stratal 0.0.13 → 0.0.15

package/dist/i18n.module-qNrpIVts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.module-qNrpIVts.mjs","names":[],"sources":["../src/i18n/middleware/i18n-context.middleware.ts","../src/i18n/middleware/locale-extraction.middleware.ts","../src/openapi/openapi.tokens.ts","../src/openapi/services/openapi-config.service.ts","../src/i18n/messages/index.ts","../src/i18n/setup.ts","../src/i18n/i18n.options.ts","../src/i18n/errors/locale-not-supported.error.ts","../src/i18n/errors/translation-missing.error.ts","../src/router/decorators/http-method.decorator.ts","../src/router/decorators/route.decorator.ts","../src/openapi/services/openapi.service.ts","../src/openapi/openapi.module.ts","../src/router/errors/controller-method-not-found.error.ts","../src/router/errors/hono-app-already-configured.error.ts","../src/router/errors/controller-registration.error.ts","../src/router/errors/openapi-route-registration.error.ts","../src/router/errors/openapi-validation.error.ts","../src/router/errors/route-not-found.error.ts","../src/router/errors/schema-validation.error.ts","../src/router/middleware/logger.middleware.ts","../src/router/schemas/common.schemas.ts","../src/router/services/route-registration.service.ts","../src/router/hono-app.ts","../src/i18n/services/i18n.service.ts","../src/i18n/services/message-loader.service.ts","../src/i18n/i18n.module.ts"],"sourcesContent":["/**\n * I18n Context Middleware\n *\n * Sets up AsyncLocalStorage context for Zod i18n validation.\n * Must run after LocaleExtractionMiddleware sets the locale.\n */\n\nimport { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { Middleware } from '../../router/middleware.interface'\nimport type { RouterContext } from '../../router/router-context'\nimport { I18N_TOKENS } from '../i18n.tokens'\nimport type { I18nService } from '../services/i18n.service'\nimport { runWithErrorMapContext } from '../validation'\n\n@Transient()\nexport class I18nContextMiddleware implements Middleware {\n  constructor(\n    @inject(I18N_TOKENS.I18nService) private readonly i18n: I18nService\n  ) {}\n\n  async handle(ctx: RouterContext, next: () => Promise<void>): Promise<void> {\n    const locale = ctx.getLocale()\n\n    await runWithErrorMapContext(\n      {\n        t: (key, params) => this.i18n.t(key, params as Record<string, string | number> | undefined),\n        locale,\n      },\n      () => next()\n    )\n  }\n}\n","/**\n * Locale Extraction Middleware\n *\n * Extracts locale from X-Locale header and sets it on RouterContext.\n * Validates against available locales from MessageLoaderService.\n */\n\nimport { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { Middleware } from '../../router/middleware.interface'\nimport type { RouterContext } from '../../router/router-context'\nimport { I18N_TOKENS } from '../i18n.tokens'\nimport type { MessageLoaderService } from '../services/message-loader.service'\n\n@Transient()\nexport class LocaleExtractionMiddleware implements Middleware {\n\n  constructor(\n    @inject(I18N_TOKENS.MessageLoader) private readonly loader: MessageLoaderService,\n  ) {\n  }\n\n  async handle(ctx: RouterContext, next: () => Promise<void>): Promise<void> {\n    const locale = this.extractLocale(ctx)\n    ctx.setLocale(locale)\n    await next()\n  }\n\n  /**\n   * Extract and validate locale from X-Locale header\n   */\n  private extractLocale(ctx: RouterContext): string {\n    const requestedLocale = ctx.header('x-locale')?.toLowerCase()\n\n    if (requestedLocale && this.loader.isLocaleSupported(requestedLocale)) {\n      return requestedLocale\n    }\n\n    return this.loader.getDefaultLocale()\n  }\n}\n","/**\n * OpenAPI Module DI Tokens\n */\nexport const OPENAPI_TOKENS = {\n  /** Static options provided via forRoot() */\n  Options: Symbol.for('stratal:openapi:options'),\n\n  /** Request-scoped config service that supports runtime overrides */\n  ConfigService: Symbol.for('stratal:openapi:config:service'),\n\n  /** OpenAPI service that generates specs and serves endpoints */\n  OpenAPIService: Symbol.for('stratal:openapi:service'),\n} as const\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type {\n  IOpenAPIConfigService,\n  OpenAPIConfigOverride,\n  OpenAPIEffectiveConfig,\n  OpenAPIModuleOptions\n} from '../types'\n\n/**\n * OpenAPI Config Service\n *\n * Request-scoped service that manages OpenAPI configuration for the current request.\n * Supports runtime overrides via middleware while preserving base configuration.\n *\n * @example\n * ```typescript\n * // In middleware (e.g., RouteAccessMiddleware)\n * constructor(\n *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService\n * ) {}\n *\n * async handle(ctx, next) {\n *   this.openAPIConfig.override({\n *     info: { title: 'Custom API' },\n *     routeFilter: (path) => shouldInclude(path)\n *   })\n *   await next()\n * }\n * ```\n */\n@Transient(OPENAPI_TOKENS.ConfigService)\nexport class OpenAPIConfigService implements IOpenAPIConfigService {\n  private overrides: OpenAPIConfigOverride[] = []\n\n  constructor(\n    @inject(OPENAPI_TOKENS.Options, { isOptional: true }) private baseOptions?: OpenAPIModuleOptions\n  ) { }\n\n  /**\n   * Add configuration override for this request\n   * Overrides are merged in the order they are added\n   */\n  override(config: OpenAPIConfigOverride): void {\n    this.overrides.push(config)\n  }\n\n  /**\n   * Get effective configuration (base merged with all overrides)\n   */\n  getEffectiveConfig(): OpenAPIEffectiveConfig {\n    // Start with base options and defaults\n    let effective: OpenAPIEffectiveConfig = {\n      jsonPath: this.baseOptions?.jsonPath ?? '/api/openapi.json',\n      ui: this.baseOptions?.ui,\n      info: {\n        title: this.baseOptions?.info?.title ?? 'API',\n        version: this.baseOptions?.info?.version ?? '1.0.0',\n        description: this.baseOptions?.info?.description\n      },\n      securitySchemes: this.baseOptions?.securitySchemes\n    }\n\n    // Merge each override in order\n    for (const override of this.overrides) {\n      effective = this.mergeConfig(effective, override)\n    }\n\n    return effective\n  }\n\n  /**\n   * Merge override into effective config\n   * Info is shallow-merged, routeFilter is replaced\n   */\n  private mergeConfig(\n    base: OpenAPIEffectiveConfig,\n    override: OpenAPIConfigOverride\n  ): OpenAPIEffectiveConfig {\n    return {\n      ...base,\n      info: {\n        ...base.info,\n        ...(override.info && {\n          title: override.info.title ?? base.info.title,\n          version: override.info.version ?? base.info.version,\n          description: override.info.description ?? base.info.description\n        })\n      },\n      // Last routeFilter wins\n      routeFilter: override.routeFilter ?? base.routeFilter\n    }\n  }\n}\n","/**\n * Core Messages\n *\n * Messages used by packages/modules infrastructure.\n * These are automatically merged with application-specific messages.\n */\n\nimport * as en from './en'\n\n/**\n * All locale messages\n * Explicitly import and export (no filesystem scanning - Cloudflare Workers compatible)\n */\nexport const messages = { en } as const\n\n/**\n * Type for all messages\n */\nexport type Messages = typeof messages\n\n/**\n * Get messages for all locales\n */\nexport function getMessages(): Record<string, Record<string, unknown>> {\n  return messages\n}\n\n/**\n * Get available locales\n */\nexport function getLocales(): string[] {\n  return Object.keys(messages)\n}\n","/**\n * I18n Setup - Message Compiler Registration\n *\n * Registers a JIT (Just-In-Time) message compiler for @intlify/core-base\n * that works in Cloudflare Workers edge runtime.\n *\n * This must be called ONCE at application startup, before any I18nService instances are created.\n */\n\nimport { compile, registerMessageCompiler } from '@intlify/core-base'\n\nlet isRegistered = false\n\n/**\n * Setup JIT message compiler for i18n\n *\n * Registers a message compiler that uses JIT compilation mode.\n * In @intlify/core-base v10+, JIT mode is enabled by default, which generates\n * AST (Abstract Syntax Tree) instead of JavaScript code, making it compatible\n * with CSP-restricted environments like Cloudflare Workers.\n *\n * **IMPORTANT:** Call this function once at application startup before creating\n * any I18nService instances. Safe to call multiple times (only registers once).\n *\n * @example\n * ```typescript\n * // In application entry point (before app.initialize())\n * setupI18nCompiler()\n * ```\n */\nexport function setupI18nCompiler(): void {\n  // Guard against multiple registrations\n  if (isRegistered) {\n    return\n  }\n\n  // Register the compile function from @intlify/core-base as the message compiler\n  // In v11+, compile() uses JIT mode by default, generating AST instead of JavaScript code\n  // This avoids CSP violations (no eval/new Function) in Cloudflare Workers\n  registerMessageCompiler(compile)\n\n  isRegistered = true\n}\n","/**\n * I18n Module Options\n *\n * Configuration options for the I18n dynamic module.\n * Use with I18nModule.forRoot() to configure i18n for your application.\n */\n\n/**\n * Options for configuring the I18n module\n *\n * @example\n * ```typescript\n * I18nModule.forRoot({\n *   defaultLocale: 'en',\n *   fallbackLocale: 'en',\n *   locales: ['en', 'fr'],\n *   messages: {\n *     en: { common: { hello: 'Hello' } },\n *     fr: { common: { hello: 'Bonjour' } }\n *   }\n * })\n * ```\n */\nexport interface I18nModuleOptions {\n  /**\n   * Default locale for the application\n   * Used when no locale is specified in request headers\n   * @default 'en'\n   */\n  defaultLocale?: string\n\n  /**\n   * Fallback locale when translation is missing\n   * @default 'en'\n   */\n  fallbackLocale?: string\n\n  /**\n   * List of supported locales\n   * Request locales not in this list will fall back to defaultLocale\n   */\n  locales?: string[]\n\n  /**\n   * Application-specific messages to merge with system messages\n   * Keys are locale codes, values are message objects\n   */\n  messages?: Record<string, Record<string, unknown>>\n}\n\n/**\n * Resolved options with all defaults applied\n * Used internally by I18n services\n */\nexport interface ResolvedI18nOptions {\n  defaultLocale: string\n  fallbackLocale: string\n  locales: string[]\n  messages: Record<string, Record<string, unknown>>\n}\n\n/**\n * Resolve I18n options with defaults\n */\nexport function resolveI18nOptions(options?: I18nModuleOptions): ResolvedI18nOptions {\n  return {\n    defaultLocale: options?.defaultLocale ?? 'en',\n    fallbackLocale: options?.fallbackLocale ?? 'en',\n    locales: options?.locales ?? ['en'],\n    messages: options?.messages ?? {}\n  }\n}\n","/**\n * Locale Not Supported Error\n * Thrown when an unsupported locale is requested\n *\n * HTTP Status: 500 Internal Server Error\n * Error Code: 9301\n */\n\nimport { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class LocaleNotSupportedError extends ApplicationError {\n  constructor(locale: string, supportedLocales: string[]) {\n    super(\n      'errors.localeNotSupported',\n      ERROR_CODES.I18N.LOCALE_NOT_SUPPORTED,\n      { locale, supportedLocales: supportedLocales.join(', ') }\n    )\n  }\n}\n","/**\n * Translation Missing Error\n * Thrown when a translation key is missing from all locales\n *\n * HTTP Status: 500 Internal Server Error\n * Error Code: 9300\n */\n\nimport { ApplicationError, ERROR_CODES } from '../../errors'\n\nexport class TranslationMissingError extends ApplicationError {\n  constructor(key: string, locale: string) {\n    super(\n      'errors.translationMissing',\n      ERROR_CODES.I18N.TRANSLATION_MISSING,\n      { key, locale }\n    )\n  }\n}\n","import { z } from '../../i18n/validation'\nimport { ROUTE_METADATA_KEYS } from '../constants'\nimport type { HttpMethod, HttpRouteMetadata, RouteConfig } from '../types'\n\n/**\n * Creates an HTTP method decorator factory for the given HTTP method.\n *\n * The returned decorator stores {@link HttpRouteMetadata} on the method and\n * tracks the method name under {@link ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS}\n * on the controller prototype so they can be discovered at registration time.\n */\nfunction createHttpMethodDecorator(method: HttpMethod) {\n  return function (path: string, config?: RouteConfig) {\n    return function (\n      target: object,\n      propertyKey: string,\n      descriptor: PropertyDescriptor\n    ) {\n      const metadata: HttpRouteMetadata = {\n        method,\n        path,\n        config: config ?? { response: z.any() },\n      }\n\n      Reflect.defineMetadata(\n        ROUTE_METADATA_KEYS.HTTP_ROUTE_CONFIG,\n        metadata,\n        target,\n        propertyKey\n      )\n\n      // Track this method as HTTP-decorated on the prototype\n      const existing: string[] =\n        (Reflect.getOwnMetadata(ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS, target) as string[] | undefined) ?? []\n      existing.push(propertyKey)\n      Reflect.defineMetadata(ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS, existing, target)\n\n      return descriptor\n    }\n  }\n}\n\n/**\n * Registers a GET route on the controller method.\n *\n * @param path - Route path relative to the controller base path\n * @param config - Optional route configuration (response schema, body, params, etc.)\n *\n * @example\n * ```typescript\n * @Controller('/api/v1/users')\n * class UsersController {\n *   @Get('/', { response: z.array(userSchema), summary: 'List users' })\n *   async list(ctx: RouterContext) { ... }\n *\n *   @Get('/:id', { params: z.object({ id: z.string().uuid() }), response: userSchema })\n *   async getUser(ctx: RouterContext) { ... }\n * }\n * ```\n */\nexport const Get = createHttpMethodDecorator('get')\n\n/**\n * Registers a POST route on the controller method.\n *\n * @param path - Route path relative to the controller base path\n * @param config - Optional route configuration (response schema, body, params, etc.)\n *\n * @example\n * ```typescript\n * @Controller('/api/v1/users')\n * class UsersController {\n *   @Post('/', { body: createUserSchema, response: userSchema, statusCode: 201 })\n *   async createUser(ctx: RouterContext) { ... }\n * }\n * ```\n */\nexport const Post = createHttpMethodDecorator('post')\n\n/**\n * Registers a PUT route on the controller method.\n *\n * @param path - Route path relative to the controller base path\n * @param config - Optional route configuration\n */\nexport const Put = createHttpMethodDecorator('put')\n\n/**\n * Registers a PATCH route on the controller method.\n *\n * @param path - Route path relative to the controller base path\n * @param config - Optional route configuration\n */\nexport const Patch = createHttpMethodDecorator('patch')\n\n/**\n * Registers a DELETE route on the controller method.\n *\n * @param path - Route path relative to the controller base path\n * @param config - Optional route configuration\n */\nexport const Delete = createHttpMethodDecorator('delete')\n\n/**\n * Registers an ALL (any HTTP method) route on the controller method.\n * Routes using @All are automatically hidden from OpenAPI documentation\n * since OpenAPI does not support a catch-all HTTP method.\n *\n * @param path - Route path relative to the controller base path\n * @param config - Optional route configuration\n */\nexport const All = createHttpMethodDecorator('all')\n\n/**\n * Get the HTTP route metadata from a controller method decorated with\n * @Get, @Post, @Put, @Patch, @Delete, or @All.\n *\n * @param target - Controller prototype\n * @param methodName - Name of the method\n * @returns HTTP route metadata or undefined if not decorated\n */\nexport function getHttpRouteMetadata(target: object, methodName: string): HttpRouteMetadata | undefined {\n  return Reflect.getMetadata(ROUTE_METADATA_KEYS.HTTP_ROUTE_CONFIG, target, methodName) as HttpRouteMetadata | undefined\n}\n\n/**\n * Get all methods decorated with HTTP method decorators from a controller class.\n *\n * @param ControllerClass - Controller class\n * @returns Array of method names that have HTTP route metadata\n */\nexport function getHttpDecoratedMethods(ControllerClass: new (...args: unknown[]) => object): string[] {\n  const prototype = ControllerClass.prototype as object\n  return (Reflect.getOwnMetadata(ROUTE_METADATA_KEYS.HTTP_DECORATED_METHODS, prototype) as string[] | undefined) ?? []\n}\n","import { ROUTE_METADATA_KEYS } from '../constants'\nimport type { RouteConfig } from '../types'\n\n/**\n * Decorator to add OpenAPI metadata to a controller method using convention-based routing.\n *\n * **Cannot be mixed with HTTP method decorators** (`@Get`, `@Post`, `@Put`, `@Patch`,\n * `@Delete`, `@All`) in the same controller. Use one pattern or the other.\n *\n * Stores route configuration (schemas, response, tags, security) in metadata.\n * HTTP method, path, and success status code are auto-derived from the method name:\n * - index() → GET /base-path → 200\n * - show() → GET /base-path/:id → 200\n * - create() → POST /base-path → 201\n * - update() → PUT /base-path/:id → 200\n * - patch() → PATCH /base-path/:id → 200\n * - destroy() → DELETE /base-path/:id → 200\n *\n * @param config - Route configuration (schemas, response, tags, security)\n *\n * @example\n * ```typescript\n * @Controller('/api/v1/notes', {\n *   tags: ['Notes'],\n *   security: ['bearerAuth']\n * })\n * export class NotesController implements Controller {\n *   @Route({\n *     body: createNoteSchema,\n *     response: noteSchema, // 201 auto-derived from 'create' method\n *     tags: ['Mutations'],\n *     description: 'Create a new note'\n *   })\n *   async create(ctx: RouterContext): Promise<Response> {\n *     // POST /api/v1/notes (auto-derived from method name)\n *     // Body schema: createNoteSchema (auto-validated)\n *     // Response: 201 → noteSchema (status auto-derived)\n *     // Tags: ['Notes', 'Mutations'] (merged with controller)\n *     // Security: ['bearerAuth'] (inherited from controller)\n *     const body = ctx.body()\n *     const note = await this.notesService.create(body)\n *     return ctx.json(note, 201)\n *   }\n *\n *   @Route({\n *     query: paginationSchema,\n *     response: z.array(noteSchema) // 200 auto-derived from 'index' method\n *   })\n *   async index(ctx: RouterContext): Promise<Response> {\n *     // GET /api/v1/notes (auto-derived)\n *     // Query params auto-validated\n *     const notes = await this.notesService.list()\n *     return ctx.json(notes)\n *   }\n *\n *   @Route({\n *     params: z.object({ id: z.string().uuid() }),\n *     response: {\n *       schema: noteSchema,\n *       description: 'Note details'\n *     },\n *     security: [] // Override to make public\n *   })\n *   async show(ctx: RouterContext): Promise<Response> {\n *     // GET /api/v1/notes/:id (auto-derived)\n *     // URL params auto-validated\n *     // Response: 200 → noteSchema (status auto-derived)\n *     // Security: [] (public route, override controller security)\n *     const id = ctx.param('id')\n *     const note = await this.notesService.findById(id)\n *     return ctx.json(note)\n *   }\n * }\n * ```\n */\nexport function Route(config: Omit<RouteConfig, 'statusCode'>) {\n  return function (\n    target: object,\n    propertyKey: string,\n    descriptor: PropertyDescriptor\n  ) {\n    // Store route config metadata on the method\n    Reflect.defineMetadata(\n      ROUTE_METADATA_KEYS.ROUTE_CONFIG,\n      config,\n      target,\n      propertyKey\n    )\n\n    return descriptor\n  }\n}\n\n/**\n * Get the route configuration from a controller method\n *\n * @param target - Controller instance or prototype\n * @param methodName - Name of the method\n * @returns Route configuration or undefined if not decorated\n */\nexport function getRouteConfig(target: object, methodName: string): RouteConfig | undefined {\n  return Reflect.getMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, target, methodName) as RouteConfig | undefined\n}\n\n/**\n * Get all methods with @Route() decorator from a controller\n *\n * @param ControllerClass - Controller class\n * @returns Array of method names that have route config\n */\nexport function getDecoratedMethods(ControllerClass: new (...args: unknown[]) => object): string[] {\n  const prototype = ControllerClass.prototype as Record<string, unknown>\n  const methodNames = Object.getOwnPropertyNames(prototype).filter(\n    name => name !== 'constructor' && typeof prototype[name] === 'function'\n  )\n\n  return methodNames.filter(methodName =>\n    Reflect.hasMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, prototype, methodName)\n  )\n}\n","import { swaggerUI } from '@hono/swagger-ui'\nimport { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { II18nService } from '../../i18n'\nimport { I18N_TOKENS } from '../../i18n'\nimport type { OpenAPIHono, PathItemObject } from '../../i18n/validation'\nimport { ROUTER_CONTEXT_KEYS, SECURITY_SCHEMES } from '../../router/constants'\nimport type { IController } from '../../router/controller'\nimport { getControllerOptions, getControllerRoute } from '../../router/decorators'\nimport type { RouterEnv } from '../../router/types'\nimport type { Constructor } from '../../types'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type { IOpenAPIConfigService, OpenAPIEffectiveConfig } from '../types'\n\n/**\n * RouteInfo for hideFromDocs filtering\n */\ninterface RouteInfo {\n  hideFromDocs: boolean\n}\n\n/**\n * OpenAPI Service\n *\n * Generates OpenAPI specifications with support for:\n * - Runtime configuration via OpenAPIConfigService\n * - Route filtering via hideFromDocs and custom routeFilter\n * - i18n support for titles and descriptions\n * - Security scheme definitions\n *\n * Configuration is resolved per-request from OpenAPIConfigService,\n * allowing middleware to override config based on domain context.\n */\n@Transient(OPENAPI_TOKENS.OpenAPIService)\nexport class OpenAPIService {\n  private routeInfoMap = new Map<string, RouteInfo>()\n\n  constructor(\n    @inject(OPENAPI_TOKENS.ConfigService)\n    private configService: IOpenAPIConfigService\n  ) { }\n\n  /**\n   * Setup OpenAPI documentation endpoints\n   */\n  setupEndpoints(app: OpenAPIHono<RouterEnv>, controllers: Constructor<IController>[]): void {\n    // Build route info map for hideFromDocs filtering\n    this.buildRouteInfoMap(controllers)\n\n    const config = this.configService.getEffectiveConfig()\n\n    // OpenAPI JSON spec endpoint\n    app.get(config.jsonPath, (c) => {\n      // Get request-scoped services\n      const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n      const i18n = requestContainer.resolve<II18nService>(I18N_TOKENS.I18nService)\n      const requestConfigService = requestContainer.resolve<IOpenAPIConfigService>(\n        OPENAPI_TOKENS.ConfigService\n      )\n\n      // Get effective config (with any middleware overrides)\n      const effectiveConfig = requestConfigService.getEffectiveConfig()\n      const url = new URL(c.req.raw.url)\n\n      // Generate full OpenAPI spec using Hono's built-in generator\n      const fullSpec = app.getOpenAPIDocument({\n        openapi: '3.0.0',\n        info: {\n          version: effectiveConfig.info.version,\n          title: effectiveConfig.info.title,\n          description: effectiveConfig.info.description\n        },\n        servers: [\n          {\n            url: `${url.protocol}//${url.host}`,\n            description: i18n.t('common.api.serverDescription')\n          }\n        ]\n      })\n\n      // Add security schemes\n      fullSpec.components ??= {}\n      fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n)\n\n      // Filter routes based on hideFromDocs and custom routeFilter\n      fullSpec.paths = this.filterRoutes(\n        fullSpec.paths as Record<string, PathItemObject>,\n        effectiveConfig\n      )\n\n      // Filter unreferenced schemas\n      if (fullSpec.components.schemas) {\n        fullSpec.components.schemas = this.filterSchemas(fullSpec as unknown as Record<string, unknown>) as typeof fullSpec.components.schemas\n      }\n\n      return c.json(fullSpec)\n    })\n\n    // Docs UI endpoint\n    if (config.ui !== false) {\n      const uiPath = config.ui?.path ?? '/api/docs'\n      const uiRenderer = config.ui?.renderer\n\n      app.get(uiPath, (c, next) => {\n        const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n        const requestConfigService = requestContainer.resolve<IOpenAPIConfigService>(\n          OPENAPI_TOKENS.ConfigService\n        )\n        const effectiveConfig = requestConfigService.getEffectiveConfig()\n        const uiContext = { specUrl: effectiveConfig.jsonPath, title: effectiveConfig.info.title }\n\n        if (uiRenderer) {\n          return uiRenderer(uiContext)(c, next)\n        }\n\n        return swaggerUI<RouterEnv>({ url: uiContext.specUrl })(c, next)\n      })\n    }\n  }\n\n  /**\n   * Get localized security scheme definitions\n   */\n  private getSecuritySchemeDefinitions(i18n: II18nService) {\n    return {\n      [SECURITY_SCHEMES.BEARER_AUTH]: {\n        type: 'http',\n        scheme: 'bearer',\n        bearerFormat: 'JWT',\n        description: i18n.t('common.api.security.bearerAuth')\n      },\n      [SECURITY_SCHEMES.API_KEY]: {\n        type: 'apiKey',\n        in: 'header',\n        name: 'X-API-Key',\n        description: i18n.t('common.api.security.apiKey')\n      },\n      [SECURITY_SCHEMES.SESSION_COOKIE]: {\n        type: 'apiKey',\n        in: 'cookie',\n        name: 'session',\n        description: i18n.t('common.api.security.sessionCookie')\n      }\n    } as const\n  }\n\n  /**\n   * Build route info map from controllers\n   * Maps route prefixes to their hideFromDocs flag\n   */\n  private buildRouteInfoMap(controllers: Constructor<IController>[]): void {\n    for (const ControllerClass of controllers) {\n      const route = getControllerRoute(ControllerClass)\n      const options = getControllerOptions(ControllerClass)\n\n      if (route) {\n        this.routeInfoMap.set(route, {\n          hideFromDocs: options?.hideFromDocs ?? false\n        })\n      }\n    }\n  }\n\n  /**\n   * Filter OpenAPI paths based on hideFromDocs and custom routeFilter\n   */\n  private filterRoutes(\n    paths: Record<string, PathItemObject>,\n    config: OpenAPIEffectiveConfig\n  ): Record<string, PathItemObject> {\n    const filteredPaths: Record<string, PathItemObject> = {}\n\n    for (const [path, pathItem] of Object.entries(paths)) {\n      // 1. Check hideFromDocs (always filtered)\n      const routeInfo = this.getRouteInfo(path)\n      if (routeInfo.hideFromDocs) {\n        continue\n      }\n\n      // 2. Apply custom routeFilter if provided\n      if (config.routeFilter) {\n        if (!config.routeFilter(path, pathItem)) {\n          continue\n        }\n      }\n\n      filteredPaths[path] = pathItem\n    }\n\n    return filteredPaths\n  }\n\n  /**\n   * Get route info by matching path against controller routes\n   */\n  private getRouteInfo(path: string): RouteInfo {\n    for (const [route, info] of this.routeInfoMap.entries()) {\n      if (path === route || path.startsWith(`${route}/`)) {\n        return info\n      }\n    }\n\n    // Default to visible for unmatched routes\n    return { hideFromDocs: false }\n  }\n\n  /**\n   * Filter unreferenced schemas from OpenAPI spec\n   */\n  private filterSchemas(spec: Record<string, unknown>): Record<string, unknown> {\n    const referencedSchemas = new Set<string>()\n\n    // Collect all schema references from paths\n    this.collectSchemaRefs(spec.paths, referencedSchemas)\n\n    // Filter schemas to only include referenced ones\n    const filteredSchemas: Record<string, unknown> = {}\n    const components = spec.components as Record<string, unknown> | undefined\n    if (components?.schemas) {\n      for (const [schemaName, schemaValue] of Object.entries(components.schemas as Record<string, unknown>)) {\n        if (referencedSchemas.has(schemaName)) {\n          filteredSchemas[schemaName] = schemaValue\n          // Also collect references from this schema (for nested schemas)\n          this.collectSchemaRefs(schemaValue, referencedSchemas)\n        }\n      }\n\n      // Second pass to include any schemas referenced by included schemas\n      for (const [schemaName, schemaValue] of Object.entries(components.schemas as Record<string, unknown>)) {\n        if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) {\n          filteredSchemas[schemaName] = schemaValue\n        }\n      }\n    }\n\n    return filteredSchemas\n  }\n\n  /**\n   * Recursively collect all schema references from an object\n   */\n  private collectSchemaRefs(obj: unknown, refs: Set<string>): void {\n    if (!obj || typeof obj !== 'object') {\n      return\n    }\n\n    const record = obj as Record<string, unknown>\n\n    // Check if this object has a $ref property\n    if (record.$ref && typeof record.$ref === 'string') {\n      // Extract schema name from $ref (format: #/components/schemas/SchemaName)\n      const match = /^#\\/components\\/schemas\\/(.+)$/.exec(record.$ref)\n      if (match) {\n        refs.add(match[1])\n      }\n    }\n\n    // Recursively check all properties\n    if (Array.isArray(obj)) {\n      for (const item of obj) {\n        this.collectSchemaRefs(item, refs)\n      }\n    } else {\n      for (const value of Object.values(record)) {\n        this.collectSchemaRefs(value, refs)\n      }\n    }\n  }\n}\n","/**\n * OpenAPI Module\n *\n * Provides configurable OpenAPI documentation endpoints with runtime override support.\n *\n * Features:\n * - Configurable paths for /openapi.json and /docs\n * - Runtime config overrides via middleware\n * - i18n support for titles and descriptions\n * - Route filtering via hideFromDocs and custom routeFilter\n *\n * @example Basic usage\n * ```typescript\n * @Module({\n *   imports: [\n *     OpenAPIModule.forRoot({\n *       info: { title: 'My API', version: '1.0.0' }\n *     })\n *   ]\n * })\n * export class AppModule {}\n * ```\n *\n * @example With runtime override in middleware\n * ```typescript\n * // In RouteAccessMiddleware\n * constructor(\n *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService\n * ) {}\n *\n * async handle(ctx, next) {\n *   this.openAPIConfig.override({\n *     info: { title: 'Custom API' },\n *     routeFilter: (path) => this.shouldInclude(path)\n *   })\n *   await next()\n * }\n * ```\n */\n\nimport { Scope } from '../di'\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule } from '../module/types'\nimport { OPENAPI_TOKENS } from './openapi.tokens'\nimport { OpenAPIConfigService, OpenAPIService } from './services'\nimport type { OpenAPIModuleOptions } from './types'\n\n/** Default options when none provided */\nconst DEFAULT_OPTIONS: OpenAPIModuleOptions = {\n  jsonPath: '/api/openapi.json',\n  info: {\n    title: 'API',\n    version: '1.0.0'\n  }\n}\n\n@Module({\n  providers: [\n    // OpenAPI config service (request-scoped, supports runtime overrides)\n    { provide: OPENAPI_TOKENS.ConfigService, useClass: OpenAPIConfigService, scope: Scope.Request },\n    // OpenAPI service (generates specs, serves endpoints)\n    { provide: OPENAPI_TOKENS.OpenAPIService, useClass: OpenAPIService },\n  ],\n})\nexport class OpenAPIModule {\n  /**\n   * Configure OpenAPI module with static options\n   *\n   * @param options - OpenAPI configuration (paths, info, security schemes)\n   * @returns DynamicModule with options provider\n   */\n  static forRoot(options: OpenAPIModuleOptions = {}): DynamicModule {\n    // Merge with defaults\n    const mergedOptions: OpenAPIModuleOptions = {\n      ...DEFAULT_OPTIONS,\n      ...options,\n      info: {\n        ...DEFAULT_OPTIONS.info,\n        ...options.info,\n        title: options.info?.title ?? DEFAULT_OPTIONS.info?.title ?? 'API',\n        version: options.info?.version ?? DEFAULT_OPTIONS.info?.version ?? '1.0.0',\n      }\n    }\n\n    return {\n      module: OpenAPIModule,\n      providers: [\n        { provide: OPENAPI_TOKENS.Options, useValue: mergedOptions }\n      ]\n    }\n  }\n\n  static forRootAsync(options: AsyncModuleOptions<OpenAPIModuleOptions>): DynamicModule {\n    return {\n      module: OpenAPIModule,\n      providers: [\n        {\n          provide: OPENAPI_TOKENS.Options,\n          useFactory: options.useFactory,\n          inject: options.inject\n        },\n      ]\n    }\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * ControllerMethodNotFoundError\n *\n * Thrown when a controller method is registered but doesn't exist on the controller instance.\n * This typically indicates a mismatch between route registration and controller implementation.\n */\nexport class ControllerMethodNotFoundError extends ApplicationError {\n  constructor(methodName: string, controllerName: string) {\n    super(\n      'errors.controllerMethodNotFound',\n      ERROR_CODES.ROUTER.CONTROLLER_METHOD_NOT_FOUND,\n      { methodName, controllerName }\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when HonoApp.configure() is called more than once.\n *\n * HonoApp can only be configured a single time during application bootstrap.\n */\nexport class HonoAppAlreadyConfiguredError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.honoAppAlreadyConfigured',\n      ERROR_CODES.SYSTEM.CONFIGURATION_ERROR\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when a controller fails to register\n *\n * This typically happens when:\n * - Controller is missing the `@Controller` decorator\n * - Controller route metadata is not set\n * - Controller class name is invalid\n *\n * Error Code: 9005\n */\nexport class ControllerRegistrationError extends ApplicationError {\n  constructor(controllerName: string, reason?: string) {\n    super('errors.controllerRegistration', ERROR_CODES.ROUTER.CONTROLLER_REGISTRATION_ERROR, {\n      controllerName,\n      reason,\n    })\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * OpenAPIRouteRegistrationError\n *\n * Thrown when an OpenAPI route fails to register properly\n * This indicates a configuration issue with route decorators or metadata\n * Uses i18n key for localized error messages\n *\n * @example\n * ```typescript\n * throw new OpenAPIRouteRegistrationError('/api/v1/users', 'Missing response schema')\n * ```\n */\nexport class OpenAPIRouteRegistrationError extends ApplicationError {\n  constructor(path: string, reason: string) {\n    super(\n      'errors.openapiRouteRegistration',\n      ERROR_CODES.ROUTER.OPENAPI_ROUTE_REGISTRATION,\n      { path, reason }\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * OpenAPIValidationError\n *\n * Thrown when OpenAPI request/response validation fails\n * Uses i18n key for localized error messages\n *\n * HTTP Status: 400 Bad Request\n * Error Code: 1004\n *\n * @example\n * ```typescript\n * throw new OpenAPIValidationError('Request body missing required field: email')\n * ```\n */\nexport class OpenAPIValidationError extends ApplicationError {\n  constructor(details: string) {\n    super(\n      'errors.openapiValidation',\n      ERROR_CODES.VALIDATION.REQUEST_VALIDATION,\n      { details }\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when a requested route is not found\n *\n * HTTP Status: 404 Not Found\n * Error Code: 4004\n */\nexport class RouteNotFoundError extends ApplicationError {\n  constructor(path: string, method: string) {\n    super(\n      'errors.routeNotFound',\n      ERROR_CODES.RESOURCE.ROUTE_NOT_FOUND,\n      { path, method }\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors';\nimport type { ZodError } from '../../i18n/validation';\nimport { type z } from '../../i18n/validation';\n/**\n * SchemaValidationError\n *\n * Thrown when Zod schema validation fails\n */\nexport class SchemaValidationError extends ApplicationError {\n  constructor(zodError: ZodError) {\n    const issues = zodError.issues.map((err: z.core.$ZodIssue) => ({\n      path: err.path.join('.'),\n      message: err.message,\n      code: err.code\n    }))\n\n    super(\n      'errors.schemaValidation',\n      ERROR_CODES.VALIDATION.SCHEMA_VALIDATION,\n      { issues }\n    )\n  }\n}\n","import type { MiddlewareHandler } from 'hono'\nimport type { LoggerService } from '../../logger'\n\n/**\n * Create a Hono middleware that logs HTTP requests using our Logger service\n *\n * Logs request method, path, status code, and duration in milliseconds.\n * Format: [HTTP] METHOD /path -> STATUS (duration ms)\n *\n * @param logger - Logger service instance\n * @returns Hono middleware handler\n *\n * @example\n * ```typescript\n * const logger = container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n * app.use('*', createLoggerMiddleware(logger))\n * ```\n */\nexport function createLoggerMiddleware(logger: LoggerService): MiddlewareHandler {\n  return async (c, next) => {\n    const start = Date.now()\n    const method = c.req.method\n    const path = c.req.path\n\n    await next()\n\n    const duration = Date.now() - start\n    const status = c.res.status\n\n    logger.info(`[HTTP] ${method} ${path} -> ${status}`, {\n      method,\n      path,\n      status,\n      duration,\n    })\n  }\n}\n","import { z } from '../../i18n/validation'\n\n/**\n * Common OpenAPI Schemas\n *\n * Reusable schema definitions for common API patterns:\n * - Error responses\n * - Pagination\n * - Common parameters\n */\n\n/**\n * Generic error response schema\n * Used for all error responses (4xx, 5xx)\n * Matches ApplicationError.toErrorResponse() structure\n */\nexport const errorResponseSchema = z.object({\n  code: z.number().int().describe('Application error code'),\n  message: z.string().describe('Human-readable error message'),\n  timestamp: z.string().datetime().describe('ISO timestamp when error occurred'),\n  metadata: z.record(z.string(), z.unknown()).optional().describe('Additional error context'),\n  stack: z.string().optional().describe('Stack trace (development only)')\n}).openapi('ErrorResponse')\n\n/**\n * Validation error response schema\n * Used for 400 Bad Request with validation failures\n * Matches ApplicationError.toErrorResponse() structure with validation-specific metadata\n */\nexport const validationErrorResponseSchema = z.object({\n  code: z.number().int().describe('Application error code'),\n  message: z.string().describe('Human-readable error message'),\n  timestamp: z.string().datetime().describe('ISO timestamp when error occurred'),\n  metadata: z.object({\n    issues: z.array(z.object({\n      path: z.string().describe('Field path that failed validation'),\n      message: z.string().describe('Validation failure message'),\n      code: z.string().describe('Zod validation error code')\n    }))\n  }).describe('Validation error details'),\n  stack: z.string().optional().describe('Stack trace (development only)')\n}).openapi('ValidationErrorResponse')\n\n/**\n * Pagination query parameters schema\n * Used for list endpoints\n */\nexport const paginationQuerySchema = z.object({\n  page: z.coerce.number().int().positive().default(1).describe('Page number (1-indexed)'),\n  limit: z.coerce.number().int().positive().max(100).default(20).describe('Items per page (max 100)')\n}).openapi('PaginationQuery')\n\n/**\n * Paginated response wrapper schema\n * Generic wrapper for paginated list responses\n */\nexport const paginatedResponseSchema = <T extends z.ZodType>(itemSchema: T) =>\n  z.object({\n    data: z.array(itemSchema).describe('Array of items for current page'),\n    pagination: z.object({\n      page: z.number().int().positive().describe('Current page number'),\n      limit: z.number().int().positive().describe('Items per page'),\n      total: z.number().int().nonnegative().describe('Total number of items'),\n      totalPages: z.number().int().nonnegative().describe('Total number of pages')\n    })\n  })\n\n/**\n * UUID parameter schema\n * Used for :id parameters in RESTful routes\n */\nexport const uuidParamSchema = z.object({\n  id: z.string().uuid().describe('Resource UUID')\n}).openapi('UUIDParam')\n\n/**\n * Success message response schema\n * Used for operations that don't return data (e.g., DELETE)\n */\nexport const successMessageSchema = z.object({\n  message: z.string().describe('Success message'),\n  data: z.record(z.string(), z.unknown()).optional().describe('Optional additional data')\n}).openapi('SuccessMessage')\n\n/**\n * Common HTTP status error schemas\n * Pre-configured for standard error responses\n */\nexport const commonErrorSchemas = {\n  400: { schema: validationErrorResponseSchema, description: 'Validation error' },\n  401: { schema: errorResponseSchema, description: 'Unauthorized' },\n  403: { schema: errorResponseSchema, description: 'Forbidden' },\n  404: { schema: errorResponseSchema, description: 'Not found' },\n  409: { schema: errorResponseSchema, description: 'Conflict' },\n  500: { schema: errorResponseSchema, description: 'Internal server error' }\n} as const\n","import type { Context, MiddlewareHandler } from 'hono'\nimport type { WSContext, WSEvents } from 'hono/ws'\nimport { type Container, getMethodInjections } from '../../di'\nimport {\n  type Guard,\n  getControllerGuards,\n  getMethodGuards,\n  GuardExecutionService,\n} from '../../guards'\nimport type { OpenAPIHono } from '../../i18n/validation'\nimport { createRoute } from '../../i18n/validation'\nimport { type LoggerService } from '../../logger'\nimport type { Constructor } from '../../types'\nimport { getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, isGateway } from '../../websocket/decorators'\nimport { GatewayContext } from '../../websocket/gateway-context'\nimport { DEFAULT_CONTENT_TYPE, HTTP_METHODS, METHOD_STATUS_CODES, SECURITY_SCHEMES, VERSION_NEUTRAL } from '../constants'\nimport type { IController } from '../controller'\nimport {\n  getControllerOptions,\n  getControllerRoute,\n  getDecoratedMethods,\n  getHttpDecoratedMethods,\n  getHttpRouteMetadata,\n  getRouteConfig,\n} from '../decorators'\nimport {\n  ControllerMethodNotFoundError,\n  ControllerRegistrationError,\n  OpenAPIRouteRegistrationError,\n} from '../errors'\nimport { RouterContext } from '../router-context'\nimport { commonErrorSchemas } from '../schemas/common.schemas'\nimport type {\n  ControllerOptions,\n  HttpMethod,\n  OpenAPIRouteConfig,\n  RouteBodyObject,\n  RouteConfig,\n  RouterEnv,\n  SecuritySchemeRecord,\n  VersioningOptions,\n} from '../types'\n\nconst invokeHandler = (instance: Record<string, (...args: unknown[]) => unknown>, method: string, ...args: unknown[]): Promise<unknown> => {\n  try {\n    return Promise.resolve(instance[method](...args))\n  } catch (err: unknown) {\n    return Promise.reject(err as Error)\n  }\n}\n\n/**\n * Route registration service\n * Manages controller and route registration with OpenAPI support\n *\n * Responsibilities:\n * - Register RESTful controllers with OpenAPI metadata\n * - Auto-derive HTTP methods/paths from controller method names\n * - Build OpenAPI route configurations with guard execution\n * - Validate all controllers have access decorators (strict mode)\n * - Create controller handlers with DI resolution\n */\nexport class RouteRegistrationService {\n  private controllerClasses = new Map<string, Constructor<IController>>()\n\n  constructor(\n    private logger: LoggerService,\n    private versioningOptions: VersioningOptions | null = null,\n  ) { }\n\n  /**\n   * Configure router with controllers\n   *\n   * @param app - OpenAPIHono application instance\n   * @param controllers - Array of controller classes from modules\n   */\n  async configure(\n    app: OpenAPIHono<RouterEnv>,\n    controllers: Constructor<IController>[]\n  ): Promise<void> {\n    this.logger.info('Registering controllers', {\n      controllerCount: controllers.length,\n    })\n\n    // Sort controllers: specific routes first, wildcard handlers last\n    // This ensures more specific routes are matched before catch-all wildcards\n    // (e.g., /api/v1/auth/magic-link matches before /api/v1/auth/:path{.+})\n    const sortedControllers = [...controllers].sort((a, b) => {\n      const aHasHandle = 'handle' in a.prototype\n      const bHasHandle = 'handle' in b.prototype\n      if (aHasHandle && !bHasHandle) return 1  // a goes after b\n      if (!aHasHandle && bHasHandle) return -1 // a goes before b\n      return 0 // maintain relative order\n    })\n\n    // Single-pass partition: gateways vs regular controllers\n    const gateways: Constructor<IController>[] = []\n    const regulars: Constructor<IController>[] = []\n\n    for (const c of sortedControllers) {\n      if (isGateway(c)) {\n        gateways.push(c)\n      } else {\n        regulars.push(c)\n      }\n    }\n\n    // Register WebSocket gateways\n    for (const GatewayClass of gateways) {\n      await this.registerGateway(app, GatewayClass)\n    }\n\n    // Register controllers\n    for (const ControllerClass of regulars) {\n      this.registerController(app, ControllerClass)\n    }\n\n    this.logger.info('Controller registration complete')\n  }\n\n  /**\n   * Register a WebSocket gateway\n   * Applies versioning and guards, then registers an upgradeWebSocket handler\n   */\n  private async registerGateway(app: OpenAPIHono<RouterEnv>, GatewayClass: Constructor<IController>): Promise<void> {\n    const route = getControllerRoute(GatewayClass)\n\n    if (!route) {\n      throw new ControllerRegistrationError(\n        GatewayClass.name,\n        'Missing @Gateway decorator or route metadata'\n      )\n    }\n\n    const controllerOpts = getControllerOptions(GatewayClass)\n    const paths = this.versioningOptions\n      ? this.resolveVersionedPaths(route, controllerOpts)\n      : [route]\n\n    for (const fullPath of paths) {\n      await this.registerGatewayRoute(app, GatewayClass, fullPath)\n    }\n  }\n\n  /**\n   * Register a single WebSocket gateway route\n   */\n  private async registerGatewayRoute(\n    app: OpenAPIHono<RouterEnv>,\n    GatewayClass: Constructor<IController>,\n    fullPath: string\n  ): Promise<void> {\n    // Collect class-level guards\n    const controllerGuards = getControllerGuards(GatewayClass)?.guards ?? []\n\n    // Dynamic import: only load hono/cloudflare-workers when gateways exist\n    const { upgradeWebSocket } = await import('hono/cloudflare-workers')\n\n    // Cache WS metadata once at registration time (not per-connection)\n    const onMsgMethod = getWsOnMessageMethod(GatewayClass)\n    const onCloseMethod = getWsOnCloseMethod(GatewayClass)\n    const onErrMethod = getWsOnErrorMethod(GatewayClass)\n\n    const wsHandler: MiddlewareHandler<RouterEnv> = upgradeWebSocket((c) => {\n      const routerCtx = new RouterContext(c as Context<RouterEnv>)\n      const container = routerCtx.getContainer()\n      const gateway = container.resolve(GatewayClass)\n\n      // Cloudflare Workers doesn't support the `onOpen` WebSocket event;\n      // the upgrade callback itself serves as the open context.\n      const events: Omit<WSEvents, 'onOpen'> = {}\n\n      const bindWsHandler = (\n        method: string,\n        onCatch?: (err: unknown, ws: WSContext) => void\n      ) => {\n        return (evt: MessageEvent | CloseEvent | Event, ws: WSContext) => {\n          const ctx = new GatewayContext(c as Context<RouterEnv>, ws)\n          c.executionCtx.waitUntil(\n            invokeHandler(gateway as Record<string, (...args: unknown[]) => unknown>, method, evt, ctx).catch((err: unknown) => {\n              this.logger.error(`WebSocket ${method} handler error`, { gateway: GatewayClass.name, error: err instanceof Error ? err.message : String(err) })\n              onCatch?.(err, ws)\n            })\n          )\n        }\n      }\n\n      if (onMsgMethod) {\n        events.onMessage = bindWsHandler(onMsgMethod, (_err, ws) => ws.close(1011, 'Internal Error'))\n      }\n      if (onCloseMethod) {\n        events.onClose = bindWsHandler(onCloseMethod)\n      }\n      if (onErrMethod) {\n        events.onError = bindWsHandler(onErrMethod)\n      }\n\n      return events\n    }) as MiddlewareHandler<RouterEnv>\n\n    this.logger.info('Registering WebSocket gateway', {\n      gateway: GatewayClass.name,\n      path: fullPath,\n    })\n\n    const handlers: MiddlewareHandler<RouterEnv>[] = []\n\n    if (controllerGuards.length > 0) {\n      this.logger.info('Gateway guards', {\n        gateway: GatewayClass.name,\n        path: fullPath,\n        guardCount: controllerGuards.length,\n      })\n      handlers.push(this.createGuardMiddleware(controllerGuards))\n    }\n\n    handlers.push(wsHandler)\n\n    // Type assertion needed because Hono's overloaded .get() signatures\n    // don't accept a spread of MiddlewareHandler[] alongside upgradeWebSocket's output type\n    app.get(fullPath, ...(handlers as [MiddlewareHandler<RouterEnv>]))\n  }\n\n  /**\n   * Register a single controller with all its routes\n   * Validates that controller has access decorator (strict mode)\n   */\n  private registerController(app: OpenAPIHono<RouterEnv>, ControllerClass: Constructor<IController>): void {\n    const route = getControllerRoute(ControllerClass)\n\n    if (!route) {\n      throw new ControllerRegistrationError(\n        ControllerClass.name,\n        'Missing @Controller decorator or route metadata'\n      )\n    }\n\n    const className = ControllerClass.name\n    this.controllerClasses.set(className, ControllerClass)\n\n    const prototype = ControllerClass.prototype as IController\n    const controllerOpts = getControllerOptions(ControllerClass)\n\n    // Handle wildcard routes (non-RESTful controllers) — check once, not per version\n    if (prototype.handle) {\n      if (!this.versioningOptions) {\n        this.registerWildcardRoute(app, ControllerClass, route)\n      } else {\n        for (const versionedRoute of this.resolveVersionedPaths(route, controllerOpts)) {\n          this.registerWildcardRoute(app, ControllerClass, versionedRoute)\n        }\n      }\n      return\n    }\n\n    // Compute decorated methods once (loop-invariant)\n    const decoratedMethods = getDecoratedMethods(ControllerClass)\n    const httpDecoratedMethods = getHttpDecoratedMethods(ControllerClass)\n\n    // Enforce mutual exclusivity once\n    if (decoratedMethods.length > 0 && httpDecoratedMethods.length > 0) {\n      throw new ControllerRegistrationError(\n        ControllerClass.name,\n        'Cannot mix @Route() with HTTP method decorators (@Get, @Post, etc.) in the same controller. Use one pattern or the other.'\n      )\n    }\n\n    // Fast path: no versioning — inline dispatch, no array allocation, no loop\n    if (!this.versioningOptions) {\n      this.dispatchRoutes(app, ControllerClass, route, decoratedMethods, httpDecoratedMethods, controllerOpts, prototype)\n      return\n    }\n\n    // Versioning path: resolve versioned paths and register each\n    for (const versionedRoute of this.resolveVersionedPaths(route, controllerOpts)) {\n      this.dispatchRoutes(app, ControllerClass, versionedRoute, decoratedMethods, httpDecoratedMethods, controllerOpts, prototype)\n    }\n  }\n\n  /**\n   * Dispatch route registration based on decorator type\n   */\n  private dispatchRoutes(\n    app: OpenAPIHono<RouterEnv>,\n    ControllerClass: Constructor<IController>,\n    path: string,\n    decoratedMethods: string[],\n    httpDecoratedMethods: string[],\n    controllerOpts: ControllerOptions | undefined,\n    prototype: IController\n  ): void {\n    if (httpDecoratedMethods.length > 0) {\n      this.registerHttpRoutes(app, ControllerClass, path, httpDecoratedMethods, controllerOpts)\n    } else if (decoratedMethods.length > 0) {\n      this.registerOpenAPIRoutes(app, ControllerClass, path, decoratedMethods, controllerOpts)\n    } else {\n      this.registerRESTfulRoutes(app, ControllerClass, path, prototype)\n    }\n  }\n\n  /**\n   * Resolve versioned paths for a controller based on versioning configuration.\n   *\n   * @param basePath - The base path from @Controller decorator\n   * @param controllerOpts - Controller options (may contain version)\n   * @returns Array of resolved paths (with version prefix if applicable)\n   */\n  private resolveVersionedPaths(basePath: string, controllerOpts?: ControllerOptions): string[] {\n    // Versioning disabled — always return base path\n    if (!this.versioningOptions) {\n      return [basePath]\n    }\n\n    const version = controllerOpts?.version\n\n    // VERSION_NEUTRAL — explicitly opt out of versioning\n    if (version === VERSION_NEUTRAL) {\n      return [basePath]\n    }\n\n    const prefix = this.versioningOptions.prefix ?? 'v'\n\n    // Explicit version(s) on the controller\n    if (version !== undefined) {\n      const versions = Array.isArray(version) ? version : [version]\n      return versions.map(v => `/${prefix}${v}${basePath}`)\n    }\n\n    // No explicit version — apply defaultVersion if set\n    if (this.versioningOptions.defaultVersion !== undefined) {\n      const defaults = Array.isArray(this.versioningOptions.defaultVersion)\n        ? this.versioningOptions.defaultVersion\n        : [this.versioningOptions.defaultVersion]\n      return defaults.map(v => `/${prefix}${v}${basePath}`)\n    }\n\n    // Versioning enabled but no version and no default — no prefix\n    return [basePath]\n  }\n\n  /**\n   * Create a guard execution middleware\n   *\n   * This middleware executes all guards for a route before the handler.\n   * Guards are executed in order; all must pass for the request to proceed.\n   *\n   * @param guards - Array of guards to execute\n   * @returns Hono middleware function\n   */\n  private createGuardMiddleware(guards: Guard[]) {\n    const guardService = new GuardExecutionService(this.logger)\n\n    return async (c: Context<RouterEnv>, next: () => Promise<void>) => {\n      const ctx = new RouterContext(c)\n      const container = ctx.getContainer()\n\n      // Execute all guards - throws on failure\n      await guardService.executeGuards(guards, ctx, container)\n\n      // All guards passed, continue to handler\n      await next()\n    }\n  }\n\n  /**\n   * Register wildcard route for non-RESTful controllers\n   */\n  private registerWildcardRoute(\n    app: OpenAPIHono<RouterEnv>,\n    ControllerClass: Constructor<IController>,\n    route: string\n  ): void {\n    this.logger.info(`Registering wildcard route`, {\n      controller: ControllerClass.name,\n      route: `${route}/:path{.+}`,\n      method: 'ALL',\n    })\n\n    const handler = this.createControllerHandler(ControllerClass, 'handle')\n    // Match base route exactly\n    app.all(route, handler)\n    // Match all sub-paths using named regex wildcard\n    app.all(`${route}/:path{.+}`, handler)\n  }\n\n  /**\n   * Register OpenAPI routes with metadata\n   */\n  private registerOpenAPIRoutes(\n    app: OpenAPIHono<RouterEnv>,\n    ControllerClass: Constructor<IController>,\n    route: string,\n    decoratedMethods: string[],\n    controllerOpts: ControllerOptions | undefined\n  ): void {\n    const className = ControllerClass.name\n    const prototype = ControllerClass.prototype as IController\n\n    // Check if entire controller is hidden from docs\n    const controllerHidden = controllerOpts?.hideFromDocs ?? false\n\n    // Collect controller-level guards\n    const controllerGuards = getControllerGuards(ControllerClass)?.guards ?? []\n\n    for (const methodName of decoratedMethods) {\n      const routeConfig = getRouteConfig(prototype, methodName)\n      if (!routeConfig) continue\n\n      const derived = this.deriveHttpMethodAndPath(methodName, route)\n      if (!derived) {\n        this.logger.warn(`Cannot derive HTTP method/path for ${className}.${methodName}`)\n        continue\n      }\n\n      // Check if route is hidden (route-level overrides controller-level)\n      const hideFromDocs = routeConfig.hideFromDocs ?? controllerHidden\n\n      if (hideFromDocs) {\n        // Register route handler without OpenAPI metadata\n        this.logger.info(`Registering hidden route (no OpenAPI)`, {\n          controller: className,\n          method: derived.method.toUpperCase(),\n          path: derived.path,\n          methodName,\n        })\n\n        this.registerRouteWithoutOpenAPI(app, ControllerClass, methodName, derived)\n        continue\n      }\n\n      // Collect method-level guards\n      const methodGuards = getMethodGuards(prototype, methodName)?.guards ?? []\n\n      // Combine controller and method guards\n      // Controller guards run first, then method guards\n      const allGuards: Guard[] = [...controllerGuards, ...methodGuards]\n\n      if (allGuards.length > 0) {\n        this.logger.info(`Route guards`, {\n          controller: className,\n          method: derived.method.toUpperCase(),\n          path: derived.path,\n          methodName,\n          guardCount: allGuards.length,\n        })\n      }\n\n      // Build and register OpenAPI route\n      const metadata = this.mergeMetadata(controllerOpts, routeConfig, ControllerClass, methodName)\n      const openApiRoute = this.buildOpenAPIRoute(\n        derived.method,\n        derived.path,\n        routeConfig,\n        metadata,\n        allGuards,\n        methodName\n      )\n\n      this.logger.info(`Registering OpenAPI route`, {\n        controller: className,\n        method: derived.method.toUpperCase(),\n        path: derived.path,\n        methodName,\n        tags: metadata.tags,\n      })\n\n      // Register OpenAPI route with handler\n      app.openapi(openApiRoute, async (c) => {\n        const ctx = new RouterContext(c)\n        const requestContainer = ctx.getContainer()\n        const controller = requestContainer.resolve<IController>(ControllerClass)\n        const method = controller[methodName as keyof IController]\n        if (typeof method === 'function') {\n          const injectedArgs = this.resolveMethodInjections(prototype, methodName, requestContainer)\n          return await (method as (...args: unknown[]) => Promise<Response>).call(controller, ctx, ...injectedArgs)\n        }\n        throw new ControllerMethodNotFoundError(methodName, className)\n      })\n    }\n  }\n\n  /**\n   * Register routes using HTTP method decorators (@Get, @Post, etc.)\n   * These use explicit method + path instead of convention-based derivation\n   */\n  private registerHttpRoutes(\n    app: OpenAPIHono<RouterEnv>,\n    ControllerClass: Constructor<IController>,\n    basePath: string,\n    httpDecoratedMethods: string[],\n    controllerOpts: ControllerOptions | undefined\n  ): void {\n    const className = ControllerClass.name\n    const prototype = ControllerClass.prototype as IController\n\n    const controllerHidden = controllerOpts?.hideFromDocs ?? false\n    const controllerGuards = getControllerGuards(ControllerClass)?.guards ?? []\n\n    for (const methodName of httpDecoratedMethods) {\n      const httpMeta = getHttpRouteMetadata(prototype, methodName)\n      if (!httpMeta) continue\n\n      const fullPath = this.joinPaths(basePath, httpMeta.path)\n      const routeConfig = httpMeta.config\n      const hideFromDocs = routeConfig.hideFromDocs ?? controllerHidden\n\n      // @All routes or hidden routes are registered without OpenAPI\n      if (httpMeta.method === 'all' || hideFromDocs) {\n        this.logger.info(`Registering route (no OpenAPI)`, {\n          controller: className,\n          method: httpMeta.method.toUpperCase(),\n          path: fullPath,\n          methodName,\n        })\n\n        this.registerRouteWithoutOpenAPI(app, ControllerClass, methodName, {\n          method: httpMeta.method,\n          path: fullPath,\n        })\n        continue\n      }\n\n      // Collect method-level guards\n      const methodGuards = getMethodGuards(prototype, methodName)?.guards ?? []\n      const allGuards: Guard[] = [...controllerGuards, ...methodGuards]\n\n      if (allGuards.length > 0) {\n        this.logger.info(`Route guards`, {\n          controller: className,\n          method: httpMeta.method.toUpperCase(),\n          path: fullPath,\n          methodName,\n          guardCount: allGuards.length,\n        })\n      }\n\n      // Build and register OpenAPI route\n      const metadata = this.mergeMetadata(controllerOpts, routeConfig, ControllerClass, methodName)\n      const statusCode = routeConfig.statusCode ?? 200\n      const openApiRoute = this.buildOpenAPIRoute(\n        httpMeta.method,\n        fullPath,\n        routeConfig,\n        metadata,\n        allGuards,\n        undefined,\n        statusCode\n      )\n\n      this.logger.info(`Registering OpenAPI route`, {\n        controller: className,\n        method: httpMeta.method.toUpperCase(),\n        path: fullPath,\n        methodName,\n        tags: metadata.tags,\n      })\n\n      app.openapi(openApiRoute, async (c) => {\n        const ctx = new RouterContext(c)\n        const requestContainer = ctx.getContainer()\n        const controller = requestContainer.resolve<IController>(ControllerClass)\n        const method = controller[methodName as keyof IController]\n        if (typeof method === 'function') {\n          const injectedArgs = this.resolveMethodInjections(prototype, methodName, requestContainer)\n          return await (method as (...args: unknown[]) => Promise<Response>).call(controller, ctx, ...injectedArgs)\n        }\n        throw new ControllerMethodNotFoundError(methodName, className)\n      })\n    }\n  }\n\n  /**\n   * Join a base path and a route path, normalizing slashes\n   */\n  private joinPaths(basePath: string, routePath: string): string {\n    if (routePath === '/') return basePath\n    return basePath + routePath\n  }\n\n  /**\n   * Register route without OpenAPI metadata (for hidden routes)\n   * Route is functional but won't appear in documentation\n   */\n  private registerRouteWithoutOpenAPI(\n    app: OpenAPIHono<RouterEnv>,\n    ControllerClass: Constructor<IController>,\n    methodName: string,\n    derived: { method: HttpMethod; path: string }\n  ): void {\n    // Create handler function\n    const prototype = ControllerClass.prototype as IController\n    const handler = async (c: Context<RouterEnv>) => {\n      const ctx = new RouterContext(c)\n      const requestContainer = ctx.getContainer()\n      const controller = requestContainer.resolve<IController>(ControllerClass)\n      const method = controller[methodName as keyof IController]\n      if (typeof method === 'function') {\n        const injectedArgs = this.resolveMethodInjections(prototype, methodName, requestContainer)\n        return await (method as (...args: unknown[]) => Promise<Response>).call(controller, ctx, ...injectedArgs)\n      }\n      throw new ControllerMethodNotFoundError(methodName, ControllerClass.name)\n    }\n\n    // Register route handler without OpenAPI metadata using type-safe method dispatch\n    // Note: Only common HTTP methods (get, post, put, patch, delete) are supported\n    // For other methods, we fall back to all() which accepts any HTTP method\n    switch (derived.method) {\n      case 'get':\n        app.get(derived.path, handler)\n        break\n      case 'post':\n        app.post(derived.path, handler)\n        break\n      case 'put':\n        app.put(derived.path, handler)\n        break\n      case 'patch':\n        app.patch(derived.path, handler)\n        break\n      case 'delete':\n        app.delete(derived.path, handler)\n        break\n      case 'all':\n        app.all(derived.path, handler)\n        break\n      default:\n        // For head, options, trace, or any other method, use all()\n        app.all(derived.path, handler)\n        break\n    }\n  }\n\n\n  /**\n   * Register traditional RESTful routes without OpenAPI\n   */\n  private registerRESTfulRoutes(\n    app: OpenAPIHono<RouterEnv>,\n    ControllerClass: Constructor<IController>,\n    route: string,\n    prototype: IController\n  ): void {\n    if (prototype.index) {\n      app.get(route, this.createControllerHandler(ControllerClass, 'index'))\n    }\n    if (prototype.show) {\n      app.get(`${route}/:id`, this.createControllerHandler(ControllerClass, 'show'))\n    }\n    if (prototype.create) {\n      app.post(route, this.createControllerHandler(ControllerClass, 'create'))\n    }\n    if (prototype.update) {\n      app.put(`${route}/:id`, this.createControllerHandler(ControllerClass, 'update'))\n    }\n    if (prototype.patch) {\n      app.patch(`${route}/:id`, this.createControllerHandler(ControllerClass, 'patch'))\n    }\n    if (prototype.destroy) {\n      app.delete(`${route}/:id`, this.createControllerHandler(ControllerClass, 'destroy'))\n    }\n  }\n\n  /**\n   * Auto-derive HTTP method and path from controller method name\n   * Uses HTTP_METHODS constant for RESTful convention mapping\n   */\n  private deriveHttpMethodAndPath(methodName: string, basePath: string): { method: Exclude<HttpMethod, 'all'>; path: string } | null {\n    if (!(methodName in HTTP_METHODS)) return null\n    const mapping = HTTP_METHODS[methodName as keyof typeof HTTP_METHODS]\n\n    return {\n      method: mapping.method as Exclude<HttpMethod, 'all'>,\n      path: basePath + mapping.path,\n    }\n  }\n\n  /**\n   * Merge controller-level and route-level metadata\n   * Tags are merged (appended), security is merged (union)\n   * Guards automatically add sessionCookie security if present\n   */\n  private mergeMetadata(\n    controllerOpts: ControllerOptions | undefined,\n    routeConfig: RouteConfig,\n    ControllerClass: Constructor<IController>,\n    methodName: string\n  ): { tags: string[]; security: SecuritySchemeRecord[] } {\n    const tags = [...(controllerOpts?.tags ?? []), ...(routeConfig.tags ?? [])]\n\n    // Check if guards are present (indicates authentication is required)\n    const prototype = ControllerClass.prototype as IController\n    const hasMethodGuards = (getMethodGuards(prototype, methodName)?.guards.length ?? 0) > 0\n    const hasControllerGuards = (getControllerGuards(ControllerClass)?.guards.length ?? 0) > 0\n    const requiresAuth = hasMethodGuards || hasControllerGuards\n\n    // Merge security: if route explicitly sets security (even empty array), use it\n    // Otherwise inherit from controller\n    let security: string[] = []\n    if (routeConfig.security !== undefined) {\n      // Route has explicit security (could be empty for public routes)\n      security = [...(controllerOpts?.security ?? []), ...routeConfig.security]\n    } else if (controllerOpts?.security) {\n      // Inherit controller security\n      security = controllerOpts.security\n    }\n\n    // Auto-add sessionCookie security if guards are present\n    if (requiresAuth && !security.includes(SECURITY_SCHEMES.SESSION_COOKIE)) {\n      security.push(SECURITY_SCHEMES.SESSION_COOKIE)\n    }\n\n    // Convert security array to OpenAPI security format\n    const securityArray: SecuritySchemeRecord[] =\n      security.length > 0\n        ? (security.map<SecuritySchemeRecord>((scheme) => ({ [scheme]: [] }) as unknown as SecuritySchemeRecord))\n        : ([] as SecuritySchemeRecord[])\n\n    return { tags, security: securityArray }\n  }\n\n  /**\n   * Build OpenAPI route configuration from metadata\n   * Creates a route definition compatible with @hono/zod-openapi\n   * Includes guard execution for proper access control\n   *\n   * Execution order: Global middlewares → Guards → Handler\n   */\n  private buildOpenAPIRoute(\n    method: Exclude<HttpMethod, 'all'>,\n    path: string,\n    routeConfig: RouteConfig,\n    metadata: { tags: string[]; security: Record<string, string[]>[] },\n    guards: Guard[],\n    methodName?: string,\n    statusCodeOverride?: number\n  ): OpenAPIRouteConfig {\n    try {\n      const route: Partial<OpenAPIRouteConfig> = {\n        method,\n        path,\n        request: {},\n        responses: {},\n      }\n\n      // Add guard execution middleware using Hono's built-in middleware property\n      if (guards.length > 0) {\n        route.middleware = [this.createGuardMiddleware(guards)]\n      }\n\n      // Add request body if defined\n      if (routeConfig.body) {\n        const bodySchema = this.isRouteBodyObject(routeConfig.body) ? routeConfig.body.schema : routeConfig.body\n        const bodyContentType = this.isRouteBodyObject(routeConfig.body) ? routeConfig.body.contentType ?? DEFAULT_CONTENT_TYPE : DEFAULT_CONTENT_TYPE\n\n        route.request = {\n          ...route.request,\n          body: {\n            content: {\n              [bodyContentType]: {\n                schema: bodySchema,\n              },\n            },\n          },\n        }\n      }\n\n      // Add query parameters if defined\n      if (routeConfig.query) {\n        route.request = {\n          ...route.request,\n          query: routeConfig.query,\n        }\n      }\n\n      // Add URL parameters if defined\n      if (routeConfig.params) {\n        route.request = {\n          ...route.request,\n          params: routeConfig.params,\n        }\n      }\n\n      // Derive success status code from method name or use override\n      const successStatus = statusCodeOverride\n        ?? (methodName && METHOD_STATUS_CODES[methodName as keyof typeof METHOD_STATUS_CODES])\n        ?? 200\n\n      // Build responses object with auto-derived status\n      const responses: NonNullable<OpenAPIRouteConfig['responses']> = {}\n\n      // Add success response with derived status code\n      const responseDef = routeConfig.response\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- response may be undefined at runtime\n      if (responseDef) {\n        if (typeof responseDef === 'object' && 'schema' in responseDef) {\n          const responseContentType = responseDef.contentType ?? DEFAULT_CONTENT_TYPE\n          responses[successStatus] = {\n            content: {\n              [responseContentType]: { schema: responseDef.schema },\n            },\n            description: responseDef.description ?? `Response ${successStatus}`,\n          }\n        } else {\n          responses[successStatus] = {\n            content: {\n              [DEFAULT_CONTENT_TYPE]: { schema: responseDef },\n            },\n            description: `Response ${successStatus}`,\n          }\n        }\n      }\n\n      // Auto-merge common error schemas (400, 401, 403, 404, 409, 500)\n      // Controllers only need to define success response; error responses are added automatically\n      for (const [statusStr, schema] of Object.entries(commonErrorSchemas)) {\n        const status = parseInt(statusStr)\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- defensive: avoid overwriting success response status\n        responses[status] ??= schema\n      }\n\n      route.responses = responses\n\n      // Add tags if provided\n      if (metadata.tags.length > 0) {\n        route.tags = metadata.tags\n      }\n\n      // Add security if provided\n      if (metadata.security.length > 0) {\n        route.security = metadata.security\n      }\n\n      // Add description and summary\n      if (routeConfig.description) {\n        route.description = routeConfig.description\n      }\n      if (routeConfig.summary) {\n        route.summary = routeConfig.summary\n      }\n\n      return createRoute(route as OpenAPIRouteConfig)\n    } catch (error) {\n      throw new OpenAPIRouteRegistrationError(path, error instanceof Error ? error.message : String(error))\n    }\n  }\n\n  /**\n   * Check if a body definition is a RouteBodyObject (has schema key) vs bare ZodType\n   */\n  private isRouteBodyObject(body: RouteConfig['body']): body is RouteBodyObject {\n    return typeof body === 'object' && 'schema' in body\n  }\n\n  /**\n   * Resolve method parameter injections from the container\n   *\n   * @param prototype - Controller prototype\n   * @param methodName - Method name to get injections for\n   * @param container - Request-scoped container\n   * @returns Array of resolved dependencies in parameter order\n   */\n  private resolveMethodInjections(\n    prototype: object,\n    methodName: string,\n    container: Container\n  ): unknown[] {\n    const injections = getMethodInjections(prototype, methodName)\n    if (!injections.length) return []\n\n    return injections.map((inj): unknown => container.resolve(inj.token))\n  }\n\n  /**\n   * Create controller handler that resolves controller from request-scoped container\n   * This ensures each request gets a fresh controller with request-scoped context\n   */\n  private createControllerHandler(\n    ControllerClass: new (...args: unknown[]) => IController,\n    methodName: keyof IController\n  ): (c: Context<RouterEnv>) => Promise<Response> {\n    return async (c: Context<RouterEnv>) => {\n      this.logger.info('Handler invoked', {\n        path: c.req.path,\n        method: c.req.method,\n        controller: ControllerClass.name,\n        methodName: methodName as string,\n      })\n\n      try {\n        const ctx = new RouterContext(c)\n        const requestContainer = ctx.getContainer()\n\n        // Resolve controller from request-scoped container\n        // Controller will get request-scoped TenancyContext via DI\n        const controller = requestContainer.resolve<IController>(ControllerClass)\n\n        const method = controller[methodName]\n        if (typeof method === 'function') {\n          const injectedArgs = this.resolveMethodInjections(ControllerClass.prototype as object, methodName as string, requestContainer)\n          return await (method as (...args: unknown[]) => Promise<Response>).apply(controller, [ctx, ...injectedArgs])\n        }\n\n        throw new ControllerMethodNotFoundError(methodName as string, ControllerClass.name)\n      } catch (error) {\n        this.logger.error('Error in controller handler', {\n          controller: ControllerClass.name,\n          methodName: methodName as string,\n          error: error instanceof Error ? error.message : String(error),\n          stack: error instanceof Error ? error.stack : undefined,\n        })\n        throw error\n      }\n    }\n  }\n}\n","import type { Context, MiddlewareHandler } from 'hono'\nimport type { Container } from '../di/container'\nimport { DI_TOKENS } from '../di/tokens'\nimport { getHttpStatus, type GlobalErrorHandler } from '../errors'\nimport { OpenAPIHono } from '../i18n/validation'\nimport type { LoggerService } from '../logger'\nimport {\n  MiddlewareConfigurationService,\n  type MiddlewareConfigEntry,\n} from '../middleware'\nimport { OPENAPI_TOKENS, type OpenAPIService } from '../openapi'\nimport type { Constructor } from '../types'\nimport { ROUTER_CONTEXT_KEYS } from './constants'\nimport type { IController } from './controller'\nimport { RouteNotFoundError } from './errors'\nimport { HonoAppAlreadyConfiguredError } from './errors/hono-app-already-configured.error'\nimport { SchemaValidationError } from './errors/schema-validation.error'\nimport { createLoggerMiddleware } from './middleware'\nimport type { Middleware } from './middleware.interface'\nimport { RouterContext } from './router-context'\nimport { RouteRegistrationService } from './services/route-registration.service'\nimport type { RouterEnv, VersioningOptions } from './types'\n\nconst isMiddlewareClass = (arg: unknown): arg is Constructor<Middleware> =>\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n  typeof arg === 'function' && arg.prototype && 'handle' in arg.prototype\n\n\n/**\n * HonoApp — extends OpenAPIHono with Stratal-specific setup\n *\n * Absorbs all Hono-related setup from the former RouterService and RequestScopeService:\n * - Request scope middleware (child container per request)\n * - Global middleware (CORS, logging, error handling)\n * - defaultHook for validation errors\n * - `use()` overload for Stratal middleware classes\n * - `configure()` for module middleware, OpenAPI, routes, and 404\n */\nexport class HonoApp extends OpenAPIHono<RouterEnv> {\n  private configured = false\n  private readonly _container: Container\n  private readonly _logger: LoggerService\n\n  /**\n   * Reference to the original Hono `use` implementation.\n   * Captured in constructor after super() sets it as an instance property.\n   * Used by private methods to register middleware without going through the override.\n   */\n  private nativeUse!: typeof this.use\n\n  constructor(\n    container: Container,\n    logger: LoggerService,\n  ) {\n    super({\n      defaultHook: (result, c) => {\n        if (!result.success) {\n          const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n          const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n          const validationError = new SchemaValidationError(result.error)\n          const errorResponse = errorHandler.handle(validationError)\n          return c.json(errorResponse, getHttpStatus(errorResponse.code))\n        }\n      },\n    })\n\n    this._container = container\n    this._logger = logger\n\n    // Capture Hono's original `use` (set by super() as an instance property)\n    this.nativeUse = this.use\n\n    // Override `use` to support Stratal middleware classes alongside Hono-native handlers\n    this.use = ((...args: unknown[]) => {\n      if (isMiddlewareClass(args[0])) {\n        this.applyMiddlewareClasses('*', args as Constructor<Middleware>[])\n        return this\n      }\n\n      if (typeof args[0] === 'string' && args.length > 1 && isMiddlewareClass(args[1])) {\n        this.applyMiddlewareClasses(args[0], args.slice(1) as Constructor<Middleware>[])\n        return this\n      }\n\n      return (this.nativeUse as (...a: unknown[]) => unknown)(...args)\n    }) as typeof this.use\n\n    // Internal setup — uses nativeUse to bypass the override\n    this.setupRequestScope()\n    this.setupGlobalMiddleware()\n  }\n\n  /**\n   * Configure module middleware, OpenAPI endpoints, controller routes, and 404 handler.\n   * Called once by Application.initialize().\n   */\n  async configure(\n    middlewareConfigs: MiddlewareConfigEntry[],\n    controllers: Constructor<IController>[],\n    versioningOptions?: VersioningOptions | null,\n  ): Promise<void> {\n    if (this.configured) throw new HonoAppAlreadyConfiguredError()\n\n    // Module middleware\n    const middlewareConfigService = new MiddlewareConfigurationService(this._logger, versioningOptions ?? null)\n    middlewareConfigService.applyMiddlewares(this, middlewareConfigs, controllers, this._container)\n\n    // OpenAPI endpoints\n    const openAPIService = this._container.resolve<OpenAPIService>(OPENAPI_TOKENS.OpenAPIService)\n    openAPIService.setupEndpoints(this, controllers)\n\n    // Controller routes\n    const routeRegistrationService = new RouteRegistrationService(this._logger, versioningOptions ?? null)\n    await routeRegistrationService.configure(this, controllers)\n\n    // 404 handler (must be last)\n    this.notFound((c) => { throw new RouteNotFoundError(c.req.path, c.req.method) })\n\n    this.configured = true\n  }\n\n  private setupRequestScope(): void {\n    this.nativeUse('*', async (c: Context<RouterEnv>, next: () => Promise<void>) => {\n      const routerContext = new RouterContext(c)\n      const requestContainer = this._container.createRequestScope(routerContext)\n      c.set(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER, requestContainer)\n      try {\n        await next()\n      } finally {\n        await requestContainer.dispose()\n      }\n    })\n  }\n\n  private setupGlobalMiddleware(): void {\n    this.nativeUse('*', createLoggerMiddleware(this._logger) as MiddlewareHandler<RouterEnv>)\n    this.onError((err, c) => {\n      const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n      const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n      const errorResponse = errorHandler.handle(err)\n      return c.json(errorResponse, getHttpStatus(errorResponse.code))\n    })\n  }\n\n  private applyMiddlewareClasses(path: string, classes: Constructor<Middleware>[]): this {\n    this.nativeUse(path, async (c: Context<RouterEnv>, next: () => Promise<void>) => {\n      const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n      const ctx = new RouterContext(c)\n\n      // Build chain from end to start\n      let current = next\n      for (let i = classes.length - 1; i >= 0; i--) {\n        const prevNext = current\n        const middleware = requestContainer.resolve<Middleware>(classes[i])\n        current = () => middleware.handle(ctx, prevNext)\n      }\n\n      await current()\n    })\n    return this\n  }\n}\n","/**\n * I18n Service\n *\n * Request-scoped service for translations.\n * Injects RouterContext to access request-specific locale.\n * Uses pre-built CoreContext from MessageLoaderService (singleton) for zero-cost lookups.\n */\n\nimport { translate } from '@intlify/core-base'\nimport { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { ROUTER_TOKENS, RouterContext } from '../../router'\nimport { I18N_TOKENS } from '../i18n.tokens'\nimport type { II18nService, MessageKeys, MessageParams } from '../i18n.types'\nimport type { MessageLoaderService } from './message-loader.service'\n\n/**\n * I18n Service\n *\n * Provides internationalization (i18n) support for the application.\n * Injects RouterContext to access request-specific locale.\n *\n * @example Usage in services\n * ```typescript\n * @Transient(MY_TOKENS.UserService)\n * export class UserService {\n *   constructor(\n *     @inject(I18N_TOKENS.I18nService) private readonly i18n: II18nService\n *   ) {}\n *\n *   getWelcomeMessage(): string {\n *     return this.i18n.t('common.welcome')\n *   }\n * }\n * ```\n */\n@Transient(I18N_TOKENS.I18nService)\nexport class I18nService implements II18nService {\n  constructor(\n    @inject(I18N_TOKENS.MessageLoader) private readonly loader: MessageLoaderService,\n    @inject(ROUTER_TOKENS.RouterContext, { isOptional: true }) private readonly routerContext?: RouterContext\n  ) {\n  }\n\n  /**\n   * Translate a message key\n   *\n   * @param key - Message key (e.g., 'common.actions.save')\n   * @param params - Optional parameters for interpolation\n   * @returns Translated string\n   */\n  t(key: MessageKeys, params?: MessageParams): string {\n    const context = this.loader.getCoreContext(this.getLocale())\n\n    const result = params !== undefined\n      ? translate(context, key, params)\n      : translate(context, key)\n\n    return typeof result === 'string' ? result : key\n  }\n\n  /**\n   * Get current locale\n   *\n   * @returns Current locale code from RouterContext or default locale\n   */\n  getLocale(): string {\n    return this.routerContext?.getLocale() ?? 'en'\n  }\n}\n","/**\n * Message Loader Service\n *\n * Singleton service that loads and caches all locale messages at startup.\n * Merges core messages (from packages/modules) with app messages (from forRoot options).\n * Lazily builds and caches CoreContext per locale on first access.\n */\n\nimport type { CoreContext } from '@intlify/core-base'\nimport { createCoreContext } from '@intlify/core-base'\nimport { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { I18nModuleOptions } from '../i18n.options'\nimport { I18N_TOKENS } from '../i18n.tokens'\nimport { getLocales, getMessages } from '../messages'\n\n@Transient(I18N_TOKENS.MessageLoader)\nexport class MessageLoaderService {\n  private readonly cache: Map<string, Record<string, unknown>>\n  private readonly contextCache: Map<string, CoreContext>\n  private readonly locales: string[]\n  private readonly defaultLocale: string\n\n  constructor(\n    @inject(I18N_TOKENS.Options, { isOptional: true })\n    private readonly options?: I18nModuleOptions\n  ) {\n    this.defaultLocale = this.options?.defaultLocale ?? 'en'\n    this.cache = new Map()\n    this.contextCache = new Map()\n\n    // Get core messages (always available)\n    const coreMessages = getMessages()\n    const coreLocales = getLocales()\n\n    // Get app messages from options (if provided)\n    const appMessages = this.options?.messages ?? {}\n\n    // Determine available locales (union of core and app locales)\n    const appLocales = Object.keys(appMessages)\n    const allLocales = [...new Set([...coreLocales, ...appLocales])]\n    this.locales = allLocales\n\n    // Merge messages for each locale (CoreContext built lazily on first access)\n    for (const locale of allLocales) {\n      const coreLocaleMessages = coreMessages[locale] ?? {}\n      const appLocaleMessages = appMessages[locale] ?? {}\n\n      // Deep merge: core defaults + app overrides\n      const merged = this.deepMerge(coreLocaleMessages, appLocaleMessages)\n      this.cache.set(locale, merged)\n    }\n  }\n\n  /**\n   * Get CoreContext for a locale (lazily built and cached on first access)\n   * Falls back to default locale if locale not found\n   *\n   * @param locale - Locale code\n   * @returns Cached CoreContext ready for translation\n   */\n  getCoreContext(locale: string): CoreContext {\n    const cached = this.contextCache.get(locale)\n    if (cached) return cached\n\n    // Resolve effective locale (fallback to default if unsupported)\n    const effectiveLocale = this.cache.has(locale) ? locale : this.defaultLocale\n\n    // Check if effective locale already cached (handles fallback)\n    const cachedEffective = this.contextCache.get(effectiveLocale)\n    if (cachedEffective) return cachedEffective\n\n    // Build and cache on first access\n    const messages = this.cache.get(effectiveLocale) ?? {}\n    const flattened = this.flattenMessages(messages)\n    const ctx = createCoreContext({\n      locale: effectiveLocale,\n      messages: { [effectiveLocale]: flattened },\n      missingWarn: false,\n      fallbackWarn: false,\n    })\n    this.contextCache.set(effectiveLocale, ctx)\n    return ctx\n  }\n\n  /**\n   * Get messages for a specific locale\n   * Falls back to default locale if locale not found\n   *\n   * @param locale - Locale code\n   * @returns Message object for the locale\n   */\n  getMessages(locale: string): Record<string, unknown> {\n    const msgs = this.cache.get(locale)\n    if (!msgs) {\n      // Fallback to default locale\n      return this.cache.get(this.defaultLocale) ?? {}\n    }\n    return msgs\n  }\n\n  /**\n   * Get list of available locale codes\n   *\n   * @returns Array of locale codes\n   */\n  getAvailableLocales(): string[] {\n    return this.locales\n  }\n\n  /**\n   * Check if a locale is supported\n   *\n   * @param locale - Locale code to check\n   * @returns true if locale is supported\n   */\n  isLocaleSupported(locale: string): boolean {\n    return this.cache.has(locale)\n  }\n\n  /**\n   * Get default locale\n   *\n   * @returns Default locale code\n   */\n  getDefaultLocale(): string {\n    return this.defaultLocale\n  }\n\n  /**\n   * Flatten nested messages to dot-notation\n   *\n   * Converts { auth: { login: { title: 'Sign In' } } }\n   * to { 'auth.login.title': 'Sign In' }\n   */\n  private flattenMessages(\n    messages: Record<string, unknown>,\n    prefix = ''\n  ): Record<string, string> {\n    const result: Record<string, string> = {}\n\n    for (const key of Object.keys(messages)) {\n      const value = messages[key]\n      const newKey = prefix ? `${prefix}.${key}` : key\n\n      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n        Object.assign(result, this.flattenMessages(value as Record<string, unknown>, newKey))\n      } else {\n        result[newKey] = String(value)\n      }\n    }\n\n    return result\n  }\n\n  /**\n   * Deep merge two objects\n   * App messages override core messages at leaf level\n   */\n  private deepMerge(\n    target: Record<string, unknown>,\n    source: Record<string, unknown>\n  ): Record<string, unknown> {\n    const result: Record<string, unknown> = { ...target }\n\n    for (const key of Object.keys(source)) {\n      const targetValue = target[key]\n      const sourceValue = source[key]\n\n      if (\n        typeof targetValue === 'object' &&\n        targetValue !== null &&\n        !Array.isArray(targetValue) &&\n        typeof sourceValue === 'object' &&\n        sourceValue !== null &&\n        !Array.isArray(sourceValue)\n      ) {\n        // Both are objects, deep merge\n        result[key] = this.deepMerge(\n          targetValue as Record<string, unknown>,\n          sourceValue as Record<string, unknown>\n        )\n      } else {\n        // Source value overrides target\n        result[key] = sourceValue\n      }\n    }\n\n    return result\n  }\n}\n","/**\n * I18n Module\n *\n * Core infrastructure module for internationalization.\n * Provides message translation and locale handling.\n *\n * @example Default usage (system messages only)\n * ```typescript\n * // In Application.ts - I18nModule is already included in core modules\n * // Works with system messages and 'en' default locale\n * ```\n *\n * @example With app-specific configuration\n * ```typescript\n * // In apps/backend/src/app.module.ts\n * import { i18nConfig } from './i18n'\n *\n * @Module({\n *   imports: [I18nModule.forRoot(i18nConfig)],\n * })\n * export class AppModule {}\n * ```\n */\n\nimport { backendErrorMap, z } from './validation'\nimport { Scope } from '../di'\nimport type { MiddlewareConfigurable, MiddlewareConsumer } from '../middleware/types'\nimport { Module } from '../module'\nimport type { DynamicModule } from '../module/types'\nimport type { I18nModuleOptions } from './i18n.options'\nimport { I18N_TOKENS } from './i18n.tokens'\nimport { I18nContextMiddleware } from './middleware/i18n-context.middleware'\nimport { LocaleExtractionMiddleware } from './middleware/locale-extraction.middleware'\nimport { I18nService } from './services/i18n.service'\nimport { MessageLoaderService } from './services/message-loader.service'\nimport { setupI18nCompiler } from './setup'\n\n// Setup i18n JIT compiler once at module load time\n// This registers the message compiler globally for all I18nService instances\n// Must be called before any Application initialization\nsetupI18nCompiler()\n\n// Set global Zod error map for i18n support using v4 config API\n// This registers the custom error map that translates validation errors\n// Must be set once at module load time, before any schema validation\nz.config({ customError: backendErrorMap })\n\n\n@Module({\n  providers: [\n    // Singleton: Message loader (loaded once at startup, via Scope.Singleton)\n    { provide: I18N_TOKENS.MessageLoader, useClass: MessageLoaderService, scope: Scope.Singleton },\n    // Request-scoped: I18n service (per request via Scope.Request)\n    { provide: I18N_TOKENS.I18nService, useClass: I18nService },\n  ],\n})\nexport class I18nModule implements MiddlewareConfigurable {\n  /**\n   * Configure I18n with app-specific options\n   *\n   * Use this method in AppModule to provide custom locale configuration\n   * and app-specific messages that merge with system messages.\n   *\n   * @param options - I18n configuration options\n   * @returns Dynamic module with options provider\n   *\n   * @example\n   * ```typescript\n   * // apps/backend/src/i18n/index.ts\n   * export const i18nConfig: I18nModuleOptions = {\n   *   defaultLocale: 'en',\n   *   fallbackLocale: 'en',\n   *   locales: ['en', 'fr'],\n   *   messages: appMessages\n   * }\n   *\n   * // apps/backend/src/app.module.ts\n   * @Module({\n   *   imports: [I18nModule.forRoot(i18nConfig)],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRoot(options: I18nModuleOptions = {}): DynamicModule {\n    return {\n      module: I18nModule,\n      providers: [\n        { provide: I18N_TOKENS.Options, useValue: options },\n      ],\n    }\n  }\n\n  /**\n   * Configure middleware for locale extraction and i18n context\n   */\n  configure(consumer: MiddlewareConsumer): void {\n    consumer\n      .apply(LocaleExtractionMiddleware, I18nContextMiddleware)\n      .forRoutes('*')\n  }\n}\n"],"mappings":"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"}

package/dist/index-CSuHOJc3.d.mts

@@ -0,0 +1,319 @@
+//#region src/i18n/messages/en/common.d.ts
+/**
+ * System Common Messages - English
+ *
+ * Common messages used by packages/modules infrastructure.
+ * These are automatically merged with application-specific messages.
+ */
+declare const common: {
+  readonly api: {
+    readonly title: "Stratal API";
+    readonly description: "Platform API";
+    readonly serverDescription: "API server";
+    readonly security: {
+      readonly bearerAuth: "JWT Bearer token authentication";
+      readonly apiKey: "API key for service authentication";
+      readonly sessionCookie: "Session cookie for browser authentication";
+    };
+  };
+};
+//#endregion
+//#region src/i18n/messages/en/errors.d.ts
+/**
+ * System Error Messages - English
+ *
+ * Error messages used by packages/modules infrastructure.
+ * These are automatically merged with application-specific messages.
+ */
+declare const errors: {
+  readonly internalError: "An internal error occurred";
+  readonly notFound: "Resource not found";
+  readonly unauthorized: "Unauthorized. Please sign in.";
+  readonly forbidden: "Access denied";
+  readonly honoAppAlreadyConfigured: "HonoApp has already been configured and can only be configured once";
+  readonly routeNotFound: "Route not found: {method} {path}";
+  readonly routeAccessDenied: "Resource not found";
+  readonly controllerMethodNotFound: "Method {methodName} not found on {controllerName}";
+  readonly controllerRegistration: "Failed to register controller {controllerName}: {reason}";
+  readonly websocketBodyNotAvailable: "body() is not available in WebSocket gateways. Use WebSocket messages instead.";
+  readonly websocketDuplicateEventHandler: "@{decorator}() is already applied to '{existingMethod}'. Only one method per gateway can handle this event.";
+  readonly contextNotInitialized: "Context has not been initialized";
+  readonly userNotAuthenticated: "User is not authenticated";
+  readonly insufficientPermissions: "Insufficient permissions to perform this action";
+  readonly requestContainerNotInitialized: "Request container has not been initialized";
+  readonly requestScopeOperationNotAllowed: "{methodName}() cannot be called on this container scope. Check if you are calling it on the correct container (global vs request-scoped).";
+  readonly conditionalBindingFallback: "Conditional binding predicate returned false for token \"{token}\" but no fallback was provided and no existing registration exists.";
+  readonly configNotInitialized: "Configuration service has not been initialized";
+  readonly configModuleNotInitialized: "ConfigModule.forRoot() was not called before module initialization";
+  readonly stratalNotInitialized: "Stratal has not been instantiated. Ensure you export a Stratal instance as the default export.";
+  readonly moduleAlreadyRegistered: "Module {moduleName} is already registered";
+  readonly moduleDependencyNotFound: "Module dependency {dependency} not found for module {moduleName}";
+  readonly moduleCircularDependency: "Circular dependency detected: {cycle}";
+  readonly invalidModuleProvider: "Invalid module provider configuration: {provider}";
+  readonly databaseGeneric: "Database error occurred";
+  readonly databaseRecordNotFound: "Record not found in database";
+  readonly databaseUniqueConstraint: "Record already exists";
+  readonly databaseForeignKeyConstraint: "Related record not found";
+  readonly databaseConnectionFailed: "Failed to connect to database";
+  readonly databaseTimeout: "Database query timeout";
+  readonly databaseNullConstraint: "Required field is missing";
+  readonly databaseTooManyConnections: "Too many database connections";
+  readonly databaseTransactionConflict: "Transaction conflict or deadlock";
+  readonly databaseConstraintFailed: "A database constraint was violated";
+  readonly databaseTableNotFound: "The specified table does not exist in the database";
+  readonly databaseColumnNotFound: "The specified column does not exist in the table";
+  readonly databaseInvalidQuery: "The database query is invalid or malformed";
+  readonly invalidErrorCodeRange: "Invalid error code range: {code}";
+  readonly queueBindingNotFound: "Queue binding {queueName} not found in environment";
+  readonly queueProviderNotSupported: "Queue provider \"{provider}\" is not supported. Valid providers: cloudflare, sync";
+  readonly cronExecutionFailed: "{count} cron job(s) failed for schedule \"{schedule}\": {jobs}";
+  readonly localeNotSupported: "Locale '{locale}' is not supported. Supported locales: {supportedLocales}";
+  readonly translationMissing: "Translation missing for key '{key}' in locale '{locale}'";
+  readonly schemaValidation: "Schema validation failed";
+  readonly openapiValidation: "OpenAPI validation failed: {details}";
+  readonly openapiRouteRegistration: "Failed to register OpenAPI route {path}: {reason}";
+  readonly email: {
+    readonly resendApiKeyMissing: "Resend API key not configured. Set RESEND_EMAIL_API_KEY environment variable.";
+    readonly smtpConfigurationMissing: "SMTP configuration missing. Set SMTP_URL environment variable.";
+    readonly smtpHostMissing: "SMTP host not configured. Check SMTP_URL format (smtp://user:pass@host:port).";
+    readonly smtpConnectionFailed: "Failed to connect to SMTP server {smtpHost}:{smtpPort}";
+    readonly resendApiFailed: "Resend API error";
+    readonly providerNotSupported: "Unsupported email provider: {provider}. Supported providers: resend, smtp";
+  };
+  readonly storage: {
+    readonly fileNotFound: "File at path \"{path}\" was not found";
+    readonly invalidDisk: "Storage disk \"{disk}\" is not configured";
+    readonly invalidFileType: "File type \"{mimeType}\" is not allowed";
+    readonly fileTooLarge: "File size {size} exceeds maximum allowed size of {maxSize}";
+    readonly presignedUrlInvalidExpiry: "Expiry must be between {min} and {max} seconds";
+    readonly diskNotConfigured: "Disk \"{disk}\" is not configured";
+    readonly providerNotSupported: "Storage provider \"{provider}\" is not supported";
+    readonly responseBodyMissing: "No body in storage response for path: {path}";
+  };
+  readonly cache: {
+    readonly getFailed: "Failed to retrieve value from cache for key '{key}'";
+    readonly putFailed: "Failed to store value in cache for key '{key}'";
+    readonly deleteFailed: "Failed to delete value from cache for key '{key}'";
+    readonly listFailed: "Failed to list cache keys";
+  };
+  readonly auth: {
+    readonly tokenRequired: "Verification token is required";
+    readonly invalidToken: "Invalid or expired verification token";
+    readonly verificationFailed: "Verification failed. Please try again.";
+    readonly userNotFound: "User not found. Please check your credentials.";
+    readonly invalidCredentials: "Invalid email or password";
+    readonly invalidPassword: "Invalid password";
+    readonly invalidEmail: "Invalid email address";
+    readonly sessionExpired: "Your session has expired. Please sign in again.";
+    readonly emailNotVerified: "Please verify your email address before signing in";
+    readonly passwordTooShort: "Password must be at least {minLength} characters";
+    readonly passwordTooLong: "Password must be at most {maxLength} characters";
+    readonly accountAlreadyExists: "An account with this email already exists";
+    readonly failedToCreateUser: "Failed to create user account. Please try again.";
+    readonly failedToCreateSession: "Failed to create session. Please try again.";
+    readonly failedToGetSession: "Failed to retrieve session. Please try again.";
+    readonly failedToUpdateUser: "Failed to update user information. Please try again.";
+    readonly failedToGetUserInfo: "Failed to retrieve user information. Please try again.";
+    readonly socialAccountLinked: "This social account is already linked to another user";
+    readonly providerNotFound: "Authentication provider not found";
+    readonly userEmailNotFound: "User email address not found";
+    readonly accountNotFound: "Account not found";
+    readonly credentialAccountNotFound: "Credential account not found";
+    readonly cannotUnlinkLastAccount: "Cannot unlink your last account";
+    readonly userAlreadyHasPassword: "User already has a password set";
+    readonly emailCannotBeUpdated: "Email address cannot be updated at this time";
+    readonly tokenExpired: "The verification token has expired. Please request a new verification email.";
+  };
+  readonly seederNameCollision: "Seeder name collision: \"{name}\" is already registered. Use distinct class names for each seeder.";
+  readonly seederNotRegistered: "Seeder \"{name}\" is not registered";
+  readonly migration: {
+    readonly failed: "Migration {migrationName} failed: {error}";
+    readonly checksumMismatch: "Migration {migrationName} checksum mismatch (expected: {expected}, actual: {actual})";
+    readonly alreadyApplied: "Migration {migrationName} has already been applied";
+    readonly notFound: "Migration {migrationName} not found";
+  };
+};
+//#endregion
+//#region src/i18n/messages/en/emails.d.ts
+/**
+ * System Email Messages - English
+ *
+ * Email-related messages used by packages/modules infrastructure.
+ * These are automatically merged with application-specific messages.
+ */
+declare const emails: {
+  readonly magicLink: {
+    readonly subject: "Your sign-in link";
+  };
+};
+//#endregion
+//#region src/i18n/messages/en/validation.d.ts
+/**
+ * Form validation messages - English
+ */
+declare const validation: {
+  readonly required: "This field is required";
+  readonly email: "Invalid email address";
+  readonly minLength: "Must be at least {min} characters";
+  readonly maxLength: "Must not exceed {max} characters";
+  readonly min: "Must be at least {min}";
+  readonly max: "Must not exceed {max}";
+  readonly pattern: "Invalid format";
+  readonly numeric: "Must be a number";
+  readonly url: "Invalid URL";
+  readonly date: "Invalid date";
+  readonly passwordStrength: "Password must contain at least one uppercase letter, one lowercase letter, and one number";
+  readonly passwordMatch: "Passwords do not match";
+  readonly unique: "This value already exists";
+  readonly phone: "Invalid phone number";
+  readonly fileRequired: "Please upload a file";
+  readonly fileTooLarge: "File must be smaller than {max}";
+  readonly invalidFileType: "Please upload a PDF, JPG, or PNG file";
+  readonly schoolTypes: {
+    readonly required: "School type is required";
+    readonly atLeastOne: "Please select at least one school type";
+    readonly invalidCode: "Invalid school type: {code}";
+    readonly notAvailableInCountry: "{schoolType} is not available in {country}";
+    readonly countryNotSupported: "Country {country} is not supported";
+  };
+  readonly timezone: {
+    readonly required: "Timezone is required";
+    readonly invalid: "Invalid timezone. Please select a valid IANA timezone.";
+  };
+  readonly locale: {
+    readonly required: "Language is required";
+    readonly invalid: "Invalid language. Supported languages: {locales}";
+  };
+};
+//#endregion
+//#region src/i18n/messages/en/zod.d.ts
+/**
+ * Zod validation error messages - English
+ *
+ * Comprehensive messages for all Zod validation error codes
+ * Structured to match Zod's issue types and validation contexts
+ */
+declare const zodI18n: {
+  readonly errors: {
+    readonly required: "Required";
+    readonly invalid_type: "Expected {expected}, received {received}";
+    readonly invalid_literal: "Invalid literal value, expected {expected}";
+    readonly custom: {
+      readonly default: "Invalid value";
+      readonly emailOrTextRequired: "Either html or text content must be provided";
+      readonly invalidFromEmail: "Invalid from email address";
+      readonly fileInstanceRequired: "File must be a File instance";
+      readonly filePathRequired: "File path is required";
+      readonly diskNameRequired: "Disk name is required";
+      readonly endpointRequired: "Endpoint URL is required for S3";
+      readonly bucketNameRequired: "Bucket name is required";
+      readonly accessKeyRequired: "Access key ID is required";
+      readonly secretKeyRequired: "Secret access key is required";
+      readonly storageDiskRequired: "At least one storage disk is required";
+      readonly databaseUrlRequired: "Database URL is required";
+      readonly domainRequired: "Domain is required";
+      readonly domainTooLong: "Domain too long";
+      readonly invalidDomainFormat: "Invalid domain format";
+    };
+    readonly invalid_union: "Invalid input";
+    readonly invalid_union_discriminator: "Invalid discriminator value. Expected {options}";
+    readonly invalid_enum_value: "Invalid enum value. Expected {options}, received {received}";
+    readonly unrecognized_keys: "Unrecognized key(s) in object: {keys}";
+    readonly invalid_arguments: "Invalid function arguments";
+    readonly invalid_return_type: "Invalid function return type";
+    readonly invalid_date: "Invalid date";
+    readonly invalid_intersection_types: "Intersection results could not be merged";
+    readonly not_multiple_of: "Number must be a multiple of {multipleOf}";
+    readonly not_finite: "Number must be finite";
+    readonly invalid_string: {
+      readonly email: "Invalid email address";
+      readonly url: "Invalid URL";
+      readonly uuid: "Invalid UUID";
+      readonly cuid: "Invalid CUID";
+      readonly cuid2: "Invalid CUID2";
+      readonly ulid: "Invalid ULID";
+      readonly regex: "Invalid format";
+      readonly datetime: "Invalid datetime";
+      readonly ip: "Invalid IP address";
+      readonly emoji: "Invalid emoji";
+      readonly startsWith: "Must start with \"{startsWith}\"";
+      readonly endsWith: "Must end with \"{endsWith}\"";
+      readonly includes: "Must include \"{includes}\"";
+      readonly base64: "Invalid Base64";
+      readonly nanoid: "Invalid NanoID";
+      readonly cidr: "Invalid CIDR";
+      readonly jwt: "Invalid JWT";
+      readonly time: "Invalid time";
+    };
+    readonly too_small: {
+      readonly string: {
+        readonly exact: "Must be exactly {minimum} characters";
+        readonly inclusive: "Must be at least {minimum} characters";
+        readonly not_inclusive: "Must be more than {minimum} characters";
+      };
+      readonly number: {
+        readonly exact: "Must be exactly {minimum}";
+        readonly inclusive: "Must be at least {minimum}";
+        readonly not_inclusive: "Must be greater than {minimum}";
+      };
+      readonly array: {
+        readonly exact: "Must contain exactly {minimum} item(s)";
+        readonly inclusive: "Must contain at least {minimum} item(s)";
+        readonly not_inclusive: "Must contain more than {minimum} item(s)";
+      };
+      readonly set: {
+        readonly exact: "Must contain exactly {minimum} item(s)";
+        readonly inclusive: "Must contain at least {minimum} item(s)";
+        readonly not_inclusive: "Must contain more than {minimum} item(s)";
+      };
+      readonly date: {
+        readonly exact: "Date must be {minimum}";
+        readonly inclusive: "Date must be {minimum} or later";
+        readonly not_inclusive: "Date must be after {minimum}";
+      };
+      readonly bigint: {
+        readonly exact: "Must be exactly {minimum}";
+        readonly inclusive: "Must be at least {minimum}";
+        readonly not_inclusive: "Must be greater than {minimum}";
+      };
+    };
+    readonly too_big: {
+      readonly string: {
+        readonly exact: "Must be exactly {maximum} characters";
+        readonly inclusive: "Must be at most {maximum} characters";
+        readonly not_inclusive: "Must be less than {maximum} characters";
+      };
+      readonly number: {
+        readonly exact: "Must be exactly {maximum}";
+        readonly inclusive: "Must be at most {maximum}";
+        readonly not_inclusive: "Must be less than {maximum}";
+      };
+      readonly array: {
+        readonly exact: "Must contain exactly {maximum} item(s)";
+        readonly inclusive: "Must contain at most {maximum} item(s)";
+        readonly not_inclusive: "Must contain less than {maximum} item(s)";
+      };
+      readonly set: {
+        readonly exact: "Must contain exactly {maximum} item(s)";
+        readonly inclusive: "Must contain at most {maximum} item(s)";
+        readonly not_inclusive: "Must contain less than {maximum} item(s)";
+      };
+      readonly date: {
+        readonly exact: "Date must be {maximum}";
+        readonly inclusive: "Date must be {maximum} or earlier";
+        readonly not_inclusive: "Date must be before {maximum}";
+      };
+      readonly bigint: {
+        readonly exact: "Must be exactly {maximum}";
+        readonly inclusive: "Must be at most {maximum}";
+        readonly not_inclusive: "Must be less than {maximum}";
+      };
+    };
+  };
+};
+declare namespace index_d_exports {
+  export { common, emails, errors, validation, zodI18n };
+}
+//#endregion
+export { errors as a, emails as i, zodI18n as n, common as o, validation as r, index_d_exports as t };
+//# sourceMappingURL=index-CSuHOJc3.d.mts.map

package/dist/index-CSuHOJc3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CSuHOJc3.d.mts","names":[],"sources":["../src/i18n/messages/en/common.ts","../src/i18n/messages/en/errors.ts","../src/i18n/messages/en/emails.ts","../src/i18n/messages/en/validation.ts","../src/i18n/messages/en/zod.ts","../src/i18n/messages/en/index.ts"],"mappings":";;;;AAOA;;;cAAa,MAAA;EAAA;;;;;;;;;;;;;;;;AAAb;;;cCAa,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ADAb;;;cEAa,MAAA;EAAA,SAIH,SAAA;IAAA,SAAA,OAAA;EAAA;AAAA;;;;;;cCPG,UAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AHGb;;;cIAa,OAAA;EAAA"}