@shipeasy/sdk 2.1.7 → 2.1.8

package/dist/client/index.d.mts

@@ -192,37 +192,31 @@ interface LabelAttrs {
     "data-label-desc"?: string;
 }
 declare function labelAttrs(key: string, variables?: Record<string, string | number>, desc?: string): LabelAttrs;
-/**
- * Universal i18n facade. Backed by the `window.i18n` global the loader
- * script installs. Returns the key itself when the loader hasn't run
- * (SSR, missing script tag, before profile fetch completes), so call
- * sites never need to null-check.
- */
-declare const i18n: {
-    t(key: string, variables?: Record<string, string | number>): string;
-    /**
-     * Translate a key and return a framework element (e.g. React <span>)
-     * carrying `data-label` / `data-variables` attributes so the ShipEasy
-     * devtools "Edit labels" overlay can highlight and edit it in place.
-     *
-     * Requires a one-time setup call: `i18n.configure({ createElement })`.
-     * The returned value is whatever `createElement` returns — pass React's
-     * `createElement`, Vue's `h`, Solid's `createSignal`-based factory, etc.
-     *
-     * Falls back to a plain translated string if `createElement` was not
-     * configured (e.g. server-side or in non-JSX contexts).
-     */
-    tEl(key: string, fallback: string, variables?: Record<string, string | number>, desc?: string): any;
-    /** Wire up the element creator once at app startup (call before any tEl use). */
+type I18nVariables = Record<string, string | number | null | undefined>;
+type I18nTagRenderer = (content: string) => unknown;
+type I18nRichComponents = Record<string, I18nTagRenderer>;
+declare const __i18nKeyBrand: unique symbol;
+declare const __i18nStringBrand: unique symbol;
+type I18nKey = string & {
+    readonly [__i18nKeyBrand]?: never;
+};
+type I18nString = string & {
+    readonly [__i18nStringBrand]?: never;
+};
+interface I18nFacade {
+    t<F extends string>(key: I18nKey, fallback: F, variables?: I18nVariables): F & I18nString;
+    t(key: I18nKey, variables?: I18nVariables): I18nString;
+    rich(key: I18nKey, fallback: string, components?: I18nRichComponents, variables?: I18nVariables): unknown;
+    tEl<F extends string>(key: I18nKey, fallback: F, variables?: I18nVariables, desc?: string): F & I18nString;
     configure(opts: {
-        createElement: (tag: string, props: object, children: string) => any;
+        components?: I18nRichComponents;
+        createElement?: (tag: string, props: object, children: string) => unknown;
     }): void;
     readonly locale: string | null;
     readonly ready: boolean;
-    /** Resolves when the loader has installed window.i18n and fetched a profile. */
     whenReady(): Promise<void>;
-    /** Subscribe to locale/profile updates. Returns an unsubscribe fn. */
     onUpdate(cb: () => void): () => void;
-};
+}
+declare const i18n: I18nFacade;
 
-export { type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };
+export { type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };

package/dist/client/index.d.ts

@@ -192,37 +192,31 @@ interface LabelAttrs {
     "data-label-desc"?: string;
 }
 declare function labelAttrs(key: string, variables?: Record<string, string | number>, desc?: string): LabelAttrs;
-/**
- * Universal i18n facade. Backed by the `window.i18n` global the loader
- * script installs. Returns the key itself when the loader hasn't run
- * (SSR, missing script tag, before profile fetch completes), so call
- * sites never need to null-check.
- */
-declare const i18n: {
-    t(key: string, variables?: Record<string, string | number>): string;
-    /**
-     * Translate a key and return a framework element (e.g. React <span>)
-     * carrying `data-label` / `data-variables` attributes so the ShipEasy
-     * devtools "Edit labels" overlay can highlight and edit it in place.
-     *
-     * Requires a one-time setup call: `i18n.configure({ createElement })`.
-     * The returned value is whatever `createElement` returns — pass React's
-     * `createElement`, Vue's `h`, Solid's `createSignal`-based factory, etc.
-     *
-     * Falls back to a plain translated string if `createElement` was not
-     * configured (e.g. server-side or in non-JSX contexts).
-     */
-    tEl(key: string, fallback: string, variables?: Record<string, string | number>, desc?: string): any;
-    /** Wire up the element creator once at app startup (call before any tEl use). */
+type I18nVariables = Record<string, string | number | null | undefined>;
+type I18nTagRenderer = (content: string) => unknown;
+type I18nRichComponents = Record<string, I18nTagRenderer>;
+declare const __i18nKeyBrand: unique symbol;
+declare const __i18nStringBrand: unique symbol;
+type I18nKey = string & {
+    readonly [__i18nKeyBrand]?: never;
+};
+type I18nString = string & {
+    readonly [__i18nStringBrand]?: never;
+};
+interface I18nFacade {
+    t<F extends string>(key: I18nKey, fallback: F, variables?: I18nVariables): F & I18nString;
+    t(key: I18nKey, variables?: I18nVariables): I18nString;
+    rich(key: I18nKey, fallback: string, components?: I18nRichComponents, variables?: I18nVariables): unknown;
+    tEl<F extends string>(key: I18nKey, fallback: F, variables?: I18nVariables, desc?: string): F & I18nString;
     configure(opts: {
-        createElement: (tag: string, props: object, children: string) => any;
+        components?: I18nRichComponents;
+        createElement?: (tag: string, props: object, children: string) => unknown;
     }): void;
     readonly locale: string | null;
     readonly ready: boolean;
-    /** Resolves when the loader has installed window.i18n and fetched a profile. */
     whenReady(): Promise<void>;
-    /** Subscribe to locale/profile updates. Returns an unsubscribe fn. */
     onUpdate(cb: () => void): () => void;
-};
+}
+declare const i18n: I18nFacade;
 
-export { type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };
+export { type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };

package/dist/client/index.js

@@ -455,13 +455,15 @@ var FlagsClientBrowser = class {
     this.evalResult = data;
   }
   getFlag(name) {
+    if (this.evalResult === null) return false;
     const ov = readGateOverride(name);
     if (ov !== null) return ov;
-    return this.evalResult?.flags[name] ?? false;
+    return this.evalResult.flags[name] ?? false;
   }
   getConfig(name, decode) {
+    if (this.evalResult === null) return void 0;
     const ov = readConfigOverride(name);
-    const raw = ov !== void 0 ? ov : this.evalResult?.configs?.[name];
+    const raw = ov !== void 0 ? ov : this.evalResult.configs?.[name];
     if (raw === void 0) return void 0;
     if (!decode) return raw;
     try {
@@ -797,15 +799,114 @@ function isEditLabelsMode() {
 }
 function interpolate(raw, variables) {
   if (!variables) return raw;
-  return raw.replace(/\{\{(\w+)\}\}/g, (_, k) => String(variables[k] ?? `{{${k}}}`));
+  return raw.replace(/\{\{(\w+)\}\}/g, (placeholder, k) => {
+    const v = variables[k];
+    return v != null ? String(v) : placeholder;
+  });
+}
+var _IS_BROWSER = typeof document !== "undefined";
+var _RICH_HTML_TAGS = [
+  "b",
+  "i",
+  "u",
+  "s",
+  "em",
+  "strong",
+  "del",
+  "ins",
+  "mark",
+  "small",
+  "code",
+  "pre",
+  "kbd",
+  "sub",
+  "sup",
+  "span",
+  "a",
+  "p",
+  "br",
+  "hr"
+];
+function _makeBuiltinTags() {
+  const tags = {};
+  for (const tag of _RICH_HTML_TAGS) {
+    tags[tag] = _IS_BROWSER ? (text) => {
+      const el = document.createElement(tag);
+      if (tag !== "br" && tag !== "hr") el.textContent = text;
+      return el;
+    } : (text) => tag === "br" || tag === "hr" ? `<${tag}>` : `<${tag}>${text}</${tag}>`;
+  }
+  return tags;
+}
+var _builtinTags = _makeBuiltinTags();
+var _configuredComponents = {};
+var _RICH_TAG_RE = /<(\w+)(?:\s*\/>|>([\s\S]*?)<\/\1>)/g;
+function _parseRichText(text, components) {
+  const parts = [];
+  let lastIndex = 0;
+  let match;
+  let allStrings = true;
+  _RICH_TAG_RE.lastIndex = 0;
+  while ((match = _RICH_TAG_RE.exec(text)) !== null) {
+    if (match.index > lastIndex) parts.push(text.slice(lastIndex, match.index));
+    const tag = match[1];
+    const content = match[2] ?? "";
+    const renderer = components[tag] ?? _configuredComponents[tag] ?? _builtinTags[tag];
+    if (renderer) {
+      const rendered = renderer(content);
+      if (typeof rendered !== "string") allStrings = false;
+      parts.push(rendered);
+    } else {
+      parts.push(content);
+    }
+    lastIndex = _RICH_TAG_RE.lastIndex;
+  }
+  if (lastIndex < text.length) parts.push(text.slice(lastIndex));
+  if (allStrings) return parts.join("");
+  return parts;
+}
+function _resolveTranslation(key, variables) {
+  if (typeof window !== "undefined" && window.i18n) {
+    const v = window.i18n.t(key, variables);
+    return v === key ? void 0 : v;
+  }
+  const store = getSSRI18nStore();
+  if (store?.strings[key]) return interpolate(store.strings[key], variables);
+  return void 0;
 }
 var i18n = {
-  t(key, variables) {
-    if (typeof window !== "undefined" && window.i18n) return window.i18n.t(key, variables);
-    const store = getSSRI18nStore();
-    if (store?.strings[key]) return interpolate(store.strings[key], variables);
+  t(key, fallbackOrVars, maybeVars) {
+    let fallback;
+    let variables;
+    if (typeof fallbackOrVars === "string") {
+      fallback = fallbackOrVars;
+      variables = maybeVars;
+    } else {
+      variables = fallbackOrVars;
+    }
+    const resolved = _resolveTranslation(key, variables);
+    if (resolved !== void 0) return resolved;
+    if (fallback !== void 0) return interpolate(fallback, variables);
     return key;
   },
+  /**
+   * Translate a key whose value contains `<tag>content</tag>` segments and
+   * render the tagged segments via per-call `components`, `configure()`-supplied
+   * components, or the built-in HTML tag renderers.
+   *
+   * Return shape:
+   *   - all renderers return strings → returns a concatenated `string`
+   *   - any renderer returns a non-string (e.g. JSX, DOM node) → returns
+   *     `Array<string | T>` and the caller is responsible for rendering
+   *
+   * Framework-agnostic: this method does pure string parsing + callback
+   * execution. No React / DOM dependency in the SDK itself.
+   */
+  rich(key, fallback, components, variables) {
+    const resolved = _resolveTranslation(key, variables);
+    const raw = resolved ?? interpolate(fallback, variables);
+    return _parseRichText(raw, components ?? {});
+  },
   /**
    * Translate a key and return a framework element (e.g. React <span>)
    * carrying `data-label` / `data-variables` attributes so the ShipEasy
@@ -818,18 +919,30 @@ var i18n = {
    * Falls back to a plain translated string if `createElement` was not
    * configured (e.g. server-side or in non-JSX contexts).
    */
-  tEl(key, fallback, variables, desc) {
-    const hasTranslation = typeof window !== "undefined" && Boolean(window.i18n) || Boolean(getSSRI18nStore()?.strings[key]);
-    const translated = hasTranslation ? this.t(key, variables) : void 0;
-    const text = translated && translated !== key ? translated : fallback;
-    if (isEditLabelsMode()) return encodeLabelMarker(key, text);
-    if (_createElement) return _createElement("span", labelAttrs(key, variables, desc), text);
-    return text;
+  /**
+   * @deprecated Use `t(key, fallback, variables)` instead. tEl() now delegates
+   * to t() and returns the translated string. Prior behaviour (createElement
+   * wrapping + edit-mode markers) was a devtools feature that conflicted with
+   * type-safe usage and has been removed.
+   */
+  tEl(key, fallback, variables, _desc) {
+    if (isEditLabelsMode()) {
+      const resolved = _resolveTranslation(key, variables);
+      const text = resolved ?? interpolate(fallback, variables);
+      return encodeLabelMarker(key, text);
+    }
+    return this.t(key, fallback, variables);
   },
-  /** Wire up the element creator once at app startup (call before any tEl use). */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  /**
+   * Configure global rich-text component overrides and (legacy) the createElement
+   * factory. `components` registers default renderers used by `rich()` when no
+   * per-call override is supplied (e.g. swap `<a>` for a framework Link).
+   */
   configure(opts) {
-    _createElement = opts.createElement;
+    if (opts.components) {
+      _configuredComponents = { ..._configuredComponents, ...opts.components };
+    }
+    if (opts.createElement) _createElement = opts.createElement;
   },
   get locale() {
     if (typeof window !== "undefined" && window.i18n) return window.i18n.locale;

package/dist/client/index.mjs

@@ -412,13 +412,15 @@ var FlagsClientBrowser = class {
     this.evalResult = data;
   }
   getFlag(name) {
+    if (this.evalResult === null) return false;
     const ov = readGateOverride(name);
     if (ov !== null) return ov;
-    return this.evalResult?.flags[name] ?? false;
+    return this.evalResult.flags[name] ?? false;
   }
   getConfig(name, decode) {
+    if (this.evalResult === null) return void 0;
     const ov = readConfigOverride(name);
-    const raw = ov !== void 0 ? ov : this.evalResult?.configs?.[name];
+    const raw = ov !== void 0 ? ov : this.evalResult.configs?.[name];
     if (raw === void 0) return void 0;
     if (!decode) return raw;
     try {
@@ -754,15 +756,114 @@ function isEditLabelsMode() {
 }
 function interpolate(raw, variables) {
   if (!variables) return raw;
-  return raw.replace(/\{\{(\w+)\}\}/g, (_, k) => String(variables[k] ?? `{{${k}}}`));
+  return raw.replace(/\{\{(\w+)\}\}/g, (placeholder, k) => {
+    const v = variables[k];
+    return v != null ? String(v) : placeholder;
+  });
+}
+var _IS_BROWSER = typeof document !== "undefined";
+var _RICH_HTML_TAGS = [
+  "b",
+  "i",
+  "u",
+  "s",
+  "em",
+  "strong",
+  "del",
+  "ins",
+  "mark",
+  "small",
+  "code",
+  "pre",
+  "kbd",
+  "sub",
+  "sup",
+  "span",
+  "a",
+  "p",
+  "br",
+  "hr"
+];
+function _makeBuiltinTags() {
+  const tags = {};
+  for (const tag of _RICH_HTML_TAGS) {
+    tags[tag] = _IS_BROWSER ? (text) => {
+      const el = document.createElement(tag);
+      if (tag !== "br" && tag !== "hr") el.textContent = text;
+      return el;
+    } : (text) => tag === "br" || tag === "hr" ? `<${tag}>` : `<${tag}>${text}</${tag}>`;
+  }
+  return tags;
+}
+var _builtinTags = _makeBuiltinTags();
+var _configuredComponents = {};
+var _RICH_TAG_RE = /<(\w+)(?:\s*\/>|>([\s\S]*?)<\/\1>)/g;
+function _parseRichText(text, components) {
+  const parts = [];
+  let lastIndex = 0;
+  let match;
+  let allStrings = true;
+  _RICH_TAG_RE.lastIndex = 0;
+  while ((match = _RICH_TAG_RE.exec(text)) !== null) {
+    if (match.index > lastIndex) parts.push(text.slice(lastIndex, match.index));
+    const tag = match[1];
+    const content = match[2] ?? "";
+    const renderer = components[tag] ?? _configuredComponents[tag] ?? _builtinTags[tag];
+    if (renderer) {
+      const rendered = renderer(content);
+      if (typeof rendered !== "string") allStrings = false;
+      parts.push(rendered);
+    } else {
+      parts.push(content);
+    }
+    lastIndex = _RICH_TAG_RE.lastIndex;
+  }
+  if (lastIndex < text.length) parts.push(text.slice(lastIndex));
+  if (allStrings) return parts.join("");
+  return parts;
+}
+function _resolveTranslation(key, variables) {
+  if (typeof window !== "undefined" && window.i18n) {
+    const v = window.i18n.t(key, variables);
+    return v === key ? void 0 : v;
+  }
+  const store = getSSRI18nStore();
+  if (store?.strings[key]) return interpolate(store.strings[key], variables);
+  return void 0;
 }
 var i18n = {
-  t(key, variables) {
-    if (typeof window !== "undefined" && window.i18n) return window.i18n.t(key, variables);
-    const store = getSSRI18nStore();
-    if (store?.strings[key]) return interpolate(store.strings[key], variables);
+  t(key, fallbackOrVars, maybeVars) {
+    let fallback;
+    let variables;
+    if (typeof fallbackOrVars === "string") {
+      fallback = fallbackOrVars;
+      variables = maybeVars;
+    } else {
+      variables = fallbackOrVars;
+    }
+    const resolved = _resolveTranslation(key, variables);
+    if (resolved !== void 0) return resolved;
+    if (fallback !== void 0) return interpolate(fallback, variables);
     return key;
   },
+  /**
+   * Translate a key whose value contains `<tag>content</tag>` segments and
+   * render the tagged segments via per-call `components`, `configure()`-supplied
+   * components, or the built-in HTML tag renderers.
+   *
+   * Return shape:
+   *   - all renderers return strings → returns a concatenated `string`
+   *   - any renderer returns a non-string (e.g. JSX, DOM node) → returns
+   *     `Array<string | T>` and the caller is responsible for rendering
+   *
+   * Framework-agnostic: this method does pure string parsing + callback
+   * execution. No React / DOM dependency in the SDK itself.
+   */
+  rich(key, fallback, components, variables) {
+    const resolved = _resolveTranslation(key, variables);
+    const raw = resolved ?? interpolate(fallback, variables);
+    return _parseRichText(raw, components ?? {});
+  },
   /**
    * Translate a key and return a framework element (e.g. React <span>)
    * carrying `data-label` / `data-variables` attributes so the ShipEasy
@@ -775,18 +876,30 @@ var i18n = {
    * Falls back to a plain translated string if `createElement` was not
    * configured (e.g. server-side or in non-JSX contexts).
    */
-  tEl(key, fallback, variables, desc) {
-    const hasTranslation = typeof window !== "undefined" && Boolean(window.i18n) || Boolean(getSSRI18nStore()?.strings[key]);
-    const translated = hasTranslation ? this.t(key, variables) : void 0;
-    const text = translated && translated !== key ? translated : fallback;
-    if (isEditLabelsMode()) return encodeLabelMarker(key, text);
-    if (_createElement) return _createElement("span", labelAttrs(key, variables, desc), text);
-    return text;
+  /**
+   * @deprecated Use `t(key, fallback, variables)` instead. tEl() now delegates
+   * to t() and returns the translated string. Prior behaviour (createElement
+   * wrapping + edit-mode markers) was a devtools feature that conflicted with
+   * type-safe usage and has been removed.
+   */
+  tEl(key, fallback, variables, _desc) {
+    if (isEditLabelsMode()) {
+      const resolved = _resolveTranslation(key, variables);
+      const text = resolved ?? interpolate(fallback, variables);
+      return encodeLabelMarker(key, text);
+    }
+    return this.t(key, fallback, variables);
   },
-  /** Wire up the element creator once at app startup (call before any tEl use). */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  /**
+   * Configure global rich-text component overrides and (legacy) the createElement
+   * factory. `components` registers default renderers used by `rich()` when no
+   * per-call override is supplied (e.g. swap `<a>` for a framework Link).
+   */
   configure(opts) {
-    _createElement = opts.createElement;
+    if (opts.components) {
+      _configuredComponents = { ..._configuredComponents, ...opts.components };
+    }
+    if (opts.createElement) _createElement = opts.createElement;
   },
   get locale() {
     if (typeof window !== "undefined" && window.i18n) return window.i18n.locale;

package/dist/server/index.js

@@ -366,10 +366,31 @@ var FlagsClient = class {
 var _I18N_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n");
 var _EDIT_MODE_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode");
 var _i18nALS = new import_node_async_hooks.AsyncLocalStorage();
-globalThis[_I18N_SSR_SYM] = () => _i18nALS.getStore() ?? null;
-if (globalThis[_EDIT_MODE_SSR_SYM] === void 0) {
-  globalThis[_EDIT_MODE_SSR_SYM] = false;
+var _I18N_CACHE_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n-cache");
+var _i18nCache = globalThis[_I18N_CACHE_SYM] ?? (globalThis[_I18N_CACHE_SYM] = /* @__PURE__ */ new Map());
+globalThis[_I18N_SSR_SYM] = () => {
+  const fromALS = _i18nALS.getStore();
+  if (fromALS && Object.keys(fromALS.strings).length > 0) return fromALS;
+  for (const v of _i18nCache.values()) {
+    if (Object.keys(v.strings).length > 0) return v;
+  }
+  return fromALS ?? null;
+};
+var _EDIT_MODE_ALS_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-als");
+var _editModeALS = globalThis[_EDIT_MODE_ALS_SYM] ?? (globalThis[_EDIT_MODE_ALS_SYM] = new import_node_async_hooks.AsyncLocalStorage());
+var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
+if (globalThis[_EDIT_MODE_FALLBACK_SYM] === void 0) {
+  globalThis[_EDIT_MODE_FALLBACK_SYM] = false;
 }
+Object.defineProperty(globalThis, _EDIT_MODE_SSR_SYM, {
+  get: () => _editModeALS.getStore() ?? globalThis[_EDIT_MODE_FALLBACK_SYM] ?? false,
+  set: (v) => {
+    const b = Boolean(v);
+    _editModeALS.enterWith(b);
+    globalThis[_EDIT_MODE_FALLBACK_SYM] = b;
+  },
+  configurable: true
+});
 var i18n = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -385,10 +406,18 @@ var i18n = {
    * @param cdnBaseUrl Optional override for the i18n CDN (default: cdn.i18n.shipeasy.ai)
    */
   async init(key, profile, cdnBaseUrl) {
-    if (_i18nALS.getStore() !== void 0) return;
+    const existingALS = _i18nALS.getStore();
+    if (existingALS && Object.keys(existingALS.strings).length > 0) return;
+    const cached = _i18nCache.get(profile);
+    if (cached && Object.keys(cached.strings).length > 0) {
+      _i18nALS.enterWith(cached);
+      return;
+    }
     const labels = await fetchLabelsForSSR({ key, profile, cdnBaseUrl }).catch(() => null);
     const locale = profile.split(":")[0] || "en";
-    _i18nALS.enterWith({ strings: labels?.strings ?? {}, locale });
+    const store = { strings: labels?.strings ?? {}, locale };
+    if (Object.keys(store.strings).length > 0) _i18nCache.set(profile, store);
+    _i18nALS.enterWith(store);
   },
   /**
    * Return the translation strings loaded for the current request.
@@ -399,13 +428,14 @@ var i18n = {
     return _i18nALS.getStore() ?? { strings: {}, locale: "en" };
   }
 };
-var DEFAULT_I18N_CDN = "https://cdn.i18n.shipeasy.ai";
-async function fetchJson(url, timeoutMs = 2e3) {
+var DEFAULT_I18N_CDN = "https://cdn.shipeasy.ai";
+async function fetchJson(url, timeoutMs = 2e3, headers) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
   try {
     const res = await fetch(url, {
       signal: controller.signal,
+      headers,
       next: { revalidate: 60 }
     });
     if (!res.ok) throw new Error(`HTTP ${res.status} fetching ${url}`);
@@ -416,20 +446,24 @@ async function fetchJson(url, timeoutMs = 2e3) {
 }
 async function fetchLabelsForSSR(opts) {
   const cdn = opts.cdnBaseUrl ?? DEFAULT_I18N_CDN;
-  const chunk = opts.chunk ?? "index";
   try {
-    const manifest = await fetchJson(
-      `${cdn}/labels/${opts.key}/${opts.profile}/manifest.json`,
-      opts.timeoutMs
+    const body = await fetchJson(
+      `${cdn}/sdk/i18n/strings?profile=${encodeURIComponent(opts.profile)}`,
+      opts.timeoutMs,
+      { "X-SDK-Key": opts.key }
     );
-    const fileUrl = manifest[chunk];
-    if (!fileUrl) return null;
-    return await fetchJson(fileUrl, opts.timeoutMs);
+    return {
+      v: 1,
+      profile: opts.profile,
+      chunk: opts.chunk ?? "default",
+      strings: body.strings ?? {}
+    };
   } catch {
     return null;
   }
 }
 var _server = null;
+var _rememberedClientKey = null;
 function configureShipeasyServer(opts) {
   if (_server) return _server;
   _server = new FlagsClient(opts);
@@ -449,7 +483,8 @@ async function shipeasy(opts) {
     console.warn("[shipeasy] apiKey not set \u2014 falling back to clientKey for server requests.");
   }
   const apiKey = opts.apiKey ?? opts.clientKey ?? "";
-  const clientKey = opts.clientKey ?? opts.apiKey ?? "";
+  const clientKey = opts.clientKey ?? _rememberedClientKey ?? opts.apiKey ?? "";
+  if (opts.clientKey && !_rememberedClientKey) _rememberedClientKey = opts.clientKey;
   const profile = opts.i18nDefaultProfile ?? "en:prod";
   flags.configure({ apiKey });
   let resolvedUrlOverrides = opts.urlOverrides;

package/dist/server/index.mjs

@@ -323,10 +323,31 @@ var FlagsClient = class {
 var _I18N_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n");
 var _EDIT_MODE_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode");
 var _i18nALS = new AsyncLocalStorage();
-globalThis[_I18N_SSR_SYM] = () => _i18nALS.getStore() ?? null;
-if (globalThis[_EDIT_MODE_SSR_SYM] === void 0) {
-  globalThis[_EDIT_MODE_SSR_SYM] = false;
+var _I18N_CACHE_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n-cache");
+var _i18nCache = globalThis[_I18N_CACHE_SYM] ?? (globalThis[_I18N_CACHE_SYM] = /* @__PURE__ */ new Map());
+globalThis[_I18N_SSR_SYM] = () => {
+  const fromALS = _i18nALS.getStore();
+  if (fromALS && Object.keys(fromALS.strings).length > 0) return fromALS;
+  for (const v of _i18nCache.values()) {
+    if (Object.keys(v.strings).length > 0) return v;
+  }
+  return fromALS ?? null;
+};
+var _EDIT_MODE_ALS_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-als");
+var _editModeALS = globalThis[_EDIT_MODE_ALS_SYM] ?? (globalThis[_EDIT_MODE_ALS_SYM] = new AsyncLocalStorage());
+var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
+if (globalThis[_EDIT_MODE_FALLBACK_SYM] === void 0) {
+  globalThis[_EDIT_MODE_FALLBACK_SYM] = false;
 }
+Object.defineProperty(globalThis, _EDIT_MODE_SSR_SYM, {
+  get: () => _editModeALS.getStore() ?? globalThis[_EDIT_MODE_FALLBACK_SYM] ?? false,
+  set: (v) => {
+    const b = Boolean(v);
+    _editModeALS.enterWith(b);
+    globalThis[_EDIT_MODE_FALLBACK_SYM] = b;
+  },
+  configurable: true
+});
 var i18n = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -342,10 +363,18 @@ var i18n = {
    * @param cdnBaseUrl Optional override for the i18n CDN (default: cdn.i18n.shipeasy.ai)
    */
   async init(key, profile, cdnBaseUrl) {
-    if (_i18nALS.getStore() !== void 0) return;
+    const existingALS = _i18nALS.getStore();
+    if (existingALS && Object.keys(existingALS.strings).length > 0) return;
+    const cached = _i18nCache.get(profile);
+    if (cached && Object.keys(cached.strings).length > 0) {
+      _i18nALS.enterWith(cached);
+      return;
+    }
     const labels = await fetchLabelsForSSR({ key, profile, cdnBaseUrl }).catch(() => null);
     const locale = profile.split(":")[0] || "en";
-    _i18nALS.enterWith({ strings: labels?.strings ?? {}, locale });
+    const store = { strings: labels?.strings ?? {}, locale };
+    if (Object.keys(store.strings).length > 0) _i18nCache.set(profile, store);
+    _i18nALS.enterWith(store);
   },
   /**
    * Return the translation strings loaded for the current request.
@@ -356,13 +385,14 @@ var i18n = {
     return _i18nALS.getStore() ?? { strings: {}, locale: "en" };
   }
 };
-var DEFAULT_I18N_CDN = "https://cdn.i18n.shipeasy.ai";
-async function fetchJson(url, timeoutMs = 2e3) {
+var DEFAULT_I18N_CDN = "https://cdn.shipeasy.ai";
+async function fetchJson(url, timeoutMs = 2e3, headers) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
   try {
     const res = await fetch(url, {
       signal: controller.signal,
+      headers,
       next: { revalidate: 60 }
     });
     if (!res.ok) throw new Error(`HTTP ${res.status} fetching ${url}`);
@@ -373,20 +403,24 @@ async function fetchJson(url, timeoutMs = 2e3) {
 }
 async function fetchLabelsForSSR(opts) {
   const cdn = opts.cdnBaseUrl ?? DEFAULT_I18N_CDN;
-  const chunk = opts.chunk ?? "index";
   try {
-    const manifest = await fetchJson(
-      `${cdn}/labels/${opts.key}/${opts.profile}/manifest.json`,
-      opts.timeoutMs
+    const body = await fetchJson(
+      `${cdn}/sdk/i18n/strings?profile=${encodeURIComponent(opts.profile)}`,
+      opts.timeoutMs,
+      { "X-SDK-Key": opts.key }
     );
-    const fileUrl = manifest[chunk];
-    if (!fileUrl) return null;
-    return await fetchJson(fileUrl, opts.timeoutMs);
+    return {
+      v: 1,
+      profile: opts.profile,
+      chunk: opts.chunk ?? "default",
+      strings: body.strings ?? {}
+    };
   } catch {
     return null;
   }
 }
 var _server = null;
+var _rememberedClientKey = null;
 function configureShipeasyServer(opts) {
   if (_server) return _server;
   _server = new FlagsClient(opts);
@@ -406,7 +440,8 @@ async function shipeasy(opts) {
     console.warn("[shipeasy] apiKey not set \u2014 falling back to clientKey for server requests.");
   }
   const apiKey = opts.apiKey ?? opts.clientKey ?? "";
-  const clientKey = opts.clientKey ?? opts.apiKey ?? "";
+  const clientKey = opts.clientKey ?? _rememberedClientKey ?? opts.apiKey ?? "";
+  if (opts.clientKey && !_rememberedClientKey) _rememberedClientKey = opts.clientKey;
   const profile = opts.i18nDefaultProfile ?? "en:prod";
   flags.configure({ apiKey });
   let resolvedUrlOverrides = opts.urlOverrides;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipeasy/sdk",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "description": "Shipeasy SDK — feature gates, runtime configs, experiments, and metrics for the Shipeasy hosted service.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://shipeasy.ai",
@@ -48,35 +48,28 @@
     "LICENSE",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "publish-loader": "wrangler r2 object put shipeasy-sdk/loader-v$npm_package_version.js --file=dist/loader/loader.global.js --content-type 'application/javascript; charset=utf-8' --cache-control 'public, max-age=31536000, immutable' --remote && wrangler r2 object put shipeasy-sdk/loader.js --file=dist/loader/loader.global.js --content-type 'application/javascript; charset=utf-8' --cache-control 'public, max-age=300' --remote"
+  },
   "dependencies": {
     "murmurhash-js": "^1.0.0"
   },
   "devDependencies": {
     "@types/murmurhash-js": "^1.0.6",
+    "@types/node": "^20.0.0",
     "tsup": "^8.3.0",
     "typescript": "^5.7.4",
     "vitest": "^2.1.0",
     "wrangler": "^4.83.0"
   },
-  "peerDependencies": {
-    "zod": "^4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "zod": {
-      "optional": true
-    }
-  },
   "publishConfig": {
     "access": "public"
   },
   "engines": {
     "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsup",
-    "type-check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "publish-loader": "wrangler r2 object put shipeasy-sdk/loader-v$npm_package_version.js --file=dist/loader/loader.global.js --content-type 'application/javascript; charset=utf-8' --cache-control 'public, max-age=31536000, immutable' --remote && wrangler r2 object put shipeasy-sdk/loader.js --file=dist/loader/loader.global.js --content-type 'application/javascript; charset=utf-8' --cache-control 'public, max-age=300' --remote"
   }
-}
+}