stratal 0.0.22 → 0.0.24

package/dist/{stratal-Bdq4IdB3.mjs → stratal-DL9M38_s.mjs}

@@ -1,102 +1,11 @@
-import { r as runWithContainer } from "./container-storage-GpNNz79X.mjs";
-import { c as DI_TOKENS, o as ROUTER_TOKENS, t as Container } from "./di-BO1QIb5H.mjs";
+import { r as DI_TOKENS, t as Container, v as ROUTER_TOKENS } from "./di-DseMn-z9.mjs";
+import { n as getContainer, r as runWithContainer, t as containerStorage } from "./container-storage-BmOJ4_Na.mjs";
 import { JsonFormatter, LOGGER_TOKENS, LoggerService, PrettyFormatter } from "./logger/index.mjs";
-import { a as DefaultExceptionHandler, r as StratalNotInitializedError } from "./errors-BBZTnjdq.mjs";
-import { i as createQueueExceptionContext, n as createCronExceptionContext, t as createCliExceptionContext } from "./exception-context-B4kM-M53.mjs";
-import { a as getGroups, i as getGlobalMiddleware, r as getDefaultEntry, t as ModuleRegistry } from "./module-xYoHba6B.mjs";
-import { r as getListenerHandlers, t as EventRegistry } from "./events-D1KdDaiP.mjs";
-import { CacheModule } from "./cache/index.mjs";
-import { t as CronManager } from "./cron-manager-9bpN9bu4.mjs";
-import { n as OpenAPIModule } from "./openapi-C6lm0RmV.mjs";
-import { a as RouteRegistry, d as RouteRegistrationService, n as Uri, o as VersioningService, s as LocalePathService, u as HonoApp } from "./router-Cy6DjkvP.mjs";
-import { t as I18nModule } from "./i18n.module-BlXrtAlV.mjs";
-import { t as QuarryRegistry } from "./quarry-registry-DkraZNwn.mjs";
-import { t as QueueModule } from "./queue.module-DeWJ0tQM.mjs";
-import { i as SeederRegistry, r as SEEDER_TOKENS } from "./seeder-BADTig4n.mjs";
-//#region src/router/router-resolver.ts
-/**
-* Internal resolver that computes the effective Router config for each controller.
-*
-* Inheritance rules:
-* - `middleware`: parent middleware runs first, then child (concatenated)
-* - `prefix`: concatenated (parent + child)
-* - `name`: concatenated (parent + child)
-* - `domain`: child overrides parent
-* - `version`: child overrides parent
-* - `hideFromDocs`: child overrides parent
-*
-* @internal — not exported from stratal/router
-*/
-var RouterResolver = class {
-	routers;
-	constructor(routers) {
-		this.routers = routers;
-	}
-	/**
-	* Resolve the effective config for a given controller class.
-	* Searches through all module routers to find the one owning this controller.
-	*/
-	resolveForController(controller) {
-		for (const { router, controllers: moduleControllers } of this.routers) {
-			if (!moduleControllers.includes(controller)) continue;
-			for (const group of router[getGroups]()) if (group.controllers?.includes(controller)) return this.mergeEntries(router[getDefaultEntry](), group);
-			if (!new Set(router[getGroups]().flatMap((g) => g.controllers ?? [])).has(controller)) return this.entryToConfig(router[getDefaultEntry]());
-		}
-		return { middleware: [] };
-	}
-	/**
-	* Collect all global middleware registered via `router.use()` across all modules.
-	*/
-	getGlobalMiddleware() {
-		const global = [];
-		for (const { router } of this.routers) global.push(...router[getGlobalMiddleware]());
-		return global;
-	}
-	/**
-	* Merge parent default entry with child group entry following inheritance rules.
-	*/
-	mergeEntries(parent, child) {
-		return {
-			prefix: this.concatPrefixes(parent.prefix, child.prefix),
-			domain: child.domain ?? parent.domain,
-			name: this.concatNames(parent.name, child.name),
-			middleware: [...parent.middleware, ...child.middleware],
-			version: child.version ?? parent.version,
-			hideFromDocs: child.hideFromDocs ?? parent.hideFromDocs,
-			params: this.mergeParams(parent.params, child.params)
-		};
-	}
-	entryToConfig(entry) {
-		return {
-			prefix: entry.prefix,
-			domain: entry.domain,
-			name: entry.name,
-			middleware: [...entry.middleware],
-			version: entry.version,
-			hideFromDocs: entry.hideFromDocs,
-			params: entry.params
-		};
-	}
-	mergeParams(parent, child) {
-		if (!parent && !child) return void 0;
-		if (!parent) return child;
-		if (!child) return parent;
-		return parent.extend(child.shape);
-	}
-	concatPrefixes(parent, child) {
-		if (!parent && !child) return void 0;
-		if (!parent) return child;
-		if (!child) return parent;
-		return `${parent.endsWith("/") ? parent.slice(0, -1) : parent}${child.startsWith("/") ? child : `/${child}`}`;
-	}
-	concatNames(parent, child) {
-		if (!parent && !child) return void 0;
-		if (!parent) return child;
-		if (!child) return parent;
-		return `${parent}${child}`;
-	}
-};
-//#endregion
+import { a as DefaultExceptionHandler, r as StratalNotInitializedError } from "./errors-mXYxG0XB.mjs";
+import { i as createQueueExceptionContext, n as createCronExceptionContext, t as createCliExceptionContext } from "./exception-context-kEoMFwze.mjs";
+import { a as getListenerHandlers } from "./events-BXJGZjpG.mjs";
+import { d as LazyModuleLoader, t as ModuleRegistry } from "./module-registry-Dm-pqHd3.mjs";
+import { t as SEEDER_TOKENS } from "./seeder-registry-CyUmKsJq.mjs";
 //#region src/application.ts
 var Application = class {
 	_container;
@@ -107,7 +16,10 @@ var Application = class {
 	quarry;
 	initialized = false;
 	routingInitPromise = null;
-	handlerInitPromise = null;
+	eventsInitPromise = null;
+	queueInitPromise = null;
+	i18nInitPromise = null;
+	cronInitPromise = null;
 	env;
 	appConfig;
 	constructor({ env, ctx, ...config }) {
@@ -139,48 +51,109 @@ var Application = class {
 		await runWithContainer(this._container, () => this.initializeInternal());
 	}
 	async initializeInternal() {
-		this.moduleRegistry.registerAll([
-			I18nModule,
-			QueueModule,
-			CacheModule
-		]);
+		const [{ QuarryModule }, { SeederModule }] = await Promise.all([import("./quarry.module-BuRPGMDm.mjs").then((n) => n.n), import("./seeder.module-CYYwk3Qk.mjs").then((n) => n.n)]);
+		this.moduleRegistry.registerAll([QuarryModule, SeederModule]);
 		this.moduleRegistry.register(this.appConfig.module);
 		await this.moduleRegistry.initialize();
 		this.initializeExceptionHandler();
-		this.cronManager = this._container.resolve(DI_TOKENS.Cron);
-		this.registerCronJobs();
-		this.registerSeeders();
 		this.registerCommands();
+		this.registerSeeders();
+		if (this.moduleRegistry.getAllListeners().length > 0) await this.initializeEventListeners();
+		if (this.moduleRegistry.getAllJobs().length > 0) await this.ensureCron();
 		this.initialized = true;
 	}
-	registerRoutingServices() {
+	async registerRoutingServices() {
+		const [{ HonoApp }, { RouteRegistry }, { RouterResolver }, { VersioningService }, { LocalePathService }, { LocaleUrlService }, { RouteRegistrationService }, { Uri }] = await Promise.all([
+			import("./hono-app-CvV3hOfT.mjs").then((n) => n.n),
+			import("./route-registry-CYqLp2Nj.mjs").then((n) => n.n),
+			import("./router-resolver-D4YlPNlm.mjs"),
+			import("./versioning.service-C6aHky8-.mjs").then((n) => n.n),
+			import("./locale-path.service-D-dHiIPc.mjs").then((n) => n.n),
+			import("./locale-url.service-C2EWmGdq.mjs").then((n) => n.n),
+			import("./route-registration.service-D6vSwiKP.mjs").then((n) => n.n),
+			import("./uri-h7Q8Jug9.mjs").then((n) => n.r)
+		]);
 		this._container.register(ROUTER_TOKENS.VersioningService, VersioningService);
 		this._container.register(ROUTER_TOKENS.HonoApp, HonoApp);
 		this._container.register(ROUTER_TOKENS.LocalePathService, LocalePathService);
+		this._container.register(ROUTER_TOKENS.LocaleUrlService, LocaleUrlService);
 		this._container.register(ROUTER_TOKENS.RouteRegistry, RouteRegistry);
 		this._container.register(ROUTER_TOKENS.Uri, Uri);
 		const routerConfigs = this.moduleRegistry.getAllRouterConfigs();
 		if (routerConfigs.length > 0) this._container.registerValue(ROUTER_TOKENS.RouterResolver, new RouterResolver(routerConfigs));
 		this._container.register(RouteRegistrationService, RouteRegistrationService);
 	}
-	async initializeHandlers() {
-		this.handlerInitPromise ??= runWithContainer(this._container, () => {
-			this.consumerRegistry = this._container.resolve(DI_TOKENS.ConsumerRegistry);
-			this.registerQueueConsumers();
+	/**
+	* Load the events subsystem and wire listeners. Needed by the HTTP, queue,
+	* and scheduled paths (handlers emit events). Independent of the queue
+	* subsystem so HTTP-only apps never load queue code. EventsModule is
+	* registered before the (possibly empty) listener wiring so `emit()` works
+	* even with zero listeners; dedups against the framework's own load.
+	*/
+	initializeEventListeners() {
+		this.eventsInitPromise ??= runWithContainer(this._container, async () => {
+			const { EventsModule } = await import("./events-BXJGZjpG.mjs").then((n) => n.n);
+			await this.moduleRegistry.registerLazy(EventsModule);
 			this.registerEventListeners();
-			return Promise.resolve();
 		});
-		return this.handlerInitPromise;
+		return this.eventsInitPromise;
 	}
-	initializeRouting() {
-		this.routingInitPromise ??= runWithContainer(this._container, async () => {
-			await this.initializeHandlers();
-			this.moduleRegistry.register(OpenAPIModule);
-			this.registerRoutingServices();
-			this.honoApp = this._container.resolve(ROUTER_TOKENS.HonoApp);
-			await this.honoApp.configure();
+	/**
+	* Wire event and queue handlers for any non-HTTP request scope — queue
+	* batches, scheduled/cron runs, CLI commands, Durable Objects, Workflows,
+	* WorkerEntrypoints — all of which may emit events or dispatch to queues from
+	* arbitrary user code. This is the single source of truth for that wiring:
+	* every non-HTTP entry point routes through it rather than open-coding which
+	* subsystems to init, so a subsystem can't be silently dropped by a future
+	* refactor (the queue half was once lost from the command path that way).
+	*
+	* HTTP (`fetch`) deliberately does NOT use this: a fetch worker only enqueues
+	* to the async Cloudflare queue and never processes consumers inline, so it
+	* skips queue init via `initializeRouting`.
+	*/
+	async ensureScopedHandlers() {
+		await this.initializeEventListeners();
+		await this.initializeQueue();
+	}
+	/**
+	* Load the queue subsystem on demand (first queue/scheduled trigger). i18n is
+	* ensured first because the queue registry depends on it.
+	*/
+	initializeQueue() {
+		this.queueInitPromise ??= runWithContainer(this._container, async () => {
+			await this.ensureI18n();
+			const { QueueModule } = await import("./queue.module-nddvxzCB.mjs").then((n) => n.n);
+			this.moduleRegistry.register(QueueModule);
+			this.consumerRegistry = this._container.resolve(DI_TOKENS.ConsumerRegistry);
+			await this.registerQueueConsumers();
 		});
-		return this.routingInitPromise;
+		return this.queueInitPromise;
+	}
+	/**
+	* Load i18n on demand. Coupled to the request path (Zod validation error maps,
+	* OpenAPI descriptions, queue registry), so it loads before routing/queue
+	* handling. Uses `registerLazy` because I18nModule has an `onInitialize` hook
+	* (configures the Zod error map). Dedups if the app already imported i18n.
+	*/
+	ensureI18n() {
+		this.i18nInitPromise ??= runWithContainer(this._container, async () => {
+			const { I18nModule } = await import("./i18n.module-DRQAZoSZ.mjs").then((n) => n.n);
+			await this.moduleRegistry.registerLazy(I18nModule);
+		});
+		return this.i18nInitPromise;
+	}
+	/**
+	* Load the cron subsystem on demand (first scheduled trigger, or at bootstrap
+	* when the app declares jobs).
+	*/
+	ensureCron() {
+		this.cronInitPromise ??= runWithContainer(this._container, async () => {
+			const { CronModule } = await import("./cron.module-Bgzq5hiT.mjs").then((n) => n.n);
+			this.moduleRegistry.register(CronModule);
+			this.cronManager = this._container.resolve(DI_TOKENS.Cron);
+			this.registerCronJobs(this.cronManager);
+		});
+		return this.cronInitPromise.then(() => this.cronManager);
 	}
 	resolve(token) {
 		try {
@@ -193,7 +166,7 @@ var Application = class {
 		}
 	}
 	async handleQueue(batch, queueName) {
-		await this.initializeHandlers();
+		await this.ensureScopedHandlers();
 		const locale = (batch.messages[0]?.body)?.metadata?.locale ?? "en";
 		const mockRouterContext = this.createMockRouterContext(locale);
 		await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {
@@ -206,11 +179,13 @@ var Application = class {
 		});
 	}
 	async handleScheduled(controller) {
-		await this.initializeHandlers();
+		const cronManager = await this.ensureCron();
+		await this.ensureScopedHandlers();
+		await this.ensureI18n();
 		const mockRouterContext = this.createMockRouterContext("en");
 		await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {
 			try {
-				await this.cronManager.executeScheduled(controller, requestContainer);
+				await cronManager.executeScheduled(controller, requestContainer);
 			} catch (error) {
 				await requestContainer.resolve(DI_TOKENS.ExceptionHandler).handle(error, createCronExceptionContext());
 				throw error;
@@ -221,7 +196,7 @@ var Application = class {
 		return {
 			getLocale: () => locale,
 			setLocale: () => {},
-			getContainer: () => this._container
+			getContainer: () => containerStorage.getStore() ?? this._container
 		};
 	}
 	async shutdown() {
@@ -233,12 +208,25 @@ var Application = class {
 	}
 	async handleCommand(name, input) {
 		await this.initializeRouting();
+		await this.ensureScopedHandlers();
 		this.quarry ??= this._container.resolve(DI_TOKENS.Quarry);
 		const mockContext = this.createMockRouterContext("en");
 		return this._container.runInRequestScope(mockContext, async () => {
 			return this.quarry.call(name, input);
 		});
 	}
+	initializeRouting() {
+		this.routingInitPromise ??= runWithContainer(this._container, async () => {
+			await this.initializeEventListeners();
+			await this.ensureI18n();
+			const { OpenAPIModule } = await import("./openapi/index.mjs");
+			this.moduleRegistry.register(OpenAPIModule);
+			await this.registerRoutingServices();
+			this.honoApp = this._container.resolve(ROUTER_TOKENS.HonoApp);
+			await this.honoApp.configure();
+		});
+		return this.routingInitPromise;
+	}
 	registerCommands() {
 		this.quarry ??= this._container.resolve(DI_TOKENS.Quarry);
 		const commands = this.moduleRegistry.getAllCommands();
@@ -250,16 +238,22 @@ var Application = class {
 		const registry = this._container.resolve(SEEDER_TOKENS.SeederRegistry);
 		for (const SeederClass of seeders) registry.register(SeederClass);
 	}
-	registerQueueConsumers() {
-		for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {
-			const consumer = this._container.resolve(ConsumerClass);
-			this.consumerRegistry.register(consumer);
-		}
+	async registerQueueConsumers() {
+		const consumerClasses = this.moduleRegistry.getAllConsumers();
+		if (consumerClasses.length === 0) return;
+		const mockContext = this.createMockRouterContext("en");
+		await this._container.runInRequestScope(mockContext, (requestContainer) => {
+			for (const ConsumerClass of consumerClasses) {
+				const consumer = requestContainer.resolve(ConsumerClass);
+				this.consumerRegistry.register(ConsumerClass, consumer.messageTypes);
+			}
+		});
 	}
-	registerCronJobs() {
+	registerCronJobs(cronManager) {
 		for (const JobClass of this.moduleRegistry.getAllJobs()) {
 			const schedule = JobClass.schedule;
-			if (schedule) this.cronManager.registerJob(schedule, JobClass);
+			if (schedule) cronManager.registerJob(schedule, JobClass);
+			else this._container.resolve(LOGGER_TOKENS.LoggerService).warn(`Cron job "${JobClass.name}" has no static schedule property — skipped`);
 		}
 	}
 	registerEventListeners() {
@@ -267,9 +261,13 @@ var Application = class {
 		if (listeners.length === 0) return;
 		const eventRegistry = this._container.resolve(DI_TOKENS.EventRegistry);
 		for (const ListenerClass of listeners) {
-			const instance = this._container.resolve(ListenerClass);
 			const handlers = getListenerHandlers(ListenerClass);
-			for (const { methodName, event, options } of handlers) eventRegistry.on(event, instance[methodName].bind(instance), options);
+			for (const { methodName, event, options } of handlers) {
+				const handler = ((...args) => {
+					return getContainer().resolve(ListenerClass)[methodName](...args);
+				});
+				eventRegistry.on(event, handler, options);
+			}
 		}
 	}
 	registerLoggerService() {
@@ -279,12 +277,16 @@ var Application = class {
 		this._container.when(() => formatter === "pretty").use(LOGGER_TOKENS.Formatter).give(PrettyFormatter).otherwise(JsonFormatter);
 		this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService);
 	}
+	/**
+	* Bootstrap kernel — registered imperatively because they cannot be expressed
+	* as ordinary module providers: ExceptionHandler is a user-overridable forced
+	* singleton (a module ClassProvider derives scope from the class decorator,
+	* which a user handler may not carry), and LazyModuleLoader is the loader
+	* itself. Subsystem registries (events/cron/quarry/seeder) are modules.
+	*/
 	registerCoreServices() {
-		this._container.registerSingleton(DI_TOKENS.Cron, CronManager);
 		this._container.registerSingleton(DI_TOKENS.ExceptionHandler, this.appConfig.exceptionHandler ?? DefaultExceptionHandler);
-		this._container.registerSingleton(DI_TOKENS.EventRegistry, EventRegistry);
-		this._container.registerSingleton(DI_TOKENS.Quarry, QuarryRegistry);
-		this._container.registerValue(SEEDER_TOKENS.SeederRegistry, new SeederRegistry(this));
+		this._container.registerSingleton(DI_TOKENS.LazyModuleLoader, LazyModuleLoader);
 	}
 	initializeExceptionHandler() {
 		const handler = this._container.resolve(DI_TOKENS.ExceptionHandler);
@@ -378,4 +380,4 @@ var Stratal = class Stratal {
 //#endregion
 export { Application as n, Stratal as t };
 
-//# sourceMappingURL=stratal-Bdq4IdB3.mjs.map
+//# sourceMappingURL=stratal-DL9M38_s.mjs.map

package/dist/stratal-DL9M38_s.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stratal-DL9M38_s.mjs","names":[],"sources":["../src/application.ts","../src/stratal.ts"],"sourcesContent":["import type { CronJob } from './cron/cron-job'\nimport type { CronManager } from './cron/cron-manager'\nimport { Container } from './di/container'\nimport { containerStorage, getContainer, runWithContainer } from './di/container-storage'\nimport { DI_TOKENS } from './di/tokens'\nimport { type StratalEnv } from './env'\nimport { DefaultExceptionHandler } from './errors/default-exception-handler'\nimport { createCliExceptionContext, createCronExceptionContext, createQueueExceptionContext } from './errors/exception-context'\nimport type { ExceptionHandler } from './errors/exception-handler'\nimport type { EventHandler, EventRegistry } from './events'\nimport { getListenerHandlers } from './events'\nimport type { StratalExecutionContext } from './execution-context'\nimport { JsonFormatter, LOGGER_TOKENS, LoggerService, LogLevel, PrettyFormatter } from './logger'\nimport { LazyModuleLoader } from './module/lazy-module-loader'\nimport { ModuleRegistry } from './module/module-registry'\nimport type { DynamicModule, ModuleClass } from './module/types'\nimport type { Command } from './quarry/command'\nimport type { QuarryRegistry } from './quarry/quarry-registry'\nimport type { CommandInput, CommandResult } from './quarry/types'\nimport type { ConsumerRegistry } from './queue/consumer-registry'\nimport type { IQueueConsumer, QueueMessage } from './queue/queue-consumer'\nimport type { QueueManager } from './queue/queue-manager'\nimport type { RouterContext } from './router'\nimport type { HonoApp } from './router/hono-app'\nimport { ROUTER_TOKENS } from './router/router.tokens'\nimport type { TrailingSlashMode, VersioningOptions } from './router/types'\nimport type { Seeder } from './seeder/seeder'\nimport { SEEDER_TOKENS } from './seeder/seeder-registry'\nimport type { SeederRegistry } from './seeder/seeder-registry'\nimport type { Constructor } from './types'\n\nexport interface ApplicationConfig {\n  module: ModuleClass | DynamicModule\n  logging?: {\n    level?: LogLevel\n    formatter?: 'json' | 'pretty'\n  }\n  versioning?: VersioningOptions\n  trailingSlash?: TrailingSlashMode\n  exceptionHandler?: Constructor<ExceptionHandler>\n}\n\nexport interface ApplicationOptions extends ApplicationConfig {\n  env: StratalEnv\n  ctx: StratalExecutionContext\n}\n\nexport class Application {\n  private _container: Container\n  private honoApp!: HonoApp\n  private moduleRegistry: ModuleRegistry\n  private consumerRegistry!: ConsumerRegistry\n  private cronManager?: CronManager\n  private quarry!: QuarryRegistry\n  private initialized = false\n\n  // Independently memoized lazy-init promises — each built-in subsystem is\n  // loaded on demand at its trigger point to keep cold start lean.\n  private routingInitPromise: Promise<void> | null = null\n  private eventsInitPromise: Promise<void> | null = null\n  private queueInitPromise: Promise<void> | null = null\n  private i18nInitPromise: Promise<void> | null = null\n  private cronInitPromise: Promise<void> | null = null\n\n  readonly env: StratalEnv\n  private readonly appConfig: ApplicationConfig\n\n  constructor({ env, ctx, ...config }: ApplicationOptions) {\n    this.env = env\n    this.appConfig = config\n\n    this._container = new Container()\n\n    this._container.registerValue(DI_TOKENS.Application, this)\n    this._container.registerValue(DI_TOKENS.CloudflareEnv, env)\n    this._container.registerValue(DI_TOKENS.ExecutionContext, ctx)\n    this._container.registerValue(ROUTER_TOKENS.RouterContext, null)\n\n    this.registerLoggerService()\n    this.registerCoreServices()\n\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.moduleRegistry = new ModuleRegistry(this._container, logger)\n\n    this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry)\n  }\n\n  get container(): Container {\n    return this._container\n  }\n\n  async ensureHono(): Promise<HonoApp> {\n    await this.initializeRouting()\n    return this.honoApp\n  }\n\n  get config(): ApplicationConfig {\n    return this.appConfig\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    await runWithContainer(this._container, () => this.initializeInternal())\n  }\n\n  private async initializeInternal(): Promise<void> {\n    // Eager subsystem modules — Quarry/Seeder are resolved synchronously\n    // post-init (CLI runner, test harness), so they must be registered before\n    // initialize() completes. Dynamic import keeps application.ts free of static\n    // subsystem imports (uniform with the other built-ins). They load at boot\n    // regardless, so this is for consistency, not cold-start deferral.\n    const [{ QuarryModule }, { SeederModule }] = await Promise.all([\n      import('./quarry/quarry.module'),\n      import('./seeder/seeder.module'),\n    ])\n    this.moduleRegistry.registerAll([QuarryModule, SeederModule])\n\n    // Register the user's root module (traverses imports). Other built-in\n    // subsystems (i18n, queue, cache, openapi, cron, events, router) load on\n    // demand at their trigger points.\n    this.moduleRegistry.register(this.appConfig.module)\n\n    // Initialize all modules (only those with lifecycle hooks)\n    await this.moduleRegistry.initialize()\n\n    // Initialize ExceptionHandler\n    this.initializeExceptionHandler()\n\n    // Register CLI commands + seeders (class refs only; no instantiation)\n    this.registerCommands()\n    this.registerSeeders()\n\n    // Wire event listeners as part of initialization whenever the application\n    // declares any, so emitted events reach their handlers regardless of which\n    // entry point drives the app. Listener wiring otherwise happens lazily only\n    // on the HTTP router (`initializeRouting`) and queue/scheduled/command\n    // (`ensureScopedHandlers`) paths; any code that emits events without going\n    // through one of those — a direct service or repository call, an RPC\n    // entrypoint, or a Durable Object — would dispatch into a registry with no\n    // handlers attached, silently dropping the event. Guarded on there being\n    // listeners so applications with none still skip loading the events\n    // subsystem; `initializeEventListeners` dedups, so any later lazy trigger\n    // becomes a no-op.\n    if (this.moduleRegistry.getAllListeners().length > 0) {\n      await this.initializeEventListeners()\n    }\n\n    // Cron only loads when the app actually declares scheduled jobs\n    if (this.moduleRegistry.getAllJobs().length > 0) {\n      await this.ensureCron()\n    }\n\n    this.initialized = true\n  }\n\n  private async registerRoutingServices(): Promise<void> {\n    const [\n      { HonoApp },\n      { RouteRegistry },\n      { RouterResolver },\n      { VersioningService },\n      { LocalePathService },\n      { LocaleUrlService },\n      { RouteRegistrationService },\n      { Uri },\n    ] = await Promise.all([\n      import('./router/hono-app'),\n      import('./router/route-registry'),\n      import('./router/router-resolver'),\n      import('./router/services/versioning.service'),\n      import('./router/services/locale-path.service'),\n      import('./router/services/locale-url.service'),\n      import('./router/services/route-registration.service'),\n      import('./router/uri'),\n    ])\n\n    this._container.register(ROUTER_TOKENS.VersioningService, VersioningService)\n    this._container.register(ROUTER_TOKENS.HonoApp, HonoApp)\n    this._container.register(ROUTER_TOKENS.LocalePathService, LocalePathService)\n    this._container.register(ROUTER_TOKENS.LocaleUrlService, LocaleUrlService)\n    this._container.register(ROUTER_TOKENS.RouteRegistry, RouteRegistry)\n    this._container.register(ROUTER_TOKENS.Uri, Uri)\n\n    const routerConfigs = this.moduleRegistry.getAllRouterConfigs()\n    if (routerConfigs.length > 0) {\n      this._container.registerValue(ROUTER_TOKENS.RouterResolver, new RouterResolver(routerConfigs))\n    }\n\n    this._container.register(RouteRegistrationService, RouteRegistrationService)\n  }\n\n  /**\n   * Load the events subsystem and wire listeners. Needed by the HTTP, queue,\n   * and scheduled paths (handlers emit events). Independent of the queue\n   * subsystem so HTTP-only apps never load queue code. EventsModule is\n   * registered before the (possibly empty) listener wiring so `emit()` works\n   * even with zero listeners; dedups against the framework's own load.\n   */\n  private initializeEventListeners(): Promise<void> {\n    this.eventsInitPromise ??= runWithContainer(this._container, async () => {\n      const { EventsModule } = await import('./events/events.module')\n      await this.moduleRegistry.registerLazy(EventsModule)\n      this.registerEventListeners()\n    })\n    return this.eventsInitPromise\n  }\n\n  /**\n   * Wire event and queue handlers for any non-HTTP request scope — queue\n   * batches, scheduled/cron runs, CLI commands, Durable Objects, Workflows,\n   * WorkerEntrypoints — all of which may emit events or dispatch to queues from\n   * arbitrary user code. This is the single source of truth for that wiring:\n   * every non-HTTP entry point routes through it rather than open-coding which\n   * subsystems to init, so a subsystem can't be silently dropped by a future\n   * refactor (the queue half was once lost from the command path that way).\n   *\n   * HTTP (`fetch`) deliberately does NOT use this: a fetch worker only enqueues\n   * to the async Cloudflare queue and never processes consumers inline, so it\n   * skips queue init via `initializeRouting`.\n   */\n  async ensureScopedHandlers(): Promise<void> {\n    await this.initializeEventListeners()\n    await this.initializeQueue()\n  }\n\n  /**\n   * Load the queue subsystem on demand (first queue/scheduled trigger). i18n is\n   * ensured first because the queue registry depends on it.\n   */\n  private initializeQueue(): Promise<void> {\n    this.queueInitPromise ??= runWithContainer(this._container, async () => {\n      await this.ensureI18n()\n      const { QueueModule } = await import('./queue/queue.module')\n      this.moduleRegistry.register(QueueModule as unknown as ModuleClass)\n      this.consumerRegistry = this._container.resolve<ConsumerRegistry>(DI_TOKENS.ConsumerRegistry)\n      await this.registerQueueConsumers()\n    })\n    return this.queueInitPromise\n  }\n\n  /**\n   * Load i18n on demand. Coupled to the request path (Zod validation error maps,\n   * OpenAPI descriptions, queue registry), so it loads before routing/queue\n   * handling. Uses `registerLazy` because I18nModule has an `onInitialize` hook\n   * (configures the Zod error map). Dedups if the app already imported i18n.\n   */\n  private ensureI18n(): Promise<void> {\n    this.i18nInitPromise ??= runWithContainer(this._container, async () => {\n      const { I18nModule } = await import('./i18n/i18n.module')\n      await this.moduleRegistry.registerLazy(I18nModule as unknown as ModuleClass)\n    })\n    return this.i18nInitPromise\n  }\n\n  /**\n   * Load the cron subsystem on demand (first scheduled trigger, or at bootstrap\n   * when the app declares jobs).\n   */\n  private ensureCron(): Promise<CronManager> {\n    this.cronInitPromise ??= runWithContainer(this._container, async () => {\n      const { CronModule } = await import('./cron/cron.module')\n      this.moduleRegistry.register(CronModule)\n      this.cronManager = this._container.resolve<CronManager>(DI_TOKENS.Cron)\n      this.registerCronJobs(this.cronManager)\n    })\n    return this.cronInitPromise.then(() => this.cronManager!)\n  }\n\n  resolve<T>(token: symbol): T {\n    try {\n      return this._container.resolve(token)\n    } catch (error) {\n      const handler = this._container.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n      const ctx = createCliExceptionContext('resolve')\n      void handler.handle(error, ctx)\n      throw error\n    }\n  }\n\n  async handleQueue(batch: MessageBatch, queueName: string): Promise<void> {\n    await this.ensureScopedHandlers()\n\n    const firstMessage = batch.messages[0]?.body as QueueMessage | undefined\n    const locale = firstMessage?.metadata?.locale ?? 'en'\n    const mockRouterContext = this.createMockRouterContext(locale)\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        const queueManager = requestContainer.resolve<QueueManager>(DI_TOKENS.Queue)\n        await queueManager.processBatch(queueName, batch)\n      } catch (error) {\n        const handler = requestContainer.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n        await handler.handle(error, createQueueExceptionContext(queueName))\n        throw error\n      }\n    })\n  }\n\n  async handleScheduled(controller: ScheduledController): Promise<void> {\n    const cronManager = await this.ensureCron()\n    // A scheduled job is a non-HTTP scope that can emit events and dispatch to\n    // queues (timeout/reminder/digest emails) — wire both so dispatches aren't\n    // silently dropped by the sync provider. i18n is ensured independently for\n    // the job execution context. All inits are memoized, so this is idempotent.\n    await this.ensureScopedHandlers()\n    await this.ensureI18n()\n\n    const mockRouterContext = this.createMockRouterContext('en')\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        await cronManager.executeScheduled(controller, requestContainer)\n      } catch (error) {\n        const handler = requestContainer.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n        await handler.handle(error, createCronExceptionContext())\n        throw error\n      }\n    })\n  }\n\n  createMockRouterContext(locale = 'en'): RouterContext {\n    return {\n      getLocale: () => locale,\n      setLocale: () => { /* no-op */ },\n      // Inside runInRequestScope the active container is the request-scoped child\n      // (set in AsyncLocalStorage); return it so request-scoped providers resolve\n      // against the scope, not the global container.\n      getContainer: () => containerStorage.getStore() ?? this._container,\n    } as unknown as RouterContext\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.initialized) return\n    this.initialized = false\n\n    await this.moduleRegistry.shutdown()\n\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    logger.info('Disposing container...')\n\n    this._container.dispose()\n  }\n\n  async handleCommand(name: string, input?: CommandInput): Promise<CommandResult> {\n    // Routing first: commands generate URLs via route() (e.g. tenant:bootstrap\n    // prints tenant URLs / builds email links).\n    await this.initializeRouting()\n    // A CLI command is a non-HTTP scope that can dispatch to queues and emit\n    // events from arbitrary user code (e.g. tenant:bootstrap → email.send /\n    // tenant.geo.seed). Without this the dev/CLI sync provider finds zero\n    // consumers and silently drops every dispatched message. All inits are\n    // memoized, so the events half (already wired by routing) is a no-op here.\n    await this.ensureScopedHandlers()\n    // Resolve QuarryRegistry lazily (deferred from bootstrap)\n    this.quarry ??= this._container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n    const mockContext = this.createMockRouterContext('en')\n    return this._container.runInRequestScope(mockContext, async () => {\n      return this.quarry.call(name, input)\n    })\n  }\n\n  private initializeRouting(): Promise<void> {\n    this.routingInitPromise ??= runWithContainer(this._container, async () => {\n      await this.initializeEventListeners()\n      await this.ensureI18n()\n      const { OpenAPIModule } = await import('./openapi')\n      this.moduleRegistry.register(OpenAPIModule as unknown as ModuleClass)\n      await this.registerRoutingServices()\n      this.honoApp = this._container.resolve<HonoApp>(ROUTER_TOKENS.HonoApp)\n      await this.honoApp.configure()\n    })\n    return this.routingInitPromise\n  }\n\n  private registerCommands(): void {\n    this.quarry ??= this._container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n    const commands = this.moduleRegistry.getAllCommands()\n    for (const CommandClass of commands) {\n      this.quarry.register(CommandClass as Constructor<Command>)\n    }\n  }\n\n  private registerSeeders(): void {\n    const seeders = this.moduleRegistry.getAllSeeders()\n    if (seeders.length === 0) return\n    const registry = this._container.resolve<SeederRegistry>(SEEDER_TOKENS.SeederRegistry)\n    for (const SeederClass of seeders) {\n      registry.register(SeederClass as Constructor<Seeder>)\n    }\n  }\n\n  private async registerQueueConsumers(): Promise<void> {\n    const consumerClasses = this.moduleRegistry.getAllConsumers()\n    if (consumerClasses.length === 0) return\n\n    // Consumers are resolved fresh per message at dispatch time (see\n    // QueueManager / SyncQueueProvider). Here we only need each consumer's\n    // declared message types; read them from a throwaway instance built inside a\n    // request scope so a consumer that injects request-scoped providers\n    // (@InjectQueue, i18n, auth context, …) doesn't fail to instantiate at boot.\n    const mockContext = this.createMockRouterContext('en')\n    await this._container.runInRequestScope(mockContext, (requestContainer) => {\n      for (const ConsumerClass of consumerClasses) {\n        const consumer = requestContainer.resolve(ConsumerClass) as IQueueConsumer\n        this.consumerRegistry.register(\n          ConsumerClass as Constructor<IQueueConsumer>,\n          consumer.messageTypes,\n        )\n      }\n    })\n  }\n\n  private registerCronJobs(cronManager: CronManager): void {\n    for (const JobClass of this.moduleRegistry.getAllJobs()) {\n      const schedule = (JobClass as unknown as { schedule: string }).schedule\n      if (schedule) {\n        cronManager.registerJob(schedule, JobClass as Constructor<CronJob>)\n      } else {\n        const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n        logger.warn(`Cron job \"${JobClass.name}\" has no static schedule property — skipped`)\n      }\n    }\n  }\n\n  private registerEventListeners(): void {\n    const listeners = this.moduleRegistry.getAllListeners()\n    if (listeners.length === 0) {\n      return\n    }\n\n    const eventRegistry = this._container.resolve<EventRegistry>(DI_TOKENS.EventRegistry)\n\n    for (const ListenerClass of listeners) {\n      const handlers = getListenerHandlers(ListenerClass)\n\n      for (const { methodName, event, options } of handlers) {\n        // Resolve the listener fresh per event from the active scope (events are\n        // emitted inside an HTTP request or runInScope), so request-scoped\n        // listener dependencies bind to the emitting request rather than being\n        // frozen at boot. Listener metadata is read from the class statically —\n        // no instance is created until an event actually fires.\n        const handler: EventHandler = ((...args: unknown[]) => {\n          const instance = getContainer().resolve(ListenerClass) as Record<\n            string,\n            (...a: unknown[]) => unknown\n          >\n          return instance[methodName](...args)\n        }) as EventHandler\n\n        eventRegistry.on(event, handler, options)\n      }\n    }\n  }\n\n  private registerLoggerService(): void {\n    const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO\n    const formatter = this.appConfig.logging?.formatter ?? 'json'\n\n    this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel)\n\n    this._container\n      .when(() => formatter === 'pretty')\n      .use(LOGGER_TOKENS.Formatter)\n      .give(PrettyFormatter)\n      .otherwise(JsonFormatter)\n\n    this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService)\n  }\n\n  /**\n   * Bootstrap kernel — registered imperatively because they cannot be expressed\n   * as ordinary module providers: ExceptionHandler is a user-overridable forced\n   * singleton (a module ClassProvider derives scope from the class decorator,\n   * which a user handler may not carry), and LazyModuleLoader is the loader\n   * itself. Subsystem registries (events/cron/quarry/seeder) are modules.\n   */\n  private registerCoreServices(): void {\n    this._container.registerSingleton(\n      DI_TOKENS.ExceptionHandler,\n      (this.appConfig.exceptionHandler ?? DefaultExceptionHandler) as Constructor,\n    )\n    this._container.registerSingleton(DI_TOKENS.LazyModuleLoader, LazyModuleLoader)\n  }\n\n  private initializeExceptionHandler(): void {\n    const handler = this._container.resolve<ExceptionHandler>(DI_TOKENS.ExceptionHandler)\n    handler.register()\n    this.moduleRegistry.configureExceptionHandlers(handler)\n  }\n}\n","import { Application, type ApplicationConfig } from './application'\nimport type { StratalEnv } from './env'\nimport { StratalNotInitializedError } from './errors'\nimport type { HonoApp } from './router/hono-app'\n\n/**\n * Stratal — Hono-style entry point for Cloudflare Workers.\n *\n * Eagerly bootstraps the Application at construction time, dynamically\n * importing `cloudflare:workers` for env and waitUntil.\n *\n * @example\n * ```typescript\n * import { Stratal } from 'stratal'\n * import { AppModule } from './app.module'\n *\n * export default new Stratal({ module: AppModule })\n * ```\n */\nexport class Stratal<Env extends StratalEnv = StratalEnv> {\n  private app: Application | null = null\n  private initPromise: Promise<Application>\n\n  private static _application: Promise<Application> | null = null\n  private static _generation = 0\n  private static _previousInstance: Stratal | null = null\n\n  constructor(config: ApplicationConfig) {\n    this.fetch = this.fetch.bind(this)\n    this.queue = this.queue.bind(this)\n    this.scheduled = this.scheduled.bind(this)\n\n    // Invalidate any in-flight initialization from a previous instance (Vite HMR reload)\n    const generation = ++Stratal._generation\n\n    if (Stratal._previousInstance) {\n      void Stratal._previousInstance.shutdown()\n    }\n    Stratal._previousInstance = this\n\n    this.initPromise = this.prepareApp(config, generation)\n    Stratal._application = this.initPromise\n  }\n\n  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {\n    const app = await this.ensureReady()\n    const hono = await app.ensureHono()\n    return hono.fetch(request, env, ctx)\n  }\n\n  async queue(batch: MessageBatch): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleQueue(batch, batch.queue)\n  }\n\n  async scheduled(controller: ScheduledController): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleScheduled(controller)\n  }\n\n  get hono(): Promise<HonoApp> {\n    return this.initPromise.then(app => app.ensureHono())\n  }\n\n  async shutdown(): Promise<void> {\n    try { this.app = await this.initPromise } catch { /* ignore */ }\n    if (this.app) {\n      await this.app.shutdown()\n      this.app = null\n    }\n  }\n\n  /**\n   * @internal\n   * Resolves the Application instance from the static singleton.\n   * Used by worker base classes (DurableObject, Workflow, WorkerEntrypoint)\n   * to access the DI container without going through Cloudflare RPC.\n   */\n  static resolveApplication(): Promise<Application> {\n    if (!Stratal._application) {\n      throw new StratalNotInitializedError()\n    }\n    return Stratal._application\n  }\n\n  private async ensureReady(): Promise<Application> {\n    this.app ??= await this.initPromise;\n    return this.app\n  }\n\n  private async prepareApp(config: ApplicationConfig, generation: number): Promise<Application> {\n    const { env, waitUntil } = await import('cloudflare:workers')\n\n    // After async import, check if a newer instance has replaced us (Vite HMR reload)\n    if (generation !== Stratal._generation) {\n      return new Promise<Application>(() => {\n        //\n      }) // Never resolves — avoids cross-request promise warning\n    }\n\n    const app = new Application({ ...config, env: env as Env, ctx: { waitUntil } })\n    await app.initialize()\n\n    // Check again after initialization completes\n    if (generation !== Stratal._generation) {\n      await app.shutdown()\n      return new Promise<Application>(() => {\n        //\n      })\n    }\n\n    return app\n  }\n}\n"],"mappings":"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"}

package/dist/{stratal-BsKmvP6J.d.mts → stratal-DwDJPY9N.d.mts}

@@ -1,5 +1,5 @@
-import { ct as Application, dn as HonoApp, lt as ApplicationConfig } from "./index-DEncMcC6.mjs";
-import { t as StratalEnv } from "./env-DKSbuBi5.mjs";
+import { ct as Application, gn as HonoApp, lt as ApplicationConfig } from "./index-B_JoEl3V.mjs";
+import { t as StratalEnv } from "./env-ug22bJj7.mjs";
 
 //#region src/stratal.d.ts
 /**
@@ -40,4 +40,4 @@ declare class Stratal<Env extends StratalEnv = StratalEnv> {
 }
 //#endregion
 export { Stratal as t };
-//# sourceMappingURL=stratal-BsKmvP6J.d.mts.map
+//# sourceMappingURL=stratal-DwDJPY9N.d.mts.map

package/dist/{stratal-BsKmvP6J.d.mts.map → stratal-DwDJPY9N.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"stratal-BsKmvP6J.d.mts","names":[],"sources":["../src/stratal.ts"],"mappings":";;;;;AAmBA;;;;;;;;;;;;;cAAa,OAAA,aAAoB,UAAA,GAAa,UAAA;EAAA,QACpC,GAAA;EAAA,QACA,WAAA;EAAA,eAEO,YAAA;EAAA,eACA,WAAA;EAAA,eACA,iBAAA;cAEH,MAAA,EAAQ,iBAAA;EAiBd,KAAA,CAAM,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,gBAAA,GAAmB,OAAA,CAAQ,QAAA;EAMlE,KAAA,CAAM,KAAA,EAAO,YAAA,GAAe,OAAA;EAK5B,SAAA,CAAU,UAAA,EAAY,mBAAA,GAAsB,OAAA;EAAA,IAK9C,IAAA,CAAA,GAAQ,OAAA,CAAQ,OAAA;EAId,QAAA,CAAA,GAAY,OAAA;EA5CV;;;;;;EAAA,OA0DD,kBAAA,CAAA,GAAsB,OAAA,CAAQ,WAAA;EAAA,QAOvB,WAAA;EAAA,QAKA,UAAA;AAAA"}
+{"version":3,"file":"stratal-DwDJPY9N.d.mts","names":[],"sources":["../src/stratal.ts"],"mappings":";;;;;AAmBA;;;;;;;;;;;;;cAAa,OAAA,aAAoB,UAAA,GAAa,UAAA;EAAA,QACpC,GAAA;EAAA,QACA,WAAA;EAAA,eAEO,YAAA;EAAA,eACA,WAAA;EAAA,eACA,iBAAA;cAEH,MAAA,EAAQ,iBAAA;EAiBd,KAAA,CAAM,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,GAAA,EAAK,GAAA,EAAK,gBAAA,GAAmB,OAAA,CAAQ,QAAA;EAMlE,KAAA,CAAM,KAAA,EAAO,YAAA,GAAe,OAAA;EAK5B,SAAA,CAAU,UAAA,EAAY,mBAAA,GAAsB,OAAA;EAAA,IAK9C,IAAA,IAAQ,OAAA,CAAQ,OAAA;EAId,QAAA,IAAY,OAAA;EA5CV;;;;;;EAAA,OA0DD,kBAAA,IAAsB,OAAA,CAAQ,WAAA;EAAA,QAOvB,WAAA;EAAA,QAKA,UAAA;AAAA"}

package/dist/tiered-cache.service-Dv3BhxxE.d.mts

@@ -0,0 +1,79 @@
+import { t as CacheService } from "./cache.service-uElmBtdS.mjs";
+
+//#region src/cache/services/tiered-cache.service.d.ts
+/**
+ * Tiered Cache Service
+ *
+ * Layers an **isolate-local in-memory L1** over {@link CacheService} (KV, the
+ * L2). Opt-in — inject `CACHE_TOKENS.TieredCacheService` instead of
+ * `CACHE_TOKENS.CacheService` when you want it.
+ *
+ * **Why:** KV reads are eventually consistent (a `get` can return an
+ * edge-cached value for up to ~60s after a `put`). The L1 makes writes made
+ * through *this isolate* immediately and consistently visible to subsequent
+ * reads on the same isolate — closing the read-after-write gap KV alone cannot.
+ * This is what makes set-once patterns (e.g. queue idempotency markers) reliable
+ * within an isolate, even inside KV's consistency window.
+ *
+ * **Use it for:** set-once / read-mostly values (idempotency claims, immutable
+ * lookups). **Do not use it for** read-modify-write counters that need
+ * cross-edge freshness (e.g. rate limiting): an isolate that wrote a key reads
+ * its own value until the L1 entry expires, so concurrent increments from other
+ * isolates are missed and overwritten. Use plain {@link CacheService} (KV) or a
+ * Durable-Object store for those.
+ *
+ * **Semantics:**
+ * - L1 caches string-backed values only (`text`/`json`). `arrayBuffer`/`stream`
+ *   reads and non-string writes bypass and invalidate L1.
+ * - `put`/`delete` are write-through: KV and L1 update in lock-step, honoring
+ *   `expirationTtl`/`expiration` for the L1 entry's own expiry.
+ * - `get` populates L1 from `text` reads (the only path that yields the raw
+ *   string). `json` reads are served from L1 when the string was cached by a
+ *   prior `put`/`text` read, otherwise they go straight to KV.
+ * - `getWithMetadata` and `list` always read KV directly (metadata is not held
+ *   in L1).
+ *
+ * **Cross-isolate caveat:** the L1 only observes writes made through its own
+ * isolate. A value mutated by another isolate is not seen until the local entry
+ * expires or is invalidated by a local write/delete.
+ *
+ * **Bindings:** `binding(name)` returns a memoized tiered instance per binding,
+ * so each KV namespace has its own stable, isolate-lifetime L1.
+ */
+declare class TieredCacheService {
+  private readonly cache;
+  /** Isolate-local L1 tier. Per-instance, so each binding has its own. */
+  private readonly l1;
+  /** Memoized tiered instances per binding name (each with its own L1). */
+  private readonly children;
+  constructor(cache: CacheService);
+  /**
+   * 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: string): TieredCacheService;
+  get(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<string | null>;
+  get<ExpectedValue = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<ExpectedValue | null>;
+  get(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<ArrayBuffer | null>;
+  get(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<ReadableStream | null>;
+  getWithMetadata<Metadata = unknown>(key: string, typeOrOptions?: 'text' | KVNamespaceGetOptions<'text'>): Promise<KVNamespaceGetWithMetadataResult<string, Metadata>>;
+  getWithMetadata<ExpectedValue = unknown, Metadata = unknown>(key: string, typeOrOptions: 'json' | KVNamespaceGetOptions<'json'>): Promise<KVNamespaceGetWithMetadataResult<ExpectedValue, Metadata>>;
+  getWithMetadata<Metadata = unknown>(key: string, typeOrOptions: 'arrayBuffer' | KVNamespaceGetOptions<'arrayBuffer'>): Promise<KVNamespaceGetWithMetadataResult<ArrayBuffer, Metadata>>;
+  getWithMetadata<Metadata = unknown>(key: string, typeOrOptions: 'stream' | KVNamespaceGetOptions<'stream'>): Promise<KVNamespaceGetWithMetadataResult<ReadableStream, Metadata>>;
+  put(key: string, value: string | ArrayBuffer | ArrayBufferView | ReadableStream, options?: KVNamespacePutOptions): Promise<void>;
+  delete(key: string): Promise<void>;
+  list<Metadata = unknown>(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult<Metadata>>;
+  /** Read a fresh L1 entry, evicting it if expired. Returns `null` on miss. */
+  private l1Read;
+  /** Write an L1 entry, refreshing its recency and evicting the oldest at cap. */
+  private l1Write;
+  /** Compute an absolute L1 expiry (epoch ms) from KV put options. */
+  private l1ExpiresAt;
+}
+//#endregion
+export { TieredCacheService as t };
+//# sourceMappingURL=tiered-cache.service-Dv3BhxxE.d.mts.map

package/dist/tiered-cache.service-Dv3BhxxE.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered-cache.service-Dv3BhxxE.d.mts","names":[],"sources":["../src/cache/services/tiered-cache.service.ts"],"mappings":";;;;;AA0DA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cACa,kBAAA;EAAA,iBAO2C,KAAA;EA4FnD;EAAA,iBAjGc,EAAA;EAsHL;EAAA,iBApHK,QAAA;cAGqC,KAAA,EAAO,YAAA;EAkH1D;;;;;;;;EAvGH,OAAA,CAAQ,IAAA,WAAe,kBAAA;EAWjB,GAAA,CAAI,GAAA,UAAa,aAAA,YAAyB,qBAAA,WAAgC,OAAA;EAC1E,GAAA,0BAA6B,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;EA+BrF,eAAA,qBACJ,GAAA,UACA,aAAA,YAAyB,qBAAA,WACxB,OAAA,CAAQ,gCAAA,SAAyC,QAAA;EAC9C,eAAA,8CACJ,GAAA,UACA,aAAA,WAAwB,qBAAA,WACvB,OAAA,CAAQ,gCAAA,CAAiC,aAAA,EAAe,QAAA;EACrD,eAAA,qBACJ,GAAA,UACA,aAAA,kBAA+B,qBAAA,kBAC9B,OAAA,CAAQ,gCAAA,CAAiC,WAAA,EAAa,QAAA;EACnD,eAAA,qBACJ,GAAA,UACA,aAAA,aAA0B,qBAAA,aACzB,OAAA,CAAQ,gCAAA,CAAiC,cAAA,EAAgB,QAAA;EAiBtD,GAAA,CACJ,GAAA,UACA,KAAA,WAAgB,WAAA,GAAc,eAAA,GAAkB,cAAA,EAChD,OAAA,GAAU,qBAAA,GACT,OAAA;EAaG,MAAA,CAAO,GAAA,WAAc,OAAA;EAOrB,IAAA,qBACJ,OAAA,GAAU,sBAAA,GACT,OAAA,CAAQ,qBAAA,CAAsB,QAAA;EA3FuC;EAAA,QAkGhE,MAAA;EAlGgG;EAAA,QA6GhG,OAAA;EA5GF;EAAA,QAuHE,WAAA;AAAA"}

package/dist/trailing-slash-CFyw8nYu.mjs

@@ -0,0 +1,34 @@
+//#region src/router/trailing-slash.ts
+/**
+* Apply a trailing-slash mode to a URL or path.
+*
+* - `'ignore'` — return as-is.
+* - `'always'` — append `/` to the pathname unless it already has one.
+*   Skipped when the last segment contains `.` (file-like paths) and for the
+*   root `/` path.
+* - `'never'`  — strip a trailing `/` from the pathname. Skipped for root.
+*
+* Preserves query string and hash. Handles both relative paths
+* (`/foo?x=1`) and absolute URLs (`https://host/foo?x=1`).
+*
+* Used by URL-generation helpers and the redirect middleware so canonical
+* form is computed in one place.
+*/
+function applyTrailingSlash(url, mode) {
+	if (mode === "ignore") return url;
+	const isAbsolute = /^https?:\/\//i.test(url);
+	const parsed = isAbsolute ? new URL(url) : new URL(url, "http://placeholder.local");
+	const path = parsed.pathname;
+	if (path === "/") return url;
+	const hasTrailing = path.endsWith("/");
+	if (mode === "always" && !hasTrailing) {
+		if (path.slice(path.lastIndexOf("/") + 1).includes(".")) return url;
+		parsed.pathname = `${path}/`;
+	} else if (mode === "never" && hasTrailing) parsed.pathname = path.slice(0, -1);
+	else return url;
+	return isAbsolute ? parsed.toString() : `${parsed.pathname}${parsed.search}${parsed.hash}`;
+}
+//#endregion
+export { applyTrailingSlash as t };
+
+//# sourceMappingURL=trailing-slash-CFyw8nYu.mjs.map

package/dist/trailing-slash-CFyw8nYu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailing-slash-CFyw8nYu.mjs","names":[],"sources":["../src/router/trailing-slash.ts"],"sourcesContent":["import type { TrailingSlashMode } from './types'\n\n/**\n * Apply a trailing-slash mode to a URL or path.\n *\n * - `'ignore'` — return as-is.\n * - `'always'` — append `/` to the pathname unless it already has one.\n *   Skipped when the last segment contains `.` (file-like paths) and for the\n *   root `/` path.\n * - `'never'`  — strip a trailing `/` from the pathname. Skipped for root.\n *\n * Preserves query string and hash. Handles both relative paths\n * (`/foo?x=1`) and absolute URLs (`https://host/foo?x=1`).\n *\n * Used by URL-generation helpers and the redirect middleware so canonical\n * form is computed in one place.\n */\nexport function applyTrailingSlash(url: string, mode: TrailingSlashMode): string {\n  if (mode === 'ignore') return url\n\n  const isAbsolute = /^https?:\\/\\//i.test(url)\n  const parsed = isAbsolute\n    ? new URL(url)\n    : new URL(url, 'http://placeholder.local')\n\n  const path = parsed.pathname\n  if (path === '/') return url\n\n  const hasTrailing = path.endsWith('/')\n\n  if (mode === 'always' && !hasTrailing) {\n    const lastSegment = path.slice(path.lastIndexOf('/') + 1)\n    if (lastSegment.includes('.')) return url\n    parsed.pathname = `${path}/`\n  } else if (mode === 'never' && hasTrailing) {\n    parsed.pathname = path.slice(0, -1)\n  } else {\n    return url\n  }\n\n  return isAbsolute\n    ? parsed.toString()\n    : `${parsed.pathname}${parsed.search}${parsed.hash}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,KAAa,MAAiC;CAC/E,IAAI,SAAS,UAAU,OAAO;CAE9B,MAAM,aAAa,gBAAgB,KAAK,GAAG;CAC3C,MAAM,SAAS,aACX,IAAI,IAAI,GAAG,IACX,IAAI,IAAI,KAAK,0BAA0B;CAE3C,MAAM,OAAO,OAAO;CACpB,IAAI,SAAS,KAAK,OAAO;CAEzB,MAAM,cAAc,KAAK,SAAS,GAAG;CAErC,IAAI,SAAS,YAAY,CAAC,aAAa;EAErC,IADoB,KAAK,MAAM,KAAK,YAAY,GAAG,IAAI,CACzC,EAAE,SAAS,GAAG,GAAG,OAAO;EACtC,OAAO,WAAW,GAAG,KAAK;CAC5B,OAAO,IAAI,SAAS,WAAW,aAC7B,OAAO,WAAW,KAAK,MAAM,GAAG,EAAE;MAElC,OAAO;CAGT,OAAO,aACH,OAAO,SAAS,IAChB,GAAG,OAAO,WAAW,OAAO,SAAS,OAAO;AAClD"}

package/dist/{types-BaeHi67f.d.mts → types-CmV_9xBD.d.mts}

@@ -16,4 +16,4 @@
 type Constructor<T = object> = new (...args: any[]) => T;
 //#endregion
 export { Constructor as t };
-//# sourceMappingURL=types-BaeHi67f.d.mts.map
+//# sourceMappingURL=types-CmV_9xBD.d.mts.map

package/dist/types-CmV_9xBD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CmV_9xBD.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;AAeA;;;;;;;;AAA+D;;;;;KAAnD,WAAA,uBAAkC,IAAA,YAAgB,CAAC"}