@shipeasy/sdk 2.1.2 → 2.1.5

package/dist/client/index.d.mts

@@ -143,6 +143,8 @@ interface BootstrapPayload {
     /** Set by getBootstrapHtml() for auto-init. Not part of evaluate() output. */
     apiKey?: string;
     apiUrl?: string;
+    /** When true, tEl() returns marker-wrapped strings for devtools label editing. */
+    editLabels?: boolean;
 }
 /**
  * Universal flags facade. Methods return safe defaults when the singleton

package/dist/client/index.d.ts

@@ -143,6 +143,8 @@ interface BootstrapPayload {
     /** Set by getBootstrapHtml() for auto-init. Not part of evaluate() output. */
     apiKey?: string;
     apiUrl?: string;
+    /** When true, tEl() returns marker-wrapped strings for devtools label editing. */
+    editLabels?: boolean;
 }
 /**
  * Universal flags facade. Methods return safe defaults when the singleton

package/dist/client/index.js

@@ -784,9 +784,16 @@ function labelAttrs(key, variables, desc) {
 }
 var _createElement = null;
 var _I18N_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n");
+var _EDIT_MODE_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode");
 function getSSRI18nStore() {
   return globalThis[_I18N_SSR_SYM]?.() ?? null;
 }
+function isEditLabelsMode() {
+  if (typeof window !== "undefined") {
+    return !!window.__SE_BOOTSTRAP?.editLabels || new URLSearchParams(location.search).has("se_edit_labels");
+  }
+  return globalThis[_EDIT_MODE_SSR_SYM]?.() ?? false;
+}
 function interpolate(raw, variables) {
   if (!variables) return raw;
   return raw.replace(/\{\{(\w+)\}\}/g, (_, k) => String(variables[k] ?? `{{${k}}}`));
@@ -812,9 +819,11 @@ var i18n = {
    */
   tEl(key, fallback, variables, desc) {
     const hasTranslation = typeof window !== "undefined" && Boolean(window.i18n) || Boolean(getSSRI18nStore()?.strings[key]);
-    const text = hasTranslation ? this.t(key, variables) || fallback : fallback;
-    if (!_createElement) return text;
-    return _createElement("span", labelAttrs(key, variables, desc), text);
+    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;
   },
   /** Wire up the element creator once at app startup (call before any tEl use). */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/client/index.mjs

@@ -741,9 +741,16 @@ function labelAttrs(key, variables, desc) {
 }
 var _createElement = null;
 var _I18N_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n");
+var _EDIT_MODE_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode");
 function getSSRI18nStore() {
   return globalThis[_I18N_SSR_SYM]?.() ?? null;
 }
+function isEditLabelsMode() {
+  if (typeof window !== "undefined") {
+    return !!window.__SE_BOOTSTRAP?.editLabels || new URLSearchParams(location.search).has("se_edit_labels");
+  }
+  return globalThis[_EDIT_MODE_SSR_SYM]?.() ?? false;
+}
 function interpolate(raw, variables) {
   if (!variables) return raw;
   return raw.replace(/\{\{(\w+)\}\}/g, (_, k) => String(variables[k] ?? `{{${k}}}`));
@@ -769,9 +776,11 @@ var i18n = {
    */
   tEl(key, fallback, variables, desc) {
     const hasTranslation = typeof window !== "undefined" && Boolean(window.i18n) || Boolean(getSSRI18nStore()?.strings[key]);
-    const text = hasTranslation ? this.t(key, variables) || fallback : fallback;
-    if (!_createElement) return text;
-    return _createElement("span", labelAttrs(key, variables, desc), text);
+    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;
   },
   /** Wire up the element creator once at app startup (call before any tEl use). */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/server/index.d.mts

@@ -136,6 +136,8 @@ interface BootstrapHtmlOptions {
     apiKey: string;
     /** i18n profile fed to the loader script. Defaults to "en:prod". */
     i18nProfile?: string;
+    /** When true, tEl() embeds label markers so the devtools can highlight them. */
+    editLabels?: boolean;
 }
 /**
  * Returns a vanilla-JS script string for a single <script> tag.

package/dist/server/index.d.ts

@@ -136,6 +136,8 @@ interface BootstrapHtmlOptions {
     apiKey: string;
     /** i18n profile fed to the loader script. Defaults to "en:prod". */
     i18nProfile?: string;
+    /** When true, tEl() embeds label markers so the devtools can highlight them. */
+    editLabels?: boolean;
 }
 /**
  * Returns a vanilla-JS script string for a single <script> tag.

package/dist/server/index.js

@@ -191,7 +191,7 @@ var FlagsClient = class {
   initialized = false;
   constructor(opts) {
     this.apiKey = opts.apiKey;
-    this.baseUrl = (opts.baseUrl ?? "https://edge.shipeasy.dev").replace(/\/$/, "");
+    this.baseUrl = (opts.baseUrl ?? "https://cdn.shipeasy.ai").replace(/\/$/, "");
     this.env = opts.env ?? "prod";
   }
   async init() {
@@ -354,8 +354,11 @@ 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();
+var _editModeALS = new import_node_async_hooks.AsyncLocalStorage();
 globalThis[_I18N_SSR_SYM] = () => _i18nALS.getStore() ?? null;
+globalThis[_EDIT_MODE_SSR_SYM] = () => _editModeALS.getStore() ?? false;
 var i18n = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -438,6 +441,8 @@ async function shipeasy(opts) {
   const clientKey = opts.clientKey ?? opts.apiKey ?? "";
   const profile = opts.i18nDefaultProfile ?? "en:prod";
   flags.configure({ apiKey });
+  const editLabels = opts.urlOverrides ? new URLSearchParams(opts.urlOverrides).has("se_edit_labels") : false;
+  _editModeALS.enterWith(editLabels);
   await Promise.allSettled([flags.initOnce(), i18n.init(clientKey, profile)]);
   const bootstrap = flags.evaluate(opts.user ?? {}, opts.urlOverrides);
   const i18nData = i18n.getForRequest();
@@ -446,7 +451,7 @@ async function shipeasy(opts) {
     configs: bootstrap.configs,
     experiments: bootstrap.experiments,
     getBootstrapHtml() {
-      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey });
+      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey, editLabels });
     }
   };
 }
@@ -462,6 +467,7 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
     apiUrl
   };
   if (i18nData) payload.i18n = i18nData;
+  if (opts.editLabels) payload.editLabels = true;
   parts.push(`window.__SE_BOOTSTRAP=${JSON.stringify(payload)};`);
   if (i18nData?.strings && Object.keys(i18nData.strings).length > 0) {
     parts.push(
@@ -471,6 +477,9 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
   parts.push(
     `(function(){var s=document.createElement('script');s.src=${JSON.stringify(`${apiUrl}/sdk/i18n/loader.js`)};s.setAttribute('data-key',${JSON.stringify(opts.apiKey)});s.setAttribute('data-profile',${JSON.stringify(profile)});document.head.appendChild(s);})();`
   );
+  parts.push(
+    `(function(){var p=new URLSearchParams(location.search);if(p.has('se')||p.has('se_devtools')){var d=document.createElement('script');d.src='https://shipeasy.ai/se-devtools.js';document.head.appendChild(d);}})();`
+  );
   return parts.join("");
 }
 var flags = {

package/dist/server/index.mjs

@@ -158,7 +158,7 @@ var FlagsClient = class {
   initialized = false;
   constructor(opts) {
     this.apiKey = opts.apiKey;
-    this.baseUrl = (opts.baseUrl ?? "https://edge.shipeasy.dev").replace(/\/$/, "");
+    this.baseUrl = (opts.baseUrl ?? "https://cdn.shipeasy.ai").replace(/\/$/, "");
     this.env = opts.env ?? "prod";
   }
   async init() {
@@ -321,8 +321,11 @@ 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();
+var _editModeALS = new AsyncLocalStorage();
 globalThis[_I18N_SSR_SYM] = () => _i18nALS.getStore() ?? null;
+globalThis[_EDIT_MODE_SSR_SYM] = () => _editModeALS.getStore() ?? false;
 var i18n = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -405,6 +408,8 @@ async function shipeasy(opts) {
   const clientKey = opts.clientKey ?? opts.apiKey ?? "";
   const profile = opts.i18nDefaultProfile ?? "en:prod";
   flags.configure({ apiKey });
+  const editLabels = opts.urlOverrides ? new URLSearchParams(opts.urlOverrides).has("se_edit_labels") : false;
+  _editModeALS.enterWith(editLabels);
   await Promise.allSettled([flags.initOnce(), i18n.init(clientKey, profile)]);
   const bootstrap = flags.evaluate(opts.user ?? {}, opts.urlOverrides);
   const i18nData = i18n.getForRequest();
@@ -413,7 +418,7 @@ async function shipeasy(opts) {
     configs: bootstrap.configs,
     experiments: bootstrap.experiments,
     getBootstrapHtml() {
-      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey });
+      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey, editLabels });
     }
   };
 }
@@ -429,6 +434,7 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
     apiUrl
   };
   if (i18nData) payload.i18n = i18nData;
+  if (opts.editLabels) payload.editLabels = true;
   parts.push(`window.__SE_BOOTSTRAP=${JSON.stringify(payload)};`);
   if (i18nData?.strings && Object.keys(i18nData.strings).length > 0) {
     parts.push(
@@ -438,6 +444,9 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
   parts.push(
     `(function(){var s=document.createElement('script');s.src=${JSON.stringify(`${apiUrl}/sdk/i18n/loader.js`)};s.setAttribute('data-key',${JSON.stringify(opts.apiKey)});s.setAttribute('data-profile',${JSON.stringify(profile)});document.head.appendChild(s);})();`
   );
+  parts.push(
+    `(function(){var p=new URLSearchParams(location.search);if(p.has('se')||p.has('se_devtools')){var d=document.createElement('script');d.src='https://shipeasy.ai/se-devtools.js';document.head.appendChild(d);}})();`
+  );
   return parts.join("");
 }
 var flags = {

package/package.json

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