stratal 0.0.13 → 0.0.15

package/dist/quarry/index.d.mts

@@ -0,0 +1,112 @@
+import { $t as Container } from "../index-D69rxo8H.mjs";
+import { t as Constructor } from "../types-Cu4jkeiH.mjs";
+import { a as ParsedOption, i as ParsedArgument, o as ParsedSignature, r as CommandResult, s as Quarry, t as CommandInput } from "../types-N84Ak6YT.mjs";
+import { t as Command } from "../command-DcebcSrL.mjs";
+
+//#region src/quarry/errors/command-not-found.error.d.ts
+/**
+ * Thrown when a command is not found in the Quarry registry.
+ */
+declare class CommandNotFoundError extends Error {
+  constructor(name: string);
+}
+//#endregion
+//#region src/quarry/errors/command.error.d.ts
+/**
+ * User-facing command error with a plain English message.
+ *
+ * Quarry catches this in `call()` and puts the message into `CommandResult.errors`.
+ * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).
+ * Not routed through GlobalErrorHandler.
+ */
+declare class CommandError extends Error {
+  constructor(message: string);
+}
+//#endregion
+//#region src/quarry/is-command.d.ts
+/**
+ * Check if a class is a Command (extends Command base class).
+ *
+ * Used by ModuleRegistry for auto-discovery from providers.
+ */
+declare function isCommand(target: Constructor): boolean;
+//#endregion
+//#region src/quarry/quarry-registry.d.ts
+/**
+ * QuarryRegistry — edge-compatible programmatic API for running commands.
+ *
+ * Registered as a singleton via DI_TOKENS.Quarry.
+ * Commands are auto-discovered from module providers and registered at bootstrap.
+ * Command constructors are stored at bootstrap; fresh instances are resolved per `call()`.
+ *
+ * Users should inject and type as `Quarry` (the interface), which only exposes `call()`.
+ */
+declare class QuarryRegistry implements Quarry {
+  private readonly container;
+  private commands;
+  private signatures;
+  private aliases;
+  constructor(container: Container);
+  /**
+   * Execute a command by name with optional flat input.
+   * A fresh command instance is resolved from the container per invocation.
+   */
+  call(name: string, input?: CommandInput): Promise<CommandResult>;
+  /**
+   * Check if a command exists by name or alias.
+   */
+  has(name: string): boolean;
+  /**
+   * Get a command constructor by name or alias.
+   */
+  get(name: string): Constructor<Command> | undefined;
+  /**
+   * Get all registered command constructors.
+   */
+  all(): Map<string, Constructor<Command>>;
+  /**
+   * List all commands with their descriptions and aliases.
+   */
+  list(): {
+    name: string;
+    description?: string;
+    aliases: string[];
+  }[];
+  /**
+   * Get auto-generated usage text for a command.
+   */
+  usage(name: string): Promise<string>;
+  /**
+   * Register a command constructor with the registry.
+   * @internal Called by Application during bootstrap.
+   */
+  register(commandClass: Constructor<Command>): void;
+  private handleError;
+  private resolveName;
+  private applyDefaults;
+}
+//#endregion
+//#region src/quarry/signature-parser.d.ts
+/**
+ * Parse a Laravel-style command signature string.
+ *
+ * Signature syntax:
+ *   command-name {arg} ...              — flat command
+ *   group subcommand {arg} ...          — subcommand hierarchy (space-separated)
+ *   namespace:command {arg} ...         — namespaced flat command (colon-separated)
+ *   {--flag} {--name=} {--name=default} {--name=*} {--A|name} {--name= : desc}
+ *
+ * Pure function, zero dependencies, edge-compatible.
+ */
+declare function parseSignature(signature: string): ParsedSignature;
+//#endregion
+//#region src/quarry/usage-generator.d.ts
+/**
+ * Generate formatted help/usage text from a parsed signature.
+ *
+ * Pure function, edge-compatible.
+ */
+declare function generateUsage(signature: ParsedSignature, description?: string): string;
+//#endregion
+export { Command, CommandError, type CommandInput, CommandNotFoundError, type CommandResult, type ParsedArgument, type ParsedOption, type ParsedSignature, type Quarry, QuarryRegistry, generateUsage, isCommand, parseSignature };
+//# sourceMappingURL=index.d.mts.map

package/dist/quarry/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/quarry/errors/command-not-found.error.ts","../../src/quarry/errors/command.error.ts","../../src/quarry/is-command.ts","../../src/quarry/quarry-registry.ts","../../src/quarry/signature-parser.ts","../../src/quarry/usage-generator.ts"],"mappings":";;;;;;;;;cAGa,oBAAA,SAA6B,KAAA;cAC5B,IAAA;AAAA;;;;;;;;;;cCGD,YAAA,SAAqB,KAAA;cACpB,OAAA;AAAA;;;;;;;;iBCAE,SAAA,CAAU,MAAA,EAAQ,WAAA;;;;;;AFLlC;;;;;;cGoBa,cAAA,YAA0B,MAAA;EAAA,iBAKqB,SAAA;EAAA,QAJlD,QAAA;EAAA,QACA,UAAA;EAAA,QACA,OAAA;cAEkD,SAAA,EAAW,SAAA;EFrB1D;;;;EE2BL,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;;;;EAiExD,GAAA,CAAI,IAAA;;;;EAQJ,GAAA,CAAI,IAAA,WAAe,WAAA,CAAY,OAAA;EDnGR;;;EC2GvB,GAAA,CAAA,GAAO,GAAA,SAAY,WAAA,CAAY,OAAA;;;;EAO/B,IAAA,CAAA;IAAU,IAAA;IAAc,WAAA;IAAsB,OAAA;EAAA;EAxFU;;;EAkHlD,KAAA,CAAM,IAAA,WAAe,OAAA;EAjCI;;;;EAqD/B,QAAA,CAAS,YAAA,EAAc,WAAA,CAAY,OAAA;EAAA,QAkC3B,WAAA;EAAA,QAMA,WAAA;EAAA,QAIA,aAAA;AAAA;;;;;;;;;AHjNV;;;;;iBIWgB,cAAA,CAAe,SAAA,WAAoB,eAAA;;;;;;;;iBCPnC,aAAA,CAAc,SAAA,EAAW,eAAA,EAAiB,WAAA"}

package/dist/quarry/index.mjs

@@ -0,0 +1,6 @@
+import "../decorate-D5j-d9_z.mjs";
+import { n as CommandError, t as Command } from "../command-DG_u5ob2.mjs";
+import { t as isCommand } from "../is-command-MZDCH-0T.mjs";
+import { n as parseSignature, r as CommandNotFoundError, t as QuarryRegistry } from "../quarry-registry-BPmKVjhG.mjs";
+import { t as generateUsage } from "../usage-generator-BTZDk5zx.mjs";
+export { Command, CommandError, CommandNotFoundError, QuarryRegistry, generateUsage, isCommand, parseSignature };

package/dist/quarry-registry-BPmKVjhG.mjs

@@ -0,0 +1,302 @@
+import { i as Transient, l as DI_TOKENS, n as __decorateParam, r as __decorateMetadata, t as __decorate } from "./decorate-D5j-d9_z.mjs";
+import { n as CommandError, r as COMMAND_INTERNALS } from "./command-DG_u5ob2.mjs";
+import { inject } from "tsyringe";
+//#region src/quarry/command-internals.ts
+/** @internal Set the flat input values before calling handle() */
+function setCommandInputs(command, values) {
+	command[COMMAND_INTERNALS].inputs = { ...values };
+}
+/** @internal Set the Quarry reference for this.call() support */
+function setCommandQuarry(command, quarry) {
+	command[COMMAND_INTERNALS].quarry = quarry;
+}
+/** @internal Collect the result after handle() completes */
+function getCommandResult(command) {
+	const internals = command[COMMAND_INTERNALS];
+	return {
+		exitCode: internals.exitCode,
+		output: [...internals.output],
+		errors: [...internals.errors]
+	};
+}
+//#endregion
+//#region src/quarry/errors/command-not-found.error.ts
+/**
+* Thrown when a command is not found in the Quarry registry.
+*/
+var CommandNotFoundError = class extends Error {
+	constructor(name) {
+		super(`Command "${name}" is not registered.`);
+		this.name = "CommandNotFoundError";
+	}
+};
+//#endregion
+//#region src/quarry/signature-parser.ts
+/**
+* Parse a Laravel-style command signature string.
+*
+* Signature syntax:
+*   command-name {arg} ...              — flat command
+*   group subcommand {arg} ...          — subcommand hierarchy (space-separated)
+*   namespace:command {arg} ...         — namespaced flat command (colon-separated)
+*   {--flag} {--name=} {--name=default} {--name=*} {--A|name} {--name= : desc}
+*
+* Pure function, zero dependencies, edge-compatible.
+*/
+function parseSignature(signature) {
+	const tokens = extractTokens(signature);
+	const name = extractCommandName(signature);
+	const args = [];
+	const options = [];
+	for (const token of tokens) {
+		const inner = token.slice(1, -1).trim();
+		if (inner.startsWith("--")) options.push(parseOption(inner));
+		else args.push(parseArgument(inner));
+	}
+	return {
+		name,
+		arguments: args,
+		options
+	};
+}
+function extractCommandName(signature) {
+	const match = /^[\w:.-]+(?:\s+[\w:.-]+)*/.exec(signature);
+	if (!match) throw new CommandError(`Invalid signature: cannot extract command name from "${signature}"`);
+	return match[0];
+}
+function extractTokens(signature) {
+	const tokens = [];
+	const regex = /\{[^}]+\}/g;
+	let match;
+	while ((match = regex.exec(signature)) !== null) tokens.push(match[0]);
+	return tokens;
+}
+function parseArgument(inner) {
+	const { value, description } = splitDescription(inner);
+	if (value.endsWith("*")) return {
+		name: value.slice(0, -1).trim(),
+		required: true,
+		isArray: true,
+		description
+	};
+	const eqIdx = value.indexOf("=");
+	if (eqIdx !== -1) return {
+		name: value.slice(0, eqIdx).trim(),
+		required: false,
+		default: value.slice(eqIdx + 1).trim(),
+		isArray: false,
+		description
+	};
+	if (value.endsWith("?")) return {
+		name: value.slice(0, -1).trim(),
+		required: false,
+		isArray: false,
+		description
+	};
+	return {
+		name: value.trim(),
+		required: true,
+		isArray: false,
+		description
+	};
+}
+function parseOption(inner) {
+	const { value, description } = splitDescription(inner.slice(2));
+	let alias;
+	let optBody = value;
+	const pipeIdx = optBody.indexOf("|");
+	if (pipeIdx !== -1) {
+		alias = optBody.slice(0, pipeIdx).trim();
+		optBody = optBody.slice(pipeIdx + 1).trim();
+	}
+	if (optBody.endsWith("=*")) return {
+		name: optBody.slice(0, -2).trim(),
+		alias,
+		isFlag: false,
+		isArray: true,
+		description
+	};
+	const eqIdx = optBody.indexOf("=");
+	if (eqIdx !== -1) {
+		const name = optBody.slice(0, eqIdx).trim();
+		const defaultValue = optBody.slice(eqIdx + 1).trim();
+		return {
+			name,
+			alias,
+			isFlag: false,
+			isArray: false,
+			default: defaultValue || void 0,
+			description
+		};
+	}
+	return {
+		name: optBody.trim(),
+		alias,
+		isFlag: true,
+		isArray: false,
+		description
+	};
+}
+function splitDescription(value) {
+	const colonIdx = value.indexOf(" : ");
+	if (colonIdx === -1) return { value };
+	return {
+		value: value.slice(0, colonIdx).trim(),
+		description: value.slice(colonIdx + 3).trim()
+	};
+}
+//#endregion
+//#region src/quarry/quarry-registry.ts
+let QuarryRegistry = class QuarryRegistry {
+	commands = /* @__PURE__ */ new Map();
+	signatures = /* @__PURE__ */ new Map();
+	aliases = /* @__PURE__ */ new Map();
+	constructor(container) {
+		this.container = container;
+	}
+	/**
+	* Execute a command by name with optional flat input.
+	* A fresh command instance is resolved from the container per invocation.
+	*/
+	async call(name, input) {
+		const resolvedName = this.resolveName(name);
+		const CommandClass = this.commands.get(resolvedName);
+		if (!CommandClass) throw new CommandNotFoundError(name);
+		const signature = this.signatures.get(resolvedName);
+		const mergedInput = this.applyDefaults(input ?? {}, signature);
+		for (const arg of signature.arguments) if (arg.required && (mergedInput[arg.name] === void 0 || mergedInput[arg.name] === null)) throw new CommandError(`Missing required argument: ${arg.name}`);
+		let command;
+		try {
+			command = this.container.resolve(CommandClass);
+			setCommandQuarry(command, this);
+			setCommandInputs(command, mergedInput);
+			const exitCode = await command.handle();
+			const result = getCommandResult(command);
+			if (typeof exitCode === "number") return {
+				...result,
+				exitCode
+			};
+			return result;
+		} catch (error) {
+			if (error instanceof CommandError) {
+				if (command) {
+					const result = getCommandResult(command);
+					return {
+						exitCode: result.exitCode === 0 ? 1 : result.exitCode,
+						output: result.output,
+						errors: [...result.errors, error.message]
+					};
+				}
+				return {
+					exitCode: 1,
+					output: [],
+					errors: [error.message]
+				};
+			}
+			const errorMessage = this.handleError(error);
+			if (command) {
+				const result = getCommandResult(command);
+				return {
+					exitCode: result.exitCode === 0 ? 1 : result.exitCode,
+					output: result.output,
+					errors: [...result.errors, errorMessage]
+				};
+			}
+			return {
+				exitCode: 1,
+				output: [],
+				errors: [errorMessage]
+			};
+		}
+	}
+	/**
+	* Check if a command exists by name or alias.
+	*/
+	has(name) {
+		const resolved = this.resolveName(name);
+		return this.commands.has(resolved);
+	}
+	/**
+	* Get a command constructor by name or alias.
+	*/
+	get(name) {
+		const resolved = this.resolveName(name);
+		return this.commands.get(resolved);
+	}
+	/**
+	* Get all registered command constructors.
+	*/
+	all() {
+		return new Map(this.commands);
+	}
+	/**
+	* List all commands with their descriptions and aliases.
+	*/
+	list() {
+		const result = [];
+		for (const [name, CommandClass] of this.commands) {
+			const staticCommand = CommandClass;
+			const commandAliases = [];
+			for (const [alias, target] of this.aliases) if (target === name) commandAliases.push(alias);
+			result.push({
+				name,
+				description: staticCommand.description,
+				aliases: commandAliases
+			});
+		}
+		return result.sort((a, b) => a.name.localeCompare(b.name));
+	}
+	/**
+	* Get auto-generated usage text for a command.
+	*/
+	async usage(name) {
+		const resolvedName = this.resolveName(name);
+		const CommandClass = this.commands.get(resolvedName);
+		if (!CommandClass) throw new CommandNotFoundError(name);
+		const signature = this.signatures.get(resolvedName);
+		const staticCommand = CommandClass;
+		const { generateUsage } = await import("./usage-generator-BTZDk5zx.mjs").then((n) => n.n);
+		return generateUsage(signature, staticCommand.description);
+	}
+	/**
+	* Register a command constructor with the registry.
+	* @internal Called by Application during bootstrap.
+	*/
+	register(commandClass) {
+		const staticCommand = commandClass;
+		if (!staticCommand.command) throw new CommandError(`Command class ${commandClass.name} is missing static "command" signature`);
+		const signature = parseSignature(staticCommand.command);
+		const name = signature.name;
+		if (this.commands.has(name) || this.aliases.has(name)) throw new CommandError(`Duplicate command name: "${name}" is already registered`);
+		if (staticCommand.aliases) {
+			for (const alias of staticCommand.aliases) if (this.commands.has(alias) || this.aliases.has(alias)) throw new CommandError(`Duplicate alias: "${alias}" conflicts with an existing command or alias`);
+		}
+		this.commands.set(name, commandClass);
+		this.signatures.set(name, signature);
+		if (staticCommand.aliases) for (const alias of staticCommand.aliases) this.aliases.set(alias, name);
+	}
+	handleError(error) {
+		return this.container.resolve(DI_TOKENS.ErrorHandler).handle(error).message;
+	}
+	resolveName(name) {
+		return this.aliases.get(name) ?? name;
+	}
+	applyDefaults(input, signature) {
+		const result = { ...input };
+		for (const arg of signature.arguments) if (result[arg.name] === void 0 && arg.default !== void 0) result[arg.name] = arg.default;
+		for (const opt of signature.options) if (result[opt.name] === void 0) {
+			if (opt.default !== void 0) result[opt.name] = opt.default;
+			else if (opt.isFlag) result[opt.name] = false;
+		}
+		return result;
+	}
+};
+QuarryRegistry = __decorate([
+	Transient(DI_TOKENS.Quarry),
+	__decorateParam(0, inject(DI_TOKENS.Container)),
+	__decorateMetadata("design:paramtypes", [Object])
+], QuarryRegistry);
+//#endregion
+export { parseSignature as n, CommandNotFoundError as r, QuarryRegistry as t };
+
+//# sourceMappingURL=quarry-registry-BPmKVjhG.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quarry-registry-BPmKVjhG.mjs","names":[],"sources":["../src/quarry/command-internals.ts","../src/quarry/errors/command-not-found.error.ts","../src/quarry/signature-parser.ts","../src/quarry/quarry-registry.ts"],"sourcesContent":["import type { Command } from './command'\nimport { COMMAND_INTERNALS } from './constants'\nimport type { CommandInput, CommandInternals, CommandResult } from './types'\n\n/** @internal Set the flat input values before calling handle() */\nexport function setCommandInputs(command: Command, values: CommandInput): void {\n  command[COMMAND_INTERNALS].inputs = { ...values }\n}\n\n/** @internal Set the Quarry reference for this.call() support */\nexport function setCommandQuarry(\n  command: Command,\n  quarry: { call(name: string, input?: CommandInput): Promise<CommandResult> },\n): void {\n  command[COMMAND_INTERNALS].quarry = quarry\n}\n\n/** @internal Collect the result after handle() completes */\nexport function getCommandResult(command: Command): CommandResult {\n  const internals: CommandInternals = command[COMMAND_INTERNALS]\n  return {\n    exitCode: internals.exitCode,\n    output: [...internals.output],\n    errors: [...internals.errors],\n  }\n}\n\n/** @internal Reset state between invocations */\nexport function resetCommandState(command: Command): void {\n  const internals: CommandInternals = command[COMMAND_INTERNALS]\n  internals.inputs = {}\n  internals.output = []\n  internals.errors = []\n  internals.exitCode = 0\n}\n","/**\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 { 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 type { GlobalErrorHandler } from '../errors/global-error-handler'\nimport type { Constructor } from '../types'\nimport { 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)\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   * 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): string {\n    const errorHandler = this.container.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n    const response = errorHandler.handle(error)\n    return response.message\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

@@ -0,0 +1,2 @@
+import { _ as QueueNames, a as InjectQueue, b as IQueueConsumer, 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, x as QueueMessage, y as ConsumerRegistry } from "../index-H-Su81aK.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

@@ -0,0 +1,84 @@
+import "../errors-CtCi1wn6.mjs";
+import { i as Transient, l as DI_TOKENS, n as __decorateParam, r as __decorateMetadata, t as __decorate } from "../decorate-D5j-d9_z.mjs";
+import "../logger-BR1-s1Um.mjs";
+import "../module-BH7t7BGG.mjs";
+import "../events-CXl-o1Ad.mjs";
+import "../command-DG_u5ob2.mjs";
+import "../is-command-MZDCH-0T.mjs";
+import "../is-seeder-BN9Ej1r7.mjs";
+import "../middleware-iRhNjsPH.mjs";
+import "../router-context-BLn4PrRG.mjs";
+import { 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-BdXWUvIM.mjs";
+import { inject } from "tsyringe";
+//#region src/queue/queue-manager.ts
+var _ref;
+let QueueManager = class QueueManager {
+	constructor(registry) {
+		this.registry = registry;
+	}
+	/**
+	* Process a batch of queue messages
+	*
+	* Routes messages to registered consumers based on message type.
+	* Uses ConsumerRegistry to find matching consumers.
+	*
+	* @param _queueName - Name of the queue (for logging, not used for routing)
+	* @param batch - Batch of messages from Cloudflare Queue
+	*/
+	async processBatch(_queueName, batch) {
+		for (const message of batch.messages) {
+			const queueMessage = message.body;
+			const consumers = this.registry.getConsumers(queueMessage.type);
+			for (const consumer of consumers) try {
+				await consumer.handle(queueMessage);
+				message.ack();
+			} catch (error) {
+				const errorInstance = error instanceof Error ? error : new Error(String(error));
+				if (consumer.onError) await consumer.onError(errorInstance, queueMessage);
+				message.retry();
+			}
+		}
+	}
+};
+QueueManager = __decorate([
+	Transient(DI_TOKENS.Queue),
+	__decorateParam(0, inject(DI_TOKENS.ConsumerRegistry)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref : Object])
+], QueueManager);
+//#endregion
+//#region src/queue/decorators/inject-queue.decorator.ts
+/**
+* Inject a queue sender by name.
+*
+* Queue names are typed via module augmentation of QueueNames interface.
+* The queue name serves as both the identifier and the DI injection token.
+*
+* @param name - Queue name (typed with autocomplete if QueueNames is augmented)
+* @returns Parameter decorator for constructor injection
+*
+* @example
+* ```typescript
+* // Direct injection by queue name
+* constructor(
+*   @InjectQueue('notifications-queue') private queue: IQueueSender
+* ) {}
+*
+* // Usage
+* await this.queue.dispatch({
+*   type: 'email.send',
+*   payload: { to: 'user@example.com', subject: 'Hello' }
+* })
+* ```
+*
+* @remarks
+* The queue must be registered via `QueueModule.registerQueue(name)` before injection.
+* For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with
+* `useExisting` provider binding instead.
+*/
+function InjectQueue(name) {
+	return inject(name);
+}
+//#endregion
+export { CloudflareQueueProvider, ConsumerRegistry, InjectQueue, QUEUE_TOKENS, QueueBindingNotFoundError, QueueManager, QueueModule, QueueProviderFactory, QueueProviderNotSupportedError, QueueRegistry, QueueSender, SyncQueueProvider };
+
+//# sourceMappingURL=index.mjs.map

package/dist/queue/index.mjs.map

@@ -0,0 +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"}