@shipeasy/sdk 5.3.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,
@@ -768,7 +771,7 @@ function writeStickyCookie(map) {
 function getOrCreateAnonId() {
   let id = readAnonCookie();
   if (!id && typeof window !== "undefined") {
-    id = window.__SE_BOOTSTRAP?.anonId ?? null;
+    id = getBootstrap()?.anonId ?? null;
   }
   if (!id) {
     try {
@@ -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() {
@@ -1430,6 +1433,13 @@ var _i18nLoaderInjected = false;
 function injectI18nLoader(clientKey, baseUrl, profileOpt) {
   if (_i18nLoaderInjected || typeof document === "undefined") return;
   if (!clientKey || typeof document.createElement !== "function" || !document.head) return;
+  try {
+    if (document.querySelector?.('script[src*="/sdk/i18n/loader.js"][data-key]')) {
+      _i18nLoaderInjected = true;
+      return;
+    }
+  } catch {
+  }
   _i18nLoaderInjected = true;
   try {
     const bs = getBootstrap();
@@ -1442,9 +1452,36 @@ function injectI18nLoader(clientKey, baseUrl, profileOpt) {
   } catch {
   }
 }
+var _bootstrapFromTag = null;
+function readBootstrapTag() {
+  if (_bootstrapFromTag) return _bootstrapFromTag;
+  if (typeof document === "undefined" || typeof document.querySelector !== "function") return null;
+  const el = document.querySelector("script[data-se-bootstrap]");
+  if (!el) return null;
+  const J = (name) => {
+    try {
+      return JSON.parse(el.getAttribute(name) || "{}");
+    } catch {
+      return {};
+    }
+  };
+  const bs = {
+    flags: J("data-flags"),
+    configs: J("data-configs"),
+    experiments: J("data-experiments"),
+    killswitches: J("data-killswitches"),
+    i18nProfile: el.getAttribute("data-i18n-profile") || void 0,
+    apiUrl: el.getAttribute("data-api-url") || void 0,
+    anonId: el.getAttribute("data-anon-id") || void 0
+  };
+  _bootstrapFromTag = bs;
+  return bs;
+}
 function getBootstrap() {
   if (typeof window === "undefined") return null;
-  return window.__SE_BOOTSTRAP ?? null;
+  const g = window.__SE_BOOTSTRAP;
+  if (g) return g;
+  return readBootstrapTag();
 }
 var _mountedAndReady = false;
 var _standaloneListeners = /* @__PURE__ */ new Set();
@@ -1520,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);
   },
@@ -1577,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");
@@ -1623,7 +1709,7 @@ function getSSRI18nStore() {
 var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
 function isEditLabelsMode() {
   if (typeof window !== "undefined") {
-    return !!window.__SE_BOOTSTRAP?.editLabels || new URLSearchParams(location.search).has("se_edit_labels");
+    return new URLSearchParams(location.search).has("se_edit_labels") || /(?:^|;\s*)se_edit_labels=1(?:;|$)/.test(document.cookie);
   }
   const val = globalThis[_EDIT_MODE_SSR_SYM];
   if (typeof val === "boolean") return val;
@@ -1825,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

@@ -719,7 +719,7 @@ function writeStickyCookie(map) {
 function getOrCreateAnonId() {
   let id = readAnonCookie();
   if (!id && typeof window !== "undefined") {
-    id = window.__SE_BOOTSTRAP?.anonId ?? null;
+    id = getBootstrap()?.anonId ?? null;
   }
   if (!id) {
     try {
@@ -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() {
@@ -1381,6 +1381,13 @@ var _i18nLoaderInjected = false;
 function injectI18nLoader(clientKey, baseUrl, profileOpt) {
   if (_i18nLoaderInjected || typeof document === "undefined") return;
   if (!clientKey || typeof document.createElement !== "function" || !document.head) return;
+  try {
+    if (document.querySelector?.('script[src*="/sdk/i18n/loader.js"][data-key]')) {
+      _i18nLoaderInjected = true;
+      return;
+    }
+  } catch {
+  }
   _i18nLoaderInjected = true;
   try {
     const bs = getBootstrap();
@@ -1393,9 +1400,36 @@ function injectI18nLoader(clientKey, baseUrl, profileOpt) {
   } catch {
   }
 }
+var _bootstrapFromTag = null;
+function readBootstrapTag() {
+  if (_bootstrapFromTag) return _bootstrapFromTag;
+  if (typeof document === "undefined" || typeof document.querySelector !== "function") return null;
+  const el = document.querySelector("script[data-se-bootstrap]");
+  if (!el) return null;
+  const J = (name) => {
+    try {
+      return JSON.parse(el.getAttribute(name) || "{}");
+    } catch {
+      return {};
+    }
+  };
+  const bs = {
+    flags: J("data-flags"),
+    configs: J("data-configs"),
+    experiments: J("data-experiments"),
+    killswitches: J("data-killswitches"),
+    i18nProfile: el.getAttribute("data-i18n-profile") || void 0,
+    apiUrl: el.getAttribute("data-api-url") || void 0,
+    anonId: el.getAttribute("data-anon-id") || void 0
+  };
+  _bootstrapFromTag = bs;
+  return bs;
+}
 function getBootstrap() {
   if (typeof window === "undefined") return null;
-  return window.__SE_BOOTSTRAP ?? null;
+  const g = window.__SE_BOOTSTRAP;
+  if (g) return g;
+  return readBootstrapTag();
 }
 var _mountedAndReady = false;
 var _standaloneListeners = /* @__PURE__ */ new Set();
@@ -1471,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);
   },
@@ -1528,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");
@@ -1574,7 +1657,7 @@ function getSSRI18nStore() {
 var _EDIT_MODE_FALLBACK_SYM = /* @__PURE__ */ Symbol.for("@shipeasy/sdk:ssr-edit-mode-fallback");
 function isEditLabelsMode() {
   if (typeof window !== "undefined") {
-    return !!window.__SE_BOOTSTRAP?.editLabels || new URLSearchParams(location.search).has("se_edit_labels");
+    return new URLSearchParams(location.search).has("se_edit_labels") || /(?:^|;\s*)se_edit_labels=1(?:;|$)/.test(document.cookie);
   }
   const val = globalThis[_EDIT_MODE_SSR_SYM];
   if (typeof val === "boolean") return val;
@@ -1775,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>;