i18n-keyless-react 2.3.0 → 2.3.2

package/dist/request-scope.js

@@ -7,23 +7,45 @@ 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 — two layered problems, one solution:
+//
+//  1. A module-local `als` is duplicated when a bundler instantiates this package more than
+//     once (e.g. TanStack Start / Vite SSR build a separate server-entry and SSR-render
+//     environment). `runWithI18nKeyless` (server entry) would set `als` on copy A while
+//     `getRequestScope`/`recordUsedKey` (React render) read copy B's `als` — `undefined` —
+//     so SSR silently falls back to the primary language with a hydration mismatch.
+//
+//  2. Storing the instance on `globalThis` fixes (1) ONLY if the key is realm-independent.
+//     `Symbol.for()`'s registry is PER-REALM: TanStack Start / Vite SSR run the server entry
+//     and the React render in two different V8 realms that SHARE the same `globalThis` object
+//     but each resolve `Symbol.for("x")` to a DIFFERENT symbol — so the write-side and
+//     read-side miss each other even through one globalThis. (Confirmed empirically: same
+//     globalThis on both sides, yet getAls() returned the ALS on the server entry and
+//     `undefined` in the render.) A plain STRING key is realm-independent and bridges them.
+//
+// So: route every read and write through one `globalThis` slot keyed by a plain string.
+const ALS_KEY = "__i18n_keyless_als__";
+const ALS_INIT_KEY = "__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 +53,7 @@ async function ensureALS() {
             }
         })();
     }
-    await alsInit;
+    await registry[ALS_INIT_KEY];
 }
 /**
  * Runs `fn` with a per-request translation scope active. Every `getTranslation(...)`
@@ -51,6 +73,7 @@ async function ensureALS() {
  */
 export async function runWithI18nKeyless(scope, fn) {
     await ensureALS();
+    const als = getAls();
     if (!als) {
         return fn();
     }
@@ -64,7 +87,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 +97,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 +110,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.2",
   "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.2",
     "zustand": "^5.0.3"
   },
   "peerDependencies": {