nxt-api-route

Generate Next.js API Route Handler

Create a Next.js App Router route.ts file for the path provided in $ARGUMENTS.

Parse $ARGUMENTS:

• First word → route path (e.g. users, auth/login, posts/[id])
• Second word (optional) → comma-separated HTTP methods to generate (e.g. GET,POST). If not provided, infer from route name.

Step 1 — Detect Project Structure

Find the app directory: app/ or src/app/

Check for existing API routes:

Glob: {app,src/app}/**/route.ts

Read 1–2 existing route files to detect:

• Import style (@/ aliases vs relative)
• Auth middleware pattern (how protected routes validate tokens)
• Error response format ({ error: string } vs { message: string } vs custom)
• Response helper usage (NextResponse.json vs Response)

Step 2 — Detect Auth Pattern

Search for auth middleware or utility:

Glob: {lib,src/lib,middleware,src/middleware,utils,src/utils}/**/*.{ts,js}

Look for: verifyToken, getSession, auth, getCurrentUser, withAuth

If found, read the file and understand the signature so the generated route can import and use it correctly.

Step 3 — Infer HTTP Methods

If methods are not specified in $ARGUMENTS, infer from the route name:

Route contains	Default methods
login, signin, register, signup	POST
logout, signout	POST
[id] or [slug]	GET, PUT, DELETE
No dynamic segment	GET, POST
search, filter	GET
upload	POST

Step 4 — Generate route.ts

Generate handlers only for the determined HTTP methods.

Base imports (always include):

import { NextRequest, NextResponse } from "next/server"

If dynamic segment in path:

interface RouteParams {
  params: Promise<{ {param}: string }>
}

GET handler template:

export async function GET(
  request: NextRequest,
  { params }: RouteParams  // only if dynamic segment
) {
  try {
    // const { {param} } = await params  // only if dynamic segment
    // const searchParams = request.nextUrl.searchParams
    // const query = searchParams.get("q")

    return NextResponse.json({ data: null }, { status: 200 })
  } catch (error) {
    return NextResponse.json(
      { error: "Internal server error" },
      { status: 500 }
    )
  }
}