stratal 0.0.26 → 0.1.0

package/dist/openapi-CMwuCp31.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi-CMwuCp31.mjs","names":[],"sources":["../src/openapi/services/openapi-config.service.ts","../src/openapi/services/openapi-config.store.ts","../src/openapi/services/openapi.service.ts","../src/openapi/openapi.module.ts"],"sourcesContent":["import { inject } from '../../di'\nimport { Request } from '../../di/decorators'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type {\n  IOpenAPIConfigService,\n  IOpenAPIConfigStore,\n  OpenAPIConfigOverride,\n  OpenAPIEffectiveConfig\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@Request(OPENAPI_TOKENS.ConfigService)\nexport class OpenAPIConfigService implements IOpenAPIConfigService {\n  private overrides: OpenAPIConfigOverride[] = []\n\n  constructor(\n    @inject(OPENAPI_TOKENS.ConfigStore) private store: IOpenAPIConfigStore\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  /** Get effective configuration (base merged with all overrides) */\n  getEffectiveConfig(): OpenAPIEffectiveConfig {\n    let effective = this.store.getBaseConfig()\n\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      routeFilter: override.routeFilter ?? base.routeFilter\n    }\n  }\n}\n","import { inject } from '../../di'\nimport { Singleton } from '../../di/decorators'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type {\n  IOpenAPIConfigStore,\n  OpenAPIEffectiveConfig,\n  OpenAPIModuleOptions\n} from '../types'\n\n/**\n * OpenAPI Config Store\n *\n * Singleton holder of the static base configuration (mount paths, base info,\n * security schemes) derived from `OpenAPIModule.forRoot()` options. It carries\n * no per-request state, so it is the thing to resolve when you need OpenAPI\n * config OUTSIDE a request scope — endpoint mounting at bootstrap, the\n * `mcp:serve` CLI command, etc. Resolving it never throws on its own.\n *\n * Per-request overrides live on {@link OpenAPIConfigService}, which reads the\n * base config from here and merges its overrides on top.\n */\n@Singleton(OPENAPI_TOKENS.ConfigStore)\nexport class OpenAPIConfigStore implements IOpenAPIConfigStore {\n  constructor(\n    @inject(OPENAPI_TOKENS.Options, { isOptional: true }) private baseOptions?: OpenAPIModuleOptions\n  ) { }\n\n  getBaseConfig(): OpenAPIEffectiveConfig {\n    return {\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}\n","import type { Container } from '../../di/container'\nimport { Singleton } from '../../di/decorators'\nimport { I18N_TOKENS } from '../../i18n/i18n.tokens'\nimport type { II18nService } from '../../i18n/i18n.types'\nimport type { OpenAPIHono, OpenAPIObject, PathItemObject } from '../../i18n/validation/zod'\nimport { ROUTER_CONTEXT_KEYS, SECURITY_SCHEMES } from '../../router/constants'\nimport type { RouterEnv } from '../../router/types'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type { IOpenAPIConfigService, IOpenAPIConfigStore, OpenAPIEffectiveConfig } from '../types'\n\n/**\n * OpenAPI Service\n *\n * Generates OpenAPI specifications with support for:\n * - Runtime configuration via OpenAPIConfigService\n * - Route filtering via custom routeFilter\n * - i18n support for titles and descriptions\n * - Security scheme definitions\n *\n * Hidden routes (hideFromDocs) are excluded at registration time via\n * @hono/zod-openapi's `hide` option and don't appear in the spec.\n *\n * Configuration is resolved per-request from OpenAPIConfigService,\n * allowing middleware to override config based on domain context.\n */\n@Singleton(OPENAPI_TOKENS.OpenAPIService)\nexport class OpenAPIService {\n\n  /**\n   * Generate a filtered OpenAPI spec using the user's config.\n   * Usable from both HTTP handlers and CLI commands.\n   */\n  getSpec(app: OpenAPIHono<RouterEnv>, container: Container): OpenAPIObject {\n    const configService = container.resolve<IOpenAPIConfigService>(OPENAPI_TOKENS.ConfigService)\n    const i18n = container.resolve<II18nService>(I18N_TOKENS.I18nService)\n    const config = configService.getEffectiveConfig()\n\n    const fullSpec = app.getOpenAPIDocument({\n      openapi: '3.0.0',\n      info: {\n        version: config.info.version,\n        title: config.info.title,\n        description: config.info.description,\n      },\n    })\n\n    // Security schemes\n    fullSpec.components ??= {}\n    fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n)\n\n    // Apply custom routeFilter if provided\n    if (config.routeFilter) {\n      fullSpec.paths = this.filterRoutes(\n        fullSpec.paths as Record<string, PathItemObject>,\n        config,\n      )\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 fullSpec\n  }\n\n  /**\n   * Setup OpenAPI documentation endpoints\n   */\n  setupEndpoints(app: OpenAPIHono<RouterEnv>, container: Container): void {\n    // Endpoints are mounted at bootstrap (no request scope), so read the static\n    // mount paths from the singleton config store — request overrides (info /\n    // routeFilter) never affect jsonPath/ui and are resolved per request inside\n    // the handlers below via the request-scoped config service.\n    const config = container.resolve<IOpenAPIConfigStore>(OPENAPI_TOKENS.ConfigStore).getBaseConfig()\n    const jsonPath = config.jsonPath\n    const ui = config.ui\n\n    // OpenAPI JSON spec endpoint\n    app.get(jsonPath, (c) => {\n      const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n      const fullSpec = this.getSpec(app, requestContainer)\n\n      // Add servers (HTTP-specific — needs request URL context)\n      const url = new URL(c.req.raw.url)\n      const i18n = requestContainer.resolve<II18nService>(I18N_TOKENS.I18nService)\n      fullSpec.servers = [{\n        url: `${url.protocol}//${url.host}`,\n        description: i18n.t('common.api.serverDescription'),\n      }]\n\n      return c.json(fullSpec)\n    })\n    this.nameLastHandler(app, 'OpenAPI', 'spec')\n\n    // Docs UI endpoint\n    if (ui !== false) {\n      const uiPath = ui?.path ?? '/api/docs'\n      const uiRenderer = ui?.renderer\n\n      app.get(uiPath, async (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        const { swaggerUI } = await import('@hono/swagger-ui')\n        return swaggerUI<RouterEnv>({ url: uiContext.specUrl })(c, next)\n      })\n      this.nameLastHandler(app, 'OpenAPI', 'docs')\n    }\n  }\n\n  private nameLastHandler(app: OpenAPIHono<RouterEnv>, controller: string, method: string): void {\n    const last = app.routes[app.routes.length - 1]\n    Object.defineProperty(last.handler, 'name', { value: `http:${controller}.${method}` })\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   * Filter OpenAPI paths using 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      if (config.routeFilter && !config.routeFilter(path, pathItem)) {\n        continue\n      }\n\n      filteredPaths[path] = pathItem\n    }\n\n    return filteredPaths\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      const allSchemas = components.schemas as Record<string, unknown>\n      let prevSize = 0\n      while (referencedSchemas.size > prevSize) {\n        prevSize = referencedSchemas.size\n        for (const [schemaName, schemaValue] of Object.entries(allSchemas)) {\n          if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) {\n            filteredSchemas[schemaName] = schemaValue\n            this.collectSchemaRefs(schemaValue, referencedSchemas)\n          }\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 { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule } from '../module/types'\nimport { OPENAPI_TOKENS } from './openapi.tokens'\nimport { OpenAPIConfigService, OpenAPIConfigStore, 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    // Static base config (singleton — resolvable outside a request scope)\n    { provide: OPENAPI_TOKENS.ConfigStore, useClass: OpenAPIConfigStore },\n    // OpenAPI config service (request-scoped, supports runtime overrides)\n    { provide: OPENAPI_TOKENS.ConfigService, useClass: OpenAPIConfigService },\n    // OpenAPI service (singleton — serves spec and docs 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"],"mappings":"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"}

package/dist/openapi-tools.service-BC5EC3R3.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi-tools.service-BC5EC3R3.mjs","names":[],"sources":["../src/openapi/openapi.tokens.ts","../src/openapi/services/openapi-tools.service.ts"],"sourcesContent":["/**\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  /**\n   * Singleton holder of the static base config. Resolvable outside a request\n   * (bootstrap endpoint mounting, CLI commands) for static config — never throws\n   * on resolve and carries no per-request state.\n   */\n  ConfigStore: Symbol.for('stratal:openapi:config:store'),\n\n  /** Request-scoped config service that layers runtime overrides over the store */\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 type { OpenAPIObject } from '../../i18n/validation/zod'\nimport type { HttpMethod } from '../../router/types'\n\ntype JsonSchema = Record<string, unknown>\n\nexport interface ToolDefinition {\n  name: string\n  description: string\n  inputSchema: JsonSchema\n  method: string\n  path: string\n  pathParams: string[]\n}\n\nexport interface ToolExecutionResult {\n  status: number\n  body: string\n  headers: Record<string, string>\n}\n\nexport interface ToolFilter {\n  tags?: string[]\n  pathPrefix?: string\n}\n\nexport type Dispatcher = (method: string, url: string, options?: {\n  body?: unknown\n  headers?: Record<string, string>\n}) => Promise<Response>\n\ninterface OperationObject {\n  operationId?: string\n  summary?: string\n  description?: string\n  tags?: string[]\n  parameters?: ParameterObject[]\n  requestBody?: RequestBodyObject\n}\n\ninterface ParameterObject {\n  name: string\n  in: string\n  required?: boolean\n  schema?: JsonSchema\n  description?: string\n}\n\ninterface RequestBodyObject {\n  required?: boolean\n  content?: Record<string, { schema?: JsonSchema }>\n}\n\n/**\n * Converts an OpenAPI 3.0 spec into callable tool definitions.\n *\n * Plain class (no DI) — reusable across MCP, CLI, and custom tooling.\n */\nexport class OpenApiToolsService {\n  private static readonly HTTP_METHODS: Set<string> = new Set<HttpMethod>(['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'trace'])\n\n  private tools: ToolDefinition[] = []\n  private toolMap = new Map<string, ToolDefinition>()\n  private dispatcher?: Dispatcher\n\n  private spec: OpenAPIObject\n\n  constructor(spec: OpenAPIObject, options?: { dispatcher?: Dispatcher }) {\n    this.spec = spec\n    this.dispatcher = options?.dispatcher\n    this.tools = this.buildTools()\n    for (const tool of this.tools) {\n      this.toolMap.set(tool.name, tool)\n    }\n  }\n\n  getTools(filter?: ToolFilter): ToolDefinition[] {\n    let tools = this.tools\n\n    if (filter?.tags?.length) {\n      const tagSet = new Set(filter.tags)\n      tools = tools.filter((t) => {\n        const op = this.getOperation(t.method, t.path)\n        return op?.tags?.some((tag) => tagSet.has(tag)) ?? false\n      })\n    }\n\n    if (filter?.pathPrefix) {\n      const prefix = filter.pathPrefix\n      tools = tools.filter((t) => t.path.startsWith(prefix))\n    }\n\n    return tools\n  }\n\n  getTool(name: string): ToolDefinition | undefined {\n    return this.toolMap.get(name)\n  }\n\n  async executeTool(name: string, args: Record<string, unknown>): Promise<ToolExecutionResult> {\n    const tool = this.toolMap.get(name)\n    if (!tool) {\n      throw new Error(`Tool not found: ${name}`)\n    }\n    if (!this.dispatcher) {\n      throw new Error('No dispatcher configured')\n    }\n\n    // Interpolate path params\n    let url = tool.path\n    for (const param of tool.pathParams) {\n      const value = args[`path_${param}`]\n      if (value === undefined) {\n        throw new Error(`Missing required path parameter: ${param}`)\n      }\n      url = url.replace(`{${param}}`, encodeURIComponent(value != null && typeof value === 'object' ? JSON.stringify(value) : String(value as string | number | boolean)))\n    }\n\n    // Collect query params\n    const queryParts: string[] = []\n    for (const key of Object.keys(args)) {\n      if (key.startsWith('query_')) {\n        const paramName = key.slice(6)\n        const value = args[key]\n        queryParts.push(`${encodeURIComponent(paramName)}=${encodeURIComponent(value != null && typeof value === 'object' ? JSON.stringify(value) : String(value as string | number | boolean))}`)\n      }\n    }\n    if (queryParts.length > 0) {\n      url += `?${queryParts.join('&')}`\n    }\n\n    const body = args.body\n    const response = await this.dispatcher(\n      tool.method.toUpperCase(),\n      url,\n      body !== undefined ? { body } : undefined,\n    )\n\n    const responseHeaders: Record<string, string> = {}\n    response.headers.forEach((value, key) => {\n      responseHeaders[key] = value\n    })\n\n    return {\n      status: response.status,\n      body: await response.text(),\n      headers: responseHeaders,\n    }\n  }\n\n  private buildTools(): ToolDefinition[] {\n    const tools: ToolDefinition[] = []\n    const paths = this.spec.paths\n\n    for (const [path, pathItem] of Object.entries(paths)) {\n      for (const [method, operation] of Object.entries(pathItem)) {\n        if (!operation || typeof operation !== 'object') continue\n        if (!OpenApiToolsService.HTTP_METHODS.has(method.toLowerCase())) continue\n\n        const op = operation as OperationObject\n        const name = op.operationId ?? this.generateName(method, path)\n        const description = this.buildDescription(op, method, path)\n        const pathItemParams = (pathItem as Record<string, unknown>).parameters as ParameterObject[] | undefined\n        const mergedParameters = this.mergeParameters(pathItemParams, op.parameters)\n        const { schema, pathParams } = this.buildInputSchema({ ...op, parameters: mergedParameters })\n\n        tools.push({ name, description, inputSchema: schema, method: method.toUpperCase(), path, pathParams })\n      }\n    }\n\n    return tools\n  }\n\n  private generateName(method: string, path: string): string {\n    const snake = path\n      .replace(/[{}]/g, '')\n      .replace(/[^a-zA-Z0-9]+/g, '_')\n      .replace(/^_|_$/g, '')\n      .toLowerCase()\n    return `${method.toLowerCase()}_${snake}`\n  }\n\n  private buildDescription(op: OperationObject, method: string, path: string): string {\n    if (op.summary && op.description) {\n      return `${op.summary} — ${op.description}`\n    }\n    return op.summary ?? op.description ?? `${method.toUpperCase()} ${path}`\n  }\n\n  private buildInputSchema(op: OperationObject): { schema: JsonSchema; pathParams: string[] } {\n    const properties: Record<string, JsonSchema> = {}\n    const required: string[] = []\n    const pathParams: string[] = []\n\n    // Parameters (path + query)\n    for (const param of op.parameters ?? []) {\n      const resolvedParam = this.resolveRef(param) as ParameterObject\n      const paramSchema = resolvedParam.schema ? this.resolveRef(resolvedParam.schema) as JsonSchema : { type: 'string' }\n\n      if (resolvedParam.in === 'path') {\n        pathParams.push(resolvedParam.name)\n        const key = `path_${resolvedParam.name}`\n        properties[key] = { ...paramSchema }\n        if (resolvedParam.description) properties[key].description = resolvedParam.description\n        required.push(key)\n      } else if (resolvedParam.in === 'query') {\n        const key = `query_${resolvedParam.name}`\n        properties[key] = { ...paramSchema }\n        if (resolvedParam.description) properties[key].description = resolvedParam.description\n        if (resolvedParam.required) required.push(key)\n      }\n    }\n\n    // Request body\n    const resolvedBody = op.requestBody ? this.resolveRef(op.requestBody) as RequestBodyObject : undefined\n    if (resolvedBody) {\n      const jsonContent = resolvedBody.content?.['application/json']\n      if (jsonContent?.schema) {\n        properties.body = this.resolveRef(jsonContent.schema) as JsonSchema\n      } else {\n        properties.body = { type: 'object' }\n      }\n      const needsBody = resolvedBody.required === true\n      if (needsBody) {\n        required.push('body')\n      }\n    }\n\n    const schema: JsonSchema = { type: 'object', properties }\n    if (required.length > 0) {\n      schema.required = required\n    }\n\n    return { schema, pathParams }\n  }\n\n  private mergeParameters(pathLevel?: ParameterObject[], opLevel?: ParameterObject[]): ParameterObject[] {\n    const resolvedPathLevel = pathLevel?.map((p) => this.resolveRef(p) as ParameterObject)\n    const resolvedOpLevel = opLevel?.map((p) => this.resolveRef(p) as ParameterObject)\n\n    if (!resolvedPathLevel?.length) return resolvedOpLevel ?? []\n    if (!resolvedOpLevel?.length) return resolvedPathLevel\n\n    const opKeys = new Set(resolvedOpLevel.map((p) => `${p.in}:${p.name}`))\n    const inherited = resolvedPathLevel.filter((p) => !opKeys.has(`${p.in}:${p.name}`))\n    return [...inherited, ...resolvedOpLevel]\n  }\n\n  private resolveRef(obj: unknown, seen = new Set<string>()): unknown {\n    if (!obj || typeof obj !== 'object') return obj\n    const record = obj as Record<string, unknown>\n\n    if (typeof record.$ref === 'string') {\n      const refPath = record.$ref\n      if (seen.has(refPath)) return obj\n      seen.add(refPath)\n\n      const resolved = this.lookupRef(refPath)\n      if (!resolved) return obj\n      return this.resolveRef(resolved, seen)\n    }\n\n    // Recursively walk all properties and resolve nested $refs\n    const result: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(record)) {\n      if (Array.isArray(value)) {\n        result[key] = value.map((item) => this.resolveRef(item, seen))\n      } else if (value && typeof value === 'object') {\n        result[key] = this.resolveRef(value, seen)\n      } else {\n        result[key] = value\n      }\n    }\n    return result\n  }\n\n  private lookupRef(refPath: string): unknown {\n    const components = this.spec.components as Record<string, Record<string, unknown>> | undefined\n    if (!components) return undefined\n\n    const match = /^#\\/components\\/(\\w+)\\/(.+)$/.exec(refPath)\n    if (!match) return undefined\n\n    const [, section, name] = match\n    const sectionObj = components[section]\n    if (typeof sectionObj !== 'object') return undefined\n    return sectionObj[name]\n  }\n\n  private getOperation(method: string, path: string): OperationObject | undefined {\n    const paths = this.spec.paths as Record<string, Record<string, unknown>> | undefined\n    return paths?.[path]?.[method.toLowerCase()] as OperationObject | undefined\n  }\n}\n"],"mappings":"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"}

package/dist/openapi.service-2rvJBCEg.d.mts

@@ -1,50 +0,0 @@
-import { $ as Container, fr as RouterEnv } from "./index-uybm0bhQ.mjs";
-import { n as OpenAPIObject, t as OpenAPIHono } from "./zod-wecrEVAs.mjs";
-
-//#region src/openapi/services/openapi.service.d.ts
-/**
- * OpenAPI Service
- *
- * Generates OpenAPI specifications with support for:
- * - Runtime configuration via OpenAPIConfigService
- * - Route filtering via custom routeFilter
- * - i18n support for titles and descriptions
- * - Security scheme definitions
- *
- * Hidden routes (hideFromDocs) are excluded at registration time via
- * @hono/zod-openapi's `hide` option and don't appear in the spec.
- *
- * Configuration is resolved per-request from OpenAPIConfigService,
- * allowing middleware to override config based on domain context.
- */
-declare class OpenAPIService {
-  /**
-   * Generate a filtered OpenAPI spec using the user's config.
-   * Usable from both HTTP handlers and CLI commands.
-   */
-  getSpec(app: OpenAPIHono<RouterEnv>, container: Container): OpenAPIObject;
-  /**
-   * Setup OpenAPI documentation endpoints
-   */
-  setupEndpoints(app: OpenAPIHono<RouterEnv>, container: Container): void;
-  private nameLastHandler;
-  /**
-   * Get localized security scheme definitions
-   */
-  private getSecuritySchemeDefinitions;
-  /**
-   * Filter OpenAPI paths using custom routeFilter
-   */
-  private filterRoutes;
-  /**
-   * Filter unreferenced schemas from OpenAPI spec
-   */
-  private filterSchemas;
-  /**
-   * Recursively collect all schema references from an object
-   */
-  private collectSchemaRefs;
-}
-//#endregion
-export { OpenAPIService as t };
-//# sourceMappingURL=openapi.service-2rvJBCEg.d.mts.map

package/dist/openapi.service-2rvJBCEg.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi.service-2rvJBCEg.d.mts","names":[],"sources":["../src/openapi/services/openapi.service.ts"],"mappings":";;;;;AAyBA;;;;;;;;;;;;;;cACa,cAAA;EAMH;;;;EAAR,OAAA,CAAQ,GAAA,EAAK,WAAA,CAAY,SAAA,GAAY,SAAA,EAAW,SAAA,GAAY,aAAA;EAqCxC;;;EAApB,cAAA,CAAe,GAAA,EAAK,WAAA,CAAY,SAAA,GAAY,SAAA,EAAW,SAAA;EAAA,QAkD/C,eAAA;EAAA;;;EAAA,QAQA,4BAAA;EA2EA;;AAAiB;EAAjB,QAjDA,YAAA;;;;UAoBA,aAAA;;;;UA6BA,iBAAA;AAAA"}

package/dist/quarry-registry-DRnV-DDa.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"quarry-registry-DRnV-DDa.d.mts","names":[],"sources":["../src/quarry/quarry-registry.ts"],"mappings":";;;;;;AAwBA;;;;;;;;cACa,cAAA,YAA0B,MAAA;EAAA,iBAKqB,SAAA;EAAA,QAJlD,QAAA;EAAA,QACA,UAAA;EAAA,QACA,OAAA;cAEkD,SAAA,EAAW,SAAA;EAyJlC;;;;EAnJ7B,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;EAXnB;;;EA8ErC,GAAA,CAAI,IAAA;EA3EI;;;EAmFR,GAAA,CAAI,IAAA,WAAe,WAAA,CAAY,OAAA;EA3EzB;;;EAmFN,GAAA,IAAO,GAAA,SAAY,WAAA,CAAY,OAAA;EAnFiB;;;EA0FhD,IAAA;IAAU,IAAA;IAAc,WAAA;IAAsB,OAAA;EAAA;EAP9C;;;EAiCM,SAAA,CAAU,OAAA;IAAY,UAAA;IAAqB,WAAA;IAAsB,aAAA;EAAA,IAA2B,OAAA;EAA5F;;;EAWA,KAAA,CAAM,IAAA,WAAe,OAAA;EAXX;;;;EA+BhB,QAAA,CAAS,YAAA,EAAc,WAAA,CAAY,OAAA;EAAA,QAkC3B,WAAA;EAAA,QAQA,WAAA;EAAA,QAIA,aAAA;AAAA"}

package/dist/quarry.module-CcGxU2dJ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"quarry.module-CcGxU2dJ.mjs","names":[],"sources":["../src/quarry/command-internals.ts","../src/quarry/signature-parser.ts","../src/quarry/quarry-registry.ts","../src/quarry/quarry.module.ts"],"sourcesContent":["import type { Command } from './command'\nimport { COMMAND_INTERNALS } from './constants'\nimport type { CommandInput, CommandInternals, CommandResult } from './types'\n\n/** @internal Set the flat input values before calling handle() */\nexport function setCommandInputs(command: Command, values: CommandInput): void {\n  command[COMMAND_INTERNALS].inputs = { ...values }\n}\n\n/** @internal Set the Quarry reference for this.call() support */\nexport function setCommandQuarry(\n  command: Command,\n  quarry: { call(name: string, input?: CommandInput): Promise<CommandResult> },\n): void {\n  command[COMMAND_INTERNALS].quarry = quarry\n}\n\n/** @internal Collect the result after handle() completes */\nexport function getCommandResult(command: Command): CommandResult {\n  const internals: CommandInternals = command[COMMAND_INTERNALS]\n  return {\n    exitCode: internals.exitCode,\n    output: [...internals.output],\n    errors: [...internals.errors],\n  }\n}\n\n/** @internal Reset state between invocations */\nexport function resetCommandState(command: Command): void {\n  const internals: CommandInternals = command[COMMAND_INTERNALS]\n  internals.inputs = {}\n  internals.output = []\n  internals.errors = []\n  internals.exitCode = 0\n}\n","import { CommandError } from './errors/command.error'\nimport type { ParsedArgument, ParsedOption, ParsedSignature } from './types'\n\n/**\n * Parse a Laravel-style command signature string.\n *\n * Signature syntax:\n *   command-name {arg} ...              — flat command\n *   group subcommand {arg} ...          — subcommand hierarchy (space-separated)\n *   namespace:command {arg} ...         — namespaced flat command (colon-separated)\n *   {--flag} {--name=} {--name=default} {--name=*} {--A|name} {--name= : desc}\n *\n * Pure function, zero dependencies, edge-compatible.\n */\nexport function parseSignature(signature: string): ParsedSignature {\n  const tokens = extractTokens(signature)\n  const name = extractCommandName(signature)\n  const args: ParsedArgument[] = []\n  const options: ParsedOption[] = []\n\n  for (const token of tokens) {\n    const inner = token.slice(1, -1).trim() // strip { }\n\n    if (inner.startsWith('--')) {\n      options.push(parseOption(inner))\n    } else {\n      args.push(parseArgument(inner))\n    }\n  }\n\n  return { name, arguments: args, options }\n}\n\nfunction extractCommandName(signature: string): string {\n  const match = /^[\\w:.-]+(?:\\s+[\\w:.-]+)*/.exec(signature)\n  if (!match) {\n    throw new CommandError(`Invalid signature: cannot extract command name from \"${signature}\"`)\n  }\n  return match[0]\n}\n\nfunction extractTokens(signature: string): string[] {\n  const tokens: string[] = []\n  const regex = /\\{[^}]+\\}/g\n  let match: RegExpExecArray | null\n\n  while ((match = regex.exec(signature)) !== null) {\n    tokens.push(match[0])\n  }\n\n  return tokens\n}\n\nfunction parseArgument(inner: string): ParsedArgument {\n  const { value, description } = splitDescription(inner)\n\n  // {name*} — array/variadic argument\n  if (value.endsWith('*')) {\n    return {\n      name: value.slice(0, -1).trim(),\n      required: true,\n      isArray: true,\n      description,\n    }\n  }\n\n  // {name=default} — argument with default value\n  const eqIdx = value.indexOf('=')\n  if (eqIdx !== -1) {\n    return {\n      name: value.slice(0, eqIdx).trim(),\n      required: false,\n      default: value.slice(eqIdx + 1).trim(),\n      isArray: false,\n      description,\n    }\n  }\n\n  // {name?} — optional argument\n  if (value.endsWith('?')) {\n    return {\n      name: value.slice(0, -1).trim(),\n      required: false,\n      isArray: false,\n      description,\n    }\n  }\n\n  // {name} — required argument\n  return {\n    name: value.trim(),\n    required: true,\n    isArray: false,\n    description,\n  }\n}\n\nfunction parseOption(inner: string): ParsedOption {\n  // Remove leading --\n  const withoutDashes = inner.slice(2)\n  const { value, description } = splitDescription(withoutDashes)\n\n  // Check for alias: {--A|name...}\n  let alias: string | undefined\n  let optBody = value\n\n  const pipeIdx = optBody.indexOf('|')\n  if (pipeIdx !== -1) {\n    alias = optBody.slice(0, pipeIdx).trim()\n    optBody = optBody.slice(pipeIdx + 1).trim()\n  }\n\n  // {--name=*} — array option\n  if (optBody.endsWith('=*')) {\n    return {\n      name: optBody.slice(0, -2).trim(),\n      alias,\n      isFlag: false,\n      isArray: true,\n      description,\n    }\n  }\n\n  // {--name=default} — option with default value\n  const eqIdx = optBody.indexOf('=')\n  if (eqIdx !== -1) {\n    const name = optBody.slice(0, eqIdx).trim()\n    const defaultValue = optBody.slice(eqIdx + 1).trim()\n\n    return {\n      name,\n      alias,\n      isFlag: false,\n      isArray: false,\n      default: defaultValue || undefined,\n      description,\n    }\n  }\n\n  // {--flag} — boolean flag\n  return {\n    name: optBody.trim(),\n    alias,\n    isFlag: true,\n    isArray: false,\n    description,\n  }\n}\n\nfunction splitDescription(value: string): { value: string; description?: string } {\n  const colonIdx = value.indexOf(' : ')\n  if (colonIdx === -1) {\n    return { value }\n  }\n\n  return {\n    value: value.slice(0, colonIdx).trim(),\n    description: value.slice(colonIdx + 3).trim(),\n  }\n}\n","import { inject } from '../di'\nimport type { Container } from '../di/container'\nimport { getContainer } from '../di/container-storage'\nimport { Singleton } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport { createCliExceptionContext } from '../errors/exception-context'\nimport type { ExceptionHandler } from '../errors/exception-handler'\nimport type { Constructor } from '../types'\nimport { type Command } from './command'\nimport { getCommandResult, setCommandInputs, setCommandQuarry } from './command-internals'\nimport { CommandNotFoundError } from './errors/command-not-found.error'\nimport { CommandError } from './errors/command.error'\nimport { parseSignature } from './signature-parser'\nimport type { CommandInput, CommandResult, ParsedSignature, Quarry } from './types'\n\n/**\n * QuarryRegistry — edge-compatible programmatic API for running commands.\n *\n * Registered as a singleton via DI_TOKENS.Quarry.\n * Commands are auto-discovered from module providers and registered at bootstrap.\n * Command constructors are stored at bootstrap; fresh instances are resolved per `call()`.\n *\n * Users should inject and type as `Quarry` (the interface), which only exposes `call()`.\n */\n@Singleton(DI_TOKENS.Quarry)\nexport class QuarryRegistry implements Quarry {\n  private commands = new Map<string, Constructor<Command>>()\n  private signatures = new Map<string, ParsedSignature>()\n  private aliases = new Map<string, string>()\n\n  constructor(@inject(DI_TOKENS.Container) private readonly container: Container) { }\n\n  /**\n   * Execute a command by name with optional flat input.\n   * A fresh command instance is resolved from the container per invocation.\n   */\n  async call(name: string, input?: CommandInput): Promise<CommandResult> {\n    const resolvedName = this.resolveName(name)\n    const CommandClass = this.commands.get(resolvedName)\n\n    if (!CommandClass) {\n      throw new CommandNotFoundError(name)\n    }\n\n    const signature = this.signatures.get(resolvedName)!\n    const mergedInput = this.applyDefaults(input ?? {}, signature)\n\n    // Validate required arguments\n    for (const arg of signature.arguments) {\n      if (arg.required && (mergedInput[arg.name] === undefined || mergedInput[arg.name] === null)) {\n        throw new CommandError(`Missing required argument: ${arg.name}`)\n      }\n    }\n\n    let command: Command | undefined\n\n    try {\n      // Resolve from the active request scope (handleCommand runs call() inside\n      // runInRequestScope), not the global container — commands may inject\n      // request-scoped providers (e.g. @InjectQueue → QueueRegistry).\n      command = getContainer().resolve<Command>(CommandClass)\n\n      setCommandQuarry(command, this)\n      setCommandInputs(command, mergedInput)\n\n      const exitCode = await command.handle()\n      const result = getCommandResult(command)\n\n      if (typeof exitCode === 'number') {\n        return { ...result, exitCode }\n      }\n\n      return result\n    } catch (error) {\n      if (error instanceof CommandError) {\n        if (command) {\n          const result = getCommandResult(command)\n          return {\n            exitCode: result.exitCode === 0 ? 1 : result.exitCode,\n            output: result.output,\n            errors: [...result.errors, error.message],\n          }\n        }\n        return { exitCode: 1, output: [], errors: [error.message] }\n      }\n\n      const errorMessage = this.handleError(error, resolvedName)\n\n      if (command) {\n        const result = getCommandResult(command)\n        return {\n          exitCode: result.exitCode === 0 ? 1 : result.exitCode,\n          output: result.output,\n          errors: [...result.errors, errorMessage],\n        }\n      }\n      return { exitCode: 1, output: [], errors: [errorMessage] }\n    }\n  }\n\n  /**\n   * Check if a command exists by name or alias.\n   */\n  has(name: string): boolean {\n    const resolved = this.resolveName(name)\n    return this.commands.has(resolved)\n  }\n\n  /**\n   * Get a command constructor by name or alias.\n   */\n  get(name: string): Constructor<Command> | undefined {\n    const resolved = this.resolveName(name)\n    return this.commands.get(resolved)\n  }\n\n  /**\n   * Get all registered command constructors.\n   */\n  all(): Map<string, Constructor<Command>> {\n    return new Map(this.commands)\n  }\n\n  /**\n   * List all commands with their descriptions and aliases.\n   */\n  list(): { name: string; description?: string; aliases: string[] }[] {\n    const result: { name: string; description?: string; aliases: string[] }[] = []\n\n    for (const [name, CommandClass] of this.commands) {\n      const staticCommand = CommandClass as unknown as typeof Command\n      const commandAliases: string[] = []\n\n      for (const [alias, target] of this.aliases) {\n        if (target === name) {\n          commandAliases.push(alias)\n        }\n      }\n\n      result.push({\n        name,\n        description: staticCommand.description,\n        aliases: commandAliases,\n      })\n    }\n\n    return result.sort((a, b) => a.name.localeCompare(b.name))\n  }\n\n  /**\n   * Generate a compact listing of all commands with visual hierarchy and colors.\n   */\n  async listUsage(options?: { binaryName?: string; binaryLabel?: string; binaryVersion?: string }): Promise<string> {\n    const commands = this.list()\n\n    // Dynamic import to keep usage-generator tree-shakeable\n    const { generateListing } = await import('./usage-generator')\n    return generateListing(commands, this.signatures, options)\n  }\n\n  /**\n   * Get auto-generated usage text for a command.\n   */\n  async usage(name: string): Promise<string> {\n    const resolvedName = this.resolveName(name)\n    const CommandClass = this.commands.get(resolvedName)\n\n    if (!CommandClass) {\n      throw new CommandNotFoundError(name)\n    }\n\n    const signature = this.signatures.get(resolvedName)!\n    const staticCommand = CommandClass as unknown as typeof Command\n\n    // Dynamic import to keep usage-generator tree-shakeable\n    const { generateUsage } = await import('./usage-generator')\n    return generateUsage(signature, staticCommand.description)\n  }\n\n  /**\n   * Register a command constructor with the registry.\n   * @internal Called by Application during bootstrap.\n   */\n  register(commandClass: Constructor<Command>): void {\n    const staticCommand = commandClass as unknown as typeof Command\n\n    if (!staticCommand.command) {\n      throw new CommandError(`Command class ${commandClass.name} is missing static \"command\" signature`)\n    }\n\n    const signature = parseSignature(staticCommand.command)\n    const name = signature.name\n\n    if (this.commands.has(name) || this.aliases.has(name)) {\n      throw new CommandError(`Duplicate command name: \"${name}\" is already registered`)\n    }\n\n    // Validate all aliases before any mutation\n    if (staticCommand.aliases) {\n      for (const alias of staticCommand.aliases) {\n        if (this.commands.has(alias) || this.aliases.has(alias)) {\n          throw new CommandError(`Duplicate alias: \"${alias}\" conflicts with an existing command or alias`)\n        }\n      }\n    }\n\n    // All checks passed — safe to mutate\n    this.commands.set(name, commandClass)\n    this.signatures.set(name, signature)\n\n    if (staticCommand.aliases) {\n      for (const alias of staticCommand.aliases) {\n        this.aliases.set(alias, name)\n      }\n    }\n  }\n\n  private handleError(error: unknown, commandName: string): string {\n    const handler = this.container.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n    const ctx = createCliExceptionContext(commandName)\n    // Fire-and-forget — reporting happens via waitUntil internally\n    void handler.handle(error, ctx)\n    return error instanceof Error ? error.message : String(error)\n  }\n\n  private resolveName(name: string): string {\n    return this.aliases.get(name) ?? name\n  }\n\n  private applyDefaults(input: CommandInput, signature: ParsedSignature): CommandInput {\n    const result = { ...input }\n\n    // Apply argument defaults\n    for (const arg of signature.arguments) {\n      if (result[arg.name] === undefined && arg.default !== undefined) {\n        result[arg.name] = arg.default\n      }\n    }\n\n    // Apply option defaults\n    for (const opt of signature.options) {\n      if (result[opt.name] === undefined) {\n        if (opt.default !== undefined) {\n          result[opt.name] = opt.default\n        } else if (opt.isFlag) {\n          result[opt.name] = false\n        }\n      }\n    }\n\n    return result\n  }\n}\n","import { DI_TOKENS } from '../di/tokens'\nimport { Module } from '../module/module.decorator'\nimport { QuarryRegistry } from './quarry-registry'\n\n/**\n * Registers the Quarry command registry (`DI_TOKENS.Quarry`).\n *\n * Eager: resolved synchronously at bootstrap (`registerCommands`) and by the\n * CLI runner (`bin/quarry.ts`), so it cannot be lazily loaded.\n */\n@Module({\n  providers: [\n    { provide: DI_TOKENS.Quarry, useClass: QuarryRegistry },\n  ],\n})\nexport class QuarryModule { }\n"],"mappings":"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"}

package/dist/queue.module-CEs4_kEM.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.module-CEs4_kEM.mjs","names":[],"sources":["../src/queue/queue.error.ts","../src/queue/queue-manager.ts","../src/queue/consumer-registry.ts","../src/queue/queue-sender.ts","../src/queue/queue-registry.ts","../src/queue/queue-store.ts","../src/queue/providers/cloudflare-queue.provider.ts","../src/queue/providers/sync-queue.provider.ts","../src/queue/services/queue-provider-factory.ts","../src/queue/queue.module.ts"],"sourcesContent":["import { ApplicationError } from '../errors'\n\nexport class QueueError extends ApplicationError {}\n","import { inject } from '../di'\nimport { getContainer } from '../di/container-storage'\nimport { Transient } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport { LOGGER_TOKENS, type LoggerService } from '../logger'\nimport { type ConsumerRegistry } from './consumer-registry'\nimport type { FailedJob } from './failed-job'\nimport type { IQueueConsumer, QueueMessage } from './queue-consumer'\nimport { QueueError } from './queue.error'\nimport type { QueueModuleOptions } from './queue.module'\nimport type { QueueStore } from './queue-store'\nimport { QUEUE_TOKENS } from './queue.tokens'\n\nconst DEFAULT_MAX_RETRIES = 3\n\n@Transient(DI_TOKENS.Queue)\nexport class QueueManager {\n  private readonly maxRetries: number\n\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry,\n    @inject(LOGGER_TOKENS.LoggerService) private readonly logger: LoggerService,\n    @inject(QUEUE_TOKENS.QueueStore) private readonly store: QueueStore,\n    @inject(QUEUE_TOKENS.QueueModuleOptions) options: QueueModuleOptions,\n  ) {\n    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES\n  }\n\n  async processBatch(queueName: string, batch: MessageBatch): Promise<void> {\n    for (const message of batch.messages) {\n      const queueMessage = message.body as QueueMessage\n      const idempotencyKey = queueMessage.metadata?.idempotencyKey ?? queueMessage.id\n\n      if (await this.store.isProcessed(idempotencyKey)) {\n        message.ack()\n        continue\n      }\n\n      // Resolve a fresh consumer instance per message from the active request\n      // scope (handleQueue runs processBatch inside runInRequestScope), so\n      // request-scoped consumer dependencies bind to this message's scope.\n      const container = getContainer()\n      const consumers = this.registry\n        .getConsumerClasses(queueMessage.type)\n        .map((ConsumerClass) => container.resolve<IQueueConsumer>(ConsumerClass))\n\n      const results = await Promise.allSettled(\n        consumers.map((consumer) => consumer.handle(queueMessage)),\n      )\n\n      let lastError: Error | undefined\n      let failedConsumer: string | undefined\n\n      for (let i = 0; i < results.length; i++) {\n        const result = results[i]\n        if (result.status === 'rejected') {\n          const consumer = consumers[i]\n          const errorInstance = result.reason instanceof Error\n            ? result.reason\n            : new Error(String(result.reason))\n\n          this.logger.error('Queue message processing failed', errorInstance, {\n            type: queueMessage.type,\n            queue: queueName,\n            messageId: queueMessage.id,\n            idempotencyKey,\n          })\n\n          if (consumer.onError) {\n            await consumer.onError(errorInstance, queueMessage)\n          }\n\n          lastError = errorInstance\n          failedConsumer = consumer.constructor.name\n        }\n      }\n\n      const failed = lastError !== undefined\n\n      if (failed) {\n        // `message.attempts` is 1-based (the first delivery is attempt 1), so a\n        // message is only out of retries once it has been delivered more than\n        // `maxRetries` times. `maxRetries: 3` therefore means 3 retries after the\n        // initial delivery (4 total attempts). This must be <= the consumer's\n        // `max_retries` in wrangler.jsonc, otherwise Cloudflare dead-letters the\n        // message before this branch ever runs and it never reaches the store.\n        if (message.attempts > this.maxRetries) {\n          // A KV failure (or a message dispatched outside Stratal, with no\n          // binding to retry through) while persisting the failed job must not\n          // abort the rest of the batch — log and ack so the message isn't\n          // redelivered forever.\n          try {\n            const binding = queueMessage.metadata?.binding\n            if (!binding) {\n              throw new QueueError(\n                `Queue message ${queueMessage.id} has no binding metadata and cannot be recorded for retry. ` +\n                  `Messages must be dispatched through a Stratal queue sender (@InjectQueue).`,\n              )\n            }\n\n            const failedJob: FailedJob = {\n              id: queueMessage.id,\n              queue: queueName,\n              binding,\n              type: queueMessage.type,\n              message: queueMessage,\n              error: {\n                name: lastError!.name,\n                message: lastError!.message,\n                stack: lastError!.stack,\n              },\n              consumer: failedConsumer!,\n              attempts: message.attempts,\n              failedAt: new Date().toISOString(),\n            }\n\n            await this.store.storeFailedJob(failedJob)\n          } catch (error) {\n            this.logger.error(\n              'Failed to persist failed queue job',\n              error instanceof Error ? error : new Error(String(error)),\n              { queue: queueName, messageId: queueMessage.id, type: queueMessage.type },\n            )\n          }\n          message.ack()\n        } else {\n          message.retry()\n        }\n      } else {\n        await this.store.markProcessed(idempotencyKey)\n        message.ack()\n      }\n    }\n  }\n}\n","import { Singleton } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { Constructor } from '../types'\nimport type { IQueueConsumer } from './queue-consumer'\n\n/** A registered consumer class together with the message types it handles. */\nexport interface ConsumerRegistration {\n  consumerClass: Constructor<IQueueConsumer>\n  messageTypes: string[]\n}\n\n/**\n * Consumer Registry\n *\n * Singleton service that holds all registered queue consumers indexed by message type.\n * Consumers declare the message types they handle, and this registry routes messages\n * to the appropriate consumers based on their types.\n *\n * **Message-Type Routing:**\n * - Consumers declare `messageTypes` array (e.g., `['email.send', 'email.batch.send']`)\n * - When a message arrives, consumers matching the message type are invoked\n * - A consumer can handle messages from ANY queue (routing is by type, not queue)\n * - Use `'*'` as a wildcard to handle all message types\n *\n * @example Consumer registration\n * ```typescript\n * // In consumer.ts\n * @Transient()\n * export class EmailConsumer implements IQueueConsumer {\n *   readonly messageTypes = ['email.send', 'email.batch.send']\n *   // ...\n * }\n *\n * // In module.ts\n * @Module({\n *   consumers: [EmailConsumer]\n * })\n *\n * // Application auto-registers via ConsumerRegistry\n * this.consumerRegistry.register(consumer)\n * ```\n */\n@Singleton(DI_TOKENS.ConsumerRegistry)\nexport class ConsumerRegistry {\n  /** Map from message type to consumer classes handling that type */\n  private classesByType = new Map<string, Constructor<IQueueConsumer>[]>()\n\n  /** All registrations (for iteration / listing) */\n  private registrations: ConsumerRegistration[] = []\n\n  /** Registered consumer classes (dedupe) */\n  private registeredClasses = new Set<Constructor<IQueueConsumer>>()\n\n  /**\n   * Register a queue consumer class.\n   *\n   * Indexes the class by each of its declared message types. A fresh instance\n   * is resolved per message from the request-scoped container at dispatch time —\n   * consumers are never held as long-lived singletons, so they may safely inject\n   * request-scoped providers (`@InjectQueue`, i18n, auth context, …).\n   *\n   * @param consumerClass - Queue consumer class to register\n   * @param messageTypes - Message types the consumer handles\n   */\n  register(consumerClass: Constructor<IQueueConsumer>, messageTypes: string[]): void {\n    if (this.registeredClasses.has(consumerClass)) {\n      return // Already registered\n    }\n\n    this.registeredClasses.add(consumerClass)\n    this.registrations.push({ consumerClass, messageTypes })\n\n    for (const messageType of messageTypes) {\n      const existing = this.classesByType.get(messageType) ?? []\n      existing.push(consumerClass)\n      this.classesByType.set(messageType, existing)\n    }\n  }\n\n  /**\n   * Get all consumer classes that can handle a specific message type.\n   *\n   * Returns classes that either declare the message type explicitly or use the\n   * `'*'` wildcard. Callers resolve a fresh instance per message from the\n   * request-scoped container.\n   *\n   * @param messageType - The message type to find consumers for\n   * @returns Array of consumer classes that can handle this message type\n   */\n  getConsumerClasses(messageType: string): Constructor<IQueueConsumer>[] {\n    const exactMatch = this.classesByType.get(messageType) ?? []\n    const wildcardMatch = this.classesByType.get('*') ?? []\n\n    // Combine and dedupe\n    return Array.from(new Set([...exactMatch, ...wildcardMatch]))\n  }\n\n  /**\n   * Check if any consumers can handle a message type\n   *\n   * @param messageType - The message type to check\n   * @returns true if at least one consumer can handle this type\n   */\n  hasConsumers(messageType: string): boolean {\n    return this.getConsumerClasses(messageType).length > 0\n  }\n\n  /**\n   * Get all registered message types\n   *\n   * @returns Array of message types with registered consumers\n   */\n  getMessageTypes(): string[] {\n    return Array.from(this.classesByType.keys())\n  }\n\n  /**\n   * Get all consumer registrations (class + message types) for listing.\n   */\n  getRegistrations(): readonly ConsumerRegistration[] {\n    return this.registrations\n  }\n}\n","import type { II18nService } from '../i18n/i18n.types';\nimport type { IQueueProvider } from './providers';\nimport type { QueueMessage } from './queue-consumer';\nimport type { DispatchMessage, IQueueSender } from './queue-sender.interface';\n\n/**\n * Queue Sender\n *\n * Implementation of IQueueSender bound to a specific queue binding.\n * Created by QueueRegistry for each registered binding.\n *\n * Automatically enriches messages with:\n * - `id`: UUID generated via crypto.randomUUID()\n * - `metadata.locale`: Current locale from I18n context\n * - `metadata.idempotencyKey`: Deterministic SHA-256 hash of type + payload (if not provided)\n *\n * @example\n * ```typescript\n * // Created by QueueRegistry, not directly instantiated\n * const sender = registry.getQueue('NOTIFICATIONS_QUEUE')\n *\n * await sender.dispatch({\n *   type: 'email.send',\n *   payload: { to: 'user@example.com', subject: 'Hello' }\n * })\n * ```\n */\nexport class QueueSender implements IQueueSender {\n  constructor(\n    private readonly binding: string,\n    private readonly provider: IQueueProvider,\n    private readonly i18n: II18nService\n  ) {}\n\n  /**\n   * Dispatch a message to this queue.\n   *\n   * @param message - Message to dispatch (without id)\n   */\n  async dispatch<T>(message: DispatchMessage<T>): Promise<void> {\n    const metadata = { ...message.metadata }\n\n    if (!metadata.locale) {\n      const locale = this.i18n.getLocale()\n      if (locale) {\n        metadata.locale = locale\n      }\n    }\n\n    metadata.idempotencyKey ??= await this.generateIdempotencyKey(message.type, message.payload);\n\n    // Stamp the producer binding so a failed job can be retried to the right\n    // Cloudflare binding. Consumers only see the queue *name*, which is not a\n    // valid producer binding key.\n    metadata.binding = this.binding\n\n    const fullMessage: QueueMessage<T> = {\n      id: crypto.randomUUID(),\n      ...message,\n      metadata,\n    }\n\n    await this.provider.send(this.binding, fullMessage)\n  }\n\n  private async generateIdempotencyKey(type: string, payload: unknown): Promise<string> {\n    // Use a stable, key-sorted serialization: `JSON.stringify` preserves\n    // insertion order, so two semantically identical payloads with differently\n    // ordered keys would otherwise hash differently and defeat deduplication.\n    const data = new TextEncoder().encode(stableStringify({ type, payload }))\n    const hash = await crypto.subtle.digest('SHA-256', data)\n    return `queue:${Array.from(new Uint8Array(hash)).map(b => b.toString(16).padStart(2, '0')).join('')}`\n  }\n}\n\n/**\n * Deterministic JSON serialization: object keys are emitted in sorted order at\n * every level so the output depends only on the data, not on key insertion\n * order. Arrays keep their order (order is significant). Used to derive a stable\n * idempotency hash from a message's `type` + `payload`.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== 'object') {\n    return JSON.stringify(value) ?? 'null'\n  }\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(',')}]`\n  }\n  const entries = Object.keys(value as Record<string, unknown>)\n    .sort()\n    .map((key) => {\n      const v = (value as Record<string, unknown>)[key]\n      if (v === undefined) return undefined\n      return `${JSON.stringify(key)}:${stableStringify(v)}`\n    })\n    .filter((entry): entry is string => entry !== undefined)\n  return `{${entries.join(',')}}`\n}\n","import { inject } from '../di'\nimport { Request } from '../di/decorators'\nimport { I18N_TOKENS } from '../i18n/i18n.tokens'\nimport type { II18nService } from '../i18n/i18n.types'\nimport type { IQueueProvider } from './providers'\nimport type { IQueueSender } from './queue-sender.interface'\nimport { QueueSender } from './queue-sender'\nimport { QUEUE_TOKENS } from './queue.tokens'\nimport { type QueueProviderFactory } from './services'\n\n/**\n * Queue Registry\n *\n * Request-scoped factory service for creating QueueSender instances.\n * Caches senders per binding within the request scope.\n *\n * This service is used internally by QueueModule.registerQueue() to provide\n * IQueueSender instances for each registered binding.\n *\n * **Why request-scoped?**\n * - Needs access to I18nService for locale-aware message metadata\n * - Provider is created once per request for consistency\n * - Queue senders are cached per request to avoid recreating them\n *\n * @example\n * ```typescript\n * // Used internally by QueueModule.registerQueue()\n * QueueModule.registerQueue('NOTIFICATIONS_QUEUE')\n *\n * // The module creates a factory provider:\n * {\n *   provide: 'NOTIFICATIONS_QUEUE',\n *   useFactory: (registry: QueueRegistry) => registry.getQueue('NOTIFICATIONS_QUEUE'),\n *   inject: [QUEUE_TOKENS.QueueRegistry],\n * }\n * ```\n */\n@Request(QUEUE_TOKENS.QueueRegistry)\nexport class QueueRegistry {\n  private readonly provider: IQueueProvider\n  private readonly senders = new Map<string, IQueueSender>()\n\n  constructor(\n    @inject(QUEUE_TOKENS.QueueProviderFactory) providerFactory: QueueProviderFactory,\n    @inject(I18N_TOKENS.I18nService) private readonly i18n: II18nService\n  ) {\n    this.provider = providerFactory.create()\n  }\n\n  /**\n   * Get or create a QueueSender for the specified binding.\n   *\n   * Senders are cached per binding within the request scope.\n   *\n   * @param binding - The queue binding to get a sender for\n   * @returns QueueSender bound to the specified binding\n   */\n  getQueue(binding: string): IQueueSender {\n    let sender = this.senders.get(binding)\n\n    if (!sender) {\n      sender = new QueueSender(binding, this.provider, this.i18n)\n      this.senders.set(binding, sender)\n    }\n\n    return sender\n  }\n}\n","import { inject } from '../di';\nimport { Transient } from '../di/decorators';\nimport { CACHE_TOKENS } from '../cache/cache.tokens';\nimport type { TieredCacheService } from '../cache/services/tiered-cache.service';\nimport type { FailedJob, FailedJobMetadata } from './failed-job';\nimport type { QueueModuleOptions } from './queue.module';\nimport { QUEUE_TOKENS } from './queue.tokens';\n\nconst IDEM_PREFIX = 'queue:idem:'\nconst FAILED_PREFIX = 'queue:failed:'\nconst DEFAULT_IDEMPOTENCY_TTL = 86400\n\n/** Default KV binding name used for queue state when none is configured. */\nexport const DEFAULT_STORE_BINDING = 'CACHE'\n\n/**\n * Persists queue idempotency claims and failed jobs.\n *\n * Backed by {@link TieredCacheService} (isolate-local L1 + KV). The L1 is what\n * makes `markProcessed` → `isProcessed` reliable within an isolate: a claim\n * written on this isolate is read back from memory, so a message redelivered to\n * the same warm isolate is de-duplicated even inside KV's eventual-consistency\n * window. Idempotency markers are set-once, the pattern the L1 tier is designed\n * for. Cross-isolate duplicates still rely on KV (eventually consistent) —\n * delivery remains at-least-once with best-effort de-duplication, not\n * exactly-once.\n */\n@Transient(QUEUE_TOKENS.QueueStore)\nexport class QueueStore {\n  private readonly cache: TieredCacheService\n  private readonly idempotencyTtl: number\n\n  constructor(\n    @inject(CACHE_TOKENS.TieredCacheService) cache: TieredCacheService,\n    @inject(QUEUE_TOKENS.QueueModuleOptions) options: QueueModuleOptions,\n  ) {\n    // Bind to the configured KV namespace via the tiered cache so the L1 lives\n    // on its singleton (one per isolate) and persists across messages. The\n    // binding is validated at module init (QueueModule.onInitialize);\n    // `binding()` also throws if it is somehow absent here.\n    this.cache = cache.binding(options.store?.binding ?? DEFAULT_STORE_BINDING)\n    this.idempotencyTtl = options.idempotency?.ttl ?? DEFAULT_IDEMPOTENCY_TTL\n  }\n\n  async isProcessed(key: string): Promise<boolean> {\n    return (await this.cache.get(`${IDEM_PREFIX}${key}`)) !== null\n  }\n\n  async markProcessed(key: string): Promise<void> {\n    await this.cache.put(`${IDEM_PREFIX}${key}`, '1', {\n      expirationTtl: this.idempotencyTtl,\n    })\n  }\n\n  async storeFailedJob(job: FailedJob): Promise<void> {\n    const metadata: FailedJobMetadata = {\n      queue: job.queue,\n      binding: job.binding,\n      type: job.type,\n      consumer: job.consumer,\n      attempts: job.attempts,\n      failedAt: job.failedAt,\n    }\n\n    await this.cache.put(`${FAILED_PREFIX}${job.id}`, JSON.stringify(job), {\n      metadata,\n    })\n  }\n\n  async getFailedJob(messageId: string): Promise<FailedJob | null> {\n    return this.cache.get<FailedJob>(`${FAILED_PREFIX}${messageId}`, 'json')\n  }\n\n  async removeFailedJob(messageId: string): Promise<void> {\n    await this.cache.delete(`${FAILED_PREFIX}${messageId}`)\n  }\n\n  async listFailedJobs(options?: {\n    limit?: number\n    cursor?: string\n  }): Promise<{ keys: { id: string; metadata: FailedJobMetadata }[]; cursor?: string }> {\n    const result = await this.cache.list<FailedJobMetadata>({\n      prefix: FAILED_PREFIX,\n      limit: options?.limit ?? 50,\n      cursor: options?.cursor,\n    })\n\n    // Skip keys without metadata: a partially-written entry (or one written by\n    // an older code path) is unusable for listing and must not crash the page.\n    const keys = result.keys\n      .filter((key): key is typeof key & { metadata: FailedJobMetadata } => key.metadata != null)\n      .map((key) => ({\n        id: key.name.slice(FAILED_PREFIX.length),\n        metadata: key.metadata,\n      }))\n\n    return {\n      keys,\n      cursor: result.list_complete ? undefined : result.cursor,\n    }\n  }\n\n  async purgeFailedJobs(): Promise<void> {\n    let cursor: string | undefined\n\n    do {\n      const result = await this.cache.list({ prefix: FAILED_PREFIX, cursor })\n      await Promise.all(result.keys.map((key) => this.cache.delete(key.name)))\n      cursor = result.list_complete ? undefined : result.cursor\n    } while (cursor)\n  }\n\n  /**\n   * Delete failed jobs older than `retentionSeconds` (by their `failedAt`\n   * timestamp). Returns the number removed. Backs the opt-in\n   * {@link FailedJobCleanupJob} cron — failed jobs otherwise persist\n   * indefinitely until retried or purged.\n   */\n  async purgeFailedJobsOlderThan(retentionSeconds: number): Promise<number> {\n    const cutoff = Date.now() - retentionSeconds * 1000\n    let cursor: string | undefined\n    let removed = 0\n\n    do {\n      const result = await this.cache.list<FailedJobMetadata>({ prefix: FAILED_PREFIX, cursor })\n      const expired = result.keys.filter((key) => {\n        const failedAt = key.metadata?.failedAt\n        return failedAt !== undefined && Date.parse(failedAt) < cutoff\n      })\n      await Promise.all(expired.map((key) => this.cache.delete(key.name)))\n      removed += expired.length\n      cursor = result.list_complete ? undefined : result.cursor\n    } while (cursor)\n\n    return removed\n  }\n}\n","import { inject } from '../../di'\nimport { type StratalEnv } from '../../env'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { QueueError } from '../queue.error'\nimport type { QueueMessage } from '../queue-consumer'\nimport type { IQueueProvider } from './queue-provider.interface'\n\n/**\n * Cloudflare Queue Provider\n *\n * Sends messages to Cloudflare Queues by resolving the binding directly on\n * the worker's `env`. Used in production environments where Cloudflare Workers\n * handle queue processing.\n *\n * @example\n * ```typescript\n * const provider = new CloudflareQueueProvider(env)\n * await provider.send('NOTIFICATIONS_QUEUE', message)\n * ```\n */\n@Transient()\nexport class CloudflareQueueProvider implements IQueueProvider {\n  constructor(\n    @inject(DI_TOKENS.CloudflareEnv) private readonly env: StratalEnv\n  ) { }\n\n  /**\n   * Send a message to a Cloudflare Queue\n   *\n   * @param binding - Queue binding identifier (e.g., 'NOTIFICATIONS_QUEUE')\n   * @param message - Complete message with id and payload\n   * @throws {QueueError} If the binding is not configured on env\n   */\n  async send<T>(binding: string, message: QueueMessage<T>): Promise<void> {\n    const queue = (this.env as unknown as Record<string, unknown>)[binding] as Queue | undefined\n\n    if (!queue) {\n      throw new QueueError(`Queue binding \"${binding}\" was not found in the environment`)\n    }\n\n    await queue.send(message)\n  }\n}\n","import type { Application } from '../../application'\nimport type { Container } from '../../di/container'\nimport { containerStorage } from '../../di/container-storage'\nimport { inject } from '../../di'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport type { RouterContext } from '../../router/router-context'\nimport { type ConsumerRegistry } from '../consumer-registry'\nimport type { IQueueConsumer, QueueMessage } from '../queue-consumer'\nimport type { IQueueProvider } from './queue-provider.interface'\n\n/**\n * Sync Queue Provider\n *\n * Processes messages immediately by finding matching consumers and calling\n * their handle() method directly. Used for testing and development where\n * real queue infrastructure is not available.\n *\n * **Behavior:**\n * - Messages are processed synchronously when send() is called\n * - Matching consumers are found via ConsumerRegistry by message type\n * - All matching consumers are called sequentially\n * - Errors are re-thrown after onError() is called (fail-fast for testing)\n *\n * **Consumer Matching:**\n * - Consumers are matched by message type, not queue name\n * - Wildcard ('*') matches all message types\n */\n@Transient()\nexport class SyncQueueProvider implements IQueueProvider {\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry,\n    @inject(DI_TOKENS.Container) private readonly root: Container,\n    @inject(DI_TOKENS.Application) private readonly app: Application,\n  ) {}\n\n  /**\n   * Process a message synchronously.\n   *\n   * Runs inside the active request scope when dispatch happens within one (an\n   * HTTP request, or `runInScope` for queues/cron/commands). When dispatched\n   * with no ambient scope — e.g. a service invoked directly in a test — it\n   * establishes its own request scope (mirroring the production queue handler)\n   * so consumers and their request-scoped dependencies resolve correctly.\n   *\n   * @param _binding - Queue binding (not used for routing, consumers match by message type)\n   * @param message - Complete message with id and payload\n   * @throws Re-throws any error from consumer.handle() after calling onError()\n   */\n  async send<T>(_binding: string, message: QueueMessage<T>): Promise<void> {\n    // The fetch path deliberately skips queue init (a Cloudflare-queue worker\n    // never processes consumers inline) — but the sync provider IS the inline\n    // consumer path, so populate the consumer registry before matching message\n    // types. Memoized inside the application; a no-op after the first dispatch.\n    await this.app.ensureScopedHandlers()\n\n    const ambient = containerStorage.getStore()\n    if (ambient) {\n      await this.process(ambient, message)\n      return\n    }\n\n    const locale = message.metadata?.locale ?? 'en'\n    const context = {\n      getLocale: () => locale,\n      setLocale: () => { /* no-op */ },\n      getContainer: () => containerStorage.getStore() ?? this.root,\n    } as unknown as RouterContext\n\n    await this.root.runInRequestScope(context, (container) => this.process(container, message))\n  }\n\n  /**\n   * Resolve a fresh consumer per message from `container` (matched by type) and\n   * invoke each sequentially, fail-fast on the first error after `onError`.\n   */\n  private async process<T>(container: Container, message: QueueMessage<T>): Promise<void> {\n    const consumers = this.registry\n      .getConsumerClasses(message.type)\n      .map((ConsumerClass) => container.resolve<IQueueConsumer>(ConsumerClass))\n\n    for (const consumer of consumers) {\n      try {\n        await consumer.handle(message)\n      } catch (error) {\n        const errorInstance = error instanceof Error ? error : new Error(String(error))\n\n        // Call onError hook if defined\n        if (consumer.onError) {\n          await consumer.onError(errorInstance, message)\n        }\n\n        // Re-throw for fail-fast behavior in tests\n        throw errorInstance\n      }\n    }\n  }\n}\n","import { inject } from '../../di'\nimport type { Container } from '../../di/container'\nimport { type StratalEnv } from '../../env'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { type ConsumerRegistry } from '../consumer-registry'\nimport { QueueError } from '../queue.error'\nimport type { Application } from '../../application'\nimport { CloudflareQueueProvider, SyncQueueProvider, type IQueueProvider } from '../providers'\nimport type { QueueModuleOptions } from '../queue.module'\nimport { QUEUE_TOKENS } from '../queue.tokens'\n\n/**\n * Queue Provider Factory\n *\n * Creates the appropriate queue provider based on configuration provided\n * via QueueModule.forRootAsync().\n *\n * **Provider Selection:**\n * - `cloudflare`: Production provider using Cloudflare Queue bindings\n * - `sync`: Testing provider that processes messages immediately\n *\n * @example\n * ```typescript\n * // Configuration via QueueModule.forRootAsync()\n * QueueModule.forRootAsync({\n *   inject: [CONFIG_TOKENS.ConfigService],\n *   useFactory: (config) => ({ provider: config.get('queue').provider })\n * })\n *\n * // Factory usage (internal)\n * const factory = container.resolve(QueueProviderFactory)\n * const provider = factory.create()\n * ```\n */\n@Transient(QUEUE_TOKENS.QueueProviderFactory)\nexport class QueueProviderFactory {\n  constructor(\n    @inject(DI_TOKENS.CloudflareEnv) private readonly env: StratalEnv,\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry,\n    @inject(DI_TOKENS.Container) private readonly container: Container,\n    @inject(DI_TOKENS.Application) private readonly app: Application,\n    @inject(QUEUE_TOKENS.QueueModuleOptions, { isOptional: true }) private readonly options?: QueueModuleOptions,\n  ) { }\n\n  /**\n   * Create a queue provider based on module configuration\n   *\n   * @returns Queue provider instance\n   * @throws {QueueError} If provider type is not supported\n   */\n  create(): IQueueProvider {\n    const providerType = this.options?.provider ?? 'cloudflare'\n\n    switch (providerType) {\n      case 'cloudflare':\n        return new CloudflareQueueProvider(this.env)\n\n      case 'sync':\n        return new SyncQueueProvider(this.registry, this.container, this.app)\n\n      default:\n        throw new QueueError(`Queue provider \"${String(providerType)}\" is not supported`)\n    }\n  }\n}\n","/**\n * Queue Module\n *\n * Provides declarative queue infrastructure with provider abstraction.\n *\n * **Usage:**\n * ```typescript\n * // 1. Configure provider (once, in app root)\n * QueueModule.forRootAsync({\n *   inject: [CONFIG_TOKENS.ConfigService],\n *   useFactory: (config) => ({ provider: config.get('queue').provider })\n * })\n *\n * // 2. Register queue bindings (the binding IS the injection token)\n * QueueModule.registerQueue('NOTIFICATIONS_QUEUE')\n * QueueModule.registerQueue('BACKGROUND_QUEUE')\n *\n * // 3. Inject and use\n * constructor(@InjectQueue('NOTIFICATIONS_QUEUE') private queue: IQueueSender) {}\n * await this.queue.dispatch({ type: 'email.send', payload: {...} })\n * ```\n *\n * **Providers:**\n * - `cloudflare`: Production provider using Cloudflare Queue bindings\n * - `sync`: Testing provider that processes messages immediately\n */\n\nimport { CacheModule } from '../cache';\nimport { DI_TOKENS } from '../di/tokens';\nimport { type StratalEnv } from '../env';\nimport { Module } from '../module';\nimport type {\n  AsyncModuleOptions,\n  DynamicModule,\n  InjectionToken,\n  ModuleContext,\n  OnInitialize,\n} from '../module/types';\nimport { ConsumerRegistry } from './consumer-registry';\nimport type { QueueBinding } from './queue-binding';\nimport { QueueManager } from './queue-manager';\nimport { QueueRegistry } from './queue-registry';\nimport type { IQueueSender } from './queue-sender.interface';\nimport { QueueError } from './queue.error';\nimport { DEFAULT_STORE_BINDING, QueueStore } from './queue-store';\nimport { QUEUE_TOKENS } from './queue.tokens';\nimport { QueueProviderFactory } from './services';\n\n/**\n * Queue module configuration options\n */\nexport interface QueueModuleOptions {\n  /**\n   * Queue provider type\n   * - 'cloudflare': Production provider using Cloudflare Queue bindings\n   * - 'sync': Testing provider that processes messages immediately\n   */\n  provider: 'cloudflare' | 'sync'\n\n  /**\n   * KV binding for queue state (idempotency keys + failed jobs).\n   * Defaults to the `CACHE` binding if omitted.\n   */\n  store?: {\n    /**\n     * KV namespace binding name.\n     * @default CACHE\n     */\n    binding?: string\n  }\n\n  /**\n   * Idempotency configuration.\n   *\n   * Delivery is **at-least-once with best-effort de-duplication**, not\n   * exactly-once. Every dispatch carries an idempotency key (an explicit\n   * `metadata.idempotencyKey`, otherwise a deterministic SHA-256 hash of `type`\n   * + `payload`), and a message already recorded as processed is skipped. The\n   * processed marker is written only after a handler succeeds, and KV `get`/`put`\n   * are eventually consistent — so a message redelivered concurrently (or after\n   * a crash before the marker was durable) can still run more than once. Make\n   * handlers idempotent; don't rely on this as a hard exactly-once guarantee.\n   * `ttl` bounds how long processed keys are remembered.\n   */\n  idempotency?: {\n    /** TTL in seconds for processed idempotency keys. Default: 86400 (24h) */\n    ttl?: number\n  }\n\n  /**\n   * Failed-job configuration.\n   *\n   * Failed jobs persist indefinitely until retried or purged. To bound growth,\n   * register the opt-in `FailedJobCleanupJob` cron in a module's `jobs` array;\n   * it deletes failed jobs older than `retention`.\n   */\n  failedJobs?: {\n    /**\n     * Age in seconds beyond which `FailedJobCleanupJob` deletes a failed job.\n     * Default: 604800 (7d). Has no effect unless the cron is registered.\n     */\n    retention?: number\n  }\n\n  /** Max retry attempts before storing as failed job. Default: 3 */\n  maxRetries?: number\n}\n\n@Module({\n  // QueueStore persists idempotency claims and failed jobs through CacheService\n  // (isolate-local L1 + KV), so the cache must be available wherever queues are.\n  imports: [CacheModule],\n  providers: [\n    { provide: DI_TOKENS.ConsumerRegistry, useClass: ConsumerRegistry },\n    QueueManager,\n    { provide: QUEUE_TOKENS.QueueProviderFactory, useClass: QueueProviderFactory },\n    { provide: QUEUE_TOKENS.QueueRegistry, useClass: QueueRegistry },\n    { provide: QUEUE_TOKENS.QueueStore, useClass: QueueStore },\n  ],\n})\nexport class QueueModule implements OnInitialize {\n  /**\n   * Fail fast at boot if the configured KV store binding is missing, rather\n   * than letting every queue invocation hard-fail lazily. The binding backs\n   * idempotency claims and failed-job storage, so without it the queue\n   * subsystem cannot function.\n   */\n  onInitialize({ container }: ModuleContext): void {\n    const options = container.resolve<QueueModuleOptions>(QUEUE_TOKENS.QueueModuleOptions)\n\n    // Only the `cloudflare` provider persists idempotency claims and failed jobs\n    // to KV. The `sync` provider (dev/CLI) processes inline and never touches the\n    // store, so it must not require the binding.\n    if (options.provider !== 'cloudflare') return\n\n    const binding = options.store?.binding ?? DEFAULT_STORE_BINDING\n    const env = container.resolve<StratalEnv>(DI_TOKENS.CloudflareEnv)\n    const kv = (env as unknown as Record<string, unknown>)[binding]\n\n    if (!kv) {\n      throw new QueueError(\n        `Queue KV store binding \"${binding}\" was not found in the environment. ` +\n          `The queue subsystem persists idempotency claims and failed jobs to KV. ` +\n          `Add a kv_namespaces entry for \"${binding}\" in wrangler.jsonc, or set ` +\n          `QueueModule.forRootAsync({ ..., store: { binding: 'YOUR_KV' } }) to point at an existing namespace.`,\n      )\n    }\n  }\n\n  /**\n   * Configure queue infrastructure with async factory.\n   *\n   * Use when provider configuration depends on other services like ConfigService.\n   *\n   * @param options - Async configuration with factory and inject tokens\n   * @returns Dynamic module with queue infrastructure\n   *\n   * @example\n   * ```typescript\n   * QueueModule.forRootAsync({\n   *   inject: [CONFIG_TOKENS.ConfigService],\n   *   useFactory: (config: IConfigService) => ({\n   *     provider: config.get('queue').provider\n   *   })\n   * })\n   * ```\n   */\n  static forRootAsync(options: AsyncModuleOptions<QueueModuleOptions>): DynamicModule {\n    return {\n      module: QueueModule,\n      providers: [\n        {\n          provide: QUEUE_TOKENS.QueueModuleOptions,\n          useFactory: options.useFactory,\n          inject: options.inject,\n        },\n      ],\n    }\n  }\n\n  /**\n   * Register a queue binding for injection.\n   *\n   * The binding name doubles as the DI injection token and the\n   * `env`-lookup key. Binding names are typed against `StratalEnv`\n   * (autocomplete works once an app augments `StratalEnv` with its\n   * Cloudflare bindings).\n   *\n   * @param binding - Queue binding identifier (e.g. `NOTIFICATIONS_QUEUE`).\n   * @returns Dynamic module that provides the queue sender\n   *\n   * @example\n   * ```typescript\n   * // In AppModule imports\n   * QueueModule.registerQueue('NOTIFICATIONS_QUEUE')\n   *\n   * // Then inject using the binding name\n   * constructor(@InjectQueue('NOTIFICATIONS_QUEUE') private queue: IQueueSender) {}\n   * ```\n   */\n  static registerQueue(binding: QueueBinding): DynamicModule {\n    return {\n      module: QueueModule,\n      providers: [\n        {\n          provide: binding as InjectionToken<IQueueSender>,\n          useFactory: (registry: QueueRegistry) => registry.getQueue(binding),\n          inject: [QUEUE_TOKENS.QueueRegistry],\n        },\n      ],\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/r2-storage.provider-BoZmR6Ut.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"r2-storage.provider-BoZmR6Ut.mjs","names":[],"sources":["../src/storage/providers/r2-storage.provider.ts"],"sourcesContent":["import { type StratalEnv } from '../../env'\nimport { signUrl } from '../../router/signed-url'\nimport type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts'\nimport { StorageError } from '../storage.error'\nimport type { StorageEntry, StorageRouteConfig } from '../types'\nimport type {\n  CompletedPart,\n  CompleteMultipartResult,\n  CreateMultipartOptions,\n  CreateMultipartResult,\n  DeleteObjectsResult,\n  HeadObjectResult,\n  IMultipartProvider,\n  ListMultipartUploadsResult,\n  ListPartsResult,\n  UploadPartResult,\n} from './multipart-provider.interface'\nimport type { StreamingBlobPayloadInputTypes } from './storage-provider.interface'\n\nconst MIN_PART_SIZE = 5 * 1024 * 1024 // 5MB\nconst MULTIPART_PREFIX = '__multipart/'\nconst PARTS_PREFIX = '__parts/'\n\n/**\n * R2 Storage Provider\n * Implements storage operations using native Cloudflare R2 bindings\n *\n * Implements IMultipartProvider for multipart upload support needed by TUS.\n * Tracks multipart upload metadata using companion R2 objects so that\n * listParts/listMultipartUploads work in all environments (local, test, prod).\n */\nexport class R2StorageProvider implements IMultipartProvider {\n  private readonly routeBasePath: string\n\n  constructor(\n    private readonly config: StorageEntry,\n    private readonly bucket: R2Bucket,\n    private readonly env: StratalEnv,\n    routeConfig?: StorageRouteConfig\n  ) {\n    this.routeBasePath = routeConfig?.basePath ?? '/storage'\n  }\n\n  async upload(\n    body: StreamingBlobPayloadInputTypes,\n    path: string,\n    options: UploadOptions\n  ): Promise<UploadResult> {\n    const customMetadata: Record<string, string> = { ...options.metadata }\n    if (options.tagging) {\n      customMetadata['x-tags'] = options.tagging\n    }\n\n    await this.bucket.put(path, body as ReadableStream | ArrayBuffer | ArrayBufferView | string | Blob | null, {\n      httpMetadata: {\n        contentType: options.mimeType,\n      },\n      customMetadata,\n    })\n\n    return {\n      path,\n      disk: this.config.disk,\n      fullPath: path,\n      size: options.size,\n      mimeType: options.mimeType ?? 'application/octet-stream',\n      uploadedAt: new Date(),\n    }\n  }\n\n  async download(path: string): Promise<DownloadResult> {\n    const obj = await this.bucket.get(path)\n\n    if (!obj) {\n      throw new StorageError(`Storage object not found at path \"${path}\"`)\n    }\n\n    // R2ObjectBody has body, text(), arrayBuffer(), etc.\n    const objBody = obj\n\n    return {\n      toStream: () => objBody.body as ReadableStream<Uint8Array>,\n      contentType: obj.httpMetadata?.contentType ?? 'application/octet-stream',\n      size: obj.size,\n      metadata: obj.customMetadata,\n      toString: () => objBody.text(),\n      toArrayBuffer: () => objBody.bytes(),\n    }\n  }\n\n  async delete(path: string): Promise<void> {\n    await this.bucket.delete(path)\n  }\n\n  async exists(path: string): Promise<boolean> {\n    const head = await this.bucket.head(path)\n    return head !== null\n  }\n\n  async getPresignedUrl(\n    path: string,\n    method: 'GET' | 'PUT' | 'DELETE' | 'HEAD',\n    expiresIn: number\n  ): Promise<PresignedUrlResult> {\n    const secret = this.env.APP_SECRET;\n    if (!secret) {\n      throw new StorageError('APP_SECRET is required for generating presigned URLs')\n    }\n\n    // Build a relative URL pointing to the StorageController route\n    const routePath = `${this.routeBasePath}/${this.config.disk}/${path}`\n    const urlWithMethod = `${routePath}?method=${method}`\n    const url = await signUrl(urlWithMethod, secret, { expiresIn })\n\n    return {\n      url,\n      expiresIn,\n      expiresAt: new Date(Date.now() + expiresIn * 1000),\n      method,\n    }\n  }\n\n  async chunkedUpload(\n    body: StreamingBlobPayloadInputTypes,\n    path: string,\n    options: Omit<UploadOptions, 'size'> & { size?: number }\n  ): Promise<UploadResult> {\n    const multipartUpload = await this.bucket.createMultipartUpload(path, {\n      httpMetadata: {\n        contentType: options.mimeType,\n      },\n      customMetadata: options.metadata,\n    })\n\n    const parts: R2UploadedPart[] = []\n\n    try {\n      if (body instanceof ReadableStream) {\n        const reader = (body as ReadableStream<Uint8Array>).getReader()\n        let buffer = new Uint8Array(0)\n        let partNumber = 1\n\n        while (true) {\n          const { done, value } = await reader.read()\n\n          if (value) {\n            const newBuffer = new Uint8Array(buffer.length + value.length)\n            newBuffer.set(buffer, 0)\n            newBuffer.set(value, buffer.length)\n            buffer = newBuffer\n          }\n\n          while (buffer.length >= MIN_PART_SIZE) {\n            const partData = buffer.slice(0, MIN_PART_SIZE)\n            buffer = buffer.slice(MIN_PART_SIZE)\n            const part = await multipartUpload.uploadPart(partNumber, partData)\n            parts.push(part)\n            partNumber++\n          }\n\n          if (done) {\n            // Upload remaining buffer as final part\n            if (buffer.length > 0) {\n              const part = await multipartUpload.uploadPart(partNumber, buffer)\n              parts.push(part)\n            }\n            break\n          }\n        }\n      } else if (body !== null && body !== undefined) {\n        // Non-stream body: upload as single part\n        const part = await multipartUpload.uploadPart(1, body as ArrayBuffer | ArrayBufferView | string | Blob)\n        parts.push(part)\n      }\n\n      await multipartUpload.complete(parts)\n    } catch (error) {\n      await multipartUpload.abort()\n      throw error\n    }\n\n    // Get actual size via head\n    const headResult = await this.bucket.head(path)\n\n    return {\n      path,\n      disk: this.config.disk,\n      fullPath: path,\n      size: headResult?.size ?? options.size ?? 0,\n      mimeType: options.mimeType ?? 'application/octet-stream',\n      uploadedAt: new Date(),\n    }\n  }\n\n  // ============================================\n  // IMultipartProvider - Multipart upload methods\n  // ============================================\n\n  getBucket(): string {\n    return this.config.binding\n  }\n\n  async headObject(key: string): Promise<HeadObjectResult | null> {\n    const obj = await this.bucket.head(key)\n    if (!obj) {\n      return null\n    }\n    return {\n      size: obj.size,\n      contentType: obj.httpMetadata?.contentType,\n      metadata: obj.customMetadata,\n    }\n  }\n\n  async deleteObjects(keys: string[]): Promise<DeleteObjectsResult> {\n    if (keys.length === 0) {\n      return { deleted: 0, errors: [] }\n    }\n\n    await this.bucket.delete(keys)\n\n    return {\n      deleted: keys.length,\n      errors: [],\n    }\n  }\n\n  async createMultipartUpload(\n    key: string,\n    options?: CreateMultipartOptions\n  ): Promise<CreateMultipartResult> {\n    const upload = await this.bucket.createMultipartUpload(key, {\n      httpMetadata: {\n        contentType: options?.contentType,\n        cacheControl: options?.cacheControl,\n      },\n      customMetadata: options?.metadata,\n    })\n\n    // Track upload for listMultipartUploads\n    await this.bucket.put(\n      `${MULTIPART_PREFIX}${upload.uploadId}.json`,\n      JSON.stringify({ key: upload.key, uploadId: upload.uploadId, initiated: new Date().toISOString() }),\n      { httpMetadata: { contentType: 'application/json' } }\n    )\n\n    return {\n      uploadId: upload.uploadId,\n      key: upload.key,\n    }\n  }\n\n  async uploadPart(\n    key: string,\n    uploadId: string,\n    partNumber: number,\n    body: Uint8Array\n  ): Promise<UploadPartResult> {\n    const upload = this.bucket.resumeMultipartUpload(key, uploadId)\n    const part = await upload.uploadPart(partNumber, body)\n\n    // Track part for listParts\n    await this.bucket.put(\n      `${PARTS_PREFIX}${uploadId}/${partNumber}`,\n      JSON.stringify({ partNumber: part.partNumber, etag: part.etag, size: body.length }),\n      { httpMetadata: { contentType: 'application/json' } }\n    )\n\n    return {\n      etag: part.etag,\n      partNumber: part.partNumber,\n    }\n  }\n\n  async completeMultipartUpload(\n    key: string,\n    uploadId: string,\n    parts: CompletedPart[]\n  ): Promise<CompleteMultipartResult> {\n    const upload = this.bucket.resumeMultipartUpload(key, uploadId)\n    const result = await upload.complete(\n      parts.map((p) => ({\n        partNumber: p.partNumber,\n        etag: p.etag,\n      }))\n    )\n\n    await this.cleanupTrackingObjects(uploadId)\n\n    return {\n      key: result.key,\n    }\n  }\n\n  async abortMultipartUpload(key: string, uploadId: string): Promise<void> {\n    const upload = this.bucket.resumeMultipartUpload(key, uploadId)\n    await upload.abort()\n\n    await this.cleanupTrackingObjects(uploadId)\n  }\n\n  async listParts(\n    _key: string,\n    uploadId: string,\n    partNumberMarker?: string\n  ): Promise<ListPartsResult> {\n    const prefix = `${PARTS_PREFIX}${uploadId}/`\n    const listed = await this.bucket.list({\n      prefix,\n      cursor: partNumberMarker,\n    })\n\n    const parts = await Promise.all(\n      listed.objects.map(async (obj) => {\n        const data = await this.bucket.get(obj.key)\n        if (!data) {\n          return null\n        }\n        return JSON.parse(await data.text()) as { partNumber: number; etag: string; size: number }\n      })\n    )\n\n    const validParts = parts\n      .filter((p): p is NonNullable<typeof p> => p !== null)\n      .sort((a, b) => a.partNumber - b.partNumber)\n\n    return {\n      parts: validParts,\n      isTruncated: listed.truncated,\n      nextPartNumberMarker: listed.truncated ? listed.cursor : undefined,\n    }\n  }\n\n  async listMultipartUploads(\n    keyMarker?: string,\n    _uploadIdMarker?: string\n  ): Promise<ListMultipartUploadsResult> {\n    const listed = await this.bucket.list({\n      prefix: MULTIPART_PREFIX,\n      cursor: keyMarker,\n    })\n\n    const uploads = await Promise.all(\n      listed.objects.map(async (obj) => {\n        const data = await this.bucket.get(obj.key)\n        if (!data) {\n          return null\n        }\n        const parsed = JSON.parse(await data.text()) as { key: string; uploadId: string; initiated: string }\n        return {\n          key: parsed.key,\n          uploadId: parsed.uploadId,\n          initiated: new Date(parsed.initiated),\n        }\n      })\n    )\n\n    return {\n      uploads: uploads.filter((u): u is NonNullable<typeof u> => u !== null),\n      isTruncated: listed.truncated,\n      nextKeyMarker: listed.truncated ? listed.cursor : undefined,\n      nextUploadIdMarker: undefined,\n    }\n  }\n\n  // ============================================\n  // Private helpers\n  // ============================================\n\n  private async cleanupTrackingObjects(uploadId: string): Promise<void> {\n    // Delete part tracking objects\n    const partsPrefix = `${PARTS_PREFIX}${uploadId}/`\n    let cursor: string | undefined\n    const keysToDelete: string[] = []\n\n    do {\n      const listed = await this.bucket.list({ prefix: partsPrefix, cursor })\n      for (const obj of listed.objects) {\n        keysToDelete.push(obj.key)\n      }\n      cursor = listed.truncated ? listed.cursor : undefined\n    } while (cursor)\n\n    // Delete multipart tracking object\n    keysToDelete.push(`${MULTIPART_PREFIX}${uploadId}.json`)\n\n    if (keysToDelete.length > 0) {\n      await this.bucket.delete(keysToDelete)\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/route-name-DGoBOfPg.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"route-name-DGoBOfPg.mjs","names":[],"sources":["../src/router/utils/path.ts","../src/router/utils/route-name.ts"],"sourcesContent":["/**\n * Path normalization and route ordering utilities.\n *\n * Users always write Hono-style `:param` paths (`:companyId`, `:id`).\n * OpenAPI requires `{param}` style — conversion happens only at registration time.\n */\n\n/**\n * Convert Hono-style `:param` path segments to OpenAPI-style `{param}`.\n * Strips regex constraints (e.g., `:locale{sw}` → `{locale}`).\n *\n * @example\n * toOpenAPIPath('/users/:id')                    // '/users/{id}'\n * toOpenAPIPath('/:companyId/users/:userId')     // '/{companyId}/users/{userId}'\n * toOpenAPIPath('/users/:id/posts')              // '/users/{id}/posts'\n * toOpenAPIPath('/:locale{en|fr}/users')         // '/{locale}/users'\n */\nexport function toOpenAPIPath(path: string): string {\n  return path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)(\\{[^}]*\\})?/g, '{$1}')\n}\n\n/**\n * Convert Hono-style `:param` path segments to OpenAPI-style `{param}`,\n * preserving regex constraints.\n *\n * Used for Hono route registration via `app.openapi()`. The non-greedy\n * regex in `@hono/zod-openapi` (`\\/{(.+?)}/g`) converts `{param}` back\n * to `:param` while leaving the constraint suffix intact.\n *\n * @example\n * toRoutingOpenAPIPath('/:locale{sw}/users/:id')  // '/{locale}{sw}/users/{id}'\n * toRoutingOpenAPIPath('/users/:id')               // '/users/{id}'\n */\nexport function toRoutingOpenAPIPath(path: string): string {\n  return path.replace(\n    /:([a-zA-Z_][a-zA-Z0-9_]*)(\\{[^}]*\\})?/g,\n    (_, name: string, constraint?: string) => constraint ? `{${name}}${constraint}` : `{${name}}`,\n  )\n}\n\n/**\n * Compute a packed specificity key for route ordering.\n * Encodes both score and segment count into a single number to avoid object allocation.\n *\n * Lower score = higher priority (registered first in Hono).\n * Scoring: static = 0, `:param{constraint}` = 5, `:param` = 10, wildcard `{.+}` / `{.*}` = 100.\n *\n * Packed as: score * 10000 - segmentCount (negative segment count so more segments = lower key = higher priority)\n *\n * Locale variants score against the path with the leading `/:locale{…}` segment\n * stripped — the variant's score therefore matches its primary, but its larger\n * segment count makes it sort just before the primary. Without this, a primary\n * catch-all (e.g. `/:slug{.+}`) gobbles locale-prefixed URLs because Hono picks\n * whichever matching route was registered first.\n */\nfunction getPathSpecificityKey(route: { path: string; isLocaleVariant?: boolean }): number {\n  const segmentCount = countSegments(route.path)\n  const scoringPath = route.isLocaleVariant\n    ? (route.path.replace(/^\\/:locale\\{[^}]*\\}/, '') || '/')\n    : route.path\n\n  let score = 0\n  let i = 0\n  while (i < scoringPath.length) {\n    if (scoringPath.charCodeAt(i) === 47 /* '/' */) { i++; continue }\n\n    let end = scoringPath.indexOf('/', i)\n    if (end === -1) end = scoringPath.length\n\n    const segment = scoringPath.substring(i, end)\n\n    if (segment.includes('{.+}') || segment.includes('{.*}')) {\n      score += 100\n    } else if (segment.charCodeAt(0) === 58 /* ':' */) {\n      score += segment.includes('{') ? 5 : 10\n    }\n\n    i = end\n  }\n\n  return score * 10000 - segmentCount\n}\n\nfunction countSegments(path: string): number {\n  let count = 0\n  let i = 0\n  while (i < path.length) {\n    if (path.charCodeAt(i) === 47 /* '/' */) { i++; continue }\n    let end = path.indexOf('/', i)\n    if (end === -1) end = path.length\n    count++\n    i = end\n  }\n  return count\n}\n\n/**\n * Compute a specificity score for route ordering.\n * Lower score = higher priority (registered first in Hono).\n *\n * Scoring: static = 0, `:param{constraint}` = 5, `:param` = 10, wildcard `{.+}` / `{.*}` = 100.\n */\nexport function getPathSpecificityScore(path: string): number {\n  const segments = path.split('/').filter(Boolean)\n  let score = 0\n  for (const segment of segments) {\n    if (segment.includes('{.+}') || segment.includes('{.*}')) {\n      score += 100\n    } else if (segment.startsWith(':') && segment.includes('{')) {\n      score += 5\n    } else if (segment.startsWith(':')) {\n      score += 10\n    }\n  }\n  return score\n}\n\n/**\n * Sort routes by specificity so Hono registers them in the correct order.\n *\n * 1. Static paths before parameterized before wildcards\n * 2. More segments = more specific (tie-breaker)\n * 3. Locale-prefixed variants before their primary (so a locale-prefixed\n *    request matches the variant first; a primary catch-all would otherwise\n *    swallow the locale prefix into its param)\n */\nexport function sortRoutesBySpecificity<T extends { path: string; isLocaleVariant?: boolean }>(routes: T[]): T[] {\n  // Pre-compute packed specificity keys (avoids object allocation per route)\n  const keys = new Map<T, number>()\n  for (const route of routes) {\n    keys.set(route, getPathSpecificityKey(route))\n  }\n\n  const copy = routes.slice()\n  copy.sort((a, b) => keys.get(a)! - keys.get(b)!)\n  return copy\n}\n","/**\n * Route naming utilities.\n *\n * Extracts parameter names from paths and domains,\n * and generates convention-based route names.\n */\n\n/**\n * Extract parameter names from a Hono-style path.\n *\n * @example\n * extractParamNames('/users/:id')                     // ['id']\n * extractParamNames('/:companyId/users/:userId')      // ['companyId', 'userId']\n * extractParamNames('/users')                         // []\n */\nexport function extractParamNames(path: string): string[] {\n  if (!path.includes(':')) return []\n  const matches = path.matchAll(/:([a-zA-Z_][a-zA-Z0-9_]*)/g)\n  return [...matches].map(m => m[1])\n}\n\n/**\n * Extract parameter names from a domain pattern.\n *\n * @example\n * extractDomainParamNames('{tenant}.example.com')           // ['tenant']\n * extractDomainParamNames('{region}.{tenant}.example.com')  // ['region', 'tenant']\n * extractDomainParamNames('example.com')                    // []\n */\nexport function extractDomainParamNames(domain: string): string[] {\n  if (!domain.includes('{')) return []\n  const matches = domain.matchAll(/\\{([a-zA-Z_][a-zA-Z0-9_]*)\\}/g)\n  return [...matches].map(m => m[1])\n}\n\n/**\n * Auto-generate a route name for convention-based `@Route` methods.\n *\n * Strips common prefixes (`/api/`, `/v{N}/`) and parameter segments,\n * then joins remaining static segments with dots and appends the method name.\n *\n * @example\n * generateConventionRouteName('/users', 'index')                         // 'users.index'\n * generateConventionRouteName('/users', 'show')                          // 'users.show'\n * generateConventionRouteName('/api/v1/users', 'create')                 // 'users.create'\n * generateConventionRouteName('/api/v1/users/:userId/notes', 'index')    // 'users.notes.index'\n * generateConventionRouteName('/:companyId/users', 'index')              // 'users.index'\n * generateConventionRouteName('/users/:userId/notes/:noteId/tags', 'index') // 'users.notes.tags.index'\n */\nexport function generateConventionRouteName(basePath: string, methodName: string): string {\n  // Single-pass: split and filter in one loop (avoids 4 intermediate arrays)\n  const parts = basePath.split('/')\n  const segments: string[] = []\n  for (const s of parts) {\n    if (s && s !== 'api' && !s.startsWith(':') && !/^v\\d+$/.test(s)) {\n      segments.push(s)\n    }\n  }\n\n  if (segments.length === 0) {\n    return methodName\n  }\n\n  return `${segments.join('.')}.${methodName}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAgB,cAAc,MAAsB;CAClD,OAAO,KAAK,QAAQ,0CAA0C,MAAM;AACtE;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,MAAsB;CACzD,OAAO,KAAK,QACV,2CACC,GAAG,MAAc,eAAwB,aAAa,IAAI,KAAK,GAAG,eAAe,IAAI,KAAK,EAC7F;AACF;;;;;;;;;;;;;;;;AAiBA,SAAS,sBAAsB,OAA4D;CACzF,MAAM,eAAe,cAAc,MAAM,IAAI;CAC7C,MAAM,cAAc,MAAM,kBACrB,MAAM,KAAK,QAAQ,uBAAuB,EAAE,KAAK,MAClD,MAAM;CAEV,IAAI,QAAQ;CACZ,IAAI,IAAI;CACR,OAAO,IAAI,YAAY,QAAQ;EAC7B,IAAI,YAAY,WAAW,CAAC,MAAM,IAAc;GAAE;GAAK;EAAS;EAEhE,IAAI,MAAM,YAAY,QAAQ,KAAK,CAAC;EACpC,IAAI,QAAQ,IAAI,MAAM,YAAY;EAElC,MAAM,UAAU,YAAY,UAAU,GAAG,GAAG;EAE5C,IAAI,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,GACrD,SAAS;OACJ,IAAI,QAAQ,WAAW,CAAC,MAAM,IACnC,SAAS,QAAQ,SAAS,GAAG,IAAI,IAAI;EAGvC,IAAI;CACN;CAEA,OAAO,QAAQ,MAAQ;AACzB;AAEA,SAAS,cAAc,MAAsB;CAC3C,IAAI,QAAQ;CACZ,IAAI,IAAI;CACR,OAAO,IAAI,KAAK,QAAQ;EACtB,IAAI,KAAK,WAAW,CAAC,MAAM,IAAc;GAAE;GAAK;EAAS;EACzD,IAAI,MAAM,KAAK,QAAQ,KAAK,CAAC;EAC7B,IAAI,QAAQ,IAAI,MAAM,KAAK;EAC3B;EACA,IAAI;CACN;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,wBAAwB,MAAsB;CAC5D,MAAM,WAAW,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;CAC/C,IAAI,QAAQ;CACZ,KAAK,MAAM,WAAW,UACpB,IAAI,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,GACrD,SAAS;MACJ,IAAI,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,GACxD,SAAS;MACJ,IAAI,QAAQ,WAAW,GAAG,GAC/B,SAAS;CAGb,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,wBAA+E,QAAkB;CAE/G,MAAM,uBAAO,IAAI,IAAe;CAChC,KAAK,MAAM,SAAS,QAClB,KAAK,IAAI,OAAO,sBAAsB,KAAK,CAAC;CAG9C,MAAM,OAAO,OAAO,MAAM;CAC1B,KAAK,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,IAAK,KAAK,IAAI,CAAC,CAAE;CAC/C,OAAO;AACT;;;;;;;;;;;;;;;;;ACzHA,SAAgB,kBAAkB,MAAwB;CACxD,IAAI,CAAC,KAAK,SAAS,GAAG,GAAG,OAAO,CAAC;CAEjC,OAAO,CAAC,GADQ,KAAK,SAAS,4BACb,CAAC,EAAE,KAAI,MAAK,EAAE,EAAE;AACnC;;;;;;;;;AAUA,SAAgB,wBAAwB,QAA0B;CAChE,IAAI,CAAC,OAAO,SAAS,GAAG,GAAG,OAAO,CAAC;CAEnC,OAAO,CAAC,GADQ,OAAO,SAAS,+BACf,CAAC,EAAE,KAAI,MAAK,EAAE,EAAE;AACnC;;;;;;;;;;;;;;;AAgBA,SAAgB,4BAA4B,UAAkB,YAA4B;CAExF,MAAM,QAAQ,SAAS,MAAM,GAAG;CAChC,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,KAAK,OACd,IAAI,KAAK,MAAM,SAAS,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,SAAS,KAAK,CAAC,GAC5D,SAAS,KAAK,CAAC;CAInB,IAAI,SAAS,WAAW,GACtB,OAAO;CAGT,OAAO,GAAG,SAAS,KAAK,GAAG,EAAE,GAAG;AAClC"}