| name | add-api-resource |
| description | Scaffolds a new Elysia API resource (camelCase folder, Drizzle-backed types, service, routes) via bun run new:resource. Use when adding a domain module under src/api/, when the user asks for a new endpoint folder, or when wiring routes after generator output. |
Add API resource (Elysia + Drizzle)
Preferred path
Run from the repository root (after nvm use / Bun per project norms):
bun run new:resource -- <PascalName>
Example: bun run new:resource -- Tickets
The script creates src/api/<camelName>/ with <prefix>.*.ts files, adds an app schema table in src/clients/postgres/schema/app.schema.ts when needed, and prints manual wiring steps.
Manual wiring (required after scaffold)
- src/config/routes.ts โ import the default route module and add
tickets: ticketsRoutes (names must match).
- src/config/app.ts โ mount with
.group("/api/v1/tickets", (group) => group.use(routes.tickets)) (adjust path and key).
- src/config/swagger.ts โ add
{ name: "Tickets", description: "..." } to documentation.tags.
Database
After schema changes:
bun run db:generate
bun run db:migrate
Commit generated SQL under drizzle/. Do not hand-edit migrations already applied to shared environments.
Finish line
- Implement real handlers (replace stubs if any), align schemas with product requirements.
- Run
bun run validate before claiming done.
Reference
Contract (read first): AGENT_CONTRACT.md. Deep examples and narrative: AGENTS.md. Canonical modules: src/api/users/, src/api/billing/.
