@shipeasy/sdk 5.4.0 → 6.2.0

package/dist/openfeature-server/index.d.ts

@@ -78,7 +78,7 @@ interface StickyEntry {
 /**
  * Pluggable sticky-bucketing store for the server (doc 20 §2). Keyed by the
  * bucketing unit; the value is that unit's per-experiment assignments. Absent
- * from {@link FlagsClientOptions} ⇒ today's deterministic behaviour. Use
+ * from {@link EngineOptions} ⇒ today's deterministic behaviour. Use
  * {@link createInMemoryStickyStore} or a cookie-bridge built from request
  * cookies.
  */
@@ -93,7 +93,7 @@ interface Killswitch {
     killed: 0 | 1 | boolean;
     switches?: Record<string, 0 | 1 | boolean>;
 }
-/** Body of `GET /sdk/flags` — the snapshot's `flags` field. See {@link FlagsClient.fromSnapshot}. */
+/** Body of `GET /sdk/flags` — the snapshot's `flags` field. See {@link Engine.fromSnapshot}. */
 interface FlagsBlob {
     version: string;
     plan: string;
@@ -103,7 +103,7 @@ interface FlagsBlob {
     }>;
     killswitches: Record<string, Killswitch>;
 }
-/** Body of `GET /sdk/experiments` — the snapshot's `experiments` field. See {@link FlagsClient.fromSnapshot}. */
+/** Body of `GET /sdk/experiments` — the snapshot's `experiments` field. See {@link Engine.fromSnapshot}. */
 interface ExpsBlob {
     version: string;
     universes: Record<string, Universe>;
@@ -115,12 +115,12 @@ interface BootstrapPayload {
     experiments: Record<string, ExperimentResult<Record<string, unknown>>>;
     killswitches: Record<string, boolean | Record<string, boolean>>;
 }
-type FlagsClientEnv = "dev" | "staging" | "prod";
-interface FlagsClientOptions {
+type EngineEnv = "dev" | "staging" | "prod";
+interface EngineOptions {
     apiKey: string;
     baseUrl?: string;
     /** Which published env to read values from. Defaults to "prod". */
-    env?: FlagsClientEnv;
+    env?: EngineEnv;
     /**
      * Preload the flags blob synchronously without a network fetch. Primarily
      * for tests; production callers should rely on init()/initOnce().
@@ -155,12 +155,12 @@ interface FlagsClientOptions {
     /**
      * Test mode — no network at all. init()/initOnce() are no-ops (never fetch),
      * track() is a no-op, telemetry is forced off, and the client starts
-     * "initialized" with an empty blob. Prefer the {@link FlagsClient.forTesting}
+     * "initialized" with an empty blob. Prefer the {@link Engine.forTesting}
      * factory over passing this directly.
      */
     testMode?: boolean;
 }
-declare class FlagsClient {
+declare class Engine {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly env;
@@ -180,7 +180,7 @@ declare class FlagsClient {
     private readonly configOverrides;
     private readonly experimentOverrides;
     private readonly changeListeners;
-    constructor(opts: FlagsClientOptions);
+    constructor(opts: EngineOptions);
     /**
      * Build a no-network, immediately-usable client for tests (Statsig-style).
      * init()/initOnce() are no-ops (never fetch), track() is a no-op, telemetry
@@ -188,12 +188,12 @@ declare class FlagsClient {
      * with overrideFlag/overrideConfig/overrideExperiment. No SDK key required.
      *
      * ```ts
-     * const client = FlagsClient.forTesting();
+     * const client = Engine.forTesting();
      * client.overrideFlag("new_checkout", true);
      * client.getFlag("new_checkout", { user_id: "u1" }); // true
      * ```
      */
-    static forTesting(opts?: Partial<FlagsClientOptions>): FlagsClient;
+    static forTesting(opts?: Partial<EngineOptions>): Engine;
     /**
      * Build a fully OFFLINE client from a pre-captured snapshot — no network ever.
      * Reuses the test-mode plumbing (init()/initOnce()/track() are no-ops,
@@ -207,14 +207,14 @@ declare class FlagsClient {
     static fromSnapshot(snapshot: {
         flags: FlagsBlob;
         experiments: ExpsBlob;
-    }): FlagsClient;
+    }): Engine;
     /**
      * Build a fully OFFLINE client from a snapshot JSON file on disk (Node only —
      * not available in the browser entrypoint). The file must contain
      * `{ "flags": <GET /sdk/flags body>, "experiments": <GET /sdk/experiments body> }`.
-     * See {@link FlagsClient.fromSnapshot}.
+     * See {@link Engine.fromSnapshot}.
      */
-    static fromFile(path: string): FlagsClient;
+    static fromFile(path: string): Engine;
     init(): Promise<void>;
     initOnce(): Promise<void>;
     /** Force `getFlag(name, …)` to return `value`, ignoring the fetched gate. */
@@ -298,32 +298,45 @@ declare class FlagsClient {
  *
  * ```ts
  * import { OpenFeature } from "@openfeature/server-sdk";
- * import { FlagsClient } from "@shipeasy/sdk/server";
+ * import { Engine } from "@shipeasy/sdk/server";
  * import { ShipeasyProvider } from "@shipeasy/sdk/openfeature-server";
  *
- * const client = new FlagsClient({ apiKey: process.env.SHIPEASY_SERVER_KEY! });
+ * const client = new Engine({ apiKey: process.env.SHIPEASY_SERVER_KEY! });
  * await OpenFeature.setProviderAndWait(new ShipeasyProvider(client));
  *
  * const ofClient = OpenFeature.getClient();
  * const on = await ofClient.getBooleanValue("new_checkout", false, { targetingKey: "u1" });
  * ```
  *
- * Pure adapter over `FlagsClient` — no change to evaluation. `@openfeature/server-sdk`
+ * Pure adapter over `Engine` — no change to evaluation. `@openfeature/server-sdk`
  * is an optional peer dependency; install it in the consuming app.
  */
 
 /**
- * Shipeasy OpenFeature provider (server paradigm). Wraps a `FlagsClient`;
+ * Shipeasy OpenFeature provider (server paradigm). Wraps an `Engine`;
  * evaluation is local against the cached blob, so resolution is effectively
  * synchronous (the methods are `async` only to satisfy the server contract).
  */
 declare class ShipeasyProvider implements Provider {
-    private readonly client;
     readonly metadata: {
         readonly name: "shipeasy";
     };
     readonly runsOn: "server";
-    constructor(client: FlagsClient);
+    private readonly client;
+    /**
+     * Construct the provider. The **global form** (no argument) resolves the
+     * engine built by `configure({ apiKey })`, so the docs build it after
+     * configuration without ever naming the `Engine`:
+     *
+     * ```ts
+     * configure({ apiKey: process.env.SHIPEASY_SERVER_KEY! });
+     * await OpenFeature.setProviderAndWait(new ShipeasyProvider());
+     * ```
+     *
+     * Passing an explicit `Engine` stays supported for advanced/back-compat use.
+     * Throws if no engine is passed and `configure()` has not run.
+     */
+    constructor(client?: Engine);
     /** Fetch the rules blob once. The SDK fires `Ready` when this resolves. */
     initialize(): Promise<void>;
     onClose(): Promise<void>;

package/dist/openfeature-server/index.js

@@ -25,6 +25,177 @@ __export(openfeature_server_exports, {
 module.exports = __toCommonJS(openfeature_server_exports);
 var import_server_sdk = require("@openfeature/server-sdk");
 
+// src/server/index.ts
+var import_node_async_hooks = require("async_hooks");
+
+// src/see/core.ts
+var SEE_MAX_SUBJECT = 200;
+var SEE_MAX_EXTRA_VALUE = 200;
+var SEE_MAX_EXTRA_KEYS = 20;
+function causesThe(subject) {
+  return {
+    to(outcome) {
+      return {
+        __seConsequence: true,
+        subject: truncate(String(subject), SEE_MAX_SUBJECT),
+        outcome: truncate(String(outcome), SEE_MAX_SUBJECT)
+      };
+    }
+  };
+}
+function violation(name) {
+  return { __seViolation: true, violationName: String(name) };
+}
+var EXPECTED_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:see-expected");
+function readExpectedMark(err) {
+  if (typeof err !== "object" || err === null) return void 0;
+  const v = err[EXPECTED_SYM];
+  return v !== void 0 && v !== null && typeof v === "object" ? v : void 0;
+}
+function markExpected(err, because, extras) {
+  if (typeof err !== "object" || err === null) return;
+  const prev = readExpectedMark(err);
+  const clean = sanitizeExtras(extras);
+  const merged = prev?.extras || clean ? { ...prev?.extras, ...clean } : void 0;
+  const mark = {
+    because: String(because),
+    ...merged ? { extras: merged } : {}
+  };
+  try {
+    Object.defineProperty(err, EXPECTED_SYM, {
+      value: mark,
+      enumerable: false,
+      configurable: true
+    });
+  } catch {
+  }
+}
+function truncate(s, max) {
+  return s.length > max ? s.slice(0, max) : s;
+}
+function sanitizeExtras(extras) {
+  if (!extras || typeof extras !== "object") return void 0;
+  const out = {};
+  let n = 0;
+  for (const [k, v] of Object.entries(extras)) {
+    if (v === null || v === void 0) continue;
+    if (n >= SEE_MAX_EXTRA_KEYS) break;
+    if (typeof v === "string") out[k] = truncate(v, SEE_MAX_EXTRA_VALUE);
+    else if (typeof v === "number" && Number.isFinite(v)) out[k] = v;
+    else if (typeof v === "boolean") out[k] = v;
+    else continue;
+    n += 1;
+  }
+  return n > 0 ? out : void 0;
+}
+var scheduleMicrotask = typeof queueMicrotask === "function" ? queueMicrotask : (cb) => {
+  void Promise.resolve().then(cb);
+};
+function startSeeChain(getProblem, dispatch) {
+  let subject;
+  let outcome;
+  let collected;
+  let flushed = false;
+  scheduleMicrotask(() => {
+    if (flushed) return;
+    flushed = true;
+    dispatch(
+      getProblem(),
+      // Bare noun phrase — titles render as "… causes the {subject} …", so a
+      // leading article would double up ("causes the the app").
+      causesThe(subject ?? "app").to(outcome ?? "hit an error"),
+      collected
+    );
+  });
+  const tail = {
+    extras(x) {
+      if (x && typeof x === "object") collected = { ...collected, ...x };
+      return tail;
+    }
+  };
+  const step = {
+    to(o) {
+      outcome = String(o);
+      return tail;
+    }
+  };
+  const start = (s) => {
+    subject = String(s);
+    return step;
+  };
+  return { causes_the: start, causesThe: start };
+}
+function startSeeViolationChain(name, dispatch) {
+  return startSeeChain(() => violation(name), dispatch);
+}
+function startControlFlowChain(err) {
+  return {
+    because(reason) {
+      markExpected(err, reason);
+      const tail = {
+        extras(x) {
+          markExpected(err, reason, x);
+          return tail;
+        }
+      };
+      return tail;
+    }
+  };
+}
+
+// src/server/index.ts
+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 _I18N_CACHE_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n-cache");
+var _i18nCache = globalThis[_I18N_CACHE_SYM] ?? (globalThis[_I18N_CACHE_SYM] = /* @__PURE__ */ new Map());
+globalThis[_I18N_SSR_SYM] = () => {
+  const fromALS = _i18nALS.getStore();
+  if (fromALS && Object.keys(fromALS.strings).length > 0) return fromALS;
+  for (const v of _i18nCache.values()) {
+    if (Object.keys(v.strings).length > 0) return v;
+  }
+  return fromALS ?? null;
+};
+var _EDIT_MODE_ALS_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-als");
+var _editModeALS = globalThis[_EDIT_MODE_ALS_SYM] ?? (globalThis[_EDIT_MODE_ALS_SYM] = new import_node_async_hooks.AsyncLocalStorage());
+var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
+if (globalThis[_EDIT_MODE_FALLBACK_SYM] === void 0) {
+  globalThis[_EDIT_MODE_FALLBACK_SYM] = false;
+}
+Object.defineProperty(globalThis, _EDIT_MODE_SSR_SYM, {
+  get: () => _editModeALS.getStore() ?? globalThis[_EDIT_MODE_FALLBACK_SYM] ?? false,
+  set: (v) => {
+    const b = Boolean(v);
+    try {
+      _editModeALS.enterWith(b);
+    } catch {
+    }
+    globalThis[_EDIT_MODE_FALLBACK_SYM] = b;
+  },
+  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 _server = null;
+function getShipeasyServerClient() {
+  return _server;
+}
+function dispatchSee(problem, consequence, extras, kind) {
+  if (!_server) {
+    console.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
+    return;
+  }
+  _server.reportError(problem, consequence, extras, kind);
+}
+var see = Object.assign(
+  (problem) => startSeeChain(() => problem, dispatchSee),
+  {
+    Violation: (name) => startSeeViolationChain(name, dispatchSee),
+    ControlFlowException: (err) => startControlFlowChain(err)
+  }
+);
+
 // src/openfeature/shared.ts
 var REASON_MAP = {
   RULE_MATCH: { reason: "TARGETING_MATCH" },
@@ -78,12 +249,31 @@ function resolveConfig(raw, defaultValue, type) {
   return { value: r.value, reason: "TARGETING_MATCH" };
 }
 var ShipeasyProvider = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
   metadata = { name: "shipeasy" };
   runsOn = "server";
+  client;
+  /**
+   * Construct the provider. The **global form** (no argument) resolves the
+   * engine built by `configure({ apiKey })`, so the docs build it after
+   * configuration without ever naming the `Engine`:
+   *
+   * ```ts
+   * configure({ apiKey: process.env.SHIPEASY_SERVER_KEY! });
+   * await OpenFeature.setProviderAndWait(new ShipeasyProvider());
+   * ```
+   *
+   * Passing an explicit `Engine` stays supported for advanced/back-compat use.
+   * Throws if no engine is passed and `configure()` has not run.
+   */
+  constructor(client) {
+    const resolved = client ?? getShipeasyServerClient();
+    if (!resolved) {
+      throw new Error(
+        "[shipeasy] new ShipeasyProvider() resolves the configured global engine \u2014 call configure({ apiKey }) first, or pass an Engine explicitly."
+      );
+    }
+    this.client = resolved;
+  }
   /** Fetch the rules blob once. The SDK fires `Ready` when this resolves. */
   async initialize() {
     await this.client.initOnce();

package/dist/openfeature-server/index.mjs

@@ -1,6 +1,177 @@
 // src/openfeature-server/index.ts
 import { ErrorCode } from "@openfeature/server-sdk";
 
+// src/server/index.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/see/core.ts
+var SEE_MAX_SUBJECT = 200;
+var SEE_MAX_EXTRA_VALUE = 200;
+var SEE_MAX_EXTRA_KEYS = 20;
+function causesThe(subject) {
+  return {
+    to(outcome) {
+      return {
+        __seConsequence: true,
+        subject: truncate(String(subject), SEE_MAX_SUBJECT),
+        outcome: truncate(String(outcome), SEE_MAX_SUBJECT)
+      };
+    }
+  };
+}
+function violation(name) {
+  return { __seViolation: true, violationName: String(name) };
+}
+var EXPECTED_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:see-expected");
+function readExpectedMark(err) {
+  if (typeof err !== "object" || err === null) return void 0;
+  const v = err[EXPECTED_SYM];
+  return v !== void 0 && v !== null && typeof v === "object" ? v : void 0;
+}
+function markExpected(err, because, extras) {
+  if (typeof err !== "object" || err === null) return;
+  const prev = readExpectedMark(err);
+  const clean = sanitizeExtras(extras);
+  const merged = prev?.extras || clean ? { ...prev?.extras, ...clean } : void 0;
+  const mark = {
+    because: String(because),
+    ...merged ? { extras: merged } : {}
+  };
+  try {
+    Object.defineProperty(err, EXPECTED_SYM, {
+      value: mark,
+      enumerable: false,
+      configurable: true
+    });
+  } catch {
+  }
+}
+function truncate(s, max) {
+  return s.length > max ? s.slice(0, max) : s;
+}
+function sanitizeExtras(extras) {
+  if (!extras || typeof extras !== "object") return void 0;
+  const out = {};
+  let n = 0;
+  for (const [k, v] of Object.entries(extras)) {
+    if (v === null || v === void 0) continue;
+    if (n >= SEE_MAX_EXTRA_KEYS) break;
+    if (typeof v === "string") out[k] = truncate(v, SEE_MAX_EXTRA_VALUE);
+    else if (typeof v === "number" && Number.isFinite(v)) out[k] = v;
+    else if (typeof v === "boolean") out[k] = v;
+    else continue;
+    n += 1;
+  }
+  return n > 0 ? out : void 0;
+}
+var scheduleMicrotask = typeof queueMicrotask === "function" ? queueMicrotask : (cb) => {
+  void Promise.resolve().then(cb);
+};
+function startSeeChain(getProblem, dispatch) {
+  let subject;
+  let outcome;
+  let collected;
+  let flushed = false;
+  scheduleMicrotask(() => {
+    if (flushed) return;
+    flushed = true;
+    dispatch(
+      getProblem(),
+      // Bare noun phrase — titles render as "… causes the {subject} …", so a
+      // leading article would double up ("causes the the app").
+      causesThe(subject ?? "app").to(outcome ?? "hit an error"),
+      collected
+    );
+  });
+  const tail = {
+    extras(x) {
+      if (x && typeof x === "object") collected = { ...collected, ...x };
+      return tail;
+    }
+  };
+  const step = {
+    to(o) {
+      outcome = String(o);
+      return tail;
+    }
+  };
+  const start = (s) => {
+    subject = String(s);
+    return step;
+  };
+  return { causes_the: start, causesThe: start };
+}
+function startSeeViolationChain(name, dispatch) {
+  return startSeeChain(() => violation(name), dispatch);
+}
+function startControlFlowChain(err) {
+  return {
+    because(reason) {
+      markExpected(err, reason);
+      const tail = {
+        extras(x) {
+          markExpected(err, reason, x);
+          return tail;
+        }
+      };
+      return tail;
+    }
+  };
+}
+
+// src/server/index.ts
+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 _I18N_CACHE_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-i18n-cache");
+var _i18nCache = globalThis[_I18N_CACHE_SYM] ?? (globalThis[_I18N_CACHE_SYM] = /* @__PURE__ */ new Map());
+globalThis[_I18N_SSR_SYM] = () => {
+  const fromALS = _i18nALS.getStore();
+  if (fromALS && Object.keys(fromALS.strings).length > 0) return fromALS;
+  for (const v of _i18nCache.values()) {
+    if (Object.keys(v.strings).length > 0) return v;
+  }
+  return fromALS ?? null;
+};
+var _EDIT_MODE_ALS_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-als");
+var _editModeALS = globalThis[_EDIT_MODE_ALS_SYM] ?? (globalThis[_EDIT_MODE_ALS_SYM] = new AsyncLocalStorage());
+var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
+if (globalThis[_EDIT_MODE_FALLBACK_SYM] === void 0) {
+  globalThis[_EDIT_MODE_FALLBACK_SYM] = false;
+}
+Object.defineProperty(globalThis, _EDIT_MODE_SSR_SYM, {
+  get: () => _editModeALS.getStore() ?? globalThis[_EDIT_MODE_FALLBACK_SYM] ?? false,
+  set: (v) => {
+    const b = Boolean(v);
+    try {
+      _editModeALS.enterWith(b);
+    } catch {
+    }
+    globalThis[_EDIT_MODE_FALLBACK_SYM] = b;
+  },
+  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 _server = null;
+function getShipeasyServerClient() {
+  return _server;
+}
+function dispatchSee(problem, consequence, extras, kind) {
+  if (!_server) {
+    console.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
+    return;
+  }
+  _server.reportError(problem, consequence, extras, kind);
+}
+var see = Object.assign(
+  (problem) => startSeeChain(() => problem, dispatchSee),
+  {
+    Violation: (name) => startSeeViolationChain(name, dispatchSee),
+    ControlFlowException: (err) => startControlFlowChain(err)
+  }
+);
+
 // src/openfeature/shared.ts
 var REASON_MAP = {
   RULE_MATCH: { reason: "TARGETING_MATCH" },
@@ -54,12 +225,31 @@ function resolveConfig(raw, defaultValue, type) {
   return { value: r.value, reason: "TARGETING_MATCH" };
 }
 var ShipeasyProvider = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
   metadata = { name: "shipeasy" };
   runsOn = "server";
+  client;
+  /**
+   * Construct the provider. The **global form** (no argument) resolves the
+   * engine built by `configure({ apiKey })`, so the docs build it after
+   * configuration without ever naming the `Engine`:
+   *
+   * ```ts
+   * configure({ apiKey: process.env.SHIPEASY_SERVER_KEY! });
+   * await OpenFeature.setProviderAndWait(new ShipeasyProvider());
+   * ```
+   *
+   * Passing an explicit `Engine` stays supported for advanced/back-compat use.
+   * Throws if no engine is passed and `configure()` has not run.
+   */
+  constructor(client) {
+    const resolved = client ?? getShipeasyServerClient();
+    if (!resolved) {
+      throw new Error(
+        "[shipeasy] new ShipeasyProvider() resolves the configured global engine \u2014 call configure({ apiKey }) first, or pass an Engine explicitly."
+      );
+    }
+    this.client = resolved;
+  }
   /** Fetch the rules blob once. The SDK fires `Ready` when this resolves. */
   async initialize() {
     await this.client.initOnce();

package/dist/openfeature-web/index.d.mts

@@ -101,8 +101,8 @@ interface AutoCollectGroups {
     errors: boolean;
     engagement: boolean;
 }
-type FlagsClientBrowserEnv = "dev" | "staging" | "prod";
-interface FlagsClientBrowserOptions {
+type EngineEnv = "dev" | "staging" | "prod";
+interface EngineOptions {
     sdkKey: string;
     baseUrl?: string;
     autoGuardrails?: boolean;
@@ -121,7 +121,7 @@ interface FlagsClientBrowserOptions {
      */
     autoCollectAlways?: boolean;
     /** Which published env to read values from. Defaults to "prod". */
-    env?: FlagsClientBrowserEnv;
+    env?: EngineEnv;
     /**
      * Per-evaluation usage telemetry. ON by default — each getFlag/getConfig/
      * getExperiment/getKillswitch call fires one fire-and-forget sendBeacon so
@@ -158,11 +158,11 @@ interface FlagsClientBrowserOptions {
      * Test mode — no network at all. identify()/init are no-ops (never call
      * /sdk/evaluate), track() is a no-op, telemetry is forced off, and the client
      * starts "ready" with an empty eval result. Prefer the
-     * {@link FlagsClientBrowser.forTesting} factory over passing this directly.
+     * {@link Engine.forTesting} factory over passing this directly.
      */
     testMode?: boolean;
 }
-declare class FlagsClientBrowser {
+declare class Engine {
     private readonly sdkKey;
     private readonly baseUrl;
     private readonly autoGuardrails;
@@ -187,7 +187,7 @@ declare class FlagsClientBrowser {
     private readonly configOverrides;
     private readonly experimentOverrides;
     private onOverrideChange;
-    constructor(opts: FlagsClientBrowserOptions);
+    constructor(opts: EngineOptions);
     /**
      * Build a no-network, immediately-usable browser client for tests
      * (Statsig-style). identify() is a no-op (never calls /sdk/evaluate), track()
@@ -196,12 +196,12 @@ declare class FlagsClientBrowser {
      * key required.
      *
      * ```ts
-     * const client = FlagsClientBrowser.forTesting();
+     * const client = Engine.forTesting();
      * client.overrideFlag("new_checkout", true);
      * client.getFlag("new_checkout"); // true
      * ```
      */
-    static forTesting(opts?: Partial<FlagsClientBrowserOptions>): FlagsClientBrowser;
+    static forTesting(opts?: Partial<EngineOptions>): Engine;
     identify(user: User): Promise<void>;
     /**
      * Report a structured error into the errors primitive. Flushes immediately
@@ -289,10 +289,10 @@ interface ShipeasySdkBridge {
  *
  * ```ts
  * import { OpenFeature } from "@openfeature/web-sdk";
- * import { FlagsClientBrowser } from "@shipeasy/sdk/client";
+ * import { Engine } from "@shipeasy/sdk/client";
  * import { ShipeasyProvider } from "@shipeasy/sdk/openfeature-web";
  *
- * const client = new FlagsClientBrowser({ sdkKey: NEXT_PUBLIC_SHIPEASY_CLIENT_KEY });
+ * const client = new Engine({ sdkKey: NEXT_PUBLIC_SHIPEASY_CLIENT_KEY });
  * await OpenFeature.setContext({ targetingKey: "u1", plan: "pro" });
  * await OpenFeature.setProviderAndWait(new ShipeasyProvider(client));
  *
@@ -307,7 +307,7 @@ interface ShipeasySdkBridge {
 
 /**
  * Shipeasy OpenFeature provider (client/web paradigm). Wraps a
- * `FlagsClientBrowser`. Context changes are reconciled through `identify()`;
+ * `Engine`. Context changes are reconciled through `identify()`;
  * flag reads come from the cached eval result.
  */
 declare class ShipeasyProvider implements Provider {
@@ -316,7 +316,7 @@ declare class ShipeasyProvider implements Provider {
         readonly name: "shipeasy";
     };
     readonly runsOn: "client";
-    constructor(client: FlagsClientBrowser);
+    constructor(client: Engine);
     /** Identify with the initial static context so the first read is warm. */
     initialize(context?: EvaluationContext): Promise<void>;
     /** Re-identify when the application author changes the static context. */