@cosmicdrift/kumiko-dispatcher-live 0.211.0 → 0.213.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dispatcher-live",
-  "version": "0.211.0",
+  "version": "0.213.0",
   "description": "HTTP-only Dispatcher for Kumiko UIs. Always-online; failures surface immediately. Default client for web admin/cockpit apps.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-headless": "0.211.0"
+    "@cosmicdrift/kumiko-headless": "0.213.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/src/dispatcher-live.ts

@@ -15,6 +15,7 @@ import {
 } from "@cosmicdrift/kumiko-headless";
 import { CSRF_HEADER_NAME, readCsrfToken } from "./csrf";
 import { buildAbortError, buildNetworkError, mapServerError } from "./error-mapping";
+import { LOCALE_HEADER_NAME, readActiveLocale } from "./locale";
 import { iterateSseChunks } from "./sse-stream";
 
 // HTTP-only dispatcher. Maps Kumiko's client-side Dispatcher contract to
@@ -103,6 +104,8 @@ export function createLiveDispatcher(options: LiveDispatcherOptions = {}): Dispa
     };
     const csrf = readCsrf();
     if (csrf !== undefined) headers[CSRF_HEADER_NAME] = csrf;
+    const locale = readActiveLocale();
+    if (locale !== undefined) headers[LOCALE_HEADER_NAME] = locale;
     // If no CSRF token, still send the request — public / pre-login
     // routes like /auth/login don't require CSRF, and POST /write/query/
     // batch against a logged-out client returns 401 via auth-middleware
@@ -204,6 +207,8 @@ export function createLiveDispatcher(options: LiveDispatcherOptions = {}): Dispa
       };
       const csrf = readCsrf();
       if (csrf !== undefined) headers[CSRF_HEADER_NAME] = csrf;
+      const locale = readActiveLocale();
+      if (locale !== undefined) headers[LOCALE_HEADER_NAME] = locale;
 
       let response: Response;
       try {

package/src/index.ts

@@ -2,5 +2,6 @@ export { CSRF_COOKIE_NAME, CSRF_HEADER_NAME, readCsrfToken } from "./csrf";
 export type { LiveDispatcherOptions } from "./dispatcher-live";
 export { createLiveDispatcher } from "./dispatcher-live";
 export { buildAbortError, buildNetworkError, mapServerError } from "./error-mapping";
+export { LOCALE_HEADER_NAME, readActiveLocale } from "./locale";
 export type { SseFrame } from "./sse-stream";
 export { iterateSseChunks, parseSseBlock, parseSseFrames } from "./sse-stream";

package/src/locale.ts

@@ -0,0 +1,22 @@
+// Active-locale header transport for the live dispatcher.
+//
+// @cosmicdrift/kumiko-renderer-web's DocumentLangSync (mounted by
+// createKumikoApp/createPublicSurface) keeps document.documentElement.lang in
+// sync with the app's LocaleResolver. This module reads that value back so
+// every outgoing request carries the language the user is ACTUALLY using —
+// not the app's hardcoded boot language — with zero app-side wiring.
+
+// Kept in sync with LOCALE_HEADER_NAME in api-constants.ts by hand rather
+// than imported from @cosmicdrift/kumiko-framework — this package must
+// remain server-dep-free (runs in browsers and React Native).
+export const LOCALE_HEADER_NAME = "X-Locale";
+
+// Reads document.documentElement.lang. Returns undefined for non-browser
+// environments (SSR, Web Worker, React Native) or before any provider has
+// set a lang yet — callers skip the header in that case and the server
+// falls back to Accept-Language, then its boot default.
+export function readActiveLocale(): string | undefined {
+  const g = globalThis as { document?: { documentElement?: { lang?: string } } };
+  const lang = g.document?.documentElement?.lang;
+  return lang !== undefined && lang.length > 0 ? lang : undefined;
+}