@shipeasy/sdk 5.4.0 → 6.0.0

package/dist/server/index.mjs

@@ -499,7 +499,7 @@ function parseOverrides(rawUrl) {
   }
   return { gates, configs, experiments };
 }
-var FlagsClient = class _FlagsClient {
+var Engine = class _Engine {
   apiKey;
   baseUrl;
   env;
@@ -514,7 +514,7 @@ var FlagsClient = class _FlagsClient {
   pollInterval = 30;
   timer = null;
   initialized = false;
-  // Test mode: built by `FlagsClient.forTesting()`. When set, init()/initOnce()
+  // Test mode: built by `Engine.forTesting()`. When set, init()/initOnce()
   // never fetch, track() is a no-op, and telemetry is off — the client is a
   // fully self-contained, network-free seam for unit tests.
   testMode;
@@ -555,13 +555,13 @@ var FlagsClient = 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) {
-    return new _FlagsClient({ apiKey: "", ...opts, testMode: true });
+    return new _Engine({ apiKey: "", ...opts, testMode: true });
   }
   /**
    * Build a fully OFFLINE client from a pre-captured snapshot — no network ever.
@@ -574,7 +574,7 @@ var FlagsClient = class _FlagsClient {
    * `{ flags: <GET /sdk/flags body>, experiments: <GET /sdk/experiments body> }`.
    */
   static fromSnapshot(snapshot) {
-    const client = new _FlagsClient({ apiKey: "", testMode: true });
+    const client = new _Engine({ apiKey: "", testMode: true });
     client.flagsBlob = snapshot.flags;
     client.expsBlob = snapshot.experiments;
     client.initialized = true;
@@ -584,13 +584,13 @@ var FlagsClient = class _FlagsClient {
    * 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) {
     const fs = __require("fs");
     const raw = fs.readFileSync(path, "utf8");
     const snapshot = JSON.parse(raw);
-    return _FlagsClient.fromSnapshot(snapshot);
+    return _Engine.fromSnapshot(snapshot);
   }
   async init() {
     if (this.testMode) {
@@ -1050,7 +1050,7 @@ async function fetchLabelsForSSR(opts) {
 var _server = null;
 function configureShipeasyServer(opts) {
   if (_server) return _server;
-  _server = new FlagsClient(opts);
+  _server = new Engine(opts);
   return _server;
 }
 function getShipeasyServerClient() {
@@ -1225,7 +1225,7 @@ var flags = {
     _server?.track(userId, eventName, props);
   },
   /** Emit an exposure for an enrolled experiment at the decision point. See
-   *  {@link FlagsClient.logExposure}. No-op before configure(). */
+   *  {@link Engine.logExposure}. No-op before configure(). */
   logExposure(user, name) {
     _server?.logExposure(user, name);
   },
@@ -1243,6 +1243,50 @@ var flags = {
     };
   }
 };
+var _identityAttributes = (user) => user && typeof user === "object" ? user : {};
+var _attributes = _identityAttributes;
+function configure(opts) {
+  const { attributes, ...engineOpts } = opts;
+  _attributes = attributes ?? _identityAttributes;
+  const engine = configureShipeasyServer(engineOpts);
+  void engine.initOnce().catch(() => {
+  });
+  return engine;
+}
+function _resetConfigureForTests() {
+  _attributes = _identityAttributes;
+}
+var Client = class {
+  engine;
+  /** The resolved attribute bag this handle evaluates against. */
+  attributes;
+  constructor(user) {
+    const engine = getShipeasyServerClient();
+    if (!engine) {
+      throw new Error(
+        "[shipeasy] new Client(user) called before configure({ apiKey }). Call configure() once at app boot from @shipeasy/sdk/server."
+      );
+    }
+    this.engine = engine;
+    this.attributes = _attributes(user);
+  }
+  getFlag(name, defaultValue = false) {
+    return this.engine.getFlag(name, this.attributes, defaultValue);
+  }
+  getFlagDetail(name) {
+    return this.engine.getFlagDetail(name, this.attributes);
+  }
+  getConfig(name, decodeOrOpts) {
+    return this.engine.getConfig(name, decodeOrOpts);
+  }
+  getExperiment(name, defaultParams, decode) {
+    return this.engine.getExperiment(name, this.attributes, 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 (!_server) {
     console.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
@@ -1259,10 +1303,13 @@ var see = Object.assign(
 );
 export {
   ANON_ID_COOKIE,
+  Client,
+  Engine,
   FLAG_REASONS,
-  FlagsClient,
   _murmur3ForTests,
+  _resetConfigureForTests,
   _resetShipeasyServerForTests,
+  configure,
   configureShipeasyServer,
   createInMemoryStickyStore,
   fetchLabelsForSSR,

package/package.json

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