stratal 0.0.22 → 0.0.24

package/README.md

@@ -27,7 +27,7 @@ Full guides and examples are available at **[stratal.dev](https://stratal.dev)**
 - **Queue Consumers** — Typed Cloudflare Queue consumers with message-type filtering
 - **Cron Jobs** — Scheduled tasks via Cloudflare Workers cron triggers
 - **Storage** — S3-compatible file storage with presigned URLs and TUS upload support
-- **Email** — Resend and SMTP providers with React Email template support
+- **Email** — SMTP provider with React Email template support
 - **i18n** — Type-safe internationalization with locale detection from request headers
 - **Guards and Middleware** — Route protection and per-module middleware configuration
 

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

@@ -3,18 +3,24 @@ 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 virtual modules for Cloudflare-specific imports
 * 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`.
+* When registered via `node --import` or `register()`, this intercepts:
+* - `cloudflare:workers` — virtual env/waitUntil from `globalThis.__stratalPlatformProxy`
+* - `cloudflare:sockets` — Node.js TCP/TLS implementation of the CF connect() API
+* - `?raw` imports — returns file contents as a default string export
 */
-const VIRTUAL_URL = "cloudflare-workers:virtual";
+const VIRTUAL_WORKERS_URL = "cloudflare-workers:virtual";
+const VIRTUAL_SOCKETS_URL = "cloudflare-sockets:virtual";
 const RAW_SUFFIX = "?raw";
 async function resolve(specifier, context, nextResolve) {
 	if (specifier === "cloudflare:workers") return {
-		url: VIRTUAL_URL,
+		url: VIRTUAL_WORKERS_URL,
+		shortCircuit: true
+	};
+	if (specifier === "cloudflare:sockets") return {
+		url: VIRTUAL_SOCKETS_URL,
 		shortCircuit: true
 	};
 	if (specifier.endsWith(RAW_SUFFIX)) return {
@@ -32,7 +38,7 @@ async function load(url, context, nextLoad) {
 			source: `export default ${JSON.stringify(content)}`
 		};
 	}
-	if (url === VIRTUAL_URL) return {
+	if (url === VIRTUAL_WORKERS_URL) return {
 		format: "module",
 		shortCircuit: true,
 		source: `
@@ -56,6 +62,73 @@ 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(); }
+`
+	};
+	if (url === VIRTUAL_SOCKETS_URL) return {
+		format: "module",
+		shortCircuit: true,
+		source: `
+import { connect as netConnect } from 'node:net';
+import { connect as tlsConnect } from 'node:tls';
+
+export function connect(address, options) {
+  const hostname = typeof address === 'string' ? address : address.hostname;
+  const port = typeof address === 'string' ? 443 : address.port;
+  const secureTransport = options?.secureTransport ?? 'off';
+
+  let currentSocket;
+  if (secureTransport === 'on') {
+    currentSocket = tlsConnect({ host: hostname, port, servername: hostname });
+  } else {
+    currentSocket = netConnect({ host: hostname, port });
+  }
+
+  let dataHandler, endHandler, errorHandler;
+
+  const readable = new ReadableStream({
+    start(controller) {
+      dataHandler = (chunk) => {
+        try { controller.enqueue(new Uint8Array(chunk)); } catch {}
+      };
+      endHandler = () => {
+        try { controller.close(); } catch {}
+      };
+      errorHandler = (err) => {
+        try { controller.error(err); } catch {}
+      };
+      currentSocket.on('data', dataHandler);
+      currentSocket.on('end', endHandler);
+      currentSocket.on('error', errorHandler);
+    }
+  });
+
+  const writable = new WritableStream({
+    write(chunk) {
+      return new Promise((resolve, reject) => {
+        currentSocket.write(Buffer.from(chunk), (err) => err ? reject(err) : resolve());
+      });
+    }
+  });
+
+  const closedPromise = new Promise((resolve) => currentSocket.on('close', resolve));
+
+  return {
+    readable,
+    writable,
+    startTls() {
+      currentSocket.removeListener('data', dataHandler);
+      currentSocket.removeListener('end', endHandler);
+      currentSocket.removeListener('error', errorHandler);
+      const tlsSocket = tlsConnect({ socket: currentSocket, servername: hostname });
+      currentSocket = tlsSocket;
+      tlsSocket.on('data', dataHandler);
+      tlsSocket.on('end', endHandler);
+      tlsSocket.on('error', errorHandler);
+    },
+    close() { currentSocket.destroy(); },
+    closed: closedPromise,
+  };
+}
 `
 	};
 	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 * 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;CACxB,IAAI,cAAc,sBAChB,OAAO;EAAE,KAAK;EAAa,cAAc;EAAM;CAEjD,IAAI,UAAU,SAAS,WAAW,EAGhC,OAAO;EAAE,MAAK,MADS,YADV,UAAU,MAAM,GAAG,GACO,EAAE,QAAQ,EAC1B,MAAM;EAAY,cAAc;EAAM;CAE/D,OAAO,YAAY,WAAW,QAAQ;;AAgBxC,eAAsB,KACpB,KACA,SACA,UACqB;CACrB,IAAI,IAAI,SAAS,WAAW,EAAE;EAG5B,MAAM,UAAU,aADC,cADD,IAAI,MAAM,GAAG,GACS,CACD,EAAE,QAAQ;EAC/C,OAAO;GACL,QAAQ;GACR,cAAc;GACd,QAAQ,kBAAkB,KAAK,UAAU,QAAQ;GAClD;;CAEH,IAAI,QAAQ,aACV,OAAO;EACL,QAAQ;EACR,cAAc;EACd,QAAQ;;;;;;;;;;;;;;;;;;;;;;EAsBT;CAEH,OAAO,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 virtual modules for Cloudflare-specific imports\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 * - `cloudflare:workers` — virtual env/waitUntil from `globalThis.__stratalPlatformProxy`\n * - `cloudflare:sockets` — Node.js TCP/TLS implementation of the CF connect() API\n * - `?raw` imports — returns file contents as a default string export\n */\n\nimport { readFileSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nconst VIRTUAL_WORKERS_URL = 'cloudflare-workers:virtual'\nconst VIRTUAL_SOCKETS_URL = 'cloudflare-sockets: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_WORKERS_URL, shortCircuit: true }\n  }\n  if (specifier === 'cloudflare:sockets') {\n    return { url: VIRTUAL_SOCKETS_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_WORKERS_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  if (url === VIRTUAL_SOCKETS_URL) {\n    return {\n      format: 'module',\n      shortCircuit: true,\n      source: `\nimport { connect as netConnect } from 'node:net';\nimport { connect as tlsConnect } from 'node:tls';\n\nexport function connect(address, options) {\n  const hostname = typeof address === 'string' ? address : address.hostname;\n  const port = typeof address === 'string' ? 443 : address.port;\n  const secureTransport = options?.secureTransport ?? 'off';\n\n  let currentSocket;\n  if (secureTransport === 'on') {\n    currentSocket = tlsConnect({ host: hostname, port, servername: hostname });\n  } else {\n    currentSocket = netConnect({ host: hostname, port });\n  }\n\n  let dataHandler, endHandler, errorHandler;\n\n  const readable = new ReadableStream({\n    start(controller) {\n      dataHandler = (chunk) => {\n        try { controller.enqueue(new Uint8Array(chunk)); } catch {}\n      };\n      endHandler = () => {\n        try { controller.close(); } catch {}\n      };\n      errorHandler = (err) => {\n        try { controller.error(err); } catch {}\n      };\n      currentSocket.on('data', dataHandler);\n      currentSocket.on('end', endHandler);\n      currentSocket.on('error', errorHandler);\n    }\n  });\n\n  const writable = new WritableStream({\n    write(chunk) {\n      return new Promise((resolve, reject) => {\n        currentSocket.write(Buffer.from(chunk), (err) => err ? reject(err) : resolve());\n      });\n    }\n  });\n\n  const closedPromise = new Promise((resolve) => currentSocket.on('close', resolve));\n\n  return {\n    readable,\n    writable,\n    startTls() {\n      currentSocket.removeListener('data', dataHandler);\n      currentSocket.removeListener('end', endHandler);\n      currentSocket.removeListener('error', errorHandler);\n      const tlsSocket = tlsConnect({ socket: currentSocket, servername: hostname });\n      currentSocket = tlsSocket;\n      tlsSocket.on('data', dataHandler);\n      tlsSocket.on('end', endHandler);\n      tlsSocket.on('error', errorHandler);\n    },\n    close() { currentSocket.destroy(); },\n    closed: closedPromise,\n  };\n}\n`,\n    }\n  }\n  return nextLoad(url, context)\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,aAAa;AAcnB,eAAsB,QACpB,WACA,SACA,aACwB;CACxB,IAAI,cAAc,sBAChB,OAAO;EAAE,KAAK;EAAqB,cAAc;CAAK;CAExD,IAAI,cAAc,sBAChB,OAAO;EAAE,KAAK;EAAqB,cAAc;CAAK;CAExD,IAAI,UAAU,SAAS,UAAU,GAG/B,OAAO;EAAE,MAAK,MADS,YADV,UAAU,MAAM,GAAG,EACM,GAAG,OAAO,GACzB,MAAM;EAAY,cAAc;CAAK;CAE9D,OAAO,YAAY,WAAW,OAAO;AACvC;AAeA,eAAsB,KACpB,KACA,SACA,UACqB;CACrB,IAAI,IAAI,SAAS,UAAU,GAAG;EAG5B,MAAM,UAAU,aADC,cADD,IAAI,MAAM,GAAG,EACQ,CACD,GAAG,OAAO;EAC9C,OAAO;GACL,QAAQ;GACR,cAAc;GACd,QAAQ,kBAAkB,KAAK,UAAU,OAAO;EAClD;CACF;CACA,IAAI,QAAQ,qBACV,OAAO;EACL,QAAQ;EACR,cAAc;EACd,QAAQ;;;;;;;;;;;;;;;;;;;;;;CAsBV;CAEF,IAAI,QAAQ,qBACV,OAAO;EACL,QAAQ;EACR,cAAc;EACd,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DV;CAEF,OAAO,SAAS,KAAK,OAAO;AAC9B"}

package/dist/bin/quarry.mjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env -S node --no-warnings
 import { createRequire, register } from "node:module";
-import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
+import { existsSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { URL, pathToFileURL } from "node:url";
 import { Command, Option } from "clipanion";
@@ -121,67 +120,58 @@ 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) {
+async function main() {
+	const cwdRequire = createRequire(join(process.cwd(), "package.json"));
+	const { unstable_readConfig: readConfig, unstable_getMiniflareWorkerOptions: getMiniflareWorkerOptions, unstable_getVarsForDev: getVarsForDev } = await import(cwdRequire.resolve("wrangler"));
+	const { Miniflare, getDefaultDevRegistryPath } = await import(cwdRequire.resolve("miniflare"));
 	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);
-	}
-	if (typeof config.name === "string") config.name = `quarry-${config.name}-${process.pid}`;
-	if (config.env && typeof config.env === "object") {
-		for (const envConfig of Object.values(config.env)) if (typeof envConfig.name === "string") envConfig.name = `quarry-${envConfig.name}-${process.pid}`;
+	const configPath = configName ? resolve(process.cwd(), configName) : void 0;
+	const envFiles = [
+		".env",
+		".env.local",
+		environment ? `.env.${environment}` : null,
+		environment ? `.env.${environment}.local` : null
+	];
+	for (const envFile of envFiles) {
+		if (!envFile) continue;
+		const envPath = resolve(process.cwd(), envFile);
+		if (existsSync(envPath)) process.loadEnvFile(envPath);
 	}
-	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 cwdRequire = createRequire(join(process.cwd(), "package.json"));
-	const { getPlatformProxy } = await import(cwdRequire.resolve("wrangler"));
-	const strippedConfigPath = await createStrippedConfig(cwdRequire);
-	const envFiles = discoverEnvFiles();
-	const { env, ctx, dispose } = await getPlatformProxy({
-		environment,
-		envFiles,
-		configPath: strippedConfigPath
+	if (process.env.WRANGLER_REGISTRY_PATH && !process.env.MINIFLARE_REGISTRY_PATH) process.env.MINIFLARE_REGISTRY_PATH = process.env.WRANGLER_REGISTRY_PATH;
+	const config = readConfig({
+		config: configPath,
+		env: environment
+	});
+	const { workerOptions } = getMiniflareWorkerOptions(config, environment);
+	const vars = getVarsForDev(configPath, void 0, config.vars, environment);
+	const varsRecord = {};
+	for (const [key, binding] of Object.entries(vars)) varsRecord[key] = binding.value;
+	workerOptions.bindings = {
+		...workerOptions.bindings ?? {},
+		...varsRecord,
+		QUEUE_PROVIDER: "sync"
+	};
+	workerOptions.name = config.name ? `quarry-${config.name}-${process.pid}` : `quarry-${process.pid}`;
+	const registryPath = getDefaultDevRegistryPath();
+	const mf = new Miniflare({
+		...workerOptions,
+		script: "",
+		modules: true,
+		unsafeDevRegistryPath: registryPath,
+		defaultPersistRoot: join(process.cwd(), ".wrangler/state/v3")
 	});
+	await mf.ready;
+	const env = await mf.getBindings();
 	const pendingPromises = [];
 	const trackedWaitUntil = (promise) => {
 		pendingPromises.push(promise);
-		ctx.waitUntil(promise);
 	};
 	let app;
 	try {
-		env.QUEUE_PROVIDER = "sync";
 		globalThis.__stratalPlatformProxy = {
 			env,
 			waitUntil: trackedWaitUntil
@@ -205,10 +195,7 @@ async function main() {
 	} finally {
 		await Promise.allSettled(pendingPromises);
 		await app?.shutdown();
-		await dispose();
-		if (strippedConfigPath) try {
-			unlinkSync(strippedConfigPath);
-		} catch {}
+		await mf.dispose();
 	}
 }
 main().catch(async (error) => {

package/dist/bin/quarry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"quarry.mjs","names":[],"sources":["../../src/bin/argv.ts","../../src/bin/commands/dynamic-command.ts","../../src/bin/quarry.ts"],"sourcesContent":["export function extractEnvFlag(argv: string[]): { env: string | undefined; rest: string[] } {\n  let env: string | undefined\n  const rest: string[] = []\n  for (let i = 0; i < argv.length; i++) {\n    const tok = argv[i]\n    if (tok === '--') {\n      rest.push(...argv.slice(i))\n      break\n    }\n    const eqMatch = tok.match(/^(?:--env|-e)=(.*)$/)\n    if (eqMatch) {\n      if (!eqMatch[1]) throw new Error('--env requires a value (e.g. --env staging)')\n      if (env !== undefined) throw new Error('--env specified more than once')\n      env = eqMatch[1]\n      continue\n    }\n    if (tok === '--env' || tok === '-e') {\n      const next = argv[i + 1]\n      if (!next || next.startsWith('-')) throw new Error('--env requires a value (e.g. --env staging)')\n      if (env !== undefined) throw new Error('--env specified more than once')\n      env = next\n      i++\n      continue\n    }\n    rest.push(tok)\n  }\n  return { env, rest }\n}\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 { 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 { URL, pathToFileURL } from 'node:url'\nimport type { QuarryRegistry } from 'stratal/quarry'\nimport { type Application } from '../application'\nimport { extractEnvFlag } from './argv'\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/quarry.ts'\n\nlet environment: string | undefined\ntry {\n  const parsed = extractEnvFlag(process.argv.slice(2))\n  environment = parsed.env\n  process.argv.splice(2, process.argv.length - 2, ...parsed.rest)\n} catch (e) {\n  console.error(`Error: ${(e as Error).message}`)\n  process.exit(1)\n}\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/quarry.ts that exports `QuarryRunner.run({ module, seeders })`, 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  // Rename so quarry's ephemeral miniflare doesn't claim the running\n  // `wrangler dev` session's dev-registry slot. getPlatformProxy registers\n  // its worker with empty entrypointAddresses (no direct sockets), and that\n  // overwrite makes peer workers route TenantsRpc/BrandingRpc/etc. calls to\n  // their fallback service (\"couldn't find a local dev session for the X\n  // entrypoint\"). A unique name keeps the running session's entry untouched.\n  if (typeof config.name === 'string') {\n    config.name = `quarry-${config.name}-${process.pid}`\n  }\n  if (config.env && typeof config.env === 'object') {\n    for (const envConfig of Object.values(config.env as Record<string, Record<string, unknown>>)) {\n      if (typeof envConfig.name === 'string') {\n        envConfig.name = `quarry-${envConfig.name}-${process.pid}`\n      }\n    }\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 strippedConfigPath = await createStrippedConfig(cwdRequire)\n\n  const envFiles = discoverEnvFiles()\n  const { env, ctx, dispose } = await getPlatformProxy({\n    environment, envFiles, configPath: strippedConfigPath,\n  })\n\n  // Track waitUntil promises so we can drain them before shutdown.\n  // In Workers runtime, waitUntil keeps the isolate alive. In Quarry (miniflare),\n  // dispose() tears down without awaiting pending promises — so we track and drain them.\n  const pendingPromises: Promise<unknown>[] = []\n  const trackedWaitUntil = (promise: Promise<unknown>) => {\n    pendingPromises.push(promise)\n    ctx.waitUntil(promise)\n  }\n\n  let app: Application | undefined\n  try {\n    env.QUEUE_PROVIDER = 'sync';\n\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: trackedWaitUntil,\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 Promise.allSettled(pendingPromises);\n\n    await app?.shutdown()\n    await dispose()\n\n    if (strippedConfigPath) {\n      try { unlinkSync(strippedConfigPath) } catch {\n        //\n      }\n    }\n  }\n}\n\nmain().catch(async (error: unknown) => {\n  const { ConfigValidationError } = await import('stratal/config')\n\n  const message = 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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"}
+{"version":3,"file":"quarry.mjs","names":[],"sources":["../../src/bin/argv.ts","../../src/bin/commands/dynamic-command.ts","../../src/bin/quarry.ts"],"sourcesContent":["export function extractEnvFlag(argv: string[]): { env: string | undefined; rest: string[] } {\n  let env: string | undefined\n  const rest: string[] = []\n  for (let i = 0; i < argv.length; i++) {\n    const tok = argv[i]\n    if (tok === '--') {\n      rest.push(...argv.slice(i))\n      break\n    }\n    const eqMatch = tok.match(/^(?:--env|-e)=(.*)$/)\n    if (eqMatch) {\n      if (!eqMatch[1]) throw new Error('--env requires a value (e.g. --env staging)')\n      if (env !== undefined) throw new Error('--env specified more than once')\n      env = eqMatch[1]\n      continue\n    }\n    if (tok === '--env' || tok === '-e') {\n      const next = argv[i + 1]\n      if (!next || next.startsWith('-')) throw new Error('--env requires a value (e.g. --env staging)')\n      if (env !== undefined) throw new Error('--env specified more than once')\n      env = next\n      i++\n      continue\n    }\n    rest.push(tok)\n  }\n  return { env, rest }\n}\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 type { MiniflareOptions } from 'miniflare';\nimport { existsSync } from 'node:fs';\nimport { createRequire, register } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { URL, pathToFileURL } from 'node:url';\nimport type { QuarryRegistry } from 'stratal/quarry';\nimport { type Application } from '../application';\nimport { extractEnvFlag } from './argv';\nimport { createDynamicCommands } from './commands/dynamic-command';\n\ninterface WranglerConfig {\n  name?: string\n  vars?: Record<string, unknown>\n}\n\ninterface MiniflareWorkerResult {\n  workerOptions: Record<string, unknown>\n}\n\ninterface WranglerModule {\n  unstable_readConfig: (args: { config?: string; env?: string }) => WranglerConfig\n  unstable_getMiniflareWorkerOptions: (config: WranglerConfig, env?: string) => MiniflareWorkerResult\n  unstable_getVarsForDev: (configPath: string | undefined, envFiles: undefined, vars: unknown, env: string | undefined) => Record<string, { value: string }>\n}\n\ninterface MiniflareModule {\n  Miniflare: new (opts: MiniflareOptions) => { ready: Promise<URL>; getBindings: (name?: string) => Promise<Record<string, unknown>>; dispose: () => Promise<void> }\n  getDefaultDevRegistryPath: () => string\n}\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/quarry.ts'\n\nlet environment: string | undefined\ntry {\n  const parsed = extractEnvFlag(process.argv.slice(2))\n  environment = parsed.env\n  process.argv.splice(2, process.argv.length - 2, ...parsed.rest)\n} catch (e) {\n  console.error(`Error: ${(e as Error).message}`)\n  process.exit(1)\n}\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/quarry.ts that exports `QuarryRunner.run({ module, seeders })`, 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\n  const { unstable_readConfig: readConfig, unstable_getMiniflareWorkerOptions: getMiniflareWorkerOptions, unstable_getVarsForDev: getVarsForDev } = await import(cwdRequire.resolve('wrangler')) as WranglerModule\n  const { Miniflare, getDefaultDevRegistryPath } = await import(cwdRequire.resolve('miniflare')) as MiniflareModule\n\n  const candidates = ['wrangler.jsonc', 'wrangler.json', 'wrangler.toml']\n  const configName = candidates.find(c => existsSync(resolve(process.cwd(), c)))\n  const configPath = configName ? resolve(process.cwd(), configName) : undefined\n\n  // Load .env into process.env before building Miniflare options, mirroring\n  // `wrangler dev`'s precedence: base `.env`, then `.env.local`, then the\n  // env-specific `.env.<environment>` and `.env.<environment>.local` (later\n  // load wins).\n  const envFiles = [\n    '.env',\n    '.env.local',\n    environment ? `.env.${environment}` : null,\n    environment ? `.env.${environment}.local` : null,\n  ]\n  for (const envFile of envFiles) {\n    if (!envFile) continue\n    const envPath = resolve(process.cwd(), envFile)\n    if (existsSync(envPath)) process.loadEnvFile(envPath)\n  }\n\n  // Bridge the documented `WRANGLER_REGISTRY_PATH` to `MINIFLARE_REGISTRY_PATH`,\n  // the variable Miniflare's `getDefaultDevRegistryPath()` actually reads.\n  // `wrangler dev` performs the same translation internally; mirroring it here\n  // lets a single documented env var redirect the dev service registry for BOTH\n  // this CLI's Miniflare (below) AND any vite dev server a command launches\n  // (`@cloudflare/vite-plugin` also resolves its registry via\n  // `getDefaultDevRegistryPath()`). That allows several isolated dev environments\n  // to run in parallel without sharing the global `~/.wrangler/registry`, where\n  // their identically-named workers would otherwise overwrite each other and\n  // break cross-worker service-binding resolution. Only set when unset so an\n  // explicit override still wins.\n  if (process.env.WRANGLER_REGISTRY_PATH && !process.env.MINIFLARE_REGISTRY_PATH) {\n    process.env.MINIFLARE_REGISTRY_PATH = process.env.WRANGLER_REGISTRY_PATH\n  }\n\n  const config = readConfig({ config: configPath, env: environment })\n  const { workerOptions } = getMiniflareWorkerOptions(config, environment)\n\n  const vars = getVarsForDev(configPath, undefined, config.vars, environment)\n  const varsRecord: Record<string, string> = {}\n  for (const [key, binding] of Object.entries(vars)) {\n    varsRecord[key] = binding.value\n  }\n\n  const existingBindings = workerOptions.bindings as Record<string, unknown> ?? {}\n  workerOptions.bindings = {\n    ...existingBindings,\n    ...varsRecord,\n    QUEUE_PROVIDER: 'sync',\n  }\n\n  // Rename so quarry doesn't overwrite a running `wrangler dev` session's\n  // dev-registry entry. The registry is how Miniflare discovers peer workers\n  // for service binding resolution — a collision would break the running session.\n  const workerName = config.name ? `quarry-${config.name}-${process.pid}` : `quarry-${process.pid}`\n  workerOptions.name = workerName\n\n  // Resolve the dev-registry path so Miniflare can discover running\n  // `wrangler dev` sessions for service binding resolution.\n  const registryPath = getDefaultDevRegistryPath()\n\n  const mf = new Miniflare({\n    ...workerOptions,\n    script: '',\n    modules: true,\n    unsafeDevRegistryPath: registryPath,\n    // Persist every durable plugin (KV, D1, R2, Durable Objects, cache) under\n    // the same root `wrangler dev` uses, so state survives across `quarry`\n    // invocations and is shared with a running `wrangler dev` session.\n    defaultPersistRoot: join(process.cwd(), '.wrangler/state/v3'),\n  })\n\n  await mf.ready\n  const env = await mf.getBindings()\n\n  const pendingPromises: Promise<unknown>[] = []\n  const trackedWaitUntil = (promise: Promise<unknown>) => {\n    pendingPromises.push(promise)\n  }\n\n  let app: Application | undefined\n  try {\n    (globalThis as Record<string, unknown>).__stratalPlatformProxy = {\n      env,\n      waitUntil: trackedWaitUntil,\n    }\n\n    await import(pathToFileURL(entryPath).href)\n\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    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 Promise.allSettled(pendingPromises)\n    await app?.shutdown()\n    await mf.dispose()\n  }\n}\n\nmain().catch(async (error: unknown) => {\n  const { ConfigValidationError } = await import('stratal/config')\n\n  const message = 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":";;;;;;;AAAA,SAAgB,eAAe,MAA6D;CAC1F,IAAI;CACJ,MAAM,OAAiB,CAAC;CACxB,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EACjB,IAAI,QAAQ,MAAM;GAChB,KAAK,KAAK,GAAG,KAAK,MAAM,CAAC,CAAC;GAC1B;EACF;EACA,MAAM,UAAU,IAAI,MAAM,qBAAqB;EAC/C,IAAI,SAAS;GACX,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,MAAM,6CAA6C;GAC9E,IAAI,QAAQ,KAAA,GAAW,MAAM,IAAI,MAAM,gCAAgC;GACvE,MAAM,QAAQ;GACd;EACF;EACA,IAAI,QAAQ,WAAW,QAAQ,MAAM;GACnC,MAAM,OAAO,KAAK,IAAI;GACtB,IAAI,CAAC,QAAQ,KAAK,WAAW,GAAG,GAAG,MAAM,IAAI,MAAM,6CAA6C;GAChG,IAAI,QAAQ,KAAA,GAAW,MAAM,IAAI,MAAM,gCAAgC;GACvE,MAAM;GACN;GACA;EACF;EACA,KAAK,KAAK,GAAG;CACf;CACA,OAAO;EAAE;EAAK;CAAK;AACrB;;;;ACrBA,SAAgB,sBACd,QACA,gBACA,KACA;CACA,MAAM,WAA2B,CAAC;CAElC,KAAK,MAAM,SAAS,OAAO,KAAK,GAAG;EACjC,MAAM,eAAe,OAAO,IAAI,MAAM,IAAI;EAC1C,MAAM,YAAY,eAAe,aAAa,OAAO;EAErD,MAAM,QAAoB,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC;EAChD,IAAI,aAAa,SACf,KAAK,MAAM,SAAS,aAAa,SAC/B,MAAM,KAAK,MAAM,MAAM,GAAG,CAAC;EAK/B,IAAI,MAAM,SAAS,QACjB,MAAM,KAAK,CAAC,CAAC;EAGf,MAAM,eAAe,QAAQ;GAC3B,OAAgB,QAAQ;GACxB,OAAgB,QAA2B,aAAa,cACpD,QAAQ,MAAM,EAAE,aAAa,aAAa,YAAY,CAAC,IACvD,KAAA;GAEJ,MAAM,UAA2B;IAC/B,MAAM,QAAiC,CAAC;IAExC,KAAK,MAAM,OAAO,UAAU,WAAW;KACrC,MAAM,QAAS,KAAiC,IAAI;KACpD,IAAI,UAAU,KAAA,GAAW,MAAM,IAAI,QAAQ;IAC7C;IAEA,KAAK,MAAM,OAAO,UAAU,SAAS;KACnC,MAAM,QAAS,KAAiC,IAAI;KACpD,IAAI,UAAU,KAAA,GAAW,MAAM,IAAI,QAAQ;IAC7C;IAEA,MAAM,SAAS,MAAM,IAAI,cAAc,MAAM,MAAM,KAAK;IAExD,KAAK,MAAM,QAAQ,OAAO,QACxB,KAAK,QAAQ,OAAO,MAAM,OAAO,IAAI;IAGvC,KAAK,MAAM,OAAO,OAAO,QACvB,KAAK,QAAQ,OAAO,MAAM,MAAM,IAAI;IAGtC,OAAO,OAAO;GAChB;EACF;EAGA,MAAM,QAAQ,OAAO;EACrB,KAAK,MAAM,OAAO,UAAU,WAC1B,IAAI,IAAI,SACN,MAAM,IAAI,QAAQ,OAAO,KAAK;GAAE,MAAM,IAAI;GAAM,UAAU,IAAI,WAAW,IAAI;EAAE,CAAC;OAEhF,MAAM,IAAI,QAAQ,OAAO,OAAO;GAAE,MAAM,IAAI;GAAM,UAAU,IAAI;EAAS,CAAC;EAI9E,KAAK,MAAM,OAAO,UAAU,SAAS;GACnC,MAAM,UAAU,IAAI,QAAQ,IAAI,IAAI,MAAM,KAAK,IAAI,SAAS,KAAK,IAAI;GACrE,MAAM,eAAyB,CAAC;GAChC,IAAI,IAAI,aAAa,aAAa,KAAK,IAAI,WAAW;GACtD,IAAI,IAAI,YAAY,KAAA,GAAW,aAAa,KAAK,aAAa,IAAI,QAAQ,EAAE;GAC5E,MAAM,UAAU,aAAa,SAAS,IAAI,aAAa,KAAK,GAAG,IAAI,KAAA;GAEnE,IAAI,IAAI,QACN,MAAM,IAAI,QAAQ,OAAO,QAAQ,SAAS,EAAE,aAAa,QAAQ,CAAC;QAC7D,IAAI,IAAI,SACb,IAAI,IAAI,YAAY,KAAA,GAClB,MAAM,IAAI,QAAQ,OAAO,MAAM,SAAS,CAAC,IAAI,OAAO,GAAG,EAAE,aAAa,QAAQ,CAAC;QAE/E,MAAM,IAAI,QAAQ,OAAO,MAAM,SAAS,EAAE,aAAa,QAAQ,CAAC;QAGlE,IAAI,IAAI,YAAY,KAAA,GAClB,MAAM,IAAI,QAAQ,OAAO,OAAO,SAAS,IAAI,SAAS,EAAE,aAAa,QAAQ,CAAC;QAE9E,MAAM,IAAI,QAAQ,OAAO,OAAO,SAAS,EAAE,aAAa,QAAQ,CAAC;EAGvE;EAEA,SAAS,KAAK,MAAM;CACtB;CAEA,OAAO;AACT;;;ACtEA,MAAM,UAAU,cAAc,OAAO,KAAK,GAAG;AAI7C,SAAS,cADe,KAAK,QAAQ,QAAQ,QAAQ,oBAAoB,CAAC,GAAG,aACxC,CAAC,GAAG,cAAc,IAAI,CAAC;AAG5D,SAAS,IAAI,IAAI,mCAAmC,OAAO,KAAK,GAAG,GAAG,cAAc,IAAI,CAAC;AAEzF,MAAM,gBAAgB;AAEtB,IAAI;AACJ,IAAI;CACF,MAAM,SAAS,eAAe,QAAQ,KAAK,MAAM,CAAC,CAAC;CACnD,cAAc,OAAO;CACrB,QAAQ,KAAK,OAAO,GAAG,QAAQ,KAAK,SAAS,GAAG,GAAG,OAAO,IAAI;AAChE,SAAS,GAAG;CACV,QAAQ,MAAM,UAAW,EAAY,SAAS;CAC9C,QAAQ,KAAK,CAAC;AAChB;AAGA,MAAM,WAAW,QAAQ,KAAK;AAC9B,IAAI,YAAY;AAEhB,IAAI,aAAa,SAAS,SAAS,GAAG,KAAK,SAAS,SAAS,IAAI,KAAK,qBAAqB,KAAK,QAAQ,IAAI;CAC1G,YAAY;CAEZ,QAAQ,KAAK,OAAO,GAAG,CAAC;AAC1B;AAGA,MAAM,YAAY,QAAQ,QAAQ,IAAI,GAAG,SAAS;AAElD,IAAI,CAAC,WAAW,SAAS,GAAG;CAC1B,QAAQ,MAAM,gCAAgC,WAAW;CACzD,QAAQ,MAAM,EAAE;CAChB,QAAQ,MAAM,sGAAsG;CACpH,QAAQ,MAAM,qDAAqD;CACnE,QAAQ,KAAK,CAAC;AAChB;AAEA,eAAe,OAAsB;CACnC,MAAM,aAAa,cAAc,KAAK,QAAQ,IAAI,GAAG,cAAc,CAAC;CAEpE,MAAM,EAAE,qBAAqB,YAAY,oCAAoC,2BAA2B,wBAAwB,kBAAkB,MAAM,OAAO,WAAW,QAAQ,UAAU;CAC5L,MAAM,EAAE,WAAW,8BAA8B,MAAM,OAAO,WAAW,QAAQ,WAAW;CAG5F,MAAM,aAAa;EADC;EAAkB;EAAiB;CAC3B,EAAE,MAAK,MAAK,WAAW,QAAQ,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC;CAC7E,MAAM,aAAa,aAAa,QAAQ,QAAQ,IAAI,GAAG,UAAU,IAAI,KAAA;CAMrE,MAAM,WAAW;EACf;EACA;EACA,cAAc,QAAQ,gBAAgB;EACtC,cAAc,QAAQ,YAAY,UAAU;CAC9C;CACA,KAAK,MAAM,WAAW,UAAU;EAC9B,IAAI,CAAC,SAAS;EACd,MAAM,UAAU,QAAQ,QAAQ,IAAI,GAAG,OAAO;EAC9C,IAAI,WAAW,OAAO,GAAG,QAAQ,YAAY,OAAO;CACtD;CAaA,IAAI,QAAQ,IAAI,0BAA0B,CAAC,QAAQ,IAAI,yBACrD,QAAQ,IAAI,0BAA0B,QAAQ,IAAI;CAGpD,MAAM,SAAS,WAAW;EAAE,QAAQ;EAAY,KAAK;CAAY,CAAC;CAClE,MAAM,EAAE,kBAAkB,0BAA0B,QAAQ,WAAW;CAEvE,MAAM,OAAO,cAAc,YAAY,KAAA,GAAW,OAAO,MAAM,WAAW;CAC1E,MAAM,aAAqC,CAAC;CAC5C,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,IAAI,GAC9C,WAAW,OAAO,QAAQ;CAI5B,cAAc,WAAW;EACvB,GAFuB,cAAc,YAAuC,CAAC;EAG7E,GAAG;EACH,gBAAgB;CAClB;CAMA,cAAc,OADK,OAAO,OAAO,UAAU,OAAO,KAAK,GAAG,QAAQ,QAAQ,UAAU,QAAQ;CAK5F,MAAM,eAAe,0BAA0B;CAE/C,MAAM,KAAK,IAAI,UAAU;EACvB,GAAG;EACH,QAAQ;EACR,SAAS;EACT,uBAAuB;EAIvB,oBAAoB,KAAK,QAAQ,IAAI,GAAG,oBAAoB;CAC9D,CAAC;CAED,MAAM,GAAG;CACT,MAAM,MAAM,MAAM,GAAG,YAAY;CAEjC,MAAM,kBAAsC,CAAC;CAC7C,MAAM,oBAAoB,YAA8B;EACtD,gBAAgB,KAAK,OAAO;CAC9B;CAEA,IAAI;CACJ,IAAI;EACF,WAAwC,yBAAyB;GAC/D;GACA,WAAW;EACb;EAEA,MAAM,OAAO,cAAc,SAAS,EAAE;EAEtC,MAAM,CACJ,EAAE,WACF,EAAE,aACF,EAAE,oBACA,MAAM,QAAQ,IAAI;GACpB,OAAO;GACP,OAAO;GACP,OAAO;EACT,CAAC;EAED,MAAM,MAAM,QAAQ,mBAAmB;EACvC,MAAM,SAAS,IAAI,UAAU,QAAwB,UAAU,MAAM;EAErE,MAAM,EAAE,QAAQ,MAAM,OAAO;EAG7B,MAAM,MAAM,IAAI,IAAI;GAClB,YAAY;GACZ,aAAa;GACb,eALU,QAAQ,oBAKD,EAAE;EACrB,CAAC;EAED,KAAK,MAAM,OAAO,sBAAsB,QAAQ,gBAAgB,GAAG,GACjE,IAAI,SAAS,GAAG;EAGlB,MAAM,IAAI,QAAQ,QAAQ,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,eAAe,CAAC;CACpE,UAAU;EACR,MAAM,QAAQ,WAAW,eAAe;EACxC,MAAM,KAAK,SAAS;EACpB,MAAM,GAAG,QAAQ;CACnB;AACF;AAEA,KAAK,EAAE,MAAM,OAAO,UAAmB;CACrC,MAAM,EAAE,0BAA0B,MAAM,OAAO;CAE/C,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CACrE,QAAQ,MAAM,gBAAgB,OAAO;CACrC,IAAI,iBAAiB,uBACnB,QAAQ,MAAM,MAAM,OAAO,OAAO;CAEpC,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/cache/index.d.mts

@@ -1,5 +1,6 @@
-import { xr as ApplicationError } from "../index-DEncMcC6.mjs";
-import { t as CacheService } from "../cache.service-e34gV6tz.mjs";
+import { Dr as ApplicationError } from "../index-B_JoEl3V.mjs";
+import { t as CacheService } from "../cache.service-uElmBtdS.mjs";
+import { t as TieredCacheService } from "../tiered-cache.service-Dv3BhxxE.mjs";
 
 //#region src/cache/cache.error.d.ts
 declare class CacheError extends ApplicationError {}
@@ -21,8 +22,9 @@ declare class CacheModule {}
 //#region src/cache/cache.tokens.d.ts
 declare const CACHE_TOKENS: {
   readonly CacheService: symbol;
+  readonly TieredCacheService: symbol;
 };
 type CacheToken = (typeof CACHE_TOKENS)[keyof typeof CACHE_TOKENS];
 //#endregion
-export { CACHE_TOKENS, CacheError, CacheModule, CacheService, CacheToken };
+export { CACHE_TOKENS, CacheError, CacheModule, CacheService, CacheToken, TieredCacheService };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cache/cache.error.ts","../../src/cache/cache.module.ts","../../src/cache/cache.tokens.ts"],"mappings":";;;;cAEa,UAAA,SAAmB,gBAAA;;;;;;;AAAhC;;;;;;;cCoBa,WAAA;;;cCtBA,YAAA;EAAA,SAEH,YAAA;AAAA;AAAA,KAEE,UAAA,WAAqB,YAAA,eAA2B,YAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cache/cache.error.ts","../../src/cache/cache.module.ts","../../src/cache/cache.tokens.ts"],"mappings":";;;;;cAEa,UAAA,SAAmB,gBAAgB;;;;;;;;AAAhD;;;;AAAgD;;cCsBnC,WAAA;;;cCxBA,YAAA;EAAA,SAGH,YAAA;EAAA,SAAA,kBAAA;AAAA;AAAA,KAEE,UAAA,WAAqB,YAAA,eAA2B,YAAY"}

package/dist/cache/index.mjs

@@ -1,13 +1,19 @@
-import { a as ApplicationError } from "../container-storage-GpNNz79X.mjs";
-import { c as DI_TOKENS, m as inject, u as Singleton } from "../di-BO1QIb5H.mjs";
-import { n as __decorateParam, t as __decorate } from "../decorate-HgTKAYK8.mjs";
+import { d as inject, r as DI_TOKENS, s as Singleton } from "../di-DseMn-z9.mjs";
+import { a as ApplicationError } from "../container-storage-BmOJ4_Na.mjs";
+import { n as __decorateParam, t as __decorate } from "../decorate-CuAoSZvs.mjs";
 import { LOGGER_TOKENS } from "../logger/index.mjs";
-import "../errors-BBZTnjdq.mjs";
-import { f as Module } from "../module-xYoHba6B.mjs";
-import { t as CACHE_TOKENS } from "../cache.tokens-ovi_c52J.mjs";
+import "../errors-mXYxG0XB.mjs";
+import { n as Module } from "../module.decorator-CYHY6pG5.mjs";
+import "../module/index.mjs";
 //#region src/cache/cache.error.ts
 var CacheError = class extends ApplicationError {};
 //#endregion
+//#region src/cache/cache.tokens.ts
+const CACHE_TOKENS = {
+	CacheService: Symbol.for("stratal:cache:service"),
+	TieredCacheService: Symbol.for("stratal:cache:tiered-service")
+};
+//#endregion
 //#region src/cache/services/cache.service.ts
 var _CacheService;
 let CacheService = _CacheService = class CacheService {
@@ -19,47 +25,34 @@ let CacheService = _CacheService = class CacheService {
 		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;
+	/** The KV namespace this instance is bound to. */
+	get namespace() {
+		return this.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)
-	*   }
-	* }
-	* ```
+	* Create a new CacheService instance bound to a different KV namespace.
 	*
 	* @param kv - KV namespace to use
-	* @returns New CacheService instance with the specified binding
+	* @returns A new CacheService for the given binding
 	*/
 	withBinding(kv) {
 		const instance = new _CacheService(this.env, this.logger);
-		instance.setKV(kv);
+		instance.kv = kv;
 		return instance;
 	}
+	/**
+	* Create a new CacheService instance bound to a KV namespace by its binding
+	* name, resolved from the environment.
+	*
+	* @param name - KV namespace binding name (e.g. `'UPLOADS_CACHE'`)
+	* @returns A new CacheService for the given binding
+	* @throws {CacheError} If no binding with that name exists in the environment
+	*/
+	binding(name) {
+		const kv = this.env[name];
+		if (!kv) throw new CacheError(`KV binding "${name}" was not found in the environment`);
+		return this.withBinding(kv);
+	}
 	async get(key, typeOrOptions) {
 		try {
 			if (typeof typeOrOptions === "string") return await this.kv.get(key, typeOrOptions);
@@ -174,6 +167,94 @@ CacheService = _CacheService = __decorate([
 	__decorateParam(1, inject(LOGGER_TOKENS.LoggerService))
 ], CacheService);
 //#endregion
+//#region src/cache/services/tiered-cache.service.ts
+var _TieredCacheService;
+/**
+* Max entries kept in the isolate-local L1 before the oldest is evicted (FIFO).
+* Bounds memory per isolate; KV remains the unbounded source of truth.
+*/
+const L1_MAX_ENTRIES = 1e3;
+let TieredCacheService = _TieredCacheService = class TieredCacheService {
+	cache;
+	/** Isolate-local L1 tier. Per-instance, so each binding has its own. */
+	l1 = /* @__PURE__ */ new Map();
+	/** Memoized tiered instances per binding name (each with its own L1). */
+	children = /* @__PURE__ */ new Map();
+	constructor(cache) {
+		this.cache = cache;
+	}
+	/**
+	* Get the tiered cache bound to a KV namespace by its binding name. Memoized:
+	* repeated calls with the same name return the same instance, preserving its
+	* isolate-local L1 across requests/messages.
+	*
+	* @param name - KV namespace binding name (e.g. `'UPLOADS_CACHE'`)
+	* @throws {CacheError} If no binding with that name exists in the environment
+	*/
+	binding(name) {
+		let child = this.children.get(name);
+		if (child === void 0) {
+			child = new _TieredCacheService(this.cache.binding(name));
+			this.children.set(name, child);
+		}
+		return child;
+	}
+	async get(key, typeOrOptions) {
+		const type = typeof typeOrOptions === "string" ? typeOrOptions : typeOrOptions?.type ?? "text";
+		if (type === "text" || type === "json") {
+			const cached = this.l1Read(key);
+			if (cached !== null) return type === "json" ? JSON.parse(cached) : cached;
+		}
+		const value = await this.cache.get(key, typeOrOptions);
+		if (type === "text" && typeof value === "string") this.l1Write(key, value, null);
+		return value;
+	}
+	async getWithMetadata(key, typeOrOptions) {
+		return this.cache.getWithMetadata(key, typeOrOptions);
+	}
+	async put(key, value, options) {
+		await this.cache.put(key, value, options);
+		if (typeof value === "string") this.l1Write(key, value, this.l1ExpiresAt(options));
+		else this.l1.delete(key);
+	}
+	async delete(key) {
+		await this.cache.delete(key);
+		this.l1.delete(key);
+	}
+	async list(options) {
+		return this.cache.list(options);
+	}
+	/** Read a fresh L1 entry, evicting it if expired. Returns `null` on miss. */
+	l1Read(key) {
+		const entry = this.l1.get(key);
+		if (entry === void 0) return null;
+		if (entry.expiresAt !== null && Date.now() >= entry.expiresAt) {
+			this.l1.delete(key);
+			return null;
+		}
+		return entry.value;
+	}
+	/** Write an L1 entry, refreshing its recency and evicting the oldest at cap. */
+	l1Write(key, value, expiresAt) {
+		this.l1.delete(key);
+		if (this.l1.size >= L1_MAX_ENTRIES) {
+			const oldest = this.l1.keys().next().value;
+			if (oldest !== void 0) this.l1.delete(oldest);
+		}
+		this.l1.set(key, {
+			value,
+			expiresAt
+		});
+	}
+	/** Compute an absolute L1 expiry (epoch ms) from KV put options. */
+	l1ExpiresAt(options) {
+		if (options?.expiration !== void 0) return options.expiration * 1e3;
+		if (options?.expirationTtl !== void 0) return Date.now() + options.expirationTtl * 1e3;
+		return null;
+	}
+};
+TieredCacheService = _TieredCacheService = __decorate([Singleton(CACHE_TOKENS.TieredCacheService), __decorateParam(0, inject(CACHE_TOKENS.CacheService))], TieredCacheService);
+//#endregion
 //#region src/cache/cache.module.ts
 /**
 * Cache Module
@@ -190,8 +271,11 @@ let CacheModule = class CacheModule {};
 CacheModule = __decorate([Module({ providers: [{
 	provide: CACHE_TOKENS.CacheService,
 	useClass: CacheService
+}, {
+	provide: CACHE_TOKENS.TieredCacheService,
+	useClass: TieredCacheService
 }] })], CacheModule);
 //#endregion
-export { CACHE_TOKENS, CacheError, CacheModule, CacheService };
+export { CACHE_TOKENS, CacheError, CacheModule, CacheService, TieredCacheService };
 
 //# sourceMappingURL=index.mjs.map