stratal 0.0.16 → 0.0.18

package/dist/stratal-B7G4i9-N.mjs

@@ -0,0 +1,502 @@
+import { A as Scope, D as runWithContainer, H as ApplicationError, V as ROUTER_TOKENS, g as DefaultExceptionHandler, i as createCronExceptionContext, j as Container, o as createQueueExceptionContext, r as createCliExceptionContext, t as StratalNotInitializedError } from "./errors--RBIvDXr.mjs";
+import { a as __decorate, f as DI_TOKENS, i as LoggerService, l as LogLevel, n as PrettyFormatter, o as __decorateParam, r as JsonFormatter, s as __decorateMetadata, t as ConsoleTransport, u as LOGGER_TOKENS } from "./logger-c0ftIK4G.mjs";
+import { a as getGroups, i as getGlobalMiddleware, r as getDefaultEntry, t as ModuleRegistry } from "./module-C3YZ-kZN.mjs";
+import { r as getListenerHandlers, t as EventRegistry } from "./events-UTJliZhl.mjs";
+import { t as Command } from "./command-DjGqCYHv.mjs";
+import { CacheModule } from "./cache/index.mjs";
+import { t as CronManager } from "./cron-manager-1KnZvojs.mjs";
+import { R as OpenAPIModule, c as RouteRegistry, d as HonoApp, f as RouteRegistrationService, i as Uri, l as VersioningService, t as I18nModule, u as LocalePathService } from "./i18n.module-BpLLLCTg.mjs";
+import { a as QueueListCommand, c as HelpCommand, d as ApiCommand, i as RouteListCommand, o as McpToolsCommand, r as ScheduleListCommand, s as McpServeCommand, t as QuarryRegistry, u as EventListCommand } from "./quarry-registry-CQCIlYTO.mjs";
+import { t as QueueModule } from "./queue.module-DIjD6nr-.mjs";
+import { i as SeederRegistry, n as DbSeedListCommand, r as SEEDER_TOKENS, t as DbSeedCommand } from "./seeder-D7VXULXB.mjs";
+import { container, inject, injectable } from "tsyringe";
+import "reflect-metadata";
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+//#region src/quarry/commands/route-types.command.ts
+let RouteTypesCommand = class RouteTypesCommand extends Command {
+	static command = "route:types {--output=src/stratal.d.ts : Output file path}";
+	static description = "Generate TypeScript types for named routes";
+	constructor(registry, localePathService) {
+		super();
+		this.registry = registry;
+		this.localePathService = localePathService;
+	}
+	handle() {
+		const outputPath = resolve(this.string("output") || "src/stratal.d.ts");
+		const namedRoutes = this.registry.named();
+		if (namedRoutes.length === 0) {
+			this.warn("No named routes found. Add name to your @Route() or @Get()/@Post() decorators.");
+			return 0;
+		}
+		writeFileSync(outputPath, this.generateDeclaration(namedRoutes), "utf-8");
+		this.info(`Generated route types for ${namedRoutes.length} named routes → ${outputPath}`);
+	}
+	/**
+	* Generate the StratalRouteMap declaration content.
+	*/
+	generateDeclaration(routes) {
+		const localeConfig = this.localePathService.enabled ? this.localePathService.localePathConfig : null;
+		const localeType = localeConfig ? localeConfig.allLocales.map((l) => `'${l}'`).join(" | ") : null;
+		const localeOptional = localeConfig ? this.localePathService.prefixDefaultLocale !== true : false;
+		const entries = routes.filter((r) => r.name !== void 0).sort((a, b) => a.name.localeCompare(b.name)).map((route) => {
+			const paramEntries = [...route.paramNames.map((p) => `${p}: string`), ...route.domainParamNames.map((p) => `${p}: string`)];
+			if (localeType && route.localePaths?.length) {
+				const optionalMarker = localeOptional ? "?" : "";
+				paramEntries.push(`locale${optionalMarker}: StratalLocale`);
+			}
+			const paramsType = paramEntries.length === 0 ? "never" : `{ ${paramEntries.join("; ")} }`;
+			return `    '${route.name}': { params: ${paramsType} }`;
+		}).join("\n");
+		const lines = ["// Auto-generated by `quarry route:types` — do not edit manually", "declare module 'stratal/router' {"];
+		if (localeType) {
+			lines.push(`  type StratalLocale = ${localeType}`);
+			lines.push("");
+		}
+		lines.push("  interface StratalRouteMap {", entries, "  }", "}");
+		return [
+			...lines,
+			"",
+			"export {}",
+			""
+		].join("\n");
+	}
+};
+RouteTypesCommand = __decorate([
+	__decorateParam(0, inject(ROUTER_TOKENS.RouteRegistry)),
+	__decorateParam(1, inject(ROUTER_TOKENS.LocalePathService)),
+	__decorateMetadata("design:paramtypes", [Object, Object])
+], RouteTypesCommand);
+//#endregion
+//#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
+//#region src/application.ts
+/**
+* Application
+*
+* Main application class managing the two-tier container hierarchy:
+* - Global Container: All services (singletons via tsyringe native)
+* - Request Container: Child of global, context-enriched instances per request
+*
+* @example
+* ```typescript
+* const app = new Application({ module: AppModule, env, ctx })
+* await app.initialize()
+*
+* // Access container via getter
+* const service = app.container.resolve(MY_TOKEN)
+*
+* // Handle HTTP request (via HonoApp)
+* // Handle queue batch
+* await app.handleQueue(batch, 'my-queue')
+* ```
+*/
+var Application = class {
+	/**
+	* Unified Container - manages all DI operations
+	*/
+	_container;
+	honoApp;
+	moduleRegistry;
+	consumerRegistry;
+	cronManager;
+	quarry;
+	initialized = false;
+	env;
+	appConfig;
+	constructor({ env, ctx, ...config }) {
+		this.env = env;
+		this.appConfig = config;
+		ApplicationError.captureStackTraces = env.ENVIRONMENT !== "production";
+		this._container = new Container({ container: container.createChildContainer() });
+		this._container.registerValue(DI_TOKENS.Application, this);
+		this._container.registerValue(DI_TOKENS.CloudflareEnv, env);
+		this._container.registerValue(DI_TOKENS.ExecutionContext, ctx);
+		this.registerLoggerService();
+		this.registerCoreServices();
+		const logger = this._container.resolve(LOGGER_TOKENS.LoggerService);
+		this.moduleRegistry = new ModuleRegistry(this._container, logger);
+		this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry);
+	}
+	/**
+	* Get the Container instance
+	*/
+	get container() {
+		return this._container;
+	}
+	/**
+	* Get the HonoApp instance
+	*/
+	get hono() {
+		return this.honoApp;
+	}
+	/**
+	* Get the application configuration
+	*/
+	get config() {
+		return this.appConfig;
+	}
+	async initialize() {
+		if (this.initialized) return;
+		await runWithContainer(this._container, () => this.initializeInternal());
+	}
+	async initializeInternal() {
+		this.moduleRegistry.registerAll([
+			I18nModule,
+			OpenAPIModule,
+			QueueModule,
+			CacheModule
+		]);
+		this.moduleRegistry.register(this.appConfig.module);
+		await this.moduleRegistry.initialize();
+		this.initializeExceptionHandler();
+		this.consumerRegistry = this._container.resolve(DI_TOKENS.ConsumerRegistry);
+		this.cronManager = this._container.resolve(DI_TOKENS.Cron);
+		this.quarry = this._container.resolve(DI_TOKENS.Quarry);
+		this.registerRoutingServices();
+		this.honoApp = this._container.resolve(ROUTER_TOKENS.HonoApp);
+		await this.honoApp.configure();
+		this.registerQueueConsumers();
+		this.registerCronJobs();
+		this.registerEventListeners();
+		this.registerSeeders();
+		this.registerCommands();
+		this.initialized = true;
+	}
+	/**
+	* Register routing services as singletons in the container.
+	* Called after module initialization so I18N_TOKENS.Options is available.
+	*/
+	registerRoutingServices() {
+		this._container.register(ROUTER_TOKENS.VersioningService, VersioningService, Scope.Singleton);
+		this._container.register(ROUTER_TOKENS.HonoApp, HonoApp, Scope.Singleton);
+		this._container.register(ROUTER_TOKENS.LocalePathService, LocalePathService, Scope.Singleton);
+		this._container.register(ROUTER_TOKENS.RouteRegistry, RouteRegistry, Scope.Singleton);
+		this._container.register(ROUTER_TOKENS.Uri, Uri, Scope.Request);
+		const routerConfigs = this.moduleRegistry.getAllRouterConfigs();
+		const routerResolver = routerConfigs.length > 0 ? new RouterResolver(routerConfigs) : null;
+		this._container.registerValue(ROUTER_TOKENS.RouterResolver, routerResolver);
+		this._container.register(RouteRegistrationService, RouteRegistrationService);
+	}
+	/**
+	* Resolve a service from the container
+	*/
+	resolve(token) {
+		try {
+			return this._container.resolve(token);
+		} catch (error) {
+			const handler = this._container.resolve(DI_TOKENS.ExceptionHandler);
+			const ctx = createCliExceptionContext("resolve");
+			handler.handle(error, ctx);
+			throw error;
+		}
+	}
+	/**
+	* Handle queue batch processing
+	*/
+	async handleQueue(batch, queueName) {
+		const locale = (batch.messages[0]?.body)?.metadata?.locale ?? "en";
+		const mockRouterContext = this.createMockRouterContext(locale);
+		await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {
+			try {
+				await requestContainer.resolve(DI_TOKENS.Queue).processBatch(queueName, batch);
+			} catch (error) {
+				await requestContainer.resolve(DI_TOKENS.ExceptionHandler).handle(error, createQueueExceptionContext(queueName));
+				throw error;
+			}
+		});
+	}
+	/**
+	* Handle scheduled cron trigger
+	*/
+	async handleScheduled(controller) {
+		const mockRouterContext = this.createMockRouterContext("en");
+		await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {
+			try {
+				await this.cronManager.executeScheduled(controller);
+			} catch (error) {
+				await requestContainer.resolve(DI_TOKENS.ExceptionHandler).handle(error, createCronExceptionContext());
+				throw error;
+			}
+		});
+	}
+	/**
+	* Create mock RouterContext for queue/cron/seeder processing
+	*/
+	createMockRouterContext(locale = "en") {
+		return {
+			getLocale: () => locale,
+			setLocale: () => {},
+			getContainer: () => this._container
+		};
+	}
+	async shutdown() {
+		if (!this.initialized) return;
+		this.initialized = false;
+		await this.moduleRegistry.shutdown();
+		this._container.resolve(LOGGER_TOKENS.LoggerService).info("Disposing container...");
+		await this._container.dispose();
+	}
+	/**
+	* Execute a command by name in a request-scoped container.
+	*/
+	async handleCommand(name, input) {
+		const mockContext = this.createMockRouterContext("en");
+		return this._container.runInRequestScope(mockContext, async () => {
+			return this.quarry.call(name, input);
+		});
+	}
+	registerCommands() {
+		const builtinCommands = [
+			HelpCommand,
+			DbSeedCommand,
+			DbSeedListCommand,
+			RouteListCommand,
+			RouteTypesCommand,
+			EventListCommand,
+			ScheduleListCommand,
+			QueueListCommand,
+			McpServeCommand,
+			McpToolsCommand,
+			ApiCommand
+		];
+		for (const Cmd of builtinCommands) {
+			injectable()(Cmd);
+			this._container.register(Cmd, Cmd, Scope.Singleton);
+			this.quarry.register(Cmd);
+		}
+		const commands = this.moduleRegistry.getAllCommands();
+		if (commands.length === 0) return;
+		for (const CommandClass of commands) this.quarry.register(CommandClass);
+	}
+	registerSeeders() {
+		const seeders = this.moduleRegistry.getAllSeeders();
+		if (seeders.length === 0) return;
+		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);
+		}
+	}
+	registerCronJobs() {
+		for (const JobClass of this.moduleRegistry.getAllJobs()) {
+			const job = this._container.resolve(JobClass);
+			this.cronManager.registerJob(job);
+		}
+	}
+	/**
+	* Auto-wire `@Listener()` classes with the EventRegistry.
+	*/
+	registerEventListeners() {
+		const listeners = this.moduleRegistry.getAllListeners();
+		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);
+		}
+	}
+	/**
+	* Register LoggerService and dependencies
+	*/
+	registerLoggerService() {
+		const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO;
+		const formatter = this.appConfig.logging?.formatter ?? "json";
+		this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel);
+		this._container.when(() => formatter === "pretty").use(LOGGER_TOKENS.Formatter).give(PrettyFormatter).otherwise(JsonFormatter);
+		this._container.registerSingleton(LOGGER_TOKENS.ConsoleTransport, ConsoleTransport);
+		this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)]);
+		this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService);
+	}
+	/**
+	* Register core services with explicit scope
+	*/
+	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));
+	}
+	/**
+	* Initialize the ExceptionHandler: call register(), then module onException hooks.
+	*/
+	initializeExceptionHandler() {
+		const handler = this._container.resolve(DI_TOKENS.ExceptionHandler);
+		handler.register();
+		this.moduleRegistry.configureExceptionHandlers(handler);
+	}
+};
+//#endregion
+//#region src/stratal.ts
+/**
+* Stratal — Hono-style entry point for Cloudflare Workers.
+*
+* Eagerly bootstraps the Application at construction time, dynamically
+* importing `cloudflare:workers` for env and waitUntil.
+*
+* @example
+* ```typescript
+* import { Stratal } from 'stratal'
+* import { AppModule } from './app.module'
+*
+* export default new Stratal({ module: AppModule })
+* ```
+*/
+var Stratal = class Stratal {
+	app = null;
+	initPromise;
+	static _application = null;
+	static _generation = 0;
+	static _previousInstance = null;
+	constructor(config) {
+		this.fetch = this.fetch.bind(this);
+		this.queue = this.queue.bind(this);
+		this.scheduled = this.scheduled.bind(this);
+		const generation = ++Stratal._generation;
+		if (Stratal._previousInstance) Stratal._previousInstance.shutdown();
+		Stratal._previousInstance = this;
+		this.initPromise = this.prepareApp(config, generation);
+		Stratal._application = this.initPromise;
+	}
+	async fetch(request, env, ctx) {
+		return (await this.ensureReady()).hono.fetch(request, env, ctx);
+	}
+	async queue(batch) {
+		return (await this.ensureReady()).handleQueue(batch, batch.queue);
+	}
+	async scheduled(controller) {
+		return (await this.ensureReady()).handleScheduled(controller);
+	}
+	get hono() {
+		return this.initPromise.then((app) => app.hono);
+	}
+	async shutdown() {
+		try {
+			this.app = await this.initPromise;
+		} catch {}
+		if (this.app) {
+			await this.app.shutdown();
+			this.app = null;
+		}
+	}
+	/**
+	* @internal
+	* Resolves the Application instance from the static singleton.
+	* Used by worker base classes (DurableObject, Workflow, WorkerEntrypoint)
+	* to access the DI container without going through Cloudflare RPC.
+	*/
+	static resolveApplication() {
+		if (!Stratal._application) throw new StratalNotInitializedError();
+		return Stratal._application;
+	}
+	async ensureReady() {
+		this.app ??= await this.initPromise;
+		return this.app;
+	}
+	async prepareApp(config, generation) {
+		const { env, waitUntil } = await import("cloudflare:workers");
+		if (generation !== Stratal._generation) return new Promise(() => {});
+		const app = new Application({
+			...config,
+			env,
+			ctx: { waitUntil }
+		});
+		await app.initialize();
+		if (generation !== Stratal._generation) {
+			await app.shutdown();
+			return new Promise(() => {});
+		}
+		return app;
+	}
+};
+//#endregion
+export { Application as n, Stratal as t };
+
+//# sourceMappingURL=stratal-B7G4i9-N.mjs.map

package/dist/stratal-B7G4i9-N.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stratal-B7G4i9-N.mjs","names":["internal.getGroups","internal.getDefaultEntry","internal.getGlobalMiddleware","tsyringeRootContainer"],"sources":["../src/quarry/commands/route-types.command.ts","../src/router/router-resolver.ts","../src/application.ts","../src/stratal.ts"],"sourcesContent":["import { writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { inject } from 'tsyringe'\nimport type { RouteRegistry, RegisteredRoute } from '../../router/route-registry'\nimport { ROUTER_TOKENS } from '../../router/router.tokens'\nimport type { LocalePathService } from '../../router/services/locale-path.service'\nimport { Command } from '../command'\n\n/**\n * Generate TypeScript types for named routes.\n *\n * Outputs a `stratal.d.ts` file with `StratalRouteMap` augmentation\n * that provides autocomplete and type-safe params for `route()` and `ctx.route()`.\n *\n * @example\n * ```bash\n * quarry route:types                           # → src/stratal.d.ts\n * quarry route:types --output=types/routes.d.ts\n * ```\n */\nexport class RouteTypesCommand extends Command {\n  static command = 'route:types {--output=src/stratal.d.ts : Output file path}'\n  static description = 'Generate TypeScript types for named routes'\n\n  constructor(\n    @inject(ROUTER_TOKENS.RouteRegistry) private registry: RouteRegistry,\n    @inject(ROUTER_TOKENS.LocalePathService) private localePathService: LocalePathService,\n  ) {\n    super()\n  }\n\n  handle(): number | undefined {\n    const outputPath = resolve(this.string('output') || 'src/stratal.d.ts')\n    const namedRoutes = this.registry.named()\n\n    if (namedRoutes.length === 0) {\n      this.warn('No named routes found. Add name to your @Route() or @Get()/@Post() decorators.')\n      return 0\n    }\n\n    const content = this.generateDeclaration(namedRoutes)\n    writeFileSync(outputPath, content, 'utf-8')\n    this.info(`Generated route types for ${namedRoutes.length} named routes → ${outputPath}`)\n\n    return undefined\n  }\n\n  /**\n   * Generate the StratalRouteMap declaration content.\n   */\n  private generateDeclaration(routes: RegisteredRoute[]): string {\n    const localeConfig = this.localePathService.enabled ? this.localePathService.localePathConfig : null\n    const localeType = localeConfig\n      ? localeConfig.allLocales.map(l => `'${l}'`).join(' | ')\n      : null\n    const localeOptional = localeConfig ? this.localePathService.prefixDefaultLocale !== true : false\n\n    const entries = routes\n      .filter((r): r is RegisteredRoute & { name: string } => r.name !== undefined)\n      .sort((a, b) => a.name.localeCompare(b.name))\n      .map(route => {\n        const paramEntries = [\n          ...route.paramNames.map(p => `${p}: string`),\n          ...route.domainParamNames.map(p => `${p}: string`),\n        ]\n\n        if (localeType && route.localePaths?.length) {\n          const optionalMarker = localeOptional ? '?' : ''\n          paramEntries.push(`locale${optionalMarker}: StratalLocale`)\n        }\n\n        const paramsType = paramEntries.length === 0\n          ? 'never'\n          : `{ ${paramEntries.join('; ')} }`\n        return `    '${route.name}': { params: ${paramsType} }`\n      })\n      .join('\\n')\n\n    const lines = [\n      '// Auto-generated by `quarry route:types` — do not edit manually',\n      \"declare module 'stratal/router' {\",\n    ]\n\n    if (localeType) {\n      lines.push(`  type StratalLocale = ${localeType}`)\n      lines.push('')\n    }\n\n    lines.push(\n      '  interface StratalRouteMap {',\n      entries,\n      '  }',\n      '}',\n    )\n\n    return [\n      ...lines,\n      '',\n      'export {}',\n      '',\n    ].join('\\n')\n  }\n}\n","import type { ZodObject } from '../i18n/validation'\nimport type { Constructor } from '../types'\nimport type { Middleware } from './middleware.interface'\nimport type { Router, RouterEntry } from './router'\nimport * as internal from './router.internals'\n\n/**\n * Resolved configuration for a single controller.\n * Merges Router default entry, sub-group overrides, and inheritance rules.\n */\nexport interface ResolvedRouterConfig {\n  prefix?: string\n  domain?: string\n  name?: string\n  middleware: Constructor<Middleware>[]\n  version?: string | string[]\n  hideFromDocs?: boolean\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  params?: ZodObject<any>\n}\n\n/**\n * Internal resolver that computes the effective Router config for each controller.\n *\n * Inheritance rules:\n * - `middleware`: parent middleware runs first, then child (concatenated)\n * - `prefix`: concatenated (parent + child)\n * - `name`: concatenated (parent + child)\n * - `domain`: child overrides parent\n * - `version`: child overrides parent\n * - `hideFromDocs`: child overrides parent\n *\n * @internal — not exported from stratal/router\n */\nexport class RouterResolver {\n  private readonly routers: { router: Router; controllers: Constructor[] }[]\n\n  constructor(routers: { router: Router; controllers: Constructor[] }[]) {\n    this.routers = routers\n  }\n\n  /**\n   * Resolve the effective config for a given controller class.\n   * Searches through all module routers to find the one owning this controller.\n   */\n  resolveForController(controller: Constructor): ResolvedRouterConfig {\n    for (const { router, controllers: moduleControllers } of this.routers) {\n      if (!moduleControllers.includes(controller)) continue\n\n      // Check if controller is in a sub-group\n      for (const group of router[internal.getGroups]()) {\n        if (group.controllers?.includes(controller)) {\n          return this.mergeEntries(router[internal.getDefaultEntry](), group)\n        }\n      }\n\n      // Controller is in the default scope (not in any sub-group)\n      // But only if it's not claimed by any sub-group in this module\n      const groupedControllers = new Set(\n        router[internal.getGroups]().flatMap(g => g.controllers ?? [])\n      )\n      if (!groupedControllers.has(controller)) {\n        return this.entryToConfig(router[internal.getDefaultEntry]())\n      }\n    }\n\n    // Controller not found in any module's router — return empty config\n    return { middleware: [] }\n  }\n\n  /**\n   * Collect all global middleware registered via `router.use()` across all modules.\n   */\n  getGlobalMiddleware(): Constructor<Middleware>[] {\n    const global: Constructor<Middleware>[] = []\n    for (const { router } of this.routers) {\n      global.push(...router[internal.getGlobalMiddleware]())\n    }\n    return global\n  }\n\n  /**\n   * Merge parent default entry with child group entry following inheritance rules.\n   */\n  private mergeEntries(parent: RouterEntry, child: RouterEntry): ResolvedRouterConfig {\n    return {\n      // Concatenate: parent prefix + child prefix\n      prefix: this.concatPrefixes(parent.prefix, child.prefix),\n      // Override: child domain wins\n      domain: child.domain ?? parent.domain,\n      // Concatenate: parent name + child name\n      name: this.concatNames(parent.name, child.name),\n      // Concatenate: parent middleware first, then child\n      middleware: [...parent.middleware, ...child.middleware],\n      // Override: child version wins\n      version: child.version ?? parent.version,\n      // Override: child hideFromDocs wins\n      hideFromDocs: child.hideFromDocs ?? parent.hideFromDocs,\n      // Extend: parent params extended with child params\n      params: this.mergeParams(parent.params, child.params),\n    }\n  }\n\n  private entryToConfig(entry: RouterEntry): ResolvedRouterConfig {\n    return {\n      prefix: entry.prefix,\n      domain: entry.domain,\n      name: entry.name,\n      middleware: [...entry.middleware],\n      version: entry.version,\n      hideFromDocs: entry.hideFromDocs,\n      params: entry.params,\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  private mergeParams(parent?: ZodObject<any>, child?: ZodObject<any>): ZodObject<any> | undefined {\n    if (!parent && !child) return undefined\n    if (!parent) return child\n    if (!child) return parent\n    // oxlint-disable-next-line typescript/no-explicit-any\n    return parent.extend(child.shape) as ZodObject<any>\n  }\n\n  private concatPrefixes(parent?: string, child?: string): string | undefined {\n    if (!parent && !child) return undefined\n    if (!parent) return child\n    if (!child) return parent\n    // Normalize: remove trailing slash from parent, ensure child starts with /\n    const p = parent.endsWith('/') ? parent.slice(0, -1) : parent\n    const c = child.startsWith('/') ? child : `/${child}`\n    return `${p}${c}`\n  }\n\n  private concatNames(parent?: string, child?: string): string | undefined {\n    if (!parent && !child) return undefined\n    if (!parent) return child\n    if (!child) return parent\n    return `${parent}${child}`\n  }\n}\n","import { injectable, container as tsyringeRootContainer } from 'tsyringe'\nimport { CacheModule } from './cache'\nimport type { CronJob } from './cron/cron-job'\nimport { CronManager } from './cron/cron-manager'\nimport { Container } from './di/container'\nimport { runWithContainer } from './di/container-storage'\nimport { DI_TOKENS } from './di/tokens'\nimport { Scope } from './di/types'\nimport { type StratalEnv } from './env'\nimport { ApplicationError } from './errors'\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 } from './events'\nimport { EventRegistry, getListenerHandlers } from './events'\nimport type { StratalExecutionContext } from './execution-context'\nimport { I18nModule } from './i18n/i18n.module'\nimport { ConsoleTransport, JsonFormatter, LOGGER_TOKENS, LoggerService, LogLevel, PrettyFormatter } from './logger'\nimport { ModuleRegistry } from './module/module-registry'\nimport type { DynamicModule, ModuleClass } from './module/types'\nimport { OpenAPIModule } from './openapi'\nimport type { Command } from './quarry/command'\nimport { ApiCommand } from './quarry/commands/api.command'\nimport { EventListCommand } from './quarry/commands/event-list.command'\nimport { HelpCommand } from './quarry/commands/help.command'\nimport { McpServeCommand } from './quarry/commands/mcp-serve.command'\nimport { McpToolsCommand } from './quarry/commands/mcp-tools.command'\nimport { QueueListCommand } from './quarry/commands/queue-list.command'\nimport { RouteListCommand } from './quarry/commands/route-list.command'\nimport { RouteTypesCommand } from './quarry/commands/route-types.command'\nimport { ScheduleListCommand } from './quarry/commands/schedule-list.command'\nimport { 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 { QueueModule } from './queue/queue.module'\nimport { type RouterContext } from './router'\nimport { HonoApp } from './router/hono-app'\nimport { RouteRegistry } from './router/route-registry'\nimport { RouterResolver } from './router/router-resolver'\nimport { ROUTER_TOKENS } from './router/router.tokens'\nimport { Uri } from './router/uri'\nimport { LocalePathService } from './router/services/locale-path.service'\nimport { RouteRegistrationService } from './router/services/route-registration.service'\nimport { VersioningService } from './router/services/versioning.service'\nimport type { VersioningOptions } from './router/types'\nimport { DbSeedCommand, DbSeedListCommand, SEEDER_TOKENS, SeederRegistry, type Seeder } from './seeder'\nimport type { Constructor } from './types'\n\nexport interface ApplicationConfig {\n  /** Root application module */\n  module: ModuleClass | DynamicModule\n  /** Logging configuration. Defaults: level=INFO, formatter='json' */\n  logging?: {\n    level?: LogLevel\n    formatter?: 'json' | 'pretty'\n  }\n  /**\n   * API versioning configuration.\n   * When provided, enables URI-based versioning for controllers.\n   */\n  versioning?: VersioningOptions\n  /**\n   * Custom exception handler class.\n   *\n   * Extend {@link ExceptionHandler} and override `register()` to configure\n   * custom reporting, rendering, and post-processing of exceptions.\n   *\n   * When not provided, {@link DefaultExceptionHandler} is used (standard\n   * severity-based logging and JSON error responses).\n   *\n   * @example\n   * ```typescript\n   * new Stratal({\n   *   module: AppModule,\n   *   exceptionHandler: AppExceptionHandler,\n   * })\n   * ```\n   */\n  exceptionHandler?: Constructor<ExceptionHandler>\n}\n\nexport interface ApplicationOptions extends ApplicationConfig {\n  env: StratalEnv\n  ctx: StratalExecutionContext\n}\n\n/**\n * Application\n *\n * Main application class managing the two-tier container hierarchy:\n * - Global Container: All services (singletons via tsyringe native)\n * - Request Container: Child of global, context-enriched instances per request\n *\n * @example\n * ```typescript\n * const app = new Application({ module: AppModule, env, ctx })\n * await app.initialize()\n *\n * // Access container via getter\n * const service = app.container.resolve(MY_TOKEN)\n *\n * // Handle HTTP request (via HonoApp)\n * // Handle queue batch\n * await app.handleQueue(batch, 'my-queue')\n * ```\n */\nexport class Application {\n  /**\n   * Unified Container - manages all DI operations\n   */\n  private _container: Container\n\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  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    ApplicationError.captureStackTraces = env.ENVIRONMENT !== 'production'\n\n    // Create unified Container with explicit child container\n    this._container = new Container({\n      container: tsyringeRootContainer.createChildContainer()\n    })\n\n    // Register globally — env and ctx always available\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\n    // Register core infrastructure inline\n    this.registerLoggerService()\n    this.registerCoreServices()\n\n    // Create ModuleRegistry with our Container\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.moduleRegistry = new ModuleRegistry(this._container, logger)\n\n    // Register ModuleRegistry in container so modules can access it in onInitialize\n    this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry)\n  }\n\n  /**\n   * Get the Container instance\n   */\n  get container(): Container {\n    return this._container\n  }\n\n  /**\n   * Get the HonoApp instance\n   */\n  get hono(): HonoApp {\n    return this.honoApp\n  }\n\n  /**\n   * Get the application configuration\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    // Wrap in AsyncLocalStorage so getContainer() works for route() and other standalone functions\n    await runWithContainer(this._container, () => this.initializeInternal())\n  }\n\n  private async initializeInternal(): Promise<void> {\n    // Phase 1: Register core infrastructure modules (internal)\n    this.moduleRegistry.registerAll([\n      I18nModule,\n      OpenAPIModule,\n      QueueModule,\n      CacheModule,\n    ])\n\n    // Phase 2: Register user's root module (traverses imports)\n    this.moduleRegistry.register(this.appConfig.module)\n\n    // Phase 3: Initialize all modules\n    await this.moduleRegistry.initialize()\n\n    // Phase 3.5: Initialize ExceptionHandler and call module onException hooks\n    this.initializeExceptionHandler()\n\n    // Phase 4: Resolve managers from container\n    this.consumerRegistry = this._container.resolve<ConsumerRegistry>(DI_TOKENS.ConsumerRegistry)\n    this.cronManager = this._container.resolve<CronManager>(DI_TOKENS.Cron)\n    this.quarry = this._container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Phase 4.5: Register routing services in container\n    // (After Phase 3 so I18N_TOKENS.Options is available for LocalePathService)\n    this.registerRoutingServices()\n\n    // Phase 5: Resolve & configure HonoApp\n    // LocalePathService is transitively resolved via RouteRegistrationService → RouteRegistry\n    // during configure(), which triggers locale middleware setup on HonoApp before route registration.\n    this.honoApp = this._container.resolve<HonoApp>(ROUTER_TOKENS.HonoApp)\n    await this.honoApp.configure()\n\n    // Phase 6: Configure queues, cron, events, commands, seeders\n    this.registerQueueConsumers()\n    this.registerCronJobs()\n    this.registerEventListeners()\n    this.registerSeeders()\n    this.registerCommands()\n\n    this.initialized = true\n  }\n\n  /**\n   * Register routing services as singletons in the container.\n   * Called after module initialization so I18N_TOKENS.Options is available.\n   */\n  private registerRoutingServices(): void {\n    // VersioningService — resolves version prefixes from appConfig.versioning\n    this._container.register(ROUTER_TOKENS.VersioningService, VersioningService, Scope.Singleton)\n\n    // HonoApp — the Hono application instance (must be before LocalePathService)\n    this._container.register(ROUTER_TOKENS.HonoApp, HonoApp, Scope.Singleton)\n\n    // LocalePathService — computes LocalePathConfig and applies locale middleware to HonoApp\n    this._container.register(ROUTER_TOKENS.LocalePathService, LocalePathService, Scope.Singleton)\n\n    // RouteRegistry — single source of truth, expands routes via services above\n    this._container.register(ROUTER_TOKENS.RouteRegistry, RouteRegistry, Scope.Singleton)\n\n    // Uri — URL generation service (request-scoped for access to RouterContext)\n    this._container.register(ROUTER_TOKENS.Uri, Uri, Scope.Request)\n\n    // RouterResolver — merges Router configs from modules\n    const routerConfigs = this.moduleRegistry.getAllRouterConfigs()\n    const routerResolver = routerConfigs.length > 0 ? new RouterResolver(routerConfigs) : null\n    this._container.registerValue(ROUTER_TOKENS.RouterResolver, routerResolver)\n\n    // RouteRegistrationService — transient, resolved in HonoApp.configure()\n    this._container.register(RouteRegistrationService, RouteRegistrationService)\n  }\n\n  /**\n   * Resolve a service from the container\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      // Fire-and-forget — reporting happens via waitUntil internally\n      void handler.handle(error, ctx)\n      throw error\n    }\n  }\n\n  /**\n   * Handle queue batch processing\n   */\n  async handleQueue(batch: MessageBatch, queueName: string): Promise<void> {\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  /**\n   * Handle scheduled cron trigger\n   */\n  async handleScheduled(controller: ScheduledController): Promise<void> {\n    const mockRouterContext = this.createMockRouterContext('en')\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        await this.cronManager.executeScheduled(controller)\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  /**\n   * Create mock RouterContext for queue/cron/seeder processing\n   */\n  createMockRouterContext(locale = 'en'): RouterContext {\n    return {\n      getLocale: () => locale,\n      setLocale: () => { /* no-op */ },\n      getContainer: () => 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    await this._container.dispose()\n  }\n\n  /**\n   * Execute a command by name in a request-scoped container.\n   */\n  async handleCommand(name: string, input?: CommandInput): Promise<CommandResult> {\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 registerCommands(): void {\n    // Built-in commands (always available)\n    const builtinCommands: Constructor<Command>[] = [\n      HelpCommand,\n      DbSeedCommand, DbSeedListCommand,\n      RouteListCommand, RouteTypesCommand, EventListCommand,\n      ScheduleListCommand, QueueListCommand,\n      McpServeCommand, McpToolsCommand, ApiCommand,\n    ]\n    for (const Cmd of builtinCommands) {\n      injectable()(Cmd)\n      this._container.register(Cmd, Cmd, Scope.Singleton)\n      this.quarry.register(Cmd)\n    }\n\n    // User commands from modules\n    const commands = this.moduleRegistry.getAllCommands()\n    if (commands.length === 0) {\n      return\n    }\n\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 registerQueueConsumers(): void {\n    for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {\n      const consumer = this._container.resolve(ConsumerClass) as IQueueConsumer\n      this.consumerRegistry.register(consumer)\n    }\n  }\n\n  private registerCronJobs(): void {\n    for (const JobClass of this.moduleRegistry.getAllJobs()) {\n      const job = this._container.resolve(JobClass) as CronJob\n      this.cronManager.registerJob(job)\n    }\n  }\n\n  /**\n   * Auto-wire `@Listener()` classes with the EventRegistry.\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 instance = this._container.resolve(ListenerClass) as Record<string, ((...args: unknown[]) => unknown)>\n      const handlers = getListenerHandlers(ListenerClass)\n\n      for (const { methodName, event, options } of handlers) {\n        eventRegistry.on(event, instance[methodName].bind(instance) as EventHandler, options)\n      }\n    }\n  }\n\n  /**\n   * Register LoggerService and dependencies\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.ConsoleTransport, ConsoleTransport)\n    this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)])\n    this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService)\n  }\n\n  /**\n   * Register core services with explicit scope\n   */\n  private registerCoreServices(): void {\n    this._container.registerSingleton(DI_TOKENS.Cron, CronManager)\n    this._container.registerSingleton(\n      DI_TOKENS.ExceptionHandler,\n      (this.appConfig.exceptionHandler ?? DefaultExceptionHandler) as Constructor,\n    )\n    this._container.registerSingleton(DI_TOKENS.EventRegistry, EventRegistry)\n    this._container.registerSingleton(DI_TOKENS.Quarry, QuarryRegistry)\n    this._container.registerValue(SEEDER_TOKENS.SeederRegistry, new SeederRegistry(this))\n  }\n\n  /**\n   * Initialize the ExceptionHandler: call register(), then module onException hooks.\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 'reflect-metadata'\n\nimport { 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    return app.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.hono)\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/{types-DahElfUw.d.mts → types-CN0zONAZ.d.mts}

@@ -13,7 +13,7 @@
  * ]
  * ```
  */
-type Constructor<T extends object = object> = new (...args: any[]) => T;
+type Constructor<T = object> = new (...args: any[]) => T;
 //#endregion
 export { Constructor as t };
-//# sourceMappingURL=types-DahElfUw.d.mts.map
+//# sourceMappingURL=types-CN0zONAZ.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-CN0zONAZ.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,WAAA,uBAAkC,IAAA,YAAgB,CAAA"}

package/dist/{usage-generator-C9hWziY4.mjs → usage-generator-Cl1HPlUp.mjs}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-D1SwGrFN.mjs";
-import { i as dimWhite, n as cyan, r as dim, s as yellow, t as bold } from "./colors-DJaRDXoS.mjs";
+import { i as dimWhite, n as cyan, r as dim, s as yellow, t as bold } from "./colors-BTAnQRGU.mjs";
 //#region src/quarry/usage-generator.ts
 var usage_generator_exports = /* @__PURE__ */ __exportAll({
 	generateListing: () => generateListing,
@@ -155,4 +155,4 @@ function formatTable(rows) {
 //#endregion
 export { usage_generator_exports as n, generateUsage as t };
 
-//# sourceMappingURL=usage-generator-C9hWziY4.mjs.map
+//# sourceMappingURL=usage-generator-Cl1HPlUp.mjs.map