@shipeasy/sdk 4.2.0 → 4.4.0

package/dist/client/index.d.mts

@@ -51,6 +51,16 @@ interface SeeErrorEvent {
     env?: string;
     sdk_version: string;
     ts: number;
+    /**
+     * Per-request correlation token. The client mints one per same-origin fetch
+     * and ships it on both the request header (`X-SE-Correlation`) and any 5xx
+     * occurrence it reports; the server safety net reports the matching uncaught
+     * error under the same token. The backend joins the two issues by it —
+     * populating `caused_by` across the network boundary, where the in-process
+     * `.cause`-chain stamp (see `findCausedBy`) cannot reach. Join-only metadata,
+     * never persisted as an issue field.
+     */
+    correlation_id?: string;
     /**
      * The earlier reported problem this occurrence descends from — present when
      * the same error was caught + reported at an inner boundary and then
@@ -120,6 +130,15 @@ interface AutoCollectGroups {
     errors: boolean;
     engagement: boolean;
 }
+/** True when `rawUrl` resolves to the page's own origin (relative URLs included). */
+declare function sameOrigin(rawUrl: string): boolean;
+/**
+ * Return a new `fetch` args tuple with `X-SE-Correlation` added, preserving any
+ * existing headers across all three arg shapes (string / URL / Request). Never
+ * mutates the caller's objects. Best-effort: on any failure the original args
+ * pass through unchanged (correlation is optional, never breaks the fetch).
+ */
+declare function injectCorrelationHeader(args: Parameters<typeof fetch>, corr: string): Parameters<typeof fetch>;
 type FlagsClientBrowserEnv = "dev" | "staging" | "prod";
 interface FlagsClientBrowserOptions {
     sdkKey: string;
@@ -176,7 +195,7 @@ declare class FlagsClientBrowser {
      * (beacon-first) — error occurrences are near-real-time, never queued behind
      * the 5s metric batch. Spam-guarded by a 30s dedup window + per-session cap.
      */
-    reportError(problem: unknown, consequence: Consequence, extras?: SeeExtras, kind?: SeeKind): void;
+    reportError(problem: unknown, consequence: Consequence, extras?: SeeExtras, kind?: SeeKind, correlationId?: string): void;
     get ready(): boolean;
     private notify;
     initFromBootstrap(data: EvalResponse): void;
@@ -478,4 +497,4 @@ interface I18nFacade {
 }
 declare const i18n: I18nFacade;
 
-export { type AutoCollectGroups, type BootstrapPayload, type Consequence, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, type Violation, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, see, shipeasy, version };
+export { type AutoCollectGroups, type BootstrapPayload, type Consequence, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, type Violation, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, injectCorrelationHeader, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, sameOrigin, see, shipeasy, version };

package/dist/client/index.d.ts

@@ -51,6 +51,16 @@ interface SeeErrorEvent {
     env?: string;
     sdk_version: string;
     ts: number;
+    /**
+     * Per-request correlation token. The client mints one per same-origin fetch
+     * and ships it on both the request header (`X-SE-Correlation`) and any 5xx
+     * occurrence it reports; the server safety net reports the matching uncaught
+     * error under the same token. The backend joins the two issues by it —
+     * populating `caused_by` across the network boundary, where the in-process
+     * `.cause`-chain stamp (see `findCausedBy`) cannot reach. Join-only metadata,
+     * never persisted as an issue field.
+     */
+    correlation_id?: string;
     /**
      * The earlier reported problem this occurrence descends from — present when
      * the same error was caught + reported at an inner boundary and then
@@ -120,6 +130,15 @@ interface AutoCollectGroups {
     errors: boolean;
     engagement: boolean;
 }
+/** True when `rawUrl` resolves to the page's own origin (relative URLs included). */
+declare function sameOrigin(rawUrl: string): boolean;
+/**
+ * Return a new `fetch` args tuple with `X-SE-Correlation` added, preserving any
+ * existing headers across all three arg shapes (string / URL / Request). Never
+ * mutates the caller's objects. Best-effort: on any failure the original args
+ * pass through unchanged (correlation is optional, never breaks the fetch).
+ */
+declare function injectCorrelationHeader(args: Parameters<typeof fetch>, corr: string): Parameters<typeof fetch>;
 type FlagsClientBrowserEnv = "dev" | "staging" | "prod";
 interface FlagsClientBrowserOptions {
     sdkKey: string;
@@ -176,7 +195,7 @@ declare class FlagsClientBrowser {
      * (beacon-first) — error occurrences are near-real-time, never queued behind
      * the 5s metric batch. Spam-guarded by a 30s dedup window + per-session cap.
      */
-    reportError(problem: unknown, consequence: Consequence, extras?: SeeExtras, kind?: SeeKind): void;
+    reportError(problem: unknown, consequence: Consequence, extras?: SeeExtras, kind?: SeeKind, correlationId?: string): void;
     get ready(): boolean;
     private notify;
     initFromBootstrap(data: EvalResponse): void;
@@ -478,4 +497,4 @@ interface I18nFacade {
 }
 declare const i18n: I18nFacade;
 
-export { type AutoCollectGroups, type BootstrapPayload, type Consequence, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, type Violation, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, see, shipeasy, version };
+export { type AutoCollectGroups, type BootstrapPayload, type Consequence, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, type Violation, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, injectCorrelationHeader, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, sameOrigin, see, shipeasy, version };

package/dist/client/index.js

@@ -32,12 +32,14 @@ __export(client_exports, {
   flags: () => flags,
   getShipeasyClient: () => getShipeasyClient,
   i18n: () => i18n,
+  injectCorrelationHeader: () => injectCorrelationHeader,
   isDevtoolsRequested: () => isDevtoolsRequested,
   labelAttrs: () => labelAttrs,
   loadDevtools: () => loadDevtools,
   readConfigOverride: () => readConfigOverride,
   readExpOverride: () => readExpOverride,
   readGateOverride: () => readGateOverride,
+  sameOrigin: () => sameOrigin,
   see: () => see,
   shipeasy: () => shipeasy,
   version: () => version
@@ -109,6 +111,7 @@ var SEE_MAX_STACK = 8e3;
 var SEE_MAX_SUBJECT = 200;
 var SEE_MAX_EXTRA_VALUE = 200;
 var SEE_MAX_EXTRA_KEYS = 20;
+var SEE_MAX_CORRELATION = 64;
 var SEE_DEDUP_WINDOW_MS = 3e4;
 var SEE_MAX_PER_SESSION = 25;
 function causesThe(subject) {
@@ -215,7 +218,7 @@ function captureCallsiteStack() {
   const kept = lines.slice(1).filter((l) => !/@shipeasy[\\/]sdk|see[\\/]core|captureCallsiteStack|\bsee\b\s*\(/.test(l));
   return kept.length ? kept.join("\n") : void 0;
 }
-function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
+function buildSeeEvent(problem, consequence, extras, ctx, kindOverride, correlationId) {
   let errorType;
   let message;
   let stack;
@@ -248,6 +251,7 @@ function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
     ts: Date.now()
   };
   if (stack) ev.stack = truncate(stack, SEE_MAX_STACK);
+  if (correlationId) ev.correlation_id = truncate(String(correlationId), SEE_MAX_CORRELATION);
   const causedBy = findCausedBy(problem);
   if (causedBy) ev.caused_by = causedBy;
   const cleanExtras = sanitizeExtras(extras);
@@ -501,8 +505,33 @@ function endpointTemplate(rawUrl) {
     return (rawUrl.split(/[?#]/)[0] ?? "").slice(0, 120);
   }
   const path = u.pathname.split("/").map((seg) => seg && isIdSegment(seg) ? ":id" : seg).join("/");
-  const sameOrigin = typeof location !== "undefined" && u.origin === location.origin;
-  return ((sameOrigin ? "" : u.host) + path).slice(0, 120);
+  const sameOrigin2 = typeof location !== "undefined" && u.origin === location.origin;
+  return ((sameOrigin2 ? "" : u.host) + path).slice(0, 120);
+}
+function sameOrigin(rawUrl) {
+  if (typeof location === "undefined") return false;
+  try {
+    return new URL(rawUrl, location.href).origin === location.origin;
+  } catch {
+    return false;
+  }
+}
+function injectCorrelationHeader(args, corr) {
+  try {
+    const input = args[0];
+    if (typeof Request !== "undefined" && input instanceof Request) {
+      const headers2 = new Headers(input.headers);
+      headers2.set("X-SE-Correlation", corr);
+      return [new Request(input, { headers: headers2 }), ...args.slice(1)];
+    }
+    const init = { ...args[1] ?? {} };
+    const headers = new Headers(init.headers ?? void 0);
+    headers.set("X-SE-Correlation", corr);
+    init.headers = headers;
+    return [input, init];
+  } catch {
+    return args;
+  }
 }
 function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignoreUrlPrefixes, always = false) {
   if (typeof window === "undefined" || typeof PerformanceObserver === "undefined") return;
@@ -579,6 +608,11 @@ function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignore
       const url = typeof args[0] === "string" ? args[0] : args[0].toString();
       const ignored = ignoreUrlPrefixes.some((p) => p && url.startsWith(p));
       const bareUrl = url.split("?")[0].slice(0, 200);
+      let corr;
+      if (!ignored && sameOrigin(url) && typeof crypto !== "undefined" && crypto.randomUUID) {
+        corr = crypto.randomUUID();
+        args = injectCorrelationHeader(args, corr);
+      }
       let res;
       try {
         res = await origFetch.apply(this, args);
@@ -599,7 +633,8 @@ function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignore
           violation("Http5xx").message(`request to ${bareUrl} returned ${res.status}`),
           causesThe(`request to ${endpointTemplate(url)}`).to("fail with a server error"),
           { status: res.status, url: url.slice(0, 200), duration_ms: Math.round(elapsed) },
-          "network"
+          "network",
+          corr
         );
       }
       return res;
@@ -694,17 +729,40 @@ function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignore
     });
   }
 }
-function getOrCreateAnonId() {
+function readAnonCookie() {
   try {
-    const stored = localStorage.getItem(ANON_ID_KEY);
-    if (stored) return stored;
+    const m = ("; " + document.cookie).match(/; __se_anon_id=([^;]+)/);
+    return m ? decodeURIComponent(m[1]) : null;
   } catch {
+    return null;
+  }
+}
+function writeAnonCookie(id) {
+  try {
+    const secure = location.protocol === "https:" ? ";secure" : "";
+    document.cookie = `${ANON_ID_KEY}=${id};path=/;max-age=31536000;samesite=lax${secure}`;
+  } catch {
+  }
+}
+function getOrCreateAnonId() {
+  let id = readAnonCookie();
+  if (!id && typeof window !== "undefined") {
+    id = window.__SE_BOOTSTRAP?.anonId ?? null;
+  }
+  if (!id) {
+    try {
+      id = localStorage.getItem(ANON_ID_KEY);
+    } catch {
+    }
+  }
+  if (!id) {
+    id = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `anon_${Math.random().toString(36).slice(2)}`;
   }
-  const id = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `anon_${Math.random().toString(36).slice(2)}`;
   try {
     localStorage.setItem(ANON_ID_KEY, id);
   } catch {
   }
+  writeAnonCookie(id);
   return id;
 }
 function collectBrowserAttrs() {
@@ -911,7 +969,7 @@ var FlagsClientBrowser = class {
         this.userId,
         this.anonId,
         this.autoGuardrailGroups,
-        (problem, consequence, extras, kind) => this.reportError(problem, consequence, extras, kind),
+        (problem, consequence, extras, kind, correlationId) => this.reportError(problem, consequence, extras, kind, correlationId),
         [`${this.baseUrl}/`, DEFAULT_TELEMETRY_URL],
         this.autoCollectAlways
       );
@@ -923,7 +981,7 @@ var FlagsClientBrowser = class {
    * (beacon-first) — error occurrences are near-real-time, never queued behind
    * the 5s metric batch. Spam-guarded by a 30s dedup window + per-session cap.
    */
-  reportError(problem, consequence, extras, kind) {
+  reportError(problem, consequence, extras, kind, correlationId) {
     try {
       const enriched = { ...collectSeeEnv(), ...extras };
       const ev = buildSeeEvent(problem, consequence, enriched, {
@@ -933,7 +991,7 @@ var FlagsClientBrowser = class {
         url: typeof window !== "undefined" && window.location ? window.location.href : void 0,
         userId: this.userId || void 0,
         anonId: this.anonId
-      }, kind);
+      }, kind, correlationId);
       if (!this.seeLimiter.shouldSend(ev)) return;
       this.buffer.sendNow([ev]);
     } catch {
@@ -1600,12 +1658,14 @@ var i18n = {
   flags,
   getShipeasyClient,
   i18n,
+  injectCorrelationHeader,
   isDevtoolsRequested,
   labelAttrs,
   loadDevtools,
   readConfigOverride,
   readExpOverride,
   readGateOverride,
+  sameOrigin,
   see,
   shipeasy,
   version

package/dist/client/index.mjs

@@ -63,6 +63,7 @@ var SEE_MAX_STACK = 8e3;
 var SEE_MAX_SUBJECT = 200;
 var SEE_MAX_EXTRA_VALUE = 200;
 var SEE_MAX_EXTRA_KEYS = 20;
+var SEE_MAX_CORRELATION = 64;
 var SEE_DEDUP_WINDOW_MS = 3e4;
 var SEE_MAX_PER_SESSION = 25;
 function causesThe(subject) {
@@ -169,7 +170,7 @@ function captureCallsiteStack() {
   const kept = lines.slice(1).filter((l) => !/@shipeasy[\\/]sdk|see[\\/]core|captureCallsiteStack|\bsee\b\s*\(/.test(l));
   return kept.length ? kept.join("\n") : void 0;
 }
-function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
+function buildSeeEvent(problem, consequence, extras, ctx, kindOverride, correlationId) {
   let errorType;
   let message;
   let stack;
@@ -202,6 +203,7 @@ function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
     ts: Date.now()
   };
   if (stack) ev.stack = truncate(stack, SEE_MAX_STACK);
+  if (correlationId) ev.correlation_id = truncate(String(correlationId), SEE_MAX_CORRELATION);
   const causedBy = findCausedBy(problem);
   if (causedBy) ev.caused_by = causedBy;
   const cleanExtras = sanitizeExtras(extras);
@@ -455,8 +457,33 @@ function endpointTemplate(rawUrl) {
     return (rawUrl.split(/[?#]/)[0] ?? "").slice(0, 120);
   }
   const path = u.pathname.split("/").map((seg) => seg && isIdSegment(seg) ? ":id" : seg).join("/");
-  const sameOrigin = typeof location !== "undefined" && u.origin === location.origin;
-  return ((sameOrigin ? "" : u.host) + path).slice(0, 120);
+  const sameOrigin2 = typeof location !== "undefined" && u.origin === location.origin;
+  return ((sameOrigin2 ? "" : u.host) + path).slice(0, 120);
+}
+function sameOrigin(rawUrl) {
+  if (typeof location === "undefined") return false;
+  try {
+    return new URL(rawUrl, location.href).origin === location.origin;
+  } catch {
+    return false;
+  }
+}
+function injectCorrelationHeader(args, corr) {
+  try {
+    const input = args[0];
+    if (typeof Request !== "undefined" && input instanceof Request) {
+      const headers2 = new Headers(input.headers);
+      headers2.set("X-SE-Correlation", corr);
+      return [new Request(input, { headers: headers2 }), ...args.slice(1)];
+    }
+    const init = { ...args[1] ?? {} };
+    const headers = new Headers(init.headers ?? void 0);
+    headers.set("X-SE-Correlation", corr);
+    init.headers = headers;
+    return [input, init];
+  } catch {
+    return args;
+  }
 }
 function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignoreUrlPrefixes, always = false) {
   if (typeof window === "undefined" || typeof PerformanceObserver === "undefined") return;
@@ -533,6 +560,11 @@ function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignore
       const url = typeof args[0] === "string" ? args[0] : args[0].toString();
       const ignored = ignoreUrlPrefixes.some((p) => p && url.startsWith(p));
       const bareUrl = url.split("?")[0].slice(0, 200);
+      let corr;
+      if (!ignored && sameOrigin(url) && typeof crypto !== "undefined" && crypto.randomUUID) {
+        corr = crypto.randomUUID();
+        args = injectCorrelationHeader(args, corr);
+      }
       let res;
       try {
         res = await origFetch.apply(this, args);
@@ -553,7 +585,8 @@ function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignore
           violation("Http5xx").message(`request to ${bareUrl} returned ${res.status}`),
           causesThe(`request to ${endpointTemplate(url)}`).to("fail with a server error"),
           { status: res.status, url: url.slice(0, 200), duration_ms: Math.round(elapsed) },
-          "network"
+          "network",
+          corr
         );
       }
       return res;
@@ -648,17 +681,40 @@ function installAutoGuardrails(buffer, userId, anonId, groups, reportSee, ignore
     });
   }
 }
-function getOrCreateAnonId() {
+function readAnonCookie() {
   try {
-    const stored = localStorage.getItem(ANON_ID_KEY);
-    if (stored) return stored;
+    const m = ("; " + document.cookie).match(/; __se_anon_id=([^;]+)/);
+    return m ? decodeURIComponent(m[1]) : null;
   } catch {
+    return null;
+  }
+}
+function writeAnonCookie(id) {
+  try {
+    const secure = location.protocol === "https:" ? ";secure" : "";
+    document.cookie = `${ANON_ID_KEY}=${id};path=/;max-age=31536000;samesite=lax${secure}`;
+  } catch {
+  }
+}
+function getOrCreateAnonId() {
+  let id = readAnonCookie();
+  if (!id && typeof window !== "undefined") {
+    id = window.__SE_BOOTSTRAP?.anonId ?? null;
+  }
+  if (!id) {
+    try {
+      id = localStorage.getItem(ANON_ID_KEY);
+    } catch {
+    }
+  }
+  if (!id) {
+    id = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `anon_${Math.random().toString(36).slice(2)}`;
   }
-  const id = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `anon_${Math.random().toString(36).slice(2)}`;
   try {
     localStorage.setItem(ANON_ID_KEY, id);
   } catch {
   }
+  writeAnonCookie(id);
   return id;
 }
 function collectBrowserAttrs() {
@@ -865,7 +921,7 @@ var FlagsClientBrowser = class {
         this.userId,
         this.anonId,
         this.autoGuardrailGroups,
-        (problem, consequence, extras, kind) => this.reportError(problem, consequence, extras, kind),
+        (problem, consequence, extras, kind, correlationId) => this.reportError(problem, consequence, extras, kind, correlationId),
         [`${this.baseUrl}/`, DEFAULT_TELEMETRY_URL],
         this.autoCollectAlways
       );
@@ -877,7 +933,7 @@ var FlagsClientBrowser = class {
    * (beacon-first) — error occurrences are near-real-time, never queued behind
    * the 5s metric batch. Spam-guarded by a 30s dedup window + per-session cap.
    */
-  reportError(problem, consequence, extras, kind) {
+  reportError(problem, consequence, extras, kind, correlationId) {
     try {
       const enriched = { ...collectSeeEnv(), ...extras };
       const ev = buildSeeEvent(problem, consequence, enriched, {
@@ -887,7 +943,7 @@ var FlagsClientBrowser = class {
         url: typeof window !== "undefined" && window.location ? window.location.href : void 0,
         userId: this.userId || void 0,
         anonId: this.anonId
-      }, kind);
+      }, kind, correlationId);
       if (!this.seeLimiter.shouldSend(ev)) return;
       this.buffer.sendNow([ev]);
     } catch {
@@ -1553,12 +1609,14 @@ export {
   flags,
   getShipeasyClient,
   i18n,
+  injectCorrelationHeader,
   isDevtoolsRequested,
   labelAttrs,
   loadDevtools,
   readConfigOverride,
   readExpOverride,
   readGateOverride,
+  sameOrigin,
   see,
   shipeasy,
   version

package/dist/server/index.d.mts

@@ -1,3 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+
 type SeeExtras = Record<string, string | number | boolean | null | undefined>;
 type SeeKind = "caught" | "uncaught" | "unhandled_rejection" | "network" | "violation";
 /** Built by `causesThe(subject).to(outcome)` — never constructed by hand. */
@@ -51,6 +53,16 @@ interface SeeErrorEvent {
     env?: string;
     sdk_version: string;
     ts: number;
+    /**
+     * Per-request correlation token. The client mints one per same-origin fetch
+     * and ships it on both the request header (`X-SE-Correlation`) and any 5xx
+     * occurrence it reports; the server safety net reports the matching uncaught
+     * error under the same token. The backend joins the two issues by it —
+     * populating `caused_by` across the network boundary, where the in-process
+     * `.cause`-chain stamp (see `findCausedBy`) cannot reach. Join-only metadata,
+     * never persisted as an issue field.
+     */
+    correlation_id?: string;
     /**
      * The earlier reported problem this occurrence descends from — present when
      * the same error was caught + reported at an inner boundary and then
@@ -60,6 +72,7 @@ interface SeeErrorEvent {
      */
     caused_by?: SeeCausedBy;
 }
+declare function isExpected(err: unknown): boolean;
 interface SeeExtrasTail {
     /** Attach debugging metadata. Callable repeatedly — keys merge, later wins. */
     extras(extras: SeeExtras): SeeExtrasTail;
@@ -121,6 +134,7 @@ interface BootstrapPayload {
     experiments: Record<string, ExperimentResult<Record<string, unknown>>>;
     killswitches: Record<string, boolean | Record<string, boolean>>;
 }
+declare const ANON_ID_COOKIE = "__se_anon_id";
 type FlagsClientEnv = "dev" | "staging" | "prod";
 interface FlagsClientOptions {
     apiKey: string;
@@ -187,6 +201,11 @@ declare class FlagsClient {
     evaluate(user: User, rawUrl?: string): BootstrapPayload;
     getKillswitch(name: string, switchKey?: string): boolean;
 }
+interface SeeCorrelationStore {
+    correlationId?: string;
+}
+declare const seeContext: AsyncLocalStorage<SeeCorrelationStore>;
+
 interface I18nForRequest {
     strings: Record<string, string>;
     locale: string;
@@ -273,6 +292,14 @@ interface BootstrapHtmlOptions {
     i18nProfile?: string;
     /** When true, tEl() embeds label markers so the devtools can highlight them. */
     editLabels?: boolean;
+    /**
+     * Stable anonymous bucketing id the server evaluated against. Emitted into
+     * window.__SE_BOOTSTRAP and persisted (pre-paint) to the first-party
+     * `__se_anon_id` cookie, so the browser SDK buckets identically to SSR.
+     * Normally minted by edge middleware; this write is the fallback for routes
+     * middleware doesn't cover. See experiment-platform/18-identity-bucketing.md.
+     */
+    anonId?: string;
 }
 /**
  * Returns a vanilla-JS string for a single inline <script> tag. Handles
@@ -362,4 +389,4 @@ interface SeeApi {
  */
 declare const see: SeeApi;
 
-export { type BootstrapHtmlOptions, type BootstrapPayload, type Consequence, type ExperimentResult, type FetchLabelsOptions, FlagsClient, type FlagsClientEnv, type FlagsClientOptions, type I18nForRequest, type LabelFile, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyServerConfig, type ShipeasyServerHandle, type User, type Violation, _resetShipeasyServerForTests, configureShipeasyServer, fetchLabelsForSSR, flags, getBootstrapHtml, getShipeasyServerClient, i18n, see, shipeasy, version };
+export { ANON_ID_COOKIE, type BootstrapHtmlOptions, type BootstrapPayload, type Consequence, type ExperimentResult, type FetchLabelsOptions, FlagsClient, type FlagsClientEnv, type FlagsClientOptions, type I18nForRequest, type LabelFile, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyServerConfig, type ShipeasyServerHandle, type User, type Violation, _resetShipeasyServerForTests, configureShipeasyServer, fetchLabelsForSSR, flags, getBootstrapHtml, getShipeasyServerClient, i18n, isExpected, see, seeContext, shipeasy, version };

package/dist/server/index.d.ts

@@ -1,3 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+
 type SeeExtras = Record<string, string | number | boolean | null | undefined>;
 type SeeKind = "caught" | "uncaught" | "unhandled_rejection" | "network" | "violation";
 /** Built by `causesThe(subject).to(outcome)` — never constructed by hand. */
@@ -51,6 +53,16 @@ interface SeeErrorEvent {
     env?: string;
     sdk_version: string;
     ts: number;
+    /**
+     * Per-request correlation token. The client mints one per same-origin fetch
+     * and ships it on both the request header (`X-SE-Correlation`) and any 5xx
+     * occurrence it reports; the server safety net reports the matching uncaught
+     * error under the same token. The backend joins the two issues by it —
+     * populating `caused_by` across the network boundary, where the in-process
+     * `.cause`-chain stamp (see `findCausedBy`) cannot reach. Join-only metadata,
+     * never persisted as an issue field.
+     */
+    correlation_id?: string;
     /**
      * The earlier reported problem this occurrence descends from — present when
      * the same error was caught + reported at an inner boundary and then
@@ -60,6 +72,7 @@ interface SeeErrorEvent {
      */
     caused_by?: SeeCausedBy;
 }
+declare function isExpected(err: unknown): boolean;
 interface SeeExtrasTail {
     /** Attach debugging metadata. Callable repeatedly — keys merge, later wins. */
     extras(extras: SeeExtras): SeeExtrasTail;
@@ -121,6 +134,7 @@ interface BootstrapPayload {
     experiments: Record<string, ExperimentResult<Record<string, unknown>>>;
     killswitches: Record<string, boolean | Record<string, boolean>>;
 }
+declare const ANON_ID_COOKIE = "__se_anon_id";
 type FlagsClientEnv = "dev" | "staging" | "prod";
 interface FlagsClientOptions {
     apiKey: string;
@@ -187,6 +201,11 @@ declare class FlagsClient {
     evaluate(user: User, rawUrl?: string): BootstrapPayload;
     getKillswitch(name: string, switchKey?: string): boolean;
 }
+interface SeeCorrelationStore {
+    correlationId?: string;
+}
+declare const seeContext: AsyncLocalStorage<SeeCorrelationStore>;
+
 interface I18nForRequest {
     strings: Record<string, string>;
     locale: string;
@@ -273,6 +292,14 @@ interface BootstrapHtmlOptions {
     i18nProfile?: string;
     /** When true, tEl() embeds label markers so the devtools can highlight them. */
     editLabels?: boolean;
+    /**
+     * Stable anonymous bucketing id the server evaluated against. Emitted into
+     * window.__SE_BOOTSTRAP and persisted (pre-paint) to the first-party
+     * `__se_anon_id` cookie, so the browser SDK buckets identically to SSR.
+     * Normally minted by edge middleware; this write is the fallback for routes
+     * middleware doesn't cover. See experiment-platform/18-identity-bucketing.md.
+     */
+    anonId?: string;
 }
 /**
  * Returns a vanilla-JS string for a single inline <script> tag. Handles
@@ -362,4 +389,4 @@ interface SeeApi {
  */
 declare const see: SeeApi;
 
-export { type BootstrapHtmlOptions, type BootstrapPayload, type Consequence, type ExperimentResult, type FetchLabelsOptions, FlagsClient, type FlagsClientEnv, type FlagsClientOptions, type I18nForRequest, type LabelFile, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyServerConfig, type ShipeasyServerHandle, type User, type Violation, _resetShipeasyServerForTests, configureShipeasyServer, fetchLabelsForSSR, flags, getBootstrapHtml, getShipeasyServerClient, i18n, see, shipeasy, version };
+export { ANON_ID_COOKIE, type BootstrapHtmlOptions, type BootstrapPayload, type Consequence, type ExperimentResult, type FetchLabelsOptions, FlagsClient, type FlagsClientEnv, type FlagsClientOptions, type I18nForRequest, type LabelFile, type SeeApi, type SeeChain, type SeeErrorEvent, type SeeExtras, type SeeKind, type SeeViolationChain, type ShipeasyServerConfig, type ShipeasyServerHandle, type User, type Violation, _resetShipeasyServerForTests, configureShipeasyServer, fetchLabelsForSSR, flags, getBootstrapHtml, getShipeasyServerClient, i18n, isExpected, see, seeContext, shipeasy, version };

package/dist/server/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server/index.ts
 var server_exports = {};
 __export(server_exports, {
+  ANON_ID_COOKIE: () => ANON_ID_COOKIE,
   FlagsClient: () => FlagsClient,
   _resetShipeasyServerForTests: () => _resetShipeasyServerForTests,
   configureShipeasyServer: () => configureShipeasyServer,
@@ -38,7 +39,9 @@ __export(server_exports, {
   getBootstrapHtml: () => getBootstrapHtml,
   getShipeasyServerClient: () => getShipeasyServerClient,
   i18n: () => i18n,
+  isExpected: () => isExpected,
   see: () => see,
+  seeContext: () => seeContext,
   shipeasy: () => shipeasy,
   version: () => version
 });
@@ -110,6 +113,7 @@ var SEE_MAX_STACK = 8e3;
 var SEE_MAX_SUBJECT = 200;
 var SEE_MAX_EXTRA_VALUE = 200;
 var SEE_MAX_EXTRA_KEYS = 20;
+var SEE_MAX_CORRELATION = 64;
 var SEE_DEDUP_WINDOW_MS = 3e4;
 var SEE_MAX_PER_SESSION = 25;
 function causesThe(subject) {
@@ -149,6 +153,10 @@ function markExpected(err, because) {
   } catch {
   }
 }
+function isExpected(err) {
+  if (typeof err !== "object" || err === null) return false;
+  return err[EXPECTED_SYM] !== void 0;
+}
 var REPORTED_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:see-reported");
 var SEE_MAX_CAUSE_DEPTH = 8;
 function readReportStamp(err) {
@@ -212,7 +220,7 @@ function captureCallsiteStack() {
   const kept = lines.slice(1).filter((l) => !/@shipeasy[\\/]sdk|see[\\/]core|captureCallsiteStack|\bsee\b\s*\(/.test(l));
   return kept.length ? kept.join("\n") : void 0;
 }
-function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
+function buildSeeEvent(problem, consequence, extras, ctx, kindOverride, correlationId) {
   let errorType;
   let message;
   let stack;
@@ -245,6 +253,7 @@ function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
     ts: Date.now()
   };
   if (stack) ev.stack = truncate(stack, SEE_MAX_STACK);
+  if (correlationId) ev.correlation_id = truncate(String(correlationId), SEE_MAX_CORRELATION);
   const causedBy = findCausedBy(problem);
   if (causedBy) ev.caused_by = causedBy;
   const cleanExtras = sanitizeExtras(extras);
@@ -434,6 +443,11 @@ function matchRule(rule, user) {
       return false;
   }
 }
+var ANON_ID_COOKIE = "__se_anon_id";
+var ANON_ID_RX = /^[A-Za-z0-9_-]{1,64}$/;
+function mintAnonId() {
+  return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `anon_${Math.random().toString(36).slice(2)}`;
+}
 function evalGateInternal(gate, user) {
   if (isEnabled(gate.killswitch)) return false;
   if (!isEnabled(gate.enabled)) return false;
@@ -441,7 +455,7 @@ function evalGateInternal(gate, user) {
     if (!matchRule(rule, user)) return false;
   }
   const uid = user.user_id ?? user.anonymous_id;
-  if (!uid) return false;
+  if (!uid) return gate.rolloutPct >= 1e4;
   return murmur3(`${gate.salt}:${uid}`) % 1e4 < gate.rolloutPct;
 }
 var TRUE_RX = /^(true|on|1|yes)$/i;
@@ -654,11 +668,12 @@ var FlagsClient = class {
    */
   reportError(problem, consequence, extras, kind) {
     try {
+      const correlationId = seeContext.getStore()?.correlationId;
       const ev = buildSeeEvent(problem, consequence, extras, {
         side: "server",
         sdkVersion: version,
         env: this.env
-      }, kind);
+      }, kind, correlationId);
       if (!this.seeLimiter.shouldSend(ev)) return;
       globalThis.fetch(`${this.baseUrl}/collect`, {
         method: "POST",
@@ -753,6 +768,8 @@ Object.defineProperty(globalThis, _EDIT_MODE_SSR_SYM, {
   },
   configurable: true
 });
+var _SEE_CORR_ALS_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:see-correlation-als");
+var seeContext = globalThis[_SEE_CORR_ALS_SYM] ?? (globalThis[_SEE_CORR_ALS_SYM] = new import_node_async_hooks.AsyncLocalStorage());
 var i18n = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -874,7 +891,23 @@ async function shipeasy(opts) {
     serverKey ? flags.initOnce() : Promise.resolve(),
     serverKey ? i18n.init(serverKey, profile) : Promise.resolve()
   ]);
-  const bootstrap = flags.evaluate(opts.user ?? {}, resolvedUrlOverrides);
+  let anonId;
+  if (!opts.user?.user_id) {
+    if (opts.user?.anonymous_id) {
+      anonId = opts.user.anonymous_id;
+    } else {
+      try {
+        const { cookies } = await import("next/headers");
+        const c = await Promise.resolve(cookies());
+        const raw = c.get?.(ANON_ID_COOKIE)?.value;
+        if (raw && ANON_ID_RX.test(raw)) anonId = raw;
+      } catch {
+      }
+      if (!anonId) anonId = mintAnonId();
+    }
+  }
+  const effectiveUser = anonId ? { anonymous_id: anonId, ...opts.user } : { ...opts.user };
+  const bootstrap = flags.evaluate(effectiveUser, resolvedUrlOverrides);
   const i18nData = i18n.getForRequest();
   return {
     flags: bootstrap.flags,
@@ -883,7 +916,8 @@ async function shipeasy(opts) {
     getBootstrapHtml() {
       return getBootstrapHtml(bootstrap, i18nData, {
         editLabels,
-        i18nProfile: profile
+        i18nProfile: profile,
+        anonId
       });
     }
   };
@@ -903,10 +937,16 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
   };
   if (i18nData) payload.i18n = i18nData;
   if (opts.editLabels) payload.editLabels = true;
+  if (opts.anonId) payload.anonId = opts.anonId;
   parts.push(
     `(function(){var Q=new URLSearchParams(location.search).has('se_edit_labels');var C=/(?:^|;\\s*)se_edit_labels=1(?:;|$)/.test(document.cookie);if(!Q&&!C)return;if(Q){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 (opts.anonId) {
+    parts.push(
+      `(function(){try{var k=${JSON.stringify(ANON_ID_COOKIE)},v=${JSON.stringify(opts.anonId)};if(('; '+document.cookie).indexOf('; '+k+'=')===-1){document.cookie=k+'='+v+';path=/;max-age=31536000;samesite=lax'+(location.protocol==='https:'?';secure':'');}}catch(_){}})();`
+    );
+  }
   if (i18nData?.strings && Object.keys(i18nData.strings).length > 0) {
     parts.push(
       `(function(){var d=window.__SE_BOOTSTRAP.i18n;if(!d)return;window.i18n={locale:d.locale,t:function(k,v){var r=d.strings[k];if(!r)return k;return v?r.replace(/\\{\\{(\\w+)\\}\\}/g,function(_,p){return v[p]!==undefined?String(v[p]):'{{'+p+'}}'}):r;},on:function(){return function(){};}};})();`
@@ -992,6 +1032,7 @@ var see = Object.assign(
 );
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ANON_ID_COOKIE,
   FlagsClient,
   _resetShipeasyServerForTests,
   configureShipeasyServer,
@@ -1000,7 +1041,9 @@ var see = Object.assign(
   getBootstrapHtml,
   getShipeasyServerClient,
   i18n,
+  isExpected,
   see,
+  seeContext,
   shipeasy,
   version
 });

package/dist/server/index.mjs

@@ -66,6 +66,7 @@ var SEE_MAX_STACK = 8e3;
 var SEE_MAX_SUBJECT = 200;
 var SEE_MAX_EXTRA_VALUE = 200;
 var SEE_MAX_EXTRA_KEYS = 20;
+var SEE_MAX_CORRELATION = 64;
 var SEE_DEDUP_WINDOW_MS = 3e4;
 var SEE_MAX_PER_SESSION = 25;
 function causesThe(subject) {
@@ -105,6 +106,10 @@ function markExpected(err, because) {
   } catch {
   }
 }
+function isExpected(err) {
+  if (typeof err !== "object" || err === null) return false;
+  return err[EXPECTED_SYM] !== void 0;
+}
 var REPORTED_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:see-reported");
 var SEE_MAX_CAUSE_DEPTH = 8;
 function readReportStamp(err) {
@@ -168,7 +173,7 @@ function captureCallsiteStack() {
   const kept = lines.slice(1).filter((l) => !/@shipeasy[\\/]sdk|see[\\/]core|captureCallsiteStack|\bsee\b\s*\(/.test(l));
   return kept.length ? kept.join("\n") : void 0;
 }
-function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
+function buildSeeEvent(problem, consequence, extras, ctx, kindOverride, correlationId) {
   let errorType;
   let message;
   let stack;
@@ -201,6 +206,7 @@ function buildSeeEvent(problem, consequence, extras, ctx, kindOverride) {
     ts: Date.now()
   };
   if (stack) ev.stack = truncate(stack, SEE_MAX_STACK);
+  if (correlationId) ev.correlation_id = truncate(String(correlationId), SEE_MAX_CORRELATION);
   const causedBy = findCausedBy(problem);
   if (causedBy) ev.caused_by = causedBy;
   const cleanExtras = sanitizeExtras(extras);
@@ -390,6 +396,11 @@ function matchRule(rule, user) {
       return false;
   }
 }
+var ANON_ID_COOKIE = "__se_anon_id";
+var ANON_ID_RX = /^[A-Za-z0-9_-]{1,64}$/;
+function mintAnonId() {
+  return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `anon_${Math.random().toString(36).slice(2)}`;
+}
 function evalGateInternal(gate, user) {
   if (isEnabled(gate.killswitch)) return false;
   if (!isEnabled(gate.enabled)) return false;
@@ -397,7 +408,7 @@ function evalGateInternal(gate, user) {
     if (!matchRule(rule, user)) return false;
   }
   const uid = user.user_id ?? user.anonymous_id;
-  if (!uid) return false;
+  if (!uid) return gate.rolloutPct >= 1e4;
   return murmur3(`${gate.salt}:${uid}`) % 1e4 < gate.rolloutPct;
 }
 var TRUE_RX = /^(true|on|1|yes)$/i;
@@ -610,11 +621,12 @@ var FlagsClient = class {
    */
   reportError(problem, consequence, extras, kind) {
     try {
+      const correlationId = seeContext.getStore()?.correlationId;
       const ev = buildSeeEvent(problem, consequence, extras, {
         side: "server",
         sdkVersion: version,
         env: this.env
-      }, kind);
+      }, kind, correlationId);
       if (!this.seeLimiter.shouldSend(ev)) return;
       globalThis.fetch(`${this.baseUrl}/collect`, {
         method: "POST",
@@ -709,6 +721,8 @@ Object.defineProperty(globalThis, _EDIT_MODE_SSR_SYM, {
   },
   configurable: true
 });
+var _SEE_CORR_ALS_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:see-correlation-als");
+var seeContext = globalThis[_SEE_CORR_ALS_SYM] ?? (globalThis[_SEE_CORR_ALS_SYM] = new AsyncLocalStorage());
 var i18n = {
   /**
    * Fetch translation labels for the current request and store them in an
@@ -830,7 +844,23 @@ async function shipeasy(opts) {
     serverKey ? flags.initOnce() : Promise.resolve(),
     serverKey ? i18n.init(serverKey, profile) : Promise.resolve()
   ]);
-  const bootstrap = flags.evaluate(opts.user ?? {}, resolvedUrlOverrides);
+  let anonId;
+  if (!opts.user?.user_id) {
+    if (opts.user?.anonymous_id) {
+      anonId = opts.user.anonymous_id;
+    } else {
+      try {
+        const { cookies } = await import("next/headers");
+        const c = await Promise.resolve(cookies());
+        const raw = c.get?.(ANON_ID_COOKIE)?.value;
+        if (raw && ANON_ID_RX.test(raw)) anonId = raw;
+      } catch {
+      }
+      if (!anonId) anonId = mintAnonId();
+    }
+  }
+  const effectiveUser = anonId ? { anonymous_id: anonId, ...opts.user } : { ...opts.user };
+  const bootstrap = flags.evaluate(effectiveUser, resolvedUrlOverrides);
   const i18nData = i18n.getForRequest();
   return {
     flags: bootstrap.flags,
@@ -839,7 +869,8 @@ async function shipeasy(opts) {
     getBootstrapHtml() {
       return getBootstrapHtml(bootstrap, i18nData, {
         editLabels,
-        i18nProfile: profile
+        i18nProfile: profile,
+        anonId
       });
     }
   };
@@ -859,10 +890,16 @@ function getBootstrapHtml(bootstrap, i18nData, opts) {
   };
   if (i18nData) payload.i18n = i18nData;
   if (opts.editLabels) payload.editLabels = true;
+  if (opts.anonId) payload.anonId = opts.anonId;
   parts.push(
     `(function(){var Q=new URLSearchParams(location.search).has('se_edit_labels');var C=/(?:^|;\\s*)se_edit_labels=1(?:;|$)/.test(document.cookie);if(!Q&&!C)return;if(Q){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 (opts.anonId) {
+    parts.push(
+      `(function(){try{var k=${JSON.stringify(ANON_ID_COOKIE)},v=${JSON.stringify(opts.anonId)};if(('; '+document.cookie).indexOf('; '+k+'=')===-1){document.cookie=k+'='+v+';path=/;max-age=31536000;samesite=lax'+(location.protocol==='https:'?';secure':'');}}catch(_){}})();`
+    );
+  }
   if (i18nData?.strings && Object.keys(i18nData.strings).length > 0) {
     parts.push(
       `(function(){var d=window.__SE_BOOTSTRAP.i18n;if(!d)return;window.i18n={locale:d.locale,t:function(k,v){var r=d.strings[k];if(!r)return k;return v?r.replace(/\\{\\{(\\w+)\\}\\}/g,function(_,p){return v[p]!==undefined?String(v[p]):'{{'+p+'}}'}):r;},on:function(){return function(){};}};})();`
@@ -947,6 +984,7 @@ var see = Object.assign(
   }
 );
 export {
+  ANON_ID_COOKIE,
   FlagsClient,
   _resetShipeasyServerForTests,
   configureShipeasyServer,
@@ -955,7 +993,9 @@ export {
   getBootstrapHtml,
   getShipeasyServerClient,
   i18n,
+  isExpected,
   see,
+  seeContext,
   shipeasy,
   version
 };

package/package.json

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