@shipeasy/sdk 6.2.0 → 6.3.1

package/dist/server/index.js

@@ -34,6 +34,7 @@ __export(server_exports, {
   Client: () => Client,
   Engine: () => Engine,
   FLAG_REASONS: () => FLAG_REASONS,
+  LOG_LEVELS: () => LOG_LEVELS,
   _murmur3ForTests: () => _murmur3ForTests,
   _resetConfigureForTests: () => _resetConfigureForTests,
   _resetShipeasyServerForTests: () => _resetShipeasyServerForTests,
@@ -121,6 +122,53 @@ function send(url) {
   }
 }
 
+// src/logger.ts
+var LOG_LEVELS = ["silent", "error", "warn", "info", "debug"];
+var RANK = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+var currentLevel = "warn";
+function setLogLevel(level) {
+  if (typeof level === "string" && Object.prototype.hasOwnProperty.call(RANK, level)) {
+    currentLevel = level;
+  }
+}
+function write(method, args) {
+  try {
+    const c = globalThis.console;
+    if (!c) return;
+    const fn = c[method] ?? c.log;
+    if (typeof fn === "function") fn.call(c, ...args);
+  } catch {
+  }
+}
+var logger = {
+  error(...args) {
+    if (RANK[currentLevel] >= RANK.error) write("error", args);
+  },
+  warn(...args) {
+    if (RANK[currentLevel] >= RANK.warn) write("warn", args);
+  },
+  info(...args) {
+    if (RANK[currentLevel] >= RANK.info) write("info", args);
+  },
+  debug(...args) {
+    if (RANK[currentLevel] >= RANK.debug) write("debug", args);
+  }
+};
+function safeRun(label, fallback, fn) {
+  try {
+    return fn();
+  } catch (err) {
+    logger.error(`[shipeasy] ${label} failed \u2014 returning safe default:`, String(err));
+    return fallback;
+  }
+}
+
 // src/see/core.ts
 var SEE_MAX_MESSAGE = 500;
 var SEE_MAX_STACK = 8e3;
@@ -582,6 +630,7 @@ var Engine = class _Engine {
   // 304). Never fired in testMode/offline (no polling happens there).
   changeListeners = /* @__PURE__ */ new Set();
   constructor(opts) {
+    setLogLevel(opts.logLevel);
     this.apiKey = opts.apiKey;
     this.baseUrl = (opts.baseUrl ?? "https://cdn.shipeasy.ai").replace(/\/$/, "");
     this.env = opts.env ?? "prod";
@@ -705,14 +754,14 @@ var Engine = class _Engine {
       try {
         l();
       } catch (err) {
-        console.warn("[shipeasy] onChange listener threw:", String(err));
+        logger.warn("[shipeasy] onChange listener threw:", String(err));
       }
     }
   }
   startPoll() {
     this.timer = setInterval(() => {
       this.fetchAll(true).catch(
-        (err) => console.warn("[shipeasy] background poll failed:", String(err))
+        (err) => logger.warn("[shipeasy] background poll failed:", String(err))
       );
     }, this.pollInterval * 1e3);
   }
@@ -791,7 +840,12 @@ var Engine = class _Engine {
       return "defaultValue" in opts ? opts.defaultValue : void 0;
     }
     if (!opts.decode) return raw;
-    return opts.decode(raw);
+    try {
+      return opts.decode(raw);
+    } catch (err) {
+      logger.warn(`[shipeasy] getConfig('${name}') decode failed:`, String(err));
+      return "defaultValue" in opts ? opts.defaultValue : void 0;
+    }
   }
   getExperiment(name, user, defaultParams, decode) {
     this.telemetry.emit("experiment", name);
@@ -806,7 +860,7 @@ var Engine = class _Engine {
       try {
         return { inExperiment: true, group: ov.group, params: decode(ov.params) };
       } catch (err) {
-        console.warn(`[shipeasy] getExperiment('${name}') override decode failed:`, String(err));
+        logger.warn(`[shipeasy] getExperiment('${name}') override decode failed:`, String(err));
         return notIn;
       }
     }
@@ -831,7 +885,7 @@ var Engine = class _Engine {
       try {
         return { inExperiment: true, group: g.name, params: decode(g.params) };
       } catch (err) {
-        console.warn(`[shipeasy] getExperiment('${name}') decode failed:`, String(err));
+        logger.warn(`[shipeasy] getExperiment('${name}') decode failed:`, String(err));
         return notIn;
       }
     };
@@ -883,7 +937,7 @@ var Engine = class _Engine {
       method: "POST",
       headers: { "X-SDK-Key": this.apiKey, "Content-Type": "text/plain" },
       body
-    }).catch((err) => console.warn("[shipeasy] track failed:", String(err)));
+    }).catch((err) => logger.warn("[shipeasy] track failed:", String(err)));
   }
   /**
    * Emit an exposure event for an experiment at the server-side decision point
@@ -914,7 +968,7 @@ var Engine = class _Engine {
       method: "POST",
       headers: { "X-SDK-Key": this.apiKey, "Content-Type": "text/plain" },
       body
-    }).catch((err) => console.warn("[shipeasy] logExposure failed:", String(err)));
+    }).catch((err) => logger.warn("[shipeasy] logExposure failed:", String(err)));
   }
   /**
    * Report a structured error into the errors primitive. Fire-and-forget —
@@ -934,7 +988,7 @@ var Engine = class _Engine {
         method: "POST",
         headers: { "X-SDK-Key": this.apiKey, "Content-Type": "text/plain" },
         body: JSON.stringify({ events: [ev] })
-      }).catch((err) => console.warn("[shipeasy] see() send failed:", String(err)));
+      }).catch((err) => logger.warn("[shipeasy] see() send failed:", String(err)));
     } catch {
     }
   }
@@ -1121,7 +1175,7 @@ function _resetShipeasyServerForTests() {
 async function shipeasy(opts) {
   const serverKey = opts.serverKey ?? "";
   if (!serverKey) {
-    console.error(
+    logger.error(
       "[shipeasy] No server key \u2014 flags, experiments and SSR i18n skipped. Pass `serverKey` to shipeasy() from @shipeasy/sdk/server with your server key (SHIPEASY_SERVER_KEY). Set it as a Worker secret with `wrangler secret put SHIPEASY_SERVER_KEY` (or add it to .env for local dev). Do not pass a client key here \u2014 the server entrypoint only accepts the server key."
     );
   }
@@ -1129,7 +1183,8 @@ async function shipeasy(opts) {
   flags.configure({
     apiKey: serverKey,
     disableTelemetry: opts.disableTelemetry,
-    privateAttributes: opts.privateAttributes
+    privateAttributes: opts.privateAttributes,
+    logLevel: opts.logLevel
   });
   let resolvedUrlOverrides = opts.urlOverrides;
   if (!resolvedUrlOverrides) {
@@ -1255,21 +1310,30 @@ var flags = {
     _server?.destroy();
   },
   get(name, user, defaultValue = false) {
-    return _server?.getFlag(name, user, defaultValue) ?? defaultValue;
+    return safeRun("flags.get", defaultValue, () => _server?.getFlag(name, user, defaultValue) ?? defaultValue);
   },
   /** Evaluate a gate and report why (value + reason). See {@link FlagDetail}. */
   getDetail(name, user) {
-    return _server?.getFlagDetail(name, user) ?? { value: false, reason: "CLIENT_NOT_READY" };
+    return safeRun(
+      "flags.getDetail",
+      { value: false, reason: "CLIENT_NOT_READY" },
+      () => _server?.getFlagDetail(name, user) ?? { value: false, reason: "CLIENT_NOT_READY" }
+    );
   },
   getConfig(name, decodeOrOpts) {
-    return _server?.getConfig(name, decodeOrOpts);
+    return safeRun(
+      "flags.getConfig",
+      void 0,
+      () => _server?.getConfig(name, decodeOrOpts)
+    );
   },
   getExperiment(name, user, defaultParams, decode) {
-    return _server?.getExperiment(name, user, defaultParams, decode) ?? {
-      inExperiment: false,
-      group: "control",
-      params: defaultParams
-    };
+    const notIn = { inExperiment: false, group: "control", params: defaultParams };
+    return safeRun(
+      "flags.getExperiment",
+      notIn,
+      () => _server?.getExperiment(name, user, defaultParams, decode) ?? notIn
+    );
   },
   /**
    * Read a killswitch. Without `switchKey`, returns true when the whole
@@ -1277,15 +1341,15 @@ var flags = {
    * switch is on. Unknown killswitches / switches return false.
    */
   ks(name, switchKey) {
-    return _server?.getKillswitch(name, switchKey) ?? false;
+    return safeRun("flags.ks", false, () => _server?.getKillswitch(name, switchKey) ?? false);
   },
   track(userId, eventName, props) {
-    _server?.track(userId, eventName, props);
+    safeRun("flags.track", void 0, () => _server?.track(userId, eventName, props));
   },
   /** Emit an exposure for an enrolled experiment at the decision point. See
    *  {@link Engine.logExposure}. No-op before configure(). */
   logExposure(user, name) {
-    _server?.logExposure(user, name);
+    safeRun("flags.logExposure", void 0, () => _server?.logExposure(user, name));
   },
   /**
    * Evaluate all flags / configs / experiments for a user against the locally
@@ -1293,12 +1357,8 @@ var flags = {
    * overrides. Returns an empty payload when the blob hasn't been fetched yet.
    */
   evaluate(user, rawUrl) {
-    return _server?.evaluate(user, rawUrl) ?? {
-      flags: {},
-      configs: {},
-      experiments: {},
-      killswitches: {}
-    };
+    const empty = { flags: {}, configs: {}, experiments: {}, killswitches: {} };
+    return safeRun("flags.evaluate", empty, () => _server?.evaluate(user, rawUrl) ?? empty);
   }
 };
 var _identityAttributes = (user) => user && typeof user === "object" ? user : {};
@@ -1387,20 +1447,37 @@ var Client = class {
     this.attributes = _attributes(user);
   }
   getFlag(name, defaultValue = false) {
-    return this.engine.getFlag(name, this.attributes, defaultValue);
+    return safeRun(
+      "Client.getFlag",
+      defaultValue,
+      () => this.engine.getFlag(name, this.attributes, defaultValue)
+    );
   }
   getFlagDetail(name) {
-    return this.engine.getFlagDetail(name, this.attributes);
+    return safeRun(
+      "Client.getFlagDetail",
+      { value: false, reason: "CLIENT_NOT_READY" },
+      () => this.engine.getFlagDetail(name, this.attributes)
+    );
   }
   getConfig(name, decodeOrOpts) {
-    return this.engine.getConfig(name, decodeOrOpts);
+    return safeRun(
+      "Client.getConfig",
+      void 0,
+      () => this.engine.getConfig(name, decodeOrOpts)
+    );
   }
   getExperiment(name, defaultParams, decode) {
-    return this.engine.getExperiment(name, this.attributes, defaultParams, decode);
+    const notIn = { inExperiment: false, group: "control", params: defaultParams };
+    return safeRun(
+      "Client.getExperiment",
+      notIn,
+      () => 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);
+    return safeRun("Client.getKillswitch", false, () => this.engine.getKillswitch(name, switchKey));
   }
   /**
    * Record a conversion/metric event for the bound user. Derives the unit from
@@ -1410,9 +1487,11 @@ var Client = class {
    * mode.
    */
   track(eventName, props) {
-    const id = this.attributes.user_id ?? this.attributes.anonymous_id;
-    if (id === void 0) return;
-    this.engine.track(String(id), eventName, props);
+    safeRun("Client.track", void 0, () => {
+      const id = this.attributes.user_id ?? this.attributes.anonymous_id;
+      if (id === void 0) return;
+      this.engine.track(String(id), eventName, props);
+    });
   }
   /**
    * Emit an exposure event for `name` at this server-side decision point for the
@@ -1421,12 +1500,12 @@ var Client = class {
    * in test mode).
    */
   logExposure(name) {
-    this.engine.logExposure(this.attributes, name);
+    safeRun("Client.logExposure", void 0, () => this.engine.logExposure(this.attributes, name));
   }
 };
 function dispatchSee(problem, consequence, extras, kind) {
   if (!_server) {
-    console.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
+    logger.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
     return;
   }
   _server.reportError(problem, consequence, extras, kind);
@@ -1444,6 +1523,7 @@ var see = Object.assign(
   Client,
   Engine,
   FLAG_REASONS,
+  LOG_LEVELS,
   _murmur3ForTests,
   _resetConfigureForTests,
   _resetShipeasyServerForTests,

package/dist/server/index.mjs

@@ -67,6 +67,53 @@ function send(url) {
   }
 }
 
+// src/logger.ts
+var LOG_LEVELS = ["silent", "error", "warn", "info", "debug"];
+var RANK = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+var currentLevel = "warn";
+function setLogLevel(level) {
+  if (typeof level === "string" && Object.prototype.hasOwnProperty.call(RANK, level)) {
+    currentLevel = level;
+  }
+}
+function write(method, args) {
+  try {
+    const c = globalThis.console;
+    if (!c) return;
+    const fn = c[method] ?? c.log;
+    if (typeof fn === "function") fn.call(c, ...args);
+  } catch {
+  }
+}
+var logger = {
+  error(...args) {
+    if (RANK[currentLevel] >= RANK.error) write("error", args);
+  },
+  warn(...args) {
+    if (RANK[currentLevel] >= RANK.warn) write("warn", args);
+  },
+  info(...args) {
+    if (RANK[currentLevel] >= RANK.info) write("info", args);
+  },
+  debug(...args) {
+    if (RANK[currentLevel] >= RANK.debug) write("debug", args);
+  }
+};
+function safeRun(label, fallback, fn) {
+  try {
+    return fn();
+  } catch (err) {
+    logger.error(`[shipeasy] ${label} failed \u2014 returning safe default:`, String(err));
+    return fallback;
+  }
+}
+
 // src/see/core.ts
 var SEE_MAX_MESSAGE = 500;
 var SEE_MAX_STACK = 8e3;
@@ -528,6 +575,7 @@ var Engine = class _Engine {
   // 304). Never fired in testMode/offline (no polling happens there).
   changeListeners = /* @__PURE__ */ new Set();
   constructor(opts) {
+    setLogLevel(opts.logLevel);
     this.apiKey = opts.apiKey;
     this.baseUrl = (opts.baseUrl ?? "https://cdn.shipeasy.ai").replace(/\/$/, "");
     this.env = opts.env ?? "prod";
@@ -651,14 +699,14 @@ var Engine = class _Engine {
       try {
         l();
       } catch (err) {
-        console.warn("[shipeasy] onChange listener threw:", String(err));
+        logger.warn("[shipeasy] onChange listener threw:", String(err));
       }
     }
   }
   startPoll() {
     this.timer = setInterval(() => {
       this.fetchAll(true).catch(
-        (err) => console.warn("[shipeasy] background poll failed:", String(err))
+        (err) => logger.warn("[shipeasy] background poll failed:", String(err))
       );
     }, this.pollInterval * 1e3);
   }
@@ -737,7 +785,12 @@ var Engine = class _Engine {
       return "defaultValue" in opts ? opts.defaultValue : void 0;
     }
     if (!opts.decode) return raw;
-    return opts.decode(raw);
+    try {
+      return opts.decode(raw);
+    } catch (err) {
+      logger.warn(`[shipeasy] getConfig('${name}') decode failed:`, String(err));
+      return "defaultValue" in opts ? opts.defaultValue : void 0;
+    }
   }
   getExperiment(name, user, defaultParams, decode) {
     this.telemetry.emit("experiment", name);
@@ -752,7 +805,7 @@ var Engine = class _Engine {
       try {
         return { inExperiment: true, group: ov.group, params: decode(ov.params) };
       } catch (err) {
-        console.warn(`[shipeasy] getExperiment('${name}') override decode failed:`, String(err));
+        logger.warn(`[shipeasy] getExperiment('${name}') override decode failed:`, String(err));
         return notIn;
       }
     }
@@ -777,7 +830,7 @@ var Engine = class _Engine {
       try {
         return { inExperiment: true, group: g.name, params: decode(g.params) };
       } catch (err) {
-        console.warn(`[shipeasy] getExperiment('${name}') decode failed:`, String(err));
+        logger.warn(`[shipeasy] getExperiment('${name}') decode failed:`, String(err));
         return notIn;
       }
     };
@@ -829,7 +882,7 @@ var Engine = class _Engine {
       method: "POST",
       headers: { "X-SDK-Key": this.apiKey, "Content-Type": "text/plain" },
       body
-    }).catch((err) => console.warn("[shipeasy] track failed:", String(err)));
+    }).catch((err) => logger.warn("[shipeasy] track failed:", String(err)));
   }
   /**
    * Emit an exposure event for an experiment at the server-side decision point
@@ -860,7 +913,7 @@ var Engine = class _Engine {
       method: "POST",
       headers: { "X-SDK-Key": this.apiKey, "Content-Type": "text/plain" },
       body
-    }).catch((err) => console.warn("[shipeasy] logExposure failed:", String(err)));
+    }).catch((err) => logger.warn("[shipeasy] logExposure failed:", String(err)));
   }
   /**
    * Report a structured error into the errors primitive. Fire-and-forget —
@@ -880,7 +933,7 @@ var Engine = class _Engine {
         method: "POST",
         headers: { "X-SDK-Key": this.apiKey, "Content-Type": "text/plain" },
         body: JSON.stringify({ events: [ev] })
-      }).catch((err) => console.warn("[shipeasy] see() send failed:", String(err)));
+      }).catch((err) => logger.warn("[shipeasy] see() send failed:", String(err)));
     } catch {
     }
   }
@@ -1067,7 +1120,7 @@ function _resetShipeasyServerForTests() {
 async function shipeasy(opts) {
   const serverKey = opts.serverKey ?? "";
   if (!serverKey) {
-    console.error(
+    logger.error(
       "[shipeasy] No server key \u2014 flags, experiments and SSR i18n skipped. Pass `serverKey` to shipeasy() from @shipeasy/sdk/server with your server key (SHIPEASY_SERVER_KEY). Set it as a Worker secret with `wrangler secret put SHIPEASY_SERVER_KEY` (or add it to .env for local dev). Do not pass a client key here \u2014 the server entrypoint only accepts the server key."
     );
   }
@@ -1075,7 +1128,8 @@ async function shipeasy(opts) {
   flags.configure({
     apiKey: serverKey,
     disableTelemetry: opts.disableTelemetry,
-    privateAttributes: opts.privateAttributes
+    privateAttributes: opts.privateAttributes,
+    logLevel: opts.logLevel
   });
   let resolvedUrlOverrides = opts.urlOverrides;
   if (!resolvedUrlOverrides) {
@@ -1201,21 +1255,30 @@ var flags = {
     _server?.destroy();
   },
   get(name, user, defaultValue = false) {
-    return _server?.getFlag(name, user, defaultValue) ?? defaultValue;
+    return safeRun("flags.get", defaultValue, () => _server?.getFlag(name, user, defaultValue) ?? defaultValue);
   },
   /** Evaluate a gate and report why (value + reason). See {@link FlagDetail}. */
   getDetail(name, user) {
-    return _server?.getFlagDetail(name, user) ?? { value: false, reason: "CLIENT_NOT_READY" };
+    return safeRun(
+      "flags.getDetail",
+      { value: false, reason: "CLIENT_NOT_READY" },
+      () => _server?.getFlagDetail(name, user) ?? { value: false, reason: "CLIENT_NOT_READY" }
+    );
   },
   getConfig(name, decodeOrOpts) {
-    return _server?.getConfig(name, decodeOrOpts);
+    return safeRun(
+      "flags.getConfig",
+      void 0,
+      () => _server?.getConfig(name, decodeOrOpts)
+    );
   },
   getExperiment(name, user, defaultParams, decode) {
-    return _server?.getExperiment(name, user, defaultParams, decode) ?? {
-      inExperiment: false,
-      group: "control",
-      params: defaultParams
-    };
+    const notIn = { inExperiment: false, group: "control", params: defaultParams };
+    return safeRun(
+      "flags.getExperiment",
+      notIn,
+      () => _server?.getExperiment(name, user, defaultParams, decode) ?? notIn
+    );
   },
   /**
    * Read a killswitch. Without `switchKey`, returns true when the whole
@@ -1223,15 +1286,15 @@ var flags = {
    * switch is on. Unknown killswitches / switches return false.
    */
   ks(name, switchKey) {
-    return _server?.getKillswitch(name, switchKey) ?? false;
+    return safeRun("flags.ks", false, () => _server?.getKillswitch(name, switchKey) ?? false);
   },
   track(userId, eventName, props) {
-    _server?.track(userId, eventName, props);
+    safeRun("flags.track", void 0, () => _server?.track(userId, eventName, props));
   },
   /** Emit an exposure for an enrolled experiment at the decision point. See
    *  {@link Engine.logExposure}. No-op before configure(). */
   logExposure(user, name) {
-    _server?.logExposure(user, name);
+    safeRun("flags.logExposure", void 0, () => _server?.logExposure(user, name));
   },
   /**
    * Evaluate all flags / configs / experiments for a user against the locally
@@ -1239,12 +1302,8 @@ var flags = {
    * overrides. Returns an empty payload when the blob hasn't been fetched yet.
    */
   evaluate(user, rawUrl) {
-    return _server?.evaluate(user, rawUrl) ?? {
-      flags: {},
-      configs: {},
-      experiments: {},
-      killswitches: {}
-    };
+    const empty = { flags: {}, configs: {}, experiments: {}, killswitches: {} };
+    return safeRun("flags.evaluate", empty, () => _server?.evaluate(user, rawUrl) ?? empty);
   }
 };
 var _identityAttributes = (user) => user && typeof user === "object" ? user : {};
@@ -1333,20 +1392,37 @@ var Client = class {
     this.attributes = _attributes(user);
   }
   getFlag(name, defaultValue = false) {
-    return this.engine.getFlag(name, this.attributes, defaultValue);
+    return safeRun(
+      "Client.getFlag",
+      defaultValue,
+      () => this.engine.getFlag(name, this.attributes, defaultValue)
+    );
   }
   getFlagDetail(name) {
-    return this.engine.getFlagDetail(name, this.attributes);
+    return safeRun(
+      "Client.getFlagDetail",
+      { value: false, reason: "CLIENT_NOT_READY" },
+      () => this.engine.getFlagDetail(name, this.attributes)
+    );
   }
   getConfig(name, decodeOrOpts) {
-    return this.engine.getConfig(name, decodeOrOpts);
+    return safeRun(
+      "Client.getConfig",
+      void 0,
+      () => this.engine.getConfig(name, decodeOrOpts)
+    );
   }
   getExperiment(name, defaultParams, decode) {
-    return this.engine.getExperiment(name, this.attributes, defaultParams, decode);
+    const notIn = { inExperiment: false, group: "control", params: defaultParams };
+    return safeRun(
+      "Client.getExperiment",
+      notIn,
+      () => 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);
+    return safeRun("Client.getKillswitch", false, () => this.engine.getKillswitch(name, switchKey));
   }
   /**
    * Record a conversion/metric event for the bound user. Derives the unit from
@@ -1356,9 +1432,11 @@ var Client = class {
    * mode.
    */
   track(eventName, props) {
-    const id = this.attributes.user_id ?? this.attributes.anonymous_id;
-    if (id === void 0) return;
-    this.engine.track(String(id), eventName, props);
+    safeRun("Client.track", void 0, () => {
+      const id = this.attributes.user_id ?? this.attributes.anonymous_id;
+      if (id === void 0) return;
+      this.engine.track(String(id), eventName, props);
+    });
   }
   /**
    * Emit an exposure event for `name` at this server-side decision point for the
@@ -1367,12 +1445,12 @@ var Client = class {
    * in test mode).
    */
   logExposure(name) {
-    this.engine.logExposure(this.attributes, name);
+    safeRun("Client.logExposure", void 0, () => this.engine.logExposure(this.attributes, name));
   }
 };
 function dispatchSee(problem, consequence, extras, kind) {
   if (!_server) {
-    console.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
+    logger.warn("[shipeasy] see() called before shipeasy({ serverKey }) \u2014 error dropped");
     return;
   }
   _server.reportError(problem, consequence, extras, kind);
@@ -1389,6 +1467,7 @@ export {
   Client,
   Engine,
   FLAG_REASONS,
+  LOG_LEVELS,
   _murmur3ForTests,
   _resetConfigureForTests,
   _resetShipeasyServerForTests,