stratal 0.0.21 → 0.0.22

package/dist/quarry-registry-BwY2hOxm.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"quarry-registry-BwY2hOxm.mjs","names":[],"sources":["../src/quarry/commands/api.command.ts","../src/quarry/commands/event-list.command.ts","../src/quarry/errors/command-not-found.error.ts","../src/quarry/commands/help.command.ts","../src/quarry/commands/mcp-serve.command.ts","../src/quarry/commands/mcp-tools.command.ts","../src/quarry/commands/queue-list.command.ts","../src/quarry/commands/route-list.command.ts","../src/quarry/commands/schedule-list.command.ts","../src/quarry/command-internals.ts","../src/quarry/signature-parser.ts","../src/quarry/quarry-registry.ts"],"sourcesContent":["import { inject } from 'tsyringe'\nimport type { Application } from '../../application'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { Command } from '../command'\nimport { bold, cyan, green, red, yellow } from '../colors'\n\nexport class ApiCommand extends Command {\n  static command = 'api {route?} {--method= : HTTP method} {--data= : JSON request body} {--header=* : Headers (Key:Value)} {--query=* : Query params (key=value)}'\n  static description = 'Call an API route directly'\n  static aliases = ['api:call']\n\n  constructor(@inject(DI_TOKENS.Application) private app: Application) {\n    super()\n  }\n\n  async handle(): Promise<number | undefined> {\n    const route = this.string('route')\n\n    if (!route) {\n      return (await this.call('route:list')).exitCode\n    }\n\n    return this.callRoute(route)\n  }\n\n  private async callRoute(route: string): Promise<number> {\n    const method = (this.string('method') || 'GET').toUpperCase()\n    const data = this.string('data')\n    const headerArgs = this.array('header')\n    const queryArgs = this.array('query')\n\n    const headers: Record<string, string> = {}\n    if (data) {\n      headers['Content-Type'] = 'application/json'\n    }\n    for (const h of headerArgs) {\n      const colonIdx = h.indexOf(':')\n      if (colonIdx > 0) {\n        headers[h.slice(0, colonIdx).trim()] = h.slice(colonIdx + 1).trim()\n      }\n    }\n\n    // Build query string\n    let url = route\n    if (queryArgs.length > 0) {\n      const parts = queryArgs.map((q) => {\n        const eqIdx = q.indexOf('=')\n        if (eqIdx > 0) {\n          return `${encodeURIComponent(q.slice(0, eqIdx))}=${encodeURIComponent(q.slice(eqIdx + 1))}`\n        }\n        return encodeURIComponent(q)\n      })\n      url += `?${parts.join('&')}`\n    }\n\n    const request = new Request(`http://localhost${url}`, {\n      method,\n      headers,\n      body: data || undefined,\n    })\n\n    const hono = await this.app.ensureHono()\n    const response = await hono.fetch(request, this.app.env)\n    const body = await response.text()\n\n    // Color-coded status\n    const statusText = `${response.status} ${response.statusText}`\n    let coloredStatus: string\n    if (response.status >= 200 && response.status < 300) {\n      coloredStatus = green(bold(statusText))\n    } else if (response.status >= 300 && response.status < 400) {\n      coloredStatus = yellow(bold(statusText))\n    } else {\n      coloredStatus = red(bold(statusText))\n    }\n\n    this.line(`${cyan(method)} ${route} ${coloredStatus}`)\n    this.newLine()\n\n    // Response headers\n    const headerLines: string[] = []\n    response.headers.forEach((value, key) => {\n      headerLines.push(`  ${key}: ${value}`)\n    })\n    if (headerLines.length > 0) {\n      this.line(bold('Headers:'))\n      for (const hl of headerLines) {\n        this.line(hl)\n      }\n      this.newLine()\n    }\n\n    // Body\n    if (body) {\n      this.line(bold('Body:'))\n      try {\n        this.line(JSON.stringify(JSON.parse(body), null, 2))\n      } catch {\n        this.line(body)\n      }\n    }\n\n    return response.status >= 400 ? 1 : 0\n  }\n}\n","import { inject } from 'tsyringe'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { getListenerHandlers } from '../../events'\nimport type { ModuleRegistry } from '../../module/module-registry'\nimport { Command } from '../command'\n\nexport class EventListCommand extends Command {\n  static command = 'event:list'\n  static description = 'List all registered event listeners'\n\n  constructor(@inject(DI_TOKENS.ModuleRegistry) private modules: ModuleRegistry) {\n    super()\n  }\n\n  handle(): number | undefined {\n    const listeners = this.modules.getAllListeners()\n\n    if (listeners.length === 0) {\n      this.info('No event listeners found')\n      return 0\n    }\n\n    const rows: string[][] = []\n\n    for (const ListenerClass of listeners) {\n      const handlers = getListenerHandlers(ListenerClass)\n      for (const { methodName, event, options } of handlers) {\n        rows.push([\n          event,\n          ListenerClass.name,\n          methodName,\n          String(options?.priority ?? 0),\n          options?.blocking ? 'Yes' : 'No',\n        ])\n      }\n    }\n\n    if (rows.length === 0) {\n      this.info('No event handlers found')\n      return 0\n    }\n\n    this.table(['Event', 'Listener', 'Method', 'Priority', 'Blocking'], rows)\n\n    return undefined\n  }\n}\n","/**\n * Thrown when a command is not found in the Quarry registry.\n */\nexport class CommandNotFoundError extends Error {\n  constructor(name: string) {\n    super(`Command \"${name}\" is not registered.`)\n    this.name = 'CommandNotFoundError'\n  }\n}\n","import { inject } from 'tsyringe'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { Command } from '../command'\nimport { CommandNotFoundError } from '../errors/command-not-found.error'\nimport type { QuarryRegistry } from '../quarry-registry'\n\nexport class HelpCommand extends Command {\n  static command = 'help {command?}'\n  static description = 'Show help for a command or list all commands'\n  static aliases = ['list']\n\n  constructor(@inject(DI_TOKENS.Quarry) private quarryRegistry: QuarryRegistry) {\n    super()\n  }\n\n  async handle(): Promise<number | undefined> {\n    const commandName = this.string('command')\n\n    if (!commandName) {\n      const listing = await this.quarryRegistry.listUsage()\n      this.line(listing)\n      return 0\n    }\n\n    try {\n      const usage = await this.quarryRegistry.usage(commandName)\n      this.line(usage)\n      return 0\n    } catch (error) {\n      if (error instanceof CommandNotFoundError) {\n        this.fail(`Unknown command: ${commandName}`)\n        return 1\n      }\n      throw error\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport { z } from 'zod'\nimport type { Application } from '../../application'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { OPENAPI_TOKENS } from '../../openapi/openapi.tokens'\nimport type { Dispatcher } from '../../openapi/services/openapi-tools.service'\nimport { OpenApiToolsService } from '../../openapi/services/openapi-tools.service'\nimport type { OpenAPIService } from '../../openapi/services/openapi.service'\nimport type { IOpenAPIConfigService } from '../../openapi/types'\nimport { Command } from '../command'\n\nexport class McpServeCommand extends Command {\n  static command = 'mcp:serve {--url= : Base URL for external dispatch} {--header=* : Headers (Key:Value)} {--tag=* : Only expose routes with these OpenAPI tags} {--path= : Only expose routes matching this path prefix}'\n  static description = 'Start an MCP stdio server exposing API routes as tools'\n\n  constructor(\n    @inject(DI_TOKENS.Application) private app: Application,\n    @inject(OPENAPI_TOKENS.OpenAPIService) private openAPIService: OpenAPIService,\n  ) {\n    super()\n  }\n\n  async handle(): Promise<number | undefined> {\n    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js')\n    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js')\n\n    const baseUrl = this.string('url')\n    const headerArgs = this.array('header')\n    const tags = this.array('tag')\n    const pathPrefix = this.string('path')\n\n    const headers: Record<string, string> = {}\n    for (const h of headerArgs) {\n      const colonIdx = h.indexOf(':')\n      if (colonIdx > 0) {\n        headers[h.slice(0, colonIdx).trim()] = h.slice(colonIdx + 1).trim()\n      }\n    }\n\n    const hono = await this.app.ensureHono()\n    const spec = this.openAPIService.getSpec(hono, this.app.container)\n\n    const dispatcher: Dispatcher = baseUrl\n      ? async (method, url, opts) => {\n        const fullUrl = `${baseUrl}${url}`\n        try {\n          return await fetch(fullUrl, {\n            method,\n            headers: {\n              'Content-Type': 'application/json',\n              ...headers,\n              ...opts?.headers,\n            },\n            body: opts?.body !== undefined ? JSON.stringify(opts.body) : undefined,\n          })\n        } catch (error) {\n          throw new Error(`MCP dispatch failed: ${method} ${fullUrl} — ${error instanceof Error ? error.message : String(error)}`, { cause: error })\n        }\n      }\n      : async (method, url, opts) => {\n        const request = new Request(`http://localhost${url}`, {\n          method,\n          headers: {\n            'Content-Type': 'application/json',\n            ...headers,\n            ...opts?.headers,\n          },\n          body: opts?.body !== undefined ? JSON.stringify(opts.body) : undefined,\n        })\n        try {\n          return await hono.fetch(request, this.app.env)\n        } catch (error) {\n          throw new Error(`MCP dispatch failed: ${method} ${url} — ${error instanceof Error ? error.message : String(error)}`, { cause: error })\n        }\n      }\n\n    const service = new OpenApiToolsService(spec, { dispatcher })\n    const filter = {\n      tags: tags.length > 0 ? tags : undefined,\n      pathPrefix: pathPrefix || undefined,\n    }\n    const tools = service.getTools(filter)\n\n    const configService = this.app.container.resolve<IOpenAPIConfigService>(OPENAPI_TOKENS.ConfigService)\n    const config = configService.getEffectiveConfig()\n\n    const server = new McpServer({\n      name: config.info.title,\n      version: config.info.version,\n    })\n\n    // Register each tool\n    for (const tool of tools) {\n      const inputSchema = z.fromJSONSchema(tool.inputSchema)\n      server.registerTool(tool.name, { description: tool.description, inputSchema }, async (args) => {\n        const result = await service.executeTool(tool.name, args as Record<string, unknown>)\n        return {\n          content: [{ type: 'text' as const, text: `Status: ${result.status}\\n\\n${result.body}` }],\n        }\n      })\n    }\n\n    // Expose OpenAPI spec as a resource\n    server.registerResource(\n      'openapi-spec',\n      'openapi://spec',\n      { description: 'Full OpenAPI specification', mimeType: 'application/json' },\n      () => ({\n        contents: [{\n          uri: 'openapi://spec',\n          mimeType: 'application/json',\n          text: JSON.stringify(spec, null, 2),\n        }],\n      }),\n    )\n\n    const transport = new StdioServerTransport()\n    const closed = new Promise<void>((resolve) => { transport.onclose = resolve })\n    await server.connect(transport)\n\n    // Write info to stderr (stdout is reserved for MCP JSON-RPC)\n    process.stderr.write(`MCP server started with ${tools.length} tool(s)\\n`)\n\n    // Keep process alive until client disconnects\n    await closed\n\n    return 0\n  }\n}\n","import { inject } from 'tsyringe'\nimport type { Application } from '../../application'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { OPENAPI_TOKENS } from '../../openapi/openapi.tokens'\nimport type { OpenAPIService } from '../../openapi/services/openapi.service'\nimport { OpenApiToolsService } from '../../openapi/services/openapi-tools.service'\nimport { Command } from '../command'\n\nexport class McpToolsCommand extends Command {\n  static command = 'mcp:tools {--tag=* : Filter by OpenAPI tags} {--path= : Filter by path prefix}'\n  static description = 'List API routes that would be exposed as MCP tools'\n\n  constructor(\n    @inject(DI_TOKENS.Application) private app: Application,\n    @inject(OPENAPI_TOKENS.OpenAPIService) private openAPIService: OpenAPIService,\n  ) {\n    super()\n  }\n\n  async handle(): Promise<number | undefined> {\n    const tags = this.array('tag')\n    const pathPrefix = this.string('path')\n\n    const hono = await this.app.ensureHono()\n    const spec = this.openAPIService.getSpec(hono, this.app.container)\n\n    const service = new OpenApiToolsService(spec)\n    const filter = {\n      tags: tags.length > 0 ? tags : undefined,\n      pathPrefix: pathPrefix || undefined,\n    }\n    const tools = service.getTools(filter)\n\n    if (tools.length === 0) {\n      this.info('No tools found')\n      return 0\n    }\n\n    this.table(\n      ['Name', 'Method', 'Path', 'Description'],\n      tools.map((t) => [t.name, t.method, t.path, t.description]),\n    )\n\n    return 0\n  }\n}\n","import { inject } from 'tsyringe'\nimport { DI_TOKENS } from '../../di/tokens'\nimport type { ConsumerRegistry } from '../../queue/consumer-registry'\nimport { Command } from '../command'\n\nexport class QueueListCommand extends Command {\n  static command = 'queue:list'\n  static description = 'List all registered queue consumers'\n\n  constructor(@inject(DI_TOKENS.ConsumerRegistry) private consumers: ConsumerRegistry) {\n    super()\n  }\n\n  handle(): number | undefined {\n    const consumers = this.consumers.getAllConsumers()\n\n    if (consumers.length === 0) {\n      this.info('No queue consumers found')\n      return 0\n    }\n\n    this.table(\n      ['Consumer', 'Message Types'],\n      consumers.map(c => [c.constructor.name, c.messageTypes.join(', ')]),\n    )\n\n    return undefined\n  }\n}\n","import { inject } from 'tsyringe'\nimport type { RouteRegistry, RegisteredRoute } from '../../router/route-registry'\nimport { ROUTER_TOKENS } from '../../router/router.tokens'\nimport { Command } from '../command'\n\n/**\n * List all registered routes from RouteRegistry.\n *\n * By default, hidden routes (hideFromDocs) are excluded.\n * Use `--hidden` to include them.\n *\n * @example\n * ```bash\n * quarry route:list\n * quarry route:list --method=GET\n * quarry route:list --path=/users\n * quarry route:list --name=users\n * quarry route:list --hidden\n * ```\n */\nexport class RouteListCommand extends Command {\n  static command = 'route:list {--method= : Filter by HTTP method} {--path= : Filter by path substring} {--name= : Filter by route name} {--hidden : Include hidden routes}'\n  static description = 'List all registered routes'\n\n  constructor(@inject(ROUTER_TOKENS.RouteRegistry) private registry: RouteRegistry) {\n    super()\n  }\n\n  handle(): number | undefined {\n    const methodFilter = this.string('method').toUpperCase()\n    const pathFilter = this.string('path')\n    const nameFilter = this.string('name')\n    const showHidden = this.boolean('hidden')\n\n    let routes = this.registry.all()\n\n    // Filter hidden routes (default: exclude)\n    if (!showHidden) {\n      routes = routes.filter(r => !r.hidden)\n    }\n\n    if (methodFilter) {\n      routes = routes.filter(r => r.method.toUpperCase() === methodFilter)\n    }\n\n    if (pathFilter) {\n      routes = routes.filter(r => r.path.includes(pathFilter))\n    }\n\n    if (nameFilter) {\n      routes = routes.filter(r => r.name?.includes(nameFilter))\n    }\n\n    if (routes.length === 0) {\n      this.info('No routes found')\n      return 0\n    }\n\n    this.table(\n      ['Method', 'Path', 'Name', 'Handler', 'Domain'],\n      routes.map(r => this.formatRow(r)),\n    )\n\n    return undefined\n  }\n\n  private formatRow(route: RegisteredRoute): string[] {\n    return [\n      route.method.toUpperCase(),\n      route.path,\n      route.name ?? '-',\n      `${route.controller}.${route.action}`,\n      route.domain ?? '-',\n    ]\n  }\n}\n","import { inject } from 'tsyringe'\nimport { DI_TOKENS } from '../../di/tokens'\nimport type { CronManager } from '../../cron/cron-manager'\nimport { Command } from '../command'\n\nexport class ScheduleListCommand extends Command {\n  static command = 'schedule:list'\n  static description = 'List all registered cron jobs'\n\n  constructor(@inject(DI_TOKENS.Cron) private cron: CronManager) {\n    super()\n  }\n\n  handle(): number | undefined {\n    const schedules = this.cron.getAllSchedules()\n\n    if (schedules.length === 0) {\n      this.info('No cron jobs found')\n      return 0\n    }\n\n    const rows: string[][] = []\n\n    for (const schedule of schedules) {\n      const jobs = this.cron.getJobsForSchedule(schedule)\n      for (const { jobClass } of jobs) {\n        rows.push([schedule, jobClass.name])\n      }\n    }\n\n    this.table(['Schedule', 'Job'], rows)\n\n    return undefined\n  }\n}\n","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 'tsyringe'\nimport type { Container } from '../di/container'\nimport { Transient } 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@Transient(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 a fresh instance per invocation to avoid shared mutable state\n      command = this.container.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"],"mappings":"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"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue.module-BhCjZp6H.mjs","names":[],"sources":["../src/queue/consumer-registry.ts","../src/queue/queue-sender.ts","../src/queue/queue.tokens.ts","../src/queue/queue-registry.ts","../src/queue/errors/queue-binding-not-found.error.ts","../src/queue/errors/queue-provider-not-supported.error.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 { Transient } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { IQueueConsumer } from './queue-consumer'\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@Transient(DI_TOKENS.ConsumerRegistry)\nexport class ConsumerRegistry {\n  /** Map from message type to consumers handling that type */\n  private consumersByType = new Map<string, IQueueConsumer[]>()\n\n  /** Set of all registered consumers (for iteration) */\n  private allConsumers = new Set<IQueueConsumer>()\n\n  /**\n   * Register a queue consumer\n   *\n   * Indexes the consumer by each of its declared message types.\n   *\n   * @param consumer - Queue consumer to register\n   */\n  register(consumer: IQueueConsumer): void {\n    if (this.allConsumers.has(consumer)) {\n      return // Already registered\n    }\n\n    this.allConsumers.add(consumer)\n\n    for (const messageType of consumer.messageTypes) {\n      const existing = this.consumersByType.get(messageType) ?? []\n      existing.push(consumer)\n      this.consumersByType.set(messageType, existing)\n    }\n  }\n\n  /**\n   * Get all consumers that can handle a specific message type\n   *\n   * Returns consumers that either:\n   * - Explicitly declare the message type\n   * - Use '*' wildcard to handle all types\n   *\n   * @param messageType - The message type to find consumers for\n   * @returns Array of consumers that can handle this message type\n   */\n  getConsumers(messageType: string): IQueueConsumer[] {\n    const exactMatch = this.consumersByType.get(messageType) ?? []\n    const wildcardMatch = this.consumersByType.get('*') ?? []\n\n    // Combine and dedupe\n    const combined = new Set([...exactMatch, ...wildcardMatch])\n    return Array.from(combined)\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.getConsumers(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.consumersByType.keys())\n  }\n\n  /**\n   * Get all registered consumers\n   *\n   * @returns Array of all registered consumers\n   */\n  getAllConsumers(): IQueueConsumer[] {\n    return Array.from(this.allConsumers)\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 name.\n * Created by QueueRegistry for each registered queue.\n *\n * Automatically enriches messages with:\n * - `id`: UUID generated via crypto.randomUUID()\n * - `timestamp`: Current time in milliseconds\n * - `metadata.locale`: Current locale from I18n context\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 queueName: 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/timestamp)\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    const fullMessage: QueueMessage<T> = {\n      id: crypto.randomUUID(),\n      timestamp: Date.now(),\n      ...message,\n      metadata: Object.keys(metadata).length > 0 ? metadata : undefined\n    }\n\n    await this.provider.send(this.queueName, fullMessage)\n  }\n}\n","export const QUEUE_TOKENS = {\n  QueueProviderFactory: Symbol.for('stratal:queue:provider:factory'),\n  QueueRegistry: Symbol.for('stratal:queue:registry'),\n  QueueModuleOptions: Symbol.for('stratal:queue:options'),\n} as const\n\nexport type QueueToken = (typeof QUEUE_TOKENS)[keyof typeof QUEUE_TOKENS]\n","import { inject } from 'tsyringe'\nimport { Transient } 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 queue name within the request scope.\n *\n * This service is used internally by QueueModule.registerQueue() to provide\n * IQueueSender instances for each registered queue.\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@Transient(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 queue name.\n   *\n   * Senders are cached per queue name within the request scope.\n   *\n   * @param queueName - The queue name to get a sender for\n   * @returns QueueSender bound to the specified queue\n   */\n  getQueue(queueName: string): IQueueSender {\n    let sender = this.senders.get(queueName)\n\n    if (!sender) {\n      sender = new QueueSender(queueName, this.provider, this.i18n)\n      this.senders.set(queueName, sender)\n    }\n\n    return sender\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * QueueBindingNotFoundError\n *\n * Thrown when attempting to access a Cloudflare Queue binding that hasn't been configured.\n * This typically indicates that the queue binding is missing from wrangler.jsonc\n * or the environment variables are not properly set.\n */\nexport class QueueBindingNotFoundError extends ApplicationError {\n  constructor(queueName: string, bindingName: string) {\n    super(\n      'errors.queueBindingNotFound',\n      ERROR_CODES.SYSTEM.QUEUE_BINDING_NOT_FOUND,\n      { queueName, bindingName }\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * QueueProviderNotSupportedError\n *\n * Thrown when attempting to use a queue provider that is not supported.\n * Valid providers are: 'cloudflare', 'sync'\n *\n * This typically indicates an invalid QUEUE_PROVIDER environment variable.\n */\nexport class QueueProviderNotSupportedError extends ApplicationError {\n  constructor(provider: string) {\n    super(\n      'errors.queueProviderNotSupported',\n      ERROR_CODES.SYSTEM.QUEUE_PROVIDER_NOT_SUPPORTED,\n      { provider }\n    )\n  }\n}\n","import { inject } from 'tsyringe'\nimport { type StratalEnv } from '../../env'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { QueueBindingNotFoundError } from '../errors'\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 bindings from the environment.\n * Used in production environments where Cloudflare Workers handle queue processing.\n *\n * **Binding Resolution:**\n * Queue names are converted to binding names:\n * - `notifications-queue` → `NOTIFICATIONS_QUEUE`\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 queueName - Queue name (e.g., 'notifications-queue')\n   * @param message - Complete message with id, timestamp, and payload\n   * @throws {QueueBindingNotFoundError} If queue binding is not configured\n   */\n  async send<T>(queueName: string, message: QueueMessage<T>): Promise<void> {\n    const queue = this.getQueue(queueName)\n    await queue.send(message)\n  }\n\n  /**\n   * Resolve queue binding from Cloudflare environment\n   *\n   * Converts kebab-case queue name to UPPER_SNAKE_CASE binding name.\n   *\n   * @param queueName - Queue name (e.g., 'notifications-queue')\n   * @returns Cloudflare Queue binding\n   * @throws {QueueBindingNotFoundError} If binding not found in env\n   */\n  private getQueue(queueName: string): Queue {\n    const bindingName = queueName.toUpperCase().replace(/-/g, '_')\n    const queue = (this.env as unknown as Record<string, unknown>)[bindingName] as Queue | undefined\n\n    if (!queue) {\n      throw new QueueBindingNotFoundError(queueName, bindingName)\n    }\n\n    return queue\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { type ConsumerRegistry } from '../consumer-registry'\nimport type { 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 * @example Testing with sync provider\n * ```typescript\n * const provider = new SyncQueueProvider(registry)\n * await provider.send('notifications-queue', {\n *   id: '123',\n *   timestamp: Date.now(),\n *   type: 'email.send',\n *   payload: { to: 'test@example.com' }\n * })\n * // Consumer's handle() is called immediately!\n * ```\n */\n@Transient()\nexport class SyncQueueProvider implements IQueueProvider {\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry\n  ) {}\n\n  /**\n   * Process a message synchronously\n   *\n   * Finds all matching consumers by message type and calls their handle() method.\n   * If any consumer throws, onError() is called and the error is re-thrown.\n   *\n   * @param _queueName - Queue name (not used for routing, consumers match by message type)\n   * @param message - Complete message with id, timestamp, and payload\n   * @throws Re-throws any error from consumer.handle() after calling onError()\n   */\n  async send<T>(_queueName: string, message: QueueMessage<T>): Promise<void> {\n    // Consumers are matched by message type, not queue name\n    const consumers = this.registry.getConsumers(message.type)\n\n    // Process synchronously - call each matching consumer\n    for (const consumer of consumers) {\n      try {\n        await consumer.handle(message)\n      } catch (error) {\n        const errorInstance = error instanceof Error\n          ? error\n          : 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 'tsyringe'\nimport { type StratalEnv } from '../../env'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { type ConsumerRegistry } from '../consumer-registry'\nimport { QueueProviderNotSupportedError } from '../errors'\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(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 {QueueProviderNotSupportedError} 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)\n\n      default:\n        throw new QueueProviderNotSupportedError(providerType)\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 queues (queue name IS the injection token)\n * QueueModule.registerQueue('notifications-queue')\n * QueueModule.registerQueue('batch-notifications-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 { DI_TOKENS } from '../di/tokens'\nimport { Scope } from '../di/types'\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule, InjectionToken } from '../module/types'\nimport { ConsumerRegistry } from './consumer-registry'\nimport type { QueueName } from './queue-name'\nimport { QueueRegistry } from './queue-registry'\nimport type { IQueueSender } from './queue-sender.interface'\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@Module({\n  providers: [\n    { provide: DI_TOKENS.ConsumerRegistry, useClass: ConsumerRegistry, scope: Scope.Singleton },\n    { provide: QUEUE_TOKENS.QueueProviderFactory, useClass: QueueProviderFactory, scope: Scope.Singleton },\n    { provide: QUEUE_TOKENS.QueueRegistry, useClass: QueueRegistry },\n  ],\n})\nexport class QueueModule {\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 for injection.\n   *\n   * The queue name serves as both the identifier and the DI injection token.\n   * Queue names are typed via module augmentation of QueueNames interface.\n   *\n   * @param name - Queue name (typed with autocomplete if QueueNames is augmented)\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 queue name\n   * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}\n   * ```\n   */\n  static registerQueue(name: QueueName): DynamicModule {\n    return {\n      module: QueueModule,\n      providers: [\n        {\n          provide: name as InjectionToken<IQueueSender>,\n          useFactory: (registry: QueueRegistry) => registry.getQueue(name),\n          inject: [QUEUE_TOKENS.QueueRegistry],\n        },\n      ],\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"r2-storage.provider-DuonKeYm.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 { R2PresignedUrlSecretMissingError, StorageResponseBodyMissingError } from '../errors'\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 StorageResponseBodyMissingError(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 R2PresignedUrlSecretMissingError()\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/rate-limit.decorator-6qzNcSOt.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limit.decorator-6qzNcSOt.mjs","names":[],"sources":["../src/rate-limiter/decorators/rate-limit.decorator.ts"],"sourcesContent":["import { ROUTE_METADATA_KEYS } from '../../router/constants'\n\nconst KEY = ROUTE_METADATA_KEYS.RATE_LIMIT\n\n/**\n * Apply a named rate limiter to a controller class or a single route method.\n *\n * Stacks: multiple `@RateLimit` decorators on the same target push onto\n * the metadata array — every named limiter is enforced. Class-level limits\n * run before method-level limits in the resulting middleware chain.\n *\n * The named limiter must be registered separately via\n * `RateLimiterRegistry.for('name', resolver)` (typically inside a\n * module's `onInitialize` hook) and the user must import\n * `RateLimiterModule.forRoot({ store: ... })` in their AppModule.\n *\n * @example\n * ```typescript\n * @Controller('/api/v1/users')\n * @RateLimit('api')\n * export class UsersController {\n *   @Get('/')\n *   list(ctx: RouterContext) { ... }\n *\n *   @Post('/')\n *   @RateLimit('writes')           // stacks with class-level 'api'\n *   create(ctx: RouterContext) { ... }\n * }\n * ```\n */\nexport function RateLimit(name: string): ClassDecorator & MethodDecorator {\n  return (target: object, propertyKey?: string | symbol) => {\n    if (propertyKey === undefined) {\n      const existing = (Reflect.getOwnMetadata(KEY, target) as string[] | undefined) ?? []\n      Reflect.defineMetadata(KEY, [...existing, name], target)\n    } else {\n      const existing = (Reflect.getOwnMetadata(KEY, target, propertyKey as string) as string[] | undefined) ?? []\n      Reflect.defineMetadata(KEY, [...existing, name], target, propertyKey as string)\n    }\n  }\n}\n\n/**\n * Read the rate-limit names attached to a class or method via `@RateLimit`.\n * Returns an empty array when no decorator was applied.\n *\n * @param target - For class metadata, pass the controller constructor.\n *   For method metadata, pass `Controller.prototype` and the method name.\n */\nexport function getRateLimits(target: object, propertyKey?: string): string[] {\n  const meta: unknown = propertyKey === undefined\n    ? Reflect.getMetadata(KEY, target)\n    : Reflect.getMetadata(KEY, target, propertyKey)\n  return Array.isArray(meta) ? (meta as string[]) : []\n}\n"],"mappings":";;AAEA,MAAM,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BhC,SAAgB,UAAU,MAAgD;CACxE,QAAQ,QAAgB,gBAAkC;EACxD,IAAI,gBAAgB,KAAA,GAAW;GAC7B,MAAM,WAAY,QAAQ,eAAe,KAAK,OAAO,IAA6B,EAAE;GACpF,QAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,KAAK,EAAE,OAAO;SACnD;GACL,MAAM,WAAY,QAAQ,eAAe,KAAK,QAAQ,YAAsB,IAA6B,EAAE;GAC3G,QAAQ,eAAe,KAAK,CAAC,GAAG,UAAU,KAAK,EAAE,QAAQ,YAAsB;;;;;;;;;;;AAYrF,SAAgB,cAAc,QAAgB,aAAgC;CAC5E,MAAM,OAAgB,gBAAgB,KAAA,IAClC,QAAQ,YAAY,KAAK,OAAO,GAChC,QAAQ,YAAY,KAAK,QAAQ,YAAY;CACjD,OAAO,MAAM,QAAQ,KAAK,GAAI,OAAoB,EAAE"}

package/dist/resend.provider-DB4IlFjG.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"resend.provider-DB4IlFjG.mjs","names":[],"sources":["../src/email/providers/resend.provider.ts"],"sourcesContent":["import { Resend } from 'resend'\nimport type { ResolvedEmailAttachment, ResolvedEmailMessage } from '../contracts'\nimport type { EmailModuleOptions } from '../email.module'\nimport { EmailResendApiFailedError, ResendApiKeyMissingError } from '../errors'\nimport { BaseEmailProvider } from './base-email.provider'\nimport type { EmailSendResult } from './email-provider.interface'\n\n/**\n * Resend Email Provider\n *\n * Implementation of IEmailProvider using Resend API\n * Docs: https://resend.com/docs\n */\nexport class ResendProvider extends BaseEmailProvider {\n  private readonly client: Resend\n  private readonly defaultFrom: { name: string; email: string }\n\n  constructor(\n    private readonly options: EmailModuleOptions\n  ) {\n    super()\n\n    // Validate Resend API key\n    if (!this.options.apiKey) {\n      throw new ResendApiKeyMissingError()\n    }\n\n    this.client = new Resend(this.options.apiKey)\n    this.defaultFrom = this.options.from\n  }\n\n  async send(message: ResolvedEmailMessage): Promise<EmailSendResult> {\n    try {\n      const from = message.from\n        ? `${message.from.name} <${message.from.email}>`\n        : `${this.defaultFrom.name} <${this.defaultFrom.email}>`\n\n      const to = Array.isArray(message.to) ? message.to : [message.to]\n\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- Resend SDK types\n      const response = await this.client.emails.send({\n        from,\n        to,\n        subject: message.subject,\n        html: message.html,\n        text: message.text,\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment -- Resend template extension\n        ...((message as any).template && { template: (message as any).template }),\n        ...(message.replyTo && { replyTo: message.replyTo }),\n        ...(message.cc && { cc: message.cc }),\n        ...(message.bcc && { bcc: message.bcc }),\n        ...(message.attachments && {\n          attachments: await Promise.all(\n            message.attachments.map(async attachment => ({\n              filename: attachment.filename,\n              content: await this.toBuffer(attachment.content),\n            }))\n          ),\n        }),\n      })\n\n      if (response.error) {\n        throw new EmailResendApiFailedError()\n      }\n\n      return {\n        messageId: response.data.id,\n        accepted: true,\n        metadata: {\n          provider: 'resend',\n        },\n      }\n    } catch (error) {\n      if (error instanceof EmailResendApiFailedError || error instanceof ResendApiKeyMissingError) {\n        throw error\n      }\n\n      throw new EmailResendApiFailedError()\n    }\n  }\n\n  /**\n   * Convert attachment content to Buffer\n   *\n   * Resend SDK expects Buffer for attachment content.\n   * If content is already a Buffer, return as-is.\n   * If content is a ReadableStream, convert to Buffer.\n   */\n  private async toBuffer(content: ResolvedEmailAttachment['content']): Promise<Buffer> {\n    if (Buffer.isBuffer(content)) {\n      return content\n    }\n    // Convert ReadableStream to Buffer\n    const response = new Response(content)\n    const arrayBuffer = await response.arrayBuffer()\n    return Buffer.from(arrayBuffer)\n  }\n}\n"],"mappings":";;;;;;;;;;AAaA,IAAa,iBAAb,cAAoC,kBAAkB;CAKjC;CAJnB;CACA;CAEA,YACE,SACA;EACA,OAAO;EAFU,KAAA,UAAA;EAKjB,IAAI,CAAC,KAAK,QAAQ,QAChB,MAAM,IAAI,0BAA0B;EAGtC,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,OAAO;EAC7C,KAAK,cAAc,KAAK,QAAQ;;CAGlC,MAAM,KAAK,SAAyD;EAClE,IAAI;GACF,MAAM,OAAO,QAAQ,OACjB,GAAG,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,KAC5C,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,YAAY,MAAM;GAExD,MAAM,KAAK,MAAM,QAAQ,QAAQ,GAAG,GAAG,QAAQ,KAAK,CAAC,QAAQ,GAAG;GAGhE,MAAM,WAAW,MAAM,KAAK,OAAO,OAAO,KAAK;IAC7C;IACA;IACA,SAAS,QAAQ;IACjB,MAAM,QAAQ;IACd,MAAM,QAAQ;IAEd,GAAK,QAAgB,YAAY,EAAE,UAAW,QAAgB,UAAU;IACxE,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,SAAS;IACnD,GAAI,QAAQ,MAAM,EAAE,IAAI,QAAQ,IAAI;IACpC,GAAI,QAAQ,OAAO,EAAE,KAAK,QAAQ,KAAK;IACvC,GAAI,QAAQ,eAAe,EACzB,aAAa,MAAM,QAAQ,IACzB,QAAQ,YAAY,IAAI,OAAM,gBAAe;KAC3C,UAAU,WAAW;KACrB,SAAS,MAAM,KAAK,SAAS,WAAW,QAAQ;KACjD,EAAE,CACJ,EACF;IACF,CAAC;GAEF,IAAI,SAAS,OACX,MAAM,IAAI,2BAA2B;GAGvC,OAAO;IACL,WAAW,SAAS,KAAK;IACzB,UAAU;IACV,UAAU,EACR,UAAU,UACX;IACF;WACM,OAAO;GACd,IAAI,iBAAiB,6BAA6B,iBAAiB,0BACjE,MAAM;GAGR,MAAM,IAAI,2BAA2B;;;;;;;;;;CAWzC,MAAc,SAAS,SAA8D;EACnF,IAAI,OAAO,SAAS,QAAQ,EAC1B,OAAO;EAIT,MAAM,cAAc,MAAM,IADL,SAAS,QACI,CAAC,aAAa;EAChD,OAAO,OAAO,KAAK,YAAY"}

package/dist/seeder-zoEfEw9i.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"seeder-zoEfEw9i.mjs","names":[],"sources":["../src/seeder/errors.ts","../src/seeder/seeder-registry.ts","../src/seeder/commands/db-seed-list.command.ts","../src/seeder/commands/db-seed.command.ts"],"sourcesContent":["import { ApplicationError, ERROR_CODES } from '../errors'\n\nexport class SeederNotRegisteredError extends ApplicationError {\n  constructor(name: string) {\n    super(\n      'errors.seederNotRegistered',\n      ERROR_CODES.SYSTEM.SEEDER_NOT_REGISTERED,\n      { name },\n    )\n  }\n}\n\nexport class SeederNameCollisionError extends ApplicationError {\n  constructor(name: string) {\n    super(\n      'errors.seederNameCollision',\n      ERROR_CODES.SYSTEM.SEEDER_NAME_COLLISION,\n      { name },\n    )\n  }\n}\n","import type { Application } from '../application'\nimport type { Container } from '../di/container'\nimport type { Constructor } from '../types'\nimport { SeederNameCollisionError, SeederNotRegisteredError } from './errors'\nimport { type Seeder, SEEDER_INTERNALS } from './seeder'\n\nexport const SEEDER_TOKENS = {\n  SeederRegistry: Symbol.for('stratal:seeders:registry'),\n} as const\n\nexport class SeederRegistry {\n  private seeders = new Set<Constructor<Seeder>>()\n  private nameIndex = new Map<string, Constructor<Seeder>>()\n\n  constructor(private app: Application) { }\n\n  register(SeederClass: Constructor<Seeder>): void {\n    const existing = this.nameIndex.get(SeederClass.name)\n    if (existing && existing !== SeederClass) {\n      throw new SeederNameCollisionError(SeederClass.name)\n    }\n    this.seeders.add(SeederClass)\n    this.nameIndex.set(SeederClass.name, SeederClass)\n  }\n\n  async run(SeederClass: Constructor<Seeder>, options?: { container?: Container }): Promise<void> {\n    if (!this.seeders.has(SeederClass)) {\n      throw new SeederNotRegisteredError(SeederClass.name)\n    }\n\n    const execute = async (container: Container) => {\n      const seeder = container.resolve<Seeder>(SeederClass)\n      seeder[SEEDER_INTERNALS] = {\n        run: (cls) => this.run(cls, { container }),\n        container,\n      }\n      await seeder.run()\n    }\n\n    if (options?.container) {\n      await execute(options.container)\n    } else {\n      const mockContext = this.app.createMockRouterContext('en')\n      await this.app.container.runInRequestScope(mockContext, execute)\n    }\n  }\n\n  async runAll(options?: { container?: Container }): Promise<void> {\n    for (const SeederClass of this.seeders) {\n      await this.run(SeederClass, options)\n    }\n  }\n\n  find(name: string): Constructor<Seeder> | undefined {\n    return this.nameIndex.get(name)\n  }\n\n  has(SeederClass: Constructor<Seeder>): boolean {\n    return this.seeders.has(SeederClass)\n  }\n\n  list(): { className: string }[] {\n    return [...this.seeders].map(cls => ({ className: cls.name }))\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Command } from '../../quarry/command'\nimport { type SeederRegistry, SEEDER_TOKENS } from '../seeder-registry'\n\nexport class DbSeedListCommand extends Command {\n  static command = 'db:seed:list'\n  static description = 'List available database seeders'\n\n  constructor(@inject(SEEDER_TOKENS.SeederRegistry) private seeders: SeederRegistry) {\n    super()\n  }\n\n  handle(): undefined | number {\n    const list = this.seeders.list()\n    if (list.length === 0) {\n      this.info('No seeders found')\n      return 0\n    }\n    this.table(['Class'], list.map(s => [s.className]))\n\n    return undefined\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Command } from '../../quarry/command'\nimport { type SeederRegistry, SEEDER_TOKENS } from '../seeder-registry'\n\nexport class DbSeedCommand extends Command {\n  static command = 'db:seed {names* : Seeder class names} {--a|all : Run all seeders} {--dry-run : Preview without executing}'\n  static description = 'Run database seeders'\n\n  constructor(@inject(SEEDER_TOKENS.SeederRegistry) private seeders: SeederRegistry) {\n    super()\n  }\n\n  async handle(): Promise<number | undefined> {\n    const names = this.array('names')\n    const all = this.boolean('all')\n    const dryRun = this.boolean('dry-run')\n\n    if (names.length > 0 && all) {\n      this.warn(`Ignoring \"${names.join(', ')}\" because --all takes precedence`)\n    }\n\n    if (names.length === 0 && !all) {\n      this.fail('Specify one or more seeder class names or use --all')\n      return 1\n    }\n\n    if (dryRun) {\n      if (all) {\n        const list = this.seeders.list()\n        this.info('Dry run — would execute:')\n        for (const s of list) {\n          this.info(`  ${s.className}`)\n        }\n      } else {\n        this.info('Dry run — would execute:')\n        for (const name of names) {\n          const SeederClass = this.seeders.find(name)\n          if (!SeederClass) {\n            this.fail(`Seeder \"${name}\" not found`)\n            return 1\n          }\n          this.info(`  ${SeederClass.name}`)\n        }\n      }\n      return 0\n    }\n\n    if (all) {\n      await this.seeders.runAll()\n      this.success('All seeders completed')\n    } else {\n      for (const name of names) {\n        const SeederClass = this.seeders.find(name)\n        if (!SeederClass) {\n          this.fail(`Seeder \"${name}\" not found`)\n          return 1\n        }\n        await this.seeders.run(SeederClass)\n        this.success(`Seeder \"${name}\" completed`)\n      }\n    }\n\n    return 0\n  }\n}\n"],"mappings":"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"}

package/dist/setup-CefZKV_e.mjs

@@ -1,37 +0,0 @@
-import { compile, registerMessageCompiler } from "@intlify/core-base";
-//#region src/i18n/utils/setup.ts
-/**
-* I18n Setup - Message Compiler Registration
-*
-* Registers a JIT (Just-In-Time) message compiler for @intlify/core-base
-* that works in Cloudflare Workers edge runtime.
-*
-* This must be called ONCE at application startup, before any I18nService instances are created.
-*/
-let isRegistered = false;
-/**
-* Setup JIT message compiler for i18n
-*
-* Registers a message compiler that uses JIT compilation mode.
-* In @intlify/core-base v10+, JIT mode is enabled by default, which generates
-* AST (Abstract Syntax Tree) instead of JavaScript code, making it compatible
-* with CSP-restricted environments like Cloudflare Workers.
-*
-* **IMPORTANT:** Call this function once at application startup before creating
-* any I18nService instances. Safe to call multiple times (only registers once).
-*
-* @example
-* ```typescript
-* // In application entry point (before app.initialize())
-* setupI18nCompiler()
-* ```
-*/
-function setupI18nCompiler() {
-	if (isRegistered) return;
-	registerMessageCompiler(compile);
-	isRegistered = true;
-}
-//#endregion
-export { setupI18nCompiler as t };
-
-//# sourceMappingURL=setup-CefZKV_e.mjs.map

package/dist/setup-CefZKV_e.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-CefZKV_e.mjs","names":[],"sources":["../src/i18n/utils/setup.ts"],"sourcesContent":["/**\n * I18n Setup - Message Compiler Registration\n *\n * Registers a JIT (Just-In-Time) message compiler for @intlify/core-base\n * that works in Cloudflare Workers edge runtime.\n *\n * This must be called ONCE at application startup, before any I18nService instances are created.\n */\n\nimport { compile, registerMessageCompiler } from '@intlify/core-base'\n\nlet isRegistered = false\n\n/**\n * Setup JIT message compiler for i18n\n *\n * Registers a message compiler that uses JIT compilation mode.\n * In @intlify/core-base v10+, JIT mode is enabled by default, which generates\n * AST (Abstract Syntax Tree) instead of JavaScript code, making it compatible\n * with CSP-restricted environments like Cloudflare Workers.\n *\n * **IMPORTANT:** Call this function once at application startup before creating\n * any I18nService instances. Safe to call multiple times (only registers once).\n *\n * @example\n * ```typescript\n * // In application entry point (before app.initialize())\n * setupI18nCompiler()\n * ```\n */\nexport function setupI18nCompiler(): void {\n  // Guard against multiple registrations\n  if (isRegistered) {\n    return\n  }\n\n  // Register the compile function from @intlify/core-base as the message compiler\n  // In v11+, compile() uses JIT mode by default, generating AST instead of JavaScript code\n  // This avoids CSP violations (no eval/new Function) in Cloudflare Workers\n  registerMessageCompiler(compile)\n\n  isRegistered = true\n}\n"],"mappings":";;;;;;;;;;AAWA,IAAI,eAAe;;;;;;;;;;;;;;;;;;AAmBnB,SAAgB,oBAA0B;CAExC,IAAI,cACF;CAMF,wBAAwB,QAAQ;CAEhC,eAAe"}

package/dist/smtp.provider-B6D7zuWX.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"smtp.provider-B6D7zuWX.mjs","names":[],"sources":["../src/email/providers/smtp.provider.ts"],"sourcesContent":["import type { Transporter } from 'nodemailer'\nimport * as nodemailer from 'nodemailer'\nimport type SMTPTransport from 'nodemailer/lib/smtp-transport'\nimport { Readable } from 'stream'\nimport type { ResolvedEmailAttachment, ResolvedEmailMessage } from '../contracts'\nimport type { EmailModuleOptions } from '../email.module'\nimport { EmailSmtpConnectionFailedError, SmtpConfigurationMissingError, SmtpHostMissingError } from '../errors'\nimport { BaseEmailProvider } from './base-email.provider'\nimport type { EmailSendResult } from './email-provider.interface'\n\n/**\n * SMTP Email Provider\n *\n * Implementation of IEmailProvider using SMTP/nodemailer\n * Supports any SMTP server configured via SMTP_URL\n */\nexport class SmtpProvider extends BaseEmailProvider {\n  private readonly transporter: Transporter<SMTPTransport.SentMessageInfo>\n  private readonly defaultFrom: { name: string; email: string }\n\n  constructor(\n    private readonly options: EmailModuleOptions\n  ) {\n    super()\n\n    // Validate SMTP configuration\n    if (!this.options.smtp) {\n      throw new SmtpConfigurationMissingError()\n    }\n\n    if (!this.options.smtp.host) {\n      throw new SmtpHostMissingError()\n    }\n\n    // Create nodemailer transporter\n    this.transporter = nodemailer.createTransport({\n      host: this.options.smtp.host,\n      port: this.options.smtp.port,\n      secure: this.options.smtp.secure,\n      auth: this.options.smtp.username && this.options.smtp.password\n        ? {\n          user: this.options.smtp.username,\n          pass: this.options.smtp.password,\n        }\n        : undefined,\n    })\n\n    this.defaultFrom = this.options.from\n  }\n\n  async send(message: ResolvedEmailMessage): Promise<EmailSendResult> {\n    try {\n      const from = message.from\n        ? `${message.from.name} <${message.from.email}>`\n        : `${this.defaultFrom.name} <${this.defaultFrom.email}>`\n\n      const info = await this.transporter.sendMail({\n        from,\n        to: Array.isArray(message.to) ? message.to.join(', ') : message.to,\n        subject: message.subject,\n        html: message.html,\n        text: message.text,\n        replyTo: message.replyTo,\n        cc: message.cc?.join(', '),\n        bcc: message.bcc?.join(', '),\n        attachments: message.attachments?.map(attachment => ({\n          filename: attachment.filename,\n          content: this.toNodeStream(attachment.content),\n          contentType: attachment.contentType,\n        })),\n      })\n\n      return {\n        messageId: info.messageId,\n        accepted: true,\n        metadata: {\n          provider: 'smtp',\n          response: info.response,\n        },\n      }\n    } catch {\n      throw new EmailSmtpConnectionFailedError(\n        this.options.smtp?.host ?? '',\n        this.options.smtp?.port ?? 587\n      )\n    }\n  }\n\n  /**\n   * Convert attachment content to Node.js stream format\n   *\n   * Nodemailer expects Node.js Readable streams, not web ReadableStream.\n   * Buffer is passed through as-is since nodemailer supports it directly.\n   */\n  private toNodeStream(content: ResolvedEmailAttachment['content']): Buffer | Readable {\n    if (Buffer.isBuffer(content)) {\n      return content\n    }\n    // Convert web ReadableStream to Node.js Readable\n    return Readable.fromWeb(content as unknown as Parameters<typeof Readable.fromWeb>[0])\n  }\n}\n"],"mappings":";;;;;;;;;;;AAgBA,IAAa,eAAb,cAAkC,kBAAkB;CAK/B;CAJnB;CACA;CAEA,YACE,SACA;EACA,OAAO;EAFU,KAAA,UAAA;EAKjB,IAAI,CAAC,KAAK,QAAQ,MAChB,MAAM,IAAI,+BAA+B;EAG3C,IAAI,CAAC,KAAK,QAAQ,KAAK,MACrB,MAAM,IAAI,sBAAsB;EAIlC,KAAK,cAAc,WAAW,gBAAgB;GAC5C,MAAM,KAAK,QAAQ,KAAK;GACxB,MAAM,KAAK,QAAQ,KAAK;GACxB,QAAQ,KAAK,QAAQ,KAAK;GAC1B,MAAM,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ,KAAK,WAClD;IACA,MAAM,KAAK,QAAQ,KAAK;IACxB,MAAM,KAAK,QAAQ,KAAK;IACzB,GACC,KAAA;GACL,CAAC;EAEF,KAAK,cAAc,KAAK,QAAQ;;CAGlC,MAAM,KAAK,SAAyD;EAClE,IAAI;GACF,MAAM,OAAO,QAAQ,OACjB,GAAG,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,KAC5C,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,YAAY,MAAM;GAExD,MAAM,OAAO,MAAM,KAAK,YAAY,SAAS;IAC3C;IACA,IAAI,MAAM,QAAQ,QAAQ,GAAG,GAAG,QAAQ,GAAG,KAAK,KAAK,GAAG,QAAQ;IAChE,SAAS,QAAQ;IACjB,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,SAAS,QAAQ;IACjB,IAAI,QAAQ,IAAI,KAAK,KAAK;IAC1B,KAAK,QAAQ,KAAK,KAAK,KAAK;IAC5B,aAAa,QAAQ,aAAa,KAAI,gBAAe;KACnD,UAAU,WAAW;KACrB,SAAS,KAAK,aAAa,WAAW,QAAQ;KAC9C,aAAa,WAAW;KACzB,EAAE;IACJ,CAAC;GAEF,OAAO;IACL,WAAW,KAAK;IAChB,UAAU;IACV,UAAU;KACR,UAAU;KACV,UAAU,KAAK;KAChB;IACF;UACK;GACN,MAAM,IAAI,+BACR,KAAK,QAAQ,MAAM,QAAQ,IAC3B,KAAK,QAAQ,MAAM,QAAQ,IAC5B;;;;;;;;;CAUL,aAAqB,SAAgE;EACnF,IAAI,OAAO,SAAS,QAAQ,EAC1B,OAAO;EAGT,OAAO,SAAS,QAAQ,QAA6D"}

package/dist/storage-D8CBP72Z.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-D8CBP72Z.mjs","names":[],"sources":["../src/storage/storage.tokens.ts","../src/storage/services/storage-manager.service.ts","../src/storage/services/storage.service.ts","../src/storage/storage.module.ts","../src/storage/controllers/storage.controller.ts","../src/storage/contracts/delete-file.input.ts","../src/storage/contracts/file-exists.input.ts","../src/storage/contracts/get-presigned-url.input.ts","../src/storage/contracts/upload-file.input.ts"],"sourcesContent":["/**\n * Dependency injection tokens for the Storage module\n * Using Symbol-based tokens to avoid magic strings\n */\nexport const STORAGE_TOKENS = {\n  Options: Symbol.for('stratal:storage:options'),\n  StorageService: Symbol.for('stratal:storage:service'),\n  StorageManager: Symbol.for('stratal:storage:manager'),\n} as const\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { type StratalEnv } from '../../env'\nimport { DiskNotConfiguredError, R2BindingNotFoundError } from '../errors'\nimport type { IStorageProvider } from '../providers/storage-provider.interface'\nimport { STORAGE_TOKENS } from '../storage.tokens'\nimport type { StorageConfig, StorageEntry } from '../types'\n\n/**\n * Storage Manager Service\n * Manages multiple storage providers (one per disk)\n * Handles lazy initialization and caching of R2 providers\n */\n@Transient(STORAGE_TOKENS.StorageManager)\nexport class StorageManagerService {\n  private readonly providers = new Map<string, IStorageProvider>()\n  private readonly creationPromises = new Map<string, Promise<IStorageProvider>>()\n  private readonly diskConfigs = new Map<string, StorageEntry>()\n\n  constructor(\n    @inject(STORAGE_TOKENS.Options)\n    private readonly options: StorageConfig,\n    @inject(DI_TOKENS.CloudflareEnv)\n    private readonly env: StratalEnv\n  ) {\n    this.initializeDiskConfigs()\n  }\n\n  /**\n   * Initialize disk configurations from options\n   */\n  private initializeDiskConfigs(): void {\n    for (const entry of this.options.storage) {\n      this.diskConfigs.set(entry.disk, entry)\n    }\n  }\n\n  /**\n   * Get provider for a specific disk\n   * Lazily initializes provider on first access\n   * @param diskName - Name of the disk\n   * @returns Storage provider instance\n   */\n  async getProvider(diskName: string): Promise<IStorageProvider> {\n    // Return cached provider if exists\n    const cached = this.providers.get(diskName)\n    if (cached) {\n      return cached\n    }\n\n    // Return in-flight creation promise to deduplicate concurrent calls\n    const inflight = this.creationPromises.get(diskName)\n    if (inflight) {\n      return inflight\n    }\n\n    // Get disk configuration\n    const diskConfig = this.diskConfigs.get(diskName)\n    if (!diskConfig) {\n      throw new DiskNotConfiguredError(diskName)\n    }\n\n    // Create provider and deduplicate concurrent calls\n    const promise = this.createProvider(diskConfig).then((provider) => {\n      this.providers.set(diskName, provider)\n      this.creationPromises.delete(diskName)\n      return provider\n    }).catch((error: unknown) => {\n      this.creationPromises.delete(diskName)\n      throw error\n    })\n\n    this.creationPromises.set(diskName, promise)\n\n    return promise\n  }\n\n  /**\n   * Create an R2 provider instance\n   * Dynamically imports R2StorageProvider to support code splitting\n   * @param config - Storage entry configuration\n   * @returns Storage provider instance\n   */\n  private async createProvider(config: StorageEntry): Promise<IStorageProvider> {\n    const { R2StorageProvider } = await import('../providers/r2-storage.provider')\n    const bucket = this.env[config.binding as keyof StratalEnv] as unknown as R2Bucket | undefined\n    if (!bucket) {\n      throw new R2BindingNotFoundError(config.binding)\n    }\n    return new R2StorageProvider(config, bucket, this.env, this.options.route)\n  }\n\n  /**\n   * Get disk configuration\n   * @param diskName - Name of the disk\n   * @returns Storage entry configuration\n   */\n  getDiskConfig(diskName: string): StorageEntry {\n    const config = this.diskConfigs.get(diskName)\n    if (!config) {\n      throw new DiskNotConfiguredError(diskName)\n    }\n    return config\n  }\n\n  /**\n   * Check if a disk exists\n   * @param diskName - Name of the disk\n   * @returns True if disk exists, false otherwise\n   */\n  hasDisk(diskName: string): boolean {\n    return this.diskConfigs.has(diskName)\n  }\n\n  /**\n   * Get all available disk names\n   * @returns Array of disk names\n   */\n  getAvailableDisks(): string[] {\n    return Array.from(this.diskConfigs.keys())\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts'\nimport {\n  InvalidDiskError,\n  PresignedUrlInvalidExpiryError,\n} from '../errors'\nimport type { StreamingBlobPayloadInputTypes } from '../providers/storage-provider.interface'\nimport { STORAGE_TOKENS } from '../storage.tokens'\nimport type { StorageConfig } from '../types'\nimport { type StorageManagerService } from './storage-manager.service'\n\n/**\n * Storage Service\n *\n * Main facade for storage operations.\n * Request-scoped for proper isolation.\n *\n * @example\n * ```typescript\n * @inject(STORAGE_TOKENS.StorageService)\n * private readonly storage: StorageService\n *\n * await this.storage.upload(file, 'documents/report.pdf')\n * ```\n */\n@Transient(STORAGE_TOKENS.StorageService)\nexport class StorageService {\n  constructor(\n    @inject(STORAGE_TOKENS.StorageManager)\n    protected readonly storageManager: StorageManagerService,\n    @inject(STORAGE_TOKENS.Options)\n    protected readonly options: StorageConfig\n  ) { }\n\n  /**\n   * Upload content to storage\n   * @param body - Content to upload (stream, buffer, or string)\n   * @param relativePath - Relative path within the disk\n   * @param options - Upload options including size and mime type\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Upload result with metadata\n   */\n  async upload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: UploadOptions,\n    disk?: string\n  ): Promise<UploadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.upload(body, fullPath, options)\n  }\n\n  /**\n   * Download a file from storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Download result with stream and metadata\n   */\n  async download(relativePath: string, disk?: string): Promise<DownloadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.download(fullPath)\n  }\n\n  /**\n   * Delete a file from storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   */\n  async delete(relativePath: string, disk?: string): Promise<void> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    await provider.delete(fullPath)\n  }\n\n  /**\n   * Check if a file exists in storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns True if file exists, false otherwise\n   */\n  async exists(relativePath: string, disk?: string): Promise<boolean> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.exists(fullPath)\n  }\n\n  /**\n   * Generate a presigned download URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedDownloadUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'GET', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned upload URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedUploadUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'PUT', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned delete URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedDeleteUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'DELETE', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned URL for any method\n   * @param relativePath - Relative path within the disk\n   * @param method - HTTP method (GET, PUT, DELETE, HEAD)\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  protected async getPresignedUrl(\n    relativePath: string,\n    method: 'GET' | 'PUT' | 'DELETE' | 'HEAD',\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n    const validatedExpiresIn = this.validateExpiresIn(expiresIn)\n\n    return provider.getPresignedUrl(fullPath, method, validatedExpiresIn)\n  }\n\n  /**\n   * Resolve disk name (use default if not provided)\n   * @param disk - Optional disk name\n   * @returns Resolved disk name\n   */\n  protected resolveDisk(disk?: string): string {\n    const diskName = disk ?? this.options.defaultStorageDisk\n\n    if (!this.storageManager.hasDisk(diskName)) {\n      throw new InvalidDiskError(diskName)\n    }\n\n    return diskName\n  }\n\n  /**\n   * Build full path with disk root and path template substitution\n   * @param relativePath - Relative path within the disk\n   * @param diskName - Name of the disk\n   * @returns Full path including disk root\n   */\n  protected buildFullPath(relativePath: string, diskName: string): string {\n    const diskConfig = this.storageManager.getDiskConfig(diskName)\n    let root = diskConfig.root || ''\n\n    // Substitute template variables\n    root = this.substituteTemplateVariables(root)\n\n    // Combine root and relative path\n    const fullPath = `${root}/${relativePath}`.replace(/\\/+/g, '/').replace(/^\\//, '')\n\n    return fullPath\n  }\n\n  /**\n   * Substitute template variables in path\n   * Override this method in subclasses to add custom substitutions\n   *\n   * @param path - Path with template variables\n   * @returns Path with substituted variables\n   */\n  protected substituteTemplateVariables(path: string): string {\n    let result = path\n\n    // Substitute {date}, {year}, {month}\n    const now = new Date()\n    result = result.replace(/{date}/g, now.toISOString().split('T')[0])\n    result = result.replace(/{year}/g, now.getFullYear().toString())\n    result = result.replace(/{month}/g, (now.getMonth() + 1).toString().padStart(2, '0'))\n\n    return result\n  }\n\n  /**\n   * Validate expiry time for presigned URLs\n   * @param expiresIn - Optional expiry time in seconds\n   * @returns Validated expiry time\n   */\n  protected validateExpiresIn(expiresIn?: number): number {\n    const presignedUrlConfig = this.options.presignedUrl\n    const validatedExpiresIn = expiresIn ?? presignedUrlConfig.defaultExpiry\n\n    const minExpiry = 1\n    const maxExpiry = presignedUrlConfig.maxExpiry\n\n    if (validatedExpiresIn < minExpiry || validatedExpiresIn > maxExpiry) {\n      throw new PresignedUrlInvalidExpiryError(validatedExpiresIn, minExpiry, maxExpiry)\n    }\n\n    return validatedExpiresIn\n  }\n\n  /**\n   * Get all available disk names\n   * @returns Array of disk names\n   */\n  getAvailableDisks(): string[] {\n    return this.storageManager.getAvailableDisks()\n  }\n\n  /**\n   * Chunked upload for streaming data without known size\n   * Uses multipart upload under the hood - handles retries and large files\n   *\n   * Use this method when:\n   * - Content-Length is unknown or unreliable\n   * - Uploading from streams that can't be rewound\n   * - Need automatic retry handling for transient failures\n   *\n   * @param body - Content to upload (stream or buffer)\n   * @param relativePath - Relative path within the disk\n   * @param options - Upload options (mimeType required, size optional)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Upload result with metadata\n   */\n  async chunkedUpload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: Omit<UploadOptions, 'size'> & { size?: number },\n    disk?: string\n  ): Promise<UploadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.chunkedUpload(body, fullPath, options)\n  }\n}\n","/**\n * Storage Module\n * Provides file storage capabilities using Cloudflare R2\n * Supports multiple disk configurations with dynamic path templates\n */\n\nimport { Scope } from '../di/types'\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule } from '../module/types'\nimport { StorageManagerService } from './services/storage-manager.service'\nimport { StorageService } from './services/storage.service'\nimport { STORAGE_TOKENS } from './storage.tokens'\nimport type { StorageConfig } from './types'\n\n/**\n * Storage module options\n * Same as StorageConfig from types.ts\n */\nexport type StorageModuleOptions = StorageConfig\n\n@Module({\n  providers: [\n    { provide: STORAGE_TOKENS.StorageManager, useClass: StorageManagerService, scope: Scope.Singleton },\n    { provide: STORAGE_TOKENS.StorageService, useClass: StorageService },\n  ],\n})\nexport class StorageModule {\n  /**\n   * Configure StorageModule with static options\n   *\n   * @example\n   * ```typescript\n   * StorageModule.forRoot({\n   *   storage: [{ disk: 'uploads', binding: 'MY_BUCKET', root: 'uploads' }],\n   *   defaultStorageDisk: 'uploads',\n   *   presignedUrl: { defaultExpiry: 3600, maxExpiry: 86400 }\n   * })\n   * ```\n   */\n  static forRoot(options: StorageModuleOptions): DynamicModule {\n    return {\n      module: StorageModule,\n      providers: [\n        { provide: STORAGE_TOKENS.Options, useValue: options },\n      ],\n    }\n  }\n\n  /**\n   * Configure StorageModule with async factory\n   *\n   * Use when configuration depends on other services.\n   *\n   * @example\n   * ```typescript\n   * StorageModule.forRootAsync({\n   *   inject: [storageConfig.KEY],\n   *   useFactory: (storage) => ({\n   *     storage: storage.storage,\n   *     defaultStorageDisk: storage.defaultStorageDisk,\n   *     presignedUrl: storage.presignedUrl\n   *   })\n   * })\n   * ```\n   */\n  static forRootAsync(options: AsyncModuleOptions<StorageModuleOptions>): DynamicModule {\n    return {\n      module: StorageModule,\n      providers: [\n        {\n          provide: STORAGE_TOKENS.Options,\n          useFactory: options.useFactory,\n          inject: options.inject,\n        },\n      ],\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport { z } from '../../i18n/validation'\nimport { Controller } from '../../router/decorators/controller.decorator'\nimport { Delete, Get, Put } from '../../router/decorators/http-method.decorator'\nimport { type RouterContext } from '../../router/router-context'\nimport { FileNotFoundError } from '../errors'\nimport type { StorageService } from '../services/storage.service'\nimport { STORAGE_TOKENS } from '../storage.tokens'\n\nconst diskParam = z.object({\n  disk: z.string(),\n})\n\n/**\n * Storage Controller\n *\n * Auto-registered controller that proxies R2 operations behind signed URLs.\n * Signature verification is applied via VerifySignatureMiddleware on the module's\n * configureRoutes() method.\n *\n * Routes:\n * - GET    /storage/:disk/*  → download file\n * - PUT    /storage/:disk/*  → upload file\n * - DELETE /storage/:disk/*  → delete file\n */\n@Controller('/storage', { hideFromDocs: true })\nexport class StorageController {\n  constructor(\n    @inject(STORAGE_TOKENS.StorageService)\n    private readonly storage: StorageService\n  ) {}\n\n  @Get('/:disk/*', { hideFromDocs: true, params: diskParam })\n  async download(ctx: RouterContext): Promise<Response> {\n    const disk = ctx.param('disk')\n    const path = extractWildcardPath(ctx)\n    const result = await this.storage.download(path, disk)\n\n    const stream = result.toStream()\n    if (!stream) {\n      throw new FileNotFoundError(path)\n    }\n\n    return new Response(stream, {\n      headers: {\n        'Content-Type': result.contentType,\n        'Content-Length': String(result.size),\n        'Content-Disposition': 'inline',\n      },\n    })\n  }\n\n  @Put('/:disk/*', { hideFromDocs: true, params: diskParam })\n  async upload(ctx: RouterContext): Promise<Response> {\n    const disk = ctx.param('disk')\n    const path = extractWildcardPath(ctx)\n\n    const body = ctx.c.req.raw.body\n    const contentType = ctx.header('content-type') ?? 'application/octet-stream'\n    const contentLength = ctx.header('content-length')\n\n    await this.storage.upload(body, path, {\n      mimeType: contentType,\n      size: contentLength ? parseInt(contentLength, 10) : 0,\n    }, disk)\n\n    return ctx.json({ path, disk }, 200)\n  }\n\n  @Delete('/:disk/*', { hideFromDocs: true, params: diskParam })\n  async destroy(ctx: RouterContext): Promise<Response> {\n    const disk = ctx.param('disk')\n    const path = extractWildcardPath(ctx)\n\n    await this.storage.delete(path, disk)\n\n    return ctx.c.body(null, 204)\n  }\n}\n\n/**\n * Extract the wildcard path from the Hono context.\n * Hono stores wildcard params under the key matching the path pattern.\n */\nfunction extractWildcardPath(ctx: RouterContext): string {\n  // Hono exposes wildcard capture as the raw path after the matched prefix\n  const url = new URL(ctx.c.req.url)\n  const fullPath = url.pathname\n  // Remove /storage/:disk/ prefix to get the file path\n  const parts = fullPath.split('/')\n  // ['', 'storage', 'disk', ...rest]\n  return parts.slice(3).join('/')\n}\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const deleteFileInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  disk: z.string().optional(),\n})\n\nexport type DeleteFileInput = z.infer<typeof deleteFileInputSchema>\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const fileExistsInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  disk: z.string().optional(),\n})\n\nexport type FileExistsInput = z.infer<typeof fileExistsInputSchema>\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const getPresignedUrlInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  method: z.enum(['GET', 'PUT', 'DELETE', 'HEAD']).default('GET'),\n  expiresIn: z.number().int().min(1).max(604800).optional(),\n  disk: z.string().optional(),\n})\n\nexport type GetPresignedUrlInput = z.infer<typeof getPresignedUrlInputSchema>\n\nexport const presignedUrlResultSchema = z.object({\n  url: z.string().url(),\n  expiresIn: z.number(),\n  expiresAt: z.date(),\n  method: z.enum(['GET', 'PUT', 'DELETE', 'HEAD']),\n})\n\nexport type PresignedUrlResult = z.infer<typeof presignedUrlResultSchema>\n","import { z } from '../../i18n/validation'\n\n/**\n * Upload options for streaming uploads\n */\nexport interface UploadOptions {\n  /**\n   * Size of the content in bytes\n   */\n  size: number\n  /**\n   * MIME type of the content\n   */\n  mimeType?: string\n  /**\n   * Custom metadata to store with the object (S3-specific)\n   * Stored as S3 object metadata headers\n   */\n  metadata?: Record<string, string>\n  /**\n   * Object tagging for lifecycle policies (S3-specific)\n   * Format: key=value (e.g., \"Tus-Completed=true\")\n   */\n  tagging?: string\n}\n\nexport const uploadResultSchema = z.object({\n  path: z.string(),\n  disk: z.string(),\n  fullPath: z.string(),\n  size: z.number(),\n  mimeType: z.string(),\n  uploadedAt: z.date(),\n})\n\nexport type UploadResult = z.infer<typeof uploadResultSchema>\n"],"mappings":"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"}

package/dist/storage-provider.interface-Bd6vA4ak.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-provider.interface-Bd6vA4ak.d.mts","names":[],"sources":["../src/storage/types.ts","../src/storage/contracts/delete-file.input.ts","../src/storage/contracts/download-result.ts","../src/storage/contracts/file-exists.input.ts","../src/storage/contracts/get-presigned-url.input.ts","../src/storage/contracts/upload-file.input.ts","../src/storage/providers/storage-provider.interface.ts"],"mappings":";;;;;;AAIA;UAAiB,YAAA;EAChB,IAAA;EAD4B;EAG5B,OAAA;EACA,IAAA;AAAA;;;AAMD;UAAiB,kBAAA;EAChB,aAAA;EACA,SAAA;AAAA;AAMD;;;AAAA,UAAiB,kBAAA;EAIR;EAFR,QAAA;EAQ6B;EAN7B,QAAA;AAAA;;;;UAMgB,aAAA;EAChB,OAAA,EAAS,YAAA;EACT,kBAAA;EACA,YAAA,EAAc,kBAAA;EAAd;EAEA,KAAA,GAAQ,kBAAA;AAAA;;;cCnCI,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;KAKtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;;;;;;ADH7C;;;UEEiB,cAAA;EFDhB;;;EEKC,QAAA,gBAAwB,cAAA,CAAe,UAAA;EAEvC,QAAA,gBAAwB,OAAA;EAExB,aAAA,gBAA6B,OAAA,CAAQ,UAAA;EFAJ;;;EEKjC,WAAA;EFGe;;;EEEf,IAAA;EFEO;AAMT;;;EEFE,QAAA,GAAW,MAAA;AAAA;;;cC5BA,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;KAKtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;;;cCLhC,0BAAA,EAA0B,CAAA,CAAA,SAAA;;;;;;;;;;;KAO3B,oBAAA,GAAuB,CAAA,CAAE,KAAA,QAAa,0BAAA;AAAA,cAErC,wBAAA,EAAwB,CAAA,CAAA,SAAA;;;;;;;;;;;KAOzB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,wBAAA;;;;;AJdhD;UKCiB,aAAA;;;;EAIf,IAAA;ELDD;;;EKKC,QAAA;ELCiC;;;;EKIjC,QAAA,GAAW,MAAA;ELIsB;;;;EKCjC,OAAA;AAAA;AAAA,cAGW,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;;;;KASnB,YAAA,GAAe,CAAA,CAAE,KAAA,QAAa,kBAAA;;;;;AL/B1C;;KMEY,8BAAA,GACR,cAAA,GACA,WAAA,GACA,eAAA,YAEA,IAAA;;;;;UAOa,gBAAA;ENVZ;AAML;;;;;AAQA;EMIE,MAAA,CAAO,IAAA,EAAM,8BAAA,EAAgC,IAAA,UAAc,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;;;;ANM9F;;EMCE,QAAA,CAAS,IAAA,WAAe,OAAA,CAAQ,cAAA;ENAxB;;;;EMMR,MAAA,CAAO,IAAA,WAAe,OAAA;ENNvB;;;;;EMaC,MAAA,CAAO,IAAA,WAAe,OAAA;ENTf;;;;;;ACnCT;EKqDE,eAAA,CACE,IAAA,UACA,MAAA,qCACA,SAAA,WACC,OAAA,CAAQ,kBAAA;;;;;;;;;EAUX,aAAA,CACE,IAAA,EAAM,8BAAA,EACN,IAAA,UACA,OAAA,EAAS,IAAA,CAAK,aAAA;IAA2B,IAAA;EAAA,IACxC,OAAA,CAAQ,YAAA;AAAA"}

package/dist/stratal-CNwpbSZl.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"stratal-CNwpbSZl.mjs","names":["internal.getGroups","internal.getDefaultEntry","internal.getGlobalMiddleware","tsyringeRootContainer"],"sources":["../src/quarry/commands/route-types.command.ts","../src/router/router-resolver.ts","../src/application.ts","../src/stratal.ts"],"sourcesContent":["import { writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { inject } from 'tsyringe'\nimport type { RouteRegistry, RegisteredRoute } from '../../router/route-registry'\nimport { ROUTER_TOKENS } from '../../router/router.tokens'\nimport type { LocalePathService } from '../../router/services/locale-path.service'\nimport { Command } from '../command'\n\n/**\n * Generate TypeScript types for named routes.\n *\n * Outputs a `stratal.d.ts` file with `StratalRouteMap` augmentation\n * that provides autocomplete and type-safe params for `route()` and `ctx.route()`.\n *\n * @example\n * ```bash\n * quarry route:types                           # → src/stratal.d.ts\n * quarry route:types --output=types/routes.d.ts\n * ```\n */\nexport class RouteTypesCommand extends Command {\n  static command = 'route:types {--output=src/stratal.d.ts : Output file path}'\n  static description = 'Generate TypeScript types for named routes'\n\n  constructor(\n    @inject(ROUTER_TOKENS.RouteRegistry) private registry: RouteRegistry,\n    @inject(ROUTER_TOKENS.LocalePathService) private localePathService: LocalePathService,\n  ) {\n    super()\n  }\n\n  handle(): number | undefined {\n    const outputPath = resolve(this.string('output') || 'src/stratal.d.ts')\n    const namedRoutes = this.registry.named()\n\n    if (namedRoutes.length === 0) {\n      this.warn('No named routes found. Add name to your @Route() or @Get()/@Post() decorators.')\n      return 0\n    }\n\n    const content = this.generateDeclaration(namedRoutes)\n    writeFileSync(outputPath, content, 'utf-8')\n    this.info(`Generated route types for ${namedRoutes.length} named routes → ${outputPath}`)\n\n    return undefined\n  }\n\n  /**\n   * Generate the StratalRouteMap declaration content.\n   */\n  private generateDeclaration(routes: RegisteredRoute[]): string {\n    const localeConfig = this.localePathService.enabled ? this.localePathService.localePathConfig : null\n    const localeType = localeConfig\n      ? localeConfig.allLocales.map(l => `'${l}'`).join(' | ')\n      : null\n    const localeOptional = localeConfig ? this.localePathService.prefixDefaultLocale !== true : false\n\n    const entries = routes\n      .filter((r): r is RegisteredRoute & { name: string } => r.name !== undefined)\n      .sort((a, b) => a.name.localeCompare(b.name))\n      .map(route => {\n        const paramEntries = [\n          ...route.paramNames.map(p => `${p}: string`),\n          ...route.domainParamNames.map(p => `${p}: string`),\n        ]\n\n        if (localeType && route.localePaths?.length) {\n          const optionalMarker = localeOptional ? '?' : ''\n          paramEntries.push(`locale${optionalMarker}: StratalLocale`)\n        }\n\n        // Extra keys become query-string params at runtime, so allow any\n        // string key. Typed path/domain params above still take precedence.\n        const indexSignature = localeType && route.localePaths?.length\n          ? '[key: string]: string | StratalLocale | undefined'\n          : '[key: string]: string | undefined'\n        paramEntries.push(indexSignature)\n\n        const paramsType = `{ ${paramEntries.join('; ')} }`\n        return `    '${route.name}': { params: ${paramsType} }`\n      })\n      .join('\\n')\n\n    const lines = [\n      '// Auto-generated by `quarry route:types` — do not edit manually',\n      \"declare module 'stratal/router' {\",\n    ]\n\n    if (localeType) {\n      lines.push(`  type StratalLocale = ${localeType}`)\n      lines.push('')\n    }\n\n    lines.push(\n      '  interface StratalRouteMap {',\n      entries,\n      '  }',\n      '}',\n    )\n\n    return [\n      ...lines,\n      '',\n      'export {}',\n      '',\n    ].join('\\n')\n  }\n}\n","import type { ZodObject } from '../i18n/validation'\nimport type { Constructor } from '../types'\nimport type { Middleware } from './middleware.interface'\nimport type { Router, RouterEntry } from './router'\nimport * as internal from './router.internals'\n\n/**\n * Resolved configuration for a single controller.\n * Merges Router default entry, sub-group overrides, and inheritance rules.\n */\nexport interface ResolvedRouterConfig {\n  prefix?: string\n  domain?: string\n  name?: string\n  middleware: Constructor<Middleware>[]\n  version?: string | string[]\n  hideFromDocs?: boolean\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  params?: ZodObject<any>\n}\n\n/**\n * Internal resolver that computes the effective Router config for each controller.\n *\n * Inheritance rules:\n * - `middleware`: parent middleware runs first, then child (concatenated)\n * - `prefix`: concatenated (parent + child)\n * - `name`: concatenated (parent + child)\n * - `domain`: child overrides parent\n * - `version`: child overrides parent\n * - `hideFromDocs`: child overrides parent\n *\n * @internal — not exported from stratal/router\n */\nexport class RouterResolver {\n  private readonly routers: { router: Router; controllers: Constructor[] }[]\n\n  constructor(routers: { router: Router; controllers: Constructor[] }[]) {\n    this.routers = routers\n  }\n\n  /**\n   * Resolve the effective config for a given controller class.\n   * Searches through all module routers to find the one owning this controller.\n   */\n  resolveForController(controller: Constructor): ResolvedRouterConfig {\n    for (const { router, controllers: moduleControllers } of this.routers) {\n      if (!moduleControllers.includes(controller)) continue\n\n      // Check if controller is in a sub-group\n      for (const group of router[internal.getGroups]()) {\n        if (group.controllers?.includes(controller)) {\n          return this.mergeEntries(router[internal.getDefaultEntry](), group)\n        }\n      }\n\n      // Controller is in the default scope (not in any sub-group)\n      // But only if it's not claimed by any sub-group in this module\n      const groupedControllers = new Set(\n        router[internal.getGroups]().flatMap(g => g.controllers ?? [])\n      )\n      if (!groupedControllers.has(controller)) {\n        return this.entryToConfig(router[internal.getDefaultEntry]())\n      }\n    }\n\n    // Controller not found in any module's router — return empty config\n    return { middleware: [] }\n  }\n\n  /**\n   * Collect all global middleware registered via `router.use()` across all modules.\n   */\n  getGlobalMiddleware(): Constructor<Middleware>[] {\n    const global: Constructor<Middleware>[] = []\n    for (const { router } of this.routers) {\n      global.push(...router[internal.getGlobalMiddleware]())\n    }\n    return global\n  }\n\n  /**\n   * Merge parent default entry with child group entry following inheritance rules.\n   */\n  private mergeEntries(parent: RouterEntry, child: RouterEntry): ResolvedRouterConfig {\n    return {\n      // Concatenate: parent prefix + child prefix\n      prefix: this.concatPrefixes(parent.prefix, child.prefix),\n      // Override: child domain wins\n      domain: child.domain ?? parent.domain,\n      // Concatenate: parent name + child name\n      name: this.concatNames(parent.name, child.name),\n      // Concatenate: parent middleware first, then child\n      middleware: [...parent.middleware, ...child.middleware],\n      // Override: child version wins\n      version: child.version ?? parent.version,\n      // Override: child hideFromDocs wins\n      hideFromDocs: child.hideFromDocs ?? parent.hideFromDocs,\n      // Extend: parent params extended with child params\n      params: this.mergeParams(parent.params, child.params),\n    }\n  }\n\n  private entryToConfig(entry: RouterEntry): ResolvedRouterConfig {\n    return {\n      prefix: entry.prefix,\n      domain: entry.domain,\n      name: entry.name,\n      middleware: [...entry.middleware],\n      version: entry.version,\n      hideFromDocs: entry.hideFromDocs,\n      params: entry.params,\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  private mergeParams(parent?: ZodObject<any>, child?: ZodObject<any>): ZodObject<any> | undefined {\n    if (!parent && !child) return undefined\n    if (!parent) return child\n    if (!child) return parent\n    // oxlint-disable-next-line typescript/no-explicit-any\n    return parent.extend(child.shape) as ZodObject<any>\n  }\n\n  private concatPrefixes(parent?: string, child?: string): string | undefined {\n    if (!parent && !child) return undefined\n    if (!parent) return child\n    if (!child) return parent\n    // Normalize: remove trailing slash from parent, ensure child starts with /\n    const p = parent.endsWith('/') ? parent.slice(0, -1) : parent\n    const c = child.startsWith('/') ? child : `/${child}`\n    return `${p}${c}`\n  }\n\n  private concatNames(parent?: string, child?: string): string | undefined {\n    if (!parent && !child) return undefined\n    if (!parent) return child\n    if (!child) return parent\n    return `${parent}${child}`\n  }\n}\n","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 { runWithContainer } from './di/container-storage'\nimport { DI_TOKENS } from './di/tokens'\nimport { Scope } from './di/types'\nimport { type StratalEnv } from './env'\nimport { ApplicationError } from './errors'\nimport { DefaultExceptionHandler } from './errors/default-exception-handler'\nimport { createCliExceptionContext, createCronExceptionContext, createQueueExceptionContext } from './errors/exception-context'\nimport type { ExceptionHandler } from './errors/exception-handler'\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 { ApiCommand } from './quarry/commands/api.command'\nimport { EventListCommand } from './quarry/commands/event-list.command'\nimport { HelpCommand } from './quarry/commands/help.command'\nimport { McpServeCommand } from './quarry/commands/mcp-serve.command'\nimport { McpToolsCommand } from './quarry/commands/mcp-tools.command'\nimport { QueueListCommand } from './quarry/commands/queue-list.command'\nimport { RouteListCommand } from './quarry/commands/route-list.command'\nimport { RouteTypesCommand } from './quarry/commands/route-types.command'\nimport { ScheduleListCommand } from './quarry/commands/schedule-list.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 RouterContext } from './router'\nimport { HonoApp } from './router/hono-app'\nimport { RouteRegistry } from './router/route-registry'\nimport { RouterResolver } from './router/router-resolver'\nimport { ROUTER_TOKENS } from './router/router.tokens'\nimport { LocalePathService } from './router/services/locale-path.service'\nimport { RouteRegistrationService } from './router/services/route-registration.service'\nimport { VersioningService } from './router/services/versioning.service'\nimport type { TrailingSlashMode, VersioningOptions } from './router/types'\nimport { Uri } from './router/uri'\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   * Trailing-slash handling for incoming requests.\n   *\n   * Defaults to `'ignore'` — both `/foo` and `/foo/` resolve to the same route.\n   *\n   * - `'ignore'` — match both, no redirect.\n   * - `'always'` — non-trailing requests redirect (308) to the trailing-slash form.\n   * - `'never'`  — trailing requests redirect (308) to the non-trailing form.\n   */\n  trailingSlash?: TrailingSlashMode\n  /**\n   * Custom exception handler class.\n   *\n   * Extend {@link ExceptionHandler} and override `register()` to configure\n   * custom reporting, rendering, and post-processing of exceptions.\n   *\n   * When not provided, {@link DefaultExceptionHandler} is used (standard\n   * severity-based logging and JSON error responses).\n   *\n   * @example\n   * ```typescript\n   * new Stratal({\n   *   module: AppModule,\n   *   exceptionHandler: AppExceptionHandler,\n   * })\n   * ```\n   */\n  exceptionHandler?: Constructor<ExceptionHandler>\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  private routingInitPromise: Promise<void> | null = null\n  private handlerInitPromise: Promise<void> | null = null\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   * Lazily initialize routing and return the HonoApp instance.\n   *\n   * Routing (service registration, HonoApp resolution, route configuration)\n   * is deferred so that `scheduled` and `queue` handlers don't pay the CPU\n   * cost of route setup on cold start.\n   */\n  async ensureHono(): Promise<HonoApp> {\n    await this.initializeRouting()\n    return this.honoApp\n  }\n\n  /**\n   * Get the application configuration\n   */\n  get config(): ApplicationConfig {\n    return this.appConfig\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    // Wrap in AsyncLocalStorage so getContainer() works for route() and other standalone functions\n    await runWithContainer(this._container, () => this.initializeInternal())\n  }\n\n  private async initializeInternal(): Promise<void> {\n    // Phase 1: Register core infrastructure modules (internal)\n    // OpenAPIModule is deferred to initializeRouting() (only needed for fetch)\n    this.moduleRegistry.registerAll([\n      I18nModule,\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 3.5: Initialize ExceptionHandler and call module onException hooks\n    this.initializeExceptionHandler()\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: Register cron jobs, seeders, and commands (cheap — stores class refs)\n    // Queue consumers and event listeners are deferred (they resolve instances\n    // from the container, which is expensive). Routing is also deferred.\n    this.registerCronJobs()\n    this.registerSeeders()\n    this.registerCommands()\n\n    this.initialized = true\n  }\n\n  /**\n   * Register routing services as singletons in the container.\n   * Called after module initialization so I18N_TOKENS.Options is available.\n   */\n  private registerRoutingServices(): void {\n    // VersioningService — resolves version prefixes from appConfig.versioning\n    this._container.register(ROUTER_TOKENS.VersioningService, VersioningService, Scope.Singleton)\n\n    // HonoApp — the Hono application instance (must be before LocalePathService)\n    this._container.register(ROUTER_TOKENS.HonoApp, HonoApp, Scope.Singleton)\n\n    // LocalePathService — computes LocalePathConfig and applies locale middleware to HonoApp\n    this._container.register(ROUTER_TOKENS.LocalePathService, LocalePathService, Scope.Singleton)\n\n    // RouteRegistry — single source of truth, expands routes via services above\n    this._container.register(ROUTER_TOKENS.RouteRegistry, RouteRegistry, Scope.Singleton)\n\n    // Uri — URL generation service (request-scoped for access to RouterContext)\n    this._container.register(ROUTER_TOKENS.Uri, Uri, Scope.Request)\n\n    // RouterResolver — merges Router configs from modules\n    const routerConfigs = this.moduleRegistry.getAllRouterConfigs()\n    const routerResolver = routerConfigs.length > 0 ? new RouterResolver(routerConfigs) : null\n    this._container.registerValue(ROUTER_TOKENS.RouterResolver, routerResolver)\n\n    // RouteRegistrationService — transient, resolved in HonoApp.configure()\n    this._container.register(RouteRegistrationService, RouteRegistrationService)\n  }\n\n  /**\n   * Wire up queue consumers and event listeners.\n   * Called lazily on first fetch/queue — not during scheduled handling.\n   */\n  private initializeHandlers(): Promise<void> {\n    this.handlerInitPromise ??= runWithContainer(this._container, () => {\n      this.registerQueueConsumers()\n      this.registerEventListeners()\n      return Promise.resolve()\n    })\n    return this.handlerInitPromise\n  }\n\n  /**\n   * Register routing services, resolve HonoApp, and configure routes.\n   * Called lazily on first fetch — not during scheduled/queue handling.\n   */\n  private initializeRouting(): Promise<void> {\n    this.routingInitPromise ??= runWithContainer(this._container, async () => {\n      await this.initializeHandlers()\n      this.moduleRegistry.register(OpenAPIModule as unknown as ModuleClass)\n      this.registerRoutingServices()\n      this.honoApp = this._container.resolve<HonoApp>(ROUTER_TOKENS.HonoApp)\n      await this.honoApp.configure()\n    })\n    return this.routingInitPromise\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 handler = this._container.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n      const ctx = createCliExceptionContext('resolve')\n      // Fire-and-forget — reporting happens via waitUntil internally\n      void handler.handle(error, ctx)\n      throw error\n    }\n  }\n\n  /**\n   * Handle queue batch processing\n   */\n  async handleQueue(batch: MessageBatch, queueName: string): Promise<void> {\n    await this.initializeHandlers()\n\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 handler = requestContainer.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n        await handler.handle(error, createQueueExceptionContext(queueName))\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, requestContainer)\n      } catch (error) {\n        const handler = requestContainer.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n        await handler.handle(error, createCronExceptionContext())\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    await this.initializeRouting()\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 commands (always available)\n    const builtinCommands: Constructor<Command>[] = [\n      HelpCommand,\n      DbSeedCommand, DbSeedListCommand,\n      RouteListCommand, RouteTypesCommand, EventListCommand,\n      ScheduleListCommand, QueueListCommand,\n      McpServeCommand, McpToolsCommand, ApiCommand,\n    ]\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      // Resolve temporarily to read the schedule property.\n      // The delay() proxy on DB dependencies is created but never triggered\n      // since we only access the schedule string.\n      const tempJob = this._container.resolve(JobClass) as CronJob\n      this.cronManager.registerJob(tempJob.schedule, JobClass as Constructor<CronJob>)\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.registerSingleton(\n      DI_TOKENS.ExceptionHandler,\n      (this.appConfig.exceptionHandler ?? DefaultExceptionHandler) as Constructor,\n    )\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  /**\n   * Initialize the ExceptionHandler: call register(), then module onException hooks.\n   */\n  private initializeExceptionHandler(): void {\n    const handler = this._container.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n    handler.register()\n    this.moduleRegistry.configureExceptionHandlers(handler)\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  private static _generation = 0\n  private static _previousInstance: Stratal | 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    // Invalidate any in-flight initialization from a previous instance (Vite HMR reload)\n    const generation = ++Stratal._generation\n\n    if (Stratal._previousInstance) {\n      void Stratal._previousInstance.shutdown()\n    }\n    Stratal._previousInstance = this\n\n    this.initPromise = this.prepareApp(config, generation)\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    const hono = await app.ensureHono()\n    return 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.ensureHono())\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, generation: number): Promise<Application> {\n    const { env, waitUntil } = await import('cloudflare:workers')\n\n    // After async import, check if a newer instance has replaced us (Vite HMR reload)\n    if (generation !== Stratal._generation) {\n      return new Promise<Application>(() => {\n        //\n      }) // Never resolves — avoids cross-request promise warning\n    }\n\n    const app = new Application({ ...config, env: env as Env, ctx: { waitUntil } })\n    await app.initialize()\n\n    // Check again after initialization completes\n    if (generation !== Stratal._generation) {\n      await app.shutdown()\n      return new Promise<Application>(() => {\n        //\n      })\n    }\n\n    return app\n  }\n}\n"],"mappings":"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"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"usage-generator-BUdlhnCK.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":"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"}