add-resource

Add a resource to Chassis

Scaffold and implement a REST resource so it matches Chassis conventions exactly. Follow these steps in order. Read AGENTS.md first if you haven't — it defines the conventions this skill applies.

Step 1 — Scaffold

Run the generator (converts the name to a controller class + base path):

npm run gen <Name>      # e.g. npm run gen book  ->  BookController at /books

This creates src/controllers/<Name>.controller.ts, a smoke test in src/__tests__/, and adds the export to src/controllers/index.ts. If the generator isn't available, create those three by hand modeled on an existing *.controller.ts, and add the export * from './<Name>.controller'; line yourself.

Step 2 — Define the input schema(s)

For every route that accepts input, write a zod schema. Put it at the top of the controller file or in src/schemas/<name>.schema.ts:

const createBookSchema = z.object({
  title: z.string().min(1),
  author: z.string().min(1),
  year: z.coerce.number().int().min(0).optional()
});

Step 3 — Implement the routes

Fill in the controller. Rules that keep it idiomatic:

• Decorate each method with @route(method, path, [middlewares]) (or @protectedRoute when it requires auth).
• Attach validation via validate({ body|query|params: schema }) in the middleware array.
• Return through req.resHandler — pick the helper that matches the outcome (ok, created, noContent, …).
• Signal failures by throwing AppError with the right ERROR_CODES entry. No try/catch.

@route('get', '/:id')
async show(req: Request): Promise<Response> {
  const book = await BookModel.findById(req.params.id);
  if (!book) throw new AppError(ERROR_CODES.NOT_FOUND, 'Book not found');
  return req.resHandler.ok(book);
}

@route('post', '/', [validate({ body: createBookSchema })])
async create(req: Request): Promise<Response> {
  return req.resHandler.created(await BookModel.create(req.body));
}