260322:1648 Correct Coresspondence / Doing RFA / Correct CI

.agents/skills/next-best-practices/route-handlers.md

@@ -7,14 +7,14 @@ Create API endpoints with `route.ts` files.
 ```tsx
 // app/api/users/route.ts
 export async function GET() {
-  const users = await getUsers()
-  return Response.json(users)
+  const users = await getUsers();
+  return Response.json(users);
 }
 
 export async function POST(request: Request) {
-  const body = await request.json()
-  const user = await createUser(body)
-  return Response.json(user, { status: 201 })
+  const body = await request.json();
+  const user = await createUser(body);
+  return Response.json(user, { status: 201 });
 }
 ```
 
@@ -60,11 +60,11 @@ Route handlers run in a **Server Component-like environment**:
 
 ```tsx
 // Bad: This won't work - no React DOM in route handlers
-import { renderToString } from 'react-dom/server'
+import { renderToString } from 'react-dom/server';
 
 export async function GET() {
-  const html = renderToString(<Component />)  // Error!
-  return new Response(html)
+  const html = renderToString(<Component />); // Error!
+  return new Response(html);
 }
 ```
 
@@ -72,18 +72,15 @@ export async function GET() {
 
 ```tsx
 // app/api/users/[id]/route.ts
-export async function GET(
-  request: Request,
-  { params }: { params: Promise<{ id: string }> }
-) {
-  const { id } = await params
-  const user = await getUser(id)
+export async function GET(request: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params;
+  const user = await getUser(id);
 
   if (!user) {
-    return Response.json({ error: 'Not found' }, { status: 404 })
+    return Response.json({ error: 'Not found' }, { status: 404 });
   }
 
-  return Response.json(user)
+  return Response.json(user);
 }
 ```
 
@@ -92,17 +89,17 @@ export async function GET(
 ```tsx
 export async function GET(request: Request) {
   // URL and search params
-  const { searchParams } = new URL(request.url)
-  const query = searchParams.get('q')
+  const { searchParams } = new URL(request.url);
+  const query = searchParams.get('q');
 
   // Headers
-  const authHeader = request.headers.get('authorization')
+  const authHeader = request.headers.get('authorization');
 
   // Cookies (Next.js helper)
-  const cookieStore = await cookies()
-  const token = cookieStore.get('token')
+  const cookieStore = await cookies();
+  const token = cookieStore.get('token');
 
-  return Response.json({ query, token })
+  return Response.json({ query, token });
 }
 ```
 
@@ -110,37 +107,37 @@ export async function GET(request: Request) {
 
 ```tsx
 // JSON response
-return Response.json({ data })
+return Response.json({ data });
 
 // With status
-return Response.json({ error: 'Not found' }, { status: 404 })
+return Response.json({ error: 'Not found' }, { status: 404 });
 
 // With headers
 return Response.json(data, {
   headers: {
     'Cache-Control': 'max-age=3600',
   },
-})
+});
 
 // Redirect
-return Response.redirect(new URL('/login', request.url))
+return Response.redirect(new URL('/login', request.url));
 
 // Stream
 return new Response(stream, {
   headers: { 'Content-Type': 'text/event-stream' },
-})
+});
 ```
 
 ## When to Use Route Handlers vs Server Actions
 
-| Use Case | Route Handlers | Server Actions |
-|----------|----------------|----------------|
-| Form submissions | No | Yes |
-| Data mutations from UI | No | Yes |
-| Third-party webhooks | Yes | No |
-| External API consumption | Yes | No |
-| Public REST API | Yes | No |
-| File uploads | Both work | Both work |
+| Use Case                 | Route Handlers | Server Actions |
+| ------------------------ | -------------- | -------------- |
+| Form submissions         | No             | Yes            |
+| Data mutations from UI   | No             | Yes            |
+| Third-party webhooks     | Yes            | No             |
+| External API consumption | Yes            | No             |
+| Public REST API          | Yes            | No             |
+| File uploads             | Both work      | Both work      |
 
 **Prefer Server Actions** for mutations triggered from your UI.
 **Use Route Handlers** for external integrations and public APIs.