stratal 0.0.13 → 0.0.15

package/dist/cache/index.mjs

@@ -0,0 +1,251 @@
+import { S as ApplicationError, b as ERROR_CODES } from "../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 { s as LOGGER_TOKENS } from "../logger-BR1-s1Um.mjs";
+import { r as Module } from "../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 { inject } from "tsyringe";
+//#region src/cache/cache.tokens.ts
+const CACHE_TOKENS = { CacheService: Symbol.for("stratal:cache:service") };
+//#endregion
+//#region src/cache/errors/cache-get.error.ts
+/**
+* Error thrown when a cache get operation fails
+*
+* Raw error details are logged via LoggerService for security.
+* Only the key is included in the user-facing error message.
+*/
+var CacheGetError = class extends ApplicationError {
+	constructor(key) {
+		super("errors.cache.getFailed", ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key });
+	}
+};
+//#endregion
+//#region src/cache/errors/cache-put.error.ts
+/**
+* Error thrown when a cache put operation fails
+*
+* Raw error details are logged via LoggerService for security.
+* Only the key is included in the user-facing error message.
+*/
+var CachePutError = class extends ApplicationError {
+	constructor(key) {
+		super("errors.cache.putFailed", ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key });
+	}
+};
+//#endregion
+//#region src/cache/errors/cache-delete.error.ts
+/**
+* Error thrown when a cache delete operation fails
+*
+* Raw error details are logged via LoggerService for security.
+* Only the key is included in the user-facing error message.
+*/
+var CacheDeleteError = class extends ApplicationError {
+	constructor(key) {
+		super("errors.cache.deleteFailed", ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key });
+	}
+};
+//#endregion
+//#region src/cache/errors/cache-list.error.ts
+/**
+* Error thrown when a cache list operation fails
+*
+* Raw error details are logged via LoggerService for security.
+*/
+var CacheListError = class extends ApplicationError {
+	constructor() {
+		super("errors.cache.listFailed", ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, {});
+	}
+};
+//#endregion
+//#region src/cache/services/cache.service.ts
+var _CacheService;
+let CacheService = _CacheService = class CacheService {
+	kv;
+	constructor(env, logger) {
+		this.env = env;
+		this.logger = logger;
+		this.kv = env.CACHE;
+	}
+	/**
+	* Set the KV namespace binding
+	*
+	* Used internally by `withBinding()` to configure different KV instances.
+	*
+	* @param kv - KV namespace to use
+	*/
+	setKV(kv) {
+		this.kv = kv;
+	}
+	/**
+	* Create a new CacheService instance with a different KV binding
+	*
+	* **Pattern:** Returns a new instance (immutable)
+	*
+	* **Best Practice:** Initialize specialized caches as class properties in constructor
+	*
+	* @example
+	* ```typescript
+	* class MyService {
+	*   private readonly uploadsCache: CacheService
+	*   private readonly systemCache: CacheService
+	*
+	*   constructor(
+	*     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,
+	*     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env
+	*   ) {
+	*     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)
+	*     this.systemCache = this.cache.withBinding(this.env.SYSTEM_CONFIG_KV)
+	*   }
+	* }
+	* ```
+	*
+	* @param kv - KV namespace to use
+	* @returns New CacheService instance with the specified binding
+	*/
+	withBinding(kv) {
+		const instance = new _CacheService(this.env, this.logger);
+		instance.setKV(kv);
+		return instance;
+	}
+	async get(key, typeOrOptions) {
+		try {
+			if (typeof typeOrOptions === "string") return await this.kv.get(key, typeOrOptions);
+			if (typeOrOptions) return await this.kv.get(key, typeOrOptions);
+			return await this.kv.get(key);
+		} catch (error) {
+			this.logger.error("Cache get operation failed", {
+				key,
+				error
+			});
+			throw new CacheGetError(key);
+		}
+	}
+	async getWithMetadata(key, typeOrOptions) {
+		try {
+			if (typeof typeOrOptions === "string") return await this.kv.getWithMetadata(key, typeOrOptions);
+			if (typeOrOptions) return await this.kv.getWithMetadata(key, typeOrOptions);
+			return await this.kv.getWithMetadata(key);
+		} catch (error) {
+			this.logger.error("Cache getWithMetadata operation failed", {
+				key,
+				error
+			});
+			throw new CacheGetError(key);
+		}
+	}
+	/**
+	* Store a value in cache
+	*
+	* @param key - Cache key
+	* @param value - Value to store (string, ArrayBuffer, ArrayBufferView, or ReadableStream)
+	* @param options - Put options (expiration, expirationTtl, metadata)
+	* @throws {CachePutError} If operation fails
+	*
+	* @example
+	* ```typescript
+	* // Simple put
+	* await cache.put('key', 'value')
+	*
+	* // With TTL
+	* await cache.put('key', 'value', { expirationTtl: 3600 })
+	*
+	* // With metadata
+	* await cache.put('key', 'value', { metadata: { created: Date.now() } })
+	* ```
+	*/
+	async put(key, value, options) {
+		try {
+			await this.kv.put(key, value, options);
+		} catch (error) {
+			this.logger.error("Cache put operation failed", {
+				key,
+				error
+			});
+			throw new CachePutError(key);
+		}
+	}
+	/**
+	* Delete a value from cache
+	*
+	* @param key - Cache key to delete
+	* @throws {CacheDeleteError} If operation fails
+	*/
+	async delete(key) {
+		try {
+			await this.kv.delete(key);
+		} catch (error) {
+			this.logger.error("Cache delete operation failed", {
+				key,
+				error
+			});
+			throw new CacheDeleteError(key);
+		}
+	}
+	/**
+	* List keys in cache
+	*
+	* @param options - List options (limit, prefix, cursor)
+	* @returns List result with keys and pagination info
+	* @throws {CacheListError} If operation fails
+	*
+	* @example
+	* ```typescript
+	* // List all keys
+	* const result = await cache.list()
+	*
+	* // List with prefix
+	* const result = await cache.list({ prefix: 'user:' })
+	*
+	* // Paginated list
+	* const result = await cache.list({ limit: 100 })
+	* if (!result.list_complete) {
+	*   const nextPage = await cache.list({ cursor: result.cursor })
+	* }
+	* ```
+	*/
+	async list(options) {
+		try {
+			return await this.kv.list(options);
+		} catch (error) {
+			this.logger.error("Cache list operation failed", {
+				options,
+				error
+			});
+			throw new CacheListError();
+		}
+	}
+};
+CacheService = _CacheService = __decorate([
+	Transient(CACHE_TOKENS.CacheService),
+	__decorateParam(0, inject(DI_TOKENS.CloudflareEnv)),
+	__decorateParam(1, inject(LOGGER_TOKENS.LoggerService)),
+	__decorateMetadata("design:paramtypes", [Object, Object])
+], CacheService);
+//#endregion
+//#region src/cache/cache.module.ts
+/**
+* Cache Module
+*
+* Provides key-value caching capabilities using Cloudflare KV namespaces.
+*
+* **Features:**
+* - Type-safe KV wrapper with full method coverage
+* - Multiple KV binding support via `withBinding()`
+* - Automatic error handling with security-focused logging
+* - Singleton service for optimal performance
+*/
+let CacheModule = class CacheModule {};
+CacheModule = __decorate([Module({ providers: [{
+	provide: CACHE_TOKENS.CacheService,
+	useClass: CacheService
+}] })], CacheModule);
+//#endregion
+export { CACHE_TOKENS, CacheDeleteError, CacheGetError, CacheListError, CacheModule, CachePutError, CacheService };
+
+//# sourceMappingURL=index.mjs.map

package/dist/cache/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/cache/cache.tokens.ts","../../src/cache/errors/cache-get.error.ts","../../src/cache/errors/cache-put.error.ts","../../src/cache/errors/cache-delete.error.ts","../../src/cache/errors/cache-list.error.ts","../../src/cache/services/cache.service.ts","../../src/cache/cache.module.ts"],"sourcesContent":["export const CACHE_TOKENS = {\n  CacheService: Symbol.for('stratal:cache:service'),\n} as const\n\nexport type CacheToken = (typeof CACHE_TOKENS)[keyof typeof CACHE_TOKENS]\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * Error thrown when a cache get operation fails\n *\n * Raw error details are logged via LoggerService for security.\n * Only the key is included in the user-facing error message.\n */\nexport class CacheGetError extends ApplicationError {\n  constructor(key: string) {\n    super('errors.cache.getFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * Error thrown when a cache put operation fails\n *\n * Raw error details are logged via LoggerService for security.\n * Only the key is included in the user-facing error message.\n */\nexport class CachePutError extends ApplicationError {\n  constructor(key: string) {\n    super('errors.cache.putFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * Error thrown when a cache delete operation fails\n *\n * Raw error details are logged via LoggerService for security.\n * Only the key is included in the user-facing error message.\n */\nexport class CacheDeleteError extends ApplicationError {\n  constructor(key: string) {\n    super('errors.cache.deleteFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, { key })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * Error thrown when a cache list operation fails\n *\n * Raw error details are logged via LoggerService for security.\n */\nexport class CacheListError extends ApplicationError {\n  constructor() {\n    super('errors.cache.listFailed', ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR, {})\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { type StratalEnv } from '../../env'\nimport { LOGGER_TOKENS, type LoggerService } from '../../logger'\nimport { CACHE_TOKENS } from '../cache.tokens'\nimport {\n  CacheDeleteError,\n  CacheGetError,\n  CacheListError,\n  CachePutError,\n} from '../errors'\n\n/**\n * Cache Service\n *\n * Type-safe wrapper around Cloudflare KV namespaces for caching operations.\n *\n * **Features:**\n * - Mirrors all KVNamespace methods with full type safety\n * - Supports multiple KV bindings via `withBinding()`\n * - Automatic error handling with logging\n * - Security: Raw errors are logged, not exposed to users\n *\n * **Usage:**\n * ```typescript\n * class MyService {\n *   private readonly uploadsCache: CacheService\n *\n *   constructor(\n *     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,\n *     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env\n *   ) {\n *     // Initialize specialized caches in constructor\n *     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)\n *   }\n *\n *   async cacheData(key: string, value: string) {\n *     await this.cache.put(key, value, { expirationTtl: 3600 })\n *     await this.uploadsCache.put(`upload:${key}`, value)\n *   }\n * }\n * ```\n *\n * @see https://developers.cloudflare.com/kv/api/\n */\n@Transient(CACHE_TOKENS.CacheService)\nexport class CacheService {\n  private kv: KVNamespace\n\n  constructor(\n    @inject(DI_TOKENS.CloudflareEnv) private readonly env: StratalEnv,\n    @inject(LOGGER_TOKENS.LoggerService) private readonly logger: LoggerService\n  ) {\n    this.kv = env.CACHE\n  }\n\n  /**\n   * Set the KV namespace binding\n   *\n   * Used internally by `withBinding()` to configure different KV instances.\n   *\n   * @param kv - KV namespace to use\n   */\n  setKV(kv: KVNamespace): void {\n    this.kv = kv\n  }\n\n  /**\n   * Create a new CacheService instance with a different KV binding\n   *\n   * **Pattern:** Returns a new instance (immutable)\n   *\n   * **Best Practice:** Initialize specialized caches as class properties in constructor\n   *\n   * @example\n   * ```typescript\n   * class MyService {\n   *   private readonly uploadsCache: CacheService\n   *   private readonly systemCache: CacheService\n   *\n   *   constructor(\n   *     @inject(CACHE_TOKENS.CacheService) private readonly cache: CacheService,\n   *     @inject(DI_TOKENS.CloudflareEnv) private readonly env: Env\n   *   ) {\n   *     this.uploadsCache = this.cache.withBinding(this.env.UPLOADS_CACHE)\n   *     this.systemCache = this.cache.withBinding(this.env.SYSTEM_CONFIG_KV)\n   *   }\n   * }\n   * ```\n   *\n   * @param kv - KV namespace to use\n   * @returns New CacheService instance with the specified binding\n   */\n  withBinding(kv: KVNamespace): CacheService {\n    const instance = new CacheService(this.env, this.logger)\n    instance.setKV(kv)\n    return instance\n  }\n\n  // ==================== GET METHODS ====================\n\n  /**\n   * Get a value from cache\n   *\n   * @param key - Cache key\n   * @param typeOrOptions - Type string or options object (defaults to 'text')\n   * @returns Value in specified type, or null if not found\n   * @throws {CacheGetError} If operation fails\n   */\n  async get(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<string | null>\n  async get<ExpectedValue = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<ExpectedValue | null>\n  async get(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<ArrayBuffer | null>\n  async get(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<ReadableStream | null>\n\n  async get<ExpectedValue = unknown>(\n    key: string,\n    typeOrOptions?: string | KVNamespaceGetOptions<'text' | 'json' | 'arrayBuffer' | 'stream'>\n  ): Promise<string | ExpectedValue | ArrayBuffer | ReadableStream | null> {\n    try {\n      if (typeof typeOrOptions === 'string') {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API\n        return await this.kv.get(key, typeOrOptions as any)\n      }\n\n      if (typeOrOptions) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API\n        return await this.kv.get(key, typeOrOptions as any)\n      }\n\n      return await this.kv.get(key)\n    } catch (error) {\n      this.logger.error('Cache get operation failed', { key, error })\n      throw new CacheGetError(key)\n    }\n  }\n\n  // ==================== GET WITH METADATA METHODS ====================\n\n  /**\n   * Get a value with metadata from cache\n   *\n   * @param key - Cache key\n   * @param typeOrOptions - Type string or options object (defaults to 'text')\n   * @returns Object with value, metadata, and cacheStatus\n   * @throws {CacheGetError} If operation fails\n   */\n  async getWithMetadata<Metadata = unknown>(\n    key: string,\n    typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>\n  ): Promise<KVNamespaceGetWithMetadataResult<string, Metadata>>\n  async getWithMetadata<ExpectedValue = unknown, Metadata = unknown>(\n    key: string,\n    typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>\n  ): Promise<KVNamespaceGetWithMetadataResult<ExpectedValue, Metadata>>\n  async getWithMetadata<Metadata = unknown>(\n    key: string,\n    typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>\n  ): Promise<KVNamespaceGetWithMetadataResult<ArrayBuffer, Metadata>>\n  async getWithMetadata<Metadata = unknown>(\n    key: string,\n    typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>\n  ): Promise<KVNamespaceGetWithMetadataResult<ReadableStream, Metadata>>\n\n  async getWithMetadata<ExpectedValue = unknown, Metadata = unknown>(\n    key: string,\n    typeOrOptions?: string | KVNamespaceGetOptions<'text' | 'json' | 'arrayBuffer' | 'stream'>\n  ): Promise<\n    KVNamespaceGetWithMetadataResult<\n      string | ExpectedValue | ArrayBuffer | ReadableStream,\n      Metadata\n    >\n  > {\n    try {\n      if (typeof typeOrOptions === 'string') {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API\n        return await this.kv.getWithMetadata(key, typeOrOptions as any)\n      }\n\n      if (typeOrOptions) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any -- bridging KV overloaded API\n        return await this.kv.getWithMetadata(key, typeOrOptions as any)\n      }\n\n      return await this.kv.getWithMetadata(key)\n    } catch (error) {\n      this.logger.error('Cache getWithMetadata operation failed', { key, error })\n      throw new CacheGetError(key)\n    }\n  }\n\n  // ==================== PUT METHOD ====================\n\n  /**\n   * Store a value in cache\n   *\n   * @param key - Cache key\n   * @param value - Value to store (string, ArrayBuffer, ArrayBufferView, or ReadableStream)\n   * @param options - Put options (expiration, expirationTtl, metadata)\n   * @throws {CachePutError} If operation fails\n   *\n   * @example\n   * ```typescript\n   * // Simple put\n   * await cache.put('key', 'value')\n   *\n   * // With TTL\n   * await cache.put('key', 'value', { expirationTtl: 3600 })\n   *\n   * // With metadata\n   * await cache.put('key', 'value', { metadata: { created: Date.now() } })\n   * ```\n   */\n  async put(\n    key: string,\n    value: string | ArrayBuffer | ArrayBufferView | ReadableStream,\n    options?: KVNamespacePutOptions\n  ): Promise<void> {\n    try {\n      await this.kv.put(key, value as string, options)\n    } catch (error) {\n      this.logger.error('Cache put operation failed', { key, error })\n      throw new CachePutError(key)\n    }\n  }\n\n  // ==================== DELETE METHODS ====================\n\n  /**\n   * Delete a value from cache\n   *\n   * @param key - Cache key to delete\n   * @throws {CacheDeleteError} If operation fails\n   */\n  async delete(key: string): Promise<void> {\n    try {\n      await this.kv.delete(key)\n    } catch (error) {\n      this.logger.error('Cache delete operation failed', { key, error })\n      throw new CacheDeleteError(key)\n    }\n  }\n\n\n  // ==================== LIST METHOD ====================\n\n  /**\n   * List keys in cache\n   *\n   * @param options - List options (limit, prefix, cursor)\n   * @returns List result with keys and pagination info\n   * @throws {CacheListError} If operation fails\n   *\n   * @example\n   * ```typescript\n   * // List all keys\n   * const result = await cache.list()\n   *\n   * // List with prefix\n   * const result = await cache.list({ prefix: 'user:' })\n   *\n   * // Paginated list\n   * const result = await cache.list({ limit: 100 })\n   * if (!result.list_complete) {\n   *   const nextPage = await cache.list({ cursor: result.cursor })\n   * }\n   * ```\n   */\n  async list<Metadata = unknown>(\n    options?: KVNamespaceListOptions\n  ): Promise<KVNamespaceListResult<Metadata>> {\n    try {\n      return await this.kv.list<Metadata>(options)\n    } catch (error) {\n      this.logger.error('Cache list operation failed', { options, error })\n      throw new CacheListError()\n    }\n  }\n}\n","/**\n * Cache Module\n *\n * Provides key-value caching capabilities using Cloudflare KV namespaces.\n *\n * **Features:**\n * - Type-safe KV wrapper with full method coverage\n * - Multiple KV binding support via `withBinding()`\n * - Automatic error handling with security-focused logging\n * - Singleton service for optimal performance\n */\n\nimport { Module } from '../module'\nimport { CACHE_TOKENS } from './cache.tokens'\nimport { CacheService } from './services'\n\n@Module({\n  providers: [\n    // Singleton - CacheService has no request dependencies\n    { provide: CACHE_TOKENS.CacheService, useClass: CacheService },\n  ],\n})\nexport class CacheModule {}\n"],"mappings":"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"}

package/dist/chunk-D1SwGrFN.mjs

@@ -0,0 +1,27 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+//#endregion
+export { __reExport as n, __exportAll as t };

package/dist/command-DG_u5ob2.mjs

@@ -0,0 +1,192 @@
+import "reflect-metadata";
+//#region src/quarry/constants.ts
+/**
+* Symbol key for storing internal mutable state on Command instances.
+* Keeps internal state hidden from user-facing autocomplete.
+*/
+const COMMAND_INTERNALS = Symbol.for("stratal:command:internals");
+//#endregion
+//#region src/quarry/errors/command.error.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.
+*/
+var CommandError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CommandError";
+	}
+};
+//#endregion
+//#region src/quarry/command.ts
+/**
+* Abstract base class for Quarry commands.
+*
+* Subclasses define a static `command` signature string and implement `handle()`.
+*
+* @example
+* ```typescript
+* export class GreetCommand extends Command {
+*   static command = 'greet {name : The name to greet} {--loud}'
+*   static description = 'Greet someone'
+*
+*   async handle(): Promise<void> {
+*     const name = this.string('name')
+*     const loud = this.boolean('loud')
+*     this.info(loud ? `HELLO, ${name.toUpperCase()}!` : `Hello, ${name}!`)
+*   }
+* }
+* ```
+*/
+var Command = class {
+	/**
+	* Laravel-style command signature string.
+	*
+	* **Command names:**
+	* - `'greet'` — flat command (`quarry greet`)
+	* - `'task add'` — subcommand hierarchy via spaces (`quarry task add`)
+	* - `'task:add'` — namespaced flat command via colons (`quarry task:add`)
+	*
+	* **Arguments:**
+	* - `{name}` — required argument
+	* - `{name?}` — optional argument
+	* - `{name=default}` — argument with default value
+	* - `{name*}` — array/variadic argument
+	* - `{name : description}` — argument with description
+	*
+	* **Options:**
+	* - `{--flag}` — boolean flag
+	* - `{--name=}` — option that accepts a value
+	* - `{--name=default}` — option with default value
+	* - `{--name=*}` — array option (multiple values)
+	* - `{--A|name}` — option with single-char alias
+	* - `{--name= : description}` — option with description
+	*
+	* @example
+	* ```typescript
+	* // Namespaced flat command: `quarry users:create ...`
+	* static command = 'users:create {email : The user email} {--A|admin} {--R|role= : Assign a role}'
+	*
+	* // Subcommand hierarchy: `quarry users create ...`
+	* static command = 'users create {email : The user email} {--A|admin} {--R|role= : Assign a role}'
+	* ```
+	*/
+	static command;
+	/** Human-readable description */
+	static description;
+	/** Alternative command names */
+	static aliases;
+	[COMMAND_INTERNALS];
+	constructor() {
+		this[COMMAND_INTERNALS] = {
+			inputs: {},
+			output: [],
+			errors: [],
+			exitCode: 0,
+			quarry: null
+		};
+	}
+	/**
+	* Get an input value with generic type.
+	*/
+	input(name) {
+		return this[COMMAND_INTERNALS].inputs[name];
+	}
+	/**
+	* Get a string input. Throws CommandError if present but not a string.
+	*/
+	string(name) {
+		const value = this[COMMAND_INTERNALS].inputs[name];
+		if (value === void 0 || value === null) return "";
+		if (typeof value !== "string") throw new CommandError(`Input "${name}" expected a string, got ${typeof value}`);
+		return value;
+	}
+	/**
+	* Get a boolean input. Throws CommandError if present but not a boolean.
+	*/
+	boolean(name) {
+		const value = this[COMMAND_INTERNALS].inputs[name];
+		if (value === void 0 || value === null) return false;
+		if (typeof value !== "boolean") throw new CommandError(`Input "${name}" expected a boolean, got ${typeof value}`);
+		return value;
+	}
+	/**
+	* Get a number input. Coerces strings to numbers. Throws CommandError on NaN.
+	*/
+	number(name) {
+		const value = this[COMMAND_INTERNALS].inputs[name];
+		if (value === void 0 || value === null) return 0;
+		const num = typeof value === "string" ? Number(value) : value;
+		if (typeof num !== "number" || Number.isNaN(num)) throw new CommandError(`Input "${name}" expected a number, got ${typeof value}`);
+		return num;
+	}
+	/**
+	* Get an array input. Throws CommandError if present but not an array.
+	*/
+	array(name) {
+		const value = this[COMMAND_INTERNALS].inputs[name];
+		if (value === void 0 || value === null) return [];
+		if (!Array.isArray(value)) throw new CommandError(`Input "${name}" expected an array, got ${typeof value}`);
+		return value;
+	}
+	/** Write an informational message to output */
+	info(message) {
+		this[COMMAND_INTERNALS].output.push(message);
+	}
+	/** Write a success message to output */
+	success(message) {
+		this[COMMAND_INTERNALS].output.push(message);
+	}
+	/** Write a warning message to output */
+	warn(message) {
+		this[COMMAND_INTERNALS].output.push(`Warning: ${message}`);
+	}
+	/** Write an error message to errors */
+	error(message) {
+		this[COMMAND_INTERNALS].errors.push(message);
+	}
+	/** Write a plain line to output */
+	line(message) {
+		this[COMMAND_INTERNALS].output.push(message ?? "");
+	}
+	/** Write an empty line to output */
+	newLine() {
+		this[COMMAND_INTERNALS].output.push("");
+	}
+	/** Write a comment-style line to output */
+	comment(message) {
+		this[COMMAND_INTERNALS].output.push(`// ${message}`);
+	}
+	/** Write a formatted table to output */
+	table(headers, rows) {
+		const colWidths = headers.map((h, i) => {
+			const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] ?? "").length), 0);
+			return Math.max(h.length, maxRow);
+		});
+		const formatRow = (cells) => cells.map((cell, i) => cell.padEnd(colWidths[i])).join("  ");
+		this[COMMAND_INTERNALS].output.push(formatRow(headers));
+		this[COMMAND_INTERNALS].output.push(colWidths.map((w) => "-".repeat(w)).join("  "));
+		for (const row of rows) this[COMMAND_INTERNALS].output.push(formatRow(row));
+	}
+	/** Write an error message and set exit code */
+	fail(message, exitCode = 1) {
+		this[COMMAND_INTERNALS].errors.push(message);
+		this[COMMAND_INTERNALS].exitCode = exitCode;
+	}
+	/**
+	* Call another command from within this command.
+	* Delegates to Quarry.call() via internal reference.
+	*/
+	async call(name, input) {
+		const internals = this[COMMAND_INTERNALS];
+		if (!internals.quarry) throw new CommandError("Cannot call commands: Quarry reference not set");
+		return internals.quarry.call(name, input);
+	}
+};
+//#endregion
+export { CommandError as n, COMMAND_INTERNALS as r, Command as t };
+
+//# sourceMappingURL=command-DG_u5ob2.mjs.map

package/dist/command-DG_u5ob2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-DG_u5ob2.mjs","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/errors/command.error.ts","../src/quarry/command.ts"],"sourcesContent":["/**\n * Symbol key for storing internal mutable state on Command instances.\n * Keeps internal state hidden from user-facing autocomplete.\n */\nexport const COMMAND_INTERNALS = Symbol.for('stratal:command:internals')\n","/**\n * User-facing command error with a plain English message.\n *\n * Quarry catches this in `call()` and puts the message into `CommandResult.errors`.\n * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).\n * Not routed through GlobalErrorHandler.\n */\nexport class CommandError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'CommandError'\n  }\n}\n","import 'reflect-metadata'\n\nimport { COMMAND_INTERNALS } from './constants'\nimport { CommandError } from './errors/command.error'\nimport type { CommandInput, CommandInternals, CommandResult } from './types'\n\n/**\n * Abstract base class for Quarry commands.\n *\n * Subclasses define a static `command` signature string and implement `handle()`.\n *\n * @example\n * ```typescript\n * export class GreetCommand extends Command {\n *   static command = 'greet {name : The name to greet} {--loud}'\n *   static description = 'Greet someone'\n *\n *   async handle(): Promise<void> {\n *     const name = this.string('name')\n *     const loud = this.boolean('loud')\n *     this.info(loud ? `HELLO, ${name.toUpperCase()}!` : `Hello, ${name}!`)\n *   }\n * }\n * ```\n */\nexport abstract class Command {\n  /**\n   * Laravel-style command signature string.\n   *\n   * **Command names:**\n   * - `'greet'` — flat command (`quarry greet`)\n   * - `'task add'` — subcommand hierarchy via spaces (`quarry task add`)\n   * - `'task:add'` — namespaced flat command via colons (`quarry task:add`)\n   *\n   * **Arguments:**\n   * - `{name}` — required argument\n   * - `{name?}` — optional argument\n   * - `{name=default}` — argument with default value\n   * - `{name*}` — array/variadic argument\n   * - `{name : description}` — argument with description\n   *\n   * **Options:**\n   * - `{--flag}` — boolean flag\n   * - `{--name=}` — option that accepts a value\n   * - `{--name=default}` — option with default value\n   * - `{--name=*}` — array option (multiple values)\n   * - `{--A|name}` — option with single-char alias\n   * - `{--name= : description}` — option with description\n   *\n   * @example\n   * ```typescript\n   * // Namespaced flat command: `quarry users:create ...`\n   * static command = 'users:create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   *\n   * // Subcommand hierarchy: `quarry users create ...`\n   * static command = 'users create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   * ```\n   */\n  static command: string\n  /** Human-readable description */\n  static description?: string\n  /** Alternative command names */\n  static aliases?: string[];\n\n  [COMMAND_INTERNALS]: CommandInternals\n\n  constructor() {\n    this[COMMAND_INTERNALS] = {\n      inputs: {},\n      output: [],\n      errors: [],\n      exitCode: 0,\n      quarry: null,\n    }\n  }\n\n  /**\n   * Implement this method with the command's logic.\n   * Return a number to set the exit code, or void for exit code 0.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n  abstract handle(): number | void | Promise<number | void>\n\n  // ── Input Accessors ──────────────────────────────────────────────\n\n  /**\n   * Get an input value with generic type.\n   */\n  input<T>(name: string): T {\n    return this[COMMAND_INTERNALS].inputs[name] as T\n  }\n\n  /**\n   * Get a string input. Throws CommandError if present but not a string.\n   */\n  string(name: string): string {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return ''\n    }\n    if (typeof value !== 'string') {\n      throw new CommandError(`Input \"${name}\" expected a string, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a boolean input. Throws CommandError if present but not a boolean.\n   */\n  boolean(name: string): boolean {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return false\n    }\n    if (typeof value !== 'boolean') {\n      throw new CommandError(`Input \"${name}\" expected a boolean, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a number input. Coerces strings to numbers. Throws CommandError on NaN.\n   */\n  number(name: string): number {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return 0\n    }\n    const num = typeof value === 'string' ? Number(value) : value\n    if (typeof num !== 'number' || Number.isNaN(num)) {\n      throw new CommandError(`Input \"${name}\" expected a number, got ${typeof value}`)\n    }\n    return num\n  }\n\n  /**\n   * Get an array input. Throws CommandError if present but not an array.\n   */\n  array(name: string): string[] {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return []\n    }\n    if (!Array.isArray(value)) {\n      throw new CommandError(`Input \"${name}\" expected an array, got ${typeof value}`)\n    }\n    return value as string[]\n  }\n\n  // ── Output Helpers ───────────────────────────────────────────────\n\n  /** Write an informational message to output */\n  info(message: string): void {\n    this[COMMAND_INTERNALS].output.push(message)\n  }\n\n  /** Write a success message to output */\n  success(message: string): void {\n    this[COMMAND_INTERNALS].output.push(message)\n  }\n\n  /** Write a warning message to output */\n  warn(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`Warning: ${message}`)\n  }\n\n  /** Write an error message to errors */\n  error(message: string): void {\n    this[COMMAND_INTERNALS].errors.push(message)\n  }\n\n  /** Write a plain line to output */\n  line(message?: string): void {\n    this[COMMAND_INTERNALS].output.push(message ?? '')\n  }\n\n  /** Write an empty line to output */\n  newLine(): void {\n    this[COMMAND_INTERNALS].output.push('')\n  }\n\n  /** Write a comment-style line to output */\n  comment(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`// ${message}`)\n  }\n\n  /** Write a formatted table to output */\n  table(headers: string[], rows: string[][]): void {\n    const colWidths = headers.map((h, i) => {\n      const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0)\n      return Math.max(h.length, maxRow)\n    })\n\n    const formatRow = (cells: string[]) =>\n      cells.map((cell, i) => cell.padEnd(colWidths[i])).join('  ')\n\n    this[COMMAND_INTERNALS].output.push(formatRow(headers))\n    this[COMMAND_INTERNALS].output.push(colWidths.map((w) => '-'.repeat(w)).join('  '))\n    for (const row of rows) {\n      this[COMMAND_INTERNALS].output.push(formatRow(row))\n    }\n  }\n\n  /** Write an error message and set exit code */\n  fail(message: string, exitCode = 1): void {\n    this[COMMAND_INTERNALS].errors.push(message)\n    this[COMMAND_INTERNALS].exitCode = exitCode\n  }\n\n  // ── Command Calling ──────────────────────────────────────────────\n\n  /**\n   * Call another command from within this command.\n   * Delegates to Quarry.call() via internal reference.\n   */\n  async call(name: string, input?: CommandInput): Promise<CommandResult> {\n    const internals = this[COMMAND_INTERNALS]\n    if (!internals.quarry) {\n      throw new CommandError('Cannot call commands: Quarry reference not set')\n    }\n    return internals.quarry.call(name, input)\n  }\n}\n"],"mappings":"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"}

package/dist/command-DcebcSrL.d.mts

@@ -0,0 +1,120 @@
+import { n as CommandInternals, r as CommandResult, t as CommandInput } from "./types-N84Ak6YT.mjs";
+//#region src/quarry/constants.d.ts
+/**
+ * Symbol key for storing internal mutable state on Command instances.
+ * Keeps internal state hidden from user-facing autocomplete.
+ */
+declare const COMMAND_INTERNALS: unique symbol;
+//#endregion
+//#region src/quarry/command.d.ts
+/**
+ * Abstract base class for Quarry commands.
+ *
+ * Subclasses define a static `command` signature string and implement `handle()`.
+ *
+ * @example
+ * ```typescript
+ * export class GreetCommand extends Command {
+ *   static command = 'greet {name : The name to greet} {--loud}'
+ *   static description = 'Greet someone'
+ *
+ *   async handle(): Promise<void> {
+ *     const name = this.string('name')
+ *     const loud = this.boolean('loud')
+ *     this.info(loud ? `HELLO, ${name.toUpperCase()}!` : `Hello, ${name}!`)
+ *   }
+ * }
+ * ```
+ */
+declare abstract class Command {
+  /**
+   * Laravel-style command signature string.
+   *
+   * **Command names:**
+   * - `'greet'` — flat command (`quarry greet`)
+   * - `'task add'` — subcommand hierarchy via spaces (`quarry task add`)
+   * - `'task:add'` — namespaced flat command via colons (`quarry task:add`)
+   *
+   * **Arguments:**
+   * - `{name}` — required argument
+   * - `{name?}` — optional argument
+   * - `{name=default}` — argument with default value
+   * - `{name*}` — array/variadic argument
+   * - `{name : description}` — argument with description
+   *
+   * **Options:**
+   * - `{--flag}` — boolean flag
+   * - `{--name=}` — option that accepts a value
+   * - `{--name=default}` — option with default value
+   * - `{--name=*}` — array option (multiple values)
+   * - `{--A|name}` — option with single-char alias
+   * - `{--name= : description}` — option with description
+   *
+   * @example
+   * ```typescript
+   * // Namespaced flat command: `quarry users:create ...`
+   * static command = 'users:create {email : The user email} {--A|admin} {--R|role= : Assign a role}'
+   *
+   * // Subcommand hierarchy: `quarry users create ...`
+   * static command = 'users create {email : The user email} {--A|admin} {--R|role= : Assign a role}'
+   * ```
+   */
+  static command: string;
+  /** Human-readable description */
+  static description?: string;
+  /** Alternative command names */
+  static aliases?: string[];
+  [COMMAND_INTERNALS]: CommandInternals;
+  constructor();
+  /**
+   * Implement this method with the command's logic.
+   * Return a number to set the exit code, or void for exit code 0.
+   */
+  abstract handle(): number | void | Promise<number | void>;
+  /**
+   * Get an input value with generic type.
+   */
+  input<T>(name: string): T;
+  /**
+   * Get a string input. Throws CommandError if present but not a string.
+   */
+  string(name: string): string;
+  /**
+   * Get a boolean input. Throws CommandError if present but not a boolean.
+   */
+  boolean(name: string): boolean;
+  /**
+   * Get a number input. Coerces strings to numbers. Throws CommandError on NaN.
+   */
+  number(name: string): number;
+  /**
+   * Get an array input. Throws CommandError if present but not an array.
+   */
+  array(name: string): string[];
+  /** Write an informational message to output */
+  info(message: string): void;
+  /** Write a success message to output */
+  success(message: string): void;
+  /** Write a warning message to output */
+  warn(message: string): void;
+  /** Write an error message to errors */
+  error(message: string): void;
+  /** Write a plain line to output */
+  line(message?: string): void;
+  /** Write an empty line to output */
+  newLine(): void;
+  /** Write a comment-style line to output */
+  comment(message: string): void;
+  /** Write a formatted table to output */
+  table(headers: string[], rows: string[][]): void;
+  /** Write an error message and set exit code */
+  fail(message: string, exitCode?: number): void;
+  /**
+   * Call another command from within this command.
+   * Delegates to Quarry.call() via internal reference.
+   */
+  call(name: string, input?: CommandInput): Promise<CommandResult>;
+}
+//#endregion
+export { Command as t };
+//# sourceMappingURL=command-DcebcSrL.d.mts.map

package/dist/command-DcebcSrL.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-DcebcSrL.d.mts","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/command.ts"],"mappings":";;;;;;cAIa,iBAAA;;;;AAAb;;;;;;;;ACqBA;;;;;;;;;;uBAAsB,OAAA;EA8LmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAA,OA7JhD,OAAA;EA4HC;EAAA,OA1HD,WAAA;EA+HD;EAAA,OA7HC,OAAA;EAAA,CAEN,iBAAA,GAAoB,gBAAA;;EA4IC;;;;EAAA,SA3Hb,MAAA,CAAA,mBAA0B,OAAA;EAsIa;;;EA/HhD,KAAA,GAAA,CAAS,IAAA,WAAe,CAAA;;;;EAOxB,MAAA,CAAO,IAAA;;;;EAcP,OAAA,CAAQ,IAAA;;;;EAcR,MAAA,CAAO,IAAA;;;;EAeP,KAAA,CAAM,IAAA;;EAcN,IAAA,CAAK,OAAA;;EAKL,OAAA,CAAQ,OAAA;;EAKR,IAAA,CAAK,OAAA;;EAKL,KAAA,CAAM,OAAA;;EAKN,IAAA,CAAK,OAAA;;EAKL,OAAA,CAAA;;EAKA,OAAA,CAAQ,OAAA;;EAKR,KAAA,CAAM,OAAA,YAAmB,IAAA;;EAiBzB,IAAA,CAAK,OAAA,UAAiB,QAAA;;;;;EAWhB,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;AAAA"}