@shipeasy/sdk 2.2.0 → 2.4.0

package/dist/client/index.d.mts

@@ -28,11 +28,23 @@ interface EvalResponse {
     configs: Record<string, unknown>;
     experiments: Record<string, EvalExpResult>;
 }
+interface AutoCollectGroups {
+    vitals: boolean;
+    errors: boolean;
+    engagement: boolean;
+}
 type FlagsClientBrowserEnv = "dev" | "staging" | "prod";
 interface FlagsClientBrowserOptions {
     sdkKey: string;
     baseUrl?: string;
     autoGuardrails?: boolean;
+    /**
+     * Per-group enablement for auto-collected metrics. When set, overrides the
+     * blanket `autoGuardrails` flag for the specific groups listed. Any group
+     * not present in the object falls back to `autoGuardrails` (defaulting to
+     * true when `autoGuardrails` is true).
+     */
+    autoGuardrailGroups?: Partial<AutoCollectGroups>;
     /** Which published env to read values from. Defaults to "prod". */
     env?: FlagsClientBrowserEnv;
 }
@@ -40,6 +52,7 @@ declare class FlagsClientBrowser {
     private readonly sdkKey;
     private readonly baseUrl;
     private readonly autoGuardrails;
+    private readonly autoGuardrailGroups;
     private readonly env;
     private evalResult;
     private anonId;
@@ -125,11 +138,20 @@ interface ShipeasyClientConfig {
      */
     autoIdentify?: boolean;
     /**
-     * Capture web vitals (LCP, CLS, INP, TTFB, FCP) and JS/network errors as
-     * `__auto_*` metric events. Defaults to false (opt-in) — enabling requires the
-     * `__auto_*` event names to be approved in the project event catalog.
+     * Capture web vitals (LCP, CLS, INP, TTFB, FCP, navigation timing), JS /
+     * network errors, and engagement signals (abandonment) as `__auto_*`
+     * metric events. Defaults to `true` — the worker bypasses event-catalog
+     * validation for `__auto_*` names so this is safe out of the box.
+     *
+     * Pass `false` to disable everything, or a per-group object to narrow:
+     *
+     * ```ts
+     * shipeasy({ apiKey, autoCollect: false });                  // off
+     * shipeasy({ apiKey, autoCollect: { errors: false } });      // vitals + engagement only
+     * shipeasy({ apiKey });                                      // all groups on
+     * ```
      */
-    autoCollect?: boolean;
+    autoCollect?: boolean | Partial<AutoCollectGroups>;
 }
 /**
  * Initialise the ShipEasy client SDK and wire up lazy devtools.
@@ -237,4 +259,4 @@ interface I18nFacade {
 }
 declare const i18n: I18nFacade;
 
-export { type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };
+export { type AutoCollectGroups, type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };

package/dist/client/index.d.ts

@@ -28,11 +28,23 @@ interface EvalResponse {
     configs: Record<string, unknown>;
     experiments: Record<string, EvalExpResult>;
 }
+interface AutoCollectGroups {
+    vitals: boolean;
+    errors: boolean;
+    engagement: boolean;
+}
 type FlagsClientBrowserEnv = "dev" | "staging" | "prod";
 interface FlagsClientBrowserOptions {
     sdkKey: string;
     baseUrl?: string;
     autoGuardrails?: boolean;
+    /**
+     * Per-group enablement for auto-collected metrics. When set, overrides the
+     * blanket `autoGuardrails` flag for the specific groups listed. Any group
+     * not present in the object falls back to `autoGuardrails` (defaulting to
+     * true when `autoGuardrails` is true).
+     */
+    autoGuardrailGroups?: Partial<AutoCollectGroups>;
     /** Which published env to read values from. Defaults to "prod". */
     env?: FlagsClientBrowserEnv;
 }
@@ -40,6 +52,7 @@ declare class FlagsClientBrowser {
     private readonly sdkKey;
     private readonly baseUrl;
     private readonly autoGuardrails;
+    private readonly autoGuardrailGroups;
     private readonly env;
     private evalResult;
     private anonId;
@@ -125,11 +138,20 @@ interface ShipeasyClientConfig {
      */
     autoIdentify?: boolean;
     /**
-     * Capture web vitals (LCP, CLS, INP, TTFB, FCP) and JS/network errors as
-     * `__auto_*` metric events. Defaults to false (opt-in) — enabling requires the
-     * `__auto_*` event names to be approved in the project event catalog.
+     * Capture web vitals (LCP, CLS, INP, TTFB, FCP, navigation timing), JS /
+     * network errors, and engagement signals (abandonment) as `__auto_*`
+     * metric events. Defaults to `true` — the worker bypasses event-catalog
+     * validation for `__auto_*` names so this is safe out of the box.
+     *
+     * Pass `false` to disable everything, or a per-group object to narrow:
+     *
+     * ```ts
+     * shipeasy({ apiKey, autoCollect: false });                  // off
+     * shipeasy({ apiKey, autoCollect: { errors: false } });      // vitals + engagement only
+     * shipeasy({ apiKey });                                      // all groups on
+     * ```
      */
-    autoCollect?: boolean;
+    autoCollect?: boolean | Partial<AutoCollectGroups>;
 }
 /**
  * Initialise the ShipEasy client SDK and wire up lazy devtools.
@@ -237,4 +259,4 @@ interface I18nFacade {
 }
 declare const i18n: I18nFacade;
 
-export { type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };
+export { type AutoCollectGroups, type BootstrapPayload, type ExperimentResult, FlagsClientBrowser, type FlagsClientBrowserEnv, type FlagsClientBrowserOptions, type I18nFacade, type I18nKey, type I18nRichComponents, type I18nString, type I18nTagRenderer, type I18nVariables, LABEL_MARKER_END, LABEL_MARKER_RE, LABEL_MARKER_SEP, LABEL_MARKER_START, type LabelAttrs, type ShipeasyClientConfig, type ShipeasySdkBridge, type User, _resetShipeasyForTests, attachDevtools, configureShipeasy, encodeLabelMarker, flags, getShipeasyClient, i18n, isDevtoolsRequested, labelAttrs, loadDevtools, readConfigOverride, readExpOverride, readGateOverride, shipeasy, version };

package/dist/client/index.js

@@ -167,7 +167,7 @@ var EventBuffer = class {
   }
 };
 var MAX_ERRORS_PER_SESSION = 5;
-function installAutoGuardrails(buffer, userId, anonId) {
+function installAutoGuardrails(buffer, userId, anonId, groups) {
   if (typeof window === "undefined" || typeof PerformanceObserver === "undefined") return;
   let lcp = null;
   let inp = null;
@@ -175,100 +175,105 @@ function installAutoGuardrails(buffer, userId, anonId) {
   let jsErrorCount = 0;
   let netErrorCount = 0;
   let navTimingFlushed = false;
-  try {
-    const lcpObs = new PerformanceObserver((list) => {
-      const entries = list.getEntries();
-      if (entries.length)
-        lcp = entries[entries.length - 1].startTime;
-    });
-    lcpObs.observe({ type: "largest-contentful-paint", buffered: true });
-  } catch {
-  }
-  try {
-    const inpObs = new PerformanceObserver((list) => {
-      for (const e of list.getEntries()) {
-        const dur = e.duration ?? 0;
-        if (inp === null || dur > inp) inp = dur;
-      }
-    });
-    inpObs.observe({
-      type: "event",
-      buffered: true,
-      durationThreshold: 16
-    });
-  } catch {
-  }
-  try {
-    const clsObs = new PerformanceObserver((list) => {
-      for (const e of list.getEntries()) {
-        if (e.value > 0.1) clsBad = true;
-      }
-    });
-    clsObs.observe({ type: "layout-shift", buffered: true });
-  } catch {
-  }
-  const origOnError = window.onerror;
-  window.onerror = (msg, source, lineno, _colno, err) => {
-    if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
-      jsErrorCount += 1;
-      buffer.pushMetric("__auto_js_error", userId, anonId, {
-        value: 1,
-        kind: "exception",
-        message: typeof msg === "string" ? msg.slice(0, 200) : String(err ?? "").slice(0, 200),
-        source: typeof source === "string" ? source.slice(0, 200) : "",
-        line: lineno ?? 0
+  if (groups.vitals) {
+    try {
+      const lcpObs = new PerformanceObserver((list) => {
+        const entries = list.getEntries();
+        if (entries.length)
+          lcp = entries[entries.length - 1].startTime;
       });
+      lcpObs.observe({ type: "largest-contentful-paint", buffered: true });
+    } catch {
     }
-    if (typeof origOnError === "function") return origOnError(msg, source, lineno, _colno, err);
-    return false;
-  };
-  window.addEventListener("unhandledrejection", (e) => {
-    if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
-      jsErrorCount += 1;
-      const reason = e.reason;
-      const message = reason instanceof Error ? reason.message : typeof reason === "string" ? reason : String(reason);
-      buffer.pushMetric("__auto_js_error", userId, anonId, {
-        value: 1,
-        kind: "unhandled_rejection",
-        message: message.slice(0, 200)
+    try {
+      const inpObs = new PerformanceObserver((list) => {
+        for (const e of list.getEntries()) {
+          const dur = e.duration ?? 0;
+          if (inp === null || dur > inp) inp = dur;
+        }
+      });
+      inpObs.observe({
+        type: "event",
+        buffered: true,
+        durationThreshold: 16
       });
+    } catch {
     }
-  });
-  const origFetch = window.fetch;
-  window.fetch = async function(...args) {
-    const startedAt = typeof performance !== "undefined" ? performance.now() : 0;
-    const url = typeof args[0] === "string" ? args[0] : args[0].toString();
-    let res;
     try {
-      res = await origFetch.apply(this, args);
-    } catch (err) {
-      if (netErrorCount < MAX_ERRORS_PER_SESSION) {
+      const clsObs = new PerformanceObserver((list) => {
+        for (const e of list.getEntries()) {
+          if (e.value > 0.1) clsBad = true;
+        }
+      });
+      clsObs.observe({ type: "layout-shift", buffered: true });
+    } catch {
+    }
+  }
+  if (groups.errors) {
+    const origOnError = window.onerror;
+    window.onerror = (msg, source, lineno, _colno, err) => {
+      if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
+        jsErrorCount += 1;
+        buffer.pushMetric("__auto_js_error", userId, anonId, {
+          value: 1,
+          kind: "exception",
+          message: typeof msg === "string" ? msg.slice(0, 200) : String(err ?? "").slice(0, 200),
+          source: typeof source === "string" ? source.slice(0, 200) : "",
+          line: lineno ?? 0
+        });
+      }
+      if (typeof origOnError === "function") return origOnError(msg, source, lineno, _colno, err);
+      return false;
+    };
+    window.addEventListener("unhandledrejection", (e) => {
+      if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
+        jsErrorCount += 1;
+        const reason = e.reason;
+        const message = reason instanceof Error ? reason.message : typeof reason === "string" ? reason : String(reason);
+        buffer.pushMetric("__auto_js_error", userId, anonId, {
+          value: 1,
+          kind: "unhandled_rejection",
+          message: message.slice(0, 200)
+        });
+      }
+    });
+    const origFetch = window.fetch;
+    window.fetch = async function(...args) {
+      const startedAt = typeof performance !== "undefined" ? performance.now() : 0;
+      const url = typeof args[0] === "string" ? args[0] : args[0].toString();
+      let res;
+      try {
+        res = await origFetch.apply(this, args);
+      } catch (err) {
+        if (netErrorCount < MAX_ERRORS_PER_SESSION) {
+          netErrorCount += 1;
+          buffer.pushMetric("__auto_network_error", userId, anonId, {
+            value: 1,
+            kind: "network",
+            status: 0,
+            url: url.slice(0, 200)
+          });
+        }
+        throw err;
+      }
+      if (res.status >= 500 && netErrorCount < MAX_ERRORS_PER_SESSION) {
         netErrorCount += 1;
+        const elapsed = typeof performance !== "undefined" ? performance.now() - startedAt : 0;
         buffer.pushMetric("__auto_network_error", userId, anonId, {
           value: 1,
-          kind: "network",
-          status: 0,
-          url: url.slice(0, 200)
+          kind: "5xx",
+          status: res.status,
+          url: url.slice(0, 200),
+          duration_ms: Math.round(elapsed)
         });
       }
-      throw err;
-    }
-    if (res.status >= 500 && netErrorCount < MAX_ERRORS_PER_SESSION) {
-      netErrorCount += 1;
-      const elapsed = typeof performance !== "undefined" ? performance.now() - startedAt : 0;
-      buffer.pushMetric("__auto_network_error", userId, anonId, {
-        value: 1,
-        kind: "5xx",
-        status: res.status,
-        url: url.slice(0, 200),
-        duration_ms: Math.round(elapsed)
-      });
-    }
-    return res;
-  };
+      return res;
+    };
+  }
   const flushNavTiming = () => {
     if (navTimingFlushed) return;
     navTimingFlushed = true;
+    if (!groups.vitals) return;
     try {
       const navList = performance.getEntriesByType("navigation");
       const nav = navList[0];
@@ -301,29 +306,53 @@ function installAutoGuardrails(buffer, userId, anonId) {
     } catch {
     }
   };
-  if (document.readyState === "complete") {
-    setTimeout(flushNavTiming, 0);
-  } else {
-    window.addEventListener(
-      "load",
-      () => {
-        setTimeout(flushNavTiming, 0);
-      },
-      { once: true }
-    );
+  if (groups.engagement) {
+    try {
+      buffer.pushMetric("__auto_session_active", userId, anonId, { value: 1 });
+    } catch {
+    }
+    let lastEmit = Date.now();
+    const SESSION_GAP_MS = 30 * 60 * 1e3;
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState !== "visible") return;
+      if (Date.now() - lastEmit < SESSION_GAP_MS) return;
+      try {
+        buffer.pushMetric("__auto_session_active", userId, anonId, { value: 1 });
+        lastEmit = Date.now();
+      } catch {
+      }
+    });
+  }
+  const needHide = groups.vitals || groups.engagement;
+  if (needHide) {
+    if (document.readyState === "complete") {
+      setTimeout(flushNavTiming, 0);
+    } else {
+      window.addEventListener(
+        "load",
+        () => {
+          setTimeout(flushNavTiming, 0);
+        },
+        { once: true }
+      );
+    }
+    const flushOnHide = () => {
+      flushNavTiming();
+      if (groups.vitals) {
+        if (lcp !== null) buffer.pushMetric("__auto_lcp", userId, anonId, { value: lcp });
+        if (inp !== null) buffer.pushMetric("__auto_inp", userId, anonId, { value: inp });
+        if (clsBad) buffer.pushMetric("__auto_cls_binary", userId, anonId, { value: 1 });
+      }
+      if (groups.engagement) {
+        const abandoned = lcp === null ? 1 : 0;
+        buffer.pushMetric("__auto_abandoned", userId, anonId, { value: abandoned });
+      }
+      buffer.flush(true);
+    };
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "hidden") flushOnHide();
+    });
   }
-  const flushOnHide = () => {
-    flushNavTiming();
-    if (lcp !== null) buffer.pushMetric("__auto_lcp", userId, anonId, { value: lcp });
-    if (inp !== null) buffer.pushMetric("__auto_inp", userId, anonId, { value: inp });
-    if (clsBad) buffer.pushMetric("__auto_cls_binary", userId, anonId, { value: 1 });
-    const abandoned = lcp === null ? 1 : 0;
-    buffer.pushMetric("__auto_abandoned", userId, anonId, { value: abandoned });
-    buffer.flush(true);
-  };
-  document.addEventListener("visibilitychange", () => {
-    if (document.visibilityState === "hidden") flushOnHide();
-  });
 }
 function getOrCreateAnonId() {
   try {
@@ -391,6 +420,7 @@ var FlagsClientBrowser = class {
   sdkKey;
   baseUrl;
   autoGuardrails;
+  autoGuardrailGroups;
   env;
   evalResult = null;
   anonId;
@@ -410,7 +440,13 @@ var FlagsClientBrowser = class {
     this.sdkKey = opts.sdkKey;
     this.baseUrl = (opts.baseUrl ?? "https://edge.shipeasy.dev").replace(/\/$/, "");
     this.env = opts.env ?? "prod";
-    this.autoGuardrails = opts.autoGuardrails === true;
+    this.autoGuardrails = opts.autoGuardrails !== false;
+    const g = opts.autoGuardrailGroups ?? {};
+    this.autoGuardrailGroups = {
+      vitals: g.vitals ?? this.autoGuardrails,
+      errors: g.errors ?? this.autoGuardrails,
+      engagement: g.engagement ?? this.autoGuardrails
+    };
     this.anonId = getOrCreateAnonId();
     this.buffer = new EventBuffer(`${this.baseUrl}/collect`, this.sdkKey);
     void this.buffer.flushPendingAlias();
@@ -439,9 +475,10 @@ var FlagsClientBrowser = class {
     const data = await res.json();
     if (seq !== this.identifySeq) return;
     this.evalResult = data;
-    if (this.autoGuardrails && !this.guardrailsInstalled) {
+    const anyGroupOn = this.autoGuardrailGroups.vitals || this.autoGuardrailGroups.errors || this.autoGuardrailGroups.engagement;
+    if (anyGroupOn && !this.guardrailsInstalled) {
       this.guardrailsInstalled = true;
-      installAutoGuardrails(this.buffer, this.userId, this.anonId);
+      installAutoGuardrails(this.buffer, this.userId, this.anonId, this.autoGuardrailGroups);
     }
     this.notify();
   }
@@ -657,10 +694,14 @@ function attachDevtools(client, opts = {}) {
 }
 var _client = null;
 function shipeasy(opts) {
+  const ac = opts.autoCollect;
+  const blanket = ac === false ? false : true;
+  const groups = ac && typeof ac === "object" ? ac : void 0;
   const client = configureShipeasy({
     sdkKey: opts.apiKey,
     baseUrl: opts.baseUrl ?? "https://cdn.shipeasy.ai",
-    autoGuardrails: opts.autoCollect === true
+    autoGuardrails: blanket,
+    autoGuardrailGroups: groups
   });
   flags.notifyMounted();
   if (opts.autoIdentify !== false) {

package/dist/client/index.mjs

@@ -124,7 +124,7 @@ var EventBuffer = class {
   }
 };
 var MAX_ERRORS_PER_SESSION = 5;
-function installAutoGuardrails(buffer, userId, anonId) {
+function installAutoGuardrails(buffer, userId, anonId, groups) {
   if (typeof window === "undefined" || typeof PerformanceObserver === "undefined") return;
   let lcp = null;
   let inp = null;
@@ -132,100 +132,105 @@ function installAutoGuardrails(buffer, userId, anonId) {
   let jsErrorCount = 0;
   let netErrorCount = 0;
   let navTimingFlushed = false;
-  try {
-    const lcpObs = new PerformanceObserver((list) => {
-      const entries = list.getEntries();
-      if (entries.length)
-        lcp = entries[entries.length - 1].startTime;
-    });
-    lcpObs.observe({ type: "largest-contentful-paint", buffered: true });
-  } catch {
-  }
-  try {
-    const inpObs = new PerformanceObserver((list) => {
-      for (const e of list.getEntries()) {
-        const dur = e.duration ?? 0;
-        if (inp === null || dur > inp) inp = dur;
-      }
-    });
-    inpObs.observe({
-      type: "event",
-      buffered: true,
-      durationThreshold: 16
-    });
-  } catch {
-  }
-  try {
-    const clsObs = new PerformanceObserver((list) => {
-      for (const e of list.getEntries()) {
-        if (e.value > 0.1) clsBad = true;
-      }
-    });
-    clsObs.observe({ type: "layout-shift", buffered: true });
-  } catch {
-  }
-  const origOnError = window.onerror;
-  window.onerror = (msg, source, lineno, _colno, err) => {
-    if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
-      jsErrorCount += 1;
-      buffer.pushMetric("__auto_js_error", userId, anonId, {
-        value: 1,
-        kind: "exception",
-        message: typeof msg === "string" ? msg.slice(0, 200) : String(err ?? "").slice(0, 200),
-        source: typeof source === "string" ? source.slice(0, 200) : "",
-        line: lineno ?? 0
+  if (groups.vitals) {
+    try {
+      const lcpObs = new PerformanceObserver((list) => {
+        const entries = list.getEntries();
+        if (entries.length)
+          lcp = entries[entries.length - 1].startTime;
       });
+      lcpObs.observe({ type: "largest-contentful-paint", buffered: true });
+    } catch {
     }
-    if (typeof origOnError === "function") return origOnError(msg, source, lineno, _colno, err);
-    return false;
-  };
-  window.addEventListener("unhandledrejection", (e) => {
-    if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
-      jsErrorCount += 1;
-      const reason = e.reason;
-      const message = reason instanceof Error ? reason.message : typeof reason === "string" ? reason : String(reason);
-      buffer.pushMetric("__auto_js_error", userId, anonId, {
-        value: 1,
-        kind: "unhandled_rejection",
-        message: message.slice(0, 200)
+    try {
+      const inpObs = new PerformanceObserver((list) => {
+        for (const e of list.getEntries()) {
+          const dur = e.duration ?? 0;
+          if (inp === null || dur > inp) inp = dur;
+        }
+      });
+      inpObs.observe({
+        type: "event",
+        buffered: true,
+        durationThreshold: 16
       });
+    } catch {
     }
-  });
-  const origFetch = window.fetch;
-  window.fetch = async function(...args) {
-    const startedAt = typeof performance !== "undefined" ? performance.now() : 0;
-    const url = typeof args[0] === "string" ? args[0] : args[0].toString();
-    let res;
     try {
-      res = await origFetch.apply(this, args);
-    } catch (err) {
-      if (netErrorCount < MAX_ERRORS_PER_SESSION) {
+      const clsObs = new PerformanceObserver((list) => {
+        for (const e of list.getEntries()) {
+          if (e.value > 0.1) clsBad = true;
+        }
+      });
+      clsObs.observe({ type: "layout-shift", buffered: true });
+    } catch {
+    }
+  }
+  if (groups.errors) {
+    const origOnError = window.onerror;
+    window.onerror = (msg, source, lineno, _colno, err) => {
+      if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
+        jsErrorCount += 1;
+        buffer.pushMetric("__auto_js_error", userId, anonId, {
+          value: 1,
+          kind: "exception",
+          message: typeof msg === "string" ? msg.slice(0, 200) : String(err ?? "").slice(0, 200),
+          source: typeof source === "string" ? source.slice(0, 200) : "",
+          line: lineno ?? 0
+        });
+      }
+      if (typeof origOnError === "function") return origOnError(msg, source, lineno, _colno, err);
+      return false;
+    };
+    window.addEventListener("unhandledrejection", (e) => {
+      if (jsErrorCount < MAX_ERRORS_PER_SESSION) {
+        jsErrorCount += 1;
+        const reason = e.reason;
+        const message = reason instanceof Error ? reason.message : typeof reason === "string" ? reason : String(reason);
+        buffer.pushMetric("__auto_js_error", userId, anonId, {
+          value: 1,
+          kind: "unhandled_rejection",
+          message: message.slice(0, 200)
+        });
+      }
+    });
+    const origFetch = window.fetch;
+    window.fetch = async function(...args) {
+      const startedAt = typeof performance !== "undefined" ? performance.now() : 0;
+      const url = typeof args[0] === "string" ? args[0] : args[0].toString();
+      let res;
+      try {
+        res = await origFetch.apply(this, args);
+      } catch (err) {
+        if (netErrorCount < MAX_ERRORS_PER_SESSION) {
+          netErrorCount += 1;
+          buffer.pushMetric("__auto_network_error", userId, anonId, {
+            value: 1,
+            kind: "network",
+            status: 0,
+            url: url.slice(0, 200)
+          });
+        }
+        throw err;
+      }
+      if (res.status >= 500 && netErrorCount < MAX_ERRORS_PER_SESSION) {
         netErrorCount += 1;
+        const elapsed = typeof performance !== "undefined" ? performance.now() - startedAt : 0;
         buffer.pushMetric("__auto_network_error", userId, anonId, {
           value: 1,
-          kind: "network",
-          status: 0,
-          url: url.slice(0, 200)
+          kind: "5xx",
+          status: res.status,
+          url: url.slice(0, 200),
+          duration_ms: Math.round(elapsed)
         });
       }
-      throw err;
-    }
-    if (res.status >= 500 && netErrorCount < MAX_ERRORS_PER_SESSION) {
-      netErrorCount += 1;
-      const elapsed = typeof performance !== "undefined" ? performance.now() - startedAt : 0;
-      buffer.pushMetric("__auto_network_error", userId, anonId, {
-        value: 1,
-        kind: "5xx",
-        status: res.status,
-        url: url.slice(0, 200),
-        duration_ms: Math.round(elapsed)
-      });
-    }
-    return res;
-  };
+      return res;
+    };
+  }
   const flushNavTiming = () => {
     if (navTimingFlushed) return;
     navTimingFlushed = true;
+    if (!groups.vitals) return;
     try {
       const navList = performance.getEntriesByType("navigation");
       const nav = navList[0];
@@ -258,29 +263,53 @@ function installAutoGuardrails(buffer, userId, anonId) {
     } catch {
     }
   };
-  if (document.readyState === "complete") {
-    setTimeout(flushNavTiming, 0);
-  } else {
-    window.addEventListener(
-      "load",
-      () => {
-        setTimeout(flushNavTiming, 0);
-      },
-      { once: true }
-    );
-  }
-  const flushOnHide = () => {
-    flushNavTiming();
-    if (lcp !== null) buffer.pushMetric("__auto_lcp", userId, anonId, { value: lcp });
-    if (inp !== null) buffer.pushMetric("__auto_inp", userId, anonId, { value: inp });
-    if (clsBad) buffer.pushMetric("__auto_cls_binary", userId, anonId, { value: 1 });
-    const abandoned = lcp === null ? 1 : 0;
-    buffer.pushMetric("__auto_abandoned", userId, anonId, { value: abandoned });
-    buffer.flush(true);
-  };
-  document.addEventListener("visibilitychange", () => {
-    if (document.visibilityState === "hidden") flushOnHide();
-  });
+  if (groups.engagement) {
+    try {
+      buffer.pushMetric("__auto_session_active", userId, anonId, { value: 1 });
+    } catch {
+    }
+    let lastEmit = Date.now();
+    const SESSION_GAP_MS = 30 * 60 * 1e3;
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState !== "visible") return;
+      if (Date.now() - lastEmit < SESSION_GAP_MS) return;
+      try {
+        buffer.pushMetric("__auto_session_active", userId, anonId, { value: 1 });
+        lastEmit = Date.now();
+      } catch {
+      }
+    });
+  }
+  const needHide = groups.vitals || groups.engagement;
+  if (needHide) {
+    if (document.readyState === "complete") {
+      setTimeout(flushNavTiming, 0);
+    } else {
+      window.addEventListener(
+        "load",
+        () => {
+          setTimeout(flushNavTiming, 0);
+        },
+        { once: true }
+      );
+    }
+    const flushOnHide = () => {
+      flushNavTiming();
+      if (groups.vitals) {
+        if (lcp !== null) buffer.pushMetric("__auto_lcp", userId, anonId, { value: lcp });
+        if (inp !== null) buffer.pushMetric("__auto_inp", userId, anonId, { value: inp });
+        if (clsBad) buffer.pushMetric("__auto_cls_binary", userId, anonId, { value: 1 });
+      }
+      if (groups.engagement) {
+        const abandoned = lcp === null ? 1 : 0;
+        buffer.pushMetric("__auto_abandoned", userId, anonId, { value: abandoned });
+      }
+      buffer.flush(true);
+    };
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "hidden") flushOnHide();
+    });
+  }
 }
 function getOrCreateAnonId() {
   try {
@@ -348,6 +377,7 @@ var FlagsClientBrowser = class {
   sdkKey;
   baseUrl;
   autoGuardrails;
+  autoGuardrailGroups;
   env;
   evalResult = null;
   anonId;
@@ -367,7 +397,13 @@ var FlagsClientBrowser = class {
     this.sdkKey = opts.sdkKey;
     this.baseUrl = (opts.baseUrl ?? "https://edge.shipeasy.dev").replace(/\/$/, "");
     this.env = opts.env ?? "prod";
-    this.autoGuardrails = opts.autoGuardrails === true;
+    this.autoGuardrails = opts.autoGuardrails !== false;
+    const g = opts.autoGuardrailGroups ?? {};
+    this.autoGuardrailGroups = {
+      vitals: g.vitals ?? this.autoGuardrails,
+      errors: g.errors ?? this.autoGuardrails,
+      engagement: g.engagement ?? this.autoGuardrails
+    };
     this.anonId = getOrCreateAnonId();
     this.buffer = new EventBuffer(`${this.baseUrl}/collect`, this.sdkKey);
     void this.buffer.flushPendingAlias();
@@ -396,9 +432,10 @@ var FlagsClientBrowser = class {
     const data = await res.json();
     if (seq !== this.identifySeq) return;
     this.evalResult = data;
-    if (this.autoGuardrails && !this.guardrailsInstalled) {
+    const anyGroupOn = this.autoGuardrailGroups.vitals || this.autoGuardrailGroups.errors || this.autoGuardrailGroups.engagement;
+    if (anyGroupOn && !this.guardrailsInstalled) {
       this.guardrailsInstalled = true;
-      installAutoGuardrails(this.buffer, this.userId, this.anonId);
+      installAutoGuardrails(this.buffer, this.userId, this.anonId, this.autoGuardrailGroups);
     }
     this.notify();
   }
@@ -614,10 +651,14 @@ function attachDevtools(client, opts = {}) {
 }
 var _client = null;
 function shipeasy(opts) {
+  const ac = opts.autoCollect;
+  const blanket = ac === false ? false : true;
+  const groups = ac && typeof ac === "object" ? ac : void 0;
   const client = configureShipeasy({
     sdkKey: opts.apiKey,
     baseUrl: opts.baseUrl ?? "https://cdn.shipeasy.ai",
-    autoGuardrails: opts.autoCollect === true
+    autoGuardrails: blanket,
+    autoGuardrailGroups: groups
   });
   flags.notifyMounted();
   if (opts.autoIdentify !== false) {

package/package.json

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