@shipeasy/sdk 6.0.0 → 6.3.1

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

@@ -1,5 +1,7 @@
 import { Provider, EvaluationContext, Logger, ResolutionDetails, JsonValue } from '@openfeature/server-sdk';
 
+type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+
 type SeeExtras = Record<string, string | number | boolean | null | undefined>;
 type SeeKind = "caught" | "uncaught" | "unhandled_rejection" | "network" | "violation";
 /** Built by `causesThe(subject).to(outcome)` — never constructed by hand. */
@@ -137,6 +139,16 @@ interface EngineOptions {
     disableTelemetry?: boolean;
     /** Override the telemetry beacon host. Defaults to {@link DEFAULT_TELEMETRY_URL}. */
     telemetryUrl?: string;
+    /**
+     * How chatty the SDK is on `console` when it catches an error internally.
+     * Every public runtime method (getFlag/getConfig/getExperiment/getKillswitch/
+     * track/logExposure/see) fails silently — it returns a safe default rather
+     * than throwing — and surfaces the swallowed error through this level so you
+     * still find out. Ordering: `silent` < `error` < `warn` < `info` < `debug`.
+     * Defaults to `"warn"` (prints `error` + `warn`). Pass `"silent"` to mute the
+     * SDK entirely. See {@link LogLevel}.
+     */
+    logLevel?: LogLevel;
     /**
      * Attribute names usable for targeting but never persisted in analytics
      * (LD/Statsig `privateAttributes`). The server evaluates locally so private
@@ -318,12 +330,25 @@ declare class Engine {
  * 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: Engine);
+    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.d.ts

@@ -1,5 +1,7 @@
 import { Provider, EvaluationContext, Logger, ResolutionDetails, JsonValue } from '@openfeature/server-sdk';
 
+type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+
 type SeeExtras = Record<string, string | number | boolean | null | undefined>;
 type SeeKind = "caught" | "uncaught" | "unhandled_rejection" | "network" | "violation";
 /** Built by `causesThe(subject).to(outcome)` — never constructed by hand. */
@@ -137,6 +139,16 @@ interface EngineOptions {
     disableTelemetry?: boolean;
     /** Override the telemetry beacon host. Defaults to {@link DEFAULT_TELEMETRY_URL}. */
     telemetryUrl?: string;
+    /**
+     * How chatty the SDK is on `console` when it catches an error internally.
+     * Every public runtime method (getFlag/getConfig/getExperiment/getKillswitch/
+     * track/logExposure/see) fails silently — it returns a safe default rather
+     * than throwing — and surfaces the swallowed error through this level so you
+     * still find out. Ordering: `silent` < `error` < `warn` < `info` < `debug`.
+     * Defaults to `"warn"` (prints `error` + `warn`). Pass `"silent"` to mute the
+     * SDK entirely. See {@link LogLevel}.
+     */
+    logLevel?: LogLevel;
     /**
      * Attribute names usable for targeting but never persisted in analytics
      * (LD/Statsig `privateAttributes`). The server evaluates locally so private
@@ -318,12 +330,25 @@ declare class Engine {
  * 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: Engine);
+    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,210 @@ __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/logger.ts
+var RANK = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+var currentLevel = "warn";
+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);
+  }
+};
+
+// 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) {
+    logger.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 +282,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,210 @@
 // src/openfeature-server/index.ts
 import { ErrorCode } from "@openfeature/server-sdk";
 
+// src/server/index.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/logger.ts
+var RANK = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+var currentLevel = "warn";
+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);
+  }
+};
+
+// 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) {
+    logger.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 +258,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

@@ -1,5 +1,7 @@
 import { Provider, EvaluationContext, Logger, ResolutionDetails, JsonValue } from '@openfeature/web-sdk';
 
+type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+
 type SeeExtras = Record<string, string | number | boolean | null | undefined>;
 type SeeKind = "caught" | "uncaught" | "unhandled_rejection" | "network" | "violation";
 /** Built by `causesThe(subject).to(outcome)` — never constructed by hand. */
@@ -131,6 +133,14 @@ interface EngineOptions {
     disableTelemetry?: boolean;
     /** Override the telemetry beacon host. Defaults to {@link DEFAULT_TELEMETRY_URL}. */
     telemetryUrl?: string;
+    /**
+     * How chatty the SDK is on `console` when it catches an error internally.
+     * Every public runtime method (getFlag/getConfig/getExperiment/getKillswitch/
+     * track/logExposure/see) fails silently — returning a safe default instead of
+     * throwing — and surfaces the swallowed error through this level. Ordering:
+     * `silent` < `error` < `warn` < `info` < `debug`. Defaults to `"warn"`.
+     */
+    logLevel?: LogLevel;
     /**
      * Suppress automatic exposure logging in `getExperiment` (Statsig's
      * `disableExposureLogging`). Default false — reading an enrolled variant

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

@@ -1,5 +1,7 @@
 import { Provider, EvaluationContext, Logger, ResolutionDetails, JsonValue } from '@openfeature/web-sdk';
 
+type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+
 type SeeExtras = Record<string, string | number | boolean | null | undefined>;
 type SeeKind = "caught" | "uncaught" | "unhandled_rejection" | "network" | "violation";
 /** Built by `causesThe(subject).to(outcome)` — never constructed by hand. */
@@ -131,6 +133,14 @@ interface EngineOptions {
     disableTelemetry?: boolean;
     /** Override the telemetry beacon host. Defaults to {@link DEFAULT_TELEMETRY_URL}. */
     telemetryUrl?: string;
+    /**
+     * How chatty the SDK is on `console` when it catches an error internally.
+     * Every public runtime method (getFlag/getConfig/getExperiment/getKillswitch/
+     * track/logExposure/see) fails silently — returning a safe default instead of
+     * throwing — and surfaces the swallowed error through this level. Ordering:
+     * `silent` < `error` < `warn` < `info` < `debug`. Defaults to `"warn"`.
+     */
+    logLevel?: LogLevel;
     /**
      * Suppress automatic exposure logging in `getExperiment` (Statsig's
      * `disableExposureLogging`). Default false — reading an enrolled variant