api-endpoint

name	api-endpoint
description	Scaffold a new REST endpoint in packages/api following project layering (route → service → repository). Use when adding a new API route.

Create an API Endpoint

Follow these steps to add a new endpoint:

1. Copy template.ts (in this skill folder) as the starting point.
2. Create packages/api/src/routes/<resource>.ts with a thin handler.
3. Add validation with a Zod schema in @shared/validators.
4. Put business logic in packages/api/src/services/<resource>.service.ts.
5. Data access goes in packages/api/src/repositories/.
6. Register the route in src/app.ts.
7. Add a supertest test <resource>.test.ts and run npm run test:api.

Keep controllers free of business logic. Wrap handlers in asyncHandler().