@shipeasy/sdk 2.1.11 → 2.1.13

package/dist/client/index.d.mts

@@ -48,6 +48,7 @@ declare class FlagsClientBrowser {
     private guardrailsInstalled;
     private listeners;
     private overrideListenerInstalled;
+    private identifySeq;
     private onOverrideChange;
     constructor(opts: FlagsClientBrowserOptions);
     identify(user: User): Promise<void>;
@@ -117,11 +118,22 @@ interface ShipeasyClientConfig {
     baseUrl?: string;
     /** Override the admin URL for the devtools overlay (dev use). */
     adminUrl?: string;
+    /**
+     * Skip the lazy auto-identify({}) at boot. Defaults to true (auto-identify on).
+     * Turn off when the host has its own identify orchestration and wants to
+     * avoid the initial anon /sdk/evaluate round-trip.
+     */
+    autoIdentify?: boolean;
 }
 /**
  * Initialise the ShipEasy client SDK and wire up lazy devtools.
  * Call this once at app startup (e.g. in a useEffect in your root layout).
  * Returns a cleanup function — call it on unmount to remove event listeners.
+ *
+ * Lazy-identifies the visitor under the hood with a stable anonId + auto-collected
+ * browser attrs (locale, timezone, path, screen, referrer, user_agent), so flags
+ * and experiments are warm without callers having to wire identify() manually.
+ * A later flags.identify({ user_id }) overrides this in place; anonId stays stable.
  */
 declare function shipeasy(opts: ShipeasyClientConfig): () => void;
 declare function configureShipeasy(opts: FlagsClientBrowserOptions): FlagsClientBrowser;

package/dist/client/index.d.ts

@@ -48,6 +48,7 @@ declare class FlagsClientBrowser {
     private guardrailsInstalled;
     private listeners;
     private overrideListenerInstalled;
+    private identifySeq;
     private onOverrideChange;
     constructor(opts: FlagsClientBrowserOptions);
     identify(user: User): Promise<void>;
@@ -117,11 +118,22 @@ interface ShipeasyClientConfig {
     baseUrl?: string;
     /** Override the admin URL for the devtools overlay (dev use). */
     adminUrl?: string;
+    /**
+     * Skip the lazy auto-identify({}) at boot. Defaults to true (auto-identify on).
+     * Turn off when the host has its own identify orchestration and wants to
+     * avoid the initial anon /sdk/evaluate round-trip.
+     */
+    autoIdentify?: boolean;
 }
 /**
  * Initialise the ShipEasy client SDK and wire up lazy devtools.
  * Call this once at app startup (e.g. in a useEffect in your root layout).
  * Returns a cleanup function — call it on unmount to remove event listeners.
+ *
+ * Lazy-identifies the visitor under the hood with a stable anonId + auto-collected
+ * browser attrs (locale, timezone, path, screen, referrer, user_agent), so flags
+ * and experiments are warm without callers having to wire identify() manually.
+ * A later flags.identify({ user_id }) overrides this in place; anonId stays stable.
  */
 declare function shipeasy(opts: ShipeasyClientConfig): () => void;
 declare function configureShipeasy(opts: FlagsClientBrowserOptions): FlagsClientBrowser;

package/dist/client/index.js

@@ -399,6 +399,9 @@ var FlagsClientBrowser = class {
   guardrailsInstalled = false;
   listeners = /* @__PURE__ */ new Set();
   overrideListenerInstalled = false;
+  // Monotonic counter so a later identify() always wins even if its /sdk/evaluate
+  // response races and lands before an earlier in-flight call's response.
+  identifySeq = 0;
   onOverrideChange = () => {
     this.installBridge();
     this.notify();
@@ -413,8 +416,9 @@ var FlagsClientBrowser = class {
     void this.buffer.flushPendingAlias();
   }
   async identify(user) {
+    const seq = ++this.identifySeq;
     const prevUserId = this.userId;
-    this.userId = user.user_id ?? "";
+    if (user.user_id !== void 0) this.userId = user.user_id;
     if (this.anonId && this.userId && this.userId !== prevUserId) {
       await this.buffer.alias(this.anonId, this.userId);
     }
@@ -432,7 +436,9 @@ var FlagsClientBrowser = class {
       })
     });
     if (!res.ok) throw new Error(`/sdk/evaluate returned ${res.status}`);
-    this.evalResult = await res.json();
+    const data = await res.json();
+    if (seq !== this.identifySeq) return;
+    this.evalResult = data;
     if (this.autoGuardrails && !this.guardrailsInstalled) {
       this.guardrailsInstalled = true;
       installAutoGuardrails(this.buffer, this.userId, this.anonId);
@@ -656,6 +662,11 @@ function shipeasy(opts) {
     baseUrl: opts.baseUrl ?? "https://cdn.shipeasy.ai"
   });
   flags.notifyMounted();
+  if (opts.autoIdentify !== false) {
+    void client.identify({}).catch((err) => {
+      console.warn("[shipeasy] auto-identify failed:", String(err));
+    });
+  }
   return attachDevtools(client, { adminUrl: opts.adminUrl });
 }
 function configureShipeasy(opts) {
@@ -791,12 +802,16 @@ var _EDIT_MODE_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode
 function getSSRI18nStore() {
   return globalThis[_I18N_SSR_SYM]?.() ?? null;
 }
+var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
 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;
+  if (typeof val === "boolean") return val;
+  if (typeof val === "function") return val();
+  const fb = globalThis[_EDIT_MODE_FALLBACK_SYM];
+  return typeof fb === "boolean" ? fb : false;
 }
 function interpolate(raw, variables) {
   if (!variables) return raw;

package/dist/client/index.mjs

@@ -356,6 +356,9 @@ var FlagsClientBrowser = class {
   guardrailsInstalled = false;
   listeners = /* @__PURE__ */ new Set();
   overrideListenerInstalled = false;
+  // Monotonic counter so a later identify() always wins even if its /sdk/evaluate
+  // response races and lands before an earlier in-flight call's response.
+  identifySeq = 0;
   onOverrideChange = () => {
     this.installBridge();
     this.notify();
@@ -370,8 +373,9 @@ var FlagsClientBrowser = class {
     void this.buffer.flushPendingAlias();
   }
   async identify(user) {
+    const seq = ++this.identifySeq;
     const prevUserId = this.userId;
-    this.userId = user.user_id ?? "";
+    if (user.user_id !== void 0) this.userId = user.user_id;
     if (this.anonId && this.userId && this.userId !== prevUserId) {
       await this.buffer.alias(this.anonId, this.userId);
     }
@@ -389,7 +393,9 @@ var FlagsClientBrowser = class {
       })
     });
     if (!res.ok) throw new Error(`/sdk/evaluate returned ${res.status}`);
-    this.evalResult = await res.json();
+    const data = await res.json();
+    if (seq !== this.identifySeq) return;
+    this.evalResult = data;
     if (this.autoGuardrails && !this.guardrailsInstalled) {
       this.guardrailsInstalled = true;
       installAutoGuardrails(this.buffer, this.userId, this.anonId);
@@ -613,6 +619,11 @@ function shipeasy(opts) {
     baseUrl: opts.baseUrl ?? "https://cdn.shipeasy.ai"
   });
   flags.notifyMounted();
+  if (opts.autoIdentify !== false) {
+    void client.identify({}).catch((err) => {
+      console.warn("[shipeasy] auto-identify failed:", String(err));
+    });
+  }
   return attachDevtools(client, { adminUrl: opts.adminUrl });
 }
 function configureShipeasy(opts) {
@@ -748,12 +759,16 @@ var _EDIT_MODE_SSR_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode
 function getSSRI18nStore() {
   return globalThis[_I18N_SSR_SYM]?.() ?? null;
 }
+var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
 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;
+  if (typeof val === "boolean") return val;
+  if (typeof val === "function") return val();
+  const fb = globalThis[_EDIT_MODE_FALLBACK_SYM];
+  return typeof fb === "boolean" ? fb : false;
 }
 function interpolate(raw, variables) {
   if (!variables) return raw;

package/dist/server/index.js

@@ -493,10 +493,17 @@ async function shipeasy(opts) {
   let resolvedUrlOverrides = opts.urlOverrides;
   if (!resolvedUrlOverrides) {
     try {
-      const { headers } = await import("next/headers");
+      const { headers, cookies } = await import("next/headers");
       const h = await Promise.resolve(headers());
       const search = h.get("x-se-search") ?? "";
-      if (search) resolvedUrlOverrides = search;
+      if (search) {
+        resolvedUrlOverrides = search;
+      } else {
+        const c = await Promise.resolve(cookies());
+        if (c.get?.("se_edit_labels")?.value === "1") {
+          resolvedUrlOverrides = "se_edit_labels=1";
+        }
+      }
     } catch {
     }
   }
@@ -532,7 +539,7 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
   if (i18nData) payload.i18n = i18nData;
   if (opts.editLabels) payload.editLabels = true;
   parts.push(
-    `(function(){if(!new URLSearchParams(location.search).has('se_edit_labels'))return;var R;function P(v){if(!v||typeof v.t!=='function'||v.__sePatched)return;var O=v.t.bind(v);v.__sePatched=true;window._sei18n_t=O;v.t=function(k,vars){var r=O(k,vars);if(r===k)return k;var V='';try{if(vars&&typeof vars==='object'){var hasKey=false;for(var _k in vars){hasKey=true;break;}if(hasKey)V=JSON.stringify(vars);}}catch(_){V='';}return '\\uFFF9'+k+'\\uFFFA'+V+'\\uFFFA'+r+'\\uFFFB';};}Object.defineProperty(window,'i18n',{configurable:true,get:function(){return R;},set:function(v){P(v);R=v;}});})();`
+    `(function(){if(!new URLSearchParams(location.search).has('se_edit_labels'))return;try{document.cookie='se_edit_labels=1;path=/;max-age=86400;samesite=lax';}catch(_){}var R;function P(v){if(!v||typeof v.t!=='function'||v.__sePatched)return;var O=v.t.bind(v);v.__sePatched=true;window._sei18n_t=O;v.t=function(k,vars){var r=O(k,vars);if(r===k)return k;var V='';try{if(vars&&typeof vars==='object'){var hasKey=false;for(var _k in vars){hasKey=true;break;}if(hasKey)V=JSON.stringify(vars);}}catch(_){V='';}return '\\uFFF9'+k+'\\uFFFA'+V+'\\uFFFA'+r+'\\uFFFB';};}Object.defineProperty(window,'i18n',{configurable:true,get:function(){return R;},set:function(v){P(v);R=v;}});})();`
   );
   parts.push(`window.__SE_BOOTSTRAP=${JSON.stringify(payload)};`);
   if (i18nData?.strings && Object.keys(i18nData.strings).length > 0) {

package/dist/server/index.mjs

@@ -450,10 +450,17 @@ async function shipeasy(opts) {
   let resolvedUrlOverrides = opts.urlOverrides;
   if (!resolvedUrlOverrides) {
     try {
-      const { headers } = await import("next/headers");
+      const { headers, cookies } = await import("next/headers");
       const h = await Promise.resolve(headers());
       const search = h.get("x-se-search") ?? "";
-      if (search) resolvedUrlOverrides = search;
+      if (search) {
+        resolvedUrlOverrides = search;
+      } else {
+        const c = await Promise.resolve(cookies());
+        if (c.get?.("se_edit_labels")?.value === "1") {
+          resolvedUrlOverrides = "se_edit_labels=1";
+        }
+      }
     } catch {
     }
   }
@@ -489,7 +496,7 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
   if (i18nData) payload.i18n = i18nData;
   if (opts.editLabels) payload.editLabels = true;
   parts.push(
-    `(function(){if(!new URLSearchParams(location.search).has('se_edit_labels'))return;var R;function P(v){if(!v||typeof v.t!=='function'||v.__sePatched)return;var O=v.t.bind(v);v.__sePatched=true;window._sei18n_t=O;v.t=function(k,vars){var r=O(k,vars);if(r===k)return k;var V='';try{if(vars&&typeof vars==='object'){var hasKey=false;for(var _k in vars){hasKey=true;break;}if(hasKey)V=JSON.stringify(vars);}}catch(_){V='';}return '\\uFFF9'+k+'\\uFFFA'+V+'\\uFFFA'+r+'\\uFFFB';};}Object.defineProperty(window,'i18n',{configurable:true,get:function(){return R;},set:function(v){P(v);R=v;}});})();`
+    `(function(){if(!new URLSearchParams(location.search).has('se_edit_labels'))return;try{document.cookie='se_edit_labels=1;path=/;max-age=86400;samesite=lax';}catch(_){}var R;function P(v){if(!v||typeof v.t!=='function'||v.__sePatched)return;var O=v.t.bind(v);v.__sePatched=true;window._sei18n_t=O;v.t=function(k,vars){var r=O(k,vars);if(r===k)return k;var V='';try{if(vars&&typeof vars==='object'){var hasKey=false;for(var _k in vars){hasKey=true;break;}if(hasKey)V=JSON.stringify(vars);}}catch(_){V='';}return '\\uFFF9'+k+'\\uFFFA'+V+'\\uFFFA'+r+'\\uFFFB';};}Object.defineProperty(window,'i18n',{configurable:true,get:function(){return R;},set:function(v){P(v);R=v;}});})();`
   );
   parts.push(`window.__SE_BOOTSTRAP=${JSON.stringify(payload)};`);
   if (i18nData?.strings && Object.keys(i18nData.strings).length > 0) {

package/package.json

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