i18n-keyless-react 2.3.0 → 2.3.1

package/dist/request-scope.js

@@ -7,23 +7,36 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 // A single AsyncLocalStorage instance, created lazily on the server only. Each
-// `run()` creates an isolated store, so the instance is correctly a module singleton.
-let als;
-let alsInit;
+// `run()` creates an isolated store, so the instance is correctly a process singleton.
+//
+// CRITICAL: the instance is stored on `globalThis` under a `Symbol.for(...)` key, NOT in a
+// module-level variable. Bundlers that build separate server-entry and SSR-render
+// environments (e.g. TanStack Start / Vite SSR) instantiate this package more than once in
+// the same process. With a module-local `als`, `runWithI18nKeyless` (called from the server
+// entry) would set `als` on copy A, while `getRequestScope`/`recordUsedKey` (called during
+// the React render) would read copy B's `als` — `undefined` — and SSR would silently fall
+// back to the primary language with a hydration mismatch. Routing every read and write
+// through the shared `globalThis` slot guarantees all module copies use ONE ALS.
+const ALS_KEY = Symbol.for("i18n-keyless.als");
+const ALS_INIT_KEY = Symbol.for("i18n-keyless.alsInit");
+const registry = globalThis;
+function getAls() {
+    return registry[ALS_KEY];
+}
 async function ensureALS() {
     // Browser: no request scoping (single user → the store is correct). Also avoids
     // pulling a Node builtin into client bundles.
-    if (als || typeof window !== "undefined") {
+    if (registry[ALS_KEY] || typeof window !== "undefined") {
         return;
     }
-    if (!alsInit) {
-        alsInit = (async () => {
+    if (!registry[ALS_INIT_KEY]) {
+        registry[ALS_INIT_KEY] = (async () => {
             try {
                 // Variable specifier + ignore hints keep bundlers from trying to resolve a Node
                 // builtin into the browser graph. tsc keeps these comments (removeComments=false).
                 const specifier = "node:async_hooks";
                 const mod = (await import(__rewriteRelativeImportExtension(/* @vite-ignore */ /* webpackIgnore: true */ specifier)));
-                als = new mod.AsyncLocalStorage();
+                registry[ALS_KEY] = new mod.AsyncLocalStorage();
             }
             catch {
                 // AsyncLocalStorage unavailable (e.g. some edge runtimes). Scoping degrades to a
@@ -31,7 +44,7 @@ async function ensureALS() {
             }
         })();
     }
-    await alsInit;
+    await registry[ALS_INIT_KEY];
 }
 /**
  * Runs `fn` with a per-request translation scope active. Every `getTranslation(...)`
@@ -51,6 +64,7 @@ async function ensureALS() {
  */
 export async function runWithI18nKeyless(scope, fn) {
     await ensureALS();
+    const als = getAls();
     if (!als) {
         return fn();
     }
@@ -64,7 +78,7 @@ export async function runWithI18nKeyless(scope, fn) {
  * exported for advanced/server use.
  */
 export function getRequestScope() {
-    const s = als?.getStore();
+    const s = getAls()?.getStore();
     return s ? { lang: s.lang, translations: s.translations } : undefined;
 }
 /**
@@ -74,7 +88,7 @@ export function getRequestScope() {
  * `<I18nKeylessText>`.
  */
 export function recordUsedKey(key) {
-    als?.getStore()?.used.add(key);
+    getAls()?.getStore()?.used.add(key);
 }
 /**
  * Returns a snapshot containing ONLY the keys used during the current render (∩ the keys
@@ -87,7 +101,7 @@ export function recordUsedKey(key) {
  * client-side navigation has every key. Returns `undefined` outside a scope. See docs/SSR.md.
  */
 export function getUsedTranslationsSnapshot() {
-    const s = als?.getStore();
+    const s = getAls()?.getStore();
     if (!s) {
         return undefined;
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "i18n-keyless-react",
   "private": false,
-  "version": "2.3.0",
+  "version": "2.3.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -24,7 +24,7 @@
     "postpublish": "rm -rf ./dist && rm *.tgz"
   },
   "dependencies": {
-    "i18n-keyless-core": "2.3.0",
+    "i18n-keyless-core": "2.3.1",
     "zustand": "^5.0.3"
   },
   "peerDependencies": {