Return chainable resource routes from jsonApiResource

[evoactivity]

router.jsonApiResource() now returns the routes it registered, so middleware can be attached to some actions only. Before this it returned nothing, and the only way to add middleware was a group around the whole resource, which reached every action.

router
  .jsonApiResource('articles', {
    resource: () => import('#controllers/articles_controller'),
    relationships: () => import('#controllers/article_relationships_controller'),
  })
  .use(['store', 'update', 'destroy'], middleware.auth())
  .useRelationships(['replace', 'add', 'remove'], middleware.auth())

What changed

• registerJsonApiResource() keeps each route it creates, keyed by action, and returns a JsonApiResourceRoutes. It is modelled on AdonisJS RouteResource.use().
• use(actions | '*', middleware) attaches to resource routes, with the same tokens as only.
• useRelationships(actions | '*', middleware) attaches to relationship routes, with the same tokens as relationshipsOnly. It is a separate method because both sets have a show.
• Both return the same object, so calls chain. An action that was not registered (left out by only or relationshipsOnly) is ignored.
• The macro's type returns JsonApiResourceRoutes<RouteMiddleware>, where RouteMiddleware is Parameters<Route['use']>[0], so it accepts exactly what an AdonisJS route's own use() accepts.
• JsonApiResourceRoutes is exported.
• docs/reference.md has a new "Route middleware" section.

The change is additive. Callers that ignore the return value behave as before.

Why

Ekto's server needs per-action middleware on resources registered this way, to mark which routes a scoped API token may use (ekto monorepo #159).

Testing

• 182 tests pass. Five new tests in tests/unit/register_resource.spec.ts cover attaching to chosen actions, '*', keeping the resource and relationship show apart, ignoring unregistered actions, and middleware order across calls.
• Typecheck, lint, Prettier and pnpm build are clean.
• The tests use a recording router. The real AdonisJS Route is checked against the new route type through the provider's typecheck.

🤖 Generated with Claude Code