stratal 0.0.17 → 0.0.19

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

@@ -0,0 +1 @@
+{"version":3,"file":"quarry-registry-DFfRRkA7.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/index.d.mts

@@ -1,3 +1,3 @@
-import { n as IQueueConsumer, r as QueueMessage, t as ConsumerRegistry } from "../consumer-registry-Bymm6ff4.mjs";
-import { _ as QueueNames, a as InjectQueue, c as QueueModule, d as SyncQueueProvider, f as CloudflareQueueProvider, g as QueueName, h as IQueueSender, i as QueueToken, l as QueueModuleOptions, m as DispatchMessage, n as QueueBindingNotFoundError, o as QueueRegistry, p as IQueueProvider, r as QUEUE_TOKENS, s as QueueProviderFactory, t as QueueProviderNotSupportedError, u as QueueSender, v as QueueManager } from "../index-DGRe6Yoa.mjs";
+import { n as IQueueConsumer, r as QueueMessage, t as ConsumerRegistry } from "../consumer-registry-Doom7BEh.mjs";
+import { _ as QueueNames, a as InjectQueue, c as QueueModule, d as SyncQueueProvider, f as CloudflareQueueProvider, g as QueueName, h as IQueueSender, i as QueueToken, l as QueueModuleOptions, m as DispatchMessage, n as QueueBindingNotFoundError, o as QueueRegistry, p as IQueueProvider, r as QUEUE_TOKENS, s as QueueProviderFactory, t as QueueProviderNotSupportedError, u as QueueSender, v as QueueManager } from "../index-Dnqm9ZB6.mjs";
 export { CloudflareQueueProvider, ConsumerRegistry, DispatchMessage, IQueueConsumer, IQueueProvider, IQueueSender, InjectQueue, QUEUE_TOKENS, QueueBindingNotFoundError, QueueManager, QueueMessage, QueueModule, QueueModuleOptions, QueueName, QueueNames, QueueProviderFactory, QueueProviderNotSupportedError, QueueRegistry, QueueSender, QueueToken, SyncQueueProvider };

package/dist/queue/index.mjs

@@ -1,17 +1,7 @@
-import "../errors-DSKapqD8.mjs";
-import { a as __decorate, d as Transient, g as DI_TOKENS, o as __decorateParam, s as __decorateMetadata } from "../logger-CGT91VY6.mjs";
-import "../module-tUtyVJ5E.mjs";
-import "../events-CvUSgEuN.mjs";
-import "../middleware-Bl-b5pkt.mjs";
-import "../router-context-D9R1v2Ac.mjs";
-import "../colors-Y7WIFXs7.mjs";
-import "../command-B1CPgsrU.mjs";
-import "../is-command-DJVI6wEJ.mjs";
-import "../is-seeder-D5MIEcdz.mjs";
-import { a as CloudflareQueueProvider, c as QUEUE_TOKENS, i as SyncQueueProvider, l as QueueSender, n as QueueRegistry, o as QueueProviderNotSupportedError, r as QueueProviderFactory, s as QueueBindingNotFoundError, t as QueueModule, u as ConsumerRegistry } from "../queue.module-BtI8f4Jo.mjs";
+import { a as __decorate, f as DI_TOKENS, o as __decorateParam, p as Transient, s as __decorateMetadata } from "../logger-V6Ms3QnQ.mjs";
+import { a as QueueProviderNotSupportedError, c as QUEUE_TOKENS, i as CloudflareQueueProvider, l as QueueSender, n as QueueProviderFactory, o as QueueBindingNotFoundError, r as SyncQueueProvider, s as QueueRegistry, t as QueueModule, u as ConsumerRegistry } from "../queue.module-P-G-nCYz.mjs";
 import { inject } from "tsyringe";
 //#region src/queue/queue-manager.ts
-var _ref;
 let QueueManager = class QueueManager {
 	constructor(registry) {
 		this.registry = registry;
@@ -43,7 +33,7 @@ let QueueManager = class QueueManager {
 QueueManager = __decorate([
 	Transient(DI_TOKENS.Queue),
 	__decorateParam(0, inject(DI_TOKENS.ConsumerRegistry)),
-	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref : Object])
+	__decorateMetadata("design:paramtypes", [Object])
 ], QueueManager);
 //#endregion
 //#region src/queue/decorators/inject-queue.decorator.ts

package/dist/queue/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/queue/queue-manager.ts","../../src/queue/decorators/inject-queue.decorator.ts"],"sourcesContent":["import { inject } from 'tsyringe'\nimport { Transient } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport { ConsumerRegistry } from './consumer-registry'\nimport type { QueueMessage } from './queue-consumer'\n\n/**\n * Queue Manager\n *\n * Singleton service for processing queue message batches.\n * Routes messages to consumers based on message type.\n *\n * **Message Routing:**\n * - Consumers declare message types they handle (e.g., ['email.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 *\n * **Note:** For sending messages to queues, use IQueueSender instances\n * obtained via @InjectQueue('queue-name') or module bindings.\n *\n * @example Processing a queue batch\n * ```typescript\n * // In Cloudflare Worker queue handler\n * await queueManager.processBatch('notifications-queue', batch)\n * ```\n */\n@Transient(DI_TOKENS.Queue)\nexport class QueueManager {\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry\n  ) {}\n\n  /**\n   * Process a batch of queue messages\n   *\n   * Routes messages to registered consumers based on message type.\n   * Uses ConsumerRegistry to find matching consumers.\n   *\n   * @param _queueName - Name of the queue (for logging, not used for routing)\n   * @param batch - Batch of messages from Cloudflare Queue\n   */\n  async processBatch(_queueName: string, batch: MessageBatch): Promise<void> {\n    for (const message of batch.messages) {\n      const queueMessage = message.body as QueueMessage\n\n      // Find consumers by message type (not by queue name)\n      const consumers = this.registry.getConsumers(queueMessage.type)\n\n      for (const consumer of consumers) {\n        try {\n          await consumer.handle(queueMessage)\n          message.ack()\n        } catch (error) {\n          const errorInstance = error instanceof Error\n            ? error\n            : new Error(String(error))\n\n          if (consumer.onError) {\n            await consumer.onError(errorInstance, queueMessage)\n          }\n          message.retry()\n        }\n      }\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport type { QueueName } from '../queue-name'\n\n/**\n * Inject a queue sender by name.\n *\n * Queue names are typed via module augmentation of QueueNames interface.\n * The queue name serves as both the identifier and the DI injection token.\n *\n * @param name - Queue name (typed with autocomplete if QueueNames is augmented)\n * @returns Parameter decorator for constructor injection\n *\n * @example\n * ```typescript\n * // Direct injection by queue name\n * constructor(\n *   @InjectQueue('notifications-queue') private queue: IQueueSender\n * ) {}\n *\n * // Usage\n * await this.queue.dispatch({\n *   type: 'email.send',\n *   payload: { to: 'user@example.com', subject: 'Hello' }\n * })\n * ```\n *\n * @remarks\n * The queue must be registered via `QueueModule.registerQueue(name)` before injection.\n * For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with\n * `useExisting` provider binding instead.\n */\nexport function InjectQueue(name: QueueName): ParameterDecorator {\n  return inject(name)\n}\n"],"mappings":";;;;;;;;;;;;;;AA2BO,IAAA,eAAA,MAAM,aAAa;CACxB,YACE,UACA;AADqD,OAAA,WAAA;;;;;;;;;;;CAYvD,MAAM,aAAa,YAAoB,OAAoC;AACzE,OAAK,MAAM,WAAW,MAAM,UAAU;GACpC,MAAM,eAAe,QAAQ;GAG7B,MAAM,YAAY,KAAK,SAAS,aAAa,aAAa,KAAK;AAE/D,QAAK,MAAM,YAAY,UACrB,KAAI;AACF,UAAM,SAAS,OAAO,aAAa;AACnC,YAAQ,KAAK;YACN,OAAO;IACd,MAAM,gBAAgB,iBAAiB,QACnC,QACA,IAAI,MAAM,OAAO,MAAM,CAAC;AAE5B,QAAI,SAAS,QACX,OAAM,SAAS,QAAQ,eAAe,aAAa;AAErD,YAAQ,OAAO;;;;;;CAlCxB,UAAU,UAAU,MAAM;oBAGtB,OAAO,UAAU,iBAAiB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACEvC,SAAgB,YAAY,MAAqC;AAC/D,QAAO,OAAO,KAAK"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/queue/queue-manager.ts","../../src/queue/decorators/inject-queue.decorator.ts"],"sourcesContent":["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'\n\n/**\n * Queue Manager\n *\n * Singleton service for processing queue message batches.\n * Routes messages to consumers based on message type.\n *\n * **Message Routing:**\n * - Consumers declare message types they handle (e.g., ['email.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 *\n * **Note:** For sending messages to queues, use IQueueSender instances\n * obtained via @InjectQueue('queue-name') or module bindings.\n *\n * @example Processing a queue batch\n * ```typescript\n * // In Cloudflare Worker queue handler\n * await queueManager.processBatch('notifications-queue', batch)\n * ```\n */\n@Transient(DI_TOKENS.Queue)\nexport class QueueManager {\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry\n  ) {}\n\n  /**\n   * Process a batch of queue messages\n   *\n   * Routes messages to registered consumers based on message type.\n   * Uses ConsumerRegistry to find matching consumers.\n   *\n   * @param _queueName - Name of the queue (for logging, not used for routing)\n   * @param batch - Batch of messages from Cloudflare Queue\n   */\n  async processBatch(_queueName: string, batch: MessageBatch): Promise<void> {\n    for (const message of batch.messages) {\n      const queueMessage = message.body as QueueMessage\n\n      // Find consumers by message type (not by queue name)\n      const consumers = this.registry.getConsumers(queueMessage.type)\n\n      for (const consumer of consumers) {\n        try {\n          await consumer.handle(queueMessage)\n          message.ack()\n        } catch (error) {\n          const errorInstance = error instanceof Error\n            ? error\n            : new Error(String(error))\n\n          if (consumer.onError) {\n            await consumer.onError(errorInstance, queueMessage)\n          }\n          message.retry()\n        }\n      }\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport type { QueueName } from '../queue-name'\n\n/**\n * Inject a queue sender by name.\n *\n * Queue names are typed via module augmentation of QueueNames interface.\n * The queue name serves as both the identifier and the DI injection token.\n *\n * @param name - Queue name (typed with autocomplete if QueueNames is augmented)\n * @returns Parameter decorator for constructor injection\n *\n * @example\n * ```typescript\n * // Direct injection by queue name\n * constructor(\n *   @InjectQueue('notifications-queue') private queue: IQueueSender\n * ) {}\n *\n * // Usage\n * await this.queue.dispatch({\n *   type: 'email.send',\n *   payload: { to: 'user@example.com', subject: 'Hello' }\n * })\n * ```\n *\n * @remarks\n * The queue must be registered via `QueueModule.registerQueue(name)` before injection.\n * For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with\n * `useExisting` provider binding instead.\n */\nexport function InjectQueue(name: QueueName): ParameterDecorator {\n  return inject(name)\n}\n"],"mappings":";;;;AA2BO,IAAA,eAAA,MAAM,aAAa;CACxB,YACE,UACA;AADqD,OAAA,WAAA;;;;;;;;;;;CAYvD,MAAM,aAAa,YAAoB,OAAoC;AACzE,OAAK,MAAM,WAAW,MAAM,UAAU;GACpC,MAAM,eAAe,QAAQ;GAG7B,MAAM,YAAY,KAAK,SAAS,aAAa,aAAa,KAAK;AAE/D,QAAK,MAAM,YAAY,UACrB,KAAI;AACF,UAAM,SAAS,OAAO,aAAa;AACnC,YAAQ,KAAK;YACN,OAAO;IACd,MAAM,gBAAgB,iBAAiB,QACnC,QACA,IAAI,MAAM,OAAO,MAAM,CAAC;AAE5B,QAAI,SAAS,QACX,OAAM,SAAS,QAAQ,eAAe,aAAa;AAErD,YAAQ,OAAO;;;;;;CAlCxB,UAAU,UAAU,MAAM;oBAGtB,OAAO,UAAU,iBAAiB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACEvC,SAAgB,YAAY,MAAqC;AAC/D,QAAO,OAAO,KAAK"}

package/dist/{queue.module-BtI8f4Jo.mjs → queue.module-P-G-nCYz.mjs}

@@ -1,6 +1,6 @@
-import { S as ApplicationError, b as ERROR_CODES, o as I18N_TOKENS, s as Scope } from "./errors-DSKapqD8.mjs";
-import { a as __decorate, d as Transient, g as DI_TOKENS, o as __decorateParam, s as __decorateMetadata } from "./logger-CGT91VY6.mjs";
-import { r as Module } from "./module-tUtyVJ5E.mjs";
+import { A as Scope, H as ApplicationError, k as ERROR_CODES, w as I18N_TOKENS } from "./errors-B4pYgYON.mjs";
+import { a as __decorate, f as DI_TOKENS, o as __decorateParam, p as Transient, s as __decorateMetadata } from "./logger-V6Ms3QnQ.mjs";
+import { C as Module } from "./module-qGE_1duv.mjs";
 import { inject } from "tsyringe";
 //#region src/queue/consumer-registry.ts
 let ConsumerRegistry = class ConsumerRegistry {
@@ -125,6 +125,38 @@ const QUEUE_TOKENS = {
 	QueueModuleOptions: Symbol.for("stratal:queue:options")
 };
 //#endregion
+//#region src/queue/queue-registry.ts
+let QueueRegistry = class QueueRegistry {
+	provider;
+	senders = /* @__PURE__ */ new Map();
+	constructor(providerFactory, i18n) {
+		this.i18n = i18n;
+		this.provider = providerFactory.create();
+	}
+	/**
+	* Get or create a QueueSender for the specified queue name.
+	*
+	* Senders are cached per queue name within the request scope.
+	*
+	* @param queueName - The queue name to get a sender for
+	* @returns QueueSender bound to the specified queue
+	*/
+	getQueue(queueName) {
+		let sender = this.senders.get(queueName);
+		if (!sender) {
+			sender = new QueueSender(queueName, this.provider, this.i18n);
+			this.senders.set(queueName, sender);
+		}
+		return sender;
+	}
+};
+QueueRegistry = __decorate([
+	Transient(QUEUE_TOKENS.QueueRegistry),
+	__decorateParam(0, inject(QUEUE_TOKENS.QueueProviderFactory)),
+	__decorateParam(1, inject(I18N_TOKENS.I18nService)),
+	__decorateMetadata("design:paramtypes", [Object, Object])
+], QueueRegistry);
+//#endregion
 //#region src/queue/errors/queue-binding-not-found.error.ts
 /**
 * QueueBindingNotFoundError
@@ -195,7 +227,6 @@ CloudflareQueueProvider = __decorate([
 ], CloudflareQueueProvider);
 //#endregion
 //#region src/queue/providers/sync-queue.provider.ts
-var _ref$2;
 let SyncQueueProvider = class SyncQueueProvider {
 	constructor(registry) {
 		this.registry = registry;
@@ -224,11 +255,10 @@ let SyncQueueProvider = class SyncQueueProvider {
 SyncQueueProvider = __decorate([
 	Transient(),
 	__decorateParam(0, inject(DI_TOKENS.ConsumerRegistry)),
-	__decorateMetadata("design:paramtypes", [typeof (_ref$2 = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref$2 : Object])
+	__decorateMetadata("design:paramtypes", [Object])
 ], SyncQueueProvider);
 //#endregion
 //#region src/queue/services/queue-provider-factory.ts
-var _ref$1;
 let QueueProviderFactory = class QueueProviderFactory {
 	constructor(env, registry, options) {
 		this.env = env;
@@ -257,44 +287,11 @@ QueueProviderFactory = __decorate([
 	__decorateParam(2, inject(QUEUE_TOKENS.QueueModuleOptions, { isOptional: true })),
 	__decorateMetadata("design:paramtypes", [
 		Object,
-		typeof (_ref$1 = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref$1 : Object,
+		Object,
 		Object
 	])
 ], QueueProviderFactory);
 //#endregion
-//#region src/queue/queue-registry.ts
-var _ref;
-let QueueRegistry = class QueueRegistry {
-	provider;
-	senders = /* @__PURE__ */ new Map();
-	constructor(providerFactory, i18n) {
-		this.i18n = i18n;
-		this.provider = providerFactory.create();
-	}
-	/**
-	* Get or create a QueueSender for the specified queue name.
-	*
-	* Senders are cached per queue name within the request scope.
-	*
-	* @param queueName - The queue name to get a sender for
-	* @returns QueueSender bound to the specified queue
-	*/
-	getQueue(queueName) {
-		let sender = this.senders.get(queueName);
-		if (!sender) {
-			sender = new QueueSender(queueName, this.provider, this.i18n);
-			this.senders.set(queueName, sender);
-		}
-		return sender;
-	}
-};
-QueueRegistry = __decorate([
-	Transient(QUEUE_TOKENS.QueueRegistry),
-	__decorateParam(0, inject(QUEUE_TOKENS.QueueProviderFactory)),
-	__decorateParam(1, inject(I18N_TOKENS.I18nService)),
-	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof QueueProviderFactory !== "undefined" && QueueProviderFactory) === "function" ? _ref : Object, Object])
-], QueueRegistry);
-//#endregion
 //#region src/queue/queue.module.ts
 /**
 * Queue Module
@@ -398,6 +395,6 @@ QueueModule = _QueueModule = __decorate([Module({ providers: [
 	}
 ] })], QueueModule);
 //#endregion
-export { CloudflareQueueProvider as a, QUEUE_TOKENS as c, SyncQueueProvider as i, QueueSender as l, QueueRegistry as n, QueueProviderNotSupportedError as o, QueueProviderFactory as r, QueueBindingNotFoundError as s, QueueModule as t, ConsumerRegistry as u };
+export { QueueProviderNotSupportedError as a, QUEUE_TOKENS as c, CloudflareQueueProvider as i, QueueSender as l, QueueProviderFactory as n, QueueBindingNotFoundError as o, SyncQueueProvider as r, QueueRegistry as s, QueueModule as t, ConsumerRegistry as u };
 
-//# sourceMappingURL=queue.module-BtI8f4Jo.mjs.map
+//# sourceMappingURL=queue.module-P-G-nCYz.mjs.map

package/dist/queue.module-P-G-nCYz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module-P-G-nCYz.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-LdzK9tfG.mjs

@@ -0,0 +1,244 @@
+import { t as __exportAll } from "./chunk-D1SwGrFN.mjs";
+import { t as signUrl } from "./signed-url-COX7cCWR.mjs";
+import { n as R2PresignedUrlSecretMissingError, t as StorageResponseBodyMissingError } from "./errors-BUyUfr2Z.mjs";
+//#region src/storage/providers/r2-storage.provider.ts
+var r2_storage_provider_exports = /* @__PURE__ */ __exportAll({ R2StorageProvider: () => R2StorageProvider });
+const MIN_PART_SIZE = 5 * 1024 * 1024;
+const MULTIPART_PREFIX = "__multipart/";
+const PARTS_PREFIX = "__parts/";
+/**
+* R2 Storage Provider
+* Implements storage operations using native Cloudflare R2 bindings
+*
+* Implements IMultipartProvider for multipart upload support needed by TUS.
+* Tracks multipart upload metadata using companion R2 objects so that
+* listParts/listMultipartUploads work in all environments (local, test, prod).
+*/
+var R2StorageProvider = class {
+	routeBasePath;
+	constructor(config, bucket, env, routeConfig) {
+		this.config = config;
+		this.bucket = bucket;
+		this.env = env;
+		this.routeBasePath = routeConfig?.basePath ?? "/storage";
+	}
+	async upload(body, path, options) {
+		const customMetadata = { ...options.metadata };
+		if (options.tagging) customMetadata["x-tags"] = options.tagging;
+		await this.bucket.put(path, body, {
+			httpMetadata: { contentType: options.mimeType },
+			customMetadata
+		});
+		return {
+			path,
+			disk: this.config.disk,
+			fullPath: path,
+			size: options.size,
+			mimeType: options.mimeType ?? "application/octet-stream",
+			uploadedAt: /* @__PURE__ */ new Date()
+		};
+	}
+	async download(path) {
+		const obj = await this.bucket.get(path);
+		if (!obj) throw new StorageResponseBodyMissingError(path);
+		const objBody = obj;
+		return {
+			toStream: () => objBody.body,
+			contentType: obj.httpMetadata?.contentType ?? "application/octet-stream",
+			size: obj.size,
+			metadata: obj.customMetadata,
+			toString: () => objBody.text(),
+			toArrayBuffer: () => objBody.bytes()
+		};
+	}
+	async delete(path) {
+		await this.bucket.delete(path);
+	}
+	async exists(path) {
+		return await this.bucket.head(path) !== null;
+	}
+	async getPresignedUrl(path, method, expiresIn) {
+		const secret = this.env.APP_SECRET;
+		if (!secret) throw new R2PresignedUrlSecretMissingError();
+		return {
+			url: await signUrl(`${`${this.routeBasePath}/${this.config.disk}/${path}`}?method=${method}`, secret, { expiresIn }),
+			expiresIn,
+			expiresAt: new Date(Date.now() + expiresIn * 1e3),
+			method
+		};
+	}
+	async chunkedUpload(body, path, options) {
+		const multipartUpload = await this.bucket.createMultipartUpload(path, {
+			httpMetadata: { contentType: options.mimeType },
+			customMetadata: options.metadata
+		});
+		const parts = [];
+		try {
+			if (body instanceof ReadableStream) {
+				const reader = body.getReader();
+				let buffer = new Uint8Array(0);
+				let partNumber = 1;
+				while (true) {
+					const { done, value } = await reader.read();
+					if (value) {
+						const newBuffer = new Uint8Array(buffer.length + value.length);
+						newBuffer.set(buffer, 0);
+						newBuffer.set(value, buffer.length);
+						buffer = newBuffer;
+					}
+					while (buffer.length >= MIN_PART_SIZE) {
+						const partData = buffer.slice(0, MIN_PART_SIZE);
+						buffer = buffer.slice(MIN_PART_SIZE);
+						const part = await multipartUpload.uploadPart(partNumber, partData);
+						parts.push(part);
+						partNumber++;
+					}
+					if (done) {
+						if (buffer.length > 0) {
+							const part = await multipartUpload.uploadPart(partNumber, buffer);
+							parts.push(part);
+						}
+						break;
+					}
+				}
+			} else if (body !== null && body !== void 0) {
+				const part = await multipartUpload.uploadPart(1, body);
+				parts.push(part);
+			}
+			await multipartUpload.complete(parts);
+		} catch (error) {
+			await multipartUpload.abort();
+			throw error;
+		}
+		const headResult = await this.bucket.head(path);
+		return {
+			path,
+			disk: this.config.disk,
+			fullPath: path,
+			size: headResult?.size ?? options.size ?? 0,
+			mimeType: options.mimeType ?? "application/octet-stream",
+			uploadedAt: /* @__PURE__ */ new Date()
+		};
+	}
+	getBucket() {
+		return this.config.binding;
+	}
+	async headObject(key) {
+		const obj = await this.bucket.head(key);
+		if (!obj) return null;
+		return {
+			size: obj.size,
+			contentType: obj.httpMetadata?.contentType,
+			metadata: obj.customMetadata
+		};
+	}
+	async deleteObjects(keys) {
+		if (keys.length === 0) return {
+			deleted: 0,
+			errors: []
+		};
+		await this.bucket.delete(keys);
+		return {
+			deleted: keys.length,
+			errors: []
+		};
+	}
+	async createMultipartUpload(key, options) {
+		const upload = await this.bucket.createMultipartUpload(key, {
+			httpMetadata: {
+				contentType: options?.contentType,
+				cacheControl: options?.cacheControl
+			},
+			customMetadata: options?.metadata
+		});
+		await this.bucket.put(`${MULTIPART_PREFIX}${upload.uploadId}.json`, JSON.stringify({
+			key: upload.key,
+			uploadId: upload.uploadId,
+			initiated: (/* @__PURE__ */ new Date()).toISOString()
+		}), { httpMetadata: { contentType: "application/json" } });
+		return {
+			uploadId: upload.uploadId,
+			key: upload.key
+		};
+	}
+	async uploadPart(key, uploadId, partNumber, body) {
+		const part = await this.bucket.resumeMultipartUpload(key, uploadId).uploadPart(partNumber, body);
+		await this.bucket.put(`${PARTS_PREFIX}${uploadId}/${partNumber}`, JSON.stringify({
+			partNumber: part.partNumber,
+			etag: part.etag,
+			size: body.length
+		}), { httpMetadata: { contentType: "application/json" } });
+		return {
+			etag: part.etag,
+			partNumber: part.partNumber
+		};
+	}
+	async completeMultipartUpload(key, uploadId, parts) {
+		const result = await this.bucket.resumeMultipartUpload(key, uploadId).complete(parts.map((p) => ({
+			partNumber: p.partNumber,
+			etag: p.etag
+		})));
+		await this.cleanupTrackingObjects(uploadId);
+		return { key: result.key };
+	}
+	async abortMultipartUpload(key, uploadId) {
+		await this.bucket.resumeMultipartUpload(key, uploadId).abort();
+		await this.cleanupTrackingObjects(uploadId);
+	}
+	async listParts(_key, uploadId, partNumberMarker) {
+		const prefix = `${PARTS_PREFIX}${uploadId}/`;
+		const listed = await this.bucket.list({
+			prefix,
+			cursor: partNumberMarker
+		});
+		return {
+			parts: (await Promise.all(listed.objects.map(async (obj) => {
+				const data = await this.bucket.get(obj.key);
+				if (!data) return null;
+				return JSON.parse(await data.text());
+			}))).filter((p) => p !== null).sort((a, b) => a.partNumber - b.partNumber),
+			isTruncated: listed.truncated,
+			nextPartNumberMarker: listed.truncated ? listed.cursor : void 0
+		};
+	}
+	async listMultipartUploads(keyMarker, _uploadIdMarker) {
+		const listed = await this.bucket.list({
+			prefix: MULTIPART_PREFIX,
+			cursor: keyMarker
+		});
+		return {
+			uploads: (await Promise.all(listed.objects.map(async (obj) => {
+				const data = await this.bucket.get(obj.key);
+				if (!data) return null;
+				const parsed = JSON.parse(await data.text());
+				return {
+					key: parsed.key,
+					uploadId: parsed.uploadId,
+					initiated: new Date(parsed.initiated)
+				};
+			}))).filter((u) => u !== null),
+			isTruncated: listed.truncated,
+			nextKeyMarker: listed.truncated ? listed.cursor : void 0,
+			nextUploadIdMarker: void 0
+		};
+	}
+	async cleanupTrackingObjects(uploadId) {
+		const partsPrefix = `${PARTS_PREFIX}${uploadId}/`;
+		let cursor;
+		const keysToDelete = [];
+		do {
+			const listed = await this.bucket.list({
+				prefix: partsPrefix,
+				cursor
+			});
+			for (const obj of listed.objects) keysToDelete.push(obj.key);
+			cursor = listed.truncated ? listed.cursor : void 0;
+		} while (cursor);
+		keysToDelete.push(`${MULTIPART_PREFIX}${uploadId}.json`);
+		if (keysToDelete.length > 0) await this.bucket.delete(keysToDelete);
+	}
+};
+//#endregion
+export { r2_storage_provider_exports as n, R2StorageProvider as t };
+
+//# sourceMappingURL=r2-storage.provider-LdzK9tfG.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"r2-storage.provider-LdzK9tfG.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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"}