stratal 0.0.16 → 0.0.18

package/README.md

@@ -80,6 +80,10 @@ Stratal provides [Agent Skills](https://agentskills.io) for AI coding assistants
 npx skills add strataljs/stratal
 ```
 
+| Skill | Description |
+|---|---|
+| `stratal` | Build Cloudflare Workers apps with the Stratal framework — modules, DI, controllers, routing, OpenAPI, queues, cron, events, seeders, CLI, auth, database, RBAC, testing, and more |
+
 ## Quick Start
 
 Define a module with a controller and wire it up as a Cloudflare Worker:

package/dist/bin/cloudflare-workers-loader.mjs

@@ -1,21 +1,37 @@
 #!/usr/bin/env -S node --no-warnings
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 //#region src/bin/cloudflare-workers-loader.ts
 /**
-* ESM loader hook that provides a virtual `cloudflare:workers` module.
+* ESM loader hook that provides a virtual `cloudflare:workers` module
+* and handles Vite-style `?raw` imports (returning file contents as a string).
 *
 * When registered via `node --import` or `register()`, this intercepts
 * `import('cloudflare:workers')` and returns a module that reads `env`
 * and `waitUntil` from `globalThis.__stratalPlatformProxy`.
 */
 const VIRTUAL_URL = "cloudflare-workers:virtual";
+const RAW_SUFFIX = "?raw";
 async function resolve(specifier, context, nextResolve) {
 	if (specifier === "cloudflare:workers") return {
 		url: VIRTUAL_URL,
 		shortCircuit: true
 	};
+	if (specifier.endsWith(RAW_SUFFIX)) return {
+		url: (await nextResolve(specifier.slice(0, -4), context)).url + RAW_SUFFIX,
+		shortCircuit: true
+	};
 	return nextResolve(specifier, context);
 }
 async function load(url, context, nextLoad) {
+	if (url.endsWith(RAW_SUFFIX)) {
+		const content = readFileSync(fileURLToPath(url.slice(0, -4)), "utf-8");
+		return {
+			format: "module",
+			shortCircuit: true,
+			source: `export default ${JSON.stringify(content)}`
+		};
+	}
 	if (url === VIRTUAL_URL) return {
 		format: "module",
 		shortCircuit: true,
@@ -24,6 +40,22 @@ const proxy = globalThis.__stratalPlatformProxy;
 if (!proxy) throw new Error('globalThis.__stratalPlatformProxy not set — Quarry CLI must initialize it before importing the app entry.');
 export const env = proxy.env;
 export const waitUntil = proxy.waitUntil;
+export const exports = {}
+export class DurableObject {
+  constructor(ctx, env) { this.ctx = ctx; this.env = env; }
+}
+export class WorkerEntrypoint {
+  constructor(ctx, env) { this.ctx = ctx; this.env = env; }
+}
+export class WorkflowEntrypoint {
+  constructor(ctx, env) { this.ctx = ctx; this.env = env; }
+}
+export class WorkflowStep {}
+export class RpcTarget {}
+export const RpcStub = function(value) { return value; };
+export function withEnv(newEnv, fn) { return fn(); }
+export function withExports(newExports, fn) { return fn(); }
+export function withEnvAndExports(newEnv, newExports, fn) { return fn(); }
 `
 	};
 	return nextLoad(url, context);

package/dist/bin/cloudflare-workers-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare-workers-loader.mjs","names":[],"sources":["../../src/bin/cloudflare-workers-loader.ts"],"sourcesContent":["/**\n * ESM loader hook that provides a virtual `cloudflare:workers` module.\n *\n * When registered via `node --import` or `register()`, this intercepts\n * `import('cloudflare:workers')` and returns a module that reads `env`\n * and `waitUntil` from `globalThis.__stratalPlatformProxy`.\n */\n\nconst VIRTUAL_URL = 'cloudflare-workers:virtual'\n\ninterface ResolveContext {\n  parentURL?: string\n  conditions: string[]\n}\n\ninterface ResolveResult {\n  url: string\n  shortCircuit?: boolean\n}\n\ntype NextResolve = (specifier: string, context: ResolveContext) => Promise<ResolveResult>\n\nexport async function resolve(\n  specifier: string,\n  context: ResolveContext,\n  nextResolve: NextResolve,\n): Promise<ResolveResult> {\n  if (specifier === 'cloudflare:workers') {\n    return { url: VIRTUAL_URL, shortCircuit: true }\n  }\n  return nextResolve(specifier, context)\n}\n\ninterface LoadContext {\n  format?: string\n  conditions: string[]\n}\n\ninterface LoadResult {\n  format: string\n  source: string\n  shortCircuit?: boolean\n}\n\ntype NextLoad = (url: string, context: LoadContext) => Promise<LoadResult>\n\nexport async function load(\n  url: string,\n  context: LoadContext,\n  nextLoad: NextLoad,\n): Promise<LoadResult> {\n  if (url === VIRTUAL_URL) {\n    return {\n      format: 'module',\n      shortCircuit: true,\n      source: `\nconst proxy = globalThis.__stratalPlatformProxy;\nif (!proxy) throw new Error('globalThis.__stratalPlatformProxy not set — Quarry CLI must initialize it before importing the app entry.');\nexport const env = proxy.env;\nexport const waitUntil = proxy.waitUntil;\n`,\n    }\n  }\n  return nextLoad(url, context)\n}\n"],"mappings":";;;;;;;;;AAQA,MAAM,cAAc;AAcpB,eAAsB,QACpB,WACA,SACA,aACwB;AACxB,KAAI,cAAc,qBAChB,QAAO;EAAE,KAAK;EAAa,cAAc;EAAM;AAEjD,QAAO,YAAY,WAAW,QAAQ;;AAgBxC,eAAsB,KACpB,KACA,SACA,UACqB;AACrB,KAAI,QAAQ,YACV,QAAO;EACL,QAAQ;EACR,cAAc;EACd,QAAQ;;;;;;EAMT;AAEH,QAAO,SAAS,KAAK,QAAQ"}
+{"version":3,"file":"cloudflare-workers-loader.mjs","names":[],"sources":["../../src/bin/cloudflare-workers-loader.ts"],"sourcesContent":["/**\n * ESM loader hook that provides a virtual `cloudflare:workers` module\n * and handles Vite-style `?raw` imports (returning file contents as a string).\n *\n * When registered via `node --import` or `register()`, this intercepts\n * `import('cloudflare:workers')` and returns a module that reads `env`\n * and `waitUntil` from `globalThis.__stratalPlatformProxy`.\n */\n\nimport { readFileSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nconst VIRTUAL_URL = 'cloudflare-workers:virtual'\nconst RAW_SUFFIX = '?raw'\n\ninterface ResolveContext {\n  parentURL?: string\n  conditions: string[]\n}\n\ninterface ResolveResult {\n  url: string\n  shortCircuit?: boolean\n}\n\ntype NextResolve = (specifier: string, context: ResolveContext) => Promise<ResolveResult>\n\nexport async function resolve(\n  specifier: string,\n  context: ResolveContext,\n  nextResolve: NextResolve,\n): Promise<ResolveResult> {\n  if (specifier === 'cloudflare:workers') {\n    return { url: VIRTUAL_URL, shortCircuit: true }\n  }\n  if (specifier.endsWith(RAW_SUFFIX)) {\n    const base = specifier.slice(0, -RAW_SUFFIX.length)\n    const resolved = await nextResolve(base, context)\n    return { url: resolved.url + RAW_SUFFIX, shortCircuit: true }\n  }\n  return nextResolve(specifier, context)\n}\n\ninterface LoadContext {\n  format?: string\n  conditions: string[]\n}\n\ninterface LoadResult {\n  format: string\n  source: string\n  shortCircuit?: boolean\n}\n\ntype NextLoad = (url: string, context: LoadContext) => Promise<LoadResult>\n\nexport async function load(\n  url: string,\n  context: LoadContext,\n  nextLoad: NextLoad,\n): Promise<LoadResult> {\n  if (url.endsWith(RAW_SUFFIX)) {\n    const fileUrl = url.slice(0, -RAW_SUFFIX.length)\n    const filePath = fileURLToPath(fileUrl)\n    const content = readFileSync(filePath, 'utf-8')\n    return {\n      format: 'module',\n      shortCircuit: true,\n      source: `export default ${JSON.stringify(content)}`,\n    }\n  }\n  if (url === VIRTUAL_URL) {\n    return {\n      format: 'module',\n      shortCircuit: true,\n      source: `\nconst proxy = globalThis.__stratalPlatformProxy;\nif (!proxy) throw new Error('globalThis.__stratalPlatformProxy not set — Quarry CLI must initialize it before importing the app entry.');\nexport const env = proxy.env;\nexport const waitUntil = proxy.waitUntil;\nexport const exports = {}\nexport class DurableObject {\n  constructor(ctx, env) { this.ctx = ctx; this.env = env; }\n}\nexport class WorkerEntrypoint {\n  constructor(ctx, env) { this.ctx = ctx; this.env = env; }\n}\nexport class WorkflowEntrypoint {\n  constructor(ctx, env) { this.ctx = ctx; this.env = env; }\n}\nexport class WorkflowStep {}\nexport class RpcTarget {}\nexport const RpcStub = function(value) { return value; };\nexport function withEnv(newEnv, fn) { return fn(); }\nexport function withExports(newExports, fn) { return fn(); }\nexport function withEnvAndExports(newEnv, newExports, fn) { return fn(); }\n`,\n    }\n  }\n  return nextLoad(url, context)\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAM,cAAc;AACpB,MAAM,aAAa;AAcnB,eAAsB,QACpB,WACA,SACA,aACwB;AACxB,KAAI,cAAc,qBAChB,QAAO;EAAE,KAAK;EAAa,cAAc;EAAM;AAEjD,KAAI,UAAU,SAAS,WAAW,CAGhC,QAAO;EAAE,MADQ,MAAM,YADV,UAAU,MAAM,GAAG,GAAmB,EACV,QAAQ,EAC1B,MAAM;EAAY,cAAc;EAAM;AAE/D,QAAO,YAAY,WAAW,QAAQ;;AAgBxC,eAAsB,KACpB,KACA,SACA,UACqB;AACrB,KAAI,IAAI,SAAS,WAAW,EAAE;EAG5B,MAAM,UAAU,aADC,cADD,IAAI,MAAM,GAAG,GAAmB,CACT,EACA,QAAQ;AAC/C,SAAO;GACL,QAAQ;GACR,cAAc;GACd,QAAQ,kBAAkB,KAAK,UAAU,QAAQ;GAClD;;AAEH,KAAI,QAAQ,YACV,QAAO;EACL,QAAQ;EACR,cAAc;EACd,QAAQ;;;;;;;;;;;;;;;;;;;;;;EAsBT;AAEH,QAAO,SAAS,KAAK,QAAQ"}

package/dist/bin/quarry.mjs

@@ -1,10 +1,136 @@
 #!/usr/bin/env -S node --no-warnings
 import { createRequire, register } from "node:module";
 import "reflect-metadata";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Command, Option } from "clipanion";
+//#region src/i18n/messages/en/errors.ts
+/**
+* System Error Messages - English
+*
+* Error messages used by packages/modules infrastructure.
+* These are automatically merged with application-specific messages.
+*/
+const errors = {
+	internalError: "An internal error occurred",
+	notFound: "Resource not found",
+	unauthorized: "Unauthorized. Please sign in.",
+	forbidden: "Access denied",
+	honoAppAlreadyConfigured: "HonoApp has already been configured and can only be configured once",
+	routeNotFound: "Route not found: {method} {path}",
+	routeAccessDenied: "Resource not found",
+	controllerMethodNotFound: "Method {methodName} not found on {controllerName}",
+	controllerRegistration: "Failed to register controller {controllerName}: {reason}",
+	duplicateRouteName: "Duplicate route name \"{name}\". Already registered by {existingHandler}, cannot register {newHandler}.",
+	routeNameNotFound: "Route \"{name}\" not found in registry.",
+	missingRouteParam: "Missing required parameter \"{param}\" for route \"{name}\" (path: {path}).",
+	routerUseScopeViolation: "router.use() can only be called on the root Router, not inside group() callbacks. Use router.middleware() for scoped middleware.",
+	missingEnvironmentVariable: "Environment variable \"{variable}\" is required but not set.",
+	websocketBodyNotAvailable: "body() is not available in WebSocket gateways. Use WebSocket messages instead.",
+	websocketDuplicateEventHandler: "@{decorator}() is already applied to '{existingMethod}'. Only one method per gateway can handle this event.",
+	contextNotInitialized: "Context has not been initialized",
+	userNotAuthenticated: "User is not authenticated",
+	insufficientPermissions: "Insufficient permissions to perform this action",
+	requestContainerNotInitialized: "Request container has not been initialized",
+	requestScopeOperationNotAllowed: "{methodName}() cannot be called on this container scope. Check if you are calling it on the correct container (global vs request-scoped).",
+	conditionalBindingFallback: "Conditional binding predicate returned false for token \"{token}\" but no fallback was provided and no existing registration exists.",
+	configNotInitialized: "Configuration service has not been initialized",
+	configModuleNotInitialized: "ConfigModule.forRoot() was not called before module initialization",
+	stratalNotInitialized: "Stratal has not been instantiated. Ensure you export a Stratal instance as the default export.",
+	moduleAlreadyRegistered: "Module {moduleName} is already registered",
+	moduleDependencyNotFound: "Module dependency {dependency} not found for module {moduleName}",
+	moduleCircularDependency: "Circular dependency detected: {cycle}",
+	invalidModuleProvider: "Invalid module provider configuration: {provider}",
+	databaseGeneric: "Database error occurred",
+	databaseRecordNotFound: "Record not found in database",
+	databaseUniqueConstraint: "Record already exists",
+	databaseForeignKeyConstraint: "Related record not found",
+	databaseConnectionFailed: "Failed to connect to database",
+	databaseTimeout: "Database query timeout",
+	databaseNullConstraint: "Required field is missing",
+	databaseTooManyConnections: "Too many database connections",
+	databaseTransactionConflict: "Transaction conflict or deadlock",
+	databaseConstraintFailed: "A database constraint was violated",
+	databaseTableNotFound: "The specified table does not exist in the database",
+	databaseColumnNotFound: "The specified column does not exist in the table",
+	databaseInvalidQuery: "The database query is invalid or malformed",
+	invalidErrorCodeRange: "Invalid error code range: {code}",
+	queueBindingNotFound: "Queue binding {queueName} not found in environment",
+	queueProviderNotSupported: "Queue provider \"{provider}\" is not supported. Valid providers: cloudflare, sync",
+	cronExecutionFailed: "{count} cron job(s) failed for schedule \"{schedule}\": {jobs}",
+	localeNotSupported: "Locale '{locale}' is not supported. Supported locales: {supportedLocales}",
+	translationMissing: "Translation missing for key '{key}' in locale '{locale}'",
+	containerNotInitialized: "Application container has not been initialized. Ensure Application.initialize() has been called.",
+	domainMismatch: "The requested domain does not match any configured route",
+	invalidSignature: "The URL signature is invalid or has expired",
+	schemaValidation: "Schema validation failed",
+	responseValidation: "Response validation failed",
+	openapiValidation: "OpenAPI validation failed: {details}",
+	openapiRouteRegistration: "Failed to register OpenAPI route {path}: {reason}",
+	email: {
+		resendApiKeyMissing: "Resend API key not configured. Set RESEND_EMAIL_API_KEY environment variable.",
+		smtpConfigurationMissing: "SMTP configuration missing. Set SMTP_URL environment variable.",
+		smtpHostMissing: "SMTP host not configured. Check SMTP_URL format (smtp://user:pass@host:port).",
+		smtpConnectionFailed: "Failed to connect to SMTP server {smtpHost}:{smtpPort}",
+		resendApiFailed: "Resend API error",
+		providerNotSupported: "Unsupported email provider: {provider}. Supported providers: resend, smtp"
+	},
+	storage: {
+		fileNotFound: "File at path \"{path}\" was not found",
+		invalidDisk: "Storage disk \"{disk}\" is not configured",
+		invalidFileType: "File type \"{mimeType}\" is not allowed",
+		fileTooLarge: "File size {size} exceeds maximum allowed size of {maxSize}",
+		presignedUrlInvalidExpiry: "Expiry must be between {min} and {max} seconds",
+		diskNotConfigured: "Disk \"{disk}\" is not configured",
+		providerNotSupported: "Storage provider \"{provider}\" is not supported",
+		responseBodyMissing: "No body in storage response for path: {path}"
+	},
+	cache: {
+		getFailed: "Failed to retrieve value from cache for key '{key}'",
+		putFailed: "Failed to store value in cache for key '{key}'",
+		deleteFailed: "Failed to delete value from cache for key '{key}'",
+		listFailed: "Failed to list cache keys"
+	},
+	auth: {
+		tokenRequired: "Verification token is required",
+		invalidToken: "Invalid or expired verification token",
+		verificationFailed: "Verification failed. Please try again.",
+		userNotFound: "User not found. Please check your credentials.",
+		invalidCredentials: "Invalid email or password",
+		invalidPassword: "Invalid password",
+		invalidEmail: "Invalid email address",
+		sessionExpired: "Your session has expired. Please sign in again.",
+		emailNotVerified: "Please verify your email address before signing in",
+		passwordTooShort: "Password must be at least {minLength} characters",
+		passwordTooLong: "Password must be at most {maxLength} characters",
+		accountAlreadyExists: "An account with this email already exists",
+		failedToCreateUser: "Failed to create user account. Please try again.",
+		failedToCreateSession: "Failed to create session. Please try again.",
+		failedToGetSession: "Failed to retrieve session. Please try again.",
+		failedToUpdateUser: "Failed to update user information. Please try again.",
+		failedToGetUserInfo: "Failed to retrieve user information. Please try again.",
+		socialAccountLinked: "This social account is already linked to another user",
+		providerNotFound: "Authentication provider not found",
+		userEmailNotFound: "User email address not found",
+		accountNotFound: "Account not found",
+		credentialAccountNotFound: "Credential account not found",
+		cannotUnlinkLastAccount: "Cannot unlink your last account",
+		userAlreadyHasPassword: "User already has a password set",
+		emailCannotBeUpdated: "Email address cannot be updated at this time",
+		tokenExpired: "The verification token has expired. Please request a new verification email."
+	},
+	seederNameCollision: "Seeder name collision: \"{name}\" is already registered. Use distinct class names for each seeder.",
+	seederNotRegistered: "Seeder \"{name}\" is not registered",
+	migration: {
+		failed: "Migration {migrationName} failed: {error}",
+		checksumMismatch: "Migration {migrationName} checksum mismatch (expected: {expected}, actual: {actual})",
+		alreadyApplied: "Migration {migrationName} has already been applied",
+		notFound: "Migration {migrationName} not found"
+	}
+};
+//#endregion
 //#region src/bin/commands/dynamic-command.ts
 /** Create Clipanion command classes from Quarry-registered commands. */
 function createDynamicCommands(quarry, parseSignature, app) {
@@ -14,6 +140,7 @@ function createDynamicCommands(quarry, parseSignature, app) {
 		const signature = parseSignature(commandClass.command);
 		const paths = [entry.name.split(" ")];
 		if (commandClass.aliases) for (const alias of commandClass.aliases) paths.push(alias.split(" "));
+		if (entry.name === "help") paths.push([]);
 		class DynCmd extends Command {
 			static paths = paths;
 			static usage = commandClass.description ? Command.Usage({ description: commandClass.description }) : void 0;
@@ -59,55 +186,6 @@ function createDynamicCommands(quarry, parseSignature, app) {
 	return commands;
 }
 //#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/bin/commands/help-command.ts
-/** Create the built-in `help`/`list` Clipanion command that delegates to Quarry's usage generator. */
-function createHelpCommand(quarry) {
-	class HelpCommand extends Command {
-		static paths = [
-			[],
-			["help"],
-			["list"]
-		];
-		static usage = Command.Usage({ description: "Show help for a command" });
-		commandPath = Option.Rest();
-		async execute() {
-			const commandName = this.commandPath.join(" ");
-			if (this.help || !commandName) {
-				const listing = await quarry.listUsage({
-					binaryName: this.cli.binaryName,
-					binaryLabel: this.cli.binaryLabel,
-					binaryVersion: this.cli.binaryVersion
-				});
-				this.context.stdout.write(listing + "\n");
-				return 0;
-			}
-			try {
-				const usage = await quarry.usage(commandName);
-				this.context.stdout.write(usage + "\n");
-				return 0;
-			} catch (error) {
-				if (error instanceof CommandNotFoundError) {
-					this.context.stderr.write(`Unknown command: ${commandName}\n`);
-					return 1;
-				}
-				throw error;
-			}
-		}
-	}
-	return HelpCommand;
-}
-//#endregion
 //#region src/bin/quarry.ts
 const require = createRequire(import.meta.url);
 register(pathToFileURL(join(dirname(require.resolve("@swc-node/register")), "esm/esm.mjs")), pathToFileURL("./"));
@@ -127,9 +205,53 @@ if (!existsSync(entryPath)) {
 	console.error("  npx quarry ./path/to/entry.ts <command> [options]");
 	process.exit(1);
 }
+function stripDurableObjects(config) {
+	delete config.durable_objects;
+	delete config.migrations;
+	if (config.env && typeof config.env === "object") for (const envConfig of Object.values(config.env)) {
+		delete envConfig.durable_objects;
+		delete envConfig.migrations;
+	}
+}
+async function createStrippedConfig(cwdRequire) {
+	const configName = [
+		"wrangler.jsonc",
+		"wrangler.json",
+		"wrangler.toml"
+	].find((c) => existsSync(resolve(process.cwd(), c)));
+	if (!configName) return void 0;
+	const raw = readFileSync(resolve(process.cwd(), configName), "utf-8");
+	let config;
+	if (configName.endsWith(".toml")) {
+		const { parse } = await import(cwdRequire.resolve("smol-toml"));
+		config = parse(raw);
+	} else {
+		const { parse: parseJsonc } = await import(cwdRequire.resolve("jsonc-parser"));
+		config = parseJsonc(raw);
+	}
+	stripDurableObjects(config);
+	const tmpPath = resolve(tmpdir(), `quarry-wrangler-${Date.now()}.json`);
+	writeFileSync(tmpPath, JSON.stringify(config, null, 2));
+	return tmpPath;
+}
+function discoverEnvFiles() {
+	const cwd = process.cwd();
+	return readdirSync(cwd).filter((file) => (/^\.dev\.vars($|\.)/.test(file) || /^\.env($|\.)/.test(file)) && !file.endsWith(".example") && !file.endsWith(".sample")).sort((a, b) => {
+		const aIsDevVars = a.startsWith(".dev.vars");
+		if (aIsDevVars !== b.startsWith(".dev.vars")) return aIsDevVars ? 1 : -1;
+		const aIsLocal = a.endsWith(".local");
+		if (aIsLocal !== b.endsWith(".local")) return aIsLocal ? 1 : -1;
+		return a.localeCompare(b);
+	}).map((file) => join(cwd, file));
+}
 async function main() {
-	const { getPlatformProxy } = await import(createRequire(join(process.cwd(), "package.json")).resolve("wrangler"));
-	const { env, ctx, dispose } = await getPlatformProxy();
+	const cwdRequire = createRequire(join(process.cwd(), "package.json"));
+	const { getPlatformProxy } = await import(cwdRequire.resolve("wrangler"));
+	const tmpConfigPath = await createStrippedConfig(cwdRequire);
+	const { env, ctx, dispose } = await getPlatformProxy({
+		envFiles: discoverEnvFiles(),
+		configPath: tmpConfigPath
+	});
 	let app;
 	try {
 		globalThis.__stratalPlatformProxy = {
@@ -150,16 +272,22 @@ async function main() {
 			binaryLabel: "Quarry CLI",
 			binaryVersion: require("../../package.json").version
 		});
-		cli.register(createHelpCommand(quarry));
 		for (const cmd of createDynamicCommands(quarry, parseSignature, app)) cli.register(cmd);
 		await cli.runExit(process.argv.slice(2), { ...Cli.defaultContext });
 	} finally {
 		await app?.shutdown();
 		await dispose();
+		if (tmpConfigPath) try {
+			unlinkSync(tmpConfigPath);
+		} catch {}
 	}
 }
-main().catch((error) => {
-	console.error("Fatal error:", error instanceof Error ? error.message : String(error));
+main().catch(async (error) => {
+	const { ConfigValidationError } = await import("stratal/config");
+	const { StratalNotInitializedError } = await import("stratal/errors");
+	const message = error instanceof StratalNotInitializedError ? errors.stratalNotInitialized : error instanceof Error ? error.message : String(error);
+	console.error("Fatal error:", message);
+	if (error instanceof ConfigValidationError) console.error(error.errors.message);
 	process.exit(1);
 });
 //#endregion

package/dist/bin/quarry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"quarry.mjs","names":[],"sources":["../../src/bin/commands/dynamic-command.ts","../../src/quarry/errors/command-not-found.error.ts","../../src/bin/commands/help-command.ts","../../src/bin/quarry.ts"],"sourcesContent":["import { Command, type CommandClass, Option, type Usage } from 'clipanion'\n\nimport type { Application } from 'stratal'\nimport type { QuarryRegistry } from 'stratal/quarry'\nimport type { ParsedSignature } from 'stratal/quarry'\n\n/** Create Clipanion command classes from Quarry-registered commands. */\nexport function createDynamicCommands(\n  quarry: QuarryRegistry,\n  parseSignature: (command: string) => ParsedSignature,\n  app: Application,\n) {\n  const commands: CommandClass[] = []\n\n  for (const entry of quarry.list()) {\n    const commandClass = quarry.get(entry.name)! as unknown as { command: string; description?: string; aliases?: string[] }\n    const signature = parseSignature(commandClass.command)\n\n    const paths: string[][] = [entry.name.split(' ')]\n    if (commandClass.aliases) {\n      for (const alias of commandClass.aliases) {\n        paths.push(alias.split(' '))\n      }\n    }\n\n    class DynCmd extends Command {\n      static override paths = paths\n      static override usage: Usage | undefined = commandClass.description\n        ? Command.Usage({ description: commandClass.description })\n        : undefined\n\n      async execute(): Promise<number> {\n        const input: Record<string, unknown> = {}\n\n        for (const arg of signature.arguments) {\n          const value = (this as Record<string, unknown>)[arg.name]\n          if (value !== undefined) input[arg.name] = value\n        }\n\n        for (const opt of signature.options) {\n          const value = (this as Record<string, unknown>)[opt.name]\n          if (value !== undefined) input[opt.name] = value\n        }\n\n        const result = await app.handleCommand(entry.name, input)\n\n        for (const line of result.output) {\n          this.context.stdout.write(line + '\\n')\n        }\n\n        for (const err of result.errors) {\n          this.context.stderr.write(err + '\\n')\n        }\n\n        return result.exitCode\n      }\n    }\n\n    // Define Clipanion options/arguments as class property defaults\n    const proto = DynCmd.prototype as unknown as Record<string, unknown>\n    for (const arg of signature.arguments) {\n      if (arg.isArray) {\n        proto[arg.name] = Option.Rest({ name: arg.name, required: arg.required ? 1 : 0 })\n      } else {\n        proto[arg.name] = Option.String({ name: arg.name, required: arg.required })\n      }\n    }\n\n    for (const opt of signature.options) {\n      const optName = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n      const optDescParts: string[] = []\n      if (opt.description) optDescParts.push(opt.description)\n      if (opt.default !== undefined) optDescParts.push(`(default: ${opt.default})`)\n      const optDesc = optDescParts.length > 0 ? optDescParts.join(' ') : undefined\n\n      if (opt.isFlag) {\n        proto[opt.name] = Option.Boolean(optName, { description: optDesc })\n      } else if (opt.isArray) {\n        if (opt.default !== undefined) {\n          proto[opt.name] = Option.Array(optName, [opt.default], { description: optDesc })\n        } else {\n          proto[opt.name] = Option.Array(optName, { description: optDesc })\n        }\n      } else {\n        if (opt.default !== undefined) {\n          proto[opt.name] = Option.String(optName, opt.default, { description: optDesc })\n        } else {\n          proto[opt.name] = Option.String(optName, { description: optDesc })\n        }\n      }\n    }\n\n    commands.push(DynCmd)\n  }\n\n  return commands\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 { Command, Option, type Usage } from 'clipanion'\nimport { CommandNotFoundError } from '../../quarry/errors/command-not-found.error'\nimport type { QuarryRegistry } from '../../quarry/quarry-registry'\n\n/** Create the built-in `help`/`list` Clipanion command that delegates to Quarry's usage generator. */\nexport function createHelpCommand(quarry: QuarryRegistry) {\n  class HelpCommand extends Command {\n    static override paths = [[], ['help'], ['list']]\n    static override usage: Usage = Command.Usage({ description: 'Show help for a command' })\n\n    commandPath = Option.Rest()\n\n    async execute(): Promise<number> {\n      const commandName = this.commandPath.join(' ')\n\n      if (this.help || !commandName) {\n        const listing = await quarry.listUsage({\n          binaryName: this.cli.binaryName,\n          binaryLabel: this.cli.binaryLabel,\n          binaryVersion: this.cli.binaryVersion,\n        })\n        this.context.stdout.write(listing + '\\n')\n        return 0\n      }\n\n      try {\n        const usage = await quarry.usage(commandName)\n        this.context.stdout.write(usage + '\\n')\n        return 0\n      } catch (error) {\n        if (error instanceof CommandNotFoundError) {\n          this.context.stderr.write(`Unknown command: ${commandName}\\n`)\n          return 1\n        }\n        throw error\n      }\n    }\n  }\n\n  return HelpCommand\n}\n","import 'reflect-metadata'\n\nimport { existsSync } from 'node:fs'\nimport { createRequire, register } from 'node:module'\nimport { dirname, join, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { QuarryRegistry } from 'stratal/quarry'\n\nimport { type Application } from '../application'\nimport { createDynamicCommands } from './commands/dynamic-command'\nimport { createHelpCommand } from './commands/help-command'\n\nconst require = createRequire(import.meta.url)\n\n// Register @swc-node/register for TypeScript + decorator support\nconst swcRegisterPath = join(dirname(require.resolve('@swc-node/register')), 'esm/esm.mjs')\nregister(pathToFileURL(swcRegisterPath), pathToFileURL('./'))\n\n// Register cloudflare:workers virtual module loader\nregister(new URL('./cloudflare-workers-loader.mjs', import.meta.url), pathToFileURL('./'))\n\nconst DEFAULT_ENTRY = './src/index.ts'\n\n// Determine entry file: if first arg looks like a file path, use it; otherwise use default\nconst firstArg = process.argv[2]\nlet entryFile = DEFAULT_ENTRY\n\nif (firstArg && (firstArg.includes('/') || firstArg.includes('\\\\') || /\\.(ts|js|mts|mjs)$/.test(firstArg))) {\n  entryFile = firstArg\n  // Remove the entry file from argv so Clipanion sees: [node, script, command, ...options]\n  process.argv.splice(2, 1)\n}\n\n// Resolve and validate the entry file\nconst entryPath = resolve(process.cwd(), entryFile)\n\nif (!existsSync(entryPath)) {\n  console.error(`Error: Entry file not found: ${entryFile}`)\n  console.error('')\n  console.error('Create src/index.ts with a default Stratal export, or specify a custom path:')\n  console.error('  npx quarry ./path/to/entry.ts <command> [options]')\n  process.exit(1)\n}\n\nasync function main(): Promise<void> {\n  const cwdRequire = createRequire(join(process.cwd(), 'package.json'))\n  // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n  const { getPlatformProxy } = await import(cwdRequire.resolve('wrangler')) as typeof import('wrangler')\n  const { env, ctx, dispose } = await getPlatformProxy()\n\n  let app: Application | undefined\n  try {\n    // Store platform proxy on globalThis so the cloudflare:workers virtual module can read it\n    (globalThis as Record<string, unknown>).__stratalPlatformProxy = {\n      env,\n      waitUntil: ctx.waitUntil.bind(ctx),\n    }\n\n    // Import user's entry file — triggers `new Stratal(...)` + full Application init\n    await import(pathToFileURL(entryPath).href)\n\n    // Parallel import of stratal modules\n    const [\n      { Stratal },\n      { DI_TOKENS },\n      { parseSignature },\n    ] = await Promise.all([\n      import('stratal'),\n      import('stratal/di'),\n      import('stratal/quarry'),\n    ])\n\n    app = await Stratal.resolveApplication()\n    const quarry = app.container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Build Clipanion CLI\n    const { Cli } = await import('clipanion')\n    const pkg = require('../../package.json') as { version: string }\n\n    const cli = new Cli({\n      binaryName: 'quarry',\n      binaryLabel: 'Quarry CLI',\n      binaryVersion: pkg.version,\n    })\n\n    cli.register(createHelpCommand(quarry))\n\n    for (const cmd of createDynamicCommands(quarry, parseSignature, app)) {\n      cli.register(cmd)\n    }\n\n    await cli.runExit(process.argv.slice(2), { ...Cli.defaultContext })\n  } finally {\n    await app?.shutdown()\n    await dispose()\n  }\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal error:', error instanceof Error ? error.message : String(error))\n  process.exit(1)\n})\n"],"mappings":"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"}
+{"version":3,"file":"quarry.mjs","names":["errorMessages"],"sources":["../../src/i18n/messages/en/errors.ts","../../src/bin/commands/dynamic-command.ts","../../src/bin/quarry.ts"],"sourcesContent":["/**\n * System Error Messages - English\n *\n * Error messages used by packages/modules infrastructure.\n * These are automatically merged with application-specific messages.\n */\n\nexport const errors = {\n  // Generic errors\n  internalError: 'An internal error occurred',\n  notFound: 'Resource not found',\n  unauthorized: 'Unauthorized. Please sign in.',\n  forbidden: 'Access denied',\n\n  // Router errors\n  honoAppAlreadyConfigured: 'HonoApp has already been configured and can only be configured once',\n  routeNotFound: 'Route not found: {method} {path}',\n  routeAccessDenied: 'Resource not found',\n  controllerMethodNotFound: 'Method {methodName} not found on {controllerName}',\n  controllerRegistration: 'Failed to register controller {controllerName}: {reason}',\n  duplicateRouteName: 'Duplicate route name \"{name}\". Already registered by {existingHandler}, cannot register {newHandler}.',\n  routeNameNotFound: 'Route \"{name}\" not found in registry.',\n  missingRouteParam: 'Missing required parameter \"{param}\" for route \"{name}\" (path: {path}).',\n  routerUseScopeViolation: 'router.use() can only be called on the root Router, not inside group() callbacks. Use router.middleware() for scoped middleware.',\n  missingEnvironmentVariable: 'Environment variable \"{variable}\" is required but not set.',\n\n  // WebSocket errors\n  websocketBodyNotAvailable: 'body() is not available in WebSocket gateways. Use WebSocket messages instead.',\n  websocketDuplicateEventHandler: '@{decorator}() is already applied to \\'{existingMethod}\\'. Only one method per gateway can handle this event.',\n\n  // Context errors\n  contextNotInitialized: 'Context has not been initialized',\n  userNotAuthenticated: 'User is not authenticated',\n  insufficientPermissions: 'Insufficient permissions to perform this action',\n  requestContainerNotInitialized: 'Request container has not been initialized',\n  requestScopeOperationNotAllowed: '{methodName}() cannot be called on this container scope. Check if you are calling it on the correct container (global vs request-scoped).',\n  conditionalBindingFallback: 'Conditional binding predicate returned false for token \"{token}\" but no fallback was provided and no existing registration exists.',\n\n  // Configuration errors\n  configNotInitialized: 'Configuration service has not been initialized',\n  configModuleNotInitialized: 'ConfigModule.forRoot() was not called before module initialization',\n  stratalNotInitialized: 'Stratal has not been instantiated. Ensure you export a Stratal instance as the default export.',\n\n  // Module errors\n  moduleAlreadyRegistered: 'Module {moduleName} is already registered',\n  moduleDependencyNotFound: 'Module dependency {dependency} not found for module {moduleName}',\n  moduleCircularDependency: 'Circular dependency detected: {cycle}',\n  invalidModuleProvider: 'Invalid module provider configuration: {provider}',\n\n  // Database errors\n  databaseGeneric: 'Database error occurred',\n  databaseRecordNotFound: 'Record not found in database',\n  databaseUniqueConstraint: 'Record already exists',\n  databaseForeignKeyConstraint: 'Related record not found',\n  databaseConnectionFailed: 'Failed to connect to database',\n  databaseTimeout: 'Database query timeout',\n  databaseNullConstraint: 'Required field is missing',\n  databaseTooManyConnections: 'Too many database connections',\n  databaseTransactionConflict: 'Transaction conflict or deadlock',\n  databaseConstraintFailed: 'A database constraint was violated',\n  databaseTableNotFound: 'The specified table does not exist in the database',\n  databaseColumnNotFound: 'The specified column does not exist in the table',\n  databaseInvalidQuery: 'The database query is invalid or malformed',\n  invalidErrorCodeRange: 'Invalid error code range: {code}',\n\n  // Queue errors\n  queueBindingNotFound: 'Queue binding {queueName} not found in environment',\n  queueProviderNotSupported: 'Queue provider \"{provider}\" is not supported. Valid providers: cloudflare, sync',\n\n  // Cron errors\n  cronExecutionFailed: '{count} cron job(s) failed for schedule \"{schedule}\": {jobs}',\n\n  // i18n errors\n  localeNotSupported: \"Locale '{locale}' is not supported. Supported locales: {supportedLocales}\",\n  translationMissing: \"Translation missing for key '{key}' in locale '{locale}'\",\n\n  // Container errors\n  containerNotInitialized: 'Application container has not been initialized. Ensure Application.initialize() has been called.',\n\n  // Domain routing errors\n  domainMismatch: 'The requested domain does not match any configured route',\n\n  // Signature errors\n  invalidSignature: 'The URL signature is invalid or has expired',\n\n  // Schema validation errors\n  schemaValidation: 'Schema validation failed',\n  responseValidation: 'Response validation failed',\n\n  // OpenAPI errors\n  openapiValidation: 'OpenAPI validation failed: {details}',\n  openapiRouteRegistration: 'Failed to register OpenAPI route {path}: {reason}',\n\n  // Email errors\n  email: {\n    resendApiKeyMissing: 'Resend API key not configured. Set RESEND_EMAIL_API_KEY environment variable.',\n    smtpConfigurationMissing: 'SMTP configuration missing. Set SMTP_URL environment variable.',\n    smtpHostMissing: 'SMTP host not configured. Check SMTP_URL format (smtp://user:pass@host:port).',\n    smtpConnectionFailed: 'Failed to connect to SMTP server {smtpHost}:{smtpPort}',\n    resendApiFailed: 'Resend API error',\n    providerNotSupported: 'Unsupported email provider: {provider}. Supported providers: resend, smtp'\n  },\n\n  // Storage errors\n  storage: {\n    fileNotFound: 'File at path \"{path}\" was not found',\n    invalidDisk: 'Storage disk \"{disk}\" is not configured',\n    invalidFileType: 'File type \"{mimeType}\" is not allowed',\n    fileTooLarge: 'File size {size} exceeds maximum allowed size of {maxSize}',\n    presignedUrlInvalidExpiry: 'Expiry must be between {min} and {max} seconds',\n    diskNotConfigured: 'Disk \"{disk}\" is not configured',\n    providerNotSupported: 'Storage provider \"{provider}\" is not supported',\n    responseBodyMissing: 'No body in storage response for path: {path}'\n  },\n\n  // Cache errors\n  cache: {\n    getFailed: \"Failed to retrieve value from cache for key '{key}'\",\n    putFailed: \"Failed to store value in cache for key '{key}'\",\n    deleteFailed: \"Failed to delete value from cache for key '{key}'\",\n    listFailed: 'Failed to list cache keys'\n  },\n\n  // Authentication errors\n  auth: {\n    tokenRequired: 'Verification token is required',\n    invalidToken: 'Invalid or expired verification token',\n    verificationFailed: 'Verification failed. Please try again.',\n    userNotFound: 'User not found. Please check your credentials.',\n    invalidCredentials: 'Invalid email or password',\n    invalidPassword: 'Invalid password',\n    invalidEmail: 'Invalid email address',\n    sessionExpired: 'Your session has expired. Please sign in again.',\n    emailNotVerified: 'Please verify your email address before signing in',\n    passwordTooShort: 'Password must be at least {minLength} characters',\n    passwordTooLong: 'Password must be at most {maxLength} characters',\n    accountAlreadyExists: 'An account with this email already exists',\n    failedToCreateUser: 'Failed to create user account. Please try again.',\n    failedToCreateSession: 'Failed to create session. Please try again.',\n    failedToGetSession: 'Failed to retrieve session. Please try again.',\n    failedToUpdateUser: 'Failed to update user information. Please try again.',\n    failedToGetUserInfo: 'Failed to retrieve user information. Please try again.',\n    socialAccountLinked: 'This social account is already linked to another user',\n    providerNotFound: 'Authentication provider not found',\n    userEmailNotFound: 'User email address not found',\n    accountNotFound: 'Account not found',\n    credentialAccountNotFound: 'Credential account not found',\n    cannotUnlinkLastAccount: 'Cannot unlink your last account',\n    userAlreadyHasPassword: 'User already has a password set',\n    emailCannotBeUpdated: 'Email address cannot be updated at this time',\n    tokenExpired: 'The verification token has expired. Please request a new verification email.'\n  },\n\n  // Seeder errors\n  seederNameCollision: 'Seeder name collision: \"{name}\" is already registered. Use distinct class names for each seeder.',\n  seederNotRegistered: 'Seeder \"{name}\" is not registered',\n\n  // Migration errors\n  migration: {\n    failed: 'Migration {migrationName} failed: {error}',\n    checksumMismatch: 'Migration {migrationName} checksum mismatch (expected: {expected}, actual: {actual})',\n    alreadyApplied: 'Migration {migrationName} has already been applied',\n    notFound: 'Migration {migrationName} not found',\n  },\n} as const\n","import { Command, type CommandClass, Option, type Usage } from 'clipanion'\n\nimport type { Application } from 'stratal'\nimport type { ParsedSignature, QuarryRegistry } from 'stratal/quarry'\n\n/** Create Clipanion command classes from Quarry-registered commands. */\nexport function createDynamicCommands(\n  quarry: QuarryRegistry,\n  parseSignature: (command: string) => ParsedSignature,\n  app: Application,\n) {\n  const commands: CommandClass[] = []\n\n  for (const entry of quarry.list()) {\n    const commandClass = quarry.get(entry.name)! as unknown as { command: string; description?: string; aliases?: string[] }\n    const signature = parseSignature(commandClass.command)\n\n    const paths: string[][] = [entry.name.split(' ')]\n    if (commandClass.aliases) {\n      for (const alias of commandClass.aliases) {\n        paths.push(alias.split(' '))\n      }\n    }\n\n    // Allow bare `npx quarry` (no arguments) to invoke the help command\n    if (entry.name === 'help') {\n      paths.push([])\n    }\n\n    class DynCmd extends Command {\n      static override paths = paths\n      static override usage: Usage | undefined = commandClass.description\n        ? Command.Usage({ description: commandClass.description })\n        : undefined\n\n      async execute(): Promise<number> {\n        const input: Record<string, unknown> = {}\n\n        for (const arg of signature.arguments) {\n          const value = (this as Record<string, unknown>)[arg.name]\n          if (value !== undefined) input[arg.name] = value\n        }\n\n        for (const opt of signature.options) {\n          const value = (this as Record<string, unknown>)[opt.name]\n          if (value !== undefined) input[opt.name] = value\n        }\n\n        const result = await app.handleCommand(entry.name, input)\n\n        for (const line of result.output) {\n          this.context.stdout.write(line + '\\n')\n        }\n\n        for (const err of result.errors) {\n          this.context.stderr.write(err + '\\n')\n        }\n\n        return result.exitCode\n      }\n    }\n\n    // Define Clipanion options/arguments as class property defaults\n    const proto = DynCmd.prototype as unknown as Record<string, unknown>\n    for (const arg of signature.arguments) {\n      if (arg.isArray) {\n        proto[arg.name] = Option.Rest({ name: arg.name, required: arg.required ? 1 : 0 })\n      } else {\n        proto[arg.name] = Option.String({ name: arg.name, required: arg.required })\n      }\n    }\n\n    for (const opt of signature.options) {\n      const optName = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n      const optDescParts: string[] = []\n      if (opt.description) optDescParts.push(opt.description)\n      if (opt.default !== undefined) optDescParts.push(`(default: ${opt.default})`)\n      const optDesc = optDescParts.length > 0 ? optDescParts.join(' ') : undefined\n\n      if (opt.isFlag) {\n        proto[opt.name] = Option.Boolean(optName, { description: optDesc })\n      } else if (opt.isArray) {\n        if (opt.default !== undefined) {\n          proto[opt.name] = Option.Array(optName, [opt.default], { description: optDesc })\n        } else {\n          proto[opt.name] = Option.Array(optName, { description: optDesc })\n        }\n      } else {\n        if (opt.default !== undefined) {\n          proto[opt.name] = Option.String(optName, opt.default, { description: optDesc })\n        } else {\n          proto[opt.name] = Option.String(optName, { description: optDesc })\n        }\n      }\n    }\n\n    commands.push(DynCmd)\n  }\n\n  return commands\n}\n","import 'reflect-metadata'\n\nimport { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs'\nimport { createRequire, register } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { dirname, join, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { QuarryRegistry } from 'stratal/quarry'\n\nimport { type Application } from '../application'\nimport { errors as errorMessages } from '../i18n/messages/en/errors'\nimport { createDynamicCommands } from './commands/dynamic-command'\n\nconst require = createRequire(import.meta.url)\n\n// Register @swc-node/register for TypeScript + decorator support\nconst swcRegisterPath = join(dirname(require.resolve('@swc-node/register')), 'esm/esm.mjs')\nregister(pathToFileURL(swcRegisterPath), pathToFileURL('./'))\n\n// Register cloudflare:workers virtual module loader\nregister(new URL('./cloudflare-workers-loader.mjs', import.meta.url), pathToFileURL('./'))\n\nconst DEFAULT_ENTRY = './src/index.ts'\n\n// Determine entry file: if first arg looks like a file path, use it; otherwise use default\nconst firstArg = process.argv[2]\nlet entryFile = DEFAULT_ENTRY\n\nif (firstArg && (firstArg.includes('/') || firstArg.includes('\\\\') || /\\.(ts|js|mts|mjs)$/.test(firstArg))) {\n  entryFile = firstArg\n  // Remove the entry file from argv so Clipanion sees: [node, script, command, ...options]\n  process.argv.splice(2, 1)\n}\n\n// Resolve and validate the entry file\nconst entryPath = resolve(process.cwd(), entryFile)\n\nif (!existsSync(entryPath)) {\n  console.error(`Error: Entry file not found: ${entryFile}`)\n  console.error('')\n  console.error('Create src/index.ts with a default Stratal export, or specify a custom path:')\n  console.error('  npx quarry ./path/to/entry.ts <command> [options]')\n  process.exit(1)\n}\n\nfunction stripDurableObjects(config: Record<string, unknown>): void {\n  delete config.durable_objects\n  delete config.migrations\n  if (config.env && typeof config.env === 'object') {\n    for (const envConfig of Object.values(config.env as Record<string, Record<string, unknown>>)) {\n      delete envConfig.durable_objects\n      delete envConfig.migrations\n    }\n  }\n}\n\nasync function createStrippedConfig(cwdRequire: NodeRequire): Promise<string | undefined> {\n  const candidates = ['wrangler.jsonc', 'wrangler.json', 'wrangler.toml']\n  const configName = candidates.find(c => existsSync(resolve(process.cwd(), c)))\n  if (!configName) return undefined\n\n  const configPath = resolve(process.cwd(), configName)\n  const raw = readFileSync(configPath, 'utf-8')\n\n  let config: Record<string, unknown>\n  if (configName.endsWith('.toml')) {\n    const { parse } = await import(cwdRequire.resolve('smol-toml')) as { parse: (input: string) => Record<string, unknown> }\n    config = parse(raw)\n  } else {\n    const { parse: parseJsonc } = await import(cwdRequire.resolve('jsonc-parser')) as { parse: (input: string) => Record<string, unknown> }\n    config = parseJsonc(raw)\n  }\n\n  stripDurableObjects(config)\n\n  const tmpPath = resolve(tmpdir(), `quarry-wrangler-${Date.now()}.json`)\n  writeFileSync(tmpPath, JSON.stringify(config, null, 2))\n  return tmpPath\n}\n\nfunction discoverEnvFiles(): string[] {\n  const cwd = process.cwd()\n  const files = readdirSync(cwd)\n  return files\n    .filter(file => (/^\\.dev\\.vars($|\\.)/.test(file) || /^\\.env($|\\.)/.test(file)) && !file.endsWith('.example') && !file.endsWith('.sample'))\n    .sort((a, b) => {\n      // Load .env files before .dev.vars so .dev.vars takes precedence\n      const aIsDevVars = a.startsWith('.dev.vars')\n      const bIsDevVars = b.startsWith('.dev.vars')\n      if (aIsDevVars !== bIsDevVars) return aIsDevVars ? 1 : -1\n      // Within each group, .local files load last (highest precedence)\n      const aIsLocal = a.endsWith('.local')\n      const bIsLocal = b.endsWith('.local')\n      if (aIsLocal !== bIsLocal) return aIsLocal ? 1 : -1\n      return a.localeCompare(b)\n    })\n    .map(file => join(cwd, file))\n}\n\nasync function main(): Promise<void> {\n  const cwdRequire = createRequire(join(process.cwd(), 'package.json'))\n  // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n  const { getPlatformProxy } = await import(cwdRequire.resolve('wrangler')) as typeof import('wrangler')\n\n  const tmpConfigPath = await createStrippedConfig(cwdRequire)\n  const envFiles = discoverEnvFiles()\n  const { env, ctx, dispose } = await getPlatformProxy({\n    envFiles, configPath: tmpConfigPath,\n  })\n\n  let app: Application | undefined\n  try {\n    // Store platform proxy on globalThis so the cloudflare:workers virtual module can read it\n    (globalThis as Record<string, unknown>).__stratalPlatformProxy = {\n      env,\n      waitUntil: ctx.waitUntil.bind(ctx),\n    }\n\n    // Import user's entry file — triggers `new Stratal(...)` + full Application init\n    await import(pathToFileURL(entryPath).href)\n\n    // Parallel import of stratal modules\n    const [\n      { Stratal },\n      { DI_TOKENS },\n      { parseSignature },\n    ] = await Promise.all([\n      import('stratal'),\n      import('stratal/di'),\n      import('stratal/quarry'),\n    ])\n\n    app = await Stratal.resolveApplication()\n    const quarry = app.container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Build Clipanion CLI\n    const { Cli } = await import('clipanion')\n    const pkg = require('../../package.json') as { version: string }\n\n    const cli = new Cli({\n      binaryName: 'quarry',\n      binaryLabel: 'Quarry CLI',\n      binaryVersion: pkg.version,\n    })\n\n    for (const cmd of createDynamicCommands(quarry, parseSignature, app)) {\n      cli.register(cmd)\n    }\n\n    await cli.runExit(process.argv.slice(2), { ...Cli.defaultContext })\n  } finally {\n    await app?.shutdown()\n    await dispose()\n    if (tmpConfigPath) {\n      try { unlinkSync(tmpConfigPath) } catch {\n        //\n      }\n    }\n  }\n}\n\nmain().catch(async (error: unknown) => {\n  const { ConfigValidationError } = await import('stratal/config')\n  const { StratalNotInitializedError } = await import('stratal/errors')\n\n  const message = error instanceof StratalNotInitializedError\n    ? errorMessages.stratalNotInitialized\n    : error instanceof Error ? error.message : String(error)\n  console.error('Fatal error:', message)\n  if (error instanceof ConfigValidationError) {\n    console.error(error.errors.message)\n  }\n  process.exit(1)\n})\n"],"mappings":"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"}

package/dist/cache/index.d.mts

@@ -1,5 +1,5 @@
-import { Ht as StratalEnv, s as ApplicationError } from "../index-BJWm863C.mjs";
-import { i as LoggerService } from "../index-Dp6A5ywM.mjs";
+import { d as ApplicationError, ir as StratalEnv } from "../index-BrmS34sa.mjs";
+import { i as LoggerService } from "../index-BR23zDMy.mjs";
 
 //#region src/cache/cache.module.d.ts
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cache/cache.module.ts","../../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"],"mappings":";;;;;;;;;AAgBA;;;;;;cAMa,WAAA;;;cCtBA,YAAA;EAAA,SAEH,YAAA;AAAA;AAAA,KAEE,UAAA,WAAqB,YAAA,eAA2B,YAAA;;;;;;;ADY5D;;cEPa,aAAA,SAAsB,gBAAA;cACrB,GAAA;AAAA;;;;;;;AFMd;;cGPa,aAAA,SAAsB,gBAAA;cACrB,GAAA;AAAA;;;;;;;AHMd;;cIPa,gBAAA,SAAyB,gBAAA;cACxB,GAAA;AAAA;;;;;;;AJMd;cKRa,cAAA,SAAuB,gBAAA;EAAA,WAAA,CAAA;AAAA;;;;;;ALQpC;;;;;;;;AChBA;;;;;AAIA;;;;;;;;ACKA;;;;;;;;;cIsCa,YAAA;EAAA,iBAIyC,GAAA;EAAA,iBACI,MAAA;EAAA,QAJhD,EAAA;cAG4C,GAAA,EAAK,UAAA,EACD,MAAA,EAAQ,aAAA;;;;;;;;EAYhE,KAAA,CAAM,EAAA,EAAI,WAAA;;;AFvDZ;;;;;;;;;;;;ACDA;;;;;;;;ACsCA;;;;EAgDE,WAAA,CAAY,EAAA,EAAI,WAAA,GAAc,YAAA;EA9BpB;;;;;;;;EA8CJ,GAAA,CAAI,GAAA,UAAa,aAAA,YAAyB,qBAAA,WAAgC,OAAA;EAC1E,GAAA,yBAAA,CAA6B,GAAA,UAAa,aAAA,WAAwB,qBAAA,WAAgC,OAAA,CAAQ,aAAA;EAC1G,GAAA,CAAI,GAAA,UAAa,aAAA,kBAA+B,qBAAA,kBAAuC,OAAA,CAAQ,WAAA;EAC/F,GAAA,CAAI,GAAA,UAAa,aAAA,aAA0B,qBAAA,aAAkC,OAAA,CAAQ,cAAA;EAAA;;;;;;;;EAkCrF,eAAA,oBAAA,CACJ,GAAA,UACA,aAAA,YAAyB,qBAAA,WACxB,OAAA,CAAQ,gCAAA,SAAyC,QAAA;EAC9C,eAAA,6CAAA,CACJ,GAAA,UACA,aAAA,WAAwB,qBAAA,WACvB,OAAA,CAAQ,gCAAA,CAAiC,aAAA,EAAe,QAAA;EACrD,eAAA,oBAAA,CACJ,GAAA,UACA,aAAA,kBAA+B,qBAAA,kBAC9B,OAAA,CAAQ,gCAAA,CAAiC,WAAA,EAAa,QAAA;EACnD,eAAA,oBAAA,CACJ,GAAA,UACA,aAAA,aAA0B,qBAAA,aACzB,OAAA,CAAQ,gCAAA,CAAiC,cAAA,EAAgB,QAAA;EAJhB;;;;;;;;;;;;;;;;;;;;EAuDtC,GAAA,CACJ,GAAA,UACA,KAAA,WAAgB,WAAA,GAAc,eAAA,GAAkB,cAAA,EAChD,OAAA,GAAU,qBAAA,GACT,OAAA;EAtKiD;;;;;;EAuL9C,MAAA,CAAO,GAAA,WAAc,OAAA;EAtL6B;;;;;;;;;;;;;;;;;;;;;;EAwNlD,IAAA,oBAAA,CACJ,OAAA,GAAU,sBAAA,GACT,OAAA,CAAQ,qBAAA,CAAsB,QAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cache/cache.module.ts","../../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"],"mappings":";;;;;;;;AAgBA;;;;;;;cAMa,WAAA;;;cCtBA,YAAA;EAAA,SAEH,YAAA;AAAA;AAAA,KAEE,UAAA,WAAqB,YAAA,eAA2B,YAAA;;;;;;ADY5D;;;cEPa,aAAA,SAAsB,gBAAA;cACrB,GAAA;AAAA;;;;;;AFMd;;;cGPa,aAAA,SAAsB,gBAAA;cACrB,GAAA;AAAA;;;;;;AHMd;;;cIPa,gBAAA,SAAyB,gBAAA;cACxB,GAAA;AAAA;;;;;;AJMd;;cKRa,cAAA,SAAuB,gBAAA;EAAA,WAAA,CAAA;AAAA;;;;;ALQpC;;;;;;;;AChBA;;;;;AAIA;;;;;;;;ACKA;;;;;;;;;;cIsCa,YAAA;EAAA,iBAIyC,GAAA;EAAA,iBACI,MAAA;EAAA,QAJhD,EAAA;cAG4C,GAAA,EAAK,UAAA,EACD,MAAA,EAAQ,aAAA;EH3Cf;;;;;;;EGuDjD,KAAA,CAAM,EAAA,EAAI,WAAA;;AFvDZ;;;;;;;;;;;;ACDA;;;;;;;;ACsCA;;;;;EAgDE,WAAA,CAAY,EAAA,EAAI,WAAA,GAAc,YAAA;EAAd;;;;;;;;EAgBV,GAAA,CAAI,GAAA,UAAa,aAAA,YAAyB,qBAAA,WAAgC,OAAA;EAC1E,GAAA,yBAAA,CAA6B,GAAA,UAAa,aAAA,WAAwB,qBAAA,WAAgC,OAAA,CAAQ,aAAA;EAC1G,GAAA,CAAI,GAAA,UAAa,aAAA,kBAA+B,qBAAA,kBAAuC,OAAA,CAAQ,WAAA;EAC/F,GAAA,CAAI,GAAA,UAAa,aAAA,aAA0B,qBAAA,aAAkC,OAAA,CAAQ,cAAA;EAAR;;;;;;;;EAkC7E,eAAA,oBAAA,CACJ,GAAA,UACA,aAAA,YAAyB,qBAAA,WACxB,OAAA,CAAQ,gCAAA,SAAyC,QAAA;EAC9C,eAAA,6CAAA,CACJ,GAAA,UACA,aAAA,WAAwB,qBAAA,WACvB,OAAA,CAAQ,gCAAA,CAAiC,aAAA,EAAe,QAAA;EACrD,eAAA,oBAAA,CACJ,GAAA,UACA,aAAA,kBAA+B,qBAAA,kBAC9B,OAAA,CAAQ,gCAAA,CAAiC,WAAA,EAAa,QAAA;EACnD,eAAA,oBAAA,CACJ,GAAA,UACA,aAAA,aAA0B,qBAAA,aACzB,OAAA,CAAQ,gCAAA,CAAiC,cAAA,EAAgB,QAAA;EAJH;;;;;;;;;;;;;;;;;;;;EAuDnD,GAAA,CACJ,GAAA,UACA,KAAA,WAAgB,WAAA,GAAc,eAAA,GAAkB,cAAA,EAChD,OAAA,GAAU,qBAAA,GACT,OAAA;EArKqD;;;;;;EAsLlD,MAAA,CAAO,GAAA,WAAc,OAAA;EA1K3B;;;;;;;;;;;;;;;;;;;;;;EA4MM,IAAA,oBAAA,CACJ,OAAA,GAAU,sBAAA,GACT,OAAA,CAAQ,qBAAA,CAAsB,QAAA;AAAA"}

package/dist/cache/index.mjs

@@ -1,14 +1,6 @@
-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-BgdxxzBe.mjs";
-import "../events-CXl-o1Ad.mjs";
-import "../colors-DJaRDXoS.mjs";
-import "../command-BvCOD6df.mjs";
-import "../is-command-BfCgWAcQ.mjs";
-import "../is-seeder-CebjZCDn.mjs";
-import "../middleware-C0Ebzswy.mjs";
-import "../router-context-BEJe9HEB.mjs";
+import { H as ApplicationError, k as ERROR_CODES } from "../errors--RBIvDXr.mjs";
+import { a as __decorate, f as DI_TOKENS, o as __decorateParam, p as Transient, s as __decorateMetadata, u as LOGGER_TOKENS } from "../logger-c0ftIK4G.mjs";
+import { S as Module } from "../module-C3YZ-kZN.mjs";
 import { inject } from "tsyringe";
 //#region src/cache/cache.tokens.ts
 const CACHE_TOKENS = { CacheService: Symbol.for("stratal:cache:service") };

package/dist/cache/index.mjs.map

@@ -1 +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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"}
+{"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/{colors-DJaRDXoS.mjs → colors-BTAnQRGU.mjs}

@@ -13,4 +13,4 @@ const dimWhite = (s) => isEnabled() ? `\x1b[2;37m${s}\x1b[22;39m` : s;
 //#endregion
 export { green as a, dimWhite as i, cyan as n, red as o, dim as r, yellow as s, bold as t };
 
-//# sourceMappingURL=colors-DJaRDXoS.mjs.map
+//# sourceMappingURL=colors-BTAnQRGU.mjs.map

package/dist/{colors-DJaRDXoS.mjs.map → colors-BTAnQRGU.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"colors-DJaRDXoS.mjs","names":[],"sources":["../src/quarry/colors.ts"],"sourcesContent":["/** Minimal ANSI color helpers that respect the `NO_COLOR` convention. */\nconst isEnabled = () => typeof process !== 'undefined' ? !process.env.NO_COLOR : true\n\n/** Create an ANSI formatter that wraps text with the given open/close SGR codes. */\nconst code = (open: number, close: number) => (s: string) =>\n  isEnabled() ? `\\x1b[${open}m${s}\\x1b[${close}m` : s\n\nexport const bold = code(1, 22)\nexport const dim = code(2, 22)\nexport const cyan = code(36, 39)\nexport const green = code(32, 39)\nexport const red = code(31, 39)\nexport const yellow = code(33, 39)\nexport const dimWhite = (s: string) =>\n  isEnabled() ? `\\x1b[2;37m${s}\\x1b[22;39m` : s\n"],"mappings":";;AACA,MAAM,kBAAkB,OAAO,YAAY,cAAc,CAAC,QAAQ,IAAI,WAAW;;AAGjF,MAAM,QAAQ,MAAc,WAAmB,MAC7C,WAAW,GAAG,QAAQ,KAAK,GAAG,EAAE,OAAO,MAAM,KAAK;AAEpD,MAAa,OAAO,KAAK,GAAG,GAAG;AAC/B,MAAa,MAAM,KAAK,GAAG,GAAG;AAC9B,MAAa,OAAO,KAAK,IAAI,GAAG;AAChC,MAAa,QAAQ,KAAK,IAAI,GAAG;AACjC,MAAa,MAAM,KAAK,IAAI,GAAG;AAC/B,MAAa,SAAS,KAAK,IAAI,GAAG;AAClC,MAAa,YAAY,MACvB,WAAW,GAAG,aAAa,EAAE,eAAe"}
+{"version":3,"file":"colors-BTAnQRGU.mjs","names":[],"sources":["../src/quarry/colors.ts"],"sourcesContent":["/** Minimal ANSI color helpers that respect the `NO_COLOR` convention. */\nconst isEnabled = () => typeof process !== 'undefined' ? !process.env.NO_COLOR : true\n\n/** Create an ANSI formatter that wraps text with the given open/close SGR codes. */\nconst code = (open: number, close: number) => (s: string) =>\n  isEnabled() ? `\\x1b[${open}m${s}\\x1b[${close}m` : s\n\nexport const bold = code(1, 22)\nexport const dim = code(2, 22)\nexport const cyan = code(36, 39)\nexport const green = code(32, 39)\nexport const red = code(31, 39)\nexport const yellow = code(33, 39)\nexport const dimWhite = (s: string) =>\n  isEnabled() ? `\\x1b[2;37m${s}\\x1b[22;39m` : s\n"],"mappings":";;AACA,MAAM,kBAAkB,OAAO,YAAY,cAAc,CAAC,QAAQ,IAAI,WAAW;;AAGjF,MAAM,QAAQ,MAAc,WAAmB,MAC7C,WAAW,GAAG,QAAQ,KAAK,GAAG,EAAE,OAAO,MAAM,KAAK;AAEpD,MAAa,OAAO,KAAK,GAAG,GAAG;AAC/B,MAAa,MAAM,KAAK,GAAG,GAAG;AAC9B,MAAa,OAAO,KAAK,IAAI,GAAG;AAChC,MAAa,QAAQ,KAAK,IAAI,GAAG;AACjC,MAAa,MAAM,KAAK,IAAI,GAAG;AAC/B,MAAa,SAAS,KAAK,IAAI,GAAG;AAClC,MAAa,YAAY,MACvB,WAAW,GAAG,aAAa,EAAE,eAAe"}

package/dist/{command-B-QH-Vu3.d.mts → command-B1YuV-UZ.d.mts}

@@ -1,4 +1,4 @@
-import { n as CommandInternals, r as CommandResult, t as CommandInput } from "./types-CLhOhYsQ.mjs";
+import { an as CommandInput, on as CommandInternals, sn as CommandResult } from "./index-BrmS34sa.mjs";
 //#region src/quarry/constants.d.ts
 /**
  * Symbol key for storing internal mutable state on Command instances.
@@ -117,4 +117,4 @@ declare abstract class Command {
 }
 //#endregion
 export { Command as t };
-//# sourceMappingURL=command-B-QH-Vu3.d.mts.map
+//# sourceMappingURL=command-B1YuV-UZ.d.mts.map

package/dist/{command-B-QH-Vu3.d.mts.map → command-B1YuV-UZ.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"command-B-QH-Vu3.d.mts","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/command.ts"],"mappings":";;;;;;cAIa,iBAAA;;;;AAAb;;;;;;;;ACsBA;;;;;;;;;;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"}
+{"version":3,"file":"command-B1YuV-UZ.d.mts","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/command.ts"],"mappings":";;;;;;cAIa,iBAAA;;;;AAAb;;;;;;;;ACsBA;;;;;;;;;;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"}