@shipeasy/sdk 2.1.3 → 2.1.7

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,17 @@ 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");
+  }
+  const val = globalThis[_EDIT_MODE_SSR_SYM];
+  return typeof val === "boolean" ? val : typeof val === "function" ? val() : false;
+}
 function interpolate(raw, variables) {
   if (!variables) return raw;
   return raw.replace(/\{\{(\w+)\}\}/g, (_, k) => String(variables[k] ?? `{{${k}}}`));
@@ -814,8 +822,9 @@ var i18n = {
     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 (!_createElement) return text;
-    return _createElement("span", labelAttrs(key, variables, desc), text);
+    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,17 @@ 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");
+  }
+  const val = globalThis[_EDIT_MODE_SSR_SYM];
+  return typeof val === "boolean" ? val : typeof val === "function" ? val() : false;
+}
 function interpolate(raw, variables) {
   if (!variables) return raw;
   return raw.replace(/\{\{(\w+)\}\}/g, (_, k) => String(variables[k] ?? `{{${k}}}`));
@@ -771,8 +779,9 @@ var i18n = {
     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 (!_createElement) return text;
-    return _createElement("span", labelAttrs(key, variables, desc), text);
+    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

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/server/index.ts
@@ -191,7 +201,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 +364,12 @@ 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 = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -438,15 +452,27 @@ async function shipeasy(opts) {
   const clientKey = opts.clientKey ?? opts.apiKey ?? "";
   const profile = opts.i18nDefaultProfile ?? "en:prod";
   flags.configure({ apiKey });
+  let resolvedUrlOverrides = opts.urlOverrides;
+  if (!resolvedUrlOverrides) {
+    try {
+      const { headers } = await import("next/headers");
+      const h = await Promise.resolve(headers());
+      const search = h.get("x-se-search") ?? "";
+      if (search) resolvedUrlOverrides = search;
+    } catch {
+    }
+  }
+  const editLabels = resolvedUrlOverrides ? new URLSearchParams(resolvedUrlOverrides).has("se_edit_labels") : false;
+  globalThis[_EDIT_MODE_SSR_SYM] = editLabels;
   await Promise.allSettled([flags.initOnce(), i18n.init(clientKey, profile)]);
-  const bootstrap = flags.evaluate(opts.user ?? {}, opts.urlOverrides);
+  const bootstrap = flags.evaluate(opts.user ?? {}, resolvedUrlOverrides);
   const i18nData = i18n.getForRequest();
   return {
     flags: bootstrap.flags,
     configs: bootstrap.configs,
     experiments: bootstrap.experiments,
     getBootstrapHtml() {
-      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey });
+      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey, editLabels });
     }
   };
 }
@@ -462,6 +488,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 +498,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,12 @@ 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 = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -405,15 +409,27 @@ async function shipeasy(opts) {
   const clientKey = opts.clientKey ?? opts.apiKey ?? "";
   const profile = opts.i18nDefaultProfile ?? "en:prod";
   flags.configure({ apiKey });
+  let resolvedUrlOverrides = opts.urlOverrides;
+  if (!resolvedUrlOverrides) {
+    try {
+      const { headers } = await import("next/headers");
+      const h = await Promise.resolve(headers());
+      const search = h.get("x-se-search") ?? "";
+      if (search) resolvedUrlOverrides = search;
+    } catch {
+    }
+  }
+  const editLabels = resolvedUrlOverrides ? new URLSearchParams(resolvedUrlOverrides).has("se_edit_labels") : false;
+  globalThis[_EDIT_MODE_SSR_SYM] = editLabels;
   await Promise.allSettled([flags.initOnce(), i18n.init(clientKey, profile)]);
-  const bootstrap = flags.evaluate(opts.user ?? {}, opts.urlOverrides);
+  const bootstrap = flags.evaluate(opts.user ?? {}, resolvedUrlOverrides);
   const i18nData = i18n.getForRequest();
   return {
     flags: bootstrap.flags,
     configs: bootstrap.configs,
     experiments: bootstrap.experiments,
     getBootstrapHtml() {
-      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey });
+      return getBootstrapHtml(bootstrap, i18nData, { apiKey: clientKey, editLabels });
     }
   };
 }
@@ -429,6 +445,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 +455,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.3",
+  "version": "2.1.7",
   "description": "Shipeasy SDK — feature gates, runtime configs, experiments, and metrics for the Shipeasy hosted service.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://shipeasy.ai",