stratal 0.0.27 → 0.1.0

package/dist/locale-path.service-BqzDIrgy.mjs

@@ -0,0 +1,213 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { C as ROUTER_TOKENS, l as Singleton, n as CONTAINER_TOKEN, p as inject } from "./di-DQ3xbjgf.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-C79yt3Wt.mjs";
+import { l as ROUTER_CONTEXT_KEYS } from "./exception-context-CdnGTQNF.mjs";
+import { t as I18N_TOKENS } from "./i18n.tokens-CZ_v8oyS.mjs";
+import { languageDetector } from "hono/language";
+//#region src/i18n/i18n.options.ts
+/** The cookie (and query-string key) the `locale` is read from / written to. */
+const LOCALE_COOKIE = "locale";
+/** Apply defaults to a single {@link LanguageDetectionOptions}. */
+function resolveDetectionOptions(detection) {
+	return {
+		enabled: detection ? detection.enabled !== false : true,
+		strategy: detection && "strategy" in detection ? detection.strategy ?? "cookie" : "cookie",
+		prefixDefaultLocale: detection && "prefixDefaultLocale" in detection && detection.prefixDefaultLocale !== void 0 ? detection.prefixDefaultLocale : false,
+		cookieOptions: detection && "cookieOptions" in detection ? detection.cookieOptions : void 0
+	};
+}
+/**
+* Resolve the detection options for a given request path, evaluating the
+* per-path resolver when `detection` is a function.
+*/
+function resolveDetectionForPath(detection, path) {
+	return resolveDetectionOptions(typeof detection === "function" ? detection(path) : detection);
+}
+/**
+* Resolve I18n options with defaults. `detection` reflects the application root
+* (`/`); use {@link resolveDetectionForPath} for per-path detail.
+*/
+function resolveI18nOptions(options) {
+	return {
+		defaultLocale: options?.defaultLocale ?? "en",
+		fallbackLocale: options?.fallbackLocale ?? "en",
+		locales: options?.locales ?? ["en"],
+		detection: resolveDetectionForPath(options?.detection, "/")
+	};
+}
+/**
+* Build Hono languageDetector options for a resolved detection + locale config.
+*
+* Cookie strategy persists the detected locale to the `locale` cookie
+* (`caches: ['cookie']`) using the resolved `cookieOptions` — so a per-path
+* cookie area scopes the write (e.g. `{ path: '/admin' }`) instead of writing
+* at the default `Path=/` and leaking across the app. Other strategies don't
+* write any cookie.
+*/
+function buildDetectorOptions(detection, locales, defaultLocale) {
+	const detectorOptions = {
+		order: [detection.strategy],
+		fallbackLanguage: defaultLocale,
+		supportedLanguages: locales,
+		lookupCookie: LOCALE_COOKIE,
+		lookupQueryString: LOCALE_COOKIE,
+		lookupFromPathIndex: 0,
+		ignoreCase: true
+	};
+	if (detection.strategy === "cookie") {
+		detectorOptions.caches = ["cookie"];
+		if (detection.cookieOptions) detectorOptions.cookieOptions = detection.cookieOptions;
+	} else detectorOptions.caches = false;
+	return detectorOptions;
+}
+//#endregion
+//#region src/router/services/locale-path.service.ts
+var locale_path_service_exports = /* @__PURE__ */ __exportAll({ LocalePathService: () => LocalePathService });
+let LocalePathService = class LocalePathService {
+	honoApp;
+	_locales;
+	_defaultLocale;
+	_detection;
+	/** Detection + config resolved at the application root (`/`) — the primary mode. */
+	_primary;
+	_primaryConfig;
+	constructor(container, honoApp) {
+		this.honoApp = honoApp;
+		const i18nOptions = container.isRegistered(I18N_TOKENS.Options) ? container.resolve(I18N_TOKENS.Options) : void 0;
+		this._locales = i18nOptions?.locales ?? ["en"];
+		this._defaultLocale = i18nOptions?.defaultLocale ?? "en";
+		this._detection = i18nOptions?.detection;
+		this._primary = resolveDetectionForPath(this._detection, "/");
+		this._primaryConfig = this.buildConfig(this._primary);
+		if (typeof this._detection === "function" || this._primary.enabled) this.setupLanguageDetection();
+		if (this._primaryConfig?.defaultLocale && this._primary.prefixDefaultLocale === "redirect") this.setupDefaultLocaleRedirect(this._primaryConfig.defaultLocale);
+	}
+	/** Whether the app uses path-based locale URLs (resolved at the root). */
+	get enabled() {
+		return this._primaryConfig !== null;
+	}
+	/** The primary (root) locale path config, or null if the root isn't path-localized. */
+	get localePathConfig() {
+		return this._primaryConfig;
+	}
+	/** The primary (root) prefixDefaultLocale setting (false, true, or 'redirect'). */
+	get prefixDefaultLocale() {
+		return this._primary.prefixDefaultLocale;
+	}
+	/** Resolve the detection options for a given request path. */
+	detectionFor(path) {
+		return resolveDetectionForPath(this._detection, path);
+	}
+	/**
+	* Whether a pathname is path-localized — served with a `/:locale` segment.
+	* `false` for paths resolving to a non-`path` strategy (localized by cookie)
+	* or with detection disabled. Redirect middleware should skip non-localized
+	* paths so it never prepends a locale segment.
+	*/
+	isPathLocalized(pathname) {
+		return this.buildConfig(this.detectionFor(pathname)) !== null;
+	}
+	/**
+	* Expand a path into primary + locale-prefixed variants.
+	*
+	* @param path - The base route path to expand
+	* @returns Array of resolved paths with locale metadata
+	*/
+	resolve(path) {
+		const config = this.buildConfig(this.detectionFor(path));
+		if (!config) return [{
+			path,
+			isLocaleVariant: false
+		}];
+		const constraint = `{(?:${(config.defaultLocale === null ? config.allLocales : config.prefixedLocales).join("|")})}`;
+		const suffix = path === "/" ? "" : path;
+		if (config.defaultLocale === null) return [{
+			path: `/:locale${constraint}${suffix}`,
+			isLocaleVariant: true
+		}];
+		const result = [{
+			path,
+			isLocaleVariant: false
+		}];
+		if (config.prefixedLocales.length > 0) result.push({
+			path: `/:locale${constraint}${suffix}`,
+			isLocaleVariant: true
+		});
+		return result;
+	}
+	/** Build the locale path config for a resolved detection, or null if not path-localized. */
+	buildConfig(detection) {
+		if (!detection.enabled || detection.strategy !== "path") return null;
+		const allLocales = this._locales;
+		const defaultLocale = this._defaultLocale;
+		return detection.prefixDefaultLocale === true ? {
+			allLocales,
+			prefixedLocales: allLocales,
+			defaultLocale: null
+		} : {
+			allLocales,
+			prefixedLocales: allLocales.filter((l) => l !== defaultLocale),
+			defaultLocale
+		};
+	}
+	/**
+	* Apply Hono's languageDetector and bridge the detected language to Stratal's
+	* LOCALE context variable. With a per-path resolver, the detector is chosen
+	* per request (cached by strategy); with a static config, one detector is
+	* built up front.
+	*/
+	setupLanguageDetection() {
+		const buildDetector = (detection) => languageDetector(buildDetectorOptions(detection, this._locales, this._defaultLocale));
+		let detector;
+		if (typeof this._detection === "function") {
+			const resolver = this._detection;
+			const cache = /* @__PURE__ */ new Map();
+			const detectorFor = (detection) => {
+				const key = `${detection.strategy}:${JSON.stringify(detection.cookieOptions ?? {})}`;
+				let d = cache.get(key);
+				if (!d) {
+					d = buildDetector(detection);
+					cache.set(key, d);
+				}
+				return d;
+			};
+			detector = (c, next) => {
+				const detection = resolveDetectionForPath(resolver, new URL(c.req.url).pathname);
+				if (!detection.enabled) return next();
+				return detectorFor(detection)(c, next);
+			};
+		} else detector = buildDetector(this._primary);
+		this.honoApp.use("*", detector);
+		this.honoApp.use("*", async (c, next) => {
+			const language = c.get("language");
+			if (language) c.set(ROUTER_CONTEXT_KEYS.LOCALE, language);
+			await next();
+		});
+	}
+	/**
+	* Redirect requests that include the default locale prefix to the unprefixed path.
+	* For example, `/en/users` → 301 redirect to `/users`.
+	*
+	* Only active when the root `prefixDefaultLocale` is `'redirect'`.
+	*/
+	setupDefaultLocaleRedirect(defaultLocale) {
+		const prefix = `/${defaultLocale}`;
+		this.honoApp.use("*", async (c, next) => {
+			const path = new URL(c.req.url).pathname;
+			if (path === prefix || path.startsWith(`${prefix}/`)) {
+				const stripped = path.slice(prefix.length) || "/";
+				return c.redirect(stripped, 301);
+			}
+			await next();
+		});
+	}
+};
+LocalePathService = __decorate([
+	Singleton(),
+	__decorateParam(0, inject(CONTAINER_TOKEN)),
+	__decorateParam(1, inject(ROUTER_TOKENS.HonoApp))
+], LocalePathService);
+//#endregion
+export { resolveDetectionForPath as a, buildDetectorOptions as i, locale_path_service_exports as n, resolveI18nOptions as o, LOCALE_COOKIE as r, LocalePathService as t };
+
+//# sourceMappingURL=locale-path.service-BqzDIrgy.mjs.map

package/dist/locale-path.service-BqzDIrgy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-path.service-BqzDIrgy.mjs","names":[],"sources":["../src/i18n/i18n.options.ts","../src/router/services/locale-path.service.ts"],"sourcesContent":["/**\n * I18n Module Options\n *\n * Configuration options for the I18n dynamic module.\n * Use with I18nModule.forRoot() / forRootAsync() to configure locale settings.\n * Use I18nModule.registerMessages() to add translations.\n */\n\nimport type { DetectorOptions } from 'hono/language';\n\n/**\n * Detection strategy for locale resolution\n *\n * - `'cookie'` — reads from the `locale` cookie (default)\n * - `'header'` — reads from the `Accept-Language` header\n * - `'querystring'` — reads from the `?locale=` query parameter\n * - `'path'` — reads from the first URL path segment (e.g., `/en/api/users`)\n */\nexport type DetectionStrategy = 'cookie' | 'header' | 'querystring' | 'path'\n\n/** The cookie (and query-string key) the `locale` is read from / written to. */\nexport const LOCALE_COOKIE = 'locale'\n\ninterface BaseDetection {\n  /** Set to false to disable language detection entirely. @default true */\n  enabled?: boolean\n}\n\n/**\n * Language detection options (discriminated by strategy)\n *\n * @example Cookie detection (default)\n * ```typescript\n * { strategy: 'cookie' }\n * ```\n *\n * @example Header detection\n * ```typescript\n * { strategy: 'header' }\n * ```\n *\n * @example Path detection\n * ```typescript\n * { strategy: 'path' }\n * ```\n *\n * @example Disable detection\n * ```typescript\n * { enabled: false }\n * ```\n */\nexport type LanguageDetectionOptions =\n  | (BaseDetection & { strategy?: 'cookie'; cookieOptions?: DetectorOptions['cookieOptions'] })\n  | (BaseDetection & { strategy: 'header' })\n  | (BaseDetection & { strategy: 'querystring' })\n  | (BaseDetection & {\n    strategy: 'path'\n    /**\n     * Controls whether the default locale gets a URL path prefix.\n     *\n     * - `false` (default) — The default locale has no prefix (`/users`), other locales\n     *   are prefixed (`/fr/users`). Requests to the prefixed default locale (`/en/users`) return 404.\n     * - `'redirect'` — Same as `false`, but requests to the prefixed default locale\n     *   (`/en/users`) are 301-redirected to the unprefixed path (`/users`).\n     * - `true` — All locales are prefixed (`/en/users`, `/fr/users`).\n     *\n     * @default false\n     */\n    prefixDefaultLocale?: false | true | 'redirect'\n  })\n  | { enabled: false }\n\n/**\n * A per-path detection resolver.\n *\n * Returns the detection options for a given request path. It **must be a pure\n * function of the path**: route `/:locale` variant expansion runs it at boot,\n * once per registered route pattern, where no request exists — so the decision\n * (e.g. \"`/admin` is cookie-localized, everything else is path-localized\") has\n * to be derivable from the path alone, and must agree at boot and per request.\n *\n * @example\n * ```typescript\n * detection: (path) =>\n *   path.startsWith('/admin')\n *     ? { strategy: 'cookie', cookieOptions: { path: '/admin' } }\n *     : { strategy: 'path' }\n * ```\n */\nexport type DetectionResolver = (path: string) => LanguageDetectionOptions\n\n/** Detection config: a single static option set, or a per-path resolver. */\nexport type DetectionConfig = LanguageDetectionOptions | DetectionResolver\n\n/**\n * Options for configuring the I18n module\n *\n * @example\n * ```typescript\n * I18nModule.forRoot({\n *   defaultLocale: 'en',\n *   fallbackLocale: 'en',\n *   locales: ['en', 'fr'],\n *   detection: { strategy: 'header' },\n * })\n * ```\n */\nexport interface I18nModuleOptions {\n  /**\n   * Default locale for the application\n   * @default 'en'\n   */\n  defaultLocale?: string\n\n  /**\n   * Fallback locale when translation is missing\n   * @default 'en'\n   */\n  fallbackLocale?: string\n\n  /**\n   * List of supported locales\n   * Request locales not in this list will fall back to defaultLocale\n   */\n  locales?: string[]\n\n  /**\n   * Language detection configuration. Either a single option set applied to\n   * every request, or a {@link DetectionResolver} — a pure function of the\n   * request path — so different areas can use different strategies (e.g. a\n   * path-localized public site with a cookie-localized `/admin` panel).\n   */\n  detection?: DetectionConfig\n}\n\n/**\n * Detection options resolved for a single path (all defaults applied).\n */\nexport interface ResolvedDetection {\n  enabled: boolean\n  strategy: DetectionStrategy\n  /** Only meaningful when `strategy` is `'path'`. */\n  prefixDefaultLocale: false | true | 'redirect'\n  /**\n   * Cookie attributes for the persisted `locale` cookie under cookie strategy\n   * (e.g. `{ path: '/admin' }` to scope a panel's locale so it isn't written at\n   * the default `Path=/`).\n   */\n  cookieOptions?: DetectorOptions['cookieOptions']\n}\n\n/**\n * Resolved options with all defaults applied\n * Used internally by I18n services\n */\nexport interface ResolvedI18nOptions {\n  defaultLocale: string\n  fallbackLocale: string\n  locales: string[]\n  /**\n   * Detection resolved at the application root (`/`) — the app's primary mode.\n   * For per-path detail (when `detection` is a resolver) use\n   * {@link resolveDetectionForPath}.\n   */\n  detection: ResolvedDetection\n}\n\n/** Apply defaults to a single {@link LanguageDetectionOptions}. */\nfunction resolveDetectionOptions(detection: LanguageDetectionOptions | undefined): ResolvedDetection {\n  const enabled = detection ? detection.enabled !== false : true\n  const strategy: DetectionStrategy = (detection && 'strategy' in detection) ? detection.strategy ?? 'cookie' : 'cookie'\n  const prefixDefaultLocale: false | true | 'redirect' =\n    (detection && 'prefixDefaultLocale' in detection && detection.prefixDefaultLocale !== undefined)\n      ? detection.prefixDefaultLocale\n      : false\n  const cookieOptions = (detection && 'cookieOptions' in detection) ? detection.cookieOptions : undefined\n  return { enabled, strategy, prefixDefaultLocale, cookieOptions }\n}\n\n/**\n * Resolve the detection options for a given request path, evaluating the\n * per-path resolver when `detection` is a function.\n */\nexport function resolveDetectionForPath(detection: DetectionConfig | undefined, path: string): ResolvedDetection {\n  return resolveDetectionOptions(typeof detection === 'function' ? detection(path) : detection)\n}\n\n/**\n * Resolve I18n options with defaults. `detection` reflects the application root\n * (`/`); use {@link resolveDetectionForPath} for per-path detail.\n */\nexport function resolveI18nOptions(options?: I18nModuleOptions): ResolvedI18nOptions {\n  return {\n    defaultLocale: options?.defaultLocale ?? 'en',\n    fallbackLocale: options?.fallbackLocale ?? 'en',\n    locales: options?.locales ?? ['en'],\n    detection: resolveDetectionForPath(options?.detection, '/'),\n  }\n}\n\n/**\n * Build Hono languageDetector options for a resolved detection + locale config.\n *\n * Cookie strategy persists the detected locale to the `locale` cookie\n * (`caches: ['cookie']`) using the resolved `cookieOptions` — so a per-path\n * cookie area scopes the write (e.g. `{ path: '/admin' }`) instead of writing\n * at the default `Path=/` and leaking across the app. Other strategies don't\n * write any cookie.\n */\nexport function buildDetectorOptions(\n  detection: ResolvedDetection,\n  locales: string[],\n  defaultLocale: string,\n): Partial<DetectorOptions> {\n  const detectorOptions: Partial<DetectorOptions> = {\n    order: [detection.strategy],\n    fallbackLanguage: defaultLocale,\n    supportedLanguages: locales,\n    lookupCookie: LOCALE_COOKIE,\n    lookupQueryString: LOCALE_COOKIE,\n    lookupFromPathIndex: 0,\n    ignoreCase: true,\n  }\n\n  if (detection.strategy === 'cookie') {\n    detectorOptions.caches = ['cookie']\n    if (detection.cookieOptions) {\n      detectorOptions.cookieOptions = detection.cookieOptions\n    }\n  } else {\n    detectorOptions.caches = false\n  }\n\n  return detectorOptions\n}\n","import type { Context, MiddlewareHandler } from 'hono'\nimport { languageDetector } from 'hono/language'\nimport { inject } from '../../di'\nimport type { Container } from '../../di/container'\nimport { Singleton } from '../../di/decorators'\nimport { CONTAINER_TOKEN } from '../../di/tokens'\nimport {\n  buildDetectorOptions,\n  type DetectionConfig,\n  type I18nModuleOptions,\n  type ResolvedDetection,\n  resolveDetectionForPath,\n} from '../../i18n/i18n.options'\nimport { I18N_TOKENS } from '../../i18n/i18n.tokens'\nimport { ROUTER_CONTEXT_KEYS } from '../constants'\nimport type { HonoApp } from '../hono-app'\nimport { ROUTER_TOKENS } from '../router.tokens'\nimport type { LocalePathConfig, RouterEnv } from '../types'\n\n/**\n * A resolved path with locale variant metadata.\n */\nexport interface ResolvedPath {\n  /** The fully resolved path (may include /:locale prefix) */\n  path: string\n  /** Whether this path is a locale-prefixed variant */\n  isLocaleVariant: boolean\n}\n\n/**\n * Resolves locale path variants for route paths.\n *\n * Detection can be static or a per-path resolver (see {@link DetectionConfig}),\n * so this evaluates it **per path**: which routes get a `/:locale` variant\n * (at registration) and which detector runs (per request). A path resolving to\n * a non-`path` strategy gets no variant and is localized out-of-band (cookie).\n *\n * Also applies language detection and default-locale redirect middleware to\n * HonoApp when resolved from the container. Registered as a singleton.\n */\n@Singleton()\nexport class LocalePathService {\n  private readonly _locales: string[]\n  private readonly _defaultLocale: string\n  private readonly _detection: DetectionConfig | undefined\n  /** Detection + config resolved at the application root (`/`) — the primary mode. */\n  private readonly _primary: ResolvedDetection\n  private readonly _primaryConfig: LocalePathConfig | null\n\n  constructor(\n    @inject(CONTAINER_TOKEN) container: Container,\n    @inject(ROUTER_TOKENS.HonoApp) private readonly honoApp: HonoApp,\n  ) {\n    const i18nOptions = container.isRegistered(I18N_TOKENS.Options)\n      ? container.resolve<I18nModuleOptions>(I18N_TOKENS.Options)\n      : undefined\n\n    this._locales = i18nOptions?.locales ?? ['en']\n    this._defaultLocale = i18nOptions?.defaultLocale ?? 'en'\n    this._detection = i18nOptions?.detection\n    this._primary = resolveDetectionForPath(this._detection, '/')\n    this._primaryConfig = this.buildConfig(this._primary)\n\n    // Install detection: always when `detection` is a resolver (it decides\n    // per request), otherwise only when the static config keeps it enabled.\n    if (typeof this._detection === 'function' || this._primary.enabled) {\n      this.setupLanguageDetection()\n    }\n    if (this._primaryConfig?.defaultLocale && this._primary.prefixDefaultLocale === 'redirect') {\n      this.setupDefaultLocaleRedirect(this._primaryConfig.defaultLocale)\n    }\n  }\n\n  /** Whether the app uses path-based locale URLs (resolved at the root). */\n  get enabled(): boolean {\n    return this._primaryConfig !== null\n  }\n\n  /** The primary (root) locale path config, or null if the root isn't path-localized. */\n  get localePathConfig(): LocalePathConfig | null {\n    return this._primaryConfig\n  }\n\n  /** The primary (root) prefixDefaultLocale setting (false, true, or 'redirect'). */\n  get prefixDefaultLocale(): false | true | 'redirect' {\n    return this._primary.prefixDefaultLocale\n  }\n\n  /** Resolve the detection options for a given request path. */\n  detectionFor(path: string): ResolvedDetection {\n    return resolveDetectionForPath(this._detection, path)\n  }\n\n  /**\n   * Whether a pathname is path-localized — served with a `/:locale` segment.\n   * `false` for paths resolving to a non-`path` strategy (localized by cookie)\n   * or with detection disabled. Redirect middleware should skip non-localized\n   * paths so it never prepends a locale segment.\n   */\n  isPathLocalized(pathname: string): boolean {\n    return this.buildConfig(this.detectionFor(pathname)) !== null\n  }\n\n  /**\n   * Expand a path into primary + locale-prefixed variants.\n   *\n   * @param path - The base route path to expand\n   * @returns Array of resolved paths with locale metadata\n   */\n  resolve(path: string): ResolvedPath[] {\n    const config = this.buildConfig(this.detectionFor(path))\n    if (!config) {\n      // Not path-localized → no `/:locale` variant; served at the bare path.\n      return [{ path, isLocaleVariant: false }]\n    }\n\n    const constraintLocales = config.defaultLocale === null ? config.allLocales : config.prefixedLocales\n    // Wrap the alternation in a non-capturing group. An unparenthesised\n    // `:locale{en|fr}` leaks the `|` boundary in Hono's RegExpRouter, so the\n    // single-segment locale param greedily swallows multi-segment paths\n    // (`/en/foo/bar` matches `/:locale{en|fr}` instead of `/:locale{en|fr}/:rest`).\n    // Grouping keeps the alternation a single token; a lone locale (no `|`) is\n    // an identical no-op group, so it's grouped too for a uniform pattern.\n    const constraint = `{(?:${constraintLocales.join('|')})}`\n    const suffix = path === '/' ? '' : path\n\n    // All locales prefixed (prefixDefaultLocale: true)\n    if (config.defaultLocale === null) {\n      return [{ path: `/:locale${constraint}${suffix}`, isLocaleVariant: true }]\n    }\n\n    // Default locale unprefixed, other locales prefixed\n    const result: ResolvedPath[] = [{ path, isLocaleVariant: false }]\n\n    // Only add /:locale route when there are non-default locales to match\n    // (z.enum requires at least one value)\n    if (config.prefixedLocales.length > 0) {\n      result.push({ path: `/:locale${constraint}${suffix}`, isLocaleVariant: true })\n    }\n\n    return result\n  }\n\n  /** Build the locale path config for a resolved detection, or null if not path-localized. */\n  private buildConfig(detection: ResolvedDetection): LocalePathConfig | null {\n    if (!detection.enabled || detection.strategy !== 'path') return null\n    const allLocales = this._locales\n    const defaultLocale = this._defaultLocale\n    return detection.prefixDefaultLocale === true\n      ? { allLocales, prefixedLocales: allLocales, defaultLocale: null }\n      : { allLocales, prefixedLocales: allLocales.filter(l => l !== defaultLocale), defaultLocale }\n  }\n\n  /**\n   * Apply Hono's languageDetector and bridge the detected language to Stratal's\n   * LOCALE context variable. With a per-path resolver, the detector is chosen\n   * per request (cached by strategy); with a static config, one detector is\n   * built up front.\n   */\n  private setupLanguageDetection(): void {\n    const buildDetector = (detection: ResolvedDetection): MiddlewareHandler<RouterEnv> =>\n      languageDetector(buildDetectorOptions(detection, this._locales, this._defaultLocale)) as MiddlewareHandler<RouterEnv>\n\n    let detector: MiddlewareHandler<RouterEnv>\n    if (typeof this._detection === 'function') {\n      const resolver = this._detection\n      // Memoize by strategy + cookie write options (which can both differ per\n      // path) — a resolver typically returns only a handful of distinct configs.\n      const cache = new Map<string, MiddlewareHandler<RouterEnv>>()\n      const detectorFor = (detection: ResolvedDetection): MiddlewareHandler<RouterEnv> => {\n        const key = `${detection.strategy}:${JSON.stringify(detection.cookieOptions ?? {})}`\n        let d = cache.get(key)\n        if (!d) {\n          d = buildDetector(detection)\n          cache.set(key, d)\n        }\n        return d\n      }\n      detector = (c, next) => {\n        const detection = resolveDetectionForPath(resolver, new URL(c.req.url).pathname)\n        if (!detection.enabled) return next()\n        return detectorFor(detection)(c, next)\n      }\n    } else {\n      detector = buildDetector(this._primary)\n    }\n\n    this.honoApp.use('*', detector)\n\n    // Bridge: sync Hono's 'language' variable to Stratal's LOCALE context key\n    this.honoApp.use('*', async (c: Context<RouterEnv>, next: () => Promise<void>) => {\n      const language = c.get('language')\n      if (language) {\n        c.set(ROUTER_CONTEXT_KEYS.LOCALE, language)\n      }\n      await next()\n    })\n  }\n\n  /**\n   * Redirect requests that include the default locale prefix to the unprefixed path.\n   * For example, `/en/users` → 301 redirect to `/users`.\n   *\n   * Only active when the root `prefixDefaultLocale` is `'redirect'`.\n   */\n  private setupDefaultLocaleRedirect(defaultLocale: string): void {\n    const prefix = `/${defaultLocale}`\n    this.honoApp.use('*', async (c: Context<RouterEnv>, next: () => Promise<void>) => {\n      const path = new URL(c.req.url).pathname\n      if (path === prefix || path.startsWith(`${prefix}/`)) {\n        const stripped = path.slice(prefix.length) || '/'\n        return c.redirect(stripped, 301)\n      }\n      await next()\n    })\n  }\n}\n"],"mappings":"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"}

package/dist/locale-url-nZrZxqJP.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"locale-url-nZrZxqJP.mjs","names":[],"sources":["../src/router/locale-url.ts"],"sourcesContent":["import type { LocaleUrlConfig } from './types'\n\n/**\n * Pure helpers for locale-aware URL path manipulation.\n *\n * Each function takes config explicitly so it can run anywhere (no DI, no request\n * context). For ergonomic DI-driven access, see {@link LocaleUrlService} which\n * binds these to the resolved {@link LocalePathService} config.\n */\n\n/**\n * Whether a locale should be URL-prefixed under the given config.\n *\n * - No config → always prefix (caller didn't opt into locale-aware URLs).\n * - `prefixDefaultLocale: true` → every locale, including the default, is prefixed.\n * - Otherwise → only non-default locales are prefixed.\n */\nexport function shouldPrefixLocale(locale: string, config: LocaleUrlConfig | undefined): boolean {\n  if (!config) return true\n  if (config.prefixDefaultLocale === true) return true\n  return locale !== config.defaultLocale\n}\n\n/**\n * Prepend `/{locale}` to a pathname, respecting `prefixDefaultLocale`.\n * Returns the pathname unchanged when the locale shouldn't be prefixed.\n */\nexport function applyLocalePrefix(pathname: string, locale: string, config: LocaleUrlConfig | undefined): string {\n  if (!shouldPrefixLocale(locale, config)) return pathname\n  return pathname === '/' ? `/${locale}` : `/${locale}${pathname}`\n}\n\n/**\n * Strip a known-locale prefix from the start of a pathname.\n * Returns the pathname unchanged if the first segment isn't in `knownLocales`.\n */\nexport function stripLocalePrefix(pathname: string, knownLocales: readonly string[]): string {\n  const segments = pathname.split('/').filter(Boolean)\n  if (segments.length > 0 && knownLocales.includes(segments[0])) {\n    const rest = segments.slice(1).join('/')\n    return rest ? `/${rest}` : '/'\n  }\n  return pathname\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,QAAgB,QAA8C;CAC/F,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,wBAAwB,MAAM,OAAO;CAChD,OAAO,WAAW,OAAO;AAC3B;;;;;AAMA,SAAgB,kBAAkB,UAAkB,QAAgB,QAA6C;CAC/G,IAAI,CAAC,mBAAmB,QAAQ,MAAM,GAAG,OAAO;CAChD,OAAO,aAAa,MAAM,IAAI,WAAW,IAAI,SAAS;AACxD;;;;;AAMA,SAAgB,kBAAkB,UAAkB,cAAyC;CAC3F,MAAM,WAAW,SAAS,MAAM,GAAG,EAAE,OAAO,OAAO;CACnD,IAAI,SAAS,SAAS,KAAK,aAAa,SAAS,SAAS,EAAE,GAAG;EAC7D,MAAM,OAAO,SAAS,MAAM,CAAC,EAAE,KAAK,GAAG;EACvC,OAAO,OAAO,IAAI,SAAS;CAC7B;CACA,OAAO;AACT"}
+{"version":3,"file":"locale-url-nZrZxqJP.mjs","names":[],"sources":["../src/router/locale-url.ts"],"sourcesContent":["import type { LocaleUrlConfig } from './types'\n\n/**\n * Pure helpers for locale-aware URL path manipulation.\n *\n * Each function takes config explicitly so it can run anywhere (no DI, no request\n * context). For ergonomic DI-driven access, see {@link LocaleUrlService} which\n * binds these to the resolved {@link LocalePathService} config.\n */\n\n/**\n * Whether a locale should be URL-prefixed under the given config.\n *\n * - No config → always prefix (caller didn't opt into locale-aware URLs).\n * - `prefixDefaultLocale: true` → every locale, including the default, is prefixed.\n * - Otherwise → only non-default locales are prefixed.\n */\nexport function shouldPrefixLocale(locale: string, config: LocaleUrlConfig | undefined): boolean {\n  if (!config) return true\n  if (config.prefixDefaultLocale === true) return true\n  return locale !== config.defaultLocale\n}\n\n/**\n * Prepend `/{locale}` to a pathname, respecting `prefixDefaultLocale`.\n * Returns the pathname unchanged when the locale shouldn't be prefixed.\n */\nexport function applyLocalePrefix(pathname: string, locale: string, config: LocaleUrlConfig | undefined): string {\n  if (!shouldPrefixLocale(locale, config)) return pathname\n  return pathname === '/' ? `/${locale}` : `/${locale}${pathname}`\n}\n\n/**\n * Strip a known-locale prefix from the start of a pathname.\n * Returns the pathname unchanged if the first segment isn't in `knownLocales`.\n */\nexport function stripLocalePrefix(pathname: string, knownLocales: readonly string[]): string {\n  const segments = pathname.split('/').filter(Boolean)\n  if (segments.length > 0 && knownLocales.includes(segments[0])) {\n    const rest = segments.slice(1).join('/')\n    return rest ? `/${rest}` : '/'\n  }\n  return pathname\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,QAAgB,QAA8C;CAC/F,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,wBAAwB,MAAM,OAAO;CAChD,OAAO,WAAW,OAAO;AAC3B;;;;;AAMA,SAAgB,kBAAkB,UAAkB,QAAgB,QAA6C;CAC/G,IAAI,CAAC,mBAAmB,QAAQ,MAAM,GAAG,OAAO;CAChD,OAAO,aAAa,MAAM,IAAI,WAAW,IAAI,SAAS;AACxD;;;;;AAMA,SAAgB,kBAAkB,UAAkB,cAAyC;CAC3F,MAAM,WAAW,SAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO;CACnD,IAAI,SAAS,SAAS,KAAK,aAAa,SAAS,SAAS,EAAE,GAAG;EAC7D,MAAM,OAAO,SAAS,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;EACvC,OAAO,OAAO,IAAI,SAAS;CAC7B;CACA,OAAO;AACT"}

package/dist/{locale-url.service-6bgia24_.mjs → locale-url.service-H8PH6GGh.mjs}

@@ -1,6 +1,6 @@
-import { t as __exportAll } from "./chunk-BBjsoOtd.mjs";
-import { b as ROUTER_TOKENS, l as Singleton, p as inject } from "./di-D7qmrAir.mjs";
-import { n as __decorateParam, t as __decorate } from "./decorate-CuAoSZvs.mjs";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { C as ROUTER_TOKENS, l as Singleton, p as inject } from "./di-DQ3xbjgf.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-C79yt3Wt.mjs";
 import { n as shouldPrefixLocale, r as stripLocalePrefix, t as applyLocalePrefix } from "./locale-url-nZrZxqJP.mjs";
 //#region src/router/services/locale-url.service.ts
 var locale_url_service_exports = /* @__PURE__ */ __exportAll({ LocaleUrlService: () => LocaleUrlService });
@@ -23,7 +23,17 @@ let LocaleUrlService = class LocaleUrlService {
 	}
 	/** Strip a known-locale prefix from the start of a pathname. */
 	stripPrefix(pathname) {
-		return stripLocalePrefix(pathname, this.localePath.localePathConfig?.allLocales ?? []);
+		const known = this.localePath.localePathConfig?.allLocales ?? [];
+		return stripLocalePrefix(pathname, known);
+	}
+	/**
+	* Whether a pathname is path-localized — served with a `/:locale` segment.
+	* `false` for paths localized out-of-band (cookie strategy) or with detection
+	* disabled. Redirect middleware should skip non-localized paths so it never
+	* prepends a locale segment to a path that isn't path-localized.
+	*/
+	isPathLocalized(pathname) {
+		return this.localePath.isPathLocalized(pathname);
 	}
 	toUrlConfig() {
 		const config = this.localePath.localePathConfig;
@@ -38,4 +48,4 @@ LocaleUrlService = __decorate([Singleton(), __decorateParam(0, inject(ROUTER_TOK
 //#endregion
 export { locale_url_service_exports as n, LocaleUrlService as t };
 
-//# sourceMappingURL=locale-url.service-6bgia24_.mjs.map
+//# sourceMappingURL=locale-url.service-H8PH6GGh.mjs.map

package/dist/{locale-url.service-6bgia24_.mjs.map → locale-url.service-H8PH6GGh.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"locale-url.service-6bgia24_.mjs","names":[],"sources":["../src/router/services/locale-url.service.ts"],"sourcesContent":["import { inject } from '../../di'\nimport { Singleton } from '../../di/decorators'\nimport { applyLocalePrefix, shouldPrefixLocale, stripLocalePrefix } from '../locale-url'\nimport { ROUTER_TOKENS } from '../router.tokens'\nimport type { LocaleUrlConfig } from '../types'\nimport { type LocalePathService } from './locale-path.service'\n\n/**\n * DI-friendly wrapper around the pure locale-url helpers.\n *\n * Binds {@link LocalePathService} config so consumers can call `applyPrefix`,\n * `stripPrefix`, and `shouldPrefix` without passing config every time.\n *\n * Useful for canonical URL generation, sitemap builders, redirect middleware,\n * hreflang link emission, and anywhere else a request handler needs to compute\n * locale-aware path variants.\n */\n@Singleton()\nexport class LocaleUrlService {\n  constructor(\n    @inject(ROUTER_TOKENS.LocalePathService) private readonly localePath: LocalePathService,\n  ) { }\n\n  /** Whether path-based locale detection is enabled — i.e., locales have URL-distinct path variants. */\n  get pathEnabled(): boolean {\n    return this.localePath.enabled\n  }\n\n  /** Whether the given locale should get a URL prefix under the current config. */\n  shouldPrefix(locale: string): boolean {\n    return shouldPrefixLocale(locale, this.toUrlConfig())\n  }\n\n  /** Prepend `/{locale}` to a pathname, respecting `prefixDefaultLocale`. */\n  applyPrefix(pathname: string, locale: string): string {\n    return applyLocalePrefix(pathname, locale, this.toUrlConfig())\n  }\n\n  /** Strip a known-locale prefix from the start of a pathname. */\n  stripPrefix(pathname: string): string {\n    const known = this.localePath.localePathConfig?.allLocales ?? []\n    return stripLocalePrefix(pathname, known)\n  }\n\n  private toUrlConfig(): LocaleUrlConfig | undefined {\n    const config = this.localePath.localePathConfig\n    if (!config) return undefined\n    return { defaultLocale: config.defaultLocale, prefixDefaultLocale: this.localePath.prefixDefaultLocale }\n  }\n}\n"],"mappings":";;;;;;AAkBO,IAAA,mBAAA,MAAM,iBAAiB;CAEgC;CAD5D,YACE,YACA;EAD0D,KAAA,aAAA;CACxD;;CAGJ,IAAI,cAAuB;EACzB,OAAO,KAAK,WAAW;CACzB;;CAGA,aAAa,QAAyB;EACpC,OAAO,mBAAmB,QAAQ,KAAK,YAAY,CAAC;CACtD;;CAGA,YAAY,UAAkB,QAAwB;EACpD,OAAO,kBAAkB,UAAU,QAAQ,KAAK,YAAY,CAAC;CAC/D;;CAGA,YAAY,UAA0B;EAEpC,OAAO,kBAAkB,UADX,KAAK,WAAW,kBAAkB,cAAc,CAAC,CACvB;CAC1C;CAEA,cAAmD;EACjD,MAAM,SAAS,KAAK,WAAW;EAC/B,IAAI,CAAC,QAAQ,OAAO,KAAA;EACpB,OAAO;GAAE,eAAe,OAAO;GAAe,qBAAqB,KAAK,WAAW;EAAoB;CACzG;AACF;+BAhCC,UAAU,GAAA,gBAAA,GAGN,OAAO,cAAc,iBAAiB,CAAA,CAAA,GAAA,gBAAA"}
+{"version":3,"file":"locale-url.service-H8PH6GGh.mjs","names":[],"sources":["../src/router/services/locale-url.service.ts"],"sourcesContent":["import { inject } from '../../di'\nimport { Singleton } from '../../di/decorators'\nimport { applyLocalePrefix, shouldPrefixLocale, stripLocalePrefix } from '../locale-url'\nimport { ROUTER_TOKENS } from '../router.tokens'\nimport type { LocaleUrlConfig } from '../types'\nimport { type LocalePathService } from './locale-path.service'\n\n/**\n * DI-friendly wrapper around the pure locale-url helpers.\n *\n * Binds {@link LocalePathService} config so consumers can call `applyPrefix`,\n * `stripPrefix`, and `shouldPrefix` without passing config every time.\n *\n * Useful for canonical URL generation, sitemap builders, redirect middleware,\n * hreflang link emission, and anywhere else a request handler needs to compute\n * locale-aware path variants.\n */\n@Singleton()\nexport class LocaleUrlService {\n  constructor(\n    @inject(ROUTER_TOKENS.LocalePathService) private readonly localePath: LocalePathService,\n  ) { }\n\n  /** Whether path-based locale detection is enabled — i.e., locales have URL-distinct path variants. */\n  get pathEnabled(): boolean {\n    return this.localePath.enabled\n  }\n\n  /** Whether the given locale should get a URL prefix under the current config. */\n  shouldPrefix(locale: string): boolean {\n    return shouldPrefixLocale(locale, this.toUrlConfig())\n  }\n\n  /** Prepend `/{locale}` to a pathname, respecting `prefixDefaultLocale`. */\n  applyPrefix(pathname: string, locale: string): string {\n    return applyLocalePrefix(pathname, locale, this.toUrlConfig())\n  }\n\n  /** Strip a known-locale prefix from the start of a pathname. */\n  stripPrefix(pathname: string): string {\n    const known = this.localePath.localePathConfig?.allLocales ?? []\n    return stripLocalePrefix(pathname, known)\n  }\n\n  /**\n   * Whether a pathname is path-localized — served with a `/:locale` segment.\n   * `false` for paths localized out-of-band (cookie strategy) or with detection\n   * disabled. Redirect middleware should skip non-localized paths so it never\n   * prepends a locale segment to a path that isn't path-localized.\n   */\n  isPathLocalized(pathname: string): boolean {\n    return this.localePath.isPathLocalized(pathname)\n  }\n\n  private toUrlConfig(): LocaleUrlConfig | undefined {\n    const config = this.localePath.localePathConfig\n    if (!config) return undefined\n    return { defaultLocale: config.defaultLocale, prefixDefaultLocale: this.localePath.prefixDefaultLocale }\n  }\n}\n"],"mappings":";;;;;;AAkBO,IAAM,mBAAN,MAAM,iBAAiB;CAEgC;CAD5D,YACE,YACA;EAD0D,KAAA,aAAA;CACxD;;CAGJ,IAAI,cAAuB;EACzB,OAAO,KAAK,WAAW;CACzB;;CAGA,aAAa,QAAyB;EACpC,OAAO,mBAAmB,QAAQ,KAAK,YAAY,CAAC;CACtD;;CAGA,YAAY,UAAkB,QAAwB;EACpD,OAAO,kBAAkB,UAAU,QAAQ,KAAK,YAAY,CAAC;CAC/D;;CAGA,YAAY,UAA0B;EACpC,MAAM,QAAQ,KAAK,WAAW,kBAAkB,cAAc,CAAC;EAC/D,OAAO,kBAAkB,UAAU,KAAK;CAC1C;;;;;;;CAQA,gBAAgB,UAA2B;EACzC,OAAO,KAAK,WAAW,gBAAgB,QAAQ;CACjD;CAEA,cAAmD;EACjD,MAAM,SAAS,KAAK,WAAW;EAC/B,IAAI,CAAC,QAAQ,OAAO,KAAA;EACpB,OAAO;GAAE,eAAe,OAAO;GAAe,qBAAqB,KAAK,WAAW;EAAoB;CACzG;AACF;AA1CC,mBAAA,WAAA,CAAA,UAAU,GAAA,gBAAA,GAGN,OAAO,cAAc,iBAAiB,CAAA,CAAA,GAAA,gBAAA"}

package/dist/logger/index.mjs

@@ -1,5 +1,5 @@
-import { p as inject, u as Transient } from "../di-D7qmrAir.mjs";
-import { n as __decorateParam, t as __decorate } from "../decorate-CuAoSZvs.mjs";
+import { p as inject, u as Transient } from "../di-DQ3xbjgf.mjs";
+import { n as __decorateParam, t as __decorate } from "../decorate-C79yt3Wt.mjs";
 //#region src/logger/logger.tokens.ts
 const LOGGER_TOKENS = {
 	LoggerService: Symbol.for("stratal:logger:service"),
@@ -78,9 +78,7 @@ let LoggerService = class LoggerService {
 			case "warn":
 				console.warn(formatted);
 				break;
-			case "error":
-				console.error(formatted);
-				break;
+			case "error": console.error(formatted);
 		}
 	}
 	enrichContext(userContext) {

package/dist/logger/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/logger/logger.tokens.ts","../../src/logger/contracts/log-level.ts","../../src/logger/services/logger.service.ts","../../src/logger/formatters/json-formatter.ts","../../src/logger/formatters/pretty-formatter.ts"],"sourcesContent":["export const LOGGER_TOKENS = {\n  LoggerService: Symbol.for('stratal:logger:service'),\n  Formatter: Symbol.for('stratal:logger:formatter'),\n  LogLevelOptions: Symbol.for('stratal:logger:log:level:options'),\n} as const\n","/**\n * Log severity levels\n * Ordered from least to most severe\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Map log levels to numeric priorities (for filtering)\n * Higher numbers = more severe = higher priority\n */\nexport const LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n  [LogLevel.DEBUG]: 0,\n  [LogLevel.INFO]: 1,\n  [LogLevel.WARN]: 2,\n  [LogLevel.ERROR]: 3,\n}\n","import { inject } from '../../di'\nimport { Transient } from '../../di/decorators'\nimport type { InternalLogContext, LogContext, LogEntry } from '../contracts'\nimport { LOG_LEVEL_PRIORITY, LogLevel } from '../contracts/log-level'\nimport type { ILogFormatter } from '../formatters/formatter.interface'\nimport { LOGGER_TOKENS } from '../logger.tokens'\n\n@Transient()\nexport class LoggerService {\n  constructor(\n    @inject(LOGGER_TOKENS.LogLevelOptions)\n    private readonly logLevel: LogLevel,\n\n    @inject(LOGGER_TOKENS.Formatter)\n    private readonly formatter: ILogFormatter,\n  ) { }\n\n  debug(message: string, context?: LogContext): void {\n    this.log(LogLevel.DEBUG, message, context)\n  }\n\n  info(message: string, context?: LogContext): void {\n    this.log(LogLevel.INFO, message, context)\n  }\n\n  warn(message: string, context?: LogContext): void {\n    this.log(LogLevel.WARN, message, context)\n  }\n\n  error(message: string, error: Error, context?: LogContext): void\n  error(message: string, context?: LogContext): void\n  error(message: string, errorOrContext?: Error | LogContext, maybeContext?: LogContext): void {\n    let context: LogContext | undefined\n    let error: Error | undefined\n\n    if (errorOrContext instanceof Error) {\n      error = errorOrContext\n      context = maybeContext\n    } else {\n      context = errorOrContext\n    }\n\n    this.log(LogLevel.ERROR, message, context, error)\n  }\n\n  private log(\n    level: LogLevel,\n    message: string,\n    userContext?: LogContext,\n    error?: Error\n  ): void {\n    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.logLevel]) {\n      return\n    }\n\n    const entry: LogEntry = {\n      level,\n      message,\n      context: this.enrichContext(userContext ?? {}),\n      error: error ? this.serializeError(error) : undefined,\n    }\n\n    const formatted = this.formatter.format(entry)\n    this.writeToConsole(level, formatted)\n  }\n\n  private writeToConsole(level: LogLevel, formatted: string): void {\n    switch (level) {\n      case LogLevel.DEBUG:\n        console.debug(formatted)\n        break\n      case LogLevel.INFO:\n        console.info(formatted)\n        break\n      case LogLevel.WARN:\n        console.warn(formatted)\n        break\n      case LogLevel.ERROR:\n        console.error(formatted)\n        break\n    }\n  }\n\n  private enrichContext(userContext: LogContext): InternalLogContext {\n    return {\n      ...userContext,\n      timestamp: Date.now(),\n    }\n  }\n\n  private serializeError(error: Error): { message: string; stack?: string; name?: string } {\n    return {\n      message: error.message,\n      stack: error.stack,\n      name: error.name,\n    }\n  }\n}\n","import type { LogEntry } from '../contracts'\nimport type { ILogFormatter } from './formatter.interface'\n\n/**\n * JSON Formatter\n *\n * Produces structured JSON logs for production environments.\n * Optimized for log aggregation systems (Cloudflare Analytics, Datadog, etc.)\n *\n * Output format:\n * {\n *   \"level\": \"info\",\n *   \"message\": \"User logged in\",\n *   \"timestamp\": 1234567890,\n *   \"userId\": \"user_456\",\n *   \"error\": { \"message\": \"...\", \"stack\": \"...\" }\n * }\n */\nexport class JsonFormatter implements ILogFormatter {\n  format(entry: LogEntry): string {\n    const output = {\n      level: entry.level,\n      message: entry.message,\n      ...entry.context,\n      ...(entry.error && { error: entry.error }),\n    }\n\n    return JSON.stringify(output)\n  }\n}\n","import type { LogEntry } from '../contracts'\nimport { LogLevel } from '../contracts'\nimport type { ILogFormatter } from './formatter.interface'\n\n/**\n * Pretty Formatter\n *\n * Human-readable colored output for development environments.\n * Uses ANSI color codes for terminal output.\n *\n * Output format:\n * [2024-01-15 10:30:45] INFO: User logged in\n *   userId: user_456\n */\nexport class PrettyFormatter implements ILogFormatter {\n  private readonly colors: Record<LogLevel, string> = {\n    [LogLevel.DEBUG]: '\\x1b[36m', // Cyan\n    [LogLevel.INFO]: '\\x1b[32m', // Green\n    [LogLevel.WARN]: '\\x1b[33m', // Yellow\n    [LogLevel.ERROR]: '\\x1b[31m', // Red\n  }\n\n  private readonly reset = '\\x1b[0m'\n\n  format(entry: LogEntry): string {\n    const color = this.colors[entry.level]\n    const timestamp = new Date(entry.context.timestamp).toISOString()\n    const levelStr = entry.level.toUpperCase().padEnd(5)\n\n    let output = `${color}[${timestamp}] ${levelStr}${this.reset}: ${entry.message}`\n\n    // Add context (exclude timestamp)\n    const { timestamp: _, ...contextWithoutTimestamp } = entry.context\n    const contextEntries = Object.entries(contextWithoutTimestamp)\n\n    if (contextEntries.length > 0) {\n      output += '\\n'\n      contextEntries.forEach(([key, value]) => {\n        output += `  ${key}: ${JSON.stringify(value)}\\n`\n      })\n    }\n\n    // Add error stack if present\n    if (entry.error?.stack) {\n      output += `\\n${entry.error.stack}\\n`\n    }\n\n    return output.trimEnd()\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/logger/logger.tokens.ts","../../src/logger/contracts/log-level.ts","../../src/logger/services/logger.service.ts","../../src/logger/formatters/json-formatter.ts","../../src/logger/formatters/pretty-formatter.ts"],"sourcesContent":["export const LOGGER_TOKENS = {\n  LoggerService: Symbol.for('stratal:logger:service'),\n  Formatter: Symbol.for('stratal:logger:formatter'),\n  LogLevelOptions: Symbol.for('stratal:logger:log:level:options'),\n} as const\n","/**\n * Log severity levels\n * Ordered from least to most severe\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Map log levels to numeric priorities (for filtering)\n * Higher numbers = more severe = higher priority\n */\nexport const LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n  [LogLevel.DEBUG]: 0,\n  [LogLevel.INFO]: 1,\n  [LogLevel.WARN]: 2,\n  [LogLevel.ERROR]: 3,\n}\n","import { inject } from '../../di'\nimport { Transient } from '../../di/decorators'\nimport type { InternalLogContext, LogContext, LogEntry } from '../contracts'\nimport { LOG_LEVEL_PRIORITY, LogLevel } from '../contracts/log-level'\nimport type { ILogFormatter } from '../formatters/formatter.interface'\nimport { LOGGER_TOKENS } from '../logger.tokens'\n\n@Transient()\nexport class LoggerService {\n  constructor(\n    @inject(LOGGER_TOKENS.LogLevelOptions)\n    private readonly logLevel: LogLevel,\n\n    @inject(LOGGER_TOKENS.Formatter)\n    private readonly formatter: ILogFormatter,\n  ) { }\n\n  debug(message: string, context?: LogContext): void {\n    this.log(LogLevel.DEBUG, message, context)\n  }\n\n  info(message: string, context?: LogContext): void {\n    this.log(LogLevel.INFO, message, context)\n  }\n\n  warn(message: string, context?: LogContext): void {\n    this.log(LogLevel.WARN, message, context)\n  }\n\n  error(message: string, error: Error, context?: LogContext): void\n  error(message: string, context?: LogContext): void\n  error(message: string, errorOrContext?: Error | LogContext, maybeContext?: LogContext): void {\n    let context: LogContext | undefined\n    let error: Error | undefined\n\n    if (errorOrContext instanceof Error) {\n      error = errorOrContext\n      context = maybeContext\n    } else {\n      context = errorOrContext\n    }\n\n    this.log(LogLevel.ERROR, message, context, error)\n  }\n\n  private log(\n    level: LogLevel,\n    message: string,\n    userContext?: LogContext,\n    error?: Error\n  ): void {\n    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.logLevel]) {\n      return\n    }\n\n    const entry: LogEntry = {\n      level,\n      message,\n      context: this.enrichContext(userContext ?? {}),\n      error: error ? this.serializeError(error) : undefined,\n    }\n\n    const formatted = this.formatter.format(entry)\n    this.writeToConsole(level, formatted)\n  }\n\n  private writeToConsole(level: LogLevel, formatted: string): void {\n    switch (level) {\n      case LogLevel.DEBUG:\n        console.debug(formatted)\n        break\n      case LogLevel.INFO:\n        console.info(formatted)\n        break\n      case LogLevel.WARN:\n        console.warn(formatted)\n        break\n      case LogLevel.ERROR:\n        console.error(formatted)\n        break\n    }\n  }\n\n  private enrichContext(userContext: LogContext): InternalLogContext {\n    return {\n      ...userContext,\n      timestamp: Date.now(),\n    }\n  }\n\n  private serializeError(error: Error): { message: string; stack?: string; name?: string } {\n    return {\n      message: error.message,\n      stack: error.stack,\n      name: error.name,\n    }\n  }\n}\n","import type { LogEntry } from '../contracts'\nimport type { ILogFormatter } from './formatter.interface'\n\n/**\n * JSON Formatter\n *\n * Produces structured JSON logs for production environments.\n * Optimized for log aggregation systems (Cloudflare Analytics, Datadog, etc.)\n *\n * Output format:\n * {\n *   \"level\": \"info\",\n *   \"message\": \"User logged in\",\n *   \"timestamp\": 1234567890,\n *   \"userId\": \"user_456\",\n *   \"error\": { \"message\": \"...\", \"stack\": \"...\" }\n * }\n */\nexport class JsonFormatter implements ILogFormatter {\n  format(entry: LogEntry): string {\n    const output = {\n      level: entry.level,\n      message: entry.message,\n      ...entry.context,\n      ...(entry.error && { error: entry.error }),\n    }\n\n    return JSON.stringify(output)\n  }\n}\n","import type { LogEntry } from '../contracts'\nimport { LogLevel } from '../contracts'\nimport type { ILogFormatter } from './formatter.interface'\n\n/**\n * Pretty Formatter\n *\n * Human-readable colored output for development environments.\n * Uses ANSI color codes for terminal output.\n *\n * Output format:\n * [2024-01-15 10:30:45] INFO: User logged in\n *   userId: user_456\n */\nexport class PrettyFormatter implements ILogFormatter {\n  private readonly colors: Record<LogLevel, string> = {\n    [LogLevel.DEBUG]: '\\x1b[36m', // Cyan\n    [LogLevel.INFO]: '\\x1b[32m', // Green\n    [LogLevel.WARN]: '\\x1b[33m', // Yellow\n    [LogLevel.ERROR]: '\\x1b[31m', // Red\n  }\n\n  private readonly reset = '\\x1b[0m'\n\n  format(entry: LogEntry): string {\n    const color = this.colors[entry.level]\n    const timestamp = new Date(entry.context.timestamp).toISOString()\n    const levelStr = entry.level.toUpperCase().padEnd(5)\n\n    let output = `${color}[${timestamp}] ${levelStr}${this.reset}: ${entry.message}`\n\n    // Add context (exclude timestamp)\n    const { timestamp: _, ...contextWithoutTimestamp } = entry.context\n    const contextEntries = Object.entries(contextWithoutTimestamp)\n\n    if (contextEntries.length > 0) {\n      output += '\\n'\n      contextEntries.forEach(([key, value]) => {\n        output += `  ${key}: ${JSON.stringify(value)}\\n`\n      })\n    }\n\n    // Add error stack if present\n    if (entry.error?.stack) {\n      output += `\\n${entry.error.stack}\\n`\n    }\n\n    return output.trimEnd()\n  }\n}\n"],"mappings":"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"}

package/dist/macroable-cvDTFZ_A.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"macroable-cvDTFZ_A.mjs","names":[],"sources":["../src/macroable/macroable.ts"],"sourcesContent":["import type { MacroFunction } from './types'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Constructor = abstract new (...args: any[]) => any\n\n/**\n * Abstract base class for adding macros, instance properties, and getters\n * to classes at runtime.\n *\n * Inspired by [@poppinss/macroable](https://github.com/poppinss/macroable)\n * and Laravel's Macroable trait.\n *\n * @example\n * ```typescript\n * // Register a macro\n * RouterContext.macro('flash', function (this: RouterContext, key: string, value: unknown) {\n *   const session = this.getContainer().resolve(SessionService)\n *   session.flash(key, value)\n * })\n *\n * // Register a getter\n * RouterContext.getter('requestId', function (this: RouterContext) {\n *   return this.header('x-request-id') ?? crypto.randomUUID()\n * }, true)\n *\n * // Register a per-instance property (safe for destructuring)\n * RouterContext.instanceProperty('getUser', function (this: RouterContext) {\n *   return this.getContainer().resolve(AuthContext).user\n * })\n * ```\n */\nexport abstract class Macroable {\n  [key: string | symbol]: unknown\n  /**\n   * Per-instance properties. Each entry is applied and bound\n   * to `this` inside the constructor so destructuring stays safe.\n   */\n  protected static instanceMacros = new Set<{ key: string | symbol; value: unknown }>()\n\n  /**\n   * Names registered via macro() — used by hasMacro() and flushMacros().\n   */\n  protected static macroNames = new Set<string | symbol>()\n\n  /**\n   * Names registered via getter() — used by hasMacro() and flushMacros().\n   */\n  protected static getterNames = new Set<string | symbol>()\n\n  /**\n   * Original prototype values saved before macro() overrides them.\n   * Used by flushMacros() to restore native methods.\n   */\n  private static _originals = new Map<string | symbol, { existed: boolean; value: unknown }>()\n\n  // ── Macros (prototype-level) ──────────────────────────────\n\n  /**\n   * Register a macro on the class prototype.\n   * Can override existing methods.\n   *\n   * When the name matches an existing property, the value type is auto-derived.\n   *\n   * @param name - Method or property name\n   * @param value - Function or value to assign\n   */\n  static macro<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    value: InstanceType<T>[K],\n  ): void\n  static macro(name: string | symbol, value: unknown): void\n  static macro(name: string | symbol, value: unknown): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'macroNames')) {\n      this.macroNames = new Set(this.macroNames)\n    }\n    if (!Object.prototype.hasOwnProperty.call(this, '_originals')) {\n      this._originals = new Map(this._originals)\n    }\n\n    // Save the original value before first override so flushMacros() can restore it\n    if (!this._originals.has(name)) {\n      const existed = Object.prototype.hasOwnProperty.call(this.prototype, name)\n      this._originals.set(name, {\n        existed,\n        value: existed ? (this.prototype as Record<string | symbol, unknown>)[name] : undefined,\n      })\n    }\n\n    this.macroNames.add(name);\n    (this.prototype as Record<string | symbol, unknown>)[name] = value\n  }\n\n  // ── Instance properties (bound per-instance) ─────────────\n\n  /**\n   * Register a per-instance property that is bound to `this`\n   * in the constructor. Safe for destructuring.\n   *\n   * When the name matches an existing property, the value type is auto-derived.\n   *\n   * @param name - Property name\n   * @param value - Function (will be bound) or value\n   */\n  static instanceProperty<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    value: InstanceType<T>[K],\n  ): void\n  static instanceProperty(name: string | symbol, value: unknown): void\n  static instanceProperty(name: string | symbol, value: unknown): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'instanceMacros')) {\n      this.instanceMacros = new Set(this.instanceMacros)\n    }\n    this.instanceMacros.add({ key: name, value })\n  }\n\n  // ── Getters (Object.defineProperty on prototype) ──────────\n\n  /**\n   * Register a computed getter on the class prototype.\n   *\n   * @param name - Property name\n   * @param accumulator - Function that computes the value (called with instance as `this`)\n   * @param singleton - If true, cache the value after first access\n   */\n  static getter<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    accumulator: (this: InstanceType<T>) => InstanceType<T>[K],\n    singleton?: boolean,\n  ): void\n  static getter(name: string | symbol, accumulator: MacroFunction, singleton?: boolean): void\n  static getter(\n    name: string | symbol,\n    accumulator: MacroFunction,\n    singleton = false,\n  ): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'getterNames')) {\n      this.getterNames = new Set(this.getterNames)\n    }\n    this.getterNames.add(name)\n\n    Object.defineProperty(this.prototype, name, {\n      get(): unknown {\n        const value: unknown = accumulator.call(this)\n        if (singleton) {\n          Object.defineProperty(this, name, {\n            value,\n            configurable: false,\n            enumerable: false,\n            writable: false,\n          })\n        }\n        return value\n      },\n      configurable: true,\n      enumerable: false,\n    })\n  }\n\n  // ── Introspection ─────────────────────────────────────────\n\n  /**\n   * Check if a macro, instance property, or getter is registered.\n   *\n   * @param name - Name to check\n   */\n  static hasMacro(name: string | symbol): boolean {\n    return (\n      this.macroNames.has(name) ||\n      [...this.instanceMacros].some((m) => m.key === name) ||\n      this.getterNames.has(name)\n    )\n  }\n\n  // ── Cleanup ───────────────────────────────────────────────\n\n  /**\n   * Remove all macros, instance properties, and getters\n   * registered on this class. Does not affect parent classes.\n   */\n  static flushMacros(): void {\n    const proto = this.prototype as Record<string | symbol, unknown>\n\n    // Restore original prototype values or delete if they didn't exist before\n    for (const name of this.macroNames) {\n      const original = this._originals.get(name)\n      if (original?.existed) {\n        proto[name] = original.value\n      } else {\n        Reflect.deleteProperty(proto, name)\n      }\n    }\n    for (const name of this.getterNames) {\n      Reflect.deleteProperty(proto, name)\n    }\n\n    if (Object.prototype.hasOwnProperty.call(this, 'macroNames')) {\n      this.macroNames.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, 'instanceMacros')) {\n      this.instanceMacros.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, 'getterNames')) {\n      this.getterNames.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, '_originals')) {\n      this._originals.clear()\n    }\n  }\n\n  // ── Constructor (applies instance properties) ─────────────\n\n  constructor() {\n    const Constructor = this.constructor as typeof Macroable\n    const self = this as Record<string | symbol, unknown>\n    Constructor.instanceMacros.forEach(({ key, value }) => {\n      if (typeof value === 'function') {\n        self[key] = value.bind(this)\n      } else {\n        self[key] = value\n      }\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAsB,YAAtB,MAAgC;;;;;CAM9B,OAAiB,iCAAiB,IAAI,IAA8C;;;;CAKpF,OAAiB,6BAAa,IAAI,IAAqB;;;;CAKvD,OAAiB,8BAAc,IAAI,IAAqB;;;;;CAMxD,OAAe,6BAAa,IAAI,IAA2D;CAmB3F,OAAO,MAAM,MAAuB,OAAsB;EACxD,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GAC1D,KAAK,aAAa,IAAI,IAAI,KAAK,UAAU;EAE3C,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GAC1D,KAAK,aAAa,IAAI,IAAI,KAAK,UAAU;EAI3C,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,GAAG;GAC9B,MAAM,UAAU,OAAO,UAAU,eAAe,KAAK,KAAK,WAAW,IAAI;GACzE,KAAK,WAAW,IAAI,MAAM;IACxB;IACA,OAAO,UAAW,KAAK,UAA+C,QAAQ,KAAA;GAChF,CAAC;EACH;EAEA,KAAK,WAAW,IAAI,IAAI;EACxB,KAAM,UAA+C,QAAQ;CAC/D;CAmBA,OAAO,iBAAiB,MAAuB,OAAsB;EACnE,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,gBAAgB,GAC9D,KAAK,iBAAiB,IAAI,IAAI,KAAK,cAAc;EAEnD,KAAK,eAAe,IAAI;GAAE,KAAK;GAAM;EAAM,CAAC;CAC9C;CAkBA,OAAO,OACL,MACA,aACA,YAAY,OACN;EACN,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,GAC3D,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW;EAE7C,KAAK,YAAY,IAAI,IAAI;EAEzB,OAAO,eAAe,KAAK,WAAW,MAAM;GAC1C,MAAe;IACb,MAAM,QAAiB,YAAY,KAAK,IAAI;IAC5C,IAAI,WACF,OAAO,eAAe,MAAM,MAAM;KAChC;KACA,cAAc;KACd,YAAY;KACZ,UAAU;IACZ,CAAC;IAEH,OAAO;GACT;GACA,cAAc;GACd,YAAY;EACd,CAAC;CACH;;;;;;CASA,OAAO,SAAS,MAAgC;EAC9C,OACE,KAAK,WAAW,IAAI,IAAI,KACxB,CAAC,GAAG,KAAK,cAAc,EAAE,MAAM,MAAM,EAAE,QAAQ,IAAI,KACnD,KAAK,YAAY,IAAI,IAAI;CAE7B;;;;;CAQA,OAAO,cAAoB;EACzB,MAAM,QAAQ,KAAK;EAGnB,KAAK,MAAM,QAAQ,KAAK,YAAY;GAClC,MAAM,WAAW,KAAK,WAAW,IAAI,IAAI;GACzC,IAAI,UAAU,SACZ,MAAM,QAAQ,SAAS;QAEvB,QAAQ,eAAe,OAAO,IAAI;EAEtC;EACA,KAAK,MAAM,QAAQ,KAAK,aACtB,QAAQ,eAAe,OAAO,IAAI;EAGpC,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GACzD,KAAK,WAAW,MAAM;EAExB,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,gBAAgB,GAC7D,KAAK,eAAe,MAAM;EAE5B,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,GAC1D,KAAK,YAAY,MAAM;EAEzB,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GACzD,KAAK,WAAW,MAAM;CAE1B;CAIA,cAAc;EACZ,MAAM,cAAc,KAAK;EACzB,MAAM,OAAO;EACb,YAAY,eAAe,SAAS,EAAE,KAAK,YAAY;GACrD,IAAI,OAAO,UAAU,YACnB,KAAK,OAAO,MAAM,KAAK,IAAI;QAE3B,KAAK,OAAO;EAEhB,CAAC;CACH;AACF"}
+{"version":3,"file":"macroable-cvDTFZ_A.mjs","names":[],"sources":["../src/macroable/macroable.ts"],"sourcesContent":["import type { MacroFunction } from './types'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Constructor = abstract new (...args: any[]) => any\n\n/**\n * Abstract base class for adding macros, instance properties, and getters\n * to classes at runtime.\n *\n * Inspired by [@poppinss/macroable](https://github.com/poppinss/macroable)\n * and Laravel's Macroable trait.\n *\n * @example\n * ```typescript\n * // Register a macro\n * RouterContext.macro('flash', function (this: RouterContext, key: string, value: unknown) {\n *   const session = this.getContainer().resolve(SessionService)\n *   session.flash(key, value)\n * })\n *\n * // Register a getter\n * RouterContext.getter('requestId', function (this: RouterContext) {\n *   return this.header('x-request-id') ?? crypto.randomUUID()\n * }, true)\n *\n * // Register a per-instance property (safe for destructuring)\n * RouterContext.instanceProperty('getUser', function (this: RouterContext) {\n *   return this.getContainer().resolve(AuthContext).user\n * })\n * ```\n */\nexport abstract class Macroable {\n  [key: string | symbol]: unknown\n  /**\n   * Per-instance properties. Each entry is applied and bound\n   * to `this` inside the constructor so destructuring stays safe.\n   */\n  protected static instanceMacros = new Set<{ key: string | symbol; value: unknown }>()\n\n  /**\n   * Names registered via macro() — used by hasMacro() and flushMacros().\n   */\n  protected static macroNames = new Set<string | symbol>()\n\n  /**\n   * Names registered via getter() — used by hasMacro() and flushMacros().\n   */\n  protected static getterNames = new Set<string | symbol>()\n\n  /**\n   * Original prototype values saved before macro() overrides them.\n   * Used by flushMacros() to restore native methods.\n   */\n  private static _originals = new Map<string | symbol, { existed: boolean; value: unknown }>()\n\n  // ── Macros (prototype-level) ──────────────────────────────\n\n  /**\n   * Register a macro on the class prototype.\n   * Can override existing methods.\n   *\n   * When the name matches an existing property, the value type is auto-derived.\n   *\n   * @param name - Method or property name\n   * @param value - Function or value to assign\n   */\n  static macro<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    value: InstanceType<T>[K],\n  ): void\n  static macro(name: string | symbol, value: unknown): void\n  static macro(name: string | symbol, value: unknown): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'macroNames')) {\n      this.macroNames = new Set(this.macroNames)\n    }\n    if (!Object.prototype.hasOwnProperty.call(this, '_originals')) {\n      this._originals = new Map(this._originals)\n    }\n\n    // Save the original value before first override so flushMacros() can restore it\n    if (!this._originals.has(name)) {\n      const existed = Object.prototype.hasOwnProperty.call(this.prototype, name)\n      this._originals.set(name, {\n        existed,\n        value: existed ? (this.prototype as Record<string | symbol, unknown>)[name] : undefined,\n      })\n    }\n\n    this.macroNames.add(name);\n    (this.prototype as Record<string | symbol, unknown>)[name] = value\n  }\n\n  // ── Instance properties (bound per-instance) ─────────────\n\n  /**\n   * Register a per-instance property that is bound to `this`\n   * in the constructor. Safe for destructuring.\n   *\n   * When the name matches an existing property, the value type is auto-derived.\n   *\n   * @param name - Property name\n   * @param value - Function (will be bound) or value\n   */\n  static instanceProperty<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    value: InstanceType<T>[K],\n  ): void\n  static instanceProperty(name: string | symbol, value: unknown): void\n  static instanceProperty(name: string | symbol, value: unknown): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'instanceMacros')) {\n      this.instanceMacros = new Set(this.instanceMacros)\n    }\n    this.instanceMacros.add({ key: name, value })\n  }\n\n  // ── Getters (Object.defineProperty on prototype) ──────────\n\n  /**\n   * Register a computed getter on the class prototype.\n   *\n   * @param name - Property name\n   * @param accumulator - Function that computes the value (called with instance as `this`)\n   * @param singleton - If true, cache the value after first access\n   */\n  static getter<T extends Constructor, K extends keyof InstanceType<T>>(\n    this: T,\n    name: K,\n    accumulator: (this: InstanceType<T>) => InstanceType<T>[K],\n    singleton?: boolean,\n  ): void\n  static getter(name: string | symbol, accumulator: MacroFunction, singleton?: boolean): void\n  static getter(\n    name: string | symbol,\n    accumulator: MacroFunction,\n    singleton = false,\n  ): void {\n    if (!Object.prototype.hasOwnProperty.call(this, 'getterNames')) {\n      this.getterNames = new Set(this.getterNames)\n    }\n    this.getterNames.add(name)\n\n    Object.defineProperty(this.prototype, name, {\n      get(): unknown {\n        const value: unknown = accumulator.call(this)\n        if (singleton) {\n          Object.defineProperty(this, name, {\n            value,\n            configurable: false,\n            enumerable: false,\n            writable: false,\n          })\n        }\n        return value\n      },\n      configurable: true,\n      enumerable: false,\n    })\n  }\n\n  // ── Introspection ─────────────────────────────────────────\n\n  /**\n   * Check if a macro, instance property, or getter is registered.\n   *\n   * @param name - Name to check\n   */\n  static hasMacro(name: string | symbol): boolean {\n    return (\n      this.macroNames.has(name) ||\n      [...this.instanceMacros].some((m) => m.key === name) ||\n      this.getterNames.has(name)\n    )\n  }\n\n  // ── Cleanup ───────────────────────────────────────────────\n\n  /**\n   * Remove all macros, instance properties, and getters\n   * registered on this class. Does not affect parent classes.\n   */\n  static flushMacros(): void {\n    const proto = this.prototype as Record<string | symbol, unknown>\n\n    // Restore original prototype values or delete if they didn't exist before\n    for (const name of this.macroNames) {\n      const original = this._originals.get(name)\n      if (original?.existed) {\n        proto[name] = original.value\n      } else {\n        Reflect.deleteProperty(proto, name)\n      }\n    }\n    for (const name of this.getterNames) {\n      Reflect.deleteProperty(proto, name)\n    }\n\n    if (Object.prototype.hasOwnProperty.call(this, 'macroNames')) {\n      this.macroNames.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, 'instanceMacros')) {\n      this.instanceMacros.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, 'getterNames')) {\n      this.getterNames.clear()\n    }\n    if (Object.prototype.hasOwnProperty.call(this, '_originals')) {\n      this._originals.clear()\n    }\n  }\n\n  // ── Constructor (applies instance properties) ─────────────\n\n  constructor() {\n    const Constructor = this.constructor as typeof Macroable\n    const self = this as Record<string | symbol, unknown>\n    Constructor.instanceMacros.forEach(({ key, value }) => {\n      if (typeof value === 'function') {\n        self[key] = value.bind(this)\n      } else {\n        self[key] = value\n      }\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAsB,YAAtB,MAAgC;;;;;CAM9B,OAAiB,iCAAiB,IAAI,IAA8C;;;;CAKpF,OAAiB,6BAAa,IAAI,IAAqB;;;;CAKvD,OAAiB,8BAAc,IAAI,IAAqB;;;;;CAMxD,OAAe,6BAAa,IAAI,IAA2D;CAmB3F,OAAO,MAAM,MAAuB,OAAsB;EACxD,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GAC1D,KAAK,aAAa,IAAI,IAAI,KAAK,UAAU;EAE3C,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GAC1D,KAAK,aAAa,IAAI,IAAI,KAAK,UAAU;EAI3C,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,GAAG;GAC9B,MAAM,UAAU,OAAO,UAAU,eAAe,KAAK,KAAK,WAAW,IAAI;GACzE,KAAK,WAAW,IAAI,MAAM;IACxB;IACA,OAAO,UAAW,KAAK,UAA+C,QAAQ,KAAA;GAChF,CAAC;EACH;EAEA,KAAK,WAAW,IAAI,IAAI;EACxB,KAAM,UAA+C,QAAQ;CAC/D;CAmBA,OAAO,iBAAiB,MAAuB,OAAsB;EACnE,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,gBAAgB,GAC9D,KAAK,iBAAiB,IAAI,IAAI,KAAK,cAAc;EAEnD,KAAK,eAAe,IAAI;GAAE,KAAK;GAAM;EAAM,CAAC;CAC9C;CAkBA,OAAO,OACL,MACA,aACA,YAAY,OACN;EACN,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,GAC3D,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW;EAE7C,KAAK,YAAY,IAAI,IAAI;EAEzB,OAAO,eAAe,KAAK,WAAW,MAAM;GAC1C,MAAe;IACb,MAAM,QAAiB,YAAY,KAAK,IAAI;IAC5C,IAAI,WACF,OAAO,eAAe,MAAM,MAAM;KAChC;KACA,cAAc;KACd,YAAY;KACZ,UAAU;IACZ,CAAC;IAEH,OAAO;GACT;GACA,cAAc;GACd,YAAY;EACd,CAAC;CACH;;;;;;CASA,OAAO,SAAS,MAAgC;EAC9C,OACE,KAAK,WAAW,IAAI,IAAI,KACxB,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC,MAAM,MAAM,EAAE,QAAQ,IAAI,KACnD,KAAK,YAAY,IAAI,IAAI;CAE7B;;;;;CAQA,OAAO,cAAoB;EACzB,MAAM,QAAQ,KAAK;EAGnB,KAAK,MAAM,QAAQ,KAAK,YAAY;GAClC,MAAM,WAAW,KAAK,WAAW,IAAI,IAAI;GACzC,IAAI,UAAU,SACZ,MAAM,QAAQ,SAAS;QAEvB,QAAQ,eAAe,OAAO,IAAI;EAEtC;EACA,KAAK,MAAM,QAAQ,KAAK,aACtB,QAAQ,eAAe,OAAO,IAAI;EAGpC,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GACzD,KAAK,WAAW,MAAM;EAExB,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,gBAAgB,GAC7D,KAAK,eAAe,MAAM;EAE5B,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,aAAa,GAC1D,KAAK,YAAY,MAAM;EAEzB,IAAI,OAAO,UAAU,eAAe,KAAK,MAAM,YAAY,GACzD,KAAK,WAAW,MAAM;CAE1B;CAIA,cAAc;EACZ,MAAM,cAAc,KAAK;EACzB,MAAM,OAAO;EACb,YAAY,eAAe,SAAS,EAAE,KAAK,YAAY;GACrD,IAAI,OAAO,UAAU,YACnB,KAAK,OAAO,MAAM,KAAK,IAAI;QAE3B,KAAK,OAAO;EAEhB,CAAC;CACH;AACF"}

package/dist/metadata-Ba8Fxs1F.mjs

@@ -0,0 +1,48 @@
+import { globalRegistry } from "zod/mini";
+//#region src/i18n/validation/metadata.ts
+const toMeta = (input) => typeof input === "string" ? { description: input } : input;
+/**
+* Attach metadata to a schema. zod/mini has no chainable `.describe()`, so
+* metadata is registered in the global registry; the OpenAPI generator reads it
+* back when building the document. Pass a string for a description only, or an
+* object to set `example`, `examples`, `title`, `deprecated`, etc.
+*
+* @example
+* ```ts
+* import { string } from 'zod/mini'
+* import { describe } from 'stratal/validation'
+*
+* const name = describe(string(), 'The display name')
+* const id = describe(string(), { description: 'The id', example: '1212121' })
+* ```
+*/
+function describe(schema, meta) {
+	globalRegistry.add(schema, toMeta(meta));
+	return schema;
+}
+/**
+* Register a schema as a reusable OpenAPI component. The generator emits it once
+* under `components.schemas.<id>` and references it with `$ref` everywhere it is
+* used. Pass a string for a description only, or an object for further metadata;
+* the explicit `id` always wins.
+*
+* @example
+* ```ts
+* import { object, string } from 'zod/mini'
+* import { named } from 'stratal/validation'
+*
+* const User = named(object({ id: string() }), 'User', 'A user record')
+* const Money = named(object({ cents: number() }), 'Money', { example: { cents: 500 } })
+* ```
+*/
+function named(schema, id, meta) {
+	globalRegistry.add(schema, meta === void 0 ? { id } : {
+		...toMeta(meta),
+		id
+	});
+	return schema;
+}
+//#endregion
+export { named as n, describe as t };
+
+//# sourceMappingURL=metadata-Ba8Fxs1F.mjs.map

package/dist/metadata-Ba8Fxs1F.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-Ba8Fxs1F.mjs","names":[],"sources":["../src/i18n/validation/metadata.ts"],"sourcesContent":["import { globalRegistry } from 'zod/mini'\nimport type { GlobalMeta, ZodType } from './zod'\n\n/**\n * Schema metadata read by the OpenAPI generator: `description`, `title`,\n * `example`, `examples`, `deprecated`, and any extra keys zod passes through to\n * the generated JSON Schema.\n */\nexport type SchemaMeta = GlobalMeta\n\n/** A bare description string, or a full metadata object. */\nexport type SchemaMetaInput = string | SchemaMeta\n\nconst toMeta = (input: SchemaMetaInput): SchemaMeta =>\n  typeof input === 'string' ? { description: input } : input\n\n/**\n * Attach metadata to a schema. zod/mini has no chainable `.describe()`, so\n * metadata is registered in the global registry; the OpenAPI generator reads it\n * back when building the document. Pass a string for a description only, or an\n * object to set `example`, `examples`, `title`, `deprecated`, etc.\n *\n * @example\n * ```ts\n * import { string } from 'zod/mini'\n * import { describe } from 'stratal/validation'\n *\n * const name = describe(string(), 'The display name')\n * const id = describe(string(), { description: 'The id', example: '1212121' })\n * ```\n */\nexport function describe<T extends ZodType>(schema: T, meta: SchemaMetaInput): T {\n  globalRegistry.add(schema, toMeta(meta))\n  return schema\n}\n\n/**\n * Register a schema as a reusable OpenAPI component. The generator emits it once\n * under `components.schemas.<id>` and references it with `$ref` everywhere it is\n * used. Pass a string for a description only, or an object for further metadata;\n * the explicit `id` always wins.\n *\n * @example\n * ```ts\n * import { object, string } from 'zod/mini'\n * import { named } from 'stratal/validation'\n *\n * const User = named(object({ id: string() }), 'User', 'A user record')\n * const Money = named(object({ cents: number() }), 'Money', { example: { cents: 500 } })\n * ```\n */\nexport function named<T extends ZodType>(schema: T, id: string, meta?: SchemaMetaInput): T {\n  globalRegistry.add(schema, meta === undefined ? { id } : { ...toMeta(meta), id })\n  return schema\n}\n"],"mappings":";;AAaA,MAAM,UAAU,UACd,OAAO,UAAU,WAAW,EAAE,aAAa,MAAM,IAAI;;;;;;;;;;;;;;;;AAiBvD,SAAgB,SAA4B,QAAW,MAA0B;CAC/E,eAAe,IAAI,QAAQ,OAAO,IAAI,CAAC;CACvC,OAAO;AACT;;;;;;;;;;;;;;;;AAiBA,SAAgB,MAAyB,QAAW,IAAY,MAA2B;CACzF,eAAe,IAAI,QAAQ,SAAS,KAAA,IAAY,EAAE,GAAG,IAAI;EAAE,GAAG,OAAO,IAAI;EAAG;CAAG,CAAC;CAChF,OAAO;AACT"}

package/dist/module/index.d.mts

@@ -1,15 +1,14 @@
-import { Bn as ModuleOptions, Fn as DynamicModule, Gn as ValueProvider, Hn as OnInitialize, In as ExistingProvider, Ir as ApplicationError, Jn as InjectionToken, Ln as FactoryProvider, Nn as AsyncModuleOptions, Pn as ClassProvider, Rn as ModuleClass, Un as OnShutdown, Vn as OnException, Wn as Provider, hn as ModuleRegistry, zn as ModuleContext } from "../index-uybm0bhQ.mjs";
+import { $n as ModuleClass, Jn as AsyncModuleOptions, Qn as FactoryProvider, Xn as DynamicModule, Yn as ClassProvider, Zn as ExistingProvider, ar as Provider, er as ModuleContext, ir as OnShutdown, li as ApplicationError, lr as InjectionToken, nr as OnException, or as ValueProvider, rr as OnInitialize, tr as ModuleOptions, xn as ModuleRegistry } from "../index-B2WtEagR.mjs";
 import { t as Constructor } from "../types-CmV_9xBD.mjs";
-import { n as ModuleRef, t as LazyModuleLoader } from "../lazy-module-loader-M6YKudNL.mjs";
-
+import { n as ModuleRef, t as LazyModuleLoader } from "../lazy-module-loader-C3OHoUnR.mjs";
 //#region src/module/module.error.d.ts
-declare class ModuleError extends ApplicationError {}
+export declare class ModuleError extends ApplicationError {}
 //#endregion
 //#region src/module/module.decorator.d.ts
-declare const MODULE_OPTIONS_KEY: unique symbol;
-declare function Module(options: ModuleOptions): <TFunction extends abstract new (...args: never[]) => unknown>(target: TFunction) => TFunction;
-declare function getModuleOptions(target: Constructor): ModuleOptions | undefined;
-declare function isModuleClass(target: unknown): target is Constructor;
+export declare const MODULE_OPTIONS_KEY: unique symbol;
+export declare function Module(options: ModuleOptions): <TFunction extends abstract new (...args: never[]) => unknown>(target: TFunction) => TFunction;
+export declare function getModuleOptions(target: Constructor): ModuleOptions | undefined;
+export declare function isModuleClass(target: unknown): target is Constructor;
 //#endregion
-export { AsyncModuleOptions, ClassProvider, DynamicModule, ExistingProvider, FactoryProvider, type InjectionToken, LazyModuleLoader, MODULE_OPTIONS_KEY, Module, ModuleClass, ModuleContext, ModuleError, ModuleOptions, ModuleRef, ModuleRegistry, OnException, OnInitialize, OnShutdown, Provider, ValueProvider, getModuleOptions, isModuleClass };
+export { AsyncModuleOptions, ClassProvider, DynamicModule, ExistingProvider, FactoryProvider, type InjectionToken, LazyModuleLoader, ModuleClass, ModuleContext, ModuleOptions, ModuleRef, ModuleRegistry, OnException, OnInitialize, OnShutdown, Provider, ValueProvider };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/module/module.error.ts","../../src/module/module.decorator.ts"],"mappings":";;;;;cAEa,WAAA,SAAoB,gBAAgB;;;cCEpC,kBAAA;AAAA,iBAEG,MAAA,CAAO,OAAA,EAAS,aAAA,uCACa,IAAA,uBAA2B,MAAA,EAAQ,SAAA,KAAY,SAAA;AAAA,iBAM5E,gBAAA,CAAiB,MAAA,EAAQ,WAAA,GAAc,aAAa;AAAA,iBAIpD,aAAA,CAAc,MAAA,YAAkB,MAAA,IAAU,WAAW"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/module/module.error.ts","../../src/module/module.decorator.ts"],"mappings":";;;;qBAEa,oBAAoB;;;qBCEpB;wBAEG,OAAO,SAAS,iBACtB,mCAAmC,2BAAyB,QAAU,cAAY;wBAM5E,iBAAiB,QAAQ,cAAc;wBAIvC,cAAc,kBAAkB,UAAU"}

package/dist/module/index.mjs

@@ -1,7 +1,6 @@
-import { a as ApplicationError } from "../container-storage-BmOJ4_Na.mjs";
-import "../errors-C01O2T-n.mjs";
-import { i as isModuleClass, n as Module, r as getModuleOptions, t as MODULE_OPTIONS_KEY } from "../module.decorator-CYHY6pG5.mjs";
-import { d as LazyModuleLoader, f as ModuleRef, t as ModuleRegistry } from "../module-registry-NxX5O0Qk.mjs";
+import { a as ApplicationError } from "../container-storage-DfF7SXdV.mjs";
+import { i as isModuleClass, n as Module, r as getModuleOptions, t as MODULE_OPTIONS_KEY } from "../module.decorator-CYbrOlX9.mjs";
+import { d as LazyModuleLoader, f as ModuleRef, t as ModuleRegistry } from "../module-registry-lkQPDuQe.mjs";
 //#region src/module/module.error.ts
 var ModuleError = class extends ApplicationError {};
 //#endregion

package/dist/module/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/module/module.error.ts"],"sourcesContent":["import { ApplicationError } from '../errors'\n\nexport class ModuleError extends ApplicationError {}\n"],"mappings":";;;;;AAEA,IAAa,cAAb,cAAiC,iBAAiB,CAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/module/module.error.ts"],"sourcesContent":["import { ApplicationError } from '../errors'\n\nexport class ModuleError extends ApplicationError {}\n"],"mappings":";;;;AAEA,IAAa,cAAb,cAAiC,iBAAiB,CAAC"}

package/dist/{module-registry-NxX5O0Qk.mjs → module-registry-lkQPDuQe.mjs}

@@ -1,12 +1,12 @@
-import { n as CONTAINER_TOKEN, p as inject, r as DI_TOKENS, u as Transient } from "./di-D7qmrAir.mjs";
-import { a as ApplicationError } from "./container-storage-BmOJ4_Na.mjs";
-import { n as __decorateParam, t as __decorate } from "./decorate-CuAoSZvs.mjs";
+import { n as CONTAINER_TOKEN, p as inject, r as DI_TOKENS, u as Transient } from "./di-DQ3xbjgf.mjs";
+import { a as ApplicationError } from "./container-storage-DfF7SXdV.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-C79yt3Wt.mjs";
 import { LOGGER_TOKENS } from "./logger/index.mjs";
-import { d as HttpException } from "./errors-C01O2T-n.mjs";
-import { s as isListener } from "./events-BhEQuT1X.mjs";
-import { r as getModuleOptions } from "./module.decorator-CYHY6pG5.mjs";
-import { t as isCommand } from "./is-command-CEPO9n8c.mjs";
-import { t as isSeeder } from "./is-seeder-Gvh_AM71.mjs";
+import { d as HttpException } from "./errors-CrOXI_y5.mjs";
+import { s as isListener } from "./events-GtwGEHyT.mjs";
+import { r as getModuleOptions } from "./module.decorator-CYbrOlX9.mjs";
+import { t as isCommand } from "./is-command-CSVv14wh.mjs";
+import { t as isSeeder } from "./is-seeder-gLgXYbqC.mjs";
 //#region src/module/module-ref.ts
 /**
 * Handle to a lazily loaded module, returned by {@link LazyModuleLoader.load}.
@@ -151,17 +151,18 @@ var RouterError = class extends ApplicationError {};
 * Only internal modules (RouterResolver) import them, keeping the Router's
 * public API clean — users never see these methods.
 *
-* Declared as individual unique symbols so TypeScript can distinguish
-* their return types in computed property access.
+* Registered via `Symbol.for` so that a duplicate evaluation of this module
+* (e.g. under a bundler or SSR module runner) resolves to the same symbol,
+* keeping symbol-keyed dispatch between `Router` and `RouterResolver` stable.
 *
 * @internal
 */
 /** @internal */
-const getDefaultEntry = Symbol("Router.getDefaultEntry");
+const getDefaultEntry = Symbol.for("stratal:router:getDefaultEntry");
 /** @internal */
-const getGroups = Symbol("Router.getGroups");
+const getGroups = Symbol.for("stratal:router:getGroups");
 /** @internal */
-const getGlobalMiddleware = Symbol("Router.getGlobalMiddleware");
+const getGlobalMiddleware = Symbol.for("stratal:router:getGlobalMiddleware");
 //#endregion
 //#region src/router/router.ts
 /**
@@ -512,7 +513,8 @@ var ModuleRegistry = class {
 		else if ("useFactory" in provider) {
 			const { provide, useFactory, inject = [] } = provider;
 			this.container.registerFactory(provide, (c) => {
-				return useFactory(...inject.map((token) => c.resolve(token)));
+				const deps = inject.map((token) => c.resolve(token));
+				return useFactory(...deps);
 			});
 		} else if ("useExisting" in provider) this.container.registerExisting(provider.provide, provider.useExisting);
 	}
@@ -551,4 +553,4 @@ var ModuleRegistry = class {
 //#endregion
 export { getGroups as a, RATE_LIMITER_TOKENS as c, LazyModuleLoader as d, ModuleRef as f, getGlobalMiddleware as i, RateLimiterError as l, Router as n, RouterError as o, getDefaultEntry as r, createThrottleMiddleware as s, ModuleRegistry as t, TooManyRequestsError as u };
 
-//# sourceMappingURL=module-registry-NxX5O0Qk.mjs.map
+//# sourceMappingURL=module-registry-lkQPDuQe.mjs.map