stratal 0.0.13 → 0.0.14

package/dist/router/decorators/controller.decorator.js

@@ -1,70 +0,0 @@
-import { Transient } from '../../di/decorators';
-import { ROUTE_METADATA_KEYS } from '../constants';
-const CONTROLLER_ROUTE_KEY = ROUTE_METADATA_KEYS.CONTROLLER_ROUTE;
-/**
- * Base controller decorator for route registration
- *
- * This is the core controller decorator that handles:
- * - Transient scope registration (request-scoped)
- * - Route metadata storage
- * - Controller options (tags, security schemes, hideFromDocs)
- *
- * @param route - Base route for this controller (e.g., '/api/v1/users')
- * @param options - Optional configuration (tags, security schemes, hideFromDocs)
- *
- * @example
- * ```typescript
- * import { Controller } from 'stratal/router'
- *
- * @Controller('/api/v1/users', { tags: ['Users'] })
- * export class UsersController implements IController {
- *   // All routes accessible
- * }
- * ```
- */
-export function Controller(route, options) {
-    return function (target) {
-        // Wrap @Transient (handles @injectable and scope metadata)
-        Transient()(target);
-        // Store route metadata on the class
-        Reflect.defineMetadata(CONTROLLER_ROUTE_KEY, route, target);
-        // Store options metadata if provided
-        if (options) {
-            Reflect.defineMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, options, target);
-        }
-        return target;
-    };
-}
-/**
- * Get the route from controller class metadata
- *
- * @param target - Controller class or instance
- * @returns Route string or undefined if not set
- */
-export function getControllerRoute(target) {
-    // Check if target is a class constructor (function) or an instance
-    // If class, get metadata from it directly; if instance, get from constructor
-    const metadataTarget = typeof target === 'function' ? target : target.constructor;
-    return Reflect.getMetadata(CONTROLLER_ROUTE_KEY, metadataTarget);
-}
-/**
- * Get the options from controller class metadata
- *
- * @param target - Controller class or instance
- * @returns Controller options or undefined if not set
- */
-export function getControllerOptions(target) {
-    const metadataTarget = typeof target === 'function' ? target : target.constructor;
-    return Reflect.getMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, metadataTarget);
-}
-/**
- * Get the version from controller class metadata
- *
- * @param target - Controller class or instance
- * @returns Version string, array, VERSION_NEUTRAL symbol, or undefined if not set
- */
-export function getControllerVersion(target) {
-    const options = getControllerOptions(target);
-    return options?.version;
-}
-//# sourceMappingURL=controller.decorator.js.map

package/dist/router/decorators/controller.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.decorator.js","sourceRoot":"","sources":["../../../src/router/decorators/controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGlD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,gBAAgB,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAA2B;IACnE,OAAO,UAAiC,MAAS;QAC/C,2DAA2D;QAC3D,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;QAEnB,oCAAoC;QACpC,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAE3D,qCAAqC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACjF,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,mEAAmE;IACnE,6EAA6E;IAC7E,MAAM,cAAc,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,WAAW,CAAA;IAC9G,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,cAAc,CAAuB,CAAA;AACxF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,cAAc,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,WAAW,CAAA;IAC9G,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,cAAc,CAAkC,CAAA;AACrH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC5C,OAAO,OAAO,EAAE,OAAO,CAAA;AACzB,CAAC"}

package/dist/router/decorators/http-method.decorator.d.ts

@@ -1,83 +0,0 @@
-import type { HttpRouteMetadata, RouteConfig } from '../types';
-/**
- * Registers a GET route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration (response schema, body, params, etc.)
- *
- * @example
- * ```typescript
- * @Controller('/api/v1/users')
- * class UsersController {
- *   @Get('/', { response: z.array(userSchema), summary: 'List users' })
- *   async list(ctx: RouterContext) { ... }
- *
- *   @Get('/:id', { params: z.object({ id: z.string().uuid() }), response: userSchema })
- *   async getUser(ctx: RouterContext) { ... }
- * }
- * ```
- */
-export declare const Get: (path: string, config?: RouteConfig) => (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Registers a POST route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration (response schema, body, params, etc.)
- *
- * @example
- * ```typescript
- * @Controller('/api/v1/users')
- * class UsersController {
- *   @Post('/', { body: createUserSchema, response: userSchema, statusCode: 201 })
- *   async createUser(ctx: RouterContext) { ... }
- * }
- * ```
- */
-export declare const Post: (path: string, config?: RouteConfig) => (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Registers a PUT route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export declare const Put: (path: string, config?: RouteConfig) => (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Registers a PATCH route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export declare const Patch: (path: string, config?: RouteConfig) => (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Registers a DELETE route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export declare const Delete: (path: string, config?: RouteConfig) => (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Registers an ALL (any HTTP method) route on the controller method.
- * Routes using @All are automatically hidden from OpenAPI documentation
- * since OpenAPI does not support a catch-all HTTP method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export declare const All: (path: string, config?: RouteConfig) => (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Get the HTTP route metadata from a controller method decorated with
- * @Get, @Post, @Put, @Patch, @Delete, or @All.
- *
- * @param target - Controller prototype
- * @param methodName - Name of the method
- * @returns HTTP route metadata or undefined if not decorated
- */
-export declare function getHttpRouteMetadata(target: object, methodName: string): HttpRouteMetadata | undefined;
-/**
- * Get all methods decorated with HTTP method decorators from a controller class.
- *
- * @param ControllerClass - Controller class
- * @returns Array of method names that have HTTP route metadata
- */
-export declare function getHttpDecoratedMethods(ControllerClass: new (...args: unknown[]) => object): string[];
-//# sourceMappingURL=http-method.decorator.d.ts.map

package/dist/router/decorators/http-method.decorator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-method.decorator.d.ts","sourceRoot":"","sources":["../../../src/router/decorators/http-method.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAwC1E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,GAAG,SAhDS,MAAM,WAAW,WAAW,MAE/C,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,uBA4Ce,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI,SAjEQ,MAAM,WAAW,WAAW,MAE/C,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,uBA6DiB,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,GAAG,SAzES,MAAM,WAAW,WAAW,MAE/C,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,uBAqEe,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,SAjFO,MAAM,WAAW,WAAW,MAE/C,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,uBA6EmB,CAAA;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,SAzFM,MAAM,WAAW,WAAW,MAE/C,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,uBAqFqB,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,SAnGS,MAAM,WAAW,WAAW,MAE/C,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,uBA+Fe,CAAA;AAEnD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEtG;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,GAAG,MAAM,EAAE,CAGrG"}

package/dist/router/decorators/http-method.decorator.js

@@ -1,113 +0,0 @@
-import { z } from '../../i18n/validation';
-import { ROUTE_METADATA_KEYS } from '../constants';
-/**
- * Creates an HTTP method decorator factory for the given HTTP method.
- *
- * The returned decorator stores {@link HttpRouteMetadata} on the method and
- * tracks the method name under {@link ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS}
- * on the controller prototype so they can be discovered at registration time.
- */
-function createHttpMethodDecorator(method) {
-    return function (path, config) {
-        return function (target, propertyKey, descriptor) {
-            const metadata = {
-                method,
-                path,
-                config: config ?? { response: z.any() },
-            };
-            Reflect.defineMetadata(ROUTE_METADATA_KEYS.HTTP_ROUTE_CONFIG, metadata, target, propertyKey);
-            // Track this method as HTTP-decorated on the prototype
-            const existing = Reflect.getOwnMetadata(ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS, target) ?? [];
-            existing.push(propertyKey);
-            Reflect.defineMetadata(ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS, existing, target);
-            return descriptor;
-        };
-    };
-}
-/**
- * Registers a GET route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration (response schema, body, params, etc.)
- *
- * @example
- * ```typescript
- * @Controller('/api/v1/users')
- * class UsersController {
- *   @Get('/', { response: z.array(userSchema), summary: 'List users' })
- *   async list(ctx: RouterContext) { ... }
- *
- *   @Get('/:id', { params: z.object({ id: z.string().uuid() }), response: userSchema })
- *   async getUser(ctx: RouterContext) { ... }
- * }
- * ```
- */
-export const Get = createHttpMethodDecorator('get');
-/**
- * Registers a POST route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration (response schema, body, params, etc.)
- *
- * @example
- * ```typescript
- * @Controller('/api/v1/users')
- * class UsersController {
- *   @Post('/', { body: createUserSchema, response: userSchema, statusCode: 201 })
- *   async createUser(ctx: RouterContext) { ... }
- * }
- * ```
- */
-export const Post = createHttpMethodDecorator('post');
-/**
- * Registers a PUT route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export const Put = createHttpMethodDecorator('put');
-/**
- * Registers a PATCH route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export const Patch = createHttpMethodDecorator('patch');
-/**
- * Registers a DELETE route on the controller method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export const Delete = createHttpMethodDecorator('delete');
-/**
- * Registers an ALL (any HTTP method) route on the controller method.
- * Routes using @All are automatically hidden from OpenAPI documentation
- * since OpenAPI does not support a catch-all HTTP method.
- *
- * @param path - Route path relative to the controller base path
- * @param config - Optional route configuration
- */
-export const All = createHttpMethodDecorator('all');
-/**
- * Get the HTTP route metadata from a controller method decorated with
- * @Get, @Post, @Put, @Patch, @Delete, or @All.
- *
- * @param target - Controller prototype
- * @param methodName - Name of the method
- * @returns HTTP route metadata or undefined if not decorated
- */
-export function getHttpRouteMetadata(target, methodName) {
-    return Reflect.getMetadata(ROUTE_METADATA_KEYS.HTTP_ROUTE_CONFIG, target, methodName);
-}
-/**
- * Get all methods decorated with HTTP method decorators from a controller class.
- *
- * @param ControllerClass - Controller class
- * @returns Array of method names that have HTTP route metadata
- */
-export function getHttpDecoratedMethods(ControllerClass) {
-    const prototype = ControllerClass.prototype;
-    return Reflect.getOwnMetadata(ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS, prototype) ?? [];
-}
-//# sourceMappingURL=http-method.decorator.js.map

package/dist/router/decorators/http-method.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-method.decorator.js","sourceRoot":"","sources":["../../../src/router/decorators/http-method.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGlD;;;;;;GAMG;AACH,SAAS,yBAAyB,CAAC,MAAkB;IACnD,OAAO,UAAU,IAAY,EAAE,MAAoB;QACjD,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;YAE9B,MAAM,QAAQ,GAAsB;gBAClC,MAAM;gBACN,IAAI;gBACJ,MAAM,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE;aACxC,CAAA;YAED,OAAO,CAAC,cAAc,CACpB,mBAAmB,CAAC,iBAAiB,EACrC,QAAQ,EACR,MAAM,EACN,WAAW,CACZ,CAAA;YAED,uDAAuD;YACvD,MAAM,QAAQ,GACX,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,MAAM,CAA0B,IAAI,EAAE,CAAA;YAC5G,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YAC1B,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;YAEpF,OAAO,UAAU,CAAA;QACnB,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAA;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAA;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAA;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,UAAkB;IACrE,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,CAAkC,CAAA;AACxH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,eAAmD;IACzF,MAAM,SAAS,GAAG,eAAe,CAAC,SAAmB,CAAA;IACrD,OAAQ,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,SAAS,CAA0B,IAAI,EAAE,CAAA;AACtH,CAAC"}

package/dist/router/decorators/index.d.ts

@@ -1,4 +0,0 @@
-export { Controller, getControllerOptions, getControllerRoute } from './controller.decorator';
-export { All, Delete, Get, getHttpDecoratedMethods, getHttpRouteMetadata, Patch, Post, Put } from './http-method.decorator';
-export { getDecoratedMethods, getRouteConfig, Route } from './route.decorator';
-//# sourceMappingURL=index.d.ts.map

package/dist/router/decorators/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAAE,oBAAoB,EAAE,kBAAkB,EACrD,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAA;AAC3H,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/router/decorators/index.js

@@ -1,6 +0,0 @@
-export { Controller, getControllerOptions, getControllerRoute } from './controller.decorator';
-export { All, Delete, Get, getHttpDecoratedMethods, getHttpRouteMetadata, Patch, Post, Put } from './http-method.decorator';
-export { getDecoratedMethods, getRouteConfig, Route } from './route.decorator';
-// Guards are now exported from core/guards module
-// Use: import { UseGuards, AuthGuard } from 'stratal/guards'
-//# sourceMappingURL=index.js.map

package/dist/router/decorators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAAE,oBAAoB,EAAE,kBAAkB,EACrD,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAA;AAC3H,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9E,kDAAkD;AAClD,6DAA6D"}

package/dist/router/decorators/route.decorator.d.ts

@@ -1,90 +0,0 @@
-import type { RouteConfig } from '../types';
-/**
- * Decorator to add OpenAPI metadata to a controller method using convention-based routing.
- *
- * **Cannot be mixed with HTTP method decorators** (`@Get`, `@Post`, `@Put`, `@Patch`,
- * `@Delete`, `@All`) in the same controller. Use one pattern or the other.
- *
- * Stores route configuration (schemas, response, tags, security) in metadata.
- * HTTP method, path, and success status code are auto-derived from the method name:
- * - index() → GET /base-path → 200
- * - show() → GET /base-path/:id → 200
- * - create() → POST /base-path → 201
- * - update() → PUT /base-path/:id → 200
- * - patch() → PATCH /base-path/:id → 200
- * - destroy() → DELETE /base-path/:id → 200
- *
- * @param config - Route configuration (schemas, response, tags, security)
- *
- * @example
- * ```typescript
- * @Controller('/api/v1/notes', {
- *   tags: ['Notes'],
- *   security: ['bearerAuth']
- * })
- * export class NotesController implements Controller {
- *   @Route({
- *     body: createNoteSchema,
- *     response: noteSchema, // 201 auto-derived from 'create' method
- *     tags: ['Mutations'],
- *     description: 'Create a new note'
- *   })
- *   async create(ctx: RouterContext): Promise<Response> {
- *     // POST /api/v1/notes (auto-derived from method name)
- *     // Body schema: createNoteSchema (auto-validated)
- *     // Response: 201 → noteSchema (status auto-derived)
- *     // Tags: ['Notes', 'Mutations'] (merged with controller)
- *     // Security: ['bearerAuth'] (inherited from controller)
- *     const body = ctx.body()
- *     const note = await this.notesService.create(body)
- *     return ctx.json(note, 201)
- *   }
- *
- *   @Route({
- *     query: paginationSchema,
- *     response: z.array(noteSchema) // 200 auto-derived from 'index' method
- *   })
- *   async index(ctx: RouterContext): Promise<Response> {
- *     // GET /api/v1/notes (auto-derived)
- *     // Query params auto-validated
- *     const notes = await this.notesService.list()
- *     return ctx.json(notes)
- *   }
- *
- *   @Route({
- *     params: z.object({ id: z.string().uuid() }),
- *     response: {
- *       schema: noteSchema,
- *       description: 'Note details'
- *     },
- *     security: [] // Override to make public
- *   })
- *   async show(ctx: RouterContext): Promise<Response> {
- *     // GET /api/v1/notes/:id (auto-derived)
- *     // URL params auto-validated
- *     // Response: 200 → noteSchema (status auto-derived)
- *     // Security: [] (public route, override controller security)
- *     const id = ctx.param('id')
- *     const note = await this.notesService.findById(id)
- *     return ctx.json(note)
- *   }
- * }
- * ```
- */
-export declare function Route(config: Omit<RouteConfig, 'statusCode'>): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Get the route configuration from a controller method
- *
- * @param target - Controller instance or prototype
- * @param methodName - Name of the method
- * @returns Route configuration or undefined if not decorated
- */
-export declare function getRouteConfig(target: object, methodName: string): RouteConfig | undefined;
-/**
- * Get all methods with @Route() decorator from a controller
- *
- * @param ControllerClass - Controller class
- * @returns Array of method names that have route config
- */
-export declare function getDecoratedMethods(ControllerClass: new (...args: unknown[]) => object): string[];
-//# sourceMappingURL=route.decorator.d.ts.map

package/dist/router/decorators/route.decorator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"route.decorator.d.ts","sourceRoot":"","sources":["../../../src/router/decorators/route.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,IAEzD,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBAYjC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,GAAG,MAAM,EAAE,CASjG"}

package/dist/router/decorators/route.decorator.js

@@ -1,102 +0,0 @@
-import { ROUTE_METADATA_KEYS } from '../constants';
-/**
- * Decorator to add OpenAPI metadata to a controller method using convention-based routing.
- *
- * **Cannot be mixed with HTTP method decorators** (`@Get`, `@Post`, `@Put`, `@Patch`,
- * `@Delete`, `@All`) in the same controller. Use one pattern or the other.
- *
- * Stores route configuration (schemas, response, tags, security) in metadata.
- * HTTP method, path, and success status code are auto-derived from the method name:
- * - index() → GET /base-path → 200
- * - show() → GET /base-path/:id → 200
- * - create() → POST /base-path → 201
- * - update() → PUT /base-path/:id → 200
- * - patch() → PATCH /base-path/:id → 200
- * - destroy() → DELETE /base-path/:id → 200
- *
- * @param config - Route configuration (schemas, response, tags, security)
- *
- * @example
- * ```typescript
- * @Controller('/api/v1/notes', {
- *   tags: ['Notes'],
- *   security: ['bearerAuth']
- * })
- * export class NotesController implements Controller {
- *   @Route({
- *     body: createNoteSchema,
- *     response: noteSchema, // 201 auto-derived from 'create' method
- *     tags: ['Mutations'],
- *     description: 'Create a new note'
- *   })
- *   async create(ctx: RouterContext): Promise<Response> {
- *     // POST /api/v1/notes (auto-derived from method name)
- *     // Body schema: createNoteSchema (auto-validated)
- *     // Response: 201 → noteSchema (status auto-derived)
- *     // Tags: ['Notes', 'Mutations'] (merged with controller)
- *     // Security: ['bearerAuth'] (inherited from controller)
- *     const body = ctx.body()
- *     const note = await this.notesService.create(body)
- *     return ctx.json(note, 201)
- *   }
- *
- *   @Route({
- *     query: paginationSchema,
- *     response: z.array(noteSchema) // 200 auto-derived from 'index' method
- *   })
- *   async index(ctx: RouterContext): Promise<Response> {
- *     // GET /api/v1/notes (auto-derived)
- *     // Query params auto-validated
- *     const notes = await this.notesService.list()
- *     return ctx.json(notes)
- *   }
- *
- *   @Route({
- *     params: z.object({ id: z.string().uuid() }),
- *     response: {
- *       schema: noteSchema,
- *       description: 'Note details'
- *     },
- *     security: [] // Override to make public
- *   })
- *   async show(ctx: RouterContext): Promise<Response> {
- *     // GET /api/v1/notes/:id (auto-derived)
- *     // URL params auto-validated
- *     // Response: 200 → noteSchema (status auto-derived)
- *     // Security: [] (public route, override controller security)
- *     const id = ctx.param('id')
- *     const note = await this.notesService.findById(id)
- *     return ctx.json(note)
- *   }
- * }
- * ```
- */
-export function Route(config) {
-    return function (target, propertyKey, descriptor) {
-        // Store route config metadata on the method
-        Reflect.defineMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, config, target, propertyKey);
-        return descriptor;
-    };
-}
-/**
- * Get the route configuration from a controller method
- *
- * @param target - Controller instance or prototype
- * @param methodName - Name of the method
- * @returns Route configuration or undefined if not decorated
- */
-export function getRouteConfig(target, methodName) {
-    return Reflect.getMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, target, methodName);
-}
-/**
- * Get all methods with @Route() decorator from a controller
- *
- * @param ControllerClass - Controller class
- * @returns Array of method names that have route config
- */
-export function getDecoratedMethods(ControllerClass) {
-    const prototype = ControllerClass.prototype;
-    const methodNames = Object.getOwnPropertyNames(prototype).filter(name => name !== 'constructor' && typeof prototype[name] === 'function');
-    return methodNames.filter(methodName => Reflect.hasMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, prototype, methodName));
-}
-//# sourceMappingURL=route.decorator.js.map

package/dist/router/decorators/route.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"route.decorator.js","sourceRoot":"","sources":["../../../src/router/decorators/route.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,MAAM,UAAU,KAAK,CAAC,MAAuC;IAC3D,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,4CAA4C;QAC5C,OAAO,CAAC,cAAc,CACpB,mBAAmB,CAAC,YAAY,EAChC,MAAM,EACN,MAAM,EACN,WAAW,CACZ,CAAA;QAED,OAAO,UAAU,CAAA;IACnB,CAAC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,UAAkB;IAC/D,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,CAA4B,CAAA;AAC7G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,eAAmD;IACrF,MAAM,SAAS,GAAG,eAAe,CAAC,SAAoC,CAAA;IACtE,MAAM,WAAW,GAAG,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,MAAM,CAC9D,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CACxE,CAAA;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CACrC,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAC7E,CAAA;AACH,CAAC"}

package/dist/router/errors/controller-method-not-found.error.d.ts

@@ -1,11 +0,0 @@
-import { ApplicationError } from '../../errors';
-/**
- * ControllerMethodNotFoundError
- *
- * Thrown when a controller method is registered but doesn't exist on the controller instance.
- * This typically indicates a mismatch between route registration and controller implementation.
- */
-export declare class ControllerMethodNotFoundError extends ApplicationError {
-    constructor(methodName: string, controllerName: string);
-}
-//# sourceMappingURL=controller-method-not-found.error.d.ts.map

package/dist/router/errors/controller-method-not-found.error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller-method-not-found.error.d.ts","sourceRoot":"","sources":["../../../src/router/errors/controller-method-not-found.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAA;AAE5D;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;gBACrD,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAOvD"}

package/dist/router/errors/controller-method-not-found.error.js

@@ -1,13 +0,0 @@
-import { ApplicationError, ERROR_CODES } from '../../errors';
-/**
- * ControllerMethodNotFoundError
- *
- * Thrown when a controller method is registered but doesn't exist on the controller instance.
- * This typically indicates a mismatch between route registration and controller implementation.
- */
-export class ControllerMethodNotFoundError extends ApplicationError {
-    constructor(methodName, controllerName) {
-        super('errors.controllerMethodNotFound', ERROR_CODES.ROUTER.CONTROLLER_METHOD_NOT_FOUND, { methodName, controllerName });
-    }
-}
-//# sourceMappingURL=controller-method-not-found.error.js.map

package/dist/router/errors/controller-method-not-found.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller-method-not-found.error.js","sourceRoot":"","sources":["../../../src/router/errors/controller-method-not-found.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,UAAkB,EAAE,cAAsB;QACpD,KAAK,CACH,iCAAiC,EACjC,WAAW,CAAC,MAAM,CAAC,2BAA2B,EAC9C,EAAE,UAAU,EAAE,cAAc,EAAE,CAC/B,CAAA;IACH,CAAC;CACF"}

package/dist/router/errors/controller-registration.error.d.ts

@@ -1,15 +0,0 @@
-import { ApplicationError } from '../../errors';
-/**
- * Error thrown when a controller fails to register
- *
- * This typically happens when:
- * - Controller is missing the `@Controller` decorator
- * - Controller route metadata is not set
- * - Controller class name is invalid
- *
- * Error Code: 9005
- */
-export declare class ControllerRegistrationError extends ApplicationError {
-    constructor(controllerName: string, reason?: string);
-}
-//# sourceMappingURL=controller-registration.error.d.ts.map

package/dist/router/errors/controller-registration.error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller-registration.error.d.ts","sourceRoot":"","sources":["../../../src/router/errors/controller-registration.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAA;AAE5D;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAMpD"}

package/dist/router/errors/controller-registration.error.js

@@ -1,20 +0,0 @@
-import { ApplicationError, ERROR_CODES } from '../../errors';
-/**
- * Error thrown when a controller fails to register
- *
- * This typically happens when:
- * - Controller is missing the `@Controller` decorator
- * - Controller route metadata is not set
- * - Controller class name is invalid
- *
- * Error Code: 9005
- */
-export class ControllerRegistrationError extends ApplicationError {
-    constructor(controllerName, reason) {
-        super('errors.controllerRegistration', ERROR_CODES.ROUTER.CONTROLLER_REGISTRATION_ERROR, {
-            controllerName,
-            reason,
-        });
-    }
-}
-//# sourceMappingURL=controller-registration.error.js.map

package/dist/router/errors/controller-registration.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller-registration.error.js","sourceRoot":"","sources":["../../../src/router/errors/controller-registration.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D;;;;;;;;;GASG;AACH,MAAM,OAAO,2BAA4B,SAAQ,gBAAgB;IAC/D,YAAY,cAAsB,EAAE,MAAe;QACjD,KAAK,CAAC,+BAA+B,EAAE,WAAW,CAAC,MAAM,CAAC,6BAA6B,EAAE;YACvF,cAAc;YACd,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/router/errors/hono-app-already-configured.error.d.ts

@@ -1,10 +0,0 @@
-import { ApplicationError } from '../../errors';
-/**
- * Error thrown when HonoApp.configure() is called more than once.
- *
- * HonoApp can only be configured a single time during application bootstrap.
- */
-export declare class HonoAppAlreadyConfiguredError extends ApplicationError {
-    constructor();
-}
-//# sourceMappingURL=hono-app-already-configured.error.d.ts.map

package/dist/router/errors/hono-app-already-configured.error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono-app-already-configured.error.d.ts","sourceRoot":"","sources":["../../../src/router/errors/hono-app-already-configured.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAA;AAE5D;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;;CAOlE"}

package/dist/router/errors/hono-app-already-configured.error.js

@@ -1,12 +0,0 @@
-import { ApplicationError, ERROR_CODES } from '../../errors';
-/**
- * Error thrown when HonoApp.configure() is called more than once.
- *
- * HonoApp can only be configured a single time during application bootstrap.
- */
-export class HonoAppAlreadyConfiguredError extends ApplicationError {
-    constructor() {
-        super('errors.honoAppAlreadyConfigured', ERROR_CODES.SYSTEM.CONFIGURATION_ERROR);
-    }
-}
-//# sourceMappingURL=hono-app-already-configured.error.js.map

package/dist/router/errors/hono-app-already-configured.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono-app-already-configured.error.js","sourceRoot":"","sources":["../../../src/router/errors/hono-app-already-configured.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D;;;;GAIG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE;QACE,KAAK,CACH,iCAAiC,EACjC,WAAW,CAAC,MAAM,CAAC,mBAAmB,CACvC,CAAA;IACH,CAAC;CACF"}

package/dist/router/errors/index.d.ts

@@ -1,8 +0,0 @@
-export { ControllerMethodNotFoundError } from './controller-method-not-found.error';
-export { HonoAppAlreadyConfiguredError } from './hono-app-already-configured.error';
-export { ControllerRegistrationError } from './controller-registration.error';
-export { OpenAPIRouteRegistrationError } from './openapi-route-registration.error';
-export { OpenAPIValidationError } from './openapi-validation.error';
-export { RouteNotFoundError } from './route-not-found.error';
-export { SchemaValidationError } from './schema-validation.error';
-//# sourceMappingURL=index.d.ts.map

package/dist/router/errors/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAA;AACnF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAA;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAA;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/router/errors/index.js

@@ -1,8 +0,0 @@
-export { ControllerMethodNotFoundError } from './controller-method-not-found.error';
-export { HonoAppAlreadyConfiguredError } from './hono-app-already-configured.error';
-export { ControllerRegistrationError } from './controller-registration.error';
-export { OpenAPIRouteRegistrationError } from './openapi-route-registration.error';
-export { OpenAPIValidationError } from './openapi-validation.error';
-export { RouteNotFoundError } from './route-not-found.error';
-export { SchemaValidationError } from './schema-validation.error';
-//# sourceMappingURL=index.js.map

package/dist/router/errors/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAA;AACnF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAA;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAA;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA"}