@shipeasy/sdk 1.2.0 → 2.0.0

package/dist/client/index.d.mts

@@ -148,14 +148,14 @@ 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;
+    /**
+     * Look up `key` in the active translation profile. When the profile
+     * hasn't been fetched yet (SSR, CDN downtime, missing key), interpolate
+     * `fallback` instead — `fallback` is the source-of-truth English copy
+     * and is mandatory so the page never renders a raw key.
+     */
+    t(key: string, fallback: 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
@@ -168,7 +168,7 @@ declare const i18n: {
      * Falls back to a plain translated string if `createElement` was not
      * configured (e.g. server-side or in non-JSX contexts).
      */
-    tEl(key: string, variables?: Record<string, string | number>, desc?: string): any;
+    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). */
     configure(opts: {
         createElement: (tag: string, props: object, children: string) => any;

package/dist/client/index.d.ts

@@ -148,14 +148,14 @@ 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;
+    /**
+     * Look up `key` in the active translation profile. When the profile
+     * hasn't been fetched yet (SSR, CDN downtime, missing key), interpolate
+     * `fallback` instead — `fallback` is the source-of-truth English copy
+     * and is mandatory so the page never renders a raw key.
+     */
+    t(key: string, fallback: 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
@@ -168,7 +168,7 @@ declare const i18n: {
      * Falls back to a plain translated string if `createElement` was not
      * configured (e.g. server-side or in non-JSX contexts).
      */
-    tEl(key: string, variables?: Record<string, string | number>, desc?: string): any;
+    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). */
     configure(opts: {
         createElement: (tag: string, props: object, children: string) => any;

package/dist/client/index.js

@@ -454,13 +454,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 {
@@ -715,10 +717,27 @@ function labelAttrs(key, variables, desc) {
   return attrs;
 }
 var _createElement = null;
+function interpolate(template, variables) {
+  if (!variables) return template;
+  let out = template;
+  for (const name of Object.keys(variables)) {
+    out = out.replace(new RegExp(`\\{\\{${name}\\}\\}`, "g"), String(variables[name]));
+  }
+  return out;
+}
 var i18n = {
-  t(key, variables) {
-    if (typeof window !== "undefined" && window.i18n) return window.i18n.t(key, variables);
-    return key;
+  /**
+   * Look up `key` in the active translation profile. When the profile
+   * hasn't been fetched yet (SSR, CDN downtime, missing key), interpolate
+   * `fallback` instead — `fallback` is the source-of-truth English copy
+   * and is mandatory so the page never renders a raw key.
+   */
+  t(key, fallback, variables) {
+    if (typeof window !== "undefined" && window.i18n) {
+      const v = window.i18n.t(key, variables);
+      if (v !== key) return v;
+    }
+    return interpolate(fallback, variables);
   },
   /**
    * Translate a key and return a framework element (e.g. React <span>)
@@ -732,9 +751,8 @@ var i18n = {
    * Falls back to a plain translated string if `createElement` was not
    * configured (e.g. server-side or in non-JSX contexts).
    */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  tEl(key, variables, desc) {
-    const text = this.t(key, variables);
+  tEl(key, fallback, variables, desc) {
+    const text = this.t(key, fallback, variables);
     if (!_createElement) return text;
     return _createElement("span", labelAttrs(key, variables, desc), text);
   },

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 {
@@ -673,10 +675,27 @@ function labelAttrs(key, variables, desc) {
   return attrs;
 }
 var _createElement = null;
+function interpolate(template, variables) {
+  if (!variables) return template;
+  let out = template;
+  for (const name of Object.keys(variables)) {
+    out = out.replace(new RegExp(`\\{\\{${name}\\}\\}`, "g"), String(variables[name]));
+  }
+  return out;
+}
 var i18n = {
-  t(key, variables) {
-    if (typeof window !== "undefined" && window.i18n) return window.i18n.t(key, variables);
-    return key;
+  /**
+   * Look up `key` in the active translation profile. When the profile
+   * hasn't been fetched yet (SSR, CDN downtime, missing key), interpolate
+   * `fallback` instead — `fallback` is the source-of-truth English copy
+   * and is mandatory so the page never renders a raw key.
+   */
+  t(key, fallback, variables) {
+    if (typeof window !== "undefined" && window.i18n) {
+      const v = window.i18n.t(key, variables);
+      if (v !== key) return v;
+    }
+    return interpolate(fallback, variables);
   },
   /**
    * Translate a key and return a framework element (e.g. React <span>)
@@ -690,9 +709,8 @@ var i18n = {
    * Falls back to a plain translated string if `createElement` was not
    * configured (e.g. server-side or in non-JSX contexts).
    */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  tEl(key, variables, desc) {
-    const text = this.t(key, variables);
+  tEl(key, fallback, variables, desc) {
+    const text = this.t(key, fallback, variables);
     if (!_createElement) return text;
     return _createElement("span", labelAttrs(key, variables, desc), text);
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipeasy/sdk",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "Shipeasy SDK — feature gates, runtime configs, experiments, and metrics for the Shipeasy hosted service.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://shipeasy.ai",