@shipeasy/sdk 5.4.0 → 6.0.0

package/dist/client/index.js

@@ -20,14 +20,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/client/index.ts
 var client_exports = {};
 __export(client_exports, {
+  Client: () => Client,
+  Engine: () => Engine,
   FLAG_REASONS: () => FLAG_REASONS,
-  FlagsClientBrowser: () => FlagsClientBrowser,
   LABEL_MARKER_END: () => LABEL_MARKER_END,
   LABEL_MARKER_RE: () => LABEL_MARKER_RE,
   LABEL_MARKER_SEP: () => LABEL_MARKER_SEP,
   LABEL_MARKER_START: () => LABEL_MARKER_START,
+  _resetConfigureForTests: () => _resetConfigureForTests,
   _resetShipeasyForTests: () => _resetShipeasyForTests,
   attachDevtools: () => attachDevtools,
+  configure: () => configure,
   configureShipeasy: () => configureShipeasy,
   encodeLabelMarker: () => encodeLabelMarker,
   flags: () => flags,
@@ -912,7 +915,7 @@ function readExperimentOverridesFromUrl() {
   }
   return out;
 }
-var FlagsClientBrowser = class _FlagsClientBrowser {
+var Engine = class _Engine {
   sdkKey;
   baseUrl;
   autoGuardrails;
@@ -934,7 +937,7 @@ var FlagsClientBrowser = class _FlagsClientBrowser {
   // 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;
-  // Test mode: built by `FlagsClientBrowser.forTesting()`. When set, identify()
+  // Test mode: built by `Engine.forTesting()`. When set, identify()
   // never fetches, track() is a no-op, telemetry is off, and the client is
   // already ready with an empty eval result.
   testMode;
@@ -988,13 +991,13 @@ var FlagsClientBrowser = 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) {
-    return new _FlagsClientBrowser({
+    return new _Engine({
       sdkKey: "",
       autoGuardrails: false,
       ...opts,
@@ -1415,7 +1418,7 @@ function shipeasy(opts) {
 }
 function configureShipeasy(opts) {
   if (_client) return _client;
-  _client = new FlagsClientBrowser(opts);
+  _client = new Engine(opts);
   return _client;
 }
 function getShipeasyClient() {
@@ -1554,7 +1557,7 @@ var flags = {
     return typeof decodeOrOpts === "function" ? _client.getExperiment(name, defaultParams, decodeOrOpts, variants) : _client.getExperiment(name, defaultParams, decodeOrOpts ?? {});
   },
   /** Manually log an exposure for an enrolled experiment. See
-   *  {@link FlagsClientBrowser.logExposure}. No-op before configure(). */
+   *  {@link Engine.logExposure}. No-op before configure(). */
   logExposure(name) {
     _client?.logExposure(name);
   },
@@ -1611,6 +1614,55 @@ var flags = {
     return _client?.ready ?? false;
   }
 };
+var _identityAttributes = (user) => user && typeof user === "object" ? user : {};
+var _attributes = _identityAttributes;
+function configure(opts) {
+  const { attributes, ...clientConfig } = opts;
+  _attributes = attributes ?? _identityAttributes;
+  return shipeasy({ autoIdentify: false, ...clientConfig });
+}
+function _resetConfigureForTests() {
+  _attributes = _identityAttributes;
+}
+var Client = class {
+  engine;
+  /** The resolved attribute bag this handle evaluates against. */
+  attributes;
+  _identify;
+  constructor(user) {
+    const engine = getShipeasyClient();
+    if (!engine) {
+      throw new Error(
+        "[shipeasy] new Client(user) called before configure({ clientKey }). Call configure() once at app boot from @shipeasy/sdk/client."
+      );
+    }
+    this.engine = engine;
+    this.attributes = _attributes(user);
+    this._identify = this.engine.identify(this.attributes).catch((err) => {
+      console.warn("[shipeasy] Client identify failed:", String(err));
+    });
+  }
+  /** Resolves once the engine's identify() for this user has completed. */
+  ready() {
+    return this._identify;
+  }
+  getFlag(name, defaultValue = false) {
+    return this.engine.getFlag(name, defaultValue);
+  }
+  getFlagDetail(name) {
+    return this.engine.getFlagDetail(name);
+  }
+  getConfig(name, decodeOrOpts) {
+    return this.engine.getConfig(name, decodeOrOpts);
+  }
+  getExperiment(name, defaultParams, decode) {
+    return this.engine.getExperiment(name, defaultParams, decode);
+  }
+  /** Read a killswitch (not user-bound; mirrors {@link Engine.getKillswitch}). */
+  getKillswitch(name, switchKey) {
+    return this.engine.getKillswitch(name, switchKey);
+  }
+};
 function dispatchSee(problem, consequence, extras, kind) {
   if (!_client) {
     console.warn("[shipeasy] see() called before shipeasy({ clientKey }) \u2014 error dropped");
@@ -1859,14 +1911,17 @@ var i18n = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Client,
+  Engine,
   FLAG_REASONS,
-  FlagsClientBrowser,
   LABEL_MARKER_END,
   LABEL_MARKER_RE,
   LABEL_MARKER_SEP,
   LABEL_MARKER_START,
+  _resetConfigureForTests,
   _resetShipeasyForTests,
   attachDevtools,
+  configure,
   configureShipeasy,
   encodeLabelMarker,
   flags,

package/dist/client/index.mjs

@@ -863,7 +863,7 @@ function readExperimentOverridesFromUrl() {
   }
   return out;
 }
-var FlagsClientBrowser = class _FlagsClientBrowser {
+var Engine = class _Engine {
   sdkKey;
   baseUrl;
   autoGuardrails;
@@ -885,7 +885,7 @@ var FlagsClientBrowser = class _FlagsClientBrowser {
   // 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;
-  // Test mode: built by `FlagsClientBrowser.forTesting()`. When set, identify()
+  // Test mode: built by `Engine.forTesting()`. When set, identify()
   // never fetches, track() is a no-op, telemetry is off, and the client is
   // already ready with an empty eval result.
   testMode;
@@ -939,13 +939,13 @@ var FlagsClientBrowser = 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) {
-    return new _FlagsClientBrowser({
+    return new _Engine({
       sdkKey: "",
       autoGuardrails: false,
       ...opts,
@@ -1366,7 +1366,7 @@ function shipeasy(opts) {
 }
 function configureShipeasy(opts) {
   if (_client) return _client;
-  _client = new FlagsClientBrowser(opts);
+  _client = new Engine(opts);
   return _client;
 }
 function getShipeasyClient() {
@@ -1505,7 +1505,7 @@ var flags = {
     return typeof decodeOrOpts === "function" ? _client.getExperiment(name, defaultParams, decodeOrOpts, variants) : _client.getExperiment(name, defaultParams, decodeOrOpts ?? {});
   },
   /** Manually log an exposure for an enrolled experiment. See
-   *  {@link FlagsClientBrowser.logExposure}. No-op before configure(). */
+   *  {@link Engine.logExposure}. No-op before configure(). */
   logExposure(name) {
     _client?.logExposure(name);
   },
@@ -1562,6 +1562,55 @@ var flags = {
     return _client?.ready ?? false;
   }
 };
+var _identityAttributes = (user) => user && typeof user === "object" ? user : {};
+var _attributes = _identityAttributes;
+function configure(opts) {
+  const { attributes, ...clientConfig } = opts;
+  _attributes = attributes ?? _identityAttributes;
+  return shipeasy({ autoIdentify: false, ...clientConfig });
+}
+function _resetConfigureForTests() {
+  _attributes = _identityAttributes;
+}
+var Client = class {
+  engine;
+  /** The resolved attribute bag this handle evaluates against. */
+  attributes;
+  _identify;
+  constructor(user) {
+    const engine = getShipeasyClient();
+    if (!engine) {
+      throw new Error(
+        "[shipeasy] new Client(user) called before configure({ clientKey }). Call configure() once at app boot from @shipeasy/sdk/client."
+      );
+    }
+    this.engine = engine;
+    this.attributes = _attributes(user);
+    this._identify = this.engine.identify(this.attributes).catch((err) => {
+      console.warn("[shipeasy] Client identify failed:", String(err));
+    });
+  }
+  /** Resolves once the engine's identify() for this user has completed. */
+  ready() {
+    return this._identify;
+  }
+  getFlag(name, defaultValue = false) {
+    return this.engine.getFlag(name, defaultValue);
+  }
+  getFlagDetail(name) {
+    return this.engine.getFlagDetail(name);
+  }
+  getConfig(name, decodeOrOpts) {
+    return this.engine.getConfig(name, decodeOrOpts);
+  }
+  getExperiment(name, defaultParams, decode) {
+    return this.engine.getExperiment(name, defaultParams, decode);
+  }
+  /** Read a killswitch (not user-bound; mirrors {@link Engine.getKillswitch}). */
+  getKillswitch(name, switchKey) {
+    return this.engine.getKillswitch(name, switchKey);
+  }
+};
 function dispatchSee(problem, consequence, extras, kind) {
   if (!_client) {
     console.warn("[shipeasy] see() called before shipeasy({ clientKey }) \u2014 error dropped");
@@ -1809,14 +1858,17 @@ var i18n = {
   }
 };
 export {
+  Client,
+  Engine,
   FLAG_REASONS,
-  FlagsClientBrowser,
   LABEL_MARKER_END,
   LABEL_MARKER_RE,
   LABEL_MARKER_SEP,
   LABEL_MARKER_START,
+  _resetConfigureForTests,
   _resetShipeasyForTests,
   attachDevtools,
+  configure,
   configureShipeasy,
   encodeLabelMarker,
   flags,

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

@@ -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,22 +298,22 @@ 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).
  */
@@ -323,7 +323,7 @@ declare class ShipeasyProvider implements Provider {
         readonly name: "shipeasy";
     };
     readonly runsOn: "server";
-    constructor(client: FlagsClient);
+    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.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,22 +298,22 @@ 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).
  */
@@ -323,7 +323,7 @@ declare class ShipeasyProvider implements Provider {
         readonly name: "shipeasy";
     };
     readonly runsOn: "server";
-    constructor(client: FlagsClient);
+    constructor(client: Engine);
     /** Fetch the rules blob once. The SDK fires `Ready` when this resolves. */
     initialize(): Promise<void>;
     onClose(): Promise<void>;

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. */