fix: stabilize api lint with minimal scoped changes

app/api/accounts/[id]/route.ts

@@ -3,9 +3,9 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getAccountHandler } from "@/lib/accounts/getAccountHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
  *
- * @returns A NextResponse with CORS headers.
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, {
@@ -15,18 +15,12 @@ export async function OPTIONS() {
 }
 
 /**
- * GET /api/accounts/[id]
+ * Handles GET requests.
  *
- * Retrieves account details by ID including profile info, emails, and wallets.
- * Requires authentication via `x-api-key` or `Authorization: Bearer`; the caller must be
- * allowed to access the requested account (same account, org delegation, or Recoup admin).
- *
- * Path parameters:
- * - id (required): The unique identifier of the account (UUID)
- *
- * @param request - The request object
- * @param params - Route params containing the account ID
- * @returns A NextResponse with account data
+ * @param request - Incoming HTTP request.
+ * @param root1 - Input object.
+ * @param root1.params - Dynamic route parameters.
+ * @returns - Computed result.
  */
 export async function GET(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
   return getAccountHandler(request, params);

app/api/admins/coding/pr/route.ts

@@ -3,20 +3,20 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getPrStatusHandler } from "@/lib/admins/pr/getPrStatusHandler";
 
 /**
- * GET /api/admins/coding/pr
+ * Handles GET requests.
  *
- * Returns the status (open, closed, or merged) for each provided GitHub PR URL.
- * Accepts one or more `pull_requests` query parameters (GitHub PR URLs).
- * Uses the GitHub REST API to check each PR's state.
- * Requires admin authentication.
- *
- * @param request
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {
   return getPrStatusHandler(request);
 }
 
-/** CORS preflight handler. */
+/**
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
+ */
 export async function OPTIONS(): Promise<NextResponse> {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }

app/api/admins/coding/slack/route.ts

@@ -3,18 +3,20 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getSlackTagsHandler } from "@/lib/admins/slack/getSlackTagsHandler";
 
 /**
- * GET /api/admins/coding/slack
+ * Handles GET requests.
  *
- * Returns Slack tagging analytics for the Recoup Coding Agent bot.
- * Pulls directly from the Slack API as the source of truth.
- * Supports period filtering: all (default), daily, weekly, monthly.
- * Requires admin authentication.
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {
   return getSlackTagsHandler(request);
 }
 
-/** CORS preflight handler. */
+/**
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
+ */
 export async function OPTIONS(): Promise<NextResponse> {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }

app/api/admins/content/slack/route.ts

@@ -3,20 +3,20 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getContentSlackTagsHandler } from "@/lib/admins/content/getContentSlackTagsHandler";
 
 /**
- * GET /api/admins/content/slack
+ * Handles GET requests.
  *
- * Returns Slack tagging analytics for the Recoup Content Agent bot.
- * Pulls directly from the Slack API as the source of truth.
- * Supports period filtering: all (default), daily, weekly, monthly.
- * Requires admin authentication.
- *
- * @param request
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {
   return getContentSlackTagsHandler(request);
 }
 
-/** CORS preflight handler. */
+/**
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
+ */
 export async function OPTIONS(): Promise<NextResponse> {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }

app/api/admins/privy/route.ts

@@ -3,16 +3,20 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getPrivyLoginsHandler } from "@/lib/admins/privy/getPrivyLoginsHandler";
 
 /**
- * GET /api/admins/privy
+ * Handles GET requests.
  *
- * Returns Privy login statistics for the requested time period.
- * Supports daily (last 24h), weekly (last 7 days), and monthly (last 30 days) periods.
- * Requires admin authentication.
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function GET(request: NextRequest): Promise<NextResponse> {
   return getPrivyLoginsHandler(request);
 }
 
+/**
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
+ */
 export async function OPTIONS(): Promise<NextResponse> {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }

app/api/chats/[id]/messages/trailing/route.ts

@@ -4,7 +4,9 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { deleteTrailingChatMessagesHandler } from "@/lib/chats/deleteTrailingChatMessagesHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, {
@@ -14,9 +16,12 @@ export async function OPTIONS() {
 }
 
 /**
- * DELETE /api/chats/[id]/messages/trailing
+ * Handles DELETE requests.
  *
- * Deletes all messages in chat `id` from `from_message_id` onward.
+ * @param request - Incoming HTTP request.
+ * @param root1 - Input object.
+ * @param root1.params - Dynamic route parameters.
+ * @returns - Computed result.
  */
 export async function DELETE(
   request: NextRequest,

app/api/coding-agent/callback/route.ts

@@ -3,12 +3,10 @@ import { codingAgentBot } from "@/lib/coding-agent/bot";
 import { handleCodingAgentCallback } from "@/lib/coding-agent/handleCodingAgentCallback";
 
 /**
- * POST /api/coding-agent/callback
+ * Handles POST requests.
  *
- * Callback endpoint for the coding agent Trigger.dev task.
- * Receives task results and posts them back to the Slack thread.
- *
- * @param request - The incoming callback request
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function POST(request: NextRequest) {
   await codingAgentBot.initialize();

app/api/coding-agent/github/route.ts

@@ -2,12 +2,10 @@ import type { NextRequest } from "next/server";
 import { handleGitHubWebhook } from "@/lib/coding-agent/handleGitHubWebhook";
 
 /**
- * POST /api/coding-agent/github
+ * Handles POST requests.
  *
- * Webhook endpoint for GitHub PR comment feedback.
- * Receives issue_comment events and triggers update-pr when the bot is mentioned.
- *
- * @param request - The incoming GitHub webhook request
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function POST(request: NextRequest) {
   return handleGitHubWebhook(request);

app/api/connectors/route.ts

@@ -6,7 +6,9 @@ import { authorizeConnectorHandler } from "@/lib/composio/connectors/authorizeCo
 import { disconnectConnectorHandler } from "@/lib/composio/connectors/disconnectConnectorHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, {
@@ -16,53 +18,30 @@ export async function OPTIONS() {
 }
 
 /**
- * GET /api/connectors
- *
- * List all available connectors and their connection status.
- *
- * Query params:
- *   - account_id (optional): Entity ID for entity-specific connections (e.g., artist ID)
+ * Handles GET requests.
  *
- * Authentication: x-api-key OR Authorization Bearer token required.
- *
- * @param request
- * @returns List of connectors with connection status
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function GET(request: NextRequest) {
   return getConnectorsHandler(request);
 }
 
 /**
- * POST /api/connectors
- *
- * Generate an OAuth authorization URL for a specific connector.
+ * Handles POST requests.
  *
- * Authentication: x-api-key OR Authorization Bearer token required.
- *
- * Request body:
- * - connector: The connector slug, e.g., "googlesheets" or "tiktok" (required)
- * - callback_url: Optional custom callback URL after OAuth
- * - account_id: Optional account ID for account-specific connections
- *
- * @param request
- * @returns The redirect URL for OAuth authorization
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function POST(request: NextRequest) {
   return authorizeConnectorHandler(request);
 }
 
 /**
- * DELETE /api/connectors
- *
- * Disconnect a connected account from Composio.
- *
- * Body:
- * - connected_account_id (required): The connected account ID to disconnect
- * - account_id (optional): Entity ID for ownership verification (e.g., artist ID)
- *
- * Authentication: x-api-key OR Authorization Bearer token required.
+ * Handles DELETE requests.
  *
- * @param request
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function DELETE(request: NextRequest) {
   return disconnectConnectorHandler(request);

app/api/content/analyze/route.ts

@@ -3,16 +3,19 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { createAnalyzeHandler } from "@/lib/content/analyze/createAnalyzeHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }
 
 /**
- * POST /api/content/analyze
+ * Handles POST requests.
  *
- * Analyze a video with AI — describe scenes, check quality, evaluate content.
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function POST(request: NextRequest): Promise<NextResponse> {
   return createAnalyzeHandler(request);

app/api/content/caption/route.ts

@@ -3,16 +3,19 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { createTextHandler } from "@/lib/content/caption/createTextHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }
 
 /**
- * POST /api/content/caption
+ * Handles POST requests.
  *
- * Generate on-screen caption text for a social video.
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function POST(request: NextRequest): Promise<NextResponse> {
   return createTextHandler(request);

app/api/content/image/route.ts

@@ -3,16 +3,19 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { createImageHandler } from "@/lib/content/image/createImageHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }
 
 /**
- * POST /api/content/image
+ * Handles POST requests.
  *
- * Generate an image from a prompt and optional reference image.
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function POST(request: NextRequest): Promise<NextResponse> {
   return createImageHandler(request);

app/api/content/route.ts

@@ -3,16 +3,19 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { editHandler } from "@/lib/content/edit/editHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }
 
 /**
- * PATCH /api/content
+ * Handles PATCH requests.
  *
- * Edit media with operations or a template preset.
+ * @param request - Incoming HTTP request.
+ * @returns - Computed result.
  */
 export async function PATCH(request: NextRequest): Promise<NextResponse> {
   return editHandler(request);

app/api/content/templates/[id]/route.ts

@@ -3,16 +3,21 @@ import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
 import { getContentTemplateDetailHandler } from "@/lib/content/getContentTemplateDetailHandler";
 
 /**
- * OPTIONS handler for CORS preflight requests.
+ * Handles OPTIONS requests.
+ *
+ * @returns - Computed result.
  */
 export async function OPTIONS() {
   return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
 }
 
 /**
- * GET /api/content/templates/[id]
+ * Handles GET requests.
  *
- * Returns the full template configuration for a given template id.
+ * @param request - Incoming HTTP request.
+ * @param context - Route handler context.
+ * @param context.params - Dynamic route parameters.
+ * @returns - Computed result.
  */
 export async function GET(
   request: NextRequest,