myeasycms-v2/packages/next/AGENTS.md

Next.js Utilities

Quick Reference

Function	Import	Purpose
enhanceAction	@kit/next/actions	Server actions with auth + validation
enhanceRouteHandler	@kit/next/routes	API routes with auth + validation

Guidelines

• Server Actions for mutations only, not data-fetching
• Keep actions light - move business logic to services
• Authorization via RLS, not application code
• Use 'use server' at top of file
• Always validate with Zod schema

Skills

For detailed implementation patterns:

• /server-action-builder - Complete server action workflow

Server Action Pattern

'use server';

import { enhanceAction } from '@kit/next/actions';

export const myAction = enhanceAction(
  async function (data, user) {
    // data: validated, user: authenticated
    return { success: true };
  },
  {
    auth: true,
    schema: MySchema,
  },
);

Route Handler Pattern

import { enhanceRouteHandler } from '@kit/next/routes';

export const POST = enhanceRouteHandler(
  async function ({ body, user, request }) {
    return NextResponse.json({ success: true });
  },
  { auth: true, schema: MySchema },
);

Revalidation

• Use revalidatePath after mutations
• Never use router.refresh() or router.push() after Server Actions