@shipeasy/sdk 2.1.12 → 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) {

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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipeasy/sdk",
-  "version": "2.1.12",
+  "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",