hono-intlayer 9.5.12 → 9.6.0

package/dist/cjs/index.cjs

@@ -1,16 +1,15 @@
 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");
 let _intlayer_core_utils = require("@intlayer/core/utils");
 let _intlayer_engine_build = require("@intlayer/engine/build");
-let cls_hooked = require("cls-hooked");
 let hono_cookie = require("hono/cookie");
 
 //#region src/index.ts
 let debug = () => {};
-const configuration = (0, _intlayer_config_node.getConfiguration)();
-const { internationalization } = configuration;
 if (process.env.NODE_ENV === "development") debug = (msg) => console.debug(msg);
 /**
 * Retrieves the locale from storage (cookies, headers).
@@ -19,28 +18,27 @@ const getStorageLocale = (context) => (0, _intlayer_core_utils.getLocaleFromStor
 	getCookie: (name) => (0, hono_cookie.getCookie)(context, name),
 	getHeader: (name) => context.req.header(name)
 });
-const appNamespace = (0, cls_hooked.createNamespace)("app");
-(0, _intlayer_core_interpreter.registerAmbientLocaleResolver)(() => appNamespace.get("locale"));
-(0, _intlayer_engine_build.prepareIntlayerServer)(configuration, { label: "hono-intlayer" });
-const translateFunction = (context) => (content, locale) => {
-	const currentLocale = context.get("locale");
-	const defaultLocale = context.get("defaultLocale");
-	const targetLocale = locale ?? currentLocale;
-	if (typeof content === "undefined") return "";
-	if (typeof content === "string") return content;
-	if (typeof content?.[targetLocale] === "undefined") {
-		if (typeof content?.[defaultLocale] === "undefined") return content;
-		else return (0, _intlayer_core_interpreter.getTranslation)(content, defaultLocale);
-	}
-	return (0, _intlayer_core_interpreter.getTranslation)(content, targetLocale);
-};
+/**
+* Request-scoped Intlayer context.
+*
+* `AsyncLocalStorage` rather than `cls-hooked`: the latter relies on
+* `async_hooks.createHook`, which Bun does not implement, and is several times
+* slower on Node.
+*/
+const intlayerStorage = new node_async_hooks.AsyncLocalStorage();
+(0, _intlayer_core_interpreter.registerAmbientLocaleResolver)(() => intlayerStorage.getStore()?.locale);
+(0, _intlayer_engine_build.prepareIntlayerServer)((0, _intlayer_config_node.getConfiguration)(), { label: "hono-intlayer" });
+/**
+* Builds the translation function bound to the locale stored in the Hono context.
+*/
+const translateFunction = (context) => (content, locale) => typeof content === "string" ? content : (0, _intlayer_core_interpreter.getTranslation)(content, locale ?? context.get("locale"), _intlayer_config_built.internationalization.defaultLocale);
 /**
 * Hono middleware that detects the user's locale and populates context with Intlayer data.
 *
 * It performs:
 * 1. Locale detection from cookies, headers, or default settings.
 * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.
-* 3. Sets up a `cls-hooked` namespace for accessing these functions anywhere in the request lifecycle.
+* 3. Sets up an `AsyncLocalStorage` context for accessing these functions anywhere in the request lifecycle.
 *
 * @returns A Hono middleware function.
 *
@@ -53,31 +51,26 @@ const translateFunction = (context) => (content, locale) => {
 * app.use('*', intlayer());
 * ```
 */
-const intlayer = () => async (context, next) => {
+const intlayer = () => (context, next) => {
 	const localeFromStorage = getStorageLocale(context);
-	const negotiatorHeaders = context.req.header();
-	const localeDetected = (0, _intlayer_core_localization.localeDetector)(negotiatorHeaders, internationalization.locales, internationalization.defaultLocale);
+	const localeDetected = (0, _intlayer_core_localization.localeDetector)({ "accept-language": context.req.header("accept-language") }, _intlayer_config_built.internationalization.locales, _intlayer_config_built.internationalization.defaultLocale);
 	const locale = localeFromStorage ?? localeDetected;
 	context.set("locale_storage", localeFromStorage);
 	context.set("locale_detected", localeDetected);
 	context.set("locale", locale);
-	context.set("defaultLocale", internationalization.defaultLocale);
+	context.set("defaultLocale", _intlayer_config_built.internationalization.defaultLocale);
 	const t = translateFunction(context);
 	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);
 	context.set("t", t);
 	context.set("getIntlayer", getIntlayer);
 	context.set("getDictionary", getDictionary);
-	return new Promise((resolve) => {
-		appNamespace.run(async () => {
-			appNamespace.set("locale", locale);
-			appNamespace.set("t", t);
-			appNamespace.set("getIntlayer", getIntlayer);
-			appNamespace.set("getDictionary", getDictionary);
-			await next();
-			resolve();
-		});
-	});
+	return intlayerStorage.run({
+		locale,
+		t,
+		getIntlayer,
+		getDictionary
+	}, next);
 };
 /**
 * Translation function to retrieve content for the current locale.
@@ -102,34 +95,28 @@ const intlayer = () => async (context, next) => {
 * ```
 */
 const t = (content, locale) => {
-	try {
-		if (typeof appNamespace === "undefined") throw new Error("Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.");
-		if (typeof appNamespace.get("t") !== "function") throw new Error("Using the import { t } from \"hono-intlayer\" is not supported in your environment. Use the context instead.");
-		return appNamespace.get("t")(content, locale);
-	} catch (error) {
-		debug(error.message);
-		return (0, _intlayer_core_interpreter.getTranslation)(content, locale ?? internationalization.defaultLocale);
+	const context = intlayerStorage.getStore();
+	if (!context) {
+		debug("Using the import { t } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.");
+		return (0, _intlayer_core_interpreter.getTranslation)(content, locale ?? _intlayer_config_built.internationalization.defaultLocale);
 	}
+	return context.t(content, locale);
 };
 const getIntlayer = (...args) => {
-	try {
-		if (typeof appNamespace === "undefined") throw new Error("Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.");
-		if (typeof appNamespace.get("getIntlayer") !== "function") throw new Error("Using the import { getIntlayer } from \"hono-intlayer\" is not supported in your environment. Use the context instead.");
-		return appNamespace.get("getIntlayer")(...args);
-	} catch (error) {
-		debug(error.message);
+	const context = intlayerStorage.getStore();
+	if (!context) {
+		debug("Using the import { getIntlayer } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.");
 		return (0, _intlayer_core_interpreter.getIntlayer)(...args);
 	}
+	return context.getIntlayer(...args);
 };
 const getDictionary = (...args) => {
-	try {
-		if (typeof appNamespace === "undefined") throw new Error("Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.");
-		if (typeof appNamespace.get("getDictionary") !== "function") throw new Error("Using the import { getDictionary } from \"hono-intlayer\" is not supported in your environment. Use the context instead.");
-		return appNamespace.get("getDictionary")(...args);
-	} catch (error) {
-		debug(error.message);
+	const context = intlayerStorage.getStore();
+	if (!context) {
+		debug("Using the import { getDictionary } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.");
 		return (0, _intlayer_core_interpreter.getDictionary)(...args);
 	}
+	return context.getDictionary(...args);
 };
 
 //#endregion

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["getConfiguration","getLocaleFromStorageServer","getCookie","createNamespace","registerAmbientLocaleResolver","prepareIntlayerServer","getTranslation","localeDetector","getIntlayerFunction","getDictionaryFunction"],"sources":["../../src/index.ts"],"sourcesContent":["import { 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 { createNamespace } from 'cls-hooked';\nimport type { Context, MiddlewareHandler } from 'hono';\nimport { getCookie } from 'hono/cookie';\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\nconst configuration = getConfiguration();\nconst { internationalization } = configuration;\n\nif (process.env['NODE_ENV'] === 'development') {\n  debug = (msg: string) => console.debug(msg);\n}\n\n/**\n * Retrieves the locale from storage (cookies, headers).\n */\nconst getStorageLocale = (context: Context): Locale | undefined =>\n  getLocaleFromStorageServer({\n    getCookie: (name: string) => getCookie(context, name),\n    getHeader: (name: string) => context.req.header(name),\n  });\n\nconst appNamespace = createNamespace('app');\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => appNamespace.get('locale'));\n\nprepareIntlayerServer(configuration, { label: 'hono-intlayer' });\n\nexport const translateFunction =\n  (context: Context) =>\n  <T extends string>(\n    content: StrictModeLocaleMap<T> | string,\n    locale?: Locale\n  ): T => {\n    const currentLocale = context.get('locale') as Locale;\n    const defaultLocale = context.get('defaultLocale') as Locale;\n\n    const targetLocale = locale ?? currentLocale;\n\n    if (typeof content === 'undefined') {\n      return '' as unknown as T;\n    }\n\n    if (typeof content === 'string') {\n      return content as unknown as T;\n    }\n\n    if (\n      typeof content?.[\n        targetLocale as unknown as keyof StrictModeLocaleMap<T>\n      ] === 'undefined'\n    ) {\n      if (\n        typeof content?.[\n          defaultLocale as unknown as keyof StrictModeLocaleMap<T>\n        ] === 'undefined'\n      ) {\n        return content as unknown as T;\n      } else {\n        return getTranslation(content, defaultLocale);\n      }\n    }\n\n    return getTranslation(content, targetLocale);\n  };\n\n/**\n * Hono middleware that detects the user's locale and populates context with Intlayer data.\n *\n * It performs:\n * 1. Locale detection from cookies, headers, or default settings.\n * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.\n * 3. Sets up a `cls-hooked` namespace for accessing these functions anywhere in the request lifecycle.\n *\n * @returns A Hono middleware function.\n *\n * @example\n * ```ts\n * import { Hono } from 'hono';\n * import { intlayer } from 'hono-intlayer';\n *\n * const app = new Hono();\n * app.use('*', intlayer());\n * ```\n */\nexport const intlayer =\n  (): MiddlewareHandler =>\n  async (context: Context, next: () => Promise<void>) => {\n    // Detect if locale is set by intlayer frontend lib in the headers\n    const localeFromStorage = getStorageLocale(context);\n\n    const negotiatorHeaders: Record<string, string> = context.req.header();\n\n    const localeDetected = localeDetector(\n      negotiatorHeaders,\n      internationalization.locales,\n      internationalization.defaultLocale\n    );\n\n    const locale = localeFromStorage ?? localeDetected;\n\n    context.set('locale_storage', localeFromStorage);\n    context.set('locale_detected', localeDetected);\n    context.set('locale', locale);\n    context.set('defaultLocale', internationalization.defaultLocale);\n\n    const t = translateFunction(context);\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    context.set('t', t);\n    context.set('getIntlayer', getIntlayer);\n    context.set('getDictionary', getDictionary);\n\n    return new Promise<void>((resolve) => {\n      appNamespace.run(async () => {\n        appNamespace.set('locale', locale);\n        appNamespace.set('t', t);\n        appNamespace.set('getIntlayer', getIntlayer);\n        appNamespace.set('getDictionary', getDictionary);\n\n        await next();\n        resolve();\n      });\n    });\n  };\n\n/**\n * Translation function to retrieve content for the current locale.\n *\n * This function works within the request lifecycle managed by the `intlayer` middleware.\n *\n * @param content - A map of locales to content.\n * @param locale - Optional locale override.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * import { t } from 'hono-intlayer';\n *\n * app.get('/', (c) => {\n *   const greeting = t({\n *     en: 'Hello',\n *     fr: 'Bonjour',\n *   });\n *   return c.text(greeting);\n * });\n * ```\n */\nexport const t = <Content = string>(\n  content: StrictModeLocaleMap<Content>,\n  locale?: Locale\n): Content => {\n  try {\n    if (typeof appNamespace === 'undefined') {\n      throw new Error(\n        'Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.'\n      );\n    }\n\n    if (typeof appNamespace.get('t') !== 'function') {\n      throw new Error(\n        'Using the import { t } from \"hono-intlayer\" is not supported in your environment. Use the context instead.'\n      );\n    }\n\n    return appNamespace.get('t')(content, locale);\n  } catch (error) {\n    debug((error as Error).message);\n\n    return getTranslation(\n      content,\n      locale ?? internationalization.defaultLocale\n    );\n  }\n};\n\nexport const getIntlayer: typeof getIntlayerFunction = (\n  ...args: Parameters<typeof getIntlayerFunction>\n) => {\n  try {\n    if (typeof appNamespace === 'undefined') {\n      throw new Error(\n        'Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.'\n      );\n    }\n\n    if (typeof appNamespace.get('getIntlayer') !== 'function') {\n      throw new Error(\n        'Using the import { getIntlayer } from \"hono-intlayer\" is not supported in your environment. Use the context instead.'\n      );\n    }\n\n    return appNamespace.get('getIntlayer')(...args);\n  } catch (error) {\n    debug((error as Error).message);\n\n    return getIntlayerFunction(...args);\n  }\n};\n\nexport const getDictionary: typeof getDictionaryFunction = (\n  ...args: Parameters<typeof getDictionaryFunction>\n) => {\n  try {\n    if (typeof appNamespace === 'undefined') {\n      throw new Error(\n        'Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.'\n      );\n    }\n\n    if (typeof appNamespace.get('getDictionary') !== 'function') {\n      throw new Error(\n        'Using the import { getDictionary } from \"hono-intlayer\" is not supported in your environment. Use the context instead.'\n      );\n    }\n\n    return appNamespace.get('getDictionary')(...args);\n  } catch (error) {\n    debug((error as Error).message);\n\n    return getDictionaryFunction(...args);\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["getLocaleFromStorageServer","getCookie","AsyncLocalStorage","registerAmbientLocaleResolver","prepareIntlayerServer","getConfiguration","getTranslation","internationalization","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 { 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 type { Context, MiddlewareHandler } from 'hono';\nimport { getCookie } from 'hono/cookie';\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\nif (process.env['NODE_ENV'] === 'development') {\n  debug = (msg: string) => console.debug(msg);\n}\n\n/**\n * Retrieves the locale from storage (cookies, headers).\n */\nconst getStorageLocale = (context: Context): Locale | undefined =>\n  getLocaleFromStorageServer({\n    getCookie: (name: string) => getCookie(context, name),\n    getHeader: (name: string) => context.req.header(name),\n  });\n\n/**\n * Intlayer helpers bound to the request being handled.\n */\ntype IntlayerRequestContext = {\n  locale: Locale;\n  t: ReturnType<typeof translateFunction>;\n  getIntlayer: typeof getIntlayerFunction;\n  getDictionary: typeof getDictionaryFunction;\n};\n\n/**\n * Request-scoped Intlayer context.\n *\n * `AsyncLocalStorage` rather than `cls-hooked`: the latter relies on\n * `async_hooks.createHook`, which Bun does not implement, and is several times\n * slower on Node.\n */\nconst intlayerStorage = new AsyncLocalStorage<IntlayerRequestContext>();\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => intlayerStorage.getStore()?.locale);\n\nprepareIntlayerServer(getConfiguration(), { label: 'hono-intlayer' });\n\n/**\n * Builds the translation function bound to the locale stored in the Hono context.\n */\nexport const translateFunction =\n  (context: Context) =>\n  <T extends string>(\n    content: StrictModeLocaleMap<T> | string,\n    locale?: Locale\n  ): T =>\n    typeof content === 'string'\n      ? (content as T)\n      : getTranslation(\n          content,\n          locale ?? (context.get('locale') as Locale),\n          internationalization.defaultLocale\n        );\n\n/**\n * Hono middleware that detects the user's locale and populates context with Intlayer data.\n *\n * It performs:\n * 1. Locale detection from cookies, headers, or default settings.\n * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.\n * 3. Sets up an `AsyncLocalStorage` context for accessing these functions anywhere in the request lifecycle.\n *\n * @returns A Hono middleware function.\n *\n * @example\n * ```ts\n * import { Hono } from 'hono';\n * import { intlayer } from 'hono-intlayer';\n *\n * const app = new Hono();\n * app.use('*', intlayer());\n * ```\n */\nexport const intlayer =\n  (): MiddlewareHandler => (context: Context, next: () => Promise<void>) => {\n    // Detect if locale is set by intlayer frontend lib in the headers\n    const localeFromStorage = getStorageLocale(context);\n\n    const localeDetected = localeDetector(\n      { 'accept-language': context.req.header('accept-language') },\n      internationalization.locales,\n      internationalization.defaultLocale\n    );\n\n    const locale = localeFromStorage ?? localeDetected;\n\n    context.set('locale_storage', localeFromStorage);\n    context.set('locale_detected', localeDetected);\n    context.set('locale', locale);\n    context.set('defaultLocale', internationalization.defaultLocale);\n\n    const t = translateFunction(context);\n\n    const getIntlayer: typeof getIntlayerFunction = (\n      key,\n      localeArg = locale as typeof localeArg,\n      ...props\n    ) => getIntlayerFunction(key, localeArg, ...props);\n\n    const getDictionary: typeof getDictionaryFunction = (\n      key,\n      localeArg = locale as typeof localeArg,\n      ...props\n    ) => getDictionaryFunction(key, localeArg, ...props);\n\n    context.set('t', t);\n    context.set('getIntlayer', getIntlayer);\n    context.set('getDictionary', getDictionary);\n\n    return intlayerStorage.run({ locale, t, getIntlayer, getDictionary }, next);\n  };\n\n/**\n * Translation function to retrieve content for the current locale.\n *\n * This function works within the request lifecycle managed by the `intlayer` middleware.\n *\n * @param content - A map of locales to content.\n * @param locale - Optional locale override.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * import { t } from 'hono-intlayer';\n *\n * app.get('/', (c) => {\n *   const greeting = t({\n *     en: 'Hello',\n *     fr: 'Bonjour',\n *   });\n *   return c.text(greeting);\n * });\n * ```\n */\nexport const t = <Content = string>(\n  content: StrictModeLocaleMap<Content>,\n  locale?: Locale\n): Content => {\n  const context = intlayerStorage.getStore();\n\n  if (!context) {\n    debug(\n      'Using the import { t } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.'\n    );\n\n    return getTranslation(\n      content,\n      locale ?? internationalization.defaultLocale\n    );\n  }\n\n  return context.t(content as StrictModeLocaleMap<string>, locale) as Content;\n};\n\nexport const getIntlayer: typeof getIntlayerFunction = (\n  ...args: Parameters<typeof getIntlayerFunction>\n) => {\n  const context = intlayerStorage.getStore();\n\n  if (!context) {\n    debug(\n      'Using the import { getIntlayer } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.'\n    );\n\n    return getIntlayerFunction(...args);\n  }\n\n  return context.getIntlayer(...args);\n};\n\nexport const getDictionary: typeof getDictionaryFunction = (\n  ...args: Parameters<typeof getDictionaryFunction>\n) => {\n  const context = intlayerStorage.getStore();\n\n  if (!context) {\n    debug(\n      'Using the import { getDictionary } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.'\n    );\n\n    return getDictionaryFunction(...args);\n  }\n\n  return context.getDictionary(...args);\n};\n"],"mappings":";;;;;;;;;;;AAkBA,IAAI,cAAyC,CAAC;AAE9C,6BAAgC,eAC9B,SAAS,QAAgB,QAAQ,MAAM,GAAG;;;;AAM5C,MAAM,oBAAoB,gBACxBA,iDAA2B;CACzB,YAAY,aAAiBC,uBAAU,SAAS,IAAI;CACpD,YAAY,SAAiB,QAAQ,IAAI,OAAO,IAAI;AACtD,CAAC;;;;;;;;AAmBH,MAAM,kBAAkB,IAAIC,mCAA0C;IAItEC,gEAAoC,gBAAgB,SAAS,CAAC,EAAE,MAAM;IAEtEC,kDAAsBC,wCAAiB,GAAG,EAAE,OAAO,gBAAgB,CAAC;;;;AAKpE,MAAa,qBACV,aAEC,SACA,WAEA,OAAO,YAAY,WACd,cACDC,2CACE,SACA,UAAW,QAAQ,IAAI,QAAQ,GAC/BC,4CAAqB,aACvB;;;;;;;;;;;;;;;;;;;;AAqBR,MAAa,kBACe,SAAkB,SAA8B;CAExE,MAAM,oBAAoB,iBAAiB,OAAO;CAElD,MAAM,qBAAiBC,4CACrB,EAAE,mBAAmB,QAAQ,IAAI,OAAO,iBAAiB,EAAE,GAC3DD,4CAAqB,SACrBA,4CAAqB,aACvB;CAEA,MAAM,SAAS,qBAAqB;CAEpC,QAAQ,IAAI,kBAAkB,iBAAiB;CAC/C,QAAQ,IAAI,mBAAmB,cAAc;CAC7C,QAAQ,IAAI,UAAU,MAAM;CAC5B,QAAQ,IAAI,iBAAiBA,4CAAqB,aAAa;CAE/D,MAAM,IAAI,kBAAkB,OAAO;CAEnC,MAAM,eACJ,KACA,YAAY,QACZ,GAAG,cACAE,wCAAoB,KAAK,WAAW,GAAG,KAAK;CAEjD,MAAM,iBACJ,KACA,YAAY,QACZ,GAAG,cACAC,0CAAsB,KAAK,WAAW,GAAG,KAAK;CAEnD,QAAQ,IAAI,KAAK,CAAC;CAClB,QAAQ,IAAI,eAAe,WAAW;CACtC,QAAQ,IAAI,iBAAiB,aAAa;CAE1C,OAAO,gBAAgB,IAAI;EAAE;EAAQ;EAAG;EAAa;CAAc,GAAG,IAAI;AAC5E;;;;;;;;;;;;;;;;;;;;;;;AAwBF,MAAa,KACX,SACA,WACY;CACZ,MAAM,UAAU,gBAAgB,SAAS;CAEzC,IAAI,CAAC,SAAS;EACZ,MACE,qIACF;EAEA,WAAOJ,2CACL,SACA,UAAUC,4CAAqB,aACjC;CACF;CAEA,OAAO,QAAQ,EAAE,SAAwC,MAAM;AACjE;AAEA,MAAa,eACX,GAAG,SACA;CACH,MAAM,UAAU,gBAAgB,SAAS;CAEzC,IAAI,CAAC,SAAS;EACZ,MACE,+IACF;EAEA,WAAOE,wCAAoB,GAAG,IAAI;CACpC;CAEA,OAAO,QAAQ,YAAY,GAAG,IAAI;AACpC;AAEA,MAAa,iBACX,GAAG,SACA;CACH,MAAM,UAAU,gBAAgB,SAAS;CAEzC,IAAI,CAAC,SAAS;EACZ,MACE,iJACF;EAEA,WAAOC,0CAAsB,GAAG,IAAI;CACtC;CAEA,OAAO,QAAQ,cAAc,GAAG,IAAI;AACtC"}

package/dist/esm/index.mjs

@@ -1,15 +1,14 @@
+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 { prepareIntlayerServer } from "@intlayer/engine/build";
-import { createNamespace } from "cls-hooked";
 import { getCookie } from "hono/cookie";
 
 //#region src/index.ts
 let debug = () => {};
-const configuration = getConfiguration();
-const { internationalization } = configuration;
 if (process.env.NODE_ENV === "development") debug = (msg) => console.debug(msg);
 /**
 * Retrieves the locale from storage (cookies, headers).
@@ -18,28 +17,27 @@ const getStorageLocale = (context) => getLocaleFromStorageServer({
 	getCookie: (name) => getCookie(context, name),
 	getHeader: (name) => context.req.header(name)
 });
-const appNamespace = createNamespace("app");
-registerAmbientLocaleResolver(() => appNamespace.get("locale"));
-prepareIntlayerServer(configuration, { label: "hono-intlayer" });
-const translateFunction = (context) => (content, locale) => {
-	const currentLocale = context.get("locale");
-	const defaultLocale = context.get("defaultLocale");
-	const targetLocale = locale ?? currentLocale;
-	if (typeof content === "undefined") return "";
-	if (typeof content === "string") return content;
-	if (typeof content?.[targetLocale] === "undefined") {
-		if (typeof content?.[defaultLocale] === "undefined") return content;
-		else return getTranslation(content, defaultLocale);
-	}
-	return getTranslation(content, targetLocale);
-};
+/**
+* Request-scoped Intlayer context.
+*
+* `AsyncLocalStorage` rather than `cls-hooked`: the latter relies on
+* `async_hooks.createHook`, which Bun does not implement, and is several times
+* slower on Node.
+*/
+const intlayerStorage = new AsyncLocalStorage();
+registerAmbientLocaleResolver(() => intlayerStorage.getStore()?.locale);
+prepareIntlayerServer(getConfiguration(), { label: "hono-intlayer" });
+/**
+* Builds the translation function bound to the locale stored in the Hono context.
+*/
+const translateFunction = (context) => (content, locale) => typeof content === "string" ? content : getTranslation(content, locale ?? context.get("locale"), internationalization.defaultLocale);
 /**
 * Hono middleware that detects the user's locale and populates context with Intlayer data.
 *
 * It performs:
 * 1. Locale detection from cookies, headers, or default settings.
 * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.
-* 3. Sets up a `cls-hooked` namespace for accessing these functions anywhere in the request lifecycle.
+* 3. Sets up an `AsyncLocalStorage` context for accessing these functions anywhere in the request lifecycle.
 *
 * @returns A Hono middleware function.
 *
@@ -52,10 +50,9 @@ const translateFunction = (context) => (content, locale) => {
 * app.use('*', intlayer());
 * ```
 */
-const intlayer = () => async (context, next) => {
+const intlayer = () => (context, next) => {
 	const localeFromStorage = getStorageLocale(context);
-	const negotiatorHeaders = context.req.header();
-	const localeDetected = localeDetector(negotiatorHeaders, internationalization.locales, internationalization.defaultLocale);
+	const localeDetected = localeDetector({ "accept-language": context.req.header("accept-language") }, internationalization.locales, internationalization.defaultLocale);
 	const locale = localeFromStorage ?? localeDetected;
 	context.set("locale_storage", localeFromStorage);
 	context.set("locale_detected", localeDetected);
@@ -67,16 +64,12 @@ const intlayer = () => async (context, next) => {
 	context.set("t", t);
 	context.set("getIntlayer", getIntlayer);
 	context.set("getDictionary", getDictionary);
-	return new Promise((resolve) => {
-		appNamespace.run(async () => {
-			appNamespace.set("locale", locale);
-			appNamespace.set("t", t);
-			appNamespace.set("getIntlayer", getIntlayer);
-			appNamespace.set("getDictionary", getDictionary);
-			await next();
-			resolve();
-		});
-	});
+	return intlayerStorage.run({
+		locale,
+		t,
+		getIntlayer,
+		getDictionary
+	}, next);
 };
 /**
 * Translation function to retrieve content for the current locale.
@@ -101,34 +94,28 @@ const intlayer = () => async (context, next) => {
 * ```
 */
 const t = (content, locale) => {
-	try {
-		if (typeof appNamespace === "undefined") throw new Error("Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.");
-		if (typeof appNamespace.get("t") !== "function") throw new Error("Using the import { t } from \"hono-intlayer\" is not supported in your environment. Use the context instead.");
-		return appNamespace.get("t")(content, locale);
-	} catch (error) {
-		debug(error.message);
+	const context = intlayerStorage.getStore();
+	if (!context) {
+		debug("Using the import { t } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.");
 		return getTranslation(content, locale ?? internationalization.defaultLocale);
 	}
+	return context.t(content, locale);
 };
 const getIntlayer = (...args) => {
-	try {
-		if (typeof appNamespace === "undefined") throw new Error("Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.");
-		if (typeof appNamespace.get("getIntlayer") !== "function") throw new Error("Using the import { getIntlayer } from \"hono-intlayer\" is not supported in your environment. Use the context instead.");
-		return appNamespace.get("getIntlayer")(...args);
-	} catch (error) {
-		debug(error.message);
+	const context = intlayerStorage.getStore();
+	if (!context) {
+		debug("Using the import { getIntlayer } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.");
 		return getIntlayer$1(...args);
 	}
+	return context.getIntlayer(...args);
 };
 const getDictionary = (...args) => {
-	try {
-		if (typeof appNamespace === "undefined") throw new Error("Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.");
-		if (typeof appNamespace.get("getDictionary") !== "function") throw new Error("Using the import { getDictionary } from \"hono-intlayer\" is not supported in your environment. Use the context instead.");
-		return appNamespace.get("getDictionary")(...args);
-	} catch (error) {
-		debug(error.message);
+	const context = intlayerStorage.getStore();
+	if (!context) {
+		debug("Using the import { getDictionary } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.");
 		return getDictionary$1(...args);
 	}
+	return context.getDictionary(...args);
 };
 
 //#endregion

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["getIntlayerFunction","getDictionaryFunction"],"sources":["../../src/index.ts"],"sourcesContent":["import { 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 { createNamespace } from 'cls-hooked';\nimport type { Context, MiddlewareHandler } from 'hono';\nimport { getCookie } from 'hono/cookie';\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\nconst configuration = getConfiguration();\nconst { internationalization } = configuration;\n\nif (process.env['NODE_ENV'] === 'development') {\n  debug = (msg: string) => console.debug(msg);\n}\n\n/**\n * Retrieves the locale from storage (cookies, headers).\n */\nconst getStorageLocale = (context: Context): Locale | undefined =>\n  getLocaleFromStorageServer({\n    getCookie: (name: string) => getCookie(context, name),\n    getHeader: (name: string) => context.req.header(name),\n  });\n\nconst appNamespace = createNamespace('app');\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => appNamespace.get('locale'));\n\nprepareIntlayerServer(configuration, { label: 'hono-intlayer' });\n\nexport const translateFunction =\n  (context: Context) =>\n  <T extends string>(\n    content: StrictModeLocaleMap<T> | string,\n    locale?: Locale\n  ): T => {\n    const currentLocale = context.get('locale') as Locale;\n    const defaultLocale = context.get('defaultLocale') as Locale;\n\n    const targetLocale = locale ?? currentLocale;\n\n    if (typeof content === 'undefined') {\n      return '' as unknown as T;\n    }\n\n    if (typeof content === 'string') {\n      return content as unknown as T;\n    }\n\n    if (\n      typeof content?.[\n        targetLocale as unknown as keyof StrictModeLocaleMap<T>\n      ] === 'undefined'\n    ) {\n      if (\n        typeof content?.[\n          defaultLocale as unknown as keyof StrictModeLocaleMap<T>\n        ] === 'undefined'\n      ) {\n        return content as unknown as T;\n      } else {\n        return getTranslation(content, defaultLocale);\n      }\n    }\n\n    return getTranslation(content, targetLocale);\n  };\n\n/**\n * Hono middleware that detects the user's locale and populates context with Intlayer data.\n *\n * It performs:\n * 1. Locale detection from cookies, headers, or default settings.\n * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.\n * 3. Sets up a `cls-hooked` namespace for accessing these functions anywhere in the request lifecycle.\n *\n * @returns A Hono middleware function.\n *\n * @example\n * ```ts\n * import { Hono } from 'hono';\n * import { intlayer } from 'hono-intlayer';\n *\n * const app = new Hono();\n * app.use('*', intlayer());\n * ```\n */\nexport const intlayer =\n  (): MiddlewareHandler =>\n  async (context: Context, next: () => Promise<void>) => {\n    // Detect if locale is set by intlayer frontend lib in the headers\n    const localeFromStorage = getStorageLocale(context);\n\n    const negotiatorHeaders: Record<string, string> = context.req.header();\n\n    const localeDetected = localeDetector(\n      negotiatorHeaders,\n      internationalization.locales,\n      internationalization.defaultLocale\n    );\n\n    const locale = localeFromStorage ?? localeDetected;\n\n    context.set('locale_storage', localeFromStorage);\n    context.set('locale_detected', localeDetected);\n    context.set('locale', locale);\n    context.set('defaultLocale', internationalization.defaultLocale);\n\n    const t = translateFunction(context);\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    context.set('t', t);\n    context.set('getIntlayer', getIntlayer);\n    context.set('getDictionary', getDictionary);\n\n    return new Promise<void>((resolve) => {\n      appNamespace.run(async () => {\n        appNamespace.set('locale', locale);\n        appNamespace.set('t', t);\n        appNamespace.set('getIntlayer', getIntlayer);\n        appNamespace.set('getDictionary', getDictionary);\n\n        await next();\n        resolve();\n      });\n    });\n  };\n\n/**\n * Translation function to retrieve content for the current locale.\n *\n * This function works within the request lifecycle managed by the `intlayer` middleware.\n *\n * @param content - A map of locales to content.\n * @param locale - Optional locale override.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * import { t } from 'hono-intlayer';\n *\n * app.get('/', (c) => {\n *   const greeting = t({\n *     en: 'Hello',\n *     fr: 'Bonjour',\n *   });\n *   return c.text(greeting);\n * });\n * ```\n */\nexport const t = <Content = string>(\n  content: StrictModeLocaleMap<Content>,\n  locale?: Locale\n): Content => {\n  try {\n    if (typeof appNamespace === 'undefined') {\n      throw new Error(\n        'Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.'\n      );\n    }\n\n    if (typeof appNamespace.get('t') !== 'function') {\n      throw new Error(\n        'Using the import { t } from \"hono-intlayer\" is not supported in your environment. Use the context instead.'\n      );\n    }\n\n    return appNamespace.get('t')(content, locale);\n  } catch (error) {\n    debug((error as Error).message);\n\n    return getTranslation(\n      content,\n      locale ?? internationalization.defaultLocale\n    );\n  }\n};\n\nexport const getIntlayer: typeof getIntlayerFunction = (\n  ...args: Parameters<typeof getIntlayerFunction>\n) => {\n  try {\n    if (typeof appNamespace === 'undefined') {\n      throw new Error(\n        'Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.'\n      );\n    }\n\n    if (typeof appNamespace.get('getIntlayer') !== 'function') {\n      throw new Error(\n        'Using the import { getIntlayer } from \"hono-intlayer\" is not supported in your environment. Use the context instead.'\n      );\n    }\n\n    return appNamespace.get('getIntlayer')(...args);\n  } catch (error) {\n    debug((error as Error).message);\n\n    return getIntlayerFunction(...args);\n  }\n};\n\nexport const getDictionary: typeof getDictionaryFunction = (\n  ...args: Parameters<typeof getDictionaryFunction>\n) => {\n  try {\n    if (typeof appNamespace === 'undefined') {\n      throw new Error(\n        'Intlayer is not initialized. Add the `app.use(\"*\", intlayer());` middleware before using this function.'\n      );\n    }\n\n    if (typeof appNamespace.get('getDictionary') !== 'function') {\n      throw new Error(\n        'Using the import { getDictionary } from \"hono-intlayer\" is not supported in your environment. Use the context instead.'\n      );\n    }\n\n    return appNamespace.get('getDictionary')(...args);\n  } catch (error) {\n    debug((error as Error).message);\n\n    return getDictionaryFunction(...args);\n  }\n};\n"],"mappings":"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"}
+{"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 { 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 type { Context, MiddlewareHandler } from 'hono';\nimport { getCookie } from 'hono/cookie';\n\n// Zero-cost fallback, will be updated with console logger in dev mode\nlet debug: (message: string) => void = () => {};\n\nif (process.env['NODE_ENV'] === 'development') {\n  debug = (msg: string) => console.debug(msg);\n}\n\n/**\n * Retrieves the locale from storage (cookies, headers).\n */\nconst getStorageLocale = (context: Context): Locale | undefined =>\n  getLocaleFromStorageServer({\n    getCookie: (name: string) => getCookie(context, name),\n    getHeader: (name: string) => context.req.header(name),\n  });\n\n/**\n * Intlayer helpers bound to the request being handled.\n */\ntype IntlayerRequestContext = {\n  locale: Locale;\n  t: ReturnType<typeof translateFunction>;\n  getIntlayer: typeof getIntlayerFunction;\n  getDictionary: typeof getDictionaryFunction;\n};\n\n/**\n * Request-scoped Intlayer context.\n *\n * `AsyncLocalStorage` rather than `cls-hooked`: the latter relies on\n * `async_hooks.createHook`, which Bun does not implement, and is several times\n * slower on Node.\n */\nconst intlayerStorage = new AsyncLocalStorage<IntlayerRequestContext>();\n\n// Lets a bare `getIntlayer` / `getDictionary` from any Intlayer package resolve\n// to the locale of the request being handled.\nregisterAmbientLocaleResolver(() => intlayerStorage.getStore()?.locale);\n\nprepareIntlayerServer(getConfiguration(), { label: 'hono-intlayer' });\n\n/**\n * Builds the translation function bound to the locale stored in the Hono context.\n */\nexport const translateFunction =\n  (context: Context) =>\n  <T extends string>(\n    content: StrictModeLocaleMap<T> | string,\n    locale?: Locale\n  ): T =>\n    typeof content === 'string'\n      ? (content as T)\n      : getTranslation(\n          content,\n          locale ?? (context.get('locale') as Locale),\n          internationalization.defaultLocale\n        );\n\n/**\n * Hono middleware that detects the user's locale and populates context with Intlayer data.\n *\n * It performs:\n * 1. Locale detection from cookies, headers, or default settings.\n * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.\n * 3. Sets up an `AsyncLocalStorage` context for accessing these functions anywhere in the request lifecycle.\n *\n * @returns A Hono middleware function.\n *\n * @example\n * ```ts\n * import { Hono } from 'hono';\n * import { intlayer } from 'hono-intlayer';\n *\n * const app = new Hono();\n * app.use('*', intlayer());\n * ```\n */\nexport const intlayer =\n  (): MiddlewareHandler => (context: Context, next: () => Promise<void>) => {\n    // Detect if locale is set by intlayer frontend lib in the headers\n    const localeFromStorage = getStorageLocale(context);\n\n    const localeDetected = localeDetector(\n      { 'accept-language': context.req.header('accept-language') },\n      internationalization.locales,\n      internationalization.defaultLocale\n    );\n\n    const locale = localeFromStorage ?? localeDetected;\n\n    context.set('locale_storage', localeFromStorage);\n    context.set('locale_detected', localeDetected);\n    context.set('locale', locale);\n    context.set('defaultLocale', internationalization.defaultLocale);\n\n    const t = translateFunction(context);\n\n    const getIntlayer: typeof getIntlayerFunction = (\n      key,\n      localeArg = locale as typeof localeArg,\n      ...props\n    ) => getIntlayerFunction(key, localeArg, ...props);\n\n    const getDictionary: typeof getDictionaryFunction = (\n      key,\n      localeArg = locale as typeof localeArg,\n      ...props\n    ) => getDictionaryFunction(key, localeArg, ...props);\n\n    context.set('t', t);\n    context.set('getIntlayer', getIntlayer);\n    context.set('getDictionary', getDictionary);\n\n    return intlayerStorage.run({ locale, t, getIntlayer, getDictionary }, next);\n  };\n\n/**\n * Translation function to retrieve content for the current locale.\n *\n * This function works within the request lifecycle managed by the `intlayer` middleware.\n *\n * @param content - A map of locales to content.\n * @param locale - Optional locale override.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * import { t } from 'hono-intlayer';\n *\n * app.get('/', (c) => {\n *   const greeting = t({\n *     en: 'Hello',\n *     fr: 'Bonjour',\n *   });\n *   return c.text(greeting);\n * });\n * ```\n */\nexport const t = <Content = string>(\n  content: StrictModeLocaleMap<Content>,\n  locale?: Locale\n): Content => {\n  const context = intlayerStorage.getStore();\n\n  if (!context) {\n    debug(\n      'Using the import { t } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.'\n    );\n\n    return getTranslation(\n      content,\n      locale ?? internationalization.defaultLocale\n    );\n  }\n\n  return context.t(content as StrictModeLocaleMap<string>, locale) as Content;\n};\n\nexport const getIntlayer: typeof getIntlayerFunction = (\n  ...args: Parameters<typeof getIntlayerFunction>\n) => {\n  const context = intlayerStorage.getStore();\n\n  if (!context) {\n    debug(\n      'Using the import { getIntlayer } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.'\n    );\n\n    return getIntlayerFunction(...args);\n  }\n\n  return context.getIntlayer(...args);\n};\n\nexport const getDictionary: typeof getDictionaryFunction = (\n  ...args: Parameters<typeof getDictionaryFunction>\n) => {\n  const context = intlayerStorage.getStore();\n\n  if (!context) {\n    debug(\n      'Using the import { getDictionary } from \"hono-intlayer\" outside of a request handled by the `intlayer()` middleware. Use the context instead.'\n    );\n\n    return getDictionaryFunction(...args);\n  }\n\n  return context.getDictionary(...args);\n};\n"],"mappings":";;;;;;;;;;AAkBA,IAAI,cAAyC,CAAC;AAE9C,6BAAgC,eAC9B,SAAS,QAAgB,QAAQ,MAAM,GAAG;;;;AAM5C,MAAM,oBAAoB,YACxB,2BAA2B;CACzB,YAAY,SAAiB,UAAU,SAAS,IAAI;CACpD,YAAY,SAAiB,QAAQ,IAAI,OAAO,IAAI;AACtD,CAAC;;;;;;;;AAmBH,MAAM,kBAAkB,IAAI,kBAA0C;AAItE,oCAAoC,gBAAgB,SAAS,CAAC,EAAE,MAAM;AAEtE,sBAAsB,iBAAiB,GAAG,EAAE,OAAO,gBAAgB,CAAC;;;;AAKpE,MAAa,qBACV,aAEC,SACA,WAEA,OAAO,YAAY,WACd,UACD,eACE,SACA,UAAW,QAAQ,IAAI,QAAQ,GAC/B,qBAAqB,aACvB;;;;;;;;;;;;;;;;;;;;AAqBR,MAAa,kBACe,SAAkB,SAA8B;CAExE,MAAM,oBAAoB,iBAAiB,OAAO;CAElD,MAAM,iBAAiB,eACrB,EAAE,mBAAmB,QAAQ,IAAI,OAAO,iBAAiB,EAAE,GAC3D,qBAAqB,SACrB,qBAAqB,aACvB;CAEA,MAAM,SAAS,qBAAqB;CAEpC,QAAQ,IAAI,kBAAkB,iBAAiB;CAC/C,QAAQ,IAAI,mBAAmB,cAAc;CAC7C,QAAQ,IAAI,UAAU,MAAM;CAC5B,QAAQ,IAAI,iBAAiB,qBAAqB,aAAa;CAE/D,MAAM,IAAI,kBAAkB,OAAO;CAEnC,MAAM,eACJ,KACA,YAAY,QACZ,GAAG,UACAA,cAAoB,KAAK,WAAW,GAAG,KAAK;CAEjD,MAAM,iBACJ,KACA,YAAY,QACZ,GAAG,UACAC,gBAAsB,KAAK,WAAW,GAAG,KAAK;CAEnD,QAAQ,IAAI,KAAK,CAAC;CAClB,QAAQ,IAAI,eAAe,WAAW;CACtC,QAAQ,IAAI,iBAAiB,aAAa;CAE1C,OAAO,gBAAgB,IAAI;EAAE;EAAQ;EAAG;EAAa;CAAc,GAAG,IAAI;AAC5E;;;;;;;;;;;;;;;;;;;;;;;AAwBF,MAAa,KACX,SACA,WACY;CACZ,MAAM,UAAU,gBAAgB,SAAS;CAEzC,IAAI,CAAC,SAAS;EACZ,MACE,qIACF;EAEA,OAAO,eACL,SACA,UAAU,qBAAqB,aACjC;CACF;CAEA,OAAO,QAAQ,EAAE,SAAwC,MAAM;AACjE;AAEA,MAAa,eACX,GAAG,SACA;CACH,MAAM,UAAU,gBAAgB,SAAS;CAEzC,IAAI,CAAC,SAAS;EACZ,MACE,+IACF;EAEA,OAAOD,cAAoB,GAAG,IAAI;CACpC;CAEA,OAAO,QAAQ,YAAY,GAAG,IAAI;AACpC;AAEA,MAAa,iBACX,GAAG,SACA;CACH,MAAM,UAAU,gBAAgB,SAAS;CAEzC,IAAI,CAAC,SAAS;EACZ,MACE,iJACF;EAEA,OAAOC,gBAAsB,GAAG,IAAI;CACtC;CAEA,OAAO,QAAQ,cAAc,GAAG,IAAI;AACtC"}

package/dist/types/index.d.ts

@@ -3,6 +3,9 @@ import { Locale } from "@intlayer/types/allLocales";
 import { StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
 import { Context, MiddlewareHandler } from "hono";
 //#region src/index.d.ts
+/**
+ * Builds the translation function bound to the locale stored in the Hono context.
+ */
 export declare const translateFunction: (context: Context) => <T extends string>(content: StrictModeLocaleMap<T> | string, locale?: Locale) => T;
 /**
  * Hono middleware that detects the user's locale and populates context with Intlayer data.
@@ -10,7 +13,7 @@ export declare const translateFunction: (context: Context) => <T extends string>
  * It performs:
  * 1. Locale detection from cookies, headers, or default settings.
  * 2. Injects `t`, `getIntlayer`, and `getDictionary` functions into the context.
- * 3. Sets up a `cls-hooked` namespace for accessing these functions anywhere in the request lifecycle.
+ * 3. Sets up an `AsyncLocalStorage` context for accessing these functions anywhere in the request lifecycle.
  *
  * @returns A Hono middleware function.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;qBA2Ca,oBAAiB,SAClB,aACT,kBAAgB,SACN,oBAAoB,aAAW,SAC/B,WACR;;;;;;;;;;;;;;;;;;;;qBAoDQ,gBACP;;;;;;;;;;;;;;;;;;;;;;;qBAyEO,IAAK,kBAAgB,SACvB,oBAAoB,UAAQ,SAC5B,WACR;qBAyBU,oBAAoB;qBAwBpB,sBAAsB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;;;qBA6Da,oBAAiB,SAClB,aACT,kBAAgB,SACN,oBAAoB,aAAW,SAC/B,WACR;;;;;;;;;;;;;;;;;;;;qBA4BQ,gBACP;;;;;;;;;;;;;;;;;;;;;;;qBA4DO,IAAK,kBAAgB,SACvB,oBAAoB,UAAQ,SAC5B,WACR;qBAiBU,oBAAoB;qBAgBpB,sBAAsB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-intlayer",
-  "version": "9.5.12",
+  "version": "9.6.0",
   "private": false,
   "description": "Manage internationalization i18n in a simple way for hono application.",
   "keywords": [
@@ -76,14 +76,12 @@
     "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",
-    "cls-hooked": "4.2.2"
+    "@intlayer/config": "9.6.0",
+    "@intlayer/core": "9.6.0",
+    "@intlayer/engine": "9.6.0",
+    "@intlayer/types": "9.6.0"
   },
   "devDependencies": {
-    "@types/cls-hooked": "4.3.9",
     "@types/node": "^22",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
@@ -92,7 +90,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "vitest": "5.0.2"
+    "vitest": "5.0.3"
   },
   "engines": {
     "node": ">=14.18"