stratal 0.0.15 → 0.0.16

package/dist/{stratal-Cm0Yy8v4.mjs.map → stratal-CE0iTz4f.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"stratal-Cm0Yy8v4.mjs","names":["tsyringeRootContainer"],"sources":["../src/application.ts","../src/stratal.ts"],"sourcesContent":["import { injectable, container as tsyringeRootContainer } from 'tsyringe'\nimport { CacheModule } from './cache'\nimport type { CronJob } from './cron/cron-job'\nimport { CronManager } from './cron/cron-manager'\nimport { Container } from './di/container'\nimport { DI_TOKENS } from './di/tokens'\nimport { Scope } from './di/types'\nimport { type StratalEnv } from './env'\nimport { ApplicationError, GlobalErrorHandler } from './errors'\nimport type { EventHandler } from './events'\nimport { EventRegistry, getListenerHandlers } from './events'\nimport type { StratalExecutionContext } from './execution-context'\nimport { I18nModule } from './i18n/i18n.module'\nimport { ConsoleTransport, JsonFormatter, LOGGER_TOKENS, LoggerService, LogLevel, PrettyFormatter } from './logger'\nimport { ModuleRegistry } from './module/module-registry'\nimport type { DynamicModule, ModuleClass } from './module/types'\nimport { OpenAPIModule } from './openapi'\nimport type { Command } from './quarry/command'\nimport { QuarryRegistry } from './quarry/quarry-registry'\nimport type { CommandInput, CommandResult } from './quarry/types'\nimport { type ConsumerRegistry } from './queue/consumer-registry'\nimport type { IQueueConsumer, QueueMessage } from './queue/queue-consumer'\nimport { type QueueManager } from './queue/queue-manager'\nimport { QueueModule } from './queue/queue.module'\nimport { type IController, type RouterContext } from './router'\nimport { HonoApp } from './router/hono-app'\nimport type { VersioningOptions } from './router/types'\nimport { DbSeedCommand, DbSeedListCommand, SEEDER_TOKENS, SeederRegistry, type Seeder } from './seeder'\nimport type { Constructor } from './types'\n\nexport interface ApplicationConfig {\n  /** Root application module */\n  module: ModuleClass | DynamicModule\n  /** Logging configuration. Defaults: level=INFO, formatter='json' */\n  logging?: {\n    level?: LogLevel\n    formatter?: 'json' | 'pretty'\n  }\n  /**\n   * API versioning configuration.\n   * When provided, enables URI-based versioning for controllers.\n   */\n  versioning?: VersioningOptions\n}\n\nexport interface ApplicationOptions extends ApplicationConfig {\n  env: StratalEnv\n  ctx: StratalExecutionContext\n}\n\n/**\n * Application\n *\n * Main application class managing the two-tier container hierarchy:\n * - Global Container: All services (singletons via tsyringe native)\n * - Request Container: Child of global, context-enriched instances per request\n *\n * @example\n * ```typescript\n * const app = new Application({ module: AppModule, env, ctx })\n * await app.initialize()\n *\n * // Access container via getter\n * const service = app.container.resolve(MY_TOKEN)\n *\n * // Handle HTTP request (via HonoApp)\n * // Handle queue batch\n * await app.handleQueue(batch, 'my-queue')\n * ```\n */\nexport class Application {\n  /**\n   * Unified Container - manages all DI operations\n   */\n  private _container: Container\n\n  private honoApp!: HonoApp\n  private moduleRegistry: ModuleRegistry\n  private consumerRegistry!: ConsumerRegistry\n  private cronManager!: CronManager\n  private quarry!: QuarryRegistry\n  private initialized = false\n\n  readonly env: StratalEnv\n  private readonly appConfig: ApplicationConfig\n\n  constructor({ env, ctx, ...config }: ApplicationOptions) {\n    this.env = env\n    this.appConfig = config\n\n    ApplicationError.captureStackTraces = env.ENVIRONMENT !== 'production'\n\n    // Create unified Container with explicit child container\n    this._container = new Container({\n      container: tsyringeRootContainer.createChildContainer()\n    })\n\n    // Register globally — env and ctx always available\n    this._container.registerValue(DI_TOKENS.Application, this)\n    this._container.registerValue(DI_TOKENS.CloudflareEnv, env)\n    this._container.registerValue(DI_TOKENS.ExecutionContext, ctx)\n\n    // Register core infrastructure inline\n    this.registerLoggerService()\n    this.registerCoreServices()\n\n    // Create ModuleRegistry with our Container\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.moduleRegistry = new ModuleRegistry(this._container, logger)\n\n    // Register ModuleRegistry in container so modules can access it in onInitialize\n    this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry)\n  }\n\n  /**\n   * Get the Container instance\n   */\n  get container(): Container {\n    return this._container\n  }\n\n  /**\n   * Get the HonoApp instance\n   */\n  get hono(): HonoApp {\n    return this.honoApp\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    // Phase 1: Register core infrastructure modules (internal)\n    this.moduleRegistry.registerAll([\n      I18nModule,\n      OpenAPIModule,\n      QueueModule,\n      CacheModule,\n    ])\n\n    // Phase 2: Register user's root module (traverses imports)\n    this.moduleRegistry.register(this.appConfig.module)\n\n    // Phase 3: Initialize all modules\n    await this.moduleRegistry.initialize()\n\n    // Phase 4: Resolve managers from container\n    this.consumerRegistry = this._container.resolve<ConsumerRegistry>(DI_TOKENS.ConsumerRegistry)\n    this.cronManager = this._container.resolve<CronManager>(DI_TOKENS.Cron)\n    this.quarry = this._container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Phase 5: Create & configure HonoApp\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.honoApp = new HonoApp(this._container, logger)\n    const middlewareConfigs = this.moduleRegistry.getAllMiddlewareConfigs()\n    const controllers = this.moduleRegistry.getAllControllers() as Constructor<IController>[]\n    await this.honoApp.configure(middlewareConfigs, controllers, this.appConfig.versioning)\n\n    // Phase 6: Configure queues, cron, events, commands, seeders\n    this.registerQueueConsumers()\n    this.registerCronJobs()\n    this.registerEventListeners()\n    this.registerSeeders()\n    this.registerCommands()\n\n    this.initialized = true\n  }\n\n  /**\n   * Resolve a service from the container\n   */\n  resolve<T>(token: symbol): T {\n    try {\n      return this._container.resolve(token)\n    } catch (error) {\n      const errorHandler = this._container.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n      const errorResponse = errorHandler.handle(error)\n      throw errorResponse as unknown as Error\n    }\n  }\n\n  /**\n   * Handle queue batch processing\n   */\n  async handleQueue(batch: MessageBatch, queueName: string): Promise<void> {\n    const firstMessage = batch.messages[0]?.body as QueueMessage | undefined\n    const locale = firstMessage?.metadata?.locale ?? 'en'\n    const mockRouterContext = this.createMockRouterContext(locale)\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        const queueManager = requestContainer.resolve<QueueManager>(DI_TOKENS.Queue)\n        await queueManager.processBatch(queueName, batch)\n      } catch (error) {\n        const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n        errorHandler.handle(error)\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Handle scheduled cron trigger\n   */\n  async handleScheduled(controller: ScheduledController): Promise<void> {\n    const mockRouterContext = this.createMockRouterContext('en')\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        await this.cronManager.executeScheduled(controller)\n      } catch (error) {\n        const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n        errorHandler.handle(error)\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Create mock RouterContext for queue/cron/seeder processing\n   */\n  createMockRouterContext(locale = 'en'): RouterContext {\n    return {\n      getLocale: () => locale,\n      setLocale: () => { /* no-op */ },\n      getContainer: () => this._container,\n    } as unknown as RouterContext\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.initialized) return\n    this.initialized = false\n\n    await this.moduleRegistry.shutdown()\n\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    logger.info('Disposing container...')\n\n    await this._container.dispose()\n  }\n\n  /**\n   * Execute a command by name in a request-scoped container.\n   */\n  async handleCommand(name: string, input?: CommandInput): Promise<CommandResult> {\n    const mockContext = this.createMockRouterContext('en')\n    return this._container.runInRequestScope(mockContext, async () => {\n      return this.quarry.call(name, input)\n    })\n  }\n\n  private registerCommands(): void {\n    // Built-in seeder commands (always available)\n    const builtinCommands: Constructor<Command>[] = [DbSeedCommand, DbSeedListCommand]\n    for (const Cmd of builtinCommands) {\n      injectable()(Cmd)\n      this._container.register(Cmd, Cmd, Scope.Singleton)\n      this.quarry.register(Cmd)\n    }\n\n    // User commands from modules\n    const commands = this.moduleRegistry.getAllCommands()\n    if (commands.length === 0) {\n      return\n    }\n\n    for (const CommandClass of commands) {\n      this.quarry.register(CommandClass as Constructor<Command>)\n    }\n  }\n\n  private registerSeeders(): void {\n    const seeders = this.moduleRegistry.getAllSeeders()\n    if (seeders.length === 0) return\n    const registry = this._container.resolve<SeederRegistry>(SEEDER_TOKENS.SeederRegistry)\n    for (const SeederClass of seeders) {\n      registry.register(SeederClass as Constructor<Seeder>)\n    }\n  }\n\n  private registerQueueConsumers(): void {\n    for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {\n      const consumer = this._container.resolve(ConsumerClass) as IQueueConsumer\n      this.consumerRegistry.register(consumer)\n    }\n  }\n\n  private registerCronJobs(): void {\n    for (const JobClass of this.moduleRegistry.getAllJobs()) {\n      const job = this._container.resolve(JobClass) as CronJob\n      this.cronManager.registerJob(job)\n    }\n  }\n\n  /**\n   * Auto-wire `@Listener()` classes with the EventRegistry.\n   */\n  private registerEventListeners(): void {\n    const listeners = this.moduleRegistry.getAllListeners()\n    if (listeners.length === 0) {\n      return\n    }\n\n    const eventRegistry = this._container.resolve<EventRegistry>(DI_TOKENS.EventRegistry)\n\n    for (const ListenerClass of listeners) {\n      const instance = this._container.resolve(ListenerClass) as Record<string, ((...args: unknown[]) => unknown)>\n      const handlers = getListenerHandlers(ListenerClass)\n\n      for (const { methodName, event, options } of handlers) {\n        eventRegistry.on(event, instance[methodName].bind(instance) as EventHandler, options)\n      }\n    }\n  }\n\n  /**\n   * Register LoggerService and dependencies\n   */\n  private registerLoggerService(): void {\n    const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO\n    const formatter = this.appConfig.logging?.formatter ?? 'json'\n\n    this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel)\n\n    this._container\n      .when(() => formatter === 'pretty')\n      .use(LOGGER_TOKENS.Formatter)\n      .give(PrettyFormatter)\n      .otherwise(JsonFormatter)\n\n    this._container.registerSingleton(LOGGER_TOKENS.ConsoleTransport, ConsoleTransport)\n    this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)])\n    this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService)\n  }\n\n  /**\n   * Register core services with explicit scope\n   */\n  private registerCoreServices(): void {\n    this._container.registerSingleton(DI_TOKENS.Cron, CronManager)\n    this._container.register(DI_TOKENS.ErrorHandler, GlobalErrorHandler)\n    this._container.registerSingleton(DI_TOKENS.EventRegistry, EventRegistry)\n    this._container.registerSingleton(DI_TOKENS.Quarry, QuarryRegistry)\n    this._container.registerValue(SEEDER_TOKENS.SeederRegistry, new SeederRegistry(this))\n  }\n}\n","import 'reflect-metadata'\n\nimport { Application, type ApplicationConfig } from './application'\nimport type { StratalEnv } from './env'\nimport { StratalNotInitializedError } from './errors'\nimport type { HonoApp } from './router/hono-app'\n\n/**\n * Stratal — Hono-style entry point for Cloudflare Workers.\n *\n * Eagerly bootstraps the Application at construction time, dynamically\n * importing `cloudflare:workers` for env and waitUntil.\n *\n * @example\n * ```typescript\n * import { Stratal } from 'stratal'\n * import { AppModule } from './app.module'\n *\n * export default new Stratal({ module: AppModule })\n * ```\n */\nexport class Stratal<Env extends StratalEnv = StratalEnv> {\n  private app: Application | null = null\n  private initPromise: Promise<Application>\n\n  private static _application: Promise<Application> | null = null\n\n  constructor(config: ApplicationConfig) {\n    this.fetch = this.fetch.bind(this)\n    this.queue = this.queue.bind(this)\n    this.scheduled = this.scheduled.bind(this)\n\n    this.initPromise = this.prepareApp(config)\n    Stratal._application = this.initPromise\n  }\n\n  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {\n    const app = await this.ensureReady()\n    return app.hono.fetch(request, env, ctx)\n  }\n\n  async queue(batch: MessageBatch): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleQueue(batch, batch.queue)\n  }\n\n  async scheduled(controller: ScheduledController): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleScheduled(controller)\n  }\n\n  get hono(): Promise<HonoApp> {\n    return this.initPromise.then(app => app.hono)\n  }\n\n  async shutdown(): Promise<void> {\n    try { this.app = await this.initPromise } catch { /* ignore */ }\n    if (this.app) {\n      await this.app.shutdown()\n      this.app = null\n    }\n  }\n\n  /**\n   * @internal\n   * Resolves the Application instance from the static singleton.\n   * Used by worker base classes (DurableObject, Workflow, WorkerEntrypoint)\n   * to access the DI container without going through Cloudflare RPC.\n   */\n  static resolveApplication(): Promise<Application> {\n    if (!Stratal._application) {\n      throw new StratalNotInitializedError()\n    }\n    return Stratal._application\n  }\n\n  private async ensureReady(): Promise<Application> {\n    this.app ??= await this.initPromise;\n    return this.app\n  }\n\n  private async prepareApp(config: ApplicationConfig): Promise<Application> {\n    const { env, waitUntil } = await import('cloudflare:workers')\n    const app = new Application({ ...config, env: env as Env, ctx: { waitUntil } })\n    await app.initialize()\n    return app\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"stratal-CE0iTz4f.mjs","names":["tsyringeRootContainer"],"sources":["../src/application.ts","../src/stratal.ts"],"sourcesContent":["import { injectable, container as tsyringeRootContainer } from 'tsyringe'\nimport { CacheModule } from './cache'\nimport type { CronJob } from './cron/cron-job'\nimport { CronManager } from './cron/cron-manager'\nimport { Container } from './di/container'\nimport { DI_TOKENS } from './di/tokens'\nimport { Scope } from './di/types'\nimport { type StratalEnv } from './env'\nimport { ApplicationError, GlobalErrorHandler } from './errors'\nimport type { EventHandler } from './events'\nimport { EventRegistry, getListenerHandlers } from './events'\nimport type { StratalExecutionContext } from './execution-context'\nimport { I18nModule } from './i18n/i18n.module'\nimport { ConsoleTransport, JsonFormatter, LOGGER_TOKENS, LoggerService, LogLevel, PrettyFormatter } from './logger'\nimport { ModuleRegistry } from './module/module-registry'\nimport type { DynamicModule, ModuleClass } from './module/types'\nimport { OpenAPIModule } from './openapi'\nimport type { Command } from './quarry/command'\nimport { QuarryRegistry } from './quarry/quarry-registry'\nimport type { CommandInput, CommandResult } from './quarry/types'\nimport { type ConsumerRegistry } from './queue/consumer-registry'\nimport type { IQueueConsumer, QueueMessage } from './queue/queue-consumer'\nimport { type QueueManager } from './queue/queue-manager'\nimport { QueueModule } from './queue/queue.module'\nimport { type IController, type RouterContext } from './router'\nimport { HonoApp } from './router/hono-app'\nimport type { VersioningOptions } from './router/types'\nimport { DbSeedCommand, DbSeedListCommand, SEEDER_TOKENS, SeederRegistry, type Seeder } from './seeder'\nimport type { Constructor } from './types'\n\nexport interface ApplicationConfig {\n  /** Root application module */\n  module: ModuleClass | DynamicModule\n  /** Logging configuration. Defaults: level=INFO, formatter='json' */\n  logging?: {\n    level?: LogLevel\n    formatter?: 'json' | 'pretty'\n  }\n  /**\n   * API versioning configuration.\n   * When provided, enables URI-based versioning for controllers.\n   */\n  versioning?: VersioningOptions\n}\n\nexport interface ApplicationOptions extends ApplicationConfig {\n  env: StratalEnv\n  ctx: StratalExecutionContext\n}\n\n/**\n * Application\n *\n * Main application class managing the two-tier container hierarchy:\n * - Global Container: All services (singletons via tsyringe native)\n * - Request Container: Child of global, context-enriched instances per request\n *\n * @example\n * ```typescript\n * const app = new Application({ module: AppModule, env, ctx })\n * await app.initialize()\n *\n * // Access container via getter\n * const service = app.container.resolve(MY_TOKEN)\n *\n * // Handle HTTP request (via HonoApp)\n * // Handle queue batch\n * await app.handleQueue(batch, 'my-queue')\n * ```\n */\nexport class Application {\n  /**\n   * Unified Container - manages all DI operations\n   */\n  private _container: Container\n\n  private honoApp!: HonoApp\n  private moduleRegistry: ModuleRegistry\n  private consumerRegistry!: ConsumerRegistry\n  private cronManager!: CronManager\n  private quarry!: QuarryRegistry\n  private initialized = false\n\n  readonly env: StratalEnv\n  private readonly appConfig: ApplicationConfig\n\n  constructor({ env, ctx, ...config }: ApplicationOptions) {\n    this.env = env\n    this.appConfig = config\n\n    ApplicationError.captureStackTraces = env.ENVIRONMENT !== 'production'\n\n    // Create unified Container with explicit child container\n    this._container = new Container({\n      container: tsyringeRootContainer.createChildContainer()\n    })\n\n    // Register globally — env and ctx always available\n    this._container.registerValue(DI_TOKENS.Application, this)\n    this._container.registerValue(DI_TOKENS.CloudflareEnv, env)\n    this._container.registerValue(DI_TOKENS.ExecutionContext, ctx)\n\n    // Register core infrastructure inline\n    this.registerLoggerService()\n    this.registerCoreServices()\n\n    // Create ModuleRegistry with our Container\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.moduleRegistry = new ModuleRegistry(this._container, logger)\n\n    // Register ModuleRegistry in container so modules can access it in onInitialize\n    this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry)\n  }\n\n  /**\n   * Get the Container instance\n   */\n  get container(): Container {\n    return this._container\n  }\n\n  /**\n   * Get the HonoApp instance\n   */\n  get hono(): HonoApp {\n    return this.honoApp\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    // Phase 1: Register core infrastructure modules (internal)\n    this.moduleRegistry.registerAll([\n      I18nModule,\n      OpenAPIModule,\n      QueueModule,\n      CacheModule,\n    ])\n\n    // Phase 2: Register user's root module (traverses imports)\n    this.moduleRegistry.register(this.appConfig.module)\n\n    // Phase 3: Initialize all modules\n    await this.moduleRegistry.initialize()\n\n    // Phase 4: Resolve managers from container\n    this.consumerRegistry = this._container.resolve<ConsumerRegistry>(DI_TOKENS.ConsumerRegistry)\n    this.cronManager = this._container.resolve<CronManager>(DI_TOKENS.Cron)\n    this.quarry = this._container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Phase 5: Create & configure HonoApp\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.honoApp = new HonoApp(this._container, logger)\n    const middlewareConfigs = this.moduleRegistry.getAllMiddlewareConfigs()\n    const controllers = this.moduleRegistry.getAllControllers() as Constructor<IController>[]\n    await this.honoApp.configure(middlewareConfigs, controllers, this.appConfig.versioning)\n\n    // Phase 6: Configure queues, cron, events, commands, seeders\n    this.registerQueueConsumers()\n    this.registerCronJobs()\n    this.registerEventListeners()\n    this.registerSeeders()\n    this.registerCommands()\n\n    this.initialized = true\n  }\n\n  /**\n   * Resolve a service from the container\n   */\n  resolve<T>(token: symbol): T {\n    try {\n      return this._container.resolve(token)\n    } catch (error) {\n      const errorHandler = this._container.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n      const errorResponse = errorHandler.handle(error)\n      throw errorResponse as unknown as Error\n    }\n  }\n\n  /**\n   * Handle queue batch processing\n   */\n  async handleQueue(batch: MessageBatch, queueName: string): Promise<void> {\n    const firstMessage = batch.messages[0]?.body as QueueMessage | undefined\n    const locale = firstMessage?.metadata?.locale ?? 'en'\n    const mockRouterContext = this.createMockRouterContext(locale)\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        const queueManager = requestContainer.resolve<QueueManager>(DI_TOKENS.Queue)\n        await queueManager.processBatch(queueName, batch)\n      } catch (error) {\n        const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n        errorHandler.handle(error)\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Handle scheduled cron trigger\n   */\n  async handleScheduled(controller: ScheduledController): Promise<void> {\n    const mockRouterContext = this.createMockRouterContext('en')\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        await this.cronManager.executeScheduled(controller)\n      } catch (error) {\n        const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n        errorHandler.handle(error)\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Create mock RouterContext for queue/cron/seeder processing\n   */\n  createMockRouterContext(locale = 'en'): RouterContext {\n    return {\n      getLocale: () => locale,\n      setLocale: () => { /* no-op */ },\n      getContainer: () => this._container,\n    } as unknown as RouterContext\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.initialized) return\n    this.initialized = false\n\n    await this.moduleRegistry.shutdown()\n\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    logger.info('Disposing container...')\n\n    await this._container.dispose()\n  }\n\n  /**\n   * Execute a command by name in a request-scoped container.\n   */\n  async handleCommand(name: string, input?: CommandInput): Promise<CommandResult> {\n    const mockContext = this.createMockRouterContext('en')\n    return this._container.runInRequestScope(mockContext, async () => {\n      return this.quarry.call(name, input)\n    })\n  }\n\n  private registerCommands(): void {\n    // Built-in seeder commands (always available)\n    const builtinCommands: Constructor<Command>[] = [DbSeedCommand, DbSeedListCommand]\n    for (const Cmd of builtinCommands) {\n      injectable()(Cmd)\n      this._container.register(Cmd, Cmd, Scope.Singleton)\n      this.quarry.register(Cmd)\n    }\n\n    // User commands from modules\n    const commands = this.moduleRegistry.getAllCommands()\n    if (commands.length === 0) {\n      return\n    }\n\n    for (const CommandClass of commands) {\n      this.quarry.register(CommandClass as Constructor<Command>)\n    }\n  }\n\n  private registerSeeders(): void {\n    const seeders = this.moduleRegistry.getAllSeeders()\n    if (seeders.length === 0) return\n    const registry = this._container.resolve<SeederRegistry>(SEEDER_TOKENS.SeederRegistry)\n    for (const SeederClass of seeders) {\n      registry.register(SeederClass as Constructor<Seeder>)\n    }\n  }\n\n  private registerQueueConsumers(): void {\n    for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {\n      const consumer = this._container.resolve(ConsumerClass) as IQueueConsumer\n      this.consumerRegistry.register(consumer)\n    }\n  }\n\n  private registerCronJobs(): void {\n    for (const JobClass of this.moduleRegistry.getAllJobs()) {\n      const job = this._container.resolve(JobClass) as CronJob\n      this.cronManager.registerJob(job)\n    }\n  }\n\n  /**\n   * Auto-wire `@Listener()` classes with the EventRegistry.\n   */\n  private registerEventListeners(): void {\n    const listeners = this.moduleRegistry.getAllListeners()\n    if (listeners.length === 0) {\n      return\n    }\n\n    const eventRegistry = this._container.resolve<EventRegistry>(DI_TOKENS.EventRegistry)\n\n    for (const ListenerClass of listeners) {\n      const instance = this._container.resolve(ListenerClass) as Record<string, ((...args: unknown[]) => unknown)>\n      const handlers = getListenerHandlers(ListenerClass)\n\n      for (const { methodName, event, options } of handlers) {\n        eventRegistry.on(event, instance[methodName].bind(instance) as EventHandler, options)\n      }\n    }\n  }\n\n  /**\n   * Register LoggerService and dependencies\n   */\n  private registerLoggerService(): void {\n    const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO\n    const formatter = this.appConfig.logging?.formatter ?? 'json'\n\n    this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel)\n\n    this._container\n      .when(() => formatter === 'pretty')\n      .use(LOGGER_TOKENS.Formatter)\n      .give(PrettyFormatter)\n      .otherwise(JsonFormatter)\n\n    this._container.registerSingleton(LOGGER_TOKENS.ConsoleTransport, ConsoleTransport)\n    this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)])\n    this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService)\n  }\n\n  /**\n   * Register core services with explicit scope\n   */\n  private registerCoreServices(): void {\n    this._container.registerSingleton(DI_TOKENS.Cron, CronManager)\n    this._container.register(DI_TOKENS.ErrorHandler, GlobalErrorHandler)\n    this._container.registerSingleton(DI_TOKENS.EventRegistry, EventRegistry)\n    this._container.registerSingleton(DI_TOKENS.Quarry, QuarryRegistry)\n    this._container.registerValue(SEEDER_TOKENS.SeederRegistry, new SeederRegistry(this))\n  }\n}\n","import 'reflect-metadata'\n\nimport { Application, type ApplicationConfig } from './application'\nimport type { StratalEnv } from './env'\nimport { StratalNotInitializedError } from './errors'\nimport type { HonoApp } from './router/hono-app'\n\n/**\n * Stratal — Hono-style entry point for Cloudflare Workers.\n *\n * Eagerly bootstraps the Application at construction time, dynamically\n * importing `cloudflare:workers` for env and waitUntil.\n *\n * @example\n * ```typescript\n * import { Stratal } from 'stratal'\n * import { AppModule } from './app.module'\n *\n * export default new Stratal({ module: AppModule })\n * ```\n */\nexport class Stratal<Env extends StratalEnv = StratalEnv> {\n  private app: Application | null = null\n  private initPromise: Promise<Application>\n\n  private static _application: Promise<Application> | null = null\n\n  constructor(config: ApplicationConfig) {\n    this.fetch = this.fetch.bind(this)\n    this.queue = this.queue.bind(this)\n    this.scheduled = this.scheduled.bind(this)\n\n    this.initPromise = this.prepareApp(config)\n    Stratal._application = this.initPromise\n  }\n\n  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {\n    const app = await this.ensureReady()\n    return app.hono.fetch(request, env, ctx)\n  }\n\n  async queue(batch: MessageBatch): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleQueue(batch, batch.queue)\n  }\n\n  async scheduled(controller: ScheduledController): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleScheduled(controller)\n  }\n\n  get hono(): Promise<HonoApp> {\n    return this.initPromise.then(app => app.hono)\n  }\n\n  async shutdown(): Promise<void> {\n    try { this.app = await this.initPromise } catch { /* ignore */ }\n    if (this.app) {\n      await this.app.shutdown()\n      this.app = null\n    }\n  }\n\n  /**\n   * @internal\n   * Resolves the Application instance from the static singleton.\n   * Used by worker base classes (DurableObject, Workflow, WorkerEntrypoint)\n   * to access the DI container without going through Cloudflare RPC.\n   */\n  static resolveApplication(): Promise<Application> {\n    if (!Stratal._application) {\n      throw new StratalNotInitializedError()\n    }\n    return Stratal._application\n  }\n\n  private async ensureReady(): Promise<Application> {\n    this.app ??= await this.initPromise;\n    return this.app\n  }\n\n  private async prepareApp(config: ApplicationConfig): Promise<Application> {\n    const { env, waitUntil } = await import('cloudflare:workers')\n    const app = new Application({ ...config, env: env as Env, ctx: { waitUntil } })\n    await app.initialize()\n    return app\n  }\n}\n"],"mappings":"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"}

package/dist/{types-N84Ak6YT.d.mts → types-CLhOhYsQ.d.mts}

@@ -61,4 +61,4 @@ interface ParsedSignature {
 }
 //#endregion
 export { ParsedOption as a, ParsedArgument as i, CommandInternals as n, ParsedSignature as o, CommandResult as r, Quarry as s, CommandInput as t };
-//# sourceMappingURL=types-N84Ak6YT.d.mts.map
+//# sourceMappingURL=types-CLhOhYsQ.d.mts.map

package/dist/{types-N84Ak6YT.d.mts.map → types-CLhOhYsQ.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-N84Ak6YT.d.mts","names":[],"sources":["../src/quarry/types.ts"],"mappings":";;AAGA;;KAAY,YAAA,GAAe,MAAA;;;AAK3B;UAAiB,aAAA;EACf,QAAA;EACA,MAAA;EACA,MAAA;AAAA;;;;AAQF;;UAAiB,MAAA;EACf,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;AAAA;;;;;UAOnC,gBAAA;EACf,MAAA,EAAQ,YAAA;EACR,MAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA,EAAQ,MAAA;AAAA;AALV;;;AAAA,UAWiB,cAAA;EACf,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;UAMe,YAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;EACA,OAAA;EACA,WAAA;AAAA;;;;UAMe,eAAA;EACf,IAAA;EACA,SAAA,EAAW,cAAA;EACX,OAAA,EAAS,YAAA;AAAA"}
+{"version":3,"file":"types-CLhOhYsQ.d.mts","names":[],"sources":["../src/quarry/types.ts"],"mappings":";;AAGA;;KAAY,YAAA,GAAe,MAAA;;;AAK3B;UAAiB,aAAA;EACf,QAAA;EACA,MAAA;EACA,MAAA;AAAA;;;;AAQF;;UAAiB,MAAA;EACf,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;AAAA;;;;;UAOnC,gBAAA;EACf,MAAA,EAAQ,YAAA;EACR,MAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA,EAAQ,MAAA;AAAA;AALV;;;AAAA,UAWiB,cAAA;EACf,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;UAMe,YAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;EACA,OAAA;EACA,WAAA;AAAA;;;;UAMe,eAAA;EACf,IAAA;EACA,SAAA,EAAW,cAAA;EACX,OAAA,EAAS,YAAA;AAAA"}

package/dist/{types-Cu4jkeiH.d.mts → types-DahElfUw.d.mts}

@@ -16,4 +16,4 @@
 type Constructor<T extends object = object> = new (...args: any[]) => T;
 //#endregion
 export { Constructor as t };
-//# sourceMappingURL=types-Cu4jkeiH.d.mts.map
+//# sourceMappingURL=types-DahElfUw.d.mts.map

package/dist/types-DahElfUw.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DahElfUw.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,WAAA,sCAAiD,IAAA,YAAgB,CAAA"}

package/dist/usage-generator-C9hWziY4.mjs

@@ -0,0 +1,158 @@
+import { t as __exportAll } from "./chunk-D1SwGrFN.mjs";
+import { i as dimWhite, n as cyan, r as dim, s as yellow, t as bold } from "./colors-DJaRDXoS.mjs";
+//#region src/quarry/usage-generator.ts
+var usage_generator_exports = /* @__PURE__ */ __exportAll({
+	generateListing: () => generateListing,
+	generateUsage: () => generateUsage
+});
+/**
+* Generate formatted help/usage text from a parsed signature.
+*
+* Pure function, edge-compatible.
+*/
+function generateUsage(signature, description) {
+	const lines = [];
+	lines.push(`${bold("Usage:")} ${bold(cyan("quarry " + buildUsageLine(signature)))}`);
+	if (description) {
+		lines.push("");
+		lines.push(description);
+	}
+	if (signature.arguments.length > 0) {
+		lines.push("");
+		lines.push(bold(yellow("Arguments:")));
+		const argRows = signature.arguments.map((arg) => {
+			const label = arg.name;
+			const parts = [];
+			if (arg.description) parts.push(arg.description);
+			if (arg.isArray) parts.push("(variadic)");
+			else if (arg.required) parts.push("(required)");
+			else if (arg.default !== void 0) parts.push(dim(`(default: ${arg.default})`));
+			else parts.push("(optional)");
+			return [label, parts.join(" ")];
+		});
+		lines.push(...formatTable(argRows));
+	}
+	if (signature.options.length > 0) {
+		lines.push("");
+		lines.push(bold(yellow("Options:")));
+		const optRows = signature.options.map((opt) => {
+			const flagParts = [];
+			if (opt.alias) flagParts.push(`-${opt.alias},`);
+			flagParts.push(`--${opt.name}`);
+			const label = flagParts.join(" ");
+			const parts = [];
+			if (opt.description) parts.push(opt.description);
+			if (!opt.isFlag && !opt.description) parts.push("Accepts a value");
+			if (opt.isFlag && !opt.description) parts.push("Boolean flag");
+			if (opt.isArray) parts.push("(multiple)");
+			if (opt.default !== void 0) parts.push(dim(`(default: ${opt.default})`));
+			return [label, parts.join(" ")];
+		});
+		lines.push(...formatTable(optRows));
+	}
+	return lines.join("\n");
+}
+/**
+* Generate a compact command listing with visual hierarchy.
+*/
+function generateListing(commands, signatures, options) {
+	const bin = options?.binaryName ?? "quarry";
+	const label = options?.binaryLabel ?? "Quarry CLI";
+	const version = options?.binaryVersion;
+	const lines = [];
+	lines.push(bold(`${label}${version ? ` v${version}` : ""}`));
+	lines.push("");
+	lines.push(bold(yellow("Usage")));
+	lines.push(`  $ ${bin} <command> [options]`);
+	lines.push("");
+	if (commands.length === 0) {
+		lines.push("No registered commands.");
+		return lines.join("\n");
+	}
+	lines.push(bold(yellow("Commands")));
+	const termWidth = typeof process !== "undefined" ? process.stdout.columns ?? 80 : 80;
+	for (let i = 0; i < commands.length; i++) {
+		const cmd = commands[i];
+		const sig = signatures.get(cmd.name);
+		const sigParts = [cyan(cmd.name)];
+		if (cmd.aliases.length > 0) sigParts.push(cyan(`(alias: ${cmd.aliases.join(", ")})`));
+		if (sig) {
+			const inlineParts = [];
+			for (const arg of sig.arguments) inlineParts.push(formatArgPlaceholder(arg));
+			for (const opt of sig.options) {
+				const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`;
+				inlineParts.push(`[${flagStr}]`);
+			}
+			if (inlineParts.length > 0) sigParts.push(dim(inlineParts.join(" ")));
+		}
+		const sigLine = "  " + sigParts.join(" ");
+		lines.push(...wrapLine(sigLine, termWidth, "      "));
+		if (cmd.description) lines.push(`    ${dimWhite(cmd.description)}`);
+		if (i < commands.length - 1) lines.push("");
+	}
+	lines.push("");
+	lines.push(dimWhite(`Run ${bin} help <command> for detailed information.`));
+	return lines.join("\n");
+}
+/** Format a single argument into its placeholder representation (e.g. `<name>`, `[name=default]`). */
+function formatArgPlaceholder(arg) {
+	if (arg.isArray) return `<${arg.name}...>`;
+	if (arg.required) return `<${arg.name}>`;
+	if (arg.default !== void 0) return `[${arg.name}=${arg.default}]`;
+	return `[${arg.name}]`;
+}
+/** Build the inline usage line showing the command name with argument and option placeholders. */
+function buildUsageLine(signature) {
+	const parts = [signature.name];
+	for (const arg of signature.arguments) parts.push(formatArgPlaceholder(arg));
+	for (const opt of signature.options) {
+		const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`;
+		if (opt.isFlag) parts.push(`[${flagStr}]`);
+		else if (opt.isArray) parts.push(`[${flagStr} <value...>]`);
+		else parts.push(`[${flagStr} <value>]`);
+	}
+	return parts.join(" ");
+}
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+/** Remove ANSI escape sequences from a string. */
+function stripAnsi(s) {
+	return s.replace(ANSI_RE, "");
+}
+const TOKEN_RE = /(?:\x1b\[[0-9;]*m)*[^\s\x1b]+(?:\x1b\[[0-9;]*m)*/g;
+/** Wrap a single line at word boundaries, preserving ANSI codes across wrapped segments. */
+function wrapLine(text, maxWidth, continuationIndent) {
+	if (stripAnsi(text).length <= maxWidth) return [text];
+	const tokens = text.match(TOKEN_RE) ?? [text];
+	const lines = [];
+	let currentLine = "";
+	let currentVisibleLen = 0;
+	for (const token of tokens) {
+		const tokenVisible = stripAnsi(token).length;
+		const separator = currentLine === "" ? "" : " ";
+		const separatorLen = separator.length;
+		if (currentLine !== "" && currentVisibleLen + separatorLen + tokenVisible > maxWidth) {
+			lines.push(currentLine);
+			currentLine = continuationIndent + token;
+			currentVisibleLen = continuationIndent.length + tokenVisible;
+		} else {
+			currentLine += separator + token;
+			currentVisibleLen += separatorLen + tokenVisible;
+		}
+	}
+	if (currentLine !== "") lines.push(currentLine);
+	return lines;
+}
+/** Format label/description pairs into aligned two-column table rows. */
+function formatTable(rows) {
+	if (rows.length === 0) return [];
+	const maxLabel = Math.max(...rows.map(([label]) => stripAnsi(label).length));
+	const padding = 4;
+	return rows.map(([label, desc]) => {
+		const visibleLen = stripAnsi(label).length;
+		return `  ${label}${" ".repeat(maxLabel - visibleLen + padding)}${desc}`;
+	});
+}
+//#endregion
+export { usage_generator_exports as n, generateUsage as t };
+
+//# sourceMappingURL=usage-generator-C9hWziY4.mjs.map

package/dist/usage-generator-C9hWziY4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-generator-C9hWziY4.mjs","names":[],"sources":["../src/quarry/usage-generator.ts"],"sourcesContent":["import { bold, cyan, dim, dimWhite, yellow } from './colors'\nimport type { ParsedSignature } from './types'\n\n/**\n * Generate formatted help/usage text from a parsed signature.\n *\n * Pure function, edge-compatible.\n */\nexport function generateUsage(signature: ParsedSignature, description?: string): string {\n  const lines: string[] = []\n\n  // Usage line\n  lines.push(`${bold('Usage:')} ${bold(cyan('quarry ' + buildUsageLine(signature)))}`)\n\n  // Description\n  if (description) {\n    lines.push('')\n    lines.push(description)\n  }\n\n  // Arguments section\n  if (signature.arguments.length > 0) {\n    lines.push('')\n    lines.push(bold(yellow('Arguments:')))\n    const argRows = signature.arguments.map((arg) => {\n      const label = arg.name\n      const parts: string[] = []\n\n      if (arg.description) parts.push(arg.description)\n\n      if (arg.isArray) {\n        parts.push('(variadic)')\n      } else if (arg.required) {\n        parts.push('(required)')\n      } else if (arg.default !== undefined) {\n        parts.push(dim(`(default: ${arg.default})`))\n      } else {\n        parts.push('(optional)')\n      }\n\n      return [label, parts.join(' ')] as const\n    })\n    lines.push(...formatTable(argRows))\n  }\n\n  // Options section\n  if (signature.options.length > 0) {\n    lines.push('')\n    lines.push(bold(yellow('Options:')))\n    const optRows = signature.options.map((opt) => {\n      const flagParts: string[] = []\n      if (opt.alias) flagParts.push(`-${opt.alias},`)\n      flagParts.push(`--${opt.name}`)\n\n      const label = flagParts.join(' ')\n      const parts: string[] = []\n\n      if (opt.description) parts.push(opt.description)\n      if (!opt.isFlag && !opt.description) parts.push('Accepts a value')\n      if (opt.isFlag && !opt.description) parts.push('Boolean flag')\n      if (opt.isArray) parts.push('(multiple)')\n      if (opt.default !== undefined) parts.push(dim(`(default: ${opt.default})`))\n\n      return [label, parts.join(' ')] as const\n    })\n    lines.push(...formatTable(optRows))\n  }\n\n  return lines.join('\\n')\n}\n\nexport interface ListingOptions {\n  binaryName?: string\n  binaryLabel?: string\n  binaryVersion?: string\n}\n\n/**\n * Generate a compact command listing with visual hierarchy.\n */\nexport function generateListing(\n  commands: { name: string; description?: string; aliases: string[] }[],\n  signatures: Map<string, ParsedSignature>,\n  options?: ListingOptions,\n): string {\n  const bin = options?.binaryName ?? 'quarry'\n  const label = options?.binaryLabel ?? 'Quarry CLI'\n  const version = options?.binaryVersion\n\n  const lines: string[] = []\n\n  // Header\n  lines.push(bold(`${label}${version ? ` v${version}` : ''}`))\n  lines.push('')\n\n  // Usage\n  lines.push(bold(yellow('Usage')))\n  lines.push(`  $ ${bin} <command> [options]`)\n  lines.push('')\n\n  // Commands\n  if (commands.length === 0) {\n    lines.push('No registered commands.')\n    return lines.join('\\n')\n  }\n\n  lines.push(bold(yellow('Commands')))\n\n  const termWidth = typeof process !== 'undefined'\n    ? (process.stdout.columns as number | undefined) ?? 80\n    : 80\n\n  for (let i = 0; i < commands.length; i++) {\n    const cmd = commands[i]\n    const sig = signatures.get(cmd.name)\n    const sigParts: string[] = [cyan(cmd.name)]\n\n    if (cmd.aliases.length > 0) {\n      sigParts.push(cyan(`(alias: ${cmd.aliases.join(', ')})`))\n    }\n\n    if (sig) {\n      const inlineParts: string[] = []\n      for (const arg of sig.arguments) {\n        inlineParts.push(formatArgPlaceholder(arg))\n      }\n\n      for (const opt of sig.options) {\n        const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n        inlineParts.push(`[${flagStr}]`)\n      }\n\n      if (inlineParts.length > 0) {\n        sigParts.push(dim(inlineParts.join(' ')))\n      }\n    }\n\n    const sigLine = '  ' + sigParts.join(' ')\n    lines.push(...wrapLine(sigLine, termWidth, '      '))\n\n    if (cmd.description) {\n      lines.push(`    ${dimWhite(cmd.description)}`)\n    }\n\n    if (i < commands.length - 1) {\n      lines.push('')\n    }\n  }\n\n  lines.push('')\n\n  // Footer\n  lines.push(dimWhite(`Run ${bin} help <command> for detailed information.`))\n\n  return lines.join('\\n')\n}\n\n/** Format a single argument into its placeholder representation (e.g. `<name>`, `[name=default]`). */\nfunction formatArgPlaceholder(arg: ParsedSignature['arguments'][number]): string {\n  if (arg.isArray) return `<${arg.name}...>`\n  if (arg.required) return `<${arg.name}>`\n  if (arg.default !== undefined) return `[${arg.name}=${arg.default}]`\n  return `[${arg.name}]`\n}\n\n/** Build the inline usage line showing the command name with argument and option placeholders. */\nfunction buildUsageLine(signature: ParsedSignature): string {\n  const parts = [signature.name]\n\n  for (const arg of signature.arguments) {\n    parts.push(formatArgPlaceholder(arg))\n  }\n\n  for (const opt of signature.options) {\n    const flagStr = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n\n    if (opt.isFlag) {\n      parts.push(`[${flagStr}]`)\n    } else if (opt.isArray) {\n      parts.push(`[${flagStr} <value...>]`)\n    } else {\n      parts.push(`[${flagStr} <value>]`)\n    }\n  }\n\n  return parts.join(' ')\n}\n\n// eslint-disable-next-line no-control-regex\nconst ANSI_RE = /\\x1b\\[[0-9;]*m/g\n\n/** Remove ANSI escape sequences from a string. */\nfunction stripAnsi(s: string): string {\n  return s.replace(ANSI_RE, '')\n}\n\n// eslint-disable-next-line no-control-regex\nconst TOKEN_RE = /(?:\\x1b\\[[0-9;]*m)*[^\\s\\x1b]+(?:\\x1b\\[[0-9;]*m)*/g\n\n/** Wrap a single line at word boundaries, preserving ANSI codes across wrapped segments. */\nfunction wrapLine(text: string, maxWidth: number, continuationIndent: string): string[] {\n  const visibleLen = stripAnsi(text).length\n  if (visibleLen <= maxWidth) return [text]\n\n  const tokens = text.match(TOKEN_RE) ?? [text]\n\n  const lines: string[] = []\n  let currentLine = ''\n  let currentVisibleLen = 0\n\n  for (const token of tokens) {\n    const tokenVisible = stripAnsi(token).length\n    const separator = currentLine === '' ? '' : ' '\n    const separatorLen = separator.length\n\n    if (currentLine !== '' && currentVisibleLen + separatorLen + tokenVisible > maxWidth) {\n      lines.push(currentLine)\n      currentLine = continuationIndent + token\n      currentVisibleLen = continuationIndent.length + tokenVisible\n    } else {\n      currentLine += separator + token\n      currentVisibleLen += separatorLen + tokenVisible\n    }\n  }\n\n  if (currentLine !== '') {\n    lines.push(currentLine)\n  }\n\n  return lines\n}\n\n/** Format label/description pairs into aligned two-column table rows. */\nfunction formatTable(rows: readonly (readonly [string, string])[]): string[] {\n  if (rows.length === 0) return []\n\n  const maxLabel = Math.max(...rows.map(([label]) => stripAnsi(label).length))\n  const padding = 4\n\n  return rows.map(([label, desc]) => {\n    const visibleLen = stripAnsi(label).length\n    const pad = ' '.repeat(maxLabel - visibleLen + padding)\n    return `  ${label}${pad}${desc}`\n  })\n}\n"],"mappings":";;;;;;;;;;;;AAQA,SAAgB,cAAc,WAA4B,aAA8B;CACtF,MAAM,QAAkB,EAAE;AAG1B,OAAM,KAAK,GAAG,KAAK,SAAS,CAAC,GAAG,KAAK,KAAK,YAAY,eAAe,UAAU,CAAC,CAAC,GAAG;AAGpF,KAAI,aAAa;AACf,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,YAAY;;AAIzB,KAAI,UAAU,UAAU,SAAS,GAAG;AAClC,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,KAAK,OAAO,aAAa,CAAC,CAAC;EACtC,MAAM,UAAU,UAAU,UAAU,KAAK,QAAQ;GAC/C,MAAM,QAAQ,IAAI;GAClB,MAAM,QAAkB,EAAE;AAE1B,OAAI,IAAI,YAAa,OAAM,KAAK,IAAI,YAAY;AAEhD,OAAI,IAAI,QACN,OAAM,KAAK,aAAa;YACf,IAAI,SACb,OAAM,KAAK,aAAa;YACf,IAAI,YAAY,KAAA,EACzB,OAAM,KAAK,IAAI,aAAa,IAAI,QAAQ,GAAG,CAAC;OAE5C,OAAM,KAAK,aAAa;AAG1B,UAAO,CAAC,OAAO,MAAM,KAAK,IAAI,CAAC;IAC/B;AACF,QAAM,KAAK,GAAG,YAAY,QAAQ,CAAC;;AAIrC,KAAI,UAAU,QAAQ,SAAS,GAAG;AAChC,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,KAAK,OAAO,WAAW,CAAC,CAAC;EACpC,MAAM,UAAU,UAAU,QAAQ,KAAK,QAAQ;GAC7C,MAAM,YAAsB,EAAE;AAC9B,OAAI,IAAI,MAAO,WAAU,KAAK,IAAI,IAAI,MAAM,GAAG;AAC/C,aAAU,KAAK,KAAK,IAAI,OAAO;GAE/B,MAAM,QAAQ,UAAU,KAAK,IAAI;GACjC,MAAM,QAAkB,EAAE;AAE1B,OAAI,IAAI,YAAa,OAAM,KAAK,IAAI,YAAY;AAChD,OAAI,CAAC,IAAI,UAAU,CAAC,IAAI,YAAa,OAAM,KAAK,kBAAkB;AAClE,OAAI,IAAI,UAAU,CAAC,IAAI,YAAa,OAAM,KAAK,eAAe;AAC9D,OAAI,IAAI,QAAS,OAAM,KAAK,aAAa;AACzC,OAAI,IAAI,YAAY,KAAA,EAAW,OAAM,KAAK,IAAI,aAAa,IAAI,QAAQ,GAAG,CAAC;AAE3E,UAAO,CAAC,OAAO,MAAM,KAAK,IAAI,CAAC;IAC/B;AACF,QAAM,KAAK,GAAG,YAAY,QAAQ,CAAC;;AAGrC,QAAO,MAAM,KAAK,KAAK;;;;;AAYzB,SAAgB,gBACd,UACA,YACA,SACQ;CACR,MAAM,MAAM,SAAS,cAAc;CACnC,MAAM,QAAQ,SAAS,eAAe;CACtC,MAAM,UAAU,SAAS;CAEzB,MAAM,QAAkB,EAAE;AAG1B,OAAM,KAAK,KAAK,GAAG,QAAQ,UAAU,KAAK,YAAY,KAAK,CAAC;AAC5D,OAAM,KAAK,GAAG;AAGd,OAAM,KAAK,KAAK,OAAO,QAAQ,CAAC,CAAC;AACjC,OAAM,KAAK,OAAO,IAAI,sBAAsB;AAC5C,OAAM,KAAK,GAAG;AAGd,KAAI,SAAS,WAAW,GAAG;AACzB,QAAM,KAAK,0BAA0B;AACrC,SAAO,MAAM,KAAK,KAAK;;AAGzB,OAAM,KAAK,KAAK,OAAO,WAAW,CAAC,CAAC;CAEpC,MAAM,YAAY,OAAO,YAAY,cAChC,QAAQ,OAAO,WAAkC,KAClD;AAEJ,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,MAAM,SAAS;EACrB,MAAM,MAAM,WAAW,IAAI,IAAI,KAAK;EACpC,MAAM,WAAqB,CAAC,KAAK,IAAI,KAAK,CAAC;AAE3C,MAAI,IAAI,QAAQ,SAAS,EACvB,UAAS,KAAK,KAAK,WAAW,IAAI,QAAQ,KAAK,KAAK,CAAC,GAAG,CAAC;AAG3D,MAAI,KAAK;GACP,MAAM,cAAwB,EAAE;AAChC,QAAK,MAAM,OAAO,IAAI,UACpB,aAAY,KAAK,qBAAqB,IAAI,CAAC;AAG7C,QAAK,MAAM,OAAO,IAAI,SAAS;IAC7B,MAAM,UAAU,IAAI,QAAQ,IAAI,IAAI,MAAM,KAAK,IAAI,SAAS,KAAK,IAAI;AACrE,gBAAY,KAAK,IAAI,QAAQ,GAAG;;AAGlC,OAAI,YAAY,SAAS,EACvB,UAAS,KAAK,IAAI,YAAY,KAAK,IAAI,CAAC,CAAC;;EAI7C,MAAM,UAAU,OAAO,SAAS,KAAK,IAAI;AACzC,QAAM,KAAK,GAAG,SAAS,SAAS,WAAW,SAAS,CAAC;AAErD,MAAI,IAAI,YACN,OAAM,KAAK,OAAO,SAAS,IAAI,YAAY,GAAG;AAGhD,MAAI,IAAI,SAAS,SAAS,EACxB,OAAM,KAAK,GAAG;;AAIlB,OAAM,KAAK,GAAG;AAGd,OAAM,KAAK,SAAS,OAAO,IAAI,2CAA2C,CAAC;AAE3E,QAAO,MAAM,KAAK,KAAK;;;AAIzB,SAAS,qBAAqB,KAAmD;AAC/E,KAAI,IAAI,QAAS,QAAO,IAAI,IAAI,KAAK;AACrC,KAAI,IAAI,SAAU,QAAO,IAAI,IAAI,KAAK;AACtC,KAAI,IAAI,YAAY,KAAA,EAAW,QAAO,IAAI,IAAI,KAAK,GAAG,IAAI,QAAQ;AAClE,QAAO,IAAI,IAAI,KAAK;;;AAItB,SAAS,eAAe,WAAoC;CAC1D,MAAM,QAAQ,CAAC,UAAU,KAAK;AAE9B,MAAK,MAAM,OAAO,UAAU,UAC1B,OAAM,KAAK,qBAAqB,IAAI,CAAC;AAGvC,MAAK,MAAM,OAAO,UAAU,SAAS;EACnC,MAAM,UAAU,IAAI,QAAQ,IAAI,IAAI,MAAM,KAAK,IAAI,SAAS,KAAK,IAAI;AAErE,MAAI,IAAI,OACN,OAAM,KAAK,IAAI,QAAQ,GAAG;WACjB,IAAI,QACb,OAAM,KAAK,IAAI,QAAQ,cAAc;MAErC,OAAM,KAAK,IAAI,QAAQ,WAAW;;AAItC,QAAO,MAAM,KAAK,IAAI;;AAIxB,MAAM,UAAU;;AAGhB,SAAS,UAAU,GAAmB;AACpC,QAAO,EAAE,QAAQ,SAAS,GAAG;;AAI/B,MAAM,WAAW;;AAGjB,SAAS,SAAS,MAAc,UAAkB,oBAAsC;AAEtF,KADmB,UAAU,KAAK,CAAC,UACjB,SAAU,QAAO,CAAC,KAAK;CAEzC,MAAM,SAAS,KAAK,MAAM,SAAS,IAAI,CAAC,KAAK;CAE7C,MAAM,QAAkB,EAAE;CAC1B,IAAI,cAAc;CAClB,IAAI,oBAAoB;AAExB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,eAAe,UAAU,MAAM,CAAC;EACtC,MAAM,YAAY,gBAAgB,KAAK,KAAK;EAC5C,MAAM,eAAe,UAAU;AAE/B,MAAI,gBAAgB,MAAM,oBAAoB,eAAe,eAAe,UAAU;AACpF,SAAM,KAAK,YAAY;AACvB,iBAAc,qBAAqB;AACnC,uBAAoB,mBAAmB,SAAS;SAC3C;AACL,kBAAe,YAAY;AAC3B,wBAAqB,eAAe;;;AAIxC,KAAI,gBAAgB,GAClB,OAAM,KAAK,YAAY;AAGzB,QAAO;;;AAIT,SAAS,YAAY,MAAwD;AAC3E,KAAI,KAAK,WAAW,EAAG,QAAO,EAAE;CAEhC,MAAM,WAAW,KAAK,IAAI,GAAG,KAAK,KAAK,CAAC,WAAW,UAAU,MAAM,CAAC,OAAO,CAAC;CAC5E,MAAM,UAAU;AAEhB,QAAO,KAAK,KAAK,CAAC,OAAO,UAAU;EACjC,MAAM,aAAa,UAAU,MAAM,CAAC;AAEpC,SAAO,KAAK,QADA,IAAI,OAAO,WAAW,aAAa,QAAQ,GAC7B;GAC1B"}

package/dist/{validation-Dbt-snjx.mjs → validation-Bh875Lyg.mjs}

@@ -191,4 +191,4 @@ __reExport(validation_exports, import__hono_zod_openapi);
 //#endregion
 export { withI18n as a, z as i, ZodError as n, backendErrorMap as o, validation_exports as r, runWithErrorMapContext as s, OpenAPIHono as t };
 
-//# sourceMappingURL=validation-Dbt-snjx.mjs.map
+//# sourceMappingURL=validation-Bh875Lyg.mjs.map

package/dist/{validation-Dbt-snjx.mjs.map → validation-Bh875Lyg.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"validation-Dbt-snjx.mjs","names":[],"sources":["../src/i18n/validation/validation.error-map.ts","../src/i18n/validation/validation.context.ts","../src/i18n/validation/with-i18n.ts","../src/i18n/validation/index.ts"],"sourcesContent":["import type {\n  $ZodErrorMap,\n  $ZodIssueInvalidKey,\n  $ZodIssueInvalidStringFormat,\n  $ZodIssueInvalidType,\n  $ZodIssueInvalidUnion,\n  $ZodIssueNotMultipleOf,\n  $ZodIssueTooBig,\n  $ZodIssueTooSmall,\n  $ZodIssueUnrecognizedKeys,\n  $ZodRawIssue,\n} from 'zod/v4/core'\nimport type { MessageKeys } from '../i18n.types'\nimport type { ErrorMapContext } from './validation.types'\n\n/**\n * Type guards for narrowing Zod v4 issue types\n */\nfunction isInvalidType(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidType> {\n  return issue.code === 'invalid_type'\n}\n\nfunction isTooBig(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooBig> {\n  return issue.code === 'too_big'\n}\n\nfunction isTooSmall(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooSmall> {\n  return issue.code === 'too_small'\n}\n\nfunction isInvalidFormat(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidStringFormat> {\n  return issue.code === 'invalid_format'\n}\n\nfunction isNotMultipleOf(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueNotMultipleOf> {\n  return issue.code === 'not_multiple_of'\n}\n\nfunction isUnrecognizedKeys(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueUnrecognizedKeys> {\n  return issue.code === 'unrecognized_keys'\n}\n\nfunction isInvalidUnion(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidUnion> {\n  return issue.code === 'invalid_union'\n}\n\nfunction isInvalidKey(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidKey> {\n  return issue.code === 'invalid_key'\n}\n\n/**\n * Maps Zod issue codes to zodI18n message keys\n * Adapted for Zod v4's simpler issue code system\n */\nfunction getMessageKey(issue: $ZodRawIssue): MessageKeys {\n  if (isInvalidType(issue)) {\n    if (issue.input === undefined) {\n      return 'zodI18n.errors.required'\n    }\n    return 'zodI18n.errors.invalid_type'\n  }\n\n  if (isTooSmall(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_small.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isTooBig(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_big.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isInvalidFormat(issue)) {\n    // Map v4's format to v3-style validation keys\n    return `zodI18n.errors.invalid_string.${issue.format}` as MessageKeys\n  }\n\n  if (isNotMultipleOf(issue)) {\n    return 'zodI18n.errors.not_multiple_of'\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    return 'zodI18n.errors.unrecognized_keys'\n  }\n\n  if (isInvalidUnion(issue)) {\n    return 'zodI18n.errors.invalid_union'\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: Replaces invalid_enum_value, invalid_literal\n    return 'zodI18n.errors.invalid_enum_value'\n  }\n\n  // invalid_element, invalid_value, or unknown codes\n  return 'zodI18n.errors.custom.default'\n}\n\n/**\n * Extracts interpolation parameters from Zod issue\n * Uses proper type narrowing for v4\n */\nfunction getMessageParams(issue: $ZodRawIssue): Record<string, unknown> {\n  const params: Record<string, unknown> = {}\n\n  if (isInvalidType(issue)) {\n    params.expected = issue.expected\n    params.received = String(issue.input)\n    return params\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    params.keys = issue.keys.join(', ')\n    return params\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: For enums and records\n    // Since v4 doesn't have options field, we'll use generic message\n    return params\n  }\n\n  if (isInvalidFormat(issue)) {\n    params.validation = issue.format\n\n    // Check for specific string format issues with additional fields\n    if ('prefix' in issue) {\n      params.startsWith = (issue as { prefix?: string }).prefix\n    }\n    if ('suffix' in issue) {\n      params.endsWith = (issue as { suffix?: string }).suffix\n    }\n    if ('includes' in issue) {\n      params.includes = (issue as { includes?: string }).includes\n    }\n    if (issue.pattern) {\n      params.pattern = issue.pattern\n    }\n\n    return params\n  }\n\n  if (isTooSmall(issue)) {\n    params.minimum = issue.minimum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.minimum = new Date(Number(issue.minimum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isTooBig(issue)) {\n    params.maximum = issue.maximum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.maximum = new Date(Number(issue.maximum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isNotMultipleOf(issue)) {\n    params.multipleOf = issue.divisor\n    return params\n  }\n\n  return params\n}\n\n/**\n * Creates a Zod error map that uses i18n for translation\n * Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)\n */\nexport function createI18nErrorMap(getContext: () => ErrorMapContext | undefined): $ZodErrorMap {\n  return (issue: $ZodRawIssue): { message: string } => {\n    // Get message key and params for this issue\n    const messageKey = getMessageKey(issue)\n    const messageParams = getMessageParams(issue)\n\n    // Get translation context\n    const context = getContext()\n\n    if (!context) {\n      // Fallback: Use English messages directly\n      // This handles config validation at startup, tests, etc.\n      return { message: 'Invalid input' }\n    }\n\n    // Normal flow: Use context-aware i18n (respects user locale)\n    return {\n      message: context.t(messageKey, messageParams),\n    }\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { ErrorMapContext } from './validation.types'\nimport { createI18nErrorMap } from './validation.error-map'\n\n/**\n * AsyncLocalStorage for storing request-scoped ErrorMapContext\n * Allows error map to access I18nService without passing through function calls\n */\nexport const errorMapContextStorage = new AsyncLocalStorage<ErrorMapContext>()\n\n/**\n * Gets the current error map context from AsyncLocalStorage\n */\nfunction getErrorMapContext(): ErrorMapContext | undefined {\n  return errorMapContextStorage.getStore()\n}\n\n/**\n * Backend error map that accesses I18nService from AsyncLocalStorage\n * Must be initialized in router middleware after locale detection\n */\nexport const backendErrorMap = createI18nErrorMap(getErrorMapContext)\n\n/**\n * Runs a function within an error map context\n * Used by router middleware to provide I18nService to validation\n *\n * @example\n * ```typescript\n * router.use('*', async (c, next) => {\n *   const i18nService = c.get('i18nService')\n *   const locale = c.get('locale')\n *\n *   return runWithErrorMapContext(\n *     {\n *       t: (key, params) => i18nService.t(key, params),\n *       locale,\n *     },\n *     () => next()\n *   )\n * })\n * ```\n */\nexport function runWithErrorMapContext<T>(\n  context: ErrorMapContext,\n  fn: () => T\n): T {\n  return errorMapContextStorage.run(context, fn)\n}\n","import type { MessageKeys } from '../i18n.types'\nimport { errorMapContextStorage } from './validation.context'\n\n/**\n * Type-safe helper for creating custom Zod error messages with i18n support (Backend)\n *\n * Usage with .refine():\n * ```typescript\n * const schema = z.string().refine(\n *   (val) => val.length > 5,\n *   withI18n('validation.minLength', { min: 5 })\n * )\n * ```\n *\n * Usage with built-in validators:\n * ```typescript\n * const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))\n * const schema = z.string().email(withI18n('validation.email'))\n * ```\n *\n * Note: This is the backend version using AsyncLocalStorage.\n * For frontend, use withI18nFrontend from the frontend validation module\n *\n * @param key - Message key from shared i18n messages (type-safe via MessageKeys)\n * @param params - Optional interpolation parameters for the message\n * @returns Zod error configuration object with translated message\n */\nexport function withI18n(\n  key: MessageKeys,\n  params?: Record<string, unknown>\n): { error: () => string } {\n  return {\n    error: () => {\n      // Get i18n context from AsyncLocalStorage (backend)\n      // This is set by the router middleware before validation\n      const context = errorMapContextStorage.getStore()\n\n      // Translate using context if available, otherwise fallback to generic message\n      const message = context\n        ? context.t(key, params as Record<string, string | number> | undefined)\n        : 'Invalid input'\n\n      return message\n    },\n  }\n}\n","// Consolidated zod - single source from @hono/zod-openapi (superset of zod)\nexport { OpenAPIHono, z } from '@hono/zod-openapi'\nexport type * from 'zod'\nexport { ZodError } from 'zod'\n\n// OpenAPI utilities\nexport * from '@hono/zod-openapi'\nexport type { OpenAPIObject, PathItemObject } from 'openapi3-ts/oas30'\n\n// Helpers\nexport { withI18n } from './with-i18n'\n\n// Backend utilities\nexport { backendErrorMap, runWithErrorMapContext } from './validation.context'\n\n// Types\nexport type { ErrorMapContext, I18nErrorMetadata, LocaleProvider, ZodCustomIssue } from './validation.types'\n\n"],"mappings":"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"}
+{"version":3,"file":"validation-Bh875Lyg.mjs","names":[],"sources":["../src/i18n/validation/validation.error-map.ts","../src/i18n/validation/validation.context.ts","../src/i18n/validation/with-i18n.ts","../src/i18n/validation/index.ts"],"sourcesContent":["import type {\n  $ZodErrorMap,\n  $ZodIssueInvalidKey,\n  $ZodIssueInvalidStringFormat,\n  $ZodIssueInvalidType,\n  $ZodIssueInvalidUnion,\n  $ZodIssueNotMultipleOf,\n  $ZodIssueTooBig,\n  $ZodIssueTooSmall,\n  $ZodIssueUnrecognizedKeys,\n  $ZodRawIssue,\n} from 'zod/v4/core'\nimport type { MessageKeys } from '../i18n.types'\nimport type { ErrorMapContext } from './validation.types'\n\n/**\n * Type guards for narrowing Zod v4 issue types\n */\nfunction isInvalidType(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidType> {\n  return issue.code === 'invalid_type'\n}\n\nfunction isTooBig(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooBig> {\n  return issue.code === 'too_big'\n}\n\nfunction isTooSmall(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooSmall> {\n  return issue.code === 'too_small'\n}\n\nfunction isInvalidFormat(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidStringFormat> {\n  return issue.code === 'invalid_format'\n}\n\nfunction isNotMultipleOf(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueNotMultipleOf> {\n  return issue.code === 'not_multiple_of'\n}\n\nfunction isUnrecognizedKeys(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueUnrecognizedKeys> {\n  return issue.code === 'unrecognized_keys'\n}\n\nfunction isInvalidUnion(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidUnion> {\n  return issue.code === 'invalid_union'\n}\n\nfunction isInvalidKey(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidKey> {\n  return issue.code === 'invalid_key'\n}\n\n/**\n * Maps Zod issue codes to zodI18n message keys\n * Adapted for Zod v4's simpler issue code system\n */\nfunction getMessageKey(issue: $ZodRawIssue): MessageKeys {\n  if (isInvalidType(issue)) {\n    if (issue.input === undefined) {\n      return 'zodI18n.errors.required'\n    }\n    return 'zodI18n.errors.invalid_type'\n  }\n\n  if (isTooSmall(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_small.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isTooBig(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_big.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isInvalidFormat(issue)) {\n    // Map v4's format to v3-style validation keys\n    return `zodI18n.errors.invalid_string.${issue.format}` as MessageKeys\n  }\n\n  if (isNotMultipleOf(issue)) {\n    return 'zodI18n.errors.not_multiple_of'\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    return 'zodI18n.errors.unrecognized_keys'\n  }\n\n  if (isInvalidUnion(issue)) {\n    return 'zodI18n.errors.invalid_union'\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: Replaces invalid_enum_value, invalid_literal\n    return 'zodI18n.errors.invalid_enum_value'\n  }\n\n  // invalid_element, invalid_value, or unknown codes\n  return 'zodI18n.errors.custom.default'\n}\n\n/**\n * Extracts interpolation parameters from Zod issue\n * Uses proper type narrowing for v4\n */\nfunction getMessageParams(issue: $ZodRawIssue): Record<string, unknown> {\n  const params: Record<string, unknown> = {}\n\n  if (isInvalidType(issue)) {\n    params.expected = issue.expected\n    params.received = String(issue.input)\n    return params\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    params.keys = issue.keys.join(', ')\n    return params\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: For enums and records\n    // Since v4 doesn't have options field, we'll use generic message\n    return params\n  }\n\n  if (isInvalidFormat(issue)) {\n    params.validation = issue.format\n\n    // Check for specific string format issues with additional fields\n    if ('prefix' in issue) {\n      params.startsWith = (issue as { prefix?: string }).prefix\n    }\n    if ('suffix' in issue) {\n      params.endsWith = (issue as { suffix?: string }).suffix\n    }\n    if ('includes' in issue) {\n      params.includes = (issue as { includes?: string }).includes\n    }\n    if (issue.pattern) {\n      params.pattern = issue.pattern\n    }\n\n    return params\n  }\n\n  if (isTooSmall(issue)) {\n    params.minimum = issue.minimum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.minimum = new Date(Number(issue.minimum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isTooBig(issue)) {\n    params.maximum = issue.maximum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.maximum = new Date(Number(issue.maximum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isNotMultipleOf(issue)) {\n    params.multipleOf = issue.divisor\n    return params\n  }\n\n  return params\n}\n\n/**\n * Creates a Zod error map that uses i18n for translation\n * Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)\n */\nexport function createI18nErrorMap(getContext: () => ErrorMapContext | undefined): $ZodErrorMap {\n  return (issue: $ZodRawIssue): { message: string } => {\n    // Get message key and params for this issue\n    const messageKey = getMessageKey(issue)\n    const messageParams = getMessageParams(issue)\n\n    // Get translation context\n    const context = getContext()\n\n    if (!context) {\n      // Fallback: Use English messages directly\n      // This handles config validation at startup, tests, etc.\n      return { message: 'Invalid input' }\n    }\n\n    // Normal flow: Use context-aware i18n (respects user locale)\n    return {\n      message: context.t(messageKey, messageParams),\n    }\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { ErrorMapContext } from './validation.types'\nimport { createI18nErrorMap } from './validation.error-map'\n\n/**\n * AsyncLocalStorage for storing request-scoped ErrorMapContext\n * Allows error map to access I18nService without passing through function calls\n */\nexport const errorMapContextStorage = new AsyncLocalStorage<ErrorMapContext>()\n\n/**\n * Gets the current error map context from AsyncLocalStorage\n */\nfunction getErrorMapContext(): ErrorMapContext | undefined {\n  return errorMapContextStorage.getStore()\n}\n\n/**\n * Backend error map that accesses I18nService from AsyncLocalStorage\n * Must be initialized in router middleware after locale detection\n */\nexport const backendErrorMap = createI18nErrorMap(getErrorMapContext)\n\n/**\n * Runs a function within an error map context\n * Used by router middleware to provide I18nService to validation\n *\n * @example\n * ```typescript\n * router.use('*', async (c, next) => {\n *   const i18nService = c.get('i18nService')\n *   const locale = c.get('locale')\n *\n *   return runWithErrorMapContext(\n *     {\n *       t: (key, params) => i18nService.t(key, params),\n *       locale,\n *     },\n *     () => next()\n *   )\n * })\n * ```\n */\nexport function runWithErrorMapContext<T>(\n  context: ErrorMapContext,\n  fn: () => T\n): T {\n  return errorMapContextStorage.run(context, fn)\n}\n","import type { MessageKeys } from '../i18n.types'\nimport { errorMapContextStorage } from './validation.context'\n\n/**\n * Type-safe helper for creating custom Zod error messages with i18n support (Backend)\n *\n * Usage with .refine():\n * ```typescript\n * const schema = z.string().refine(\n *   (val) => val.length > 5,\n *   withI18n('validation.minLength', { min: 5 })\n * )\n * ```\n *\n * Usage with built-in validators:\n * ```typescript\n * const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))\n * const schema = z.string().email(withI18n('validation.email'))\n * ```\n *\n * Note: This is the backend version using AsyncLocalStorage.\n * For frontend, use withI18nFrontend from the frontend validation module\n *\n * @param key - Message key from shared i18n messages (type-safe via MessageKeys)\n * @param params - Optional interpolation parameters for the message\n * @returns Zod error configuration object with translated message\n */\nexport function withI18n(\n  key: MessageKeys,\n  params?: Record<string, unknown>\n): { error: () => string } {\n  return {\n    error: () => {\n      // Get i18n context from AsyncLocalStorage (backend)\n      // This is set by the router middleware before validation\n      const context = errorMapContextStorage.getStore()\n\n      // Translate using context if available, otherwise fallback to generic message\n      const message = context\n        ? context.t(key, params as Record<string, string | number> | undefined)\n        : 'Invalid input'\n\n      return message\n    },\n  }\n}\n","// Consolidated zod - single source from @hono/zod-openapi (superset of zod)\nexport { OpenAPIHono, z } from '@hono/zod-openapi'\nexport type * from 'zod'\nexport { ZodError } from 'zod'\n\n// OpenAPI utilities\nexport * from '@hono/zod-openapi'\nexport type { OpenAPIObject, PathItemObject } from 'openapi3-ts/oas30'\n\n// Helpers\nexport { withI18n } from './with-i18n'\n\n// Backend utilities\nexport { backendErrorMap, runWithErrorMapContext } from './validation.context'\n\n// Types\nexport type { ErrorMapContext, I18nErrorMetadata, LocaleProvider, ZodCustomIssue } from './validation.types'\n\n"],"mappings":"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"}

package/dist/websocket/index.d.mts

@@ -1,5 +1,5 @@
-import { Et as ControllerOptions, Nt as RouterEnv, Tt as RouterContext, s as ApplicationError, wt as ContextQueryResult } from "../index-D69rxo8H.mjs";
-import { t as Constructor } from "../types-Cu4jkeiH.mjs";
+import { Et as ControllerOptions, Nt as RouterEnv, Tt as RouterContext, s as ApplicationError, wt as ContextQueryResult } from "../index-BJWm863C.mjs";
+import { t as Constructor } from "../types-DahElfUw.mjs";
 import { Context } from "hono";
 import { WSContext, WSContext as WSContext$1, WSEvents, WSMessageReceive, WSReadyState, WSReadyState as WSReadyState$1 } from "hono/ws";
 

package/dist/websocket/index.mjs

@@ -1,6 +1,6 @@
 import "../errors-CtCi1wn6.mjs";
 import "../decorate-D5j-d9_z.mjs";
 import "../logger-BR1-s1Um.mjs";
-import "../router-context-BLn4PrRG.mjs";
-import { a as OnMessage, c as getWsOnMessageMethod, d as isGateway, i as OnError, l as WebSocketDuplicateEventHandlerError, n as WebSocketBodyNotAvailableError, o as getWsOnCloseMethod, r as OnClose, s as getWsOnErrorMethod, t as GatewayContext, u as Gateway } from "../gateway-context-90CQEQDR.mjs";
+import "../router-context-BEJe9HEB.mjs";
+import { a as OnMessage, c as getWsOnMessageMethod, d as isGateway, i as OnError, l as WebSocketDuplicateEventHandlerError, n as WebSocketBodyNotAvailableError, o as getWsOnCloseMethod, r as OnClose, s as getWsOnErrorMethod, t as GatewayContext, u as Gateway } from "../gateway-context-BkZ4UKaX.mjs";
 export { Gateway, GatewayContext, OnClose, OnError, OnMessage, WebSocketBodyNotAvailableError, WebSocketDuplicateEventHandlerError, getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, isGateway };

package/dist/workers/index.d.mts

@@ -1,4 +1,4 @@
-import { $t as Container, Ht as StratalEnv } from "../index-D69rxo8H.mjs";
+import { $t as Container, Ht as StratalEnv } from "../index-BJWm863C.mjs";
 import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
 
 //#region src/workers/run-in-scope.d.ts

package/dist/workers/index.mjs

@@ -1,22 +1,23 @@
 import "../errors-CtCi1wn6.mjs";
 import { l as DI_TOKENS } from "../decorate-D5j-d9_z.mjs";
 import "../logger-BR1-s1Um.mjs";
-import "../module-BH7t7BGG.mjs";
+import "../module-BgdxxzBe.mjs";
 import "../events-CXl-o1Ad.mjs";
-import "../command-DG_u5ob2.mjs";
-import "../is-command-MZDCH-0T.mjs";
-import "../is-seeder-BN9Ej1r7.mjs";
-import "../middleware-iRhNjsPH.mjs";
-import "../router-context-BLn4PrRG.mjs";
-import "../cron-manager-BRh86QCS.mjs";
-import "../validation-Dbt-snjx.mjs";
-import "../i18n.module-qNrpIVts.mjs";
-import "../guards-DMbsAxSX.mjs";
-import "../gateway-context-90CQEQDR.mjs";
-import "../quarry-registry-BPmKVjhG.mjs";
-import "../queue.module-BdXWUvIM.mjs";
-import "../seeder-DatfjJvU.mjs";
-import { t as Stratal } from "../stratal-Cm0Yy8v4.mjs";
+import "../colors-DJaRDXoS.mjs";
+import "../command-BvCOD6df.mjs";
+import "../is-command-BfCgWAcQ.mjs";
+import "../is-seeder-CebjZCDn.mjs";
+import "../middleware-C0Ebzswy.mjs";
+import "../router-context-BEJe9HEB.mjs";
+import "../cron-manager-DR7fiG6o.mjs";
+import "../validation-Bh875Lyg.mjs";
+import "../i18n.module-W8OJxg3d.mjs";
+import "../guards-DUk_Kzst.mjs";
+import "../gateway-context-BkZ4UKaX.mjs";
+import "../quarry-registry-DCwqVcRp.mjs";
+import "../queue.module-BZvmeAMj.mjs";
+import "../seeder-Cupi5jl-.mjs";
+import { t as Stratal } from "../stratal-CE0iTz4f.mjs";
 import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
 //#region src/workers/run-in-scope.ts
 /**

package/dist/workers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/workers/run-in-scope.ts","../../src/workers/stratal-durable-object.ts","../../src/workers/stratal-worker-entrypoint.ts","../../src/workers/stratal-workflow.ts"],"sourcesContent":["import type { Container } from '../di/container'\nimport { Stratal } from '../stratal'\n\n/**\n * Shared helper that creates a request-scoped DI container by accessing the\n * Stratal Application via the static singleton.\n *\n * Works with Durable Objects, Workflows, and WorkerEntrypoints.\n */\nexport async function runInScope<T>(\n  callback: (container: Container) => T | Promise<T>\n): Promise<T> {\n  const app = await Stratal.resolveApplication()\n  const mockCtx = app.createMockRouterContext('en')\n  return app.container.runInRequestScope(mockCtx, callback)\n}\n","import { DurableObject } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Durable Objects with full DI access.\n *\n * Extends Cloudflare's `DurableObject` and provides a `runInScope()` helper\n * that creates a request-scoped container with `DurableObjectState` and\n * `DurableObjectId` tokens registered.\n *\n * @example\n * ```typescript\n * import { StratalDurableObject } from 'stratal/workers'\n *\n * export class Counter extends StratalDurableObject {\n *   async increment() {\n *     return this.runInScope(async (container) => {\n *       const svc = container.resolve(CounterService)\n *       return svc.increment()\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalDurableObject<\n  Env extends StratalEnv = StratalEnv\n> extends DurableObject<Env> {\n  protected async runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(async (requestContainer) => {\n      requestContainer.registerValue(DI_TOKENS.DurableObjectState, this.ctx)\n      requestContainer.registerValue(DI_TOKENS.DurableObjectId, this.ctx.id)\n      return callback(requestContainer)\n    })\n  }\n}\n","import { WorkerEntrypoint } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Cloudflare WorkerEntrypoints (Service Bindings / RPC) with full DI access.\n *\n * Extends Cloudflare's `WorkerEntrypoint` and provides a `runInScope()` helper\n * that creates a request-scoped DI container.\n *\n * @example\n * ```typescript\n * import { StratalWorkerEntrypoint } from 'stratal/workers'\n *\n * export class AuthRpc extends StratalWorkerEntrypoint {\n *   async verifyToken(token: string) {\n *     return this.runInScope(async (container) => {\n *       const auth = container.resolve(AuthService)\n *       return auth.verify(token)\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalWorkerEntrypoint<\n  Env extends StratalEnv = StratalEnv\n> extends WorkerEntrypoint<Env> {\n  protected runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(callback)\n  }\n}\n","import { WorkflowEntrypoint } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Cloudflare Workflows with full DI access.\n *\n * Extends Cloudflare's `WorkflowEntrypoint` and provides a `runInScope()` helper\n * that creates a request-scoped DI container.\n *\n * @example\n * ```typescript\n * import { StratalWorkflow } from 'stratal/workers'\n *\n * export class MyWorkflow extends StratalWorkflow<Env, { userId: string }> {\n *   async run(event: WorkflowEvent<{ userId: string }>, step: WorkflowStep) {\n *     await this.runInScope(async (container) => {\n *       const svc = container.resolve(UserService)\n *       await svc.process(event.payload.userId)\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalWorkflow<\n  Env extends StratalEnv = StratalEnv,\n  Params = unknown\n> extends WorkflowEntrypoint<Env, Params> {\n  protected runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(callback)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,eAAsB,WACpB,UACY;CACZ,MAAM,MAAM,MAAM,QAAQ,oBAAoB;CAC9C,MAAM,UAAU,IAAI,wBAAwB,KAAK;AACjD,QAAO,IAAI,UAAU,kBAAkB,SAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACa3D,IAAsB,uBAAtB,cAEU,cAAmB;CAC3B,MAAgB,WACd,UACY;AACZ,SAAO,WAAW,OAAO,qBAAqB;AAC5C,oBAAiB,cAAc,UAAU,oBAAoB,KAAK,IAAI;AACtE,oBAAiB,cAAc,UAAU,iBAAiB,KAAK,IAAI,GAAG;AACtE,UAAO,SAAS,iBAAiB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;ACZN,IAAsB,0BAAtB,cAEU,iBAAsB;CAC9B,WACE,UACY;AACZ,SAAO,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACN/B,IAAsB,kBAAtB,cAGU,mBAAgC;CACxC,WACE,UACY;AACZ,SAAO,WAAW,SAAS"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/workers/run-in-scope.ts","../../src/workers/stratal-durable-object.ts","../../src/workers/stratal-worker-entrypoint.ts","../../src/workers/stratal-workflow.ts"],"sourcesContent":["import type { Container } from '../di/container'\nimport { Stratal } from '../stratal'\n\n/**\n * Shared helper that creates a request-scoped DI container by accessing the\n * Stratal Application via the static singleton.\n *\n * Works with Durable Objects, Workflows, and WorkerEntrypoints.\n */\nexport async function runInScope<T>(\n  callback: (container: Container) => T | Promise<T>\n): Promise<T> {\n  const app = await Stratal.resolveApplication()\n  const mockCtx = app.createMockRouterContext('en')\n  return app.container.runInRequestScope(mockCtx, callback)\n}\n","import { DurableObject } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Durable Objects with full DI access.\n *\n * Extends Cloudflare's `DurableObject` and provides a `runInScope()` helper\n * that creates a request-scoped container with `DurableObjectState` and\n * `DurableObjectId` tokens registered.\n *\n * @example\n * ```typescript\n * import { StratalDurableObject } from 'stratal/workers'\n *\n * export class Counter extends StratalDurableObject {\n *   async increment() {\n *     return this.runInScope(async (container) => {\n *       const svc = container.resolve(CounterService)\n *       return svc.increment()\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalDurableObject<\n  Env extends StratalEnv = StratalEnv\n> extends DurableObject<Env> {\n  protected async runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(async (requestContainer) => {\n      requestContainer.registerValue(DI_TOKENS.DurableObjectState, this.ctx)\n      requestContainer.registerValue(DI_TOKENS.DurableObjectId, this.ctx.id)\n      return callback(requestContainer)\n    })\n  }\n}\n","import { WorkerEntrypoint } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Cloudflare WorkerEntrypoints (Service Bindings / RPC) with full DI access.\n *\n * Extends Cloudflare's `WorkerEntrypoint` and provides a `runInScope()` helper\n * that creates a request-scoped DI container.\n *\n * @example\n * ```typescript\n * import { StratalWorkerEntrypoint } from 'stratal/workers'\n *\n * export class AuthRpc extends StratalWorkerEntrypoint {\n *   async verifyToken(token: string) {\n *     return this.runInScope(async (container) => {\n *       const auth = container.resolve(AuthService)\n *       return auth.verify(token)\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalWorkerEntrypoint<\n  Env extends StratalEnv = StratalEnv\n> extends WorkerEntrypoint<Env> {\n  protected runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(callback)\n  }\n}\n","import { WorkflowEntrypoint } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Cloudflare Workflows with full DI access.\n *\n * Extends Cloudflare's `WorkflowEntrypoint` and provides a `runInScope()` helper\n * that creates a request-scoped DI container.\n *\n * @example\n * ```typescript\n * import { StratalWorkflow } from 'stratal/workers'\n *\n * export class MyWorkflow extends StratalWorkflow<Env, { userId: string }> {\n *   async run(event: WorkflowEvent<{ userId: string }>, step: WorkflowStep) {\n *     await this.runInScope(async (container) => {\n *       const svc = container.resolve(UserService)\n *       await svc.process(event.payload.userId)\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalWorkflow<\n  Env extends StratalEnv = StratalEnv,\n  Params = unknown\n> extends WorkflowEntrypoint<Env, Params> {\n  protected runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(callback)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,eAAsB,WACpB,UACY;CACZ,MAAM,MAAM,MAAM,QAAQ,oBAAoB;CAC9C,MAAM,UAAU,IAAI,wBAAwB,KAAK;AACjD,QAAO,IAAI,UAAU,kBAAkB,SAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACa3D,IAAsB,uBAAtB,cAEU,cAAmB;CAC3B,MAAgB,WACd,UACY;AACZ,SAAO,WAAW,OAAO,qBAAqB;AAC5C,oBAAiB,cAAc,UAAU,oBAAoB,KAAK,IAAI;AACtE,oBAAiB,cAAc,UAAU,iBAAiB,KAAK,IAAI,GAAG;AACtE,UAAO,SAAS,iBAAiB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;ACZN,IAAsB,0BAAtB,cAEU,iBAAsB;CAC9B,WACE,UACY;AACZ,SAAO,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACN/B,IAAsB,kBAAtB,cAGU,mBAAgC;CACxC,WACE,UACY;AACZ,SAAO,WAAW,SAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratal",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "A modular Cloudflare Workers framework with dependency injection, queue-based events, and type-safe configuration",
   "type": "module",
   "license": "MIT",
@@ -159,7 +159,6 @@
     "@xmldom/xmldom": "^0.8.11",
     "clipanion": "^4.0.0-rc.4",
     "hono": "^4.12.8",
-    "reflect-metadata": "^0.2.2",
     "tsyringe": "^4.10.0",
     "zod": "^4.3.6"
   },
@@ -168,10 +167,10 @@
     "@aws-sdk/lib-storage": "^3.700.0",
     "@aws-sdk/s3-request-presigner": "^3.700.0",
     "@react-email/components": "^1.0.0",
-    "@tus/server": "^2.0.0",
     "nodemailer": ">=7.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "reflect-metadata": "^0.2.2",
     "resend": "^6.0.0"
   },
   "peerDependenciesMeta": {
@@ -187,9 +186,6 @@
     "@react-email/components": {
       "optional": true
     },
-    "@tus/server": {
-      "optional": true
-    },
     "nodemailer": {
       "optional": true
     },
@@ -211,7 +207,6 @@
     "@cloudflare/workers-types": "4.20260317.1",
     "@react-email/components": "^1.0.10",
     "@stratal/testing": "workspace:*",
-    "@tus/server": "^2.3.0",
     "@types/node": "^25.5.0",
     "@types/nodemailer": "^7.0.11",
     "@types/react": "^19.2.14",
@@ -222,6 +217,7 @@
     "nodemailer": "^8.0.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
+    "reflect-metadata": "^0.2.2",
     "resend": "^6.9.4",
     "tsdown": "^0.21.4",
     "typescript": "^5.9.3",