decorators

Vovk.ts decorators

Decorators wrap static methods on controllers. Three kinds:

• HTTP decorators (@get, @post, @put, @patch, @del) — mark procedure as HTTP route. See procedure skill.
• Metadata decorators (@prefix, @operation) — attach info, no behavior change.
• Custom decorators (createDecorator) — middleware wrapping handler. How auth, logging, feature flags attach.

Two syntaxes: @decorator (needs experimentalDecorators) — default. decorate(...) — function-form fallback, no TS flag; only on request.

Scope

Covers:

• @prefix for route prefixes.
• .auto() for name-derived routes.
• HTTP decorator options (headers, cors).
• createDecorator — runs before/after handler.
• Auth pattern with req.vovk.meta() state passing.
• Stacking order (top-down — outermost runs first).
• decorate() alt syntax.
• Local (.fn()) context detection.

Out of scope:

• Writing procedures + validation → procedure skill.
• @operation for OpenAPI docs → openapi skill.
• @operation.tool for AI tool derivation → tools skill.
• Next.js middleware (middleware.ts) — separate, runs earlier in request lifecycle.

@prefix

Class-level route prefix:

import { prefix, get, procedure } from 'vovk';

@prefix('users')
export default class UserController {
  @get('{id}')
  static getUser = procedure({ /* ... */ }).handle(/* ... */);
}
// → GET /api/users/{id}

Root-level — @prefix('') or omit (same effect):

export default class RootController {
  @get()
  static ping = procedure().handle(() => ({ ok: true }));
}
// → GET /api

.auto() — name-derived routes

Use method name instead of path:

@put.auto()
static doSomething = procedure().handle(/* ... */);
// → PUT /api/<prefix>/do-something

Method names → kebab-case. Works with every HTTP decorator (@get.auto(), @post.auto(), etc.), same options.

HTTP decorator options

Second arg: response-header + CORS config.

@put('do-something', {
  headers: { 'x-hello': 'world' },
  cors: true,
})
static doSomething = procedure().handle(/* ... */);