stratal 0.0.16 → 0.0.17

package/dist/{i18n.module-W8OJxg3d.mjs → i18n.module-Dn9SrFdS.mjs}

@@ -1,12 +1,13 @@
-import { S as ApplicationError, b as ERROR_CODES, o as I18N_TOKENS, s as Scope, v as ROUTER_TOKENS, y as getHttpStatus } from "./errors-CtCi1wn6.mjs";
-import { i as Transient, l as DI_TOKENS, n as __decorateParam, r as __decorateMetadata, s as getMethodInjections, t as __decorate } from "./decorate-D5j-d9_z.mjs";
-import { r as Module } from "./module-BgdxxzBe.mjs";
-import { i as getControllerRoute, r as getControllerOptions, t as MiddlewareConfigurationService } from "./middleware-C0Ebzswy.mjs";
-import { a as ROUTER_CONTEXT_KEYS, c as VERSION_NEUTRAL, i as METHOD_STATUS_CODES, n as DEFAULT_CONTENT_TYPE, o as ROUTE_METADATA_KEYS, r as HTTP_METHODS, s as SECURITY_SCHEMES, t as RouterContext } from "./router-context-BEJe9HEB.mjs";
-import { i as z, o as backendErrorMap, r as validation_exports, s as runWithErrorMapContext, t as OpenAPIHono } from "./validation-Bh875Lyg.mjs";
+import { S as ApplicationError, b as ERROR_CODES, o as I18N_TOKENS, s as Scope, v as ROUTER_TOKENS, y as getHttpStatus } from "./errors-DSKapqD8.mjs";
+import { a as __decorate, d as Transient, g as DI_TOKENS, m as getMethodInjections, o as __decorateParam, s as __decorateMetadata } from "./logger-CGT91VY6.mjs";
+import { r as Module } from "./module-tUtyVJ5E.mjs";
+import { i as getControllerRoute, r as getControllerOptions, t as MiddlewareConfigurationService } from "./middleware-Bl-b5pkt.mjs";
+import { a as ROUTER_CONTEXT_KEYS, c as VERSION_NEUTRAL, i as METHOD_STATUS_CODES, n as DEFAULT_CONTENT_TYPE, o as ROUTE_METADATA_KEYS, r as HTTP_METHODS, s as SECURITY_SCHEMES, t as RouterContext } from "./router-context-D9R1v2Ac.mjs";
+import { i as z, o as backendErrorMap, r as validation_exports, s as runWithErrorMapContext, t as OpenAPIHono } from "./validation-DQTC259A.mjs";
+import { n as OPENAPI_TOKENS } from "./openapi-tools.service-B3TxYKoQ.mjs";
 import { t as en_exports } from "./en-DaewN8hc.mjs";
 import { i as getMethodGuards, r as getControllerGuards, t as GuardExecutionService } from "./guards-DUk_Kzst.mjs";
-import { c as getWsOnMessageMethod, d as isGateway, o as getWsOnCloseMethod, s as getWsOnErrorMethod, t as GatewayContext } from "./gateway-context-BkZ4UKaX.mjs";
+import { c as getWsOnMessageMethod, d as isGateway, o as getWsOnCloseMethod, s as getWsOnErrorMethod, t as GatewayContext } from "./gateway-context-CNOLkLUC.mjs";
 import { inject } from "tsyringe";
 import { compile, createCoreContext, registerMessageCompiler, translate } from "@intlify/core-base";
 import { swaggerUI } from "@hono/swagger-ui";
@@ -65,16 +66,6 @@ LocaleExtractionMiddleware = __decorate([
 	__decorateMetadata("design:paramtypes", [Object])
 ], LocaleExtractionMiddleware);
 //#endregion
-//#region src/openapi/openapi.tokens.ts
-/**
-* OpenAPI Module DI Tokens
-*/
-const OPENAPI_TOKENS = {
-	Options: Symbol.for("stratal:openapi:options"),
-	ConfigService: Symbol.for("stratal:openapi:config:service"),
-	OpenAPIService: Symbol.for("stratal:openapi:service")
-};
-//#endregion
 //#region src/openapi/services/openapi-config.service.ts
 let OpenAPIConfigService = class OpenAPIConfigService {
 	overrides = [];
@@ -82,15 +73,13 @@ let OpenAPIConfigService = class OpenAPIConfigService {
 		this.baseOptions = baseOptions;
 	}
 	/**
-	* Add configuration override for this request
-	* Overrides are merged in the order they are added
+	* 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)
-	*/
+	/** Get effective configuration (base merged with all overrides) */
 	getEffectiveConfig() {
 		let effective = {
 			jsonPath: this.baseOptions?.jsonPath ?? "/api/openapi.json",
@@ -106,8 +95,8 @@ let OpenAPIConfigService = class OpenAPIConfigService {
 		return effective;
 	}
 	/**
-	* Merge override into effective config
-	* Info is shallow-merged, routeFilter is replaced
+	* Merge override into effective config.
+	* Info is shallow-merged, routeFilter is replaced.
 	*/
 	mergeConfig(base, override) {
 		return {
@@ -155,6 +144,52 @@ 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-registry.ts
+var _MessageRegistry;
+let MessageRegistry = class MessageRegistry {
+	static {
+		_MessageRegistry = this;
+	}
+	static contributions = [];
+	/**
+	* Add messages (called statically by I18nModule.registerMessages)
+	*/
+	static addMessages(messages) {
+		if (Boolean(messages) && typeof messages === "object" && Object.keys(messages).length > 0) _MessageRegistry.contributions.push(messages);
+	}
+	/**
+	* Get all messages deep-merged in registration order
+	*/
+	getMergedMessages() {
+		const merged = {};
+		for (const contribution of _MessageRegistry.contributions) for (const locale of Object.keys(contribution)) merged[locale] = deepMerge(merged[locale] ?? {}, contribution[locale]);
+		return merged;
+	}
+	/**
+	* Reset registry (for testing)
+	* @internal
+	*/
+	static reset() {
+		_MessageRegistry.contributions = [];
+	}
+};
+MessageRegistry = _MessageRegistry = __decorate([Transient(I18N_TOKENS.MessageRegistry)], MessageRegistry);
+//#endregion
 //#region src/i18n/setup.ts
 /**
 * I18n Setup - Message Compiler Registration
@@ -196,8 +231,7 @@ function resolveI18nOptions(options) {
 	return {
 		defaultLocale: options?.defaultLocale ?? "en",
 		fallbackLocale: options?.fallbackLocale ?? "en",
-		locales: options?.locales ?? ["en"],
-		messages: options?.messages ?? {}
+		locales: options?.locales ?? ["en"]
 	};
 }
 //#endregion
@@ -449,38 +483,46 @@ function getDecoratedMethods(ControllerClass) {
 //#region src/openapi/services/openapi.service.ts
 let OpenAPIService = class OpenAPIService {
 	routeInfoMap = /* @__PURE__ */ new Map();
-	constructor(configService) {
-		this.configService = configService;
+	/**
+	* 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);
+		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, controllers) {
+	setupEndpoints(app, controllers, container) {
 		this.buildRouteInfoMap(controllers);
-		const config = this.configService.getEffectiveConfig();
+		const config = container.resolve(OPENAPI_TOKENS.ConfigService).getEffectiveConfig();
 		app.get(config.jsonPath, (c) => {
 			const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
-			const i18n = requestContainer.resolve(I18N_TOKENS.I18nService);
-			const effectiveConfig = requestContainer.resolve(OPENAPI_TOKENS.ConfigService).getEffectiveConfig();
+			const fullSpec = this.getSpec(app, requestContainer);
 			const url = new URL(c.req.raw.url);
-			const fullSpec = app.getOpenAPIDocument({
-				openapi: "3.0.0",
-				info: {
-					version: effectiveConfig.info.version,
-					title: effectiveConfig.info.title,
-					description: effectiveConfig.info.description
-				},
-				servers: [{
-					url: `${url.protocol}//${url.host}`,
-					description: i18n.t("common.api.serverDescription")
-				}]
-			});
-			fullSpec.components ??= {};
-			fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n);
-			fullSpec.paths = this.filterRoutes(fullSpec.paths, effectiveConfig);
-			if (fullSpec.components.schemas) fullSpec.components.schemas = this.filterSchemas(fullSpec);
+			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;
@@ -493,8 +535,13 @@ let OpenAPIService = class OpenAPIService {
 				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
 	*/
@@ -561,11 +608,15 @@ let OpenAPIService = class OpenAPIService {
 		const filteredSchemas = {};
 		const components = spec.components;
 		if (components?.schemas) {
-			for (const [schemaName, schemaValue] of Object.entries(components.schemas)) if (referencedSchemas.has(schemaName)) {
-				filteredSchemas[schemaName] = schemaValue;
-				this.collectSchemaRefs(schemaValue, referencedSchemas);
+			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);
+				}
 			}
-			for (const [schemaName, schemaValue] of Object.entries(components.schemas)) if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) filteredSchemas[schemaName] = schemaValue;
 		}
 		return filteredSchemas;
 	}
@@ -583,11 +634,7 @@ let OpenAPIService = class OpenAPIService {
 		else for (const value of Object.values(record)) this.collectSchemaRefs(value, refs);
 	}
 };
-OpenAPIService = __decorate([
-	Transient(OPENAPI_TOKENS.OpenAPIService),
-	__decorateParam(0, inject(OPENAPI_TOKENS.ConfigService)),
-	__decorateMetadata("design:paramtypes", [Object])
-], OpenAPIService);
+OpenAPIService = __decorate([Transient(OPENAPI_TOKENS.OpenAPIService)], OpenAPIService);
 //#endregion
 //#region src/openapi/openapi.module.ts
 /**
@@ -681,7 +728,8 @@ OpenAPIModule = _OpenAPIModule = __decorate([Module({ providers: [{
 	scope: Scope.Request
 }, {
 	provide: OPENAPI_TOKENS.OpenAPIService,
-	useClass: OpenAPIService
+	useClass: OpenAPIService,
+	scope: Scope.Singleton
 }] })], OpenAPIModule);
 //#endregion
 //#region src/router/errors/controller-method-not-found.error.ts
@@ -1031,6 +1079,7 @@ var RouteRegistrationService = class {
 			if (onErrMethod) events.onError = bindWsHandler(onErrMethod);
 			return events;
 		});
+		this.nameHandler(wsHandler, GatewayClass.name, onMsgMethod ?? "[anonymous]", "ws");
 		this.logger.info("Registering WebSocket gateway", {
 			gateway: GatewayClass.name,
 			path: fullPath
@@ -1171,7 +1220,7 @@ var RouteRegistrationService = class {
 				methodName,
 				tags: metadata.tags
 			});
-			app.openapi(openApiRoute, async (c) => {
+			const handler = async (c) => {
 				const ctx = new RouterContext(c);
 				const requestContainer = ctx.getContainer();
 				const controller = requestContainer.resolve(ControllerClass);
@@ -1181,7 +1230,9 @@ var RouteRegistrationService = class {
 					return await method.call(controller, ctx, ...injectedArgs);
 				}
 				throw new ControllerMethodNotFoundError(methodName, className);
-			});
+			};
+			this.nameHandler(handler, className, methodName);
+			app.openapi(openApiRoute, handler);
 		}
 	}
 	/**
@@ -1231,7 +1282,7 @@ var RouteRegistrationService = class {
 				methodName,
 				tags: metadata.tags
 			});
-			app.openapi(openApiRoute, async (c) => {
+			const handler = async (c) => {
 				const ctx = new RouterContext(c);
 				const requestContainer = ctx.getContainer();
 				const controller = requestContainer.resolve(ControllerClass);
@@ -1241,7 +1292,9 @@ var RouteRegistrationService = class {
 					return await method.call(controller, ctx, ...injectedArgs);
 				}
 				throw new ControllerMethodNotFoundError(methodName, className);
-			});
+			};
+			this.nameHandler(handler, className, methodName);
+			app.openapi(openApiRoute, handler);
 		}
 	}
 	/**
@@ -1268,6 +1321,7 @@ var RouteRegistrationService = class {
 			}
 			throw new ControllerMethodNotFoundError(methodName, ControllerClass.name);
 		};
+		this.nameHandler(handler, ControllerClass.name, methodName);
 		switch (derived.method) {
 			case "get":
 				app.get(derived.path, handler);
@@ -1412,11 +1466,18 @@ var RouteRegistrationService = class {
 		return injections.map((inj) => container.resolve(inj.token));
 	}
 	/**
+	* Name a handler function so Hono's inspectRoutes() can identify it.
+	* Format: `{type}:{Controller}.{method}` (e.g. `http:UsersController.create`)
+	*/
+	nameHandler(fn, controller, method, type = "http") {
+		Object.defineProperty(fn, "name", { value: `${type}:${controller}.${method}` });
+	}
+	/**
 	* Create controller handler that resolves controller from request-scoped container
 	* This ensures each request gets a fresh controller with request-scoped context
 	*/
 	createControllerHandler(ControllerClass, methodName) {
-		return async (c) => {
+		const handler = async (c) => {
 			this.logger.info("Handler invoked", {
 				path: c.req.path,
 				method: c.req.method,
@@ -1443,6 +1504,8 @@ var RouteRegistrationService = class {
 				throw error;
 			}
 		};
+		this.nameHandler(handler, ControllerClass.name, methodName);
+		return handler;
 	}
 };
 //#endregion
@@ -1501,7 +1564,7 @@ var HonoApp = class extends OpenAPIHono {
 	async configure(middlewareConfigs, controllers, versioningOptions) {
 		if (this.configured) throw new HonoAppAlreadyConfiguredError();
 		new MiddlewareConfigurationService(this._logger, versioningOptions ?? null).applyMiddlewares(this, middlewareConfigs, controllers, this._container);
-		this._container.resolve(OPENAPI_TOKENS.OpenAPIService).setupEndpoints(this, controllers);
+		this._container.resolve(OPENAPI_TOKENS.OpenAPIService).setupEndpoints(this, controllers, this._container);
 		await new RouteRegistrationService(this._logger, versioningOptions ?? null).configure(this, controllers);
 		this.notFound((c) => {
 			throw new RouteNotFoundError(c.req.path, c.req.method);
@@ -1591,30 +1654,26 @@ let MessageLoaderService = class MessageLoaderService {
 	contextCache;
 	locales;
 	defaultLocale;
-	constructor(options) {
+	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 appMessages = this.options?.messages ?? {};
-		const appLocales = Object.keys(appMessages);
-		const allLocales = [...new Set([...coreLocales, ...appLocales])];
+		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 coreLocaleMessages = coreMessages[locale] ?? {};
-			const appLocaleMessages = appMessages[locale] ?? {};
-			const merged = this.deepMerge(coreLocaleMessages, appLocaleMessages);
+			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
-	*
-	* @param locale - Locale code
-	* @returns Cached CoreContext ready for translation
 	*/
 	getCoreContext(locale) {
 		const cached = this.contextCache.get(locale);
@@ -1634,47 +1693,27 @@ let MessageLoaderService = class MessageLoaderService {
 		return ctx;
 	}
 	/**
-	* Get messages for a specific locale
-	* Falls back to default locale if locale not found
-	*
-	* @param locale - Locale code
-	* @returns Message object for the locale
+	* Get messages for a specific locale.
+	* Falls back to default locale if not found.
 	*/
 	getMessages(locale) {
-		const msgs = this.cache.get(locale);
-		if (!msgs) return this.cache.get(this.defaultLocale) ?? {};
-		return msgs;
+		return this.cache.get(locale) ?? this.cache.get(this.defaultLocale) ?? {};
 	}
-	/**
-	* Get list of available locale codes
-	*
-	* @returns Array of locale codes
-	*/
+	/** Get list of available locale codes */
 	getAvailableLocales() {
 		return this.locales;
 	}
-	/**
-	* Check if a locale is supported
-	*
-	* @param locale - Locale code to check
-	* @returns true if locale is supported
-	*/
+	/** Check if a locale is supported */
 	isLocaleSupported(locale) {
 		return this.cache.has(locale);
 	}
-	/**
-	* Get default locale
-	*
-	* @returns Default locale code
-	*/
+	/** Get default locale */
 	getDefaultLocale() {
 		return this.defaultLocale;
 	}
 	/**
-	* Flatten nested messages to dot-notation
-	*
-	* Converts { auth: { login: { title: 'Sign In' } } }
-	* to { 'auth.login.title': 'Sign In' }
+	* Flatten nested messages to dot-notation.
+	* e.g. `{ a: { b: 'hello' } }` → `{ 'a.b': 'hello' }`
 	*/
 	flattenMessages(messages, prefix = "") {
 		const result = {};
@@ -1686,25 +1725,12 @@ let MessageLoaderService = class MessageLoaderService {
 		}
 		return result;
 	}
-	/**
-	* Deep merge two objects
-	* App messages override core messages at leaf level
-	*/
-	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] = this.deepMerge(targetValue, sourceValue);
-			else result[key] = sourceValue;
-		}
-		return result;
-	}
 };
 MessageLoaderService = __decorate([
 	Transient(I18N_TOKENS.MessageLoader),
-	__decorateParam(0, inject(I18N_TOKENS.Options, { isOptional: true })),
-	__decorateMetadata("design:paramtypes", [Object])
+	__decorateParam(0, inject(I18N_TOKENS.MessageRegistry)),
+	__decorateParam(1, inject(I18N_TOKENS.Options, { isOptional: true })),
+	__decorateMetadata("design:paramtypes", [Object, Object])
 ], MessageLoaderService);
 //#endregion
 //#region src/i18n/i18n.module.ts
@@ -1714,21 +1740,28 @@ MessageLoaderService = __decorate([
 * Core infrastructure module for internationalization.
 * Provides message translation and locale handling.
 *
-* @example Default usage (system messages only)
+* - `forRoot()` configures locale settings (call once in root module)
+* - `registerMessages()` adds translations (call from any module, as many times as needed)
+*
+* @example
 * ```typescript
-* // In Application.ts - I18nModule is already included in core modules
-* // Works with system messages and 'en' default locale
+* @Module({
+*   imports: [
+*     I18nModule.forRoot({ defaultLocale: 'en', locales: ['en', 'fr'] }),
+*     I18nModule.registerMessages(appMessages),
+*   ],
+* })
+* export class AppModule {}
 * ```
 *
-* @example With app-specific configuration
+* @example Package contributing messages
 * ```typescript
-* // In apps/backend/src/app.module.ts
-* import { i18nConfig } from './i18n'
-*
 * @Module({
-*   imports: [I18nModule.forRoot(i18nConfig)],
+*   imports: [
+*     I18nModule.registerMessages(tenancyMessages),
+*   ],
 * })
-* export class AppModule {}
+* export class TenancyModule {}
 * ```
 */
 var _I18nModule;
@@ -1736,30 +1769,12 @@ setupI18nCompiler();
 z.config({ customError: backendErrorMap });
 let I18nModule = _I18nModule = class I18nModule {
 	/**
-	* Configure I18n with app-specific options
-	*
-	* Use this method in AppModule to provide custom locale configuration
-	* and app-specific messages that merge with system messages.
+	* Configure I18n locale settings
 	*
-	* @param options - I18n configuration options
-	* @returns Dynamic module with options provider
+	* Call once in the root module. Does not accept messages —
+	* use `registerMessages()` to add translations.
 	*
-	* @example
-	* ```typescript
-	* // apps/backend/src/i18n/index.ts
-	* export const i18nConfig: I18nModuleOptions = {
-	*   defaultLocale: 'en',
-	*   fallbackLocale: 'en',
-	*   locales: ['en', 'fr'],
-	*   messages: appMessages
-	* }
-	*
-	* // apps/backend/src/app.module.ts
-	* @Module({
-	*   imports: [I18nModule.forRoot(i18nConfig)],
-	* })
-	* export class AppModule {}
-	* ```
+	* @param options - Locale configuration (defaultLocale, fallbackLocale, locales)
 	*/
 	static forRoot(options = {}) {
 		return {
@@ -1771,21 +1786,56 @@ let I18nModule = _I18nModule = class I18nModule {
 		};
 	}
 	/**
-	* Configure middleware for locale extraction and i18n context
+	* 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: []
+		};
+	}
 	configure(consumer) {
 		consumer.apply(LocaleExtractionMiddleware, I18nContextMiddleware).forRoutes("*");
 	}
 };
-I18nModule = _I18nModule = __decorate([Module({ providers: [{
-	provide: I18N_TOKENS.MessageLoader,
-	useClass: MessageLoaderService,
-	scope: Scope.Singleton
-}, {
-	provide: I18N_TOKENS.I18nService,
-	useClass: I18nService
-}] })], I18nModule);
+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 { LocaleNotSupportedError as A, Get as C, getHttpDecoratedMethods as D, Put as E, messages as F, OpenAPIConfigService as I, OPENAPI_TOKENS as L, setupI18nCompiler as M, getLocales as N, getHttpRouteMetadata as O, getMessages as P, LocaleExtractionMiddleware as R, Delete as S, Post as T, OpenAPIService as _, errorResponseSchema as a, getRouteConfig as b, successMessageSchema as c, RouteNotFoundError as d, OpenAPIValidationError as f, OpenAPIModule as g, HonoAppAlreadyConfiguredError as h, commonErrorSchemas as i, resolveI18nOptions as j, TranslationMissingError as k, uuidParamSchema as l, ControllerRegistrationError as m, HonoApp as n, paginatedResponseSchema as o, OpenAPIRouteRegistrationError as p, RouteRegistrationService as r, paginationQuerySchema as s, I18nModule as t, validationErrorResponseSchema as u, Route as v, Patch as w, All as x, getDecoratedMethods as y, I18nContextMiddleware as z };
+export { LocaleNotSupportedError as A, Get as C, getHttpDecoratedMethods as D, Put as E, getMessages as F, messages as I, OpenAPIConfigService as L, setupI18nCompiler as M, MessageRegistry as N, getHttpRouteMetadata as O, getLocales as P, LocaleExtractionMiddleware as R, Delete as S, Post as T, OpenAPIService as _, errorResponseSchema as a, getRouteConfig as b, successMessageSchema as c, RouteNotFoundError as d, OpenAPIValidationError as f, OpenAPIModule as g, HonoAppAlreadyConfiguredError as h, commonErrorSchemas as i, resolveI18nOptions as j, TranslationMissingError as k, uuidParamSchema as l, ControllerRegistrationError as m, HonoApp as n, paginatedResponseSchema as o, OpenAPIRouteRegistrationError as p, RouteRegistrationService as r, paginationQuerySchema as s, I18nModule as t, validationErrorResponseSchema as u, Route as v, Patch as w, All as x, getDecoratedMethods as y, I18nContextMiddleware as z };
 
-//# sourceMappingURL=i18n.module-W8OJxg3d.mjs.map
+//# sourceMappingURL=i18n.module-Dn9SrFdS.mjs.map