stratal 0.0.20 → 0.0.22

package/dist/{i18n.module-BBlNNlcG.mjs → router-Cy6DjkvP.mjs}

@@ -1,599 +1,74 @@
-import { A as Scope, D as runWithContainer, E as getContainer, H as ApplicationError, V as ROUTER_TOKENS, a as createHttpExceptionContext, c as DEFAULT_CONTENT_TYPE, d as ROUTER_CONTEXT_KEYS, f as ROUTE_METADATA_KEYS, k as ERROR_CODES, l as HTTP_METHODS, m as VERSION_NEUTRAL, p as SECURITY_SCHEMES, s as RouterContext, u as METHOD_STATUS_CODES, w as I18N_TOKENS } from "./errors-BdyV5PnY.mjs";
-import { a as __decorate, d as CONTAINER_TOKEN, f as DI_TOKENS, g as getMethodInjections, o as __decorateParam, p as Transient, s as __decorateMetadata, u as LOGGER_TOKENS } from "./logger-V6Ms3QnQ.mjs";
-import { S as createThrottleMiddleware, b as ControllerRegistrationError, c as InvalidSignatureError, d as MissingRouteParamError, f as ResponseValidationError, g as RouteNotFoundError, h as SchemaValidationError, k as Module, l as MiddlewareNextCalledMultipleTimesError, o as DomainMismatchError, p as RouteNameNotFoundError, s as DuplicateRouteNameError, u as MissingEnvironmentVariableError, v as OpenAPIRouteRegistrationError, x as ControllerMethodNotFoundError, y as HonoAppAlreadyConfiguredError } from "./module-Dk2qTa77.mjs";
-import { c as backendErrorMap, i as z, l as runWithErrorMapContext, r as validation_exports, t as OpenAPIHono } from "./validation-DtJwAv7O.mjs";
-import { n as OPENAPI_TOKENS } from "./openapi-tools.service-Zs-Ewv7F.mjs";
-import { t as en_exports } from "./en-DSH_bhh6.mjs";
-import { i as getMethodGuards, r as getControllerGuards, t as GuardExecutionService } from "./guards-DUk_Kzst.mjs";
-import { n as getControllerOptions, r as getControllerRoute } from "./controller.decorator-DQzenvSN.mjs";
-import { c as getWsOnMessageMethod, d as isGateway, o as getWsOnCloseMethod, s as getWsOnErrorMethod, t as GatewayContext } from "./gateway-context-CdJjpUCW.mjs";
-import "./http-method.decorator-DXwxAfb_.mjs";
-import { n as getRateLimits } from "./rate-limit.decorator--o6Q6p9w.mjs";
-import { n as verifySignedUrl, t as signUrl } from "./signed-url-BQPbv2In.mjs";
-import { t as setupI18nCompiler } from "./setup-CefZKV_e.mjs";
-import { inject } from "tsyringe";
-import { createCoreContext, translate } from "@intlify/core-base";
-import { swaggerUI } from "@hono/swagger-ui";
+import { n as getContainer, r as runWithContainer } from "./container-storage-GpNNz79X.mjs";
+import { _ as getMethodInjections, c as DI_TOKENS, l as Request, m as inject, o as ROUTER_TOKENS, s as CONTAINER_TOKEN, u as Singleton } from "./di-BO1QIb5H.mjs";
+import { n as getMetadata, t as defineMetadata } from "./metadata-BVkc4aUu.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-HgTKAYK8.mjs";
+import { LOGGER_TOKENS } from "./logger/index.mjs";
+import { d as abort, u as HttpException } from "./errors-BBZTnjdq.mjs";
+import { a as RouterContext, c as METHOD_STATUS_CODES, d as SECURITY_SCHEMES, f as VERSION_NEUTRAL, l as ROUTER_CONTEXT_KEYS, o as DEFAULT_CONTENT_TYPE, r as createHttpExceptionContext, s as HTTP_METHODS, u as ROUTE_METADATA_KEYS } from "./exception-context-B4kM-M53.mjs";
+import { o as RouterError, s as createThrottleMiddleware } from "./module-xYoHba6B.mjs";
+import { t as I18N_TOKENS } from "./i18n.tokens-hwRpmjRq.mjs";
+import { i as zod_exports, r as z, t as OpenAPIHono } from "./zod-hMa3rSHV.mjs";
+import { a as OPENAPI_TOKENS } from "./openapi-C6lm0RmV.mjs";
+import { i as getMethodGuards, r as getControllerGuards, t as GuardExecutionService } from "./guards-Ced-uNIF.mjs";
+import { n as getRateLimits } from "./rate-limit.decorator-D69zdZbp.mjs";
+import { n as getControllerOptions, r as getControllerRoute } from "./controller.decorator-DIUazNU7.mjs";
+import { a as getWsOnCloseMethod, o as getWsOnErrorMethod, s as getWsOnMessageMethod, t as GatewayContext, u as isGateway } from "./gateway-context-CFe6a9gz.mjs";
+import "./http-method.decorator-CdjKFJZZ.mjs";
+import { n as verifySignedUrl, t as signUrl } from "./signed-url-BqUqt5dF.mjs";
 import { languageDetector } from "hono/language";
-//#region src/i18n/middleware/i18n-context.middleware.ts
-/**
-* I18n Context Middleware
-*
-* Sets up AsyncLocalStorage context for Zod i18n validation.
-* Must run after LocaleExtractionMiddleware sets the locale.
-*/
-let I18nContextMiddleware = class I18nContextMiddleware {
-	constructor(i18n) {
-		this.i18n = i18n;
-	}
-	async handle(ctx, next) {
-		await runWithErrorMapContext({
-			t: (key, params) => this.i18n.t(key, params),
-			locale: ctx.getLocale()
-		}, () => next());
-	}
-};
-I18nContextMiddleware = __decorate([
-	Transient(),
-	__decorateParam(0, inject(I18N_TOKENS.I18nService)),
-	__decorateMetadata("design:paramtypes", [Object])
-], I18nContextMiddleware);
-//#endregion
-//#region src/openapi/services/openapi-config.service.ts
-let OpenAPIConfigService = class OpenAPIConfigService {
-	overrides = [];
-	constructor(baseOptions) {
-		this.baseOptions = baseOptions;
-	}
-	/**
-	* Add configuration override for this request.
-	* Overrides are merged in the order they are added.
-	*/
-	override(config) {
-		this.overrides.push(config);
-	}
-	/** Get effective configuration (base merged with all overrides) */
-	getEffectiveConfig() {
-		let effective = {
-			jsonPath: this.baseOptions?.jsonPath ?? "/api/openapi.json",
-			ui: this.baseOptions?.ui,
-			info: {
-				title: this.baseOptions?.info?.title ?? "API",
-				version: this.baseOptions?.info?.version ?? "1.0.0",
-				description: this.baseOptions?.info?.description
-			},
-			securitySchemes: this.baseOptions?.securitySchemes
-		};
-		for (const override of this.overrides) effective = this.mergeConfig(effective, override);
-		return effective;
-	}
-	/**
-	* Merge override into effective config.
-	* Info is shallow-merged, routeFilter is replaced.
-	*/
-	mergeConfig(base, override) {
-		return {
-			...base,
-			info: {
-				...base.info,
-				...override.info && {
-					title: override.info.title ?? base.info.title,
-					version: override.info.version ?? base.info.version,
-					description: override.info.description ?? base.info.description
-				}
-			},
-			routeFilter: override.routeFilter ?? base.routeFilter
-		};
-	}
-};
-OpenAPIConfigService = __decorate([
-	Transient(OPENAPI_TOKENS.ConfigService),
-	__decorateParam(0, inject(OPENAPI_TOKENS.Options, { isOptional: true })),
-	__decorateMetadata("design:paramtypes", [Object])
-], OpenAPIConfigService);
-//#endregion
-//#region src/i18n/errors/locale-not-supported.error.ts
-/**
-* Locale Not Supported Error
-* Thrown when an unsupported locale is requested
-*
-* HTTP Status: 500 Internal Server Error
-* Error Code: 9301
-*/
-var LocaleNotSupportedError = class extends ApplicationError {
-	constructor(locale, supportedLocales) {
-		super("errors.localeNotSupported", ERROR_CODES.I18N.LOCALE_NOT_SUPPORTED, {
-			locale,
-			supportedLocales: supportedLocales.join(", ")
-		});
+//#region src/router/errors/route-not-found.error.ts
+var RouteNotFoundError = class extends HttpException {
+	path;
+	method;
+	constructor(path, method) {
+		super(404, `Route not found: ${method} ${path}`);
+		this.path = path;
+		this.method = method;
 	}
 };
 //#endregion
-//#region src/i18n/errors/translation-missing.error.ts
-/**
-* Translation Missing Error
-* Thrown when a translation key is missing from all locales
-*
-* HTTP Status: 500 Internal Server Error
-* Error Code: 9300
-*/
-var TranslationMissingError = class extends ApplicationError {
-	constructor(key, locale) {
-		super("errors.translationMissing", ERROR_CODES.I18N.TRANSLATION_MISSING, {
-			key,
-			locale
-		});
-	}
-};
-//#endregion
-//#region src/i18n/i18n.options.ts
-/**
-* Resolve I18n options with defaults
-*/
-function resolveI18nOptions(options) {
-	const detection = options?.detection;
-	const enabled = detection ? detection.enabled !== false : true;
-	const strategy = detection && "strategy" in detection ? detection.strategy ?? "cookie" : "cookie";
-	const prefixDefaultLocale = detection && "prefixDefaultLocale" in detection && detection.prefixDefaultLocale !== void 0 ? detection.prefixDefaultLocale : false;
-	return {
-		defaultLocale: options?.defaultLocale ?? "en",
-		fallbackLocale: options?.fallbackLocale ?? "en",
-		locales: options?.locales ?? ["en"],
-		detection: {
-			enabled,
-			strategy,
-			prefixDefaultLocale
-		}
-	};
-}
-/**
-* Build Hono languageDetector options from I18n module options
-*/
-function buildDetectorOptions(options) {
-	const resolved = resolveI18nOptions(options);
-	const strategy = resolved.detection.strategy;
-	const detectorOptions = {
-		order: [strategy],
-		fallbackLanguage: resolved.defaultLocale,
-		supportedLanguages: resolved.locales,
-		lookupCookie: "locale",
-		lookupQueryString: "locale",
-		lookupFromPathIndex: 0,
-		ignoreCase: true
-	};
-	if (strategy === "cookie") {
-		detectorOptions.caches = ["cookie"];
-		if (options?.detection && "cookieOptions" in options.detection && options.detection.cookieOptions) detectorOptions.cookieOptions = options.detection.cookieOptions;
-	} else detectorOptions.caches = false;
-	return detectorOptions;
-}
-//#endregion
-//#region src/i18n/messages/index.ts
-/**
-* Core Messages
-*
-* Messages used by packages/modules infrastructure.
-* These are automatically merged with application-specific messages.
-*/
-/**
-* All locale messages
-* Explicitly import and export (no filesystem scanning - Cloudflare Workers compatible)
-*/
-const messages = { en: en_exports };
-/**
-* Get messages for all locales
-*/
-function getMessages() {
-	return messages;
-}
-/**
-* Get available locales
-*/
-function getLocales() {
-	return Object.keys(messages);
-}
-//#endregion
-//#region src/i18n/utils/deep-merge.ts
-/**
-* Deep merge two objects. Source values override target at leaf level.
-*/
-function deepMerge(target, source) {
-	const result = { ...target };
-	for (const key of Object.keys(source)) {
-		const targetValue = target[key];
-		const sourceValue = source[key];
-		if (typeof targetValue === "object" && targetValue !== null && !Array.isArray(targetValue) && typeof sourceValue === "object" && sourceValue !== null && !Array.isArray(sourceValue)) result[key] = deepMerge(targetValue, sourceValue);
-		else result[key] = sourceValue;
-	}
-	return result;
-}
-//#endregion
-//#region src/i18n/services/message-loader.service.ts
-let MessageLoaderService = class MessageLoaderService {
-	cache;
-	contextCache;
-	locales;
-	defaultLocale;
-	constructor(registry, options) {
-		this.registry = registry;
-		this.options = options;
-		this.defaultLocale = this.options?.defaultLocale ?? "en";
-		this.cache = /* @__PURE__ */ new Map();
-		this.contextCache = /* @__PURE__ */ new Map();
-		const coreMessages = getMessages();
-		const coreLocales = getLocales();
-		const registryMessages = this.registry.getMergedMessages();
-		const registryLocales = Object.keys(registryMessages);
-		const allLocales = [...new Set([...coreLocales, ...registryLocales])];
-		this.locales = allLocales;
-		for (const locale of allLocales) {
-			const merged = deepMerge(coreMessages[locale] ?? {}, registryMessages[locale] ?? {});
-			this.cache.set(locale, merged);
-		}
-	}
-	/**
-	* Get CoreContext for a locale (lazily built and cached on first access)
-	* Falls back to default locale if locale not found
-	*/
-	getCoreContext(locale) {
-		const cached = this.contextCache.get(locale);
-		if (cached) return cached;
-		const effectiveLocale = this.cache.has(locale) ? locale : this.defaultLocale;
-		const cachedEffective = this.contextCache.get(effectiveLocale);
-		if (cachedEffective) return cachedEffective;
-		const messages = this.cache.get(effectiveLocale) ?? {};
-		const flattened = this.flattenMessages(messages);
-		const ctx = createCoreContext({
-			locale: effectiveLocale,
-			messages: { [effectiveLocale]: flattened },
-			missingWarn: false,
-			fallbackWarn: false
-		});
-		this.contextCache.set(effectiveLocale, ctx);
-		return ctx;
-	}
-	/**
-	* Get messages for a specific locale.
-	* Falls back to default locale if not found.
-	*/
-	getMessages(locale) {
-		return this.cache.get(locale) ?? this.cache.get(this.defaultLocale) ?? {};
-	}
-	/** Get list of available locale codes */
-	getAvailableLocales() {
-		return this.locales;
-	}
-	/** Check if a locale is supported */
-	isLocaleSupported(locale) {
-		return this.cache.has(locale);
-	}
-	/** Get default locale */
-	getDefaultLocale() {
-		return this.defaultLocale;
-	}
-	/**
-	* Get flattened (dot-notation) messages for a locale, optionally filtered by namespace prefixes.
-	*
-	* Returns flat key-value pairs matching the format used by `@intlify/core-base`'s
-	* `createCoreContext`. Requires `registerMessageCompiler(compile)` to be called
-	* before `translate()` can resolve these flat keys.
-	*
-	* @param locale - Locale code (falls back to default locale if not found)
-	* @param options - Optional filter configuration
-	* @param options.only - Dot-notation prefixes to include (e.g., `['common', 'nav.sidebar']`)
-	* @returns Flattened messages as `{ 'key.path': 'translated value' }`
-	*
-	* @example
-	* ```typescript
-	* // All messages for the locale
-	* loader.getFilteredMessages('en')
-	*
-	* // Only 'common' and 'nav' namespaces
-	* loader.getFilteredMessages('en', { only: ['common', 'nav'] })
-	*
-	* // Deeply nested prefix
-	* loader.getFilteredMessages('en', { only: ['common.actions'] })
-	* ```
-	*/
-	getFilteredMessages(locale, options) {
-		const messages = this.getMessages(locale);
-		const flattened = this.flattenMessages(messages);
-		if (!options?.only?.length) return flattened;
-		const result = {};
-		for (const [key, value] of Object.entries(flattened)) if (options.only.some((prefix) => key === prefix || key.startsWith(`${prefix}.`))) result[key] = value;
-		return result;
-	}
-	/**
-	* Flatten nested messages to dot-notation.
-	* e.g. `{ a: { b: 'hello' } }` → `{ 'a.b': 'hello' }`
-	*/
-	flattenMessages(messages, prefix = "") {
-		const result = {};
-		for (const key of Object.keys(messages)) {
-			const value = messages[key];
-			const newKey = prefix ? `${prefix}.${key}` : key;
-			if (typeof value === "object" && value !== null && !Array.isArray(value)) Object.assign(result, this.flattenMessages(value, newKey));
-			else result[newKey] = String(value);
-		}
-		return result;
+//#region src/router/errors/schema-validation.error.ts
+var SchemaValidationError = class extends HttpException {
+	issues;
+	constructor(zodError) {
+		super(400, "Schema validation failed");
+		this.issues = zodError.issues.map((err) => ({
+			path: err.path.join("."),
+			message: err.message,
+			code: err.code
+		}));
 	}
 };
-MessageLoaderService = __decorate([
-	Transient(I18N_TOKENS.MessageLoader),
-	__decorateParam(0, inject(I18N_TOKENS.MessageRegistry)),
-	__decorateParam(1, inject(I18N_TOKENS.Options, { isOptional: true })),
-	__decorateMetadata("design:paramtypes", [Object, Object])
-], MessageLoaderService);
 //#endregion
-//#region src/i18n/services/message-registry.ts
+//#region src/router/errors/index.ts
 /**
-* Global key for the shared contributions array.
+* Error thrown when a signed URL has an invalid or expired signature.
 *
-* When stratal is installed via portal/symlink (e.g., in monorepos), bundlers
-* like esbuild may inline multiple copies of this module. Each copy gets its
-* own static class fields, so messages registered by one copy are invisible
-* to another. Using a `Symbol.for()` key on `globalThis` ensures all copies
-* share the same contributions array.
+* HTTP Status: 403 Forbidden
 */
-const CONTRIBUTIONS_KEY = Symbol.for("stratal:i18n:message-registry:contributions");
-function getContributions() {
-	const g = globalThis;
-	g[CONTRIBUTIONS_KEY] ??= [];
-	return g[CONTRIBUTIONS_KEY];
-}
-let MessageRegistry = class MessageRegistry {
-	/**
-	* Add messages (called statically by I18nModule.registerMessages)
-	*/
-	static addMessages(messages) {
-		if (Boolean(messages) && typeof messages === "object" && Object.keys(messages).length > 0) getContributions().push(messages);
-	}
-	/**
-	* Get all messages deep-merged in registration order
-	*/
-	getMergedMessages() {
-		const merged = {};
-		for (const contribution of getContributions()) for (const locale of Object.keys(contribution)) merged[locale] = deepMerge(merged[locale] ?? {}, contribution[locale]);
-		return merged;
-	}
-	/**
-	* Reset registry (for testing)
-	* @internal
-	*/
-	static reset() {
-		globalThis[CONTRIBUTIONS_KEY] = [];
-	}
-};
-MessageRegistry = __decorate([Transient(I18N_TOKENS.MessageRegistry)], MessageRegistry);
-//#endregion
-//#region src/openapi/services/openapi.service.ts
-let OpenAPIService = class OpenAPIService {
-	/**
-	* Generate a filtered OpenAPI spec using the user's config.
-	* Usable from both HTTP handlers and CLI commands.
-	*/
-	getSpec(app, container) {
-		const configService = container.resolve(OPENAPI_TOKENS.ConfigService);
-		const i18n = container.resolve(I18N_TOKENS.I18nService);
-		const config = configService.getEffectiveConfig();
-		const fullSpec = app.getOpenAPIDocument({
-			openapi: "3.0.0",
-			info: {
-				version: config.info.version,
-				title: config.info.title,
-				description: config.info.description
-			}
-		});
-		fullSpec.components ??= {};
-		fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n);
-		if (config.routeFilter) fullSpec.paths = this.filterRoutes(fullSpec.paths, config);
-		if (fullSpec.components.schemas) fullSpec.components.schemas = this.filterSchemas(fullSpec);
-		return fullSpec;
-	}
-	/**
-	* Setup OpenAPI documentation endpoints
-	*/
-	setupEndpoints(app, container) {
-		const config = container.resolve(OPENAPI_TOKENS.ConfigService).getEffectiveConfig();
-		app.get(config.jsonPath, (c) => {
-			const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
-			const fullSpec = this.getSpec(app, requestContainer);
-			const url = new URL(c.req.raw.url);
-			const i18n = requestContainer.resolve(I18N_TOKENS.I18nService);
-			fullSpec.servers = [{
-				url: `${url.protocol}//${url.host}`,
-				description: i18n.t("common.api.serverDescription")
-			}];
-			return c.json(fullSpec);
-		});
-		this.nameLastHandler(app, "OpenAPI", "spec");
-		if (config.ui !== false) {
-			const uiPath = config.ui?.path ?? "/api/docs";
-			const uiRenderer = config.ui?.renderer;
-			app.get(uiPath, (c, next) => {
-				const effectiveConfig = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER).resolve(OPENAPI_TOKENS.ConfigService).getEffectiveConfig();
-				const uiContext = {
-					specUrl: effectiveConfig.jsonPath,
-					title: effectiveConfig.info.title
-				};
-				if (uiRenderer) return uiRenderer(uiContext)(c, next);
-				return swaggerUI({ url: uiContext.specUrl })(c, next);
-			});
-			this.nameLastHandler(app, "OpenAPI", "docs");
-		}
-	}
-	nameLastHandler(app, controller, method) {
-		const last = app.routes[app.routes.length - 1];
-		Object.defineProperty(last.handler, "name", { value: `http:${controller}.${method}` });
-	}
-	/**
-	* Get localized security scheme definitions
-	*/
-	getSecuritySchemeDefinitions(i18n) {
-		return {
-			[SECURITY_SCHEMES.BEARER_AUTH]: {
-				type: "http",
-				scheme: "bearer",
-				bearerFormat: "JWT",
-				description: i18n.t("common.api.security.bearerAuth")
-			},
-			[SECURITY_SCHEMES.API_KEY]: {
-				type: "apiKey",
-				in: "header",
-				name: "X-API-Key",
-				description: i18n.t("common.api.security.apiKey")
-			},
-			[SECURITY_SCHEMES.SESSION_COOKIE]: {
-				type: "apiKey",
-				in: "cookie",
-				name: "session",
-				description: i18n.t("common.api.security.sessionCookie")
-			}
-		};
-	}
-	/**
-	* Filter OpenAPI paths using custom routeFilter
-	*/
-	filterRoutes(paths, config) {
-		const filteredPaths = {};
-		for (const [path, pathItem] of Object.entries(paths)) {
-			if (config.routeFilter && !config.routeFilter(path, pathItem)) continue;
-			filteredPaths[path] = pathItem;
-		}
-		return filteredPaths;
-	}
-	/**
-	* Filter unreferenced schemas from OpenAPI spec
-	*/
-	filterSchemas(spec) {
-		const referencedSchemas = /* @__PURE__ */ new Set();
-		this.collectSchemaRefs(spec.paths, referencedSchemas);
-		const filteredSchemas = {};
-		const components = spec.components;
-		if (components?.schemas) {
-			const allSchemas = components.schemas;
-			let prevSize = 0;
-			while (referencedSchemas.size > prevSize) {
-				prevSize = referencedSchemas.size;
-				for (const [schemaName, schemaValue] of Object.entries(allSchemas)) if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) {
-					filteredSchemas[schemaName] = schemaValue;
-					this.collectSchemaRefs(schemaValue, referencedSchemas);
-				}
-			}
-		}
-		return filteredSchemas;
-	}
-	/**
-	* Recursively collect all schema references from an object
-	*/
-	collectSchemaRefs(obj, refs) {
-		if (!obj || typeof obj !== "object") return;
-		const record = obj;
-		if (record.$ref && typeof record.$ref === "string") {
-			const match = /^#\/components\/schemas\/(.+)$/.exec(record.$ref);
-			if (match) refs.add(match[1]);
-		}
-		if (Array.isArray(obj)) for (const item of obj) this.collectSchemaRefs(item, refs);
-		else for (const value of Object.values(record)) this.collectSchemaRefs(value, refs);
+var InvalidSignatureError = class extends HttpException {
+	constructor() {
+		super(403, "Invalid or expired signature");
 	}
 };
-OpenAPIService = __decorate([Transient(OPENAPI_TOKENS.OpenAPIService)], OpenAPIService);
-//#endregion
-//#region src/openapi/openapi.module.ts
 /**
-* OpenAPI Module
-*
-* Provides configurable OpenAPI documentation endpoints with runtime override support.
-*
-* Features:
-* - Configurable paths for /openapi.json and /docs
-* - Runtime config overrides via middleware
-* - i18n support for titles and descriptions
-* - Route filtering via hideFromDocs and custom routeFilter
-*
-* @example Basic usage
-* ```typescript
-* @Module({
-*   imports: [
-*     OpenAPIModule.forRoot({
-*       info: { title: 'My API', version: '1.0.0' }
-*     })
-*   ]
-* })
-* export class AppModule {}
-* ```
-*
-* @example With runtime override in middleware
-* ```typescript
-* // In RouteAccessMiddleware
-* constructor(
-*   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService
-* ) {}
+* ResponseValidationError
 *
-* async handle(ctx, next) {
-*   this.openAPIConfig.override({
-*     info: { title: 'Custom API' },
-*     routeFilter: (path) => this.shouldInclude(path)
-*   })
-*   await next()
-* }
-* ```
+* Thrown when a controller's response body does not match the declared Zod response schema.
+* Indicates a server-side schema mismatch — the controller is returning data that
+* violates its own API contract.
 */
-var _OpenAPIModule;
-/** Default options when none provided */
-const DEFAULT_OPTIONS = {
-	jsonPath: "/api/openapi.json",
-	info: {
-		title: "API",
-		version: "1.0.0"
-	}
-};
-let OpenAPIModule = _OpenAPIModule = class OpenAPIModule {
-	/**
-	* Configure OpenAPI module with static options
-	*
-	* @param options - OpenAPI configuration (paths, info, security schemes)
-	* @returns DynamicModule with options provider
-	*/
-	static forRoot(options = {}) {
-		const mergedOptions = {
-			...DEFAULT_OPTIONS,
-			...options,
-			info: {
-				...DEFAULT_OPTIONS.info,
-				...options.info,
-				title: options.info?.title ?? DEFAULT_OPTIONS.info?.title ?? "API",
-				version: options.info?.version ?? DEFAULT_OPTIONS.info?.version ?? "1.0.0"
-			}
-		};
-		return {
-			module: _OpenAPIModule,
-			providers: [{
-				provide: OPENAPI_TOKENS.Options,
-				useValue: mergedOptions
-			}]
-		};
-	}
-	static forRootAsync(options) {
-		return {
-			module: _OpenAPIModule,
-			providers: [{
-				provide: OPENAPI_TOKENS.Options,
-				useFactory: options.useFactory,
-				inject: options.inject
-			}]
-		};
+var ResponseValidationError = class extends HttpException {
+	issues;
+	constructor(zodError) {
+		super(500, "Response validation failed");
+		this.issues = zodError.issues.map((err) => ({
+			path: err.path.join("."),
+			message: err.message,
+			code: err.code
+		}));
 	}
 };
-OpenAPIModule = _OpenAPIModule = __decorate([Module({ providers: [{
-	provide: OPENAPI_TOKENS.ConfigService,
-	useClass: OpenAPIConfigService,
-	scope: Scope.Request
-}, {
-	provide: OPENAPI_TOKENS.OpenAPIService,
-	useClass: OpenAPIService,
-	scope: Scope.Singleton
-}] })], OpenAPIModule);
 //#endregion
 //#region src/router/middleware/logger.middleware.ts
 /**
@@ -666,7 +141,7 @@ function stripPort(host) {
 * When the host matches, domain parameters are extracted and stored in context
 * variables accessible via `ctx.domain(key)`.
 *
-* When the host does NOT match, throws `DomainMismatchError` (404).
+* When the host does NOT match, aborts with 404.
 *
 * @param pattern - Domain pattern with `{param}` placeholders (e.g., '{tenant}.myapp.com')
 *
@@ -686,7 +161,7 @@ function createDomainMiddleware(pattern) {
 	return async (c, next) => {
 		const host = stripPort(c.req.header("host") ?? "");
 		const match = regex.exec(host);
-		if (!match) throw new DomainMismatchError();
+		if (!match) abort(404, "Domain mismatch");
 		for (let i = 0; i < paramNames.length; i++) c.set(`domain:${paramNames[i]}`, match[i + 1]);
 		await next();
 	};
@@ -714,12 +189,7 @@ function createMiddlewareChain(classes) {
 				const middleware = requestContainer.resolve(middlewareClass);
 				let called = false;
 				const guardedNext = () => {
-					if (called) {
-						const err = new MiddlewareNextCalledMultipleTimesError(middlewareClass.name ?? "anonymous");
-						console.error("[STRATAL DEBUG] next() called multiple times for " + middlewareClass.name);
-						console.error("[STRATAL DEBUG] Stack trace:", (/* @__PURE__ */ new Error()).stack);
-						return Promise.reject(err);
-					}
+					if (called) return Promise.reject(new RouterError(`Middleware "${middlewareClass.name ?? "anonymous"}" called next() multiple times`));
 					called = true;
 					return prevNext();
 				};
@@ -871,10 +341,10 @@ function Route(config) {
 			type: "convention",
 			config
 		};
-		Reflect.defineMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, metadata, target, propertyKey);
-		const existing = Reflect.getOwnMetadata(ROUTE_METADATA_KEYS.DECORATED_METHODS, target) ?? [];
+		defineMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, metadata, target, propertyKey);
+		const existing = getMetadata(ROUTE_METADATA_KEYS.DECORATED_METHODS, target) ?? [];
 		existing.push(propertyKey);
-		Reflect.defineMetadata(ROUTE_METADATA_KEYS.DECORATED_METHODS, existing, target);
+		defineMetadata(ROUTE_METADATA_KEYS.DECORATED_METHODS, existing, target);
 		return descriptor;
 	};
 }
@@ -886,7 +356,7 @@ function Route(config) {
 * @returns Route metadata or undefined if not decorated
 */
 function getRouteMetadata(target, methodName) {
-	return Reflect.getMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, target, methodName);
+	return getMetadata(ROUTE_METADATA_KEYS.ROUTE_CONFIG, target, methodName);
 }
 /**
 * Get all methods with route decorators (@Route, @Get, @Post, etc.) from a controller
@@ -898,7 +368,7 @@ function getRouteDecoratedMethods(ControllerClass) {
 	const methods = /* @__PURE__ */ new Set();
 	let proto = ControllerClass.prototype;
 	while (proto && proto !== Object.prototype) {
-		const own = Reflect.getOwnMetadata(ROUTE_METADATA_KEYS.DECORATED_METHODS, proto);
+		const own = getMetadata(ROUTE_METADATA_KEYS.DECORATED_METHODS, proto);
 		if (own) for (const m of own) methods.add(m);
 		proto = Object.getPrototypeOf(proto);
 	}
@@ -917,31 +387,19 @@ function getRouteDecoratedMethods(ControllerClass) {
 /**
 * Generic error response schema
 * Used for all error responses (4xx, 5xx)
-* Matches ApplicationError.toErrorResponse() structure
+* Matches the ErrorResponse shape produced by ExceptionHandler
 */
 const errorResponseSchema = z.object({
-	code: z.number().int().describe("Application error code"),
 	message: z.string().describe("Human-readable error message"),
 	timestamp: z.string().datetime().describe("ISO timestamp when error occurred"),
-	metadata: z.record(z.string(), z.unknown()).optional().describe("Additional error context"),
 	stack: z.string().optional().describe("Stack trace (development only)")
 }).openapi("ErrorResponse");
 /**
 * Validation error response schema
 * Used for 400 Bad Request with validation failures
-* Matches ApplicationError.toErrorResponse() structure with validation-specific metadata
+* Matches the ErrorResponse shape produced by ExceptionHandler
 */
-const validationErrorResponseSchema = z.object({
-	code: z.number().int().describe("Application error code"),
-	message: z.string().describe("Human-readable error message"),
-	timestamp: z.string().datetime().describe("ISO timestamp when error occurred"),
-	metadata: z.object({ issues: z.array(z.object({
-		path: z.string().describe("Field path that failed validation"),
-		message: z.string().describe("Validation failure message"),
-		code: z.string().describe("Zod validation error code")
-	})) }).describe("Validation error details"),
-	stack: z.string().optional().describe("Stack trace (development only)")
-}).openapi("ValidationErrorResponse");
+const validationErrorResponseSchema = errorResponseSchema.openapi("ValidationErrorResponse");
 /**
 * Pagination query parameters schema
 * Used for list endpoints
@@ -1050,10 +508,34 @@ function toRoutingOpenAPIPath(path) {
 * Scoring: static = 0, `:param{constraint}` = 5, `:param` = 10, wildcard `{.+}` / `{.*}` = 100.
 *
 * Packed as: score * 10000 - segmentCount (negative segment count so more segments = lower key = higher priority)
+*
+* Locale variants score against the path with the leading `/:locale{…}` segment
+* stripped — the variant's score therefore matches its primary, but its larger
+* segment count makes it sort just before the primary. Without this, a primary
+* catch-all (e.g. `/:slug{.+}`) gobbles locale-prefixed URLs because Hono picks
+* whichever matching route was registered first.
 */
-function getPathSpecificityKey(path) {
+function getPathSpecificityKey(route) {
+	const segmentCount = countSegments(route.path);
+	const scoringPath = route.isLocaleVariant ? route.path.replace(/^\/:locale\{[^}]*\}/, "") || "/" : route.path;
 	let score = 0;
-	let segmentCount = 0;
+	let i = 0;
+	while (i < scoringPath.length) {
+		if (scoringPath.charCodeAt(i) === 47) {
+			i++;
+			continue;
+		}
+		let end = scoringPath.indexOf("/", i);
+		if (end === -1) end = scoringPath.length;
+		const segment = scoringPath.substring(i, end);
+		if (segment.includes("{.+}") || segment.includes("{.*}")) score += 100;
+		else if (segment.charCodeAt(0) === 58) score += segment.includes("{") ? 5 : 10;
+		i = end;
+	}
+	return score * 1e4 - segmentCount;
+}
+function countSegments(path) {
+	let count = 0;
 	let i = 0;
 	while (i < path.length) {
 		if (path.charCodeAt(i) === 47) {
@@ -1062,13 +544,10 @@ function getPathSpecificityKey(path) {
 		}
 		let end = path.indexOf("/", i);
 		if (end === -1) end = path.length;
-		segmentCount++;
-		const segment = path.substring(i, end);
-		if (segment.includes("{.+}") || segment.includes("{.*}")) score += 100;
-		else if (segment.charCodeAt(0) === 58) score += segment.includes("{") ? 5 : 10;
+		count++;
 		i = end;
 	}
-	return score * 1e4 - segmentCount;
+	return count;
 }
 /**
 * Compute a specificity score for route ordering.
@@ -1089,11 +568,13 @@ function getPathSpecificityScore(path) {
 *
 * 1. Static paths before parameterized before wildcards
 * 2. More segments = more specific (tie-breaker)
-* 3. Primary paths before locale-prefixed variants
+* 3. Locale-prefixed variants before their primary (so a locale-prefixed
+*    request matches the variant first; a primary catch-all would otherwise
+*    swallow the locale prefix into its param)
 */
 function sortRoutesBySpecificity(routes) {
 	const keys = /* @__PURE__ */ new Map();
-	for (const route of routes) keys.set(route, getPathSpecificityKey(route.path));
+	for (const route of routes) keys.set(route, getPathSpecificityKey(route));
 	const copy = routes.slice();
 	copy.sort((a, b) => keys.get(a) - keys.get(b));
 	return copy;
@@ -1161,6 +642,12 @@ const invokeHandler = (instance, method, ...args) => {
 	}
 };
 let RouteRegistrationService = class RouteRegistrationService {
+	logger;
+	registry;
+	routerResolver;
+	localePathService;
+	app;
+	moduleRegistry;
 	controllerClasses = /* @__PURE__ */ new Map();
 	upgradeWebSocketFn = null;
 	constructor(logger, registry, routerResolver, localePathService, app, moduleRegistry) {
@@ -1196,7 +683,7 @@ let RouteRegistrationService = class RouteRegistrationService {
 	collectRoutes(ControllerClass, actions) {
 		const isWsGateway = isGateway(ControllerClass);
 		const controllerRoute = getControllerRoute(ControllerClass);
-		if (!controllerRoute) throw new ControllerRegistrationError(ControllerClass.name, isWsGateway ? "Missing @Gateway decorator or route metadata" : "Missing @Controller decorator or route metadata");
+		if (!controllerRoute) throw new RouterError(`Controller "${ControllerClass.name}" registration failed: ${isWsGateway ? "Missing @Gateway decorator or route metadata" : "Missing @Controller decorator or route metadata"}`);
 		const controllerOpts = getControllerOptions(ControllerClass);
 		const controllerGuards = getControllerGuards(ControllerClass)?.guards ?? [];
 		const routerConfig = this.routerResolver?.resolveForController(ControllerClass) ?? { middleware: [] };
@@ -1249,7 +736,7 @@ let RouteRegistrationService = class RouteRegistrationService {
 			return;
 		}
 		const decoratedMethods = getRouteDecoratedMethods(ControllerClass);
-		if (decoratedMethods.length === 0) throw new ControllerRegistrationError(ControllerClass.name, "No route decorators found. Use @Route() or HTTP method decorators (@Get, @Post, etc.) on controller methods.");
+		if (decoratedMethods.length === 0) throw new RouterError(`Controller "${ControllerClass.name}" registration failed: No route decorators found. Use @Route() or HTTP method decorators (@Get, @Post, etc.) on controller methods.`);
 		const methodMetadata = [];
 		let hasConvention = false;
 		let hasExplicit = false;
@@ -1263,7 +750,7 @@ let RouteRegistrationService = class RouteRegistrationService {
 			if (meta.type === "convention") hasConvention = true;
 			else if (meta.type === "explicit") hasExplicit = true;
 		}
-		if (hasConvention && hasExplicit) throw new ControllerRegistrationError(ControllerClass.name, "Cannot mix @Route() with HTTP method decorators (@Get, @Post, etc.) in the same controller. Use one pattern or the other.");
+		if (hasConvention && hasExplicit) throw new RouterError(`Controller "${ControllerClass.name}" registration failed: Cannot mix @Route() with HTTP method decorators (@Get, @Post, etc.) in the same controller. Use one pattern or the other.`);
 		const routerHidden = routerConfig.hideFromDocs;
 		const controllerHidden = controllerOpts?.hideFromDocs ?? false;
 		const routerName = routerConfig.name;
@@ -1370,16 +857,16 @@ let RouteRegistrationService = class RouteRegistrationService {
 			const bindWsHandler = (method, onCatch) => {
 				return (evt, ws) => {
 					invokeHandler(gateway, method, evt, new GatewayContext(c, ws)).catch((err) => {
-						this.logger.error(`WebSocket ${method} handler error`, {
-							gateway: GatewayClass.name,
-							error: err instanceof Error ? err.message : String(err)
-						});
+						this.logger.error(`WebSocket ${method} handler error`, err, { gateway: GatewayClass.name });
 						onCatch?.(err, ws);
 					});
 				};
 			};
 			if (onMsgMethod) events.onMessage = bindWsHandler(onMsgMethod, (_err, ws) => ws.close(1011, "Internal Error"));
 			if (onCloseMethod) events.onClose = bindWsHandler(onCloseMethod);
+			else events.onClose = (_evt, ws) => {
+				ws.close();
+			};
 			if (onErrMethod) events.onError = bindWsHandler(onErrMethod);
 			return events;
 		});
@@ -1462,7 +949,7 @@ let RouteRegistrationService = class RouteRegistrationService {
 	resolveMethodAndPath(meta, methodName, basePath, className) {
 		if (meta.type === "convention") {
 			const derived = this.deriveHttpMethodAndPath(methodName, basePath);
-			if (!derived) throw new ControllerRegistrationError(`Cannot derive HTTP method/path for convention-based route "${className}.${methodName}". Ensure the method name follows the naming convention (e.g., index, create, show).`);
+			if (!derived) throw new RouterError(`Cannot derive HTTP method/path for convention-based route "${className}.${methodName}". Ensure the method name follows the naming convention (e.g., index, create, show).`);
 			return {
 				httpMethod: derived.method,
 				fullPath: derived.path,
@@ -1582,9 +1069,9 @@ let RouteRegistrationService = class RouteRegistrationService {
 			if (metadata.security.length > 0) route.security = metadata.security;
 			if (routeConfig.description) route.description = routeConfig.description;
 			if (routeConfig.summary) route.summary = routeConfig.summary;
-			return (0, validation_exports.createRoute)(route);
+			return (0, zod_exports.createRoute)(route);
 		} catch (error) {
-			throw new OpenAPIRouteRegistrationError(path, error instanceof Error ? error.message : String(error));
+			throw new RouterError(`OpenAPI route registration failed for "${path}": ${error instanceof Error ? error.message : String(error)}`);
 		}
 	}
 	/**
@@ -1629,7 +1116,7 @@ let RouteRegistrationService = class RouteRegistrationService {
 				if (responseSchema && c.env.ENVIRONMENT !== "production") return this.validateResponse(response, responseSchema);
 				return response;
 			}
-			throw new ControllerMethodNotFoundError(methodName, ControllerClass.name);
+			throw new RouterError(`Method "${methodName}" not found on controller "${ControllerClass.name}"`);
 		};
 		this.nameHandler(handler, ControllerClass.name, methodName);
 		return handler;
@@ -1679,21 +1166,13 @@ let RouteRegistrationService = class RouteRegistrationService {
 	}
 };
 RouteRegistrationService = __decorate([
-	Transient(),
+	Singleton(),
 	__decorateParam(0, inject(LOGGER_TOKENS.LoggerService)),
 	__decorateParam(1, inject(ROUTER_TOKENS.RouteRegistry)),
-	__decorateParam(2, inject(ROUTER_TOKENS.RouterResolver)),
+	__decorateParam(2, inject(ROUTER_TOKENS.RouterResolver, { isOptional: true })),
 	__decorateParam(3, inject(ROUTER_TOKENS.LocalePathService)),
 	__decorateParam(4, inject(ROUTER_TOKENS.HonoApp)),
-	__decorateParam(5, inject(DI_TOKENS.ModuleRegistry)),
-	__decorateMetadata("design:paramtypes", [
-		Object,
-		Object,
-		Object,
-		Object,
-		Object,
-		Object
-	])
+	__decorateParam(5, inject(DI_TOKENS.ModuleRegistry))
 ], RouteRegistrationService);
 //#endregion
 //#region src/router/hono-app.ts
@@ -1750,7 +1229,7 @@ let HonoApp = class HonoApp extends OpenAPIHono {
 	* Called once by Application.initialize().
 	*/
 	async configure() {
-		if (this.configured) throw new HonoAppAlreadyConfiguredError();
+		if (this.configured) throw new RouterError("HonoApp has already been configured");
 		this._container.resolve(OPENAPI_TOKENS.OpenAPIService).setupEndpoints(this, this._container);
 		await this._container.resolve(RouteRegistrationService).configure();
 		this.notFound((c) => {
@@ -1773,19 +1252,57 @@ let HonoApp = class HonoApp extends OpenAPIHono {
 	}
 };
 HonoApp = __decorate([
-	Transient(),
+	Singleton(),
 	__decorateParam(0, inject(CONTAINER_TOKEN)),
 	__decorateParam(1, inject(LOGGER_TOKENS.LoggerService)),
-	__decorateParam(2, inject(DI_TOKENS.Application)),
-	__decorateMetadata("design:paramtypes", [
-		Object,
-		Object,
-		Object
-	])
+	__decorateParam(2, inject(DI_TOKENS.Application))
 ], HonoApp);
 //#endregion
+//#region src/i18n/i18n.options.ts
+/**
+* Resolve I18n options with defaults
+*/
+function resolveI18nOptions(options) {
+	const detection = options?.detection;
+	const enabled = detection ? detection.enabled !== false : true;
+	const strategy = detection && "strategy" in detection ? detection.strategy ?? "cookie" : "cookie";
+	const prefixDefaultLocale = detection && "prefixDefaultLocale" in detection && detection.prefixDefaultLocale !== void 0 ? detection.prefixDefaultLocale : false;
+	return {
+		defaultLocale: options?.defaultLocale ?? "en",
+		fallbackLocale: options?.fallbackLocale ?? "en",
+		locales: options?.locales ?? ["en"],
+		detection: {
+			enabled,
+			strategy,
+			prefixDefaultLocale
+		}
+	};
+}
+/**
+* Build Hono languageDetector options from I18n module options
+*/
+function buildDetectorOptions(options) {
+	const resolved = resolveI18nOptions(options);
+	const strategy = resolved.detection.strategy;
+	const detectorOptions = {
+		order: [strategy],
+		fallbackLanguage: resolved.defaultLocale,
+		supportedLanguages: resolved.locales,
+		lookupCookie: "locale",
+		lookupQueryString: "locale",
+		lookupFromPathIndex: 0,
+		ignoreCase: true
+	};
+	if (strategy === "cookie") {
+		detectorOptions.caches = ["cookie"];
+		if (options?.detection && "cookieOptions" in options.detection && options.detection.cookieOptions) detectorOptions.cookieOptions = options.detection.cookieOptions;
+	} else detectorOptions.caches = false;
+	return detectorOptions;
+}
+//#endregion
 //#region src/router/services/locale-path.service.ts
 let LocalePathService = class LocalePathService {
+	honoApp;
 	_config;
 	_pathDetectionEnabled;
 	_prefixDefaultLocale;
@@ -1891,10 +1408,9 @@ let LocalePathService = class LocalePathService {
 	}
 };
 LocalePathService = __decorate([
-	Transient(),
+	Singleton(),
 	__decorateParam(0, inject(CONTAINER_TOKEN)),
-	__decorateParam(1, inject(ROUTER_TOKENS.HonoApp)),
-	__decorateMetadata("design:paramtypes", [Object, Object])
+	__decorateParam(1, inject(ROUTER_TOKENS.HonoApp))
 ], LocalePathService);
 //#endregion
 //#region src/router/services/versioning.service.ts
@@ -1923,11 +1439,7 @@ let VersioningService = class VersioningService {
 		return [basePath];
 	}
 };
-VersioningService = __decorate([
-	Transient(),
-	__decorateParam(0, inject(DI_TOKENS.Application)),
-	__decorateMetadata("design:paramtypes", [Object])
-], VersioningService);
+VersioningService = __decorate([Singleton(), __decorateParam(0, inject(DI_TOKENS.Application))], VersioningService);
 //#endregion
 //#region src/router/route-registry.ts
 const CONCRETE_HTTP_METHODS = [
@@ -1941,6 +1453,8 @@ const CONCRETE_HTTP_METHODS = [
 	"trace"
 ];
 let RouteRegistry = class RouteRegistry {
+	versioningService;
+	localePathService;
 	routes = [];
 	namedRoutes = /* @__PURE__ */ new Map();
 	_sortedCache = null;
@@ -1954,7 +1468,7 @@ let RouteRegistry = class RouteRegistry {
 	* Named routes must have unique names.
 	*
 	* @returns Array of expanded RegisteredRoute entries (primary + locale variants)
-	* @throws DuplicateRouteNameError if a named route with the same name already exists
+	* @throws RouterError if a named route with the same name already exists
 	*/
 	register(input) {
 		const domainParamNames = input.domainParamNames ?? (input.domain ? extractDomainParamNames(input.domain) : []);
@@ -1986,7 +1500,7 @@ let RouteRegistry = class RouteRegistry {
 				if (route.name) {
 					if (this.namedRoutes.has(route.name)) {
 						const existing = this.namedRoutes.get(route.name);
-						throw new DuplicateRouteNameError(route.name, `${existing.controller}.${existing.action}`, `${route.controller}.${route.action}`);
+						throw new RouterError(`Duplicate route name "${route.name}": already registered by ${existing.controller}.${existing.action}, cannot register ${route.controller}.${route.action}`);
 					}
 					this.namedRoutes.set(route.name, route);
 				}
@@ -2025,7 +1539,7 @@ let RouteRegistry = class RouteRegistry {
 		}
 		return cache;
 	}
-	/** Get all routes sorted by specificity (static > param > wildcard, primary before locale) */
+	/** Get all routes sorted by specificity (static > param > wildcard, locale variant before its primary) */
 	all() {
 		this._sortedCache ??= sortRoutesBySpecificity(this.routes);
 		return this._sortedCache;
@@ -2036,12 +1550,41 @@ let RouteRegistry = class RouteRegistry {
 	}
 };
 RouteRegistry = __decorate([
-	Transient(),
+	Singleton(),
 	__decorateParam(0, inject(ROUTER_TOKENS.VersioningService)),
-	__decorateParam(1, inject(ROUTER_TOKENS.LocalePathService)),
-	__decorateMetadata("design:paramtypes", [Object, Object])
+	__decorateParam(1, inject(ROUTER_TOKENS.LocalePathService))
 ], RouteRegistry);
 //#endregion
+//#region src/router/route-url.ts
+/**
+* Generate a URL from a named route.
+*
+* Keys in `params` matching `:param` placeholders fill the path.
+* Domain params (`{tenant}`) are also consumed from `params`.
+* Extra keys become query string parameters.
+*
+* Resolves RouteRegistry from the application container via AsyncLocalStorage.
+* Available after `Application.initialize()` has been called.
+*
+* @param name - Named route identifier
+* @param params - Route params + domain params + extra query params
+* @returns Generated URL string
+*
+* @example
+* ```typescript
+* // In a controller (preferred):
+* ctx.route('users.show', { id: '1' })
+*
+* // Outside controllers (standalone function):
+* import { route } from 'stratal/router'
+*
+* route('users.show', { id: '1' })
+* ```
+*/
+function route(name, params, options) {
+	return getContainer().resolve(ROUTER_TOKENS.Uri).route(name, params, options);
+}
+//#endregion
 //#region src/router/uri.ts
 /**
 * Encode a value for use as a path parameter.
@@ -2064,7 +1607,7 @@ function encodePathParam(value) {
 * @param params - Path params, domain params, and extra query params
 * @returns Relative URL string (or absolute with domain prefix if route has a domain pattern)
 *
-* @throws MissingRouteParamError if a required path or domain param is missing
+* @throws RouterError if a required path or domain param is missing
 */
 function buildRouteUrl(route, name, params) {
 	const allParams = { ...params };
@@ -2076,7 +1619,7 @@ function buildRouteUrl(route, name, params) {
 	}
 	for (const paramName of route.paramNames) {
 		const value = allParams[paramName];
-		if (value === void 0) throw new MissingRouteParamError(paramName, name, route.path);
+		if (value === void 0) throw new RouterError(`Missing required route parameter "${paramName}" for route "${name}" (path: ${route.path})`);
 		url = url.replace(new RegExp(`:${paramName}(\\{[^}]*\\})?`), encodePathParam(value));
 		consumedKeys.add(paramName);
 	}
@@ -2085,7 +1628,7 @@ function buildRouteUrl(route, name, params) {
 		domain = route.domain;
 		for (const domainParam of route.domainParamNames) {
 			const value = allParams[domainParam];
-			if (value === void 0) throw new MissingRouteParamError(domainParam, name, route.domain);
+			if (value === void 0) throw new RouterError(`Missing required domain parameter "${domainParam}" for route "${name}" (domain: ${route.domain})`);
 			domain = domain.replace(`{${domainParam}}`, encodeURIComponent(value));
 			consumedKeys.add(domainParam);
 		}
@@ -2099,6 +1642,8 @@ function buildRouteUrl(route, name, params) {
 	return url;
 }
 let Uri = class Uri {
+	registry;
+	routerContext;
 	_defaults = {};
 	trailingSlash;
 	constructor(registry, routerContext, application) {
@@ -2141,12 +1686,11 @@ let Uri = class Uri {
 	* @param options - URL generation options
 	* @returns Generated URL string
 	*
-	* @throws RouteNameNotFoundError if route name not found
-	* @throws MissingRouteParamError if required params missing
+	* @throws RouterError if route name not found or required params missing
 	*/
 	route(name, params, options) {
 		const registeredRoute = this.registry.get(name);
-		if (!registeredRoute) throw new RouteNameNotFoundError(name);
+		if (!registeredRoute) throw new RouterError(`Route name "${name}" was not found in the registry`);
 		let url = applyTrailingSlash(buildRouteUrl(registeredRoute, name, {
 			...this._defaults,
 			...params
@@ -2266,52 +1810,12 @@ let Uri = class Uri {
 	}
 };
 Uri = __decorate([
-	Transient(),
+	Request(),
 	__decorateParam(0, inject(ROUTER_TOKENS.RouteRegistry)),
 	__decorateParam(1, inject(ROUTER_TOKENS.RouterContext)),
-	__decorateParam(2, inject(DI_TOKENS.Application)),
-	__decorateMetadata("design:paramtypes", [
-		Object,
-		Object,
-		Object
-	])
+	__decorateParam(2, inject(DI_TOKENS.Application))
 ], Uri);
 //#endregion
-//#region src/router/route-url.ts
-/**
-* Generate a URL from a named route.
-*
-* Keys in `params` matching `:param` placeholders fill the path.
-* Domain params (`{tenant}`) are also consumed from `params`.
-* Extra keys become query string parameters.
-*
-* Resolves RouteRegistry from the application container via AsyncLocalStorage.
-* Available after `Application.initialize()` has been called.
-*
-* @param name - Named route identifier
-* @param params - Route params + domain params + extra query params
-* @returns Generated URL string
-*
-* @example
-* ```typescript
-* // In a controller (preferred):
-* ctx.route('users.show', { id: '1' })
-*
-* // Outside controllers (standalone function):
-* import { route } from 'stratal/router'
-*
-* route('users.show', { id: '1' })
-* ```
-*/
-function route(name, params) {
-	const container = getContainer();
-	const registry = container.resolve(ROUTER_TOKENS.RouteRegistry);
-	const application = container.resolve(DI_TOKENS.Application);
-	const registeredRoute = registry.get(name);
-	if (!registeredRoute) throw new RouteNameNotFoundError(name);
-	return applyTrailingSlash(buildRouteUrl(registeredRoute, name, params), application.config.trailingSlash ?? "ignore");
-}
-//#endregion
 //#region src/router/middleware/verify-signature.middleware.ts
 /**
 * Middleware that verifies signed URLs.
@@ -2337,156 +1841,12 @@ var VerifySignatureMiddleware = class {
 	async handle(ctx, next) {
 		const url = ctx.c.req.url;
 		const secret = ctx.c.env.APP_SECRET;
-		if (!secret) throw new MissingEnvironmentVariableError("APP_SECRET");
+		if (!secret) throw new RouterError("Missing required environment variable \"APP_SECRET\"");
 		if (!await verifySignedUrl(url, secret)) throw new InvalidSignatureError();
 		await next();
 	}
 };
 //#endregion
-//#region src/i18n/services/i18n.service.ts
-/**
-* I18n Service
-*
-* Request-scoped service for translations.
-* Injects RouterContext to access request-specific locale.
-* Uses pre-built CoreContext from MessageLoaderService (singleton) for zero-cost lookups.
-*/
-let I18nService = class I18nService {
-	constructor(loader, routerContext) {
-		this.loader = loader;
-		this.routerContext = routerContext;
-	}
-	/**
-	* Translate a message key
-	*
-	* @param key - Message key (e.g., 'common.actions.save')
-	* @param params - Optional parameters for interpolation
-	* @returns Translated string
-	*/
-	t(key, params) {
-		const context = this.loader.getCoreContext(this.getLocale());
-		const result = params !== void 0 ? translate(context, key, params) : translate(context, key);
-		return typeof result === "string" ? result : key;
-	}
-	/**
-	* Get current locale
-	*
-	* @returns Current locale code from RouterContext or default locale
-	*/
-	getLocale() {
-		return this.routerContext?.getLocale() ?? "en";
-	}
-};
-I18nService = __decorate([
-	Transient(I18N_TOKENS.I18nService),
-	__decorateParam(0, inject(I18N_TOKENS.MessageLoader)),
-	__decorateParam(1, inject(ROUTER_TOKENS.RouterContext, { isOptional: true })),
-	__decorateMetadata("design:paramtypes", [Object, Object])
-], I18nService);
-//#endregion
-//#region src/i18n/i18n.module.ts
-/**
-* I18n Module
-*
-* Core infrastructure module for internationalization.
-* Provides message translation and locale handling.
-*
-* - `forRoot()` configures locale settings (call once in root module)
-* - `registerMessages()` adds translations (call from any module, as many times as needed)
-*
-* @example
-* ```typescript
-* @Module({
-*   imports: [
-*     I18nModule.forRoot({ defaultLocale: 'en', locales: ['en', 'fr'] }),
-*     I18nModule.registerMessages(appMessages),
-*   ],
-* })
-* export class AppModule {}
-* ```
-*
-* @example Package contributing messages
-* ```typescript
-* @Module({
-*   imports: [
-*     I18nModule.registerMessages(tenancyMessages),
-*   ],
-* })
-* export class TenancyModule {}
-* ```
-*/
-var _I18nModule;
-setupI18nCompiler();
-z.config({ customError: backendErrorMap });
-let I18nModule = _I18nModule = class I18nModule {
-	/**
-	* Configure I18n locale settings
-	*
-	* Call once in the root module. Does not accept messages —
-	* use `registerMessages()` to add translations.
-	*
-	* @param options - Locale configuration (defaultLocale, fallbackLocale, locales)
-	*/
-	static forRoot(options = {}) {
-		return {
-			module: _I18nModule,
-			providers: [{
-				provide: I18N_TOKENS.Options,
-				useValue: options
-			}]
-		};
-	}
-	/**
-	* Register i18n messages
-	*
-	* Can be called from any module, as many times as needed.
-	* Messages are deep-merged in registration order — later calls override earlier ones at leaf level.
-	*
-	* @param messages - Messages keyed by locale code
-	*
-	* @example App-level messages
-	* ```typescript
-	* I18nModule.registerMessages({
-	*   en: { common: { hello: 'Hello' }, errors: { notFound: 'Not found' } },
-	*   fr: { common: { hello: 'Bonjour' }, errors: { notFound: 'Introuvable' } },
-	* })
-	* ```
-	*
-	* @example Package-level messages
-	* ```typescript
-	* I18nModule.registerMessages({
-	*   en: { tenancy: { tenantNotFound: 'Tenant not found' } },
-	* })
-	* ```
-	*/
-	static registerMessages(messages) {
-		MessageRegistry.addMessages(messages);
-		return {
-			module: _I18nModule,
-			providers: []
-		};
-	}
-	configureRoutes(router) {
-		router.use(I18nContextMiddleware);
-	}
-};
-I18nModule = _I18nModule = __decorate([Module({ providers: [
-	{
-		provide: I18N_TOKENS.MessageRegistry,
-		useClass: MessageRegistry,
-		scope: Scope.Singleton
-	},
-	{
-		provide: I18N_TOKENS.MessageLoader,
-		useClass: MessageLoaderService,
-		scope: Scope.Singleton
-	},
-	{
-		provide: I18N_TOKENS.I18nService,
-		useClass: I18nService
-	}
-] })], I18nModule);
-//#endregion
-export { OpenAPIModule as A, LocaleNotSupportedError as B, validationErrorResponseSchema as C, createMiddlewareChain as D, getRouteMetadata as E, getMessages as F, I18nContextMiddleware as H, messages as I, buildDetectorOptions as L, MessageRegistry as M, MessageLoaderService as N, createDomainMiddleware as O, getLocales as P, resolveI18nOptions as R, uuidParamSchema as S, getRouteDecoratedMethods as T, OpenAPIConfigService as V, commonErrorSchemas as _, buildRouteUrl as a, paginationQuerySchema as b, LocalePathService as c, extractDomainParamNames as d, extractParamNames as f, toOpenAPIPath as g, sortRoutesBySpecificity as h, Uri as i, OpenAPIService as j, parseDomainPattern as k, HonoApp as l, getPathSpecificityScore as m, VerifySignatureMiddleware as n, RouteRegistry as o, generateConventionRouteName as p, route as r, VersioningService as s, I18nModule as t, RouteRegistrationService as u, errorResponseSchema as v, Route as w, successMessageSchema as x, paginatedResponseSchema as y, TranslationMissingError as z };
+export { parseDomainPattern as A, uuidParamSchema as C, getRouteMetadata as D, getRouteDecoratedMethods as E, ResponseValidationError as M, SchemaValidationError as N, createMiddlewareChain as O, RouteNotFoundError as P, successMessageSchema as S, Route as T, toOpenAPIPath as _, RouteRegistry as a, paginatedResponseSchema as b, buildDetectorOptions as c, RouteRegistrationService as d, extractDomainParamNames as f, sortRoutesBySpecificity as g, getPathSpecificityScore as h, route as i, InvalidSignatureError as j, createDomainMiddleware as k, resolveI18nOptions as l, generateConventionRouteName as m, Uri as n, VersioningService as o, extractParamNames as p, buildRouteUrl as r, LocalePathService as s, VerifySignatureMiddleware as t, HonoApp as u, commonErrorSchemas as v, validationErrorResponseSchema as w, paginationQuerySchema as x, errorResponseSchema as y };
 
-//# sourceMappingURL=i18n.module-BBlNNlcG.mjs.map
+//# sourceMappingURL=router-Cy6DjkvP.mjs.map