elysia-intlayer 9.5.12 → 9.6.0

package/dist/cjs/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 let node_async_hooks = require("node:async_hooks");
+let _intlayer_config_built = require("@intlayer/config/built");
 let _intlayer_config_node = require("@intlayer/config/node");
 let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 let _intlayer_core_localization = require("@intlayer/core/localization");
@@ -10,9 +11,6 @@ let elysia = require("elysia");
 //#region src/index.ts
 /**
 * Per-request storage backing the standalone `t`, `getIntlayer` and `getDictionary` exports.
-*
-* `cls-hooked` (used by the Node-based Intlayer plugins) relies on `async_hooks.createHook`,
-* which Bun does not implement. `AsyncLocalStorage` is supported by both runtimes.
 */
 const intlayerStorage = new node_async_hooks.AsyncLocalStorage();
 /**
@@ -22,28 +20,9 @@ const getRequestContext = () => intlayerStorage.getStore()?.current;
 (0, _intlayer_core_interpreter.registerAmbientLocaleResolver)(() => getRequestContext()?.locale);
 let debug = () => {};
 /**
-* Builds the translation function bound to a resolved request locale.
+* Translates `content` into `locale`, falling back to the default locale.
 */
-const createTranslateFunction = (locale, defaultLocale) => (content, localeArg) => {
-	const targetLocale = localeArg ?? locale;
-	if (typeof content === "undefined") return "";
-	if (typeof content === "string") return content;
-	if (typeof content?.[targetLocale] === "undefined") {
-		if (typeof content?.[defaultLocale] === "undefined") return content;
-		return (0, _intlayer_core_interpreter.getTranslation)(content, defaultLocale);
-	}
-	return (0, _intlayer_core_interpreter.getTranslation)(content, targetLocale);
-};
-/**
-* Releases the request context once the response is mapped, so the standalone helpers
-* never resolve against an already terminated request.
-*
-* Returns `undefined` so Elysia keeps running the remaining `mapResponse` handlers.
-*/
-const releaseContext = () => {
-	const contextRef = intlayerStorage.getStore();
-	if (contextRef) contextRef.current = void 0;
-};
+const translate = (content, locale) => typeof content === "string" ? content : (0, _intlayer_core_interpreter.getTranslation)(content, locale, _intlayer_config_built.internationalization.defaultLocale);
 /**
 * Elysia plugin that integrates Intlayer into your Elysia application.
 *
@@ -51,7 +30,7 @@ const releaseContext = () => {
 * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.
 * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.
 * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports
-*    for the duration of the request, through `AsyncLocalStorage`.
+*    for the whole request, through `AsyncLocalStorage`.
 *
 * @example
 * ```ts
@@ -69,39 +48,30 @@ const releaseContext = () => {
 * ```
 */
 const intlayer = () => {
-	const configuration = (0, _intlayer_config_node.getConfiguration)();
-	const { internationalization } = configuration;
 	if (process.env.NODE_ENV === "development") debug = (message) => console.debug(message);
-	(0, _intlayer_engine_build.prepareIntlayerServer)(configuration, { label: "elysia-intlayer" });
-	return new elysia.Elysia({ name: "elysia-intlayer" }).derive({ as: "global" }, ({ request, cookie }) => {
-		/**
-		* Retrieves the locale from storage (cookies, headers).
-		*/
+	(0, _intlayer_engine_build.prepareIntlayerServer)((0, _intlayer_config_node.getConfiguration)(), { label: "elysia-intlayer" });
+	const { locales, defaultLocale } = _intlayer_config_built.internationalization;
+	return new elysia.Elysia({ name: "elysia-intlayer" }).wrap((handle) => (...parameters) => intlayerStorage.run({}, () => handle(...parameters))).derive({ as: "global" }, ({ request, cookie }) => {
 		const localeFromStorage = (0, _intlayer_core_utils.getLocaleFromStorageServer)({
-			getCookie: (name) => cookie?.[name]?.value,
+			getCookie: (name) => cookie?.[name]?.value ?? (0, _intlayer_core_utils.getCookie)(name, request.headers.get("cookie") ?? ""),
 			getHeader: (name) => request.headers.get(name) ?? void 0
 		});
-		const negotiatorHeaders = {};
-		request.headers.forEach((value, key) => {
-			negotiatorHeaders[key] = value;
-		});
-		const localeDetected = (0, _intlayer_core_localization.localeDetector)(negotiatorHeaders, internationalization.locales, internationalization.defaultLocale);
+		const localeDetected = (0, _intlayer_core_localization.localeDetector)({ "accept-language": request.headers.get("accept-language") ?? void 0 }, locales, defaultLocale);
 		const locale = localeFromStorage ?? localeDetected;
-		const defaultLocale = internationalization.defaultLocale;
-		const getIntlayer = (key, localeArg = locale, ...props) => (0, _intlayer_core_interpreter.getIntlayer)(key, localeArg, ...props);
-		const getDictionary = (key, localeArg = locale, ...props) => (0, _intlayer_core_interpreter.getDictionary)(key, localeArg, ...props);
 		const context = {
 			locale_storage: localeFromStorage,
 			locale_detected: localeDetected,
 			locale,
 			defaultLocale,
-			t: createTranslateFunction(locale, defaultLocale),
-			getIntlayer,
-			getDictionary
+			t: (content, localeArg) => translate(content, localeArg ?? locale),
+			getIntlayer: (key, localeArg = locale, ...props) => (0, _intlayer_core_interpreter.getIntlayer)(key, localeArg, ...props),
+			getDictionary: (key, localeArg = locale, ...props) => (0, _intlayer_core_interpreter.getDictionary)(key, localeArg, ...props)
 		};
-		intlayerStorage.enterWith({ current: context });
+		const contextRef = intlayerStorage.getStore();
+		if (contextRef) contextRef.current = context;
+		else intlayerStorage.enterWith({ current: context });
 		return { intlayer: context };
-	}).mapResponse({ as: "global" }, releaseContext).onError({ as: "global" }, releaseContext);
+	});
 };
 /**
 * Translation function that retrieves content for the locale of the current request.
@@ -120,8 +90,7 @@ const t = (content, locale) => {
 	const context = getRequestContext();
 	if (context) return context.t(content, locale);
 	debug("Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.t` instead.");
-	const { internationalization } = (0, _intlayer_config_node.getConfiguration)();
-	return (0, _intlayer_core_interpreter.getTranslation)(content, locale ?? internationalization.defaultLocale);
+	return translate(content, locale ?? _intlayer_config_built.internationalization.defaultLocale);
 };
 /**
 * Retrieves a dictionary by key, using the locale of the current request by default.

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["AsyncLocalStorage","registerAmbientLocaleResolver","getTranslation","getConfiguration","Elysia","getLocaleFromStorageServer","localeDetector","getIntlayerFunction","getDictionaryFunction"],"sources":["../../src/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { getConfiguration } from '@intlayer/config/node';\nimport {\n  getDictionary as getDictionaryFunction,\n  getIntlayer as getIntlayerFunction,\n  getTranslation,\n  registerAmbientLocaleResolver,\n} from '@intlayer/core/interpreter';\nimport { localeDetector } from '@intlayer/core/localization';\nimport { getLocaleFromStorageServer } from '@intlayer/core/utils';\nimport { prepareIntlayerServer } from '@intlayer/engine/build';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport { Elysia } from 'elysia';\n\n/**\n * Translates a locale map into the content matching the current request locale.\n */\nexport type TranslateFunction = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n) => Content;\n\n/**\n * Intlayer state injected into every Elysia route context by the `intlayer` plugin.\n */\nexport type IntlayerContext = {\n  /** Locale explicitly requested by the client through a cookie or a header. */\n  locale_storage?: Locale;\n  /** Locale negotiated from the request headers (`Accept-Language`). */\n  locale_detected: Locale;\n  /** Locale to use for this request, `locale_storage` taking precedence. */\n  locale: Locale;\n  /** Locale configured as fallback in `intlayer.config.ts`. */\n  defaultLocale: Locale;\n  /** Translates an inline locale map. */\n  t: TranslateFunction;\n  /** Reads a dictionary by key, defaulting to the request locale. */\n  getIntlayer: typeof getIntlayerFunction;\n  /** Reads an imported dictionary, defaulting to the request locale. */\n  getDictionary: typeof getDictionaryFunction;\n};\n\n/**\n * Mutable holder for the context of the request being handled.\n *\n * The context is held behind a reference because `AsyncLocalStorage.enterWith(undefined)`\n * is a no-op in Bun: clearing the reference is the only reliable way to release it.\n */\ntype IntlayerContextRef = { current?: IntlayerContext };\n\n/**\n * Per-request storage backing the standalone `t`, `getIntlayer` and `getDictionary` exports.\n *\n * `cls-hooked` (used by the Node-based Intlayer plugins) relies on `async_hooks.createHook`,\n * which Bun does not implement. `AsyncLocalStorage` is supported by both runtimes.\n */\nconst intlayerStorage = new AsyncLocalStorage<IntlayerContextRef>();\n\n/**\n * Returns the context of the request currently being handled, if any.\n */\nconst getRequestContext = (): IntlayerContext | undefined =>\n  intlayerStorage.getStore()?.current;\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => getRequestContext()?.locale);\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\n/**\n * Builds the translation function bound to a resolved request locale.\n */\nconst createTranslateFunction =\n  (locale: Locale, defaultLocale: Locale): TranslateFunction =>\n  <Content extends string>(\n    content: StrictModeLocaleMap<Content> | string,\n    localeArg?: Locale\n  ): Content => {\n    const targetLocale = localeArg ?? locale;\n\n    if (typeof content === 'undefined') {\n      return '' as unknown as Content;\n    }\n\n    if (typeof content === 'string') {\n      return content as unknown as Content;\n    }\n\n    if (\n      typeof content?.[\n        targetLocale as unknown as keyof StrictModeLocaleMap<Content>\n      ] === 'undefined'\n    ) {\n      if (\n        typeof content?.[\n          defaultLocale as unknown as keyof StrictModeLocaleMap<Content>\n        ] === 'undefined'\n      ) {\n        return content as unknown as Content;\n      }\n\n      return getTranslation(content, defaultLocale);\n    }\n\n    return getTranslation(content, targetLocale);\n  };\n\n/**\n * Releases the request context once the response is mapped, so the standalone helpers\n * never resolve against an already terminated request.\n *\n * Returns `undefined` so Elysia keeps running the remaining `mapResponse` handlers.\n */\nconst releaseContext = (): undefined => {\n  const contextRef = intlayerStorage.getStore();\n\n  if (contextRef) {\n    contextRef.current = undefined;\n  }\n\n  return undefined;\n};\n\n/**\n * Elysia plugin that integrates Intlayer into your Elysia application.\n *\n * It handles:\n * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.\n * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.\n * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports\n *    for the duration of the request, through `AsyncLocalStorage`.\n *\n * @example\n * ```ts\n * import { Elysia } from 'elysia';\n * import { intlayer } from 'elysia-intlayer';\n *\n * const app = new Elysia()\n *   .use(intlayer())\n *   .get('/', ({ intlayer }) =>\n *     intlayer.t({\n *       en: 'Hello',\n *       fr: 'Bonjour',\n *     })\n *   );\n * ```\n */\nexport const intlayer = () => {\n  const configuration = getConfiguration();\n  const { internationalization } = configuration;\n\n  if (process.env['NODE_ENV'] === 'development') {\n    debug = (message: string) => console.debug(message);\n  }\n\n  prepareIntlayerServer(configuration, { label: 'elysia-intlayer' });\n\n  return new Elysia({ name: 'elysia-intlayer' })\n    .derive({ as: 'global' }, ({ request, cookie }) => {\n      /**\n       * Retrieves the locale from storage (cookies, headers).\n       */\n      const localeFromStorage = getLocaleFromStorageServer({\n        getCookie: (name: string) =>\n          cookie?.[name]?.value as string | undefined,\n        getHeader: (name: string) => request.headers.get(name) ?? undefined,\n      });\n\n      const negotiatorHeaders: Record<string, string> = {};\n      request.headers.forEach((value, key) => {\n        negotiatorHeaders[key] = value;\n      });\n\n      const localeDetected = localeDetector(\n        negotiatorHeaders,\n        internationalization.locales,\n        internationalization.defaultLocale\n      );\n\n      const locale = localeFromStorage ?? localeDetected;\n      const defaultLocale = internationalization.defaultLocale;\n\n      const getIntlayer: typeof getIntlayerFunction = (\n        key: Parameters<typeof getIntlayerFunction>[0],\n        localeArg = locale as Parameters<typeof getIntlayerFunction>[1],\n        ...props: any[]\n      ) => getIntlayerFunction(key, localeArg, ...props);\n\n      const getDictionary: typeof getDictionaryFunction = (\n        key: Parameters<typeof getDictionaryFunction>[0],\n        localeArg = locale as Parameters<typeof getDictionaryFunction>[1],\n        ...props: any[]\n      ) => getDictionaryFunction(key, localeArg, ...props);\n\n      const context: IntlayerContext = {\n        locale_storage: localeFromStorage,\n        locale_detected: localeDetected,\n        locale,\n        defaultLocale,\n        t: createTranslateFunction(locale, defaultLocale),\n        getIntlayer,\n        getDictionary,\n      };\n\n      // Elysia awaits every lifecycle hook of a request on the same async chain,\n      // so entering the store here keeps it available to the route handler.\n      intlayerStorage.enterWith({ current: context });\n\n      return { intlayer: context };\n    })\n    .mapResponse({ as: 'global' }, releaseContext)\n    .onError({ as: 'global' }, releaseContext);\n};\n\n/**\n * Translation function that retrieves content for the locale of the current request.\n *\n * Falls back to the configured default locale when called outside of a request\n * handled by the `intlayer` plugin.\n *\n * @example\n * ```ts\n * import { t } from 'elysia-intlayer';\n *\n * app.get('/', () => t({ en: 'Hello', fr: 'Bonjour' }));\n * ```\n */\nexport const t = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n): Content => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.t(content, locale);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.t` instead.'\n  );\n\n  const { internationalization } = getConfiguration();\n\n  return getTranslation(\n    content as StrictModeLocaleMap<Content>,\n    locale ?? internationalization.defaultLocale\n  );\n};\n\n/**\n * Retrieves a dictionary by key, using the locale of the current request by default.\n */\nexport const getIntlayer: typeof getIntlayerFunction = (\n  ...args: Parameters<typeof getIntlayerFunction>\n) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getIntlayer(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getIntlayer` instead.'\n  );\n\n  return getIntlayerFunction(...args);\n};\n\n/**\n * Retrieves an imported dictionary, using the locale of the current request by default.\n */\nexport const getDictionary: typeof getDictionaryFunction = (\n  ...args: Parameters<typeof getDictionaryFunction>\n) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getDictionary(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getDictionary` instead.'\n  );\n\n  return getDictionaryFunction(...args);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAyDA,MAAM,kBAAkB,IAAIA,mCAAsC;;;;AAKlE,MAAM,0BACJ,gBAAgB,SAAS,CAAC,EAAE;IAI9BC,gEAAoC,kBAAkB,CAAC,EAAE,MAAM;AAG/D,IAAI,cAAyC,CAAC;;;;AAK9C,MAAM,2BACH,QAAgB,mBAEf,SACA,cACY;CACZ,MAAM,eAAe,aAAa;CAElC,IAAI,OAAO,YAAY,aACrB,OAAO;CAGT,IAAI,OAAO,YAAY,UACrB,OAAO;CAGT,IACE,OAAO,UACL,kBACI,aACN;EACA,IACE,OAAO,UACL,mBACI,aAEN,OAAO;EAGT,WAAOC,2CAAe,SAAS,aAAa;CAC9C;CAEA,WAAOA,2CAAe,SAAS,YAAY;AAC7C;;;;;;;AAQF,MAAM,uBAAkC;CACtC,MAAM,aAAa,gBAAgB,SAAS;CAE5C,IAAI,YACF,WAAW,UAAU;AAIzB;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,iBAAiB;CAC5B,MAAM,oBAAgBC,wCAAiB;CACvC,MAAM,EAAE,yBAAyB;CAEjC,6BAAgC,eAC9B,SAAS,YAAoB,QAAQ,MAAM,OAAO;CAGpD,kDAAsB,eAAe,EAAE,OAAO,kBAAkB,CAAC;CAEjE,OAAO,IAAIC,cAAO,EAAE,MAAM,kBAAkB,CAAC,CAAC,CAC3C,OAAO,EAAE,IAAI,SAAS,IAAI,EAAE,SAAS,aAAa;;;;EAIjD,MAAM,wBAAoBC,iDAA2B;GACnD,YAAY,SACV,SAAS,KAAK,EAAE;GAClB,YAAY,SAAiB,QAAQ,QAAQ,IAAI,IAAI,KAAK;EAC5D,CAAC;EAED,MAAM,oBAA4C,CAAC;EACnD,QAAQ,QAAQ,SAAS,OAAO,QAAQ;GACtC,kBAAkB,OAAO;EAC3B,CAAC;EAED,MAAM,qBAAiBC,4CACrB,mBACA,qBAAqB,SACrB,qBAAqB,aACvB;EAEA,MAAM,SAAS,qBAAqB;EACpC,MAAM,gBAAgB,qBAAqB;EAE3C,MAAM,eACJ,KACA,YAAY,QACZ,GAAG,cACAC,wCAAoB,KAAK,WAAW,GAAG,KAAK;EAEjD,MAAM,iBACJ,KACA,YAAY,QACZ,GAAG,cACAC,0CAAsB,KAAK,WAAW,GAAG,KAAK;EAEnD,MAAM,UAA2B;GAC/B,gBAAgB;GAChB,iBAAiB;GACjB;GACA;GACA,GAAG,wBAAwB,QAAQ,aAAa;GAChD;GACA;EACF;EAIA,gBAAgB,UAAU,EAAE,SAAS,QAAQ,CAAC;EAE9C,OAAO,EAAE,UAAU,QAAQ;CAC7B,CAAC,CAAC,CACD,YAAY,EAAE,IAAI,SAAS,GAAG,cAAc,CAAC,CAC7C,QAAQ,EAAE,IAAI,SAAS,GAAG,cAAc;AAC7C;;;;;;;;;;;;;;AAeA,MAAa,KACX,SACA,WACY;CACZ,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,EAAE,SAAS,MAAM;CAGlC,MACE,6GACF;CAEA,MAAM,EAAE,6BAAyBL,wCAAiB;CAElD,WAAOD,2CACL,SACA,UAAU,qBAAqB,aACjC;AACF;;;;AAKA,MAAa,eACX,GAAG,SACA;CACH,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,YAAY,GAAG,IAAI;CAGpC,MACE,uHACF;CAEA,WAAOK,wCAAoB,GAAG,IAAI;AACpC;;;;AAKA,MAAa,iBACX,GAAG,SACA;CACH,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,cAAc,GAAG,IAAI;CAGtC,MACE,yHACF;CAEA,WAAOC,0CAAsB,GAAG,IAAI;AACtC"}
+{"version":3,"file":"index.cjs","names":["AsyncLocalStorage","registerAmbientLocaleResolver","getTranslation","internationalization","getConfiguration","Elysia","getLocaleFromStorageServer","getCookie","localeDetector","getIntlayerFunction","getDictionaryFunction"],"sources":["../../src/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { internationalization } from '@intlayer/config/built';\nimport { getConfiguration } from '@intlayer/config/node';\nimport {\n  getDictionary as getDictionaryFunction,\n  getIntlayer as getIntlayerFunction,\n  getTranslation,\n  registerAmbientLocaleResolver,\n} from '@intlayer/core/interpreter';\nimport { localeDetector } from '@intlayer/core/localization';\nimport { getCookie, getLocaleFromStorageServer } from '@intlayer/core/utils';\nimport { prepareIntlayerServer } from '@intlayer/engine/build';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport { Elysia } from 'elysia';\n\n/**\n * Translates a locale map into the content matching the current request locale.\n */\nexport type TranslateFunction = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n) => Content;\n\n/**\n * Intlayer state injected into every Elysia route context by the `intlayer` plugin.\n */\nexport type IntlayerContext = {\n  /** Locale explicitly requested by the client through a cookie or a header. */\n  locale_storage?: Locale;\n  /** Locale negotiated from the request headers (`Accept-Language`). */\n  locale_detected: Locale;\n  /** Locale to use for this request, `locale_storage` taking precedence. */\n  locale: Locale;\n  /** Locale configured as fallback in `intlayer.config.ts`. */\n  defaultLocale: Locale;\n  /** Translates an inline locale map. */\n  t: TranslateFunction;\n  /** Reads a dictionary by key, defaulting to the request locale. */\n  getIntlayer: typeof getIntlayerFunction;\n  /** Reads an imported dictionary, defaulting to the request locale. */\n  getDictionary: typeof getDictionaryFunction;\n};\n\n/**\n * Holder for the context of the request being handled.\n *\n * The request scope is opened around the whole request (see `wrap` below),\n * before Elysia builds the route context: the context is filled in later by\n * `derive`, once the locale is known.\n */\ntype IntlayerContextRef = { current?: IntlayerContext };\n\n/**\n * Per-request storage backing the standalone `t`, `getIntlayer` and `getDictionary` exports.\n */\nconst intlayerStorage = new AsyncLocalStorage<IntlayerContextRef>();\n\n/**\n * Returns the context of the request currently being handled, if any.\n */\nconst getRequestContext = (): IntlayerContext | undefined =>\n  intlayerStorage.getStore()?.current;\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => getRequestContext()?.locale);\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\n/**\n * Translates `content` into `locale`, falling back to the default locale.\n */\nconst translate = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale: Locale\n): Content =>\n  typeof content === 'string'\n    ? (content as Content)\n    : getTranslation(content, locale, internationalization.defaultLocale);\n\n/**\n * Elysia plugin that integrates Intlayer into your Elysia application.\n *\n * It handles:\n * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.\n * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.\n * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports\n *    for the whole request, through `AsyncLocalStorage`.\n *\n * @example\n * ```ts\n * import { Elysia } from 'elysia';\n * import { intlayer } from 'elysia-intlayer';\n *\n * const app = new Elysia()\n *   .use(intlayer())\n *   .get('/', ({ intlayer }) =>\n *     intlayer.t({\n *       en: 'Hello',\n *       fr: 'Bonjour',\n *     })\n *   );\n * ```\n */\nexport const intlayer = () => {\n  if (process.env['NODE_ENV'] === 'development') {\n    debug = (message: string) => console.debug(message);\n  }\n\n  prepareIntlayerServer(getConfiguration(), { label: 'elysia-intlayer' });\n\n  const { locales, defaultLocale } = internationalization;\n\n  return (\n    new Elysia({ name: 'elysia-intlayer' })\n      // Runs the whole request, hooks and streamed body included, in its own\n      // scope, so the context never leaks to the caller of `app.handle`\n      .wrap(\n        (handle) =>\n          (...parameters: unknown[]) =>\n            intlayerStorage.run({}, () => handle(...parameters))\n      )\n      .derive({ as: 'global' }, ({ request, cookie }) => {\n        const localeFromStorage = getLocaleFromStorageServer({\n          getCookie: (name: string) =>\n            (cookie?.[name]?.value as string | undefined) ??\n            getCookie(name, request.headers.get('cookie') ?? ''),\n          getHeader: (name: string) => request.headers.get(name) ?? undefined,\n        });\n\n        const localeDetected = localeDetector(\n          {\n            'accept-language':\n              request.headers.get('accept-language') ?? undefined,\n          },\n          locales,\n          defaultLocale\n        );\n\n        const locale = localeFromStorage ?? localeDetected;\n\n        const context: IntlayerContext = {\n          locale_storage: localeFromStorage,\n          locale_detected: localeDetected,\n          locale,\n          defaultLocale,\n          t: (content, localeArg) => translate(content, localeArg ?? locale),\n          getIntlayer: (\n            key,\n            localeArg = locale as typeof localeArg,\n            ...props\n          ) => getIntlayerFunction(key, localeArg, ...props),\n          getDictionary: (\n            key,\n            localeArg = locale as typeof localeArg,\n            ...props\n          ) => getDictionaryFunction(key, localeArg, ...props),\n        };\n\n        const contextRef = intlayerStorage.getStore();\n\n        if (contextRef) {\n          contextRef.current = context;\n        } else {\n          // Handler not wrapped (plugin registered after the handler was\n          // compiled): scope the context to the rest of this request instead\n          intlayerStorage.enterWith({ current: context });\n        }\n\n        return { intlayer: context };\n      })\n  );\n};\n\n/**\n * Translation function that retrieves content for the locale of the current request.\n *\n * Falls back to the configured default locale when called outside of a request\n * handled by the `intlayer` plugin.\n *\n * @example\n * ```ts\n * import { t } from 'elysia-intlayer';\n *\n * app.get('/', () => t({ en: 'Hello', fr: 'Bonjour' }));\n * ```\n */\nexport const t = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n): Content => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.t(content, locale);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.t` instead.'\n  );\n\n  return translate(content, locale ?? internationalization.defaultLocale);\n};\n\n/**\n * Retrieves a dictionary by key, using the locale of the current request by default.\n */\nexport const getIntlayer: typeof getIntlayerFunction = (...args) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getIntlayer(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getIntlayer` instead.'\n  );\n\n  return getIntlayerFunction(...args);\n};\n\n/**\n * Retrieves an imported dictionary, using the locale of the current request by default.\n */\nexport const getDictionary: typeof getDictionaryFunction = (...args) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getDictionary(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getDictionary` instead.'\n  );\n\n  return getDictionaryFunction(...args);\n};\n"],"mappings":";;;;;;;;;;;;;;AAwDA,MAAM,kBAAkB,IAAIA,mCAAsC;;;;AAKlE,MAAM,0BACJ,gBAAgB,SAAS,CAAC,EAAE;IAI9BC,gEAAoC,kBAAkB,CAAC,EAAE,MAAM;AAG/D,IAAI,cAAyC,CAAC;;;;AAK9C,MAAM,aACJ,SACA,WAEA,OAAO,YAAY,WACd,cACDC,2CAAe,SAAS,QAAQC,4CAAqB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;AA0BxE,MAAa,iBAAiB;CAC5B,6BAAgC,eAC9B,SAAS,YAAoB,QAAQ,MAAM,OAAO;CAGpD,sDAAsBC,wCAAiB,GAAG,EAAE,OAAO,kBAAkB,CAAC;CAEtE,MAAM,EAAE,SAAS,kBAAkBD;CAEnC,OACE,IAAIE,cAAO,EAAE,MAAM,kBAAkB,CAAC,CAAC,CAGpC,MACE,YACE,GAAG,eACF,gBAAgB,IAAI,CAAC,SAAS,OAAO,GAAG,UAAU,CAAC,CACzD,CAAC,CACA,OAAO,EAAE,IAAI,SAAS,IAAI,EAAE,SAAS,aAAa;EACjD,MAAM,wBAAoBC,iDAA2B;GACnD,YAAY,SACT,SAAS,KAAK,EAAE,aACjBC,gCAAU,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK,EAAE;GACrD,YAAY,SAAiB,QAAQ,QAAQ,IAAI,IAAI,KAAK;EAC5D,CAAC;EAED,MAAM,qBAAiBC,4CACrB,EACE,mBACE,QAAQ,QAAQ,IAAI,iBAAiB,KAAK,OAC9C,GACA,SACA,aACF;EAEA,MAAM,SAAS,qBAAqB;EAEpC,MAAM,UAA2B;GAC/B,gBAAgB;GAChB,iBAAiB;GACjB;GACA;GACA,IAAI,SAAS,cAAc,UAAU,SAAS,aAAa,MAAM;GACjE,cACE,KACA,YAAY,QACZ,GAAG,cACAC,wCAAoB,KAAK,WAAW,GAAG,KAAK;GACjD,gBACE,KACA,YAAY,QACZ,GAAG,cACAC,0CAAsB,KAAK,WAAW,GAAG,KAAK;EACrD;EAEA,MAAM,aAAa,gBAAgB,SAAS;EAE5C,IAAI,YACF,WAAW,UAAU;OAIrB,gBAAgB,UAAU,EAAE,SAAS,QAAQ,CAAC;EAGhD,OAAO,EAAE,UAAU,QAAQ;CAC7B,CAAC;AAEP;;;;;;;;;;;;;;AAeA,MAAa,KACX,SACA,WACY;CACZ,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,EAAE,SAAS,MAAM;CAGlC,MACE,6GACF;CAEA,OAAO,UAAU,SAAS,UAAUP,4CAAqB,aAAa;AACxE;;;;AAKA,MAAa,eAA2C,GAAG,SAAS;CAClE,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,YAAY,GAAG,IAAI;CAGpC,MACE,uHACF;CAEA,WAAOM,wCAAoB,GAAG,IAAI;AACpC;;;;AAKA,MAAa,iBAA+C,GAAG,SAAS;CACtE,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,cAAc,GAAG,IAAI;CAGtC,MACE,yHACF;CAEA,WAAOC,0CAAsB,GAAG,IAAI;AACtC"}

package/dist/esm/index.mjs

@@ -1,17 +1,15 @@
 import { AsyncLocalStorage } from "node:async_hooks";
+import { internationalization } from "@intlayer/config/built";
 import { getConfiguration } from "@intlayer/config/node";
 import { getDictionary as getDictionary$1, getIntlayer as getIntlayer$1, getTranslation, registerAmbientLocaleResolver } from "@intlayer/core/interpreter";
 import { localeDetector } from "@intlayer/core/localization";
-import { getLocaleFromStorageServer } from "@intlayer/core/utils";
+import { getCookie, getLocaleFromStorageServer } from "@intlayer/core/utils";
 import { prepareIntlayerServer } from "@intlayer/engine/build";
 import { Elysia } from "elysia";
 
 //#region src/index.ts
 /**
 * Per-request storage backing the standalone `t`, `getIntlayer` and `getDictionary` exports.
-*
-* `cls-hooked` (used by the Node-based Intlayer plugins) relies on `async_hooks.createHook`,
-* which Bun does not implement. `AsyncLocalStorage` is supported by both runtimes.
 */
 const intlayerStorage = new AsyncLocalStorage();
 /**
@@ -21,28 +19,9 @@ const getRequestContext = () => intlayerStorage.getStore()?.current;
 registerAmbientLocaleResolver(() => getRequestContext()?.locale);
 let debug = () => {};
 /**
-* Builds the translation function bound to a resolved request locale.
+* Translates `content` into `locale`, falling back to the default locale.
 */
-const createTranslateFunction = (locale, defaultLocale) => (content, localeArg) => {
-	const targetLocale = localeArg ?? locale;
-	if (typeof content === "undefined") return "";
-	if (typeof content === "string") return content;
-	if (typeof content?.[targetLocale] === "undefined") {
-		if (typeof content?.[defaultLocale] === "undefined") return content;
-		return getTranslation(content, defaultLocale);
-	}
-	return getTranslation(content, targetLocale);
-};
-/**
-* Releases the request context once the response is mapped, so the standalone helpers
-* never resolve against an already terminated request.
-*
-* Returns `undefined` so Elysia keeps running the remaining `mapResponse` handlers.
-*/
-const releaseContext = () => {
-	const contextRef = intlayerStorage.getStore();
-	if (contextRef) contextRef.current = void 0;
-};
+const translate = (content, locale) => typeof content === "string" ? content : getTranslation(content, locale, internationalization.defaultLocale);
 /**
 * Elysia plugin that integrates Intlayer into your Elysia application.
 *
@@ -50,7 +29,7 @@ const releaseContext = () => {
 * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.
 * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.
 * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports
-*    for the duration of the request, through `AsyncLocalStorage`.
+*    for the whole request, through `AsyncLocalStorage`.
 *
 * @example
 * ```ts
@@ -68,39 +47,30 @@ const releaseContext = () => {
 * ```
 */
 const intlayer = () => {
-	const configuration = getConfiguration();
-	const { internationalization } = configuration;
 	if (process.env.NODE_ENV === "development") debug = (message) => console.debug(message);
-	prepareIntlayerServer(configuration, { label: "elysia-intlayer" });
-	return new Elysia({ name: "elysia-intlayer" }).derive({ as: "global" }, ({ request, cookie }) => {
-		/**
-		* Retrieves the locale from storage (cookies, headers).
-		*/
+	prepareIntlayerServer(getConfiguration(), { label: "elysia-intlayer" });
+	const { locales, defaultLocale } = internationalization;
+	return new Elysia({ name: "elysia-intlayer" }).wrap((handle) => (...parameters) => intlayerStorage.run({}, () => handle(...parameters))).derive({ as: "global" }, ({ request, cookie }) => {
 		const localeFromStorage = getLocaleFromStorageServer({
-			getCookie: (name) => cookie?.[name]?.value,
+			getCookie: (name) => cookie?.[name]?.value ?? getCookie(name, request.headers.get("cookie") ?? ""),
 			getHeader: (name) => request.headers.get(name) ?? void 0
 		});
-		const negotiatorHeaders = {};
-		request.headers.forEach((value, key) => {
-			negotiatorHeaders[key] = value;
-		});
-		const localeDetected = localeDetector(negotiatorHeaders, internationalization.locales, internationalization.defaultLocale);
+		const localeDetected = localeDetector({ "accept-language": request.headers.get("accept-language") ?? void 0 }, locales, defaultLocale);
 		const locale = localeFromStorage ?? localeDetected;
-		const defaultLocale = internationalization.defaultLocale;
-		const getIntlayer = (key, localeArg = locale, ...props) => getIntlayer$1(key, localeArg, ...props);
-		const getDictionary = (key, localeArg = locale, ...props) => getDictionary$1(key, localeArg, ...props);
 		const context = {
 			locale_storage: localeFromStorage,
 			locale_detected: localeDetected,
 			locale,
 			defaultLocale,
-			t: createTranslateFunction(locale, defaultLocale),
-			getIntlayer,
-			getDictionary
+			t: (content, localeArg) => translate(content, localeArg ?? locale),
+			getIntlayer: (key, localeArg = locale, ...props) => getIntlayer$1(key, localeArg, ...props),
+			getDictionary: (key, localeArg = locale, ...props) => getDictionary$1(key, localeArg, ...props)
 		};
-		intlayerStorage.enterWith({ current: context });
+		const contextRef = intlayerStorage.getStore();
+		if (contextRef) contextRef.current = context;
+		else intlayerStorage.enterWith({ current: context });
 		return { intlayer: context };
-	}).mapResponse({ as: "global" }, releaseContext).onError({ as: "global" }, releaseContext);
+	});
 };
 /**
 * Translation function that retrieves content for the locale of the current request.
@@ -119,8 +89,7 @@ const t = (content, locale) => {
 	const context = getRequestContext();
 	if (context) return context.t(content, locale);
 	debug("Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.t` instead.");
-	const { internationalization } = getConfiguration();
-	return getTranslation(content, locale ?? internationalization.defaultLocale);
+	return translate(content, locale ?? internationalization.defaultLocale);
 };
 /**
 * Retrieves a dictionary by key, using the locale of the current request by default.

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["getIntlayerFunction","getDictionaryFunction"],"sources":["../../src/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { getConfiguration } from '@intlayer/config/node';\nimport {\n  getDictionary as getDictionaryFunction,\n  getIntlayer as getIntlayerFunction,\n  getTranslation,\n  registerAmbientLocaleResolver,\n} from '@intlayer/core/interpreter';\nimport { localeDetector } from '@intlayer/core/localization';\nimport { getLocaleFromStorageServer } from '@intlayer/core/utils';\nimport { prepareIntlayerServer } from '@intlayer/engine/build';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport { Elysia } from 'elysia';\n\n/**\n * Translates a locale map into the content matching the current request locale.\n */\nexport type TranslateFunction = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n) => Content;\n\n/**\n * Intlayer state injected into every Elysia route context by the `intlayer` plugin.\n */\nexport type IntlayerContext = {\n  /** Locale explicitly requested by the client through a cookie or a header. */\n  locale_storage?: Locale;\n  /** Locale negotiated from the request headers (`Accept-Language`). */\n  locale_detected: Locale;\n  /** Locale to use for this request, `locale_storage` taking precedence. */\n  locale: Locale;\n  /** Locale configured as fallback in `intlayer.config.ts`. */\n  defaultLocale: Locale;\n  /** Translates an inline locale map. */\n  t: TranslateFunction;\n  /** Reads a dictionary by key, defaulting to the request locale. */\n  getIntlayer: typeof getIntlayerFunction;\n  /** Reads an imported dictionary, defaulting to the request locale. */\n  getDictionary: typeof getDictionaryFunction;\n};\n\n/**\n * Mutable holder for the context of the request being handled.\n *\n * The context is held behind a reference because `AsyncLocalStorage.enterWith(undefined)`\n * is a no-op in Bun: clearing the reference is the only reliable way to release it.\n */\ntype IntlayerContextRef = { current?: IntlayerContext };\n\n/**\n * Per-request storage backing the standalone `t`, `getIntlayer` and `getDictionary` exports.\n *\n * `cls-hooked` (used by the Node-based Intlayer plugins) relies on `async_hooks.createHook`,\n * which Bun does not implement. `AsyncLocalStorage` is supported by both runtimes.\n */\nconst intlayerStorage = new AsyncLocalStorage<IntlayerContextRef>();\n\n/**\n * Returns the context of the request currently being handled, if any.\n */\nconst getRequestContext = (): IntlayerContext | undefined =>\n  intlayerStorage.getStore()?.current;\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => getRequestContext()?.locale);\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\n/**\n * Builds the translation function bound to a resolved request locale.\n */\nconst createTranslateFunction =\n  (locale: Locale, defaultLocale: Locale): TranslateFunction =>\n  <Content extends string>(\n    content: StrictModeLocaleMap<Content> | string,\n    localeArg?: Locale\n  ): Content => {\n    const targetLocale = localeArg ?? locale;\n\n    if (typeof content === 'undefined') {\n      return '' as unknown as Content;\n    }\n\n    if (typeof content === 'string') {\n      return content as unknown as Content;\n    }\n\n    if (\n      typeof content?.[\n        targetLocale as unknown as keyof StrictModeLocaleMap<Content>\n      ] === 'undefined'\n    ) {\n      if (\n        typeof content?.[\n          defaultLocale as unknown as keyof StrictModeLocaleMap<Content>\n        ] === 'undefined'\n      ) {\n        return content as unknown as Content;\n      }\n\n      return getTranslation(content, defaultLocale);\n    }\n\n    return getTranslation(content, targetLocale);\n  };\n\n/**\n * Releases the request context once the response is mapped, so the standalone helpers\n * never resolve against an already terminated request.\n *\n * Returns `undefined` so Elysia keeps running the remaining `mapResponse` handlers.\n */\nconst releaseContext = (): undefined => {\n  const contextRef = intlayerStorage.getStore();\n\n  if (contextRef) {\n    contextRef.current = undefined;\n  }\n\n  return undefined;\n};\n\n/**\n * Elysia plugin that integrates Intlayer into your Elysia application.\n *\n * It handles:\n * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.\n * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.\n * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports\n *    for the duration of the request, through `AsyncLocalStorage`.\n *\n * @example\n * ```ts\n * import { Elysia } from 'elysia';\n * import { intlayer } from 'elysia-intlayer';\n *\n * const app = new Elysia()\n *   .use(intlayer())\n *   .get('/', ({ intlayer }) =>\n *     intlayer.t({\n *       en: 'Hello',\n *       fr: 'Bonjour',\n *     })\n *   );\n * ```\n */\nexport const intlayer = () => {\n  const configuration = getConfiguration();\n  const { internationalization } = configuration;\n\n  if (process.env['NODE_ENV'] === 'development') {\n    debug = (message: string) => console.debug(message);\n  }\n\n  prepareIntlayerServer(configuration, { label: 'elysia-intlayer' });\n\n  return new Elysia({ name: 'elysia-intlayer' })\n    .derive({ as: 'global' }, ({ request, cookie }) => {\n      /**\n       * Retrieves the locale from storage (cookies, headers).\n       */\n      const localeFromStorage = getLocaleFromStorageServer({\n        getCookie: (name: string) =>\n          cookie?.[name]?.value as string | undefined,\n        getHeader: (name: string) => request.headers.get(name) ?? undefined,\n      });\n\n      const negotiatorHeaders: Record<string, string> = {};\n      request.headers.forEach((value, key) => {\n        negotiatorHeaders[key] = value;\n      });\n\n      const localeDetected = localeDetector(\n        negotiatorHeaders,\n        internationalization.locales,\n        internationalization.defaultLocale\n      );\n\n      const locale = localeFromStorage ?? localeDetected;\n      const defaultLocale = internationalization.defaultLocale;\n\n      const getIntlayer: typeof getIntlayerFunction = (\n        key: Parameters<typeof getIntlayerFunction>[0],\n        localeArg = locale as Parameters<typeof getIntlayerFunction>[1],\n        ...props: any[]\n      ) => getIntlayerFunction(key, localeArg, ...props);\n\n      const getDictionary: typeof getDictionaryFunction = (\n        key: Parameters<typeof getDictionaryFunction>[0],\n        localeArg = locale as Parameters<typeof getDictionaryFunction>[1],\n        ...props: any[]\n      ) => getDictionaryFunction(key, localeArg, ...props);\n\n      const context: IntlayerContext = {\n        locale_storage: localeFromStorage,\n        locale_detected: localeDetected,\n        locale,\n        defaultLocale,\n        t: createTranslateFunction(locale, defaultLocale),\n        getIntlayer,\n        getDictionary,\n      };\n\n      // Elysia awaits every lifecycle hook of a request on the same async chain,\n      // so entering the store here keeps it available to the route handler.\n      intlayerStorage.enterWith({ current: context });\n\n      return { intlayer: context };\n    })\n    .mapResponse({ as: 'global' }, releaseContext)\n    .onError({ as: 'global' }, releaseContext);\n};\n\n/**\n * Translation function that retrieves content for the locale of the current request.\n *\n * Falls back to the configured default locale when called outside of a request\n * handled by the `intlayer` plugin.\n *\n * @example\n * ```ts\n * import { t } from 'elysia-intlayer';\n *\n * app.get('/', () => t({ en: 'Hello', fr: 'Bonjour' }));\n * ```\n */\nexport const t = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n): Content => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.t(content, locale);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.t` instead.'\n  );\n\n  const { internationalization } = getConfiguration();\n\n  return getTranslation(\n    content as StrictModeLocaleMap<Content>,\n    locale ?? internationalization.defaultLocale\n  );\n};\n\n/**\n * Retrieves a dictionary by key, using the locale of the current request by default.\n */\nexport const getIntlayer: typeof getIntlayerFunction = (\n  ...args: Parameters<typeof getIntlayerFunction>\n) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getIntlayer(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getIntlayer` instead.'\n  );\n\n  return getIntlayerFunction(...args);\n};\n\n/**\n * Retrieves an imported dictionary, using the locale of the current request by default.\n */\nexport const getDictionary: typeof getDictionaryFunction = (\n  ...args: Parameters<typeof getDictionaryFunction>\n) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getDictionary(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getDictionary` instead.'\n  );\n\n  return getDictionaryFunction(...args);\n};\n"],"mappings":";;;;;;;;;;;;;;;AAyDA,MAAM,kBAAkB,IAAI,kBAAsC;;;;AAKlE,MAAM,0BACJ,gBAAgB,SAAS,CAAC,EAAE;AAI9B,oCAAoC,kBAAkB,CAAC,EAAE,MAAM;AAG/D,IAAI,cAAyC,CAAC;;;;AAK9C,MAAM,2BACH,QAAgB,mBAEf,SACA,cACY;CACZ,MAAM,eAAe,aAAa;CAElC,IAAI,OAAO,YAAY,aACrB,OAAO;CAGT,IAAI,OAAO,YAAY,UACrB,OAAO;CAGT,IACE,OAAO,UACL,kBACI,aACN;EACA,IACE,OAAO,UACL,mBACI,aAEN,OAAO;EAGT,OAAO,eAAe,SAAS,aAAa;CAC9C;CAEA,OAAO,eAAe,SAAS,YAAY;AAC7C;;;;;;;AAQF,MAAM,uBAAkC;CACtC,MAAM,aAAa,gBAAgB,SAAS;CAE5C,IAAI,YACF,WAAW,UAAU;AAIzB;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,iBAAiB;CAC5B,MAAM,gBAAgB,iBAAiB;CACvC,MAAM,EAAE,yBAAyB;CAEjC,6BAAgC,eAC9B,SAAS,YAAoB,QAAQ,MAAM,OAAO;CAGpD,sBAAsB,eAAe,EAAE,OAAO,kBAAkB,CAAC;CAEjE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC,CAAC,CAC3C,OAAO,EAAE,IAAI,SAAS,IAAI,EAAE,SAAS,aAAa;;;;EAIjD,MAAM,oBAAoB,2BAA2B;GACnD,YAAY,SACV,SAAS,KAAK,EAAE;GAClB,YAAY,SAAiB,QAAQ,QAAQ,IAAI,IAAI,KAAK;EAC5D,CAAC;EAED,MAAM,oBAA4C,CAAC;EACnD,QAAQ,QAAQ,SAAS,OAAO,QAAQ;GACtC,kBAAkB,OAAO;EAC3B,CAAC;EAED,MAAM,iBAAiB,eACrB,mBACA,qBAAqB,SACrB,qBAAqB,aACvB;EAEA,MAAM,SAAS,qBAAqB;EACpC,MAAM,gBAAgB,qBAAqB;EAE3C,MAAM,eACJ,KACA,YAAY,QACZ,GAAG,UACAA,cAAoB,KAAK,WAAW,GAAG,KAAK;EAEjD,MAAM,iBACJ,KACA,YAAY,QACZ,GAAG,UACAC,gBAAsB,KAAK,WAAW,GAAG,KAAK;EAEnD,MAAM,UAA2B;GAC/B,gBAAgB;GAChB,iBAAiB;GACjB;GACA;GACA,GAAG,wBAAwB,QAAQ,aAAa;GAChD;GACA;EACF;EAIA,gBAAgB,UAAU,EAAE,SAAS,QAAQ,CAAC;EAE9C,OAAO,EAAE,UAAU,QAAQ;CAC7B,CAAC,CAAC,CACD,YAAY,EAAE,IAAI,SAAS,GAAG,cAAc,CAAC,CAC7C,QAAQ,EAAE,IAAI,SAAS,GAAG,cAAc;AAC7C;;;;;;;;;;;;;;AAeA,MAAa,KACX,SACA,WACY;CACZ,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,EAAE,SAAS,MAAM;CAGlC,MACE,6GACF;CAEA,MAAM,EAAE,yBAAyB,iBAAiB;CAElD,OAAO,eACL,SACA,UAAU,qBAAqB,aACjC;AACF;;;;AAKA,MAAa,eACX,GAAG,SACA;CACH,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,YAAY,GAAG,IAAI;CAGpC,MACE,uHACF;CAEA,OAAOD,cAAoB,GAAG,IAAI;AACpC;;;;AAKA,MAAa,iBACX,GAAG,SACA;CACH,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,cAAc,GAAG,IAAI;CAGtC,MACE,yHACF;CAEA,OAAOC,gBAAsB,GAAG,IAAI;AACtC"}
+{"version":3,"file":"index.mjs","names":["getIntlayerFunction","getDictionaryFunction"],"sources":["../../src/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { internationalization } from '@intlayer/config/built';\nimport { getConfiguration } from '@intlayer/config/node';\nimport {\n  getDictionary as getDictionaryFunction,\n  getIntlayer as getIntlayerFunction,\n  getTranslation,\n  registerAmbientLocaleResolver,\n} from '@intlayer/core/interpreter';\nimport { localeDetector } from '@intlayer/core/localization';\nimport { getCookie, getLocaleFromStorageServer } from '@intlayer/core/utils';\nimport { prepareIntlayerServer } from '@intlayer/engine/build';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport { Elysia } from 'elysia';\n\n/**\n * Translates a locale map into the content matching the current request locale.\n */\nexport type TranslateFunction = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n) => Content;\n\n/**\n * Intlayer state injected into every Elysia route context by the `intlayer` plugin.\n */\nexport type IntlayerContext = {\n  /** Locale explicitly requested by the client through a cookie or a header. */\n  locale_storage?: Locale;\n  /** Locale negotiated from the request headers (`Accept-Language`). */\n  locale_detected: Locale;\n  /** Locale to use for this request, `locale_storage` taking precedence. */\n  locale: Locale;\n  /** Locale configured as fallback in `intlayer.config.ts`. */\n  defaultLocale: Locale;\n  /** Translates an inline locale map. */\n  t: TranslateFunction;\n  /** Reads a dictionary by key, defaulting to the request locale. */\n  getIntlayer: typeof getIntlayerFunction;\n  /** Reads an imported dictionary, defaulting to the request locale. */\n  getDictionary: typeof getDictionaryFunction;\n};\n\n/**\n * Holder for the context of the request being handled.\n *\n * The request scope is opened around the whole request (see `wrap` below),\n * before Elysia builds the route context: the context is filled in later by\n * `derive`, once the locale is known.\n */\ntype IntlayerContextRef = { current?: IntlayerContext };\n\n/**\n * Per-request storage backing the standalone `t`, `getIntlayer` and `getDictionary` exports.\n */\nconst intlayerStorage = new AsyncLocalStorage<IntlayerContextRef>();\n\n/**\n * Returns the context of the request currently being handled, if any.\n */\nconst getRequestContext = (): IntlayerContext | undefined =>\n  intlayerStorage.getStore()?.current;\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => getRequestContext()?.locale);\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\n/**\n * Translates `content` into `locale`, falling back to the default locale.\n */\nconst translate = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale: Locale\n): Content =>\n  typeof content === 'string'\n    ? (content as Content)\n    : getTranslation(content, locale, internationalization.defaultLocale);\n\n/**\n * Elysia plugin that integrates Intlayer into your Elysia application.\n *\n * It handles:\n * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.\n * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.\n * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports\n *    for the whole request, through `AsyncLocalStorage`.\n *\n * @example\n * ```ts\n * import { Elysia } from 'elysia';\n * import { intlayer } from 'elysia-intlayer';\n *\n * const app = new Elysia()\n *   .use(intlayer())\n *   .get('/', ({ intlayer }) =>\n *     intlayer.t({\n *       en: 'Hello',\n *       fr: 'Bonjour',\n *     })\n *   );\n * ```\n */\nexport const intlayer = () => {\n  if (process.env['NODE_ENV'] === 'development') {\n    debug = (message: string) => console.debug(message);\n  }\n\n  prepareIntlayerServer(getConfiguration(), { label: 'elysia-intlayer' });\n\n  const { locales, defaultLocale } = internationalization;\n\n  return (\n    new Elysia({ name: 'elysia-intlayer' })\n      // Runs the whole request, hooks and streamed body included, in its own\n      // scope, so the context never leaks to the caller of `app.handle`\n      .wrap(\n        (handle) =>\n          (...parameters: unknown[]) =>\n            intlayerStorage.run({}, () => handle(...parameters))\n      )\n      .derive({ as: 'global' }, ({ request, cookie }) => {\n        const localeFromStorage = getLocaleFromStorageServer({\n          getCookie: (name: string) =>\n            (cookie?.[name]?.value as string | undefined) ??\n            getCookie(name, request.headers.get('cookie') ?? ''),\n          getHeader: (name: string) => request.headers.get(name) ?? undefined,\n        });\n\n        const localeDetected = localeDetector(\n          {\n            'accept-language':\n              request.headers.get('accept-language') ?? undefined,\n          },\n          locales,\n          defaultLocale\n        );\n\n        const locale = localeFromStorage ?? localeDetected;\n\n        const context: IntlayerContext = {\n          locale_storage: localeFromStorage,\n          locale_detected: localeDetected,\n          locale,\n          defaultLocale,\n          t: (content, localeArg) => translate(content, localeArg ?? locale),\n          getIntlayer: (\n            key,\n            localeArg = locale as typeof localeArg,\n            ...props\n          ) => getIntlayerFunction(key, localeArg, ...props),\n          getDictionary: (\n            key,\n            localeArg = locale as typeof localeArg,\n            ...props\n          ) => getDictionaryFunction(key, localeArg, ...props),\n        };\n\n        const contextRef = intlayerStorage.getStore();\n\n        if (contextRef) {\n          contextRef.current = context;\n        } else {\n          // Handler not wrapped (plugin registered after the handler was\n          // compiled): scope the context to the rest of this request instead\n          intlayerStorage.enterWith({ current: context });\n        }\n\n        return { intlayer: context };\n      })\n  );\n};\n\n/**\n * Translation function that retrieves content for the locale of the current request.\n *\n * Falls back to the configured default locale when called outside of a request\n * handled by the `intlayer` plugin.\n *\n * @example\n * ```ts\n * import { t } from 'elysia-intlayer';\n *\n * app.get('/', () => t({ en: 'Hello', fr: 'Bonjour' }));\n * ```\n */\nexport const t = <Content extends string>(\n  content: StrictModeLocaleMap<Content> | string,\n  locale?: Locale\n): Content => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.t(content, locale);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.t` instead.'\n  );\n\n  return translate(content, locale ?? internationalization.defaultLocale);\n};\n\n/**\n * Retrieves a dictionary by key, using the locale of the current request by default.\n */\nexport const getIntlayer: typeof getIntlayerFunction = (...args) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getIntlayer(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getIntlayer` instead.'\n  );\n\n  return getIntlayerFunction(...args);\n};\n\n/**\n * Retrieves an imported dictionary, using the locale of the current request by default.\n */\nexport const getDictionary: typeof getDictionaryFunction = (...args) => {\n  const context = getRequestContext();\n\n  if (context) {\n    return context.getDictionary(...args);\n  }\n\n  debug(\n    'Intlayer context not found. Add `.use(intlayer())` to your Elysia app, or use `context.intlayer.getDictionary` instead.'\n  );\n\n  return getDictionaryFunction(...args);\n};\n"],"mappings":";;;;;;;;;;;;;AAwDA,MAAM,kBAAkB,IAAI,kBAAsC;;;;AAKlE,MAAM,0BACJ,gBAAgB,SAAS,CAAC,EAAE;AAI9B,oCAAoC,kBAAkB,CAAC,EAAE,MAAM;AAG/D,IAAI,cAAyC,CAAC;;;;AAK9C,MAAM,aACJ,SACA,WAEA,OAAO,YAAY,WACd,UACD,eAAe,SAAS,QAAQ,qBAAqB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;AA0BxE,MAAa,iBAAiB;CAC5B,6BAAgC,eAC9B,SAAS,YAAoB,QAAQ,MAAM,OAAO;CAGpD,sBAAsB,iBAAiB,GAAG,EAAE,OAAO,kBAAkB,CAAC;CAEtE,MAAM,EAAE,SAAS,kBAAkB;CAEnC,OACE,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC,CAAC,CAGpC,MACE,YACE,GAAG,eACF,gBAAgB,IAAI,CAAC,SAAS,OAAO,GAAG,UAAU,CAAC,CACzD,CAAC,CACA,OAAO,EAAE,IAAI,SAAS,IAAI,EAAE,SAAS,aAAa;EACjD,MAAM,oBAAoB,2BAA2B;GACnD,YAAY,SACT,SAAS,KAAK,EAAE,SACjB,UAAU,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK,EAAE;GACrD,YAAY,SAAiB,QAAQ,QAAQ,IAAI,IAAI,KAAK;EAC5D,CAAC;EAED,MAAM,iBAAiB,eACrB,EACE,mBACE,QAAQ,QAAQ,IAAI,iBAAiB,KAAK,OAC9C,GACA,SACA,aACF;EAEA,MAAM,SAAS,qBAAqB;EAEpC,MAAM,UAA2B;GAC/B,gBAAgB;GAChB,iBAAiB;GACjB;GACA;GACA,IAAI,SAAS,cAAc,UAAU,SAAS,aAAa,MAAM;GACjE,cACE,KACA,YAAY,QACZ,GAAG,UACAA,cAAoB,KAAK,WAAW,GAAG,KAAK;GACjD,gBACE,KACA,YAAY,QACZ,GAAG,UACAC,gBAAsB,KAAK,WAAW,GAAG,KAAK;EACrD;EAEA,MAAM,aAAa,gBAAgB,SAAS;EAE5C,IAAI,YACF,WAAW,UAAU;OAIrB,gBAAgB,UAAU,EAAE,SAAS,QAAQ,CAAC;EAGhD,OAAO,EAAE,UAAU,QAAQ;CAC7B,CAAC;AAEP;;;;;;;;;;;;;;AAeA,MAAa,KACX,SACA,WACY;CACZ,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,EAAE,SAAS,MAAM;CAGlC,MACE,6GACF;CAEA,OAAO,UAAU,SAAS,UAAU,qBAAqB,aAAa;AACxE;;;;AAKA,MAAa,eAA2C,GAAG,SAAS;CAClE,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,YAAY,GAAG,IAAI;CAGpC,MACE,uHACF;CAEA,OAAOD,cAAoB,GAAG,IAAI;AACpC;;;;AAKA,MAAa,iBAA+C,GAAG,SAAS;CACtE,MAAM,UAAU,kBAAkB;CAElC,IAAI,SACF,OAAO,QAAQ,cAAc,GAAG,IAAI;CAGtC,MACE,yHACF;CAEA,OAAOC,gBAAsB,GAAG,IAAI;AACtC"}

package/dist/types/index.d.ts

@@ -33,7 +33,7 @@ export type IntlayerContext = {
  * 1. Locale detection from storage (cookies, headers) then from `Accept-Language`.
  * 2. Decorating the route context with an `intlayer` object exposing `t`, `getIntlayer` and `getDictionary`.
  * 3. Exposing the same helpers to the standalone `t`, `getIntlayer` and `getDictionary` exports
- *    for the duration of the request, through `AsyncLocalStorage`.
+ *    for the whole request, through `AsyncLocalStorage`.
  *
  * @example
  * ```ts
@@ -53,9 +53,9 @@ export type IntlayerContext = {
 export declare const intlayer: () => Elysia<"", {
   decorator: {};
   store: {};
-  derive: Partial<{
+  derive: {
     readonly intlayer: IntlayerContext;
-  }>;
+  };
   resolve: {};
 }, {
   typebox: {};
@@ -66,7 +66,9 @@ export declare const intlayer: () => Elysia<"", {
   macro: {};
   macroFn: {};
   parser: {};
-  response: {};
+  response: import("elysia").ExtractErrorFromHandle<{
+    readonly intlayer: IntlayerContext;
+  }>;
 }, {}, {
   derive: {};
   resolve: {};

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;;;YAkBY,qBAAqB,wBAC/B,SAAS,oBAAoB,mBAC7B,SAAS,WACN;;;;YAKO;;EAEV,iBAAiB;;EAEjB,iBAAiB;;EAEjB,QAAQ;;EAER,eAAe;;EAEf,GAAG;;EAEH,oBAAoB;;EAEpB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8GX,gBAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgFR,IAAK,wBAAsB,SAC7B,oBAAoB,mBAAiB,SACrC,WACR;;;;qBAsBU,oBAAoB;;;;qBAmBpB,sBAAsB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;;;YAmBY,qBAAqB,wBAC/B,SAAS,oBAAoB,mBAC7B,SAAS,WACN;;;;YAKO;;EAEV,iBAAiB;;EAEjB,iBAAiB;;EAEjB,QAAQ;;EAER,eAAe;;EAEf,GAAG;;EAEH,oBAAoB;;EAEpB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiEX,gBAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmFR,IAAK,wBAAsB,SAC7B,oBAAoB,mBAAiB,SACrC,WACR;;;;qBAiBU,oBAAoB;;;;qBAiBpB,sBAAsB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elysia-intlayer",
-  "version": "9.5.12",
+  "version": "9.6.0",
   "private": false,
   "description": "Manage internationalization i18n in a simple way for Elysia applications.",
   "keywords": [
@@ -76,10 +76,10 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/config": "9.5.12",
-    "@intlayer/core": "9.5.12",
-    "@intlayer/engine": "9.5.12",
-    "@intlayer/types": "9.5.12"
+    "@intlayer/config": "9.6.0",
+    "@intlayer/core": "9.6.0",
+    "@intlayer/engine": "9.6.0",
+    "@intlayer/types": "9.6.0"
   },
   "devDependencies": {
     "@types/node": "^22",
@@ -90,7 +90,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "vitest": "5.0.2"
+    "vitest": "5.0.3"
   },
   "peerDependencies": {
     "elysia": ">=1.0.0"