@interfere/react 9.0.2 → 10.0.0

package/dist/internal/plugin-runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-runtime.mjs","names":[],"sources":["../../src/internal/plugin-runtime.ts"],"sourcesContent":["import type { EventType } from \"@interfere/types/sdk/envelope\";\nimport {\n  type ConsentState,\n  PLUGIN_MANIFEST,\n  type PluginKey,\n} from \"@interfere/types/sdk/plugins/manifest\";\nimport {\n  EVENT_TYPE_TO_PLUGIN,\n  type RemotePluginConfig,\n} from \"@interfere/types/sdk/remote-config\";\n\nimport errorsPlugin from \"../plugins/errors.js\";\nimport {\n  loadPlugin,\n  type PluginOverrides,\n  resolveFeatures,\n} from \"../plugins/lib/loader.js\";\nimport type { PluginCleanup, PluginContext } from \"../plugins/lib/types.js\";\nimport { createLogger } from \"../util/log.js\";\nimport {\n  getPluginConsentCategory,\n  hasConsentChanged,\n  isConsentAllowed,\n  resolveGrantedConsent,\n  shouldCaptureEvent,\n} from \"./consent.js\";\n\nconst log = createLogger(\"plugin-runtime\");\n\nexport class PluginRuntime {\n  private readonly activeCleanups = new Map<PluginKey, PluginCleanup>();\n  private readonly pending = new Set<Promise<void>>();\n  private readonly context: PluginContext;\n  private readonly features: Record<PluginKey, boolean>;\n  private remoteConfig: RemotePluginConfig = {};\n  private consentState: ConsentState | null;\n  private syncVersion = 0;\n  private disposed = false;\n\n  constructor(\n    context: PluginContext,\n    overrides: PluginOverrides | undefined,\n    initialConsent: ConsentState | undefined\n  ) {\n    this.context = context;\n    this.features = resolveFeatures(overrides);\n    this.consentState = initialConsent ?? null;\n  }\n\n  getConsent(): ConsentState | null {\n    return this.consentState;\n  }\n\n  setConsent(nextConsent?: ConsentState): void {\n    const nextState = resolveGrantedConsent(nextConsent);\n    if (!hasConsentChanged(this.consentState, nextState)) {\n      return;\n    }\n\n    this.consentState = nextState;\n    this.sync();\n  }\n\n  resetConsent(): void {\n    if (!hasConsentChanged(this.consentState, null)) {\n      return;\n    }\n\n    this.consentState = null;\n    this.sync();\n  }\n\n  applyRemoteConfig(config: RemotePluginConfig): void {\n    this.remoteConfig = config;\n    this.sync();\n  }\n\n  canCapture(type: EventType): boolean {\n    const plugin = EVENT_TYPE_TO_PLUGIN[type];\n    if (plugin && this.remoteConfig[plugin] === false) {\n      return false;\n    }\n    return shouldCaptureEvent(type, this.consentState);\n  }\n\n  start(): void {\n    if (this.shouldEnablePlugin(\"errors\")) {\n      const cleanup = errorsPlugin.setup(this.context);\n      if (cleanup) {\n        this.activeCleanups.set(\"errors\", cleanup);\n      }\n    }\n\n    this.sync();\n  }\n\n  async dispose(): Promise<void> {\n    this.disposed = true;\n    this.syncVersion += 1;\n\n    for (const key of this.activeCleanups.keys()) {\n      this.deactivate(key);\n    }\n\n    await Promise.allSettled(this.pending);\n  }\n\n  private shouldEnablePlugin(key: PluginKey): boolean {\n    return (\n      this.features[key] &&\n      this.remoteConfig[key] !== false &&\n      isConsentAllowed(getPluginConsentCategory(key), this.consentState)\n    );\n  }\n\n  private deactivate(key: PluginKey): void {\n    const cleanup = this.activeCleanups.get(key);\n    if (!cleanup) {\n      return;\n    }\n\n    try {\n      cleanup();\n    } catch {\n      log.warn(\"cleanup failed for %s\", key);\n    }\n\n    this.activeCleanups.delete(key);\n  }\n\n  private async activate(key: PluginKey): Promise<void> {\n    if (this.activeCleanups.has(key) || !this.shouldEnablePlugin(key)) {\n      return;\n    }\n\n    const version = this.syncVersion;\n    const cleanup = await loadPlugin(key, this.context);\n    if (!cleanup) {\n      return;\n    }\n\n    const staleSync = version !== this.syncVersion;\n    if (staleSync || !this.shouldEnablePlugin(key)) {\n      cleanup();\n      return;\n    }\n\n    this.activeCleanups.set(key, cleanup);\n  }\n\n  private sync(): void {\n    if (this.disposed) {\n      return;\n    }\n\n    this.syncVersion += 1;\n\n    for (const plugin of PLUGIN_MANIFEST) {\n      if (this.shouldEnablePlugin(plugin.name)) {\n        if (plugin.name === \"errors\") {\n          if (!this.activeCleanups.has(\"errors\")) {\n            const cleanup = errorsPlugin.setup(this.context);\n            if (cleanup) {\n              this.activeCleanups.set(\"errors\", cleanup);\n            }\n          }\n          continue;\n        }\n\n        const p = this.activate(plugin.name).catch(() => {\n          log.warn(\"non-critical plugin loading failed\");\n        });\n        this.pending.add(p);\n        p.finally(() => this.pending.delete(p));\n        continue;\n      }\n\n      this.deactivate(plugin.name);\n    }\n  }\n}\n"],"mappings":";;;;;;;AA2BA,MAAM,MAAM,aAAa,iBAAiB;AAE1C,IAAa,gBAAb,MAA2B;CACzB,iCAAkC,IAAI,KAA+B;CACrE,0BAA2B,IAAI,KAAoB;CACnD;CACA;CACA,eAA2C,EAAE;CAC7C;CACA,cAAsB;CACtB,WAAmB;CAEnB,YACE,SACA,WACA,gBACA;AACA,OAAK,UAAU;AACf,OAAK,WAAW,gBAAgB,UAAU;AAC1C,OAAK,eAAe,kBAAkB;;CAGxC,aAAkC;AAChC,SAAO,KAAK;;CAGd,WAAW,aAAkC;EAC3C,MAAM,YAAY,sBAAsB,YAAY;AACpD,MAAI,CAAC,kBAAkB,KAAK,cAAc,UAAU,CAClD;AAGF,OAAK,eAAe;AACpB,OAAK,MAAM;;CAGb,eAAqB;AACnB,MAAI,CAAC,kBAAkB,KAAK,cAAc,KAAK,CAC7C;AAGF,OAAK,eAAe;AACpB,OAAK,MAAM;;CAGb,kBAAkB,QAAkC;AAClD,OAAK,eAAe;AACpB,OAAK,MAAM;;CAGb,WAAW,MAA0B;EACnC,MAAM,SAAS,qBAAqB;AACpC,MAAI,UAAU,KAAK,aAAa,YAAY,MAC1C,QAAO;AAET,SAAO,mBAAmB,MAAM,KAAK,aAAa;;CAGpD,QAAc;AACZ,MAAI,KAAK,mBAAmB,SAAS,EAAE;GACrC,MAAM,UAAU,aAAa,MAAM,KAAK,QAAQ;AAChD,OAAI,QACF,MAAK,eAAe,IAAI,UAAU,QAAQ;;AAI9C,OAAK,MAAM;;CAGb,MAAM,UAAyB;AAC7B,OAAK,WAAW;AAChB,OAAK,eAAe;AAEpB,OAAK,MAAM,OAAO,KAAK,eAAe,MAAM,CAC1C,MAAK,WAAW,IAAI;AAGtB,QAAM,QAAQ,WAAW,KAAK,QAAQ;;CAGxC,mBAA2B,KAAyB;AAClD,SACE,KAAK,SAAS,QACd,KAAK,aAAa,SAAS,SAC3B,iBAAiB,yBAAyB,IAAI,EAAE,KAAK,aAAa;;CAItE,WAAmB,KAAsB;EACvC,MAAM,UAAU,KAAK,eAAe,IAAI,IAAI;AAC5C,MAAI,CAAC,QACH;AAGF,MAAI;AACF,YAAS;UACH;AACN,OAAI,KAAK,yBAAyB,IAAI;;AAGxC,OAAK,eAAe,OAAO,IAAI;;CAGjC,MAAc,SAAS,KAA+B;AACpD,MAAI,KAAK,eAAe,IAAI,IAAI,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAC/D;EAGF,MAAM,UAAU,KAAK;EACrB,MAAM,UAAU,MAAM,WAAW,KAAK,KAAK,QAAQ;AACnD,MAAI,CAAC,QACH;AAIF,MADkB,YAAY,KAAK,eAClB,CAAC,KAAK,mBAAmB,IAAI,EAAE;AAC9C,YAAS;AACT;;AAGF,OAAK,eAAe,IAAI,KAAK,QAAQ;;CAGvC,OAAqB;AACnB,MAAI,KAAK,SACP;AAGF,OAAK,eAAe;AAEpB,OAAK,MAAM,UAAU,iBAAiB;AACpC,OAAI,KAAK,mBAAmB,OAAO,KAAK,EAAE;AACxC,QAAI,OAAO,SAAS,UAAU;AAC5B,SAAI,CAAC,KAAK,eAAe,IAAI,SAAS,EAAE;MACtC,MAAM,UAAU,aAAa,MAAM,KAAK,QAAQ;AAChD,UAAI,QACF,MAAK,eAAe,IAAI,UAAU,QAAQ;;AAG9C;;IAGF,MAAM,IAAI,KAAK,SAAS,OAAO,KAAK,CAAC,YAAY;AAC/C,SAAI,KAAK,qCAAqC;MAC9C;AACF,SAAK,QAAQ,IAAI,EAAE;AACnB,MAAE,cAAc,KAAK,QAAQ,OAAO,EAAE,CAAC;AACvC;;AAGF,QAAK,WAAW,OAAO,KAAK"}
+{"version":3,"file":"plugin-runtime.mjs","names":[],"sources":["../../src/internal/plugin-runtime.ts"],"sourcesContent":["import {\n  type ConsentState,\n  PLUGIN_MANIFEST,\n  type PluginKey,\n} from \"@interfere/types/sdk/plugins/manifest\";\nimport type { RemotePluginConfig } from \"@interfere/types/sdk/remote-config\";\n\nimport errorsPlugin from \"../plugins/errors.js\";\nimport {\n  loadPlugin,\n  type PluginOverrides,\n  resolveFeatures,\n} from \"../plugins/lib/loader.js\";\nimport type { PluginCleanup, PluginContext } from \"../plugins/lib/types.js\";\nimport { createLogger } from \"../util/log.js\";\nimport {\n  getPluginConsentCategory,\n  hasConsentChanged,\n  isConsentAllowed,\n  resolveGrantedConsent,\n} from \"./consent.js\";\n\nconst log = createLogger(\"plugin-runtime\");\n\nexport class PluginRuntime {\n  private readonly activeCleanups = new Map<PluginKey, PluginCleanup>();\n  private readonly pending = new Set<Promise<void>>();\n  private readonly context: PluginContext;\n  private readonly features: Record<PluginKey, boolean>;\n  private remoteConfig: RemotePluginConfig = {};\n  private consentState: ConsentState | null;\n  private syncVersion = 0;\n  private disposed = false;\n\n  constructor(\n    context: PluginContext,\n    overrides: PluginOverrides | undefined,\n    initialConsent: ConsentState | undefined\n  ) {\n    this.context = context;\n    this.features = resolveFeatures(overrides);\n    this.consentState = initialConsent ?? null;\n  }\n\n  getConsent(): ConsentState | null {\n    return this.consentState;\n  }\n\n  setConsent(nextConsent?: ConsentState): void {\n    const nextState = resolveGrantedConsent(nextConsent);\n    if (!hasConsentChanged(this.consentState, nextState)) {\n      return;\n    }\n\n    this.consentState = nextState;\n    this.sync();\n  }\n\n  resetConsent(): void {\n    if (!hasConsentChanged(this.consentState, null)) {\n      return;\n    }\n\n    this.consentState = null;\n    this.sync();\n  }\n\n  applyRemoteConfig(config: RemotePluginConfig): void {\n    this.remoteConfig = config;\n    this.sync();\n  }\n\n  start(): void {\n    if (this.shouldEnablePlugin(\"errors\")) {\n      const cleanup = errorsPlugin.setup(this.context);\n      if (cleanup) {\n        this.activeCleanups.set(\"errors\", cleanup);\n      }\n    }\n\n    this.sync();\n  }\n\n  async dispose(): Promise<void> {\n    this.disposed = true;\n    this.syncVersion += 1;\n\n    for (const key of this.activeCleanups.keys()) {\n      this.deactivate(key);\n    }\n\n    await Promise.allSettled(this.pending);\n  }\n\n  private shouldEnablePlugin(key: PluginKey): boolean {\n    return (\n      this.features[key] &&\n      this.remoteConfig[key] !== false &&\n      isConsentAllowed(getPluginConsentCategory(key), this.consentState)\n    );\n  }\n\n  private deactivate(key: PluginKey): void {\n    const cleanup = this.activeCleanups.get(key);\n    if (!cleanup) {\n      return;\n    }\n\n    try {\n      cleanup();\n    } catch {\n      log.warn(\"cleanup failed for %s\", key);\n    }\n\n    this.activeCleanups.delete(key);\n  }\n\n  private async activate(key: PluginKey): Promise<void> {\n    if (this.activeCleanups.has(key) || !this.shouldEnablePlugin(key)) {\n      return;\n    }\n\n    const version = this.syncVersion;\n    const cleanup = await loadPlugin(key, this.context);\n    if (!cleanup) {\n      return;\n    }\n\n    const staleSync = version !== this.syncVersion;\n    if (staleSync || !this.shouldEnablePlugin(key)) {\n      cleanup();\n      return;\n    }\n\n    this.activeCleanups.set(key, cleanup);\n  }\n\n  private sync(): void {\n    if (this.disposed) {\n      return;\n    }\n\n    this.syncVersion += 1;\n\n    for (const plugin of PLUGIN_MANIFEST) {\n      if (this.shouldEnablePlugin(plugin.name)) {\n        if (plugin.name === \"errors\") {\n          if (!this.activeCleanups.has(\"errors\")) {\n            const cleanup = errorsPlugin.setup(this.context);\n            if (cleanup) {\n              this.activeCleanups.set(\"errors\", cleanup);\n            }\n          }\n          continue;\n        }\n\n        const p = this.activate(plugin.name).catch(() => {\n          log.warn(\"non-critical plugin loading failed\");\n        });\n        this.pending.add(p);\n        p.finally(() => this.pending.delete(p));\n        continue;\n      }\n\n      this.deactivate(plugin.name);\n    }\n  }\n}\n"],"mappings":";;;;;;AAsBA,MAAM,MAAM,aAAa,iBAAiB;AAE1C,IAAa,gBAAb,MAA2B;CACzB,iCAAkC,IAAI,KAA+B;CACrE,0BAA2B,IAAI,KAAoB;CACnD;CACA;CACA,eAA2C,EAAE;CAC7C;CACA,cAAsB;CACtB,WAAmB;CAEnB,YACE,SACA,WACA,gBACA;EACA,KAAK,UAAU;EACf,KAAK,WAAW,gBAAgB,UAAU;EAC1C,KAAK,eAAe,kBAAkB;;CAGxC,aAAkC;EAChC,OAAO,KAAK;;CAGd,WAAW,aAAkC;EAC3C,MAAM,YAAY,sBAAsB,YAAY;EACpD,IAAI,CAAC,kBAAkB,KAAK,cAAc,UAAU,EAClD;EAGF,KAAK,eAAe;EACpB,KAAK,MAAM;;CAGb,eAAqB;EACnB,IAAI,CAAC,kBAAkB,KAAK,cAAc,KAAK,EAC7C;EAGF,KAAK,eAAe;EACpB,KAAK,MAAM;;CAGb,kBAAkB,QAAkC;EAClD,KAAK,eAAe;EACpB,KAAK,MAAM;;CAGb,QAAc;EACZ,IAAI,KAAK,mBAAmB,SAAS,EAAE;GACrC,MAAM,UAAU,aAAa,MAAM,KAAK,QAAQ;GAChD,IAAI,SACF,KAAK,eAAe,IAAI,UAAU,QAAQ;;EAI9C,KAAK,MAAM;;CAGb,MAAM,UAAyB;EAC7B,KAAK,WAAW;EAChB,KAAK,eAAe;EAEpB,KAAK,MAAM,OAAO,KAAK,eAAe,MAAM,EAC1C,KAAK,WAAW,IAAI;EAGtB,MAAM,QAAQ,WAAW,KAAK,QAAQ;;CAGxC,mBAA2B,KAAyB;EAClD,OACE,KAAK,SAAS,QACd,KAAK,aAAa,SAAS,SAC3B,iBAAiB,yBAAyB,IAAI,EAAE,KAAK,aAAa;;CAItE,WAAmB,KAAsB;EACvC,MAAM,UAAU,KAAK,eAAe,IAAI,IAAI;EAC5C,IAAI,CAAC,SACH;EAGF,IAAI;GACF,SAAS;UACH;GACN,IAAI,KAAK,yBAAyB,IAAI;;EAGxC,KAAK,eAAe,OAAO,IAAI;;CAGjC,MAAc,SAAS,KAA+B;EACpD,IAAI,KAAK,eAAe,IAAI,IAAI,IAAI,CAAC,KAAK,mBAAmB,IAAI,EAC/D;EAGF,MAAM,UAAU,KAAK;EACrB,MAAM,UAAU,MAAM,WAAW,KAAK,KAAK,QAAQ;EACnD,IAAI,CAAC,SACH;EAIF,IADkB,YAAY,KAAK,eAClB,CAAC,KAAK,mBAAmB,IAAI,EAAE;GAC9C,SAAS;GACT;;EAGF,KAAK,eAAe,IAAI,KAAK,QAAQ;;CAGvC,OAAqB;EACnB,IAAI,KAAK,UACP;EAGF,KAAK,eAAe;EAEpB,KAAK,MAAM,UAAU,iBAAiB;GACpC,IAAI,KAAK,mBAAmB,OAAO,KAAK,EAAE;IACxC,IAAI,OAAO,SAAS,UAAU;KAC5B,IAAI,CAAC,KAAK,eAAe,IAAI,SAAS,EAAE;MACtC,MAAM,UAAU,aAAa,MAAM,KAAK,QAAQ;MAChD,IAAI,SACF,KAAK,eAAe,IAAI,UAAU,QAAQ;;KAG9C;;IAGF,MAAM,IAAI,KAAK,SAAS,OAAO,KAAK,CAAC,YAAY;KAC/C,IAAI,KAAK,qCAAqC;MAC9C;IACF,KAAK,QAAQ,IAAI,EAAE;IACnB,EAAE,cAAc,KAAK,QAAQ,OAAO,EAAE,CAAC;IACvC;;GAGF,KAAK,WAAW,OAAO,KAAK"}

package/dist/internal/react-context.d.mts

@@ -0,0 +1,45 @@
+import { Kernel } from "./kernel.mjs";
+import * as _$react from "react";
+import { ConsentState } from "@interfere/types/sdk/plugins/manifest";
+import { IdentifyParams } from "@interfere/types/sdk/identify";
+
+//#region src/internal/react-context.d.ts
+interface InterfereContextValue {
+  consent: {
+    get(): ConsentState | null;
+    set(state?: ConsentState): void;
+  };
+  device: {
+    getDeviceId(): string | null;
+    getFpHash(): string | null;
+  };
+  identity: {
+    get(): IdentifyParams | null;
+    set(params: IdentifyParams): Promise<void>;
+  };
+  /**
+   * The active kernel, or `null` when the SDK isn't initialized yet — for
+   * example during server-side prerender, when `init()` is client-only.
+   * Accessor objects (consent/device/identity/session) above stay safe to
+   * call in either state; they no-op when the kernel is null.
+   */
+  kernel: Kernel | null;
+  session: {
+    getId(): string | null;
+    getWindowId(): string | null;
+  };
+}
+/**
+ * Context value used when the provider is mounted without a kernel — every
+ * accessor returns `null` and mutations are no-ops. Lets `useInterfere()`
+ * work seamlessly across SSR/CSR boundaries (server gets nulls, client
+ * gets real values once the kernel resolves).
+ */
+declare const NULL_CONTEXT_VALUE: InterfereContextValue;
+/**
+ * Lives in its own module so `provider.tsx` and `internal/capture-boundary.tsx`
+ * can both import it without forming an import cycle.
+ */
+declare const InterfereContext: _$react.Context<InterfereContextValue | null>;
+//#endregion
+export { InterfereContext, InterfereContextValue, NULL_CONTEXT_VALUE };

package/dist/internal/react-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-context.d.mts","names":[],"sources":["../../src/internal/react-context.ts"],"mappings":";;;;;;UASiB,qBAAA;EACf,OAAA;IACE,GAAA,IAAO,YAAA;IACP,GAAA,CAAI,KAAA,GAAQ,YAAA;EAAA;EAEd,MAAA;IACE,WAAA;IACA,SAAA;EAAA;EAEF,QAAA;IACE,GAAA,IAAO,cAAA;IACP,GAAA,CAAI,MAAA,EAAQ,cAAA,GAAiB,OAAA;EAAA;EAQjB;;;;;;EAAd,MAAA,EAAQ,MAAA;EACR,OAAA;IACE,KAAA;IACA,WAAA;EAAA;AAAA;;;;;;;cAkBS,kBAAA,EAAoB,qBAAA;;;;;cAYpB,gBAAA,EAAgB,OAAA,CAAA,OAAA,CAAA,qBAAA"}

package/dist/internal/react-context.mjs

@@ -0,0 +1,34 @@
+"use client";
+import { createContext } from "react";
+/**
+* Context value used when the provider is mounted without a kernel — every
+* accessor returns `null` and mutations are no-ops. Lets `useInterfere()`
+* work seamlessly across SSR/CSR boundaries (server gets nulls, client
+* gets real values once the kernel resolves).
+*/
+const NULL_CONTEXT_VALUE = {
+	consent: {
+		get: () => null,
+		set: () => void 0
+	},
+	device: {
+		getDeviceId: () => null,
+		getFpHash: () => null
+	},
+	identity: {
+		get: () => null,
+		set: () => Promise.resolve()
+	},
+	kernel: null,
+	session: {
+		getId: () => null,
+		getWindowId: () => null
+	}
+};
+/**
+* Lives in its own module so `provider.tsx` and `internal/capture-boundary.tsx`
+* can both import it without forming an import cycle.
+*/
+const InterfereContext = createContext(null);
+//#endregion
+export { InterfereContext, NULL_CONTEXT_VALUE };

package/dist/internal/react-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-context.mjs","names":[],"sources":["../../src/internal/react-context.ts"],"sourcesContent":["\"use client\";\n\nimport type { IdentifyParams } from \"@interfere/types/sdk/identify\";\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport { createContext } from \"react\";\n\nimport type { Kernel } from \"./kernel.js\";\n\nexport interface InterfereContextValue {\n  consent: {\n    get(): ConsentState | null;\n    set(state?: ConsentState): void;\n  };\n  device: {\n    getDeviceId(): string | null;\n    getFpHash(): string | null;\n  };\n  identity: {\n    get(): IdentifyParams | null;\n    set(params: IdentifyParams): Promise<void>;\n  };\n  /**\n   * The active kernel, or `null` when the SDK isn't initialized yet — for\n   * example during server-side prerender, when `init()` is client-only.\n   * Accessor objects (consent/device/identity/session) above stay safe to\n   * call in either state; they no-op when the kernel is null.\n   */\n  kernel: Kernel | null;\n  session: {\n    getId(): string | null;\n    getWindowId(): string | null;\n  };\n}\n\nconst NULL_CONSENT = { get: () => null, set: () => undefined };\nconst NULL_DEVICE = { getDeviceId: () => null, getFpHash: () => null };\nconst NULL_IDENTITY = {\n  get: () => null,\n  set: () => Promise.resolve(),\n};\nconst NULL_SESSION = { getId: () => null, getWindowId: () => null };\n\n/**\n * Context value used when the provider is mounted without a kernel — every\n * accessor returns `null` and mutations are no-ops. Lets `useInterfere()`\n * work seamlessly across SSR/CSR boundaries (server gets nulls, client\n * gets real values once the kernel resolves).\n */\nexport const NULL_CONTEXT_VALUE: InterfereContextValue = {\n  consent: NULL_CONSENT,\n  device: NULL_DEVICE,\n  identity: NULL_IDENTITY,\n  kernel: null,\n  session: NULL_SESSION,\n};\n\n/**\n * Lives in its own module so `provider.tsx` and `internal/capture-boundary.tsx`\n * can both import it without forming an import cycle.\n */\nexport const InterfereContext = createContext<InterfereContextValue | null>(\n  null\n);\n"],"mappings":";;;;;;;;AAiDA,MAAa,qBAA4C;CACvD,SAAS;EAfY,WAAW;EAAM,WAAW,KAAA;EAexC;CACT,QAAQ;EAfY,mBAAmB;EAAM,iBAAiB;EAetD;CACR,UAAU;EAdV,WAAW;EACX,WAAW,QAAQ,SAAS;EAalB;CACV,QAAQ;CACR,SAAS;EAbY,aAAa;EAAM,mBAAmB;EAalD;CACV;;;;;AAMD,MAAa,mBAAmB,cAC9B,KACD"}

package/dist/internal/sw.d.mts

@@ -1,4 +1,24 @@
 //#region src/internal/sw.d.ts
-declare function registerServiceWorker(): void;
+interface SwRegistrationOptions {
+  /**
+   * Optional hook to bridge SW → kernel telemetry. The SW posts
+   * `{ type: "interfere.sw.queued" | ... }` messages back to the
+   * page when it queues, replays, or drops a request; if provided,
+   * this fires for each one so the kernel can record an OTel span
+   * event.
+   */
+  onMessage?: (message: SwMessage) => void;
+}
+interface SwMessage {
+  reason?: string;
+  type: "interfere.sw.queued" | "interfere.sw.replayed" | "interfere.sw.dropped";
+  url: string;
+}
+/**
+ * Best-effort: never throws, never blocks. SW registration is a
+ * page-load-time durability bonus; if it fails, the SDK falls back to
+ * direct fetch and behaves exactly like 9.x did.
+ */
+declare function registerServiceWorker(opts?: SwRegistrationOptions): Promise<void>;
 //#endregion
-export { registerServiceWorker };
+export { SwMessage, SwRegistrationOptions, registerServiceWorker };

package/dist/internal/sw.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sw.d.mts","names":[],"sources":["../../src/internal/sw.ts"],"mappings":";iBAMgB,qBAAA,CAAA"}
+{"version":3,"file":"sw.d.mts","names":[],"sources":["../../src/internal/sw.ts"],"mappings":";UAMiB,qBAAA;EAAA;;;;;;;EAQf,SAAA,IAAa,OAAA,EAAS,SAAA;AAAA;AAAA,UAGP,SAAA;EACf,MAAA;EACA,IAAA;EAIA,GAAA;AAAA;;;;;AAQF;iBAAsB,qBAAA,CACpB,IAAA,GAAM,qBAAA,GACL,OAAA"}

package/dist/internal/sw.mjs

@@ -1,10 +1,37 @@
 import { createLogger } from "../util/log.mjs";
+import { resolveRoutePrefix } from "@interfere/constants/route-prefix";
 //#region src/internal/sw.ts
 const log = createLogger("sw");
-const SW_PATH = "/api/interfere/sw";
-function registerServiceWorker() {
+/**
+* Best-effort: never throws, never blocks. SW registration is a
+* page-load-time durability bonus; if it fails, the SDK falls back to
+* direct fetch and behaves exactly like 9.x did.
+*/
+async function registerServiceWorker(opts = {}) {
 	if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) return;
-	navigator.serviceWorker.register(SW_PATH, { scope: "/api/interfere/" }).then(() => log.debug("registered")).catch(() => log.warn("registration failed, using direct fetch"));
+	const prefix = resolveRoutePrefix();
+	const swPath = `${prefix}/sw`;
+	const swScope = `${prefix}/`;
+	try {
+		await navigator.serviceWorker.register(swPath, { scope: swScope });
+		log.debug("registered at %s (scope %s)", swPath, swScope);
+	} catch (err) {
+		log.warn("registration failed, falling back to direct fetch", err);
+		return;
+	}
+	if (opts.onMessage) {
+		const handler = (event) => {
+			const data = event.data;
+			if (!isSwMessage(data)) return;
+			opts.onMessage?.(data);
+		};
+		navigator.serviceWorker.addEventListener("message", handler);
+	}
+}
+function isSwMessage(value) {
+	if (!value || typeof value !== "object") return false;
+	const v = value;
+	return (v["type"] === "interfere.sw.queued" || v["type"] === "interfere.sw.replayed" || v["type"] === "interfere.sw.dropped") && typeof v["url"] === "string";
 }
 //#endregion
 export { registerServiceWorker };

package/dist/internal/sw.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sw.mjs","names":[],"sources":["../../src/internal/sw.ts"],"sourcesContent":["import { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"sw\");\n\nconst SW_PATH = \"/api/interfere/sw\";\n\nexport function registerServiceWorker(): void {\n  if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n    return;\n  }\n\n  navigator.serviceWorker\n    .register(SW_PATH, { scope: \"/api/interfere/\" })\n    .then(() => log.debug(\"registered\"))\n    .catch(() => log.warn(\"registration failed, using direct fetch\"));\n}\n"],"mappings":";;AAEA,MAAM,MAAM,aAAa,KAAK;AAE9B,MAAM,UAAU;AAEhB,SAAgB,wBAA8B;AAC5C,KAAI,OAAO,cAAc,eAAe,EAAE,mBAAmB,WAC3D;AAGF,WAAU,cACP,SAAS,SAAS,EAAE,OAAO,mBAAmB,CAAC,CAC/C,WAAW,IAAI,MAAM,aAAa,CAAC,CACnC,YAAY,IAAI,KAAK,0CAA0C,CAAC"}
+{"version":3,"file":"sw.mjs","names":[],"sources":["../../src/internal/sw.ts"],"sourcesContent":["import { resolveRoutePrefix } from \"@interfere/constants/route-prefix\";\n\nimport { createLogger } from \"../util/log.js\";\n\nconst log = createLogger(\"sw\");\n\nexport interface SwRegistrationOptions {\n  /**\n   * Optional hook to bridge SW → kernel telemetry. The SW posts\n   * `{ type: \"interfere.sw.queued\" | ... }` messages back to the\n   * page when it queues, replays, or drops a request; if provided,\n   * this fires for each one so the kernel can record an OTel span\n   * event.\n   */\n  onMessage?: (message: SwMessage) => void;\n}\n\nexport interface SwMessage {\n  reason?: string;\n  type:\n    | \"interfere.sw.queued\"\n    | \"interfere.sw.replayed\"\n    | \"interfere.sw.dropped\";\n  url: string;\n}\n\n/**\n * Best-effort: never throws, never blocks. SW registration is a\n * page-load-time durability bonus; if it fails, the SDK falls back to\n * direct fetch and behaves exactly like 9.x did.\n */\nexport async function registerServiceWorker(\n  opts: SwRegistrationOptions = {}\n): Promise<void> {\n  if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n    return;\n  }\n\n  // Customers can override the proxy mount point via\n  // `NEXT_PUBLIC_INTERFERE_ROUTE_PREFIX` (homepage / dashboard both do\n  // this). Hardcoding `/api/interfere/sw` would 404 on those surfaces\n  // and Chrome stalls the install handler when the SW script can't be\n  // fetched, so we resolve the same prefix the rest of the SDK uses.\n  const prefix = resolveRoutePrefix();\n  const swPath = `${prefix}/sw`;\n  const swScope = `${prefix}/`;\n\n  try {\n    await navigator.serviceWorker.register(swPath, { scope: swScope });\n    log.debug(\"registered at %s (scope %s)\", swPath, swScope);\n  } catch (err) {\n    log.warn(\"registration failed, falling back to direct fetch\", err);\n    return;\n  }\n\n  if (opts.onMessage) {\n    const handler = (event: MessageEvent<unknown>) => {\n      const data = event.data;\n      if (!isSwMessage(data)) {\n        return;\n      }\n      opts.onMessage?.(data);\n    };\n    navigator.serviceWorker.addEventListener(\"message\", handler);\n  }\n}\n\nfunction isSwMessage(value: unknown): value is SwMessage {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const v = value as Record<string, unknown>;\n  return (\n    (v[\"type\"] === \"interfere.sw.queued\" ||\n      v[\"type\"] === \"interfere.sw.replayed\" ||\n      v[\"type\"] === \"interfere.sw.dropped\") &&\n    typeof v[\"url\"] === \"string\"\n  );\n}\n"],"mappings":";;;AAIA,MAAM,MAAM,aAAa,KAAK;;;;;;AA2B9B,eAAsB,sBACpB,OAA8B,EAAE,EACjB;CACf,IAAI,OAAO,cAAc,eAAe,EAAE,mBAAmB,YAC3D;CAQF,MAAM,SAAS,oBAAoB;CACnC,MAAM,SAAS,GAAG,OAAO;CACzB,MAAM,UAAU,GAAG,OAAO;CAE1B,IAAI;EACF,MAAM,UAAU,cAAc,SAAS,QAAQ,EAAE,OAAO,SAAS,CAAC;EAClE,IAAI,MAAM,+BAA+B,QAAQ,QAAQ;UAClD,KAAK;EACZ,IAAI,KAAK,qDAAqD,IAAI;EAClE;;CAGF,IAAI,KAAK,WAAW;EAClB,MAAM,WAAW,UAAiC;GAChD,MAAM,OAAO,MAAM;GACnB,IAAI,CAAC,YAAY,KAAK,EACpB;GAEF,KAAK,YAAY,KAAK;;EAExB,UAAU,cAAc,iBAAiB,WAAW,QAAQ;;;AAIhE,SAAS,YAAY,OAAoC;CACvD,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B,OAAO;CAET,MAAM,IAAI;CACV,QACG,EAAE,YAAY,yBACb,EAAE,YAAY,2BACd,EAAE,YAAY,2BAChB,OAAO,EAAE,WAAW"}

package/dist/internal/version.d.mts

@@ -1,4 +1,6 @@
 //#region src/internal/version.d.ts
+declare const SDK_NAME: string;
+declare const SDK_VERSION: string;
 declare const PRODUCER_VERSION: string;
 //#endregion
-export { PRODUCER_VERSION };
+export { PRODUCER_VERSION, SDK_NAME, SDK_VERSION };

package/dist/internal/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","names":[],"sources":["../../src/internal/version.ts"],"mappings":";cAEa,gBAAA"}
+{"version":3,"file":"version.d.mts","names":[],"sources":["../../src/internal/version.ts"],"mappings":";cAEa,QAAA;AAAA,cACA,WAAA;AAAA,cACA,gBAAA"}

package/dist/internal/version.mjs

@@ -1,5 +1,7 @@
 import { name, version } from "../package.mjs";
 //#region src/internal/version.ts
-const PRODUCER_VERSION = `${name}@${version}`;
+const SDK_NAME = name;
+const SDK_VERSION = version;
+const PRODUCER_VERSION = `${SDK_NAME}@${SDK_VERSION}`;
 //#endregion
-export { PRODUCER_VERSION };
+export { PRODUCER_VERSION, SDK_NAME, SDK_VERSION };

package/dist/internal/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","names":["pkg.name","pkg.version"],"sources":["../../src/internal/version.ts"],"sourcesContent":["import pkg from \"../../package.json\" with { type: \"json\" };\n\nexport const PRODUCER_VERSION = `${pkg.name}@${pkg.version}`;\n"],"mappings":";;AAEA,MAAa,mBAAmB,GAAGA,KAAS,GAAGC"}
+{"version":3,"file":"version.mjs","names":["pkg.name","pkg.version"],"sources":["../../src/internal/version.ts"],"sourcesContent":["import pkg from \"../../package.json\" with { type: \"json\" };\n\nexport const SDK_NAME = pkg.name;\nexport const SDK_VERSION = pkg.version;\nexport const PRODUCER_VERSION = `${SDK_NAME}@${SDK_VERSION}`;\n"],"mappings":";;AAEA,MAAa,WAAWA;AACxB,MAAa,cAAcC;AAC3B,MAAa,mBAAmB,GAAG,SAAS,GAAG"}

package/dist/internal/wrapper-singleton.d.mts

@@ -0,0 +1,47 @@
+import { Kernel, KernelOptions } from "./kernel.mjs";
+import { ConsentState } from "@interfere/types/sdk/plugins/manifest";
+import { IdentifyParams } from "@interfere/types/sdk/identify";
+
+//#region src/internal/wrapper-singleton.d.ts
+interface WrapperSingleton {
+  close(): Promise<void>;
+  consent: {
+    get(): ConsentState | null;
+    set(value?: ConsentState): void;
+  };
+  getKernel(): Kernel;
+  getKernelOrNull(): Kernel | null;
+  identity: {
+    get(): IdentifyParams | null;
+    set(params: IdentifyParams): Promise<void>;
+  };
+  init(opts?: KernelOptions): Promise<Kernel | null>;
+  subscribeToKernel(listener: () => void): () => void;
+}
+interface WrapperSingletonInput {
+  /**
+   * Surfaced in the "kernel not initialized" error so the message points
+   * customers at the right entry file (e.g. "instrumentation-client" /
+   * "main.ts"). Single concrete fact — no other behavior change.
+   */
+  initEntryName: string;
+  /**
+   * Wrapper SDK identifier injected as the first entry in
+   * `__INTERFERE_SDK_STACK__` (e.g. `@interfere/next@10.0.0`). Threaded
+   * through to the kernel so the OTel resource carries the full stack.
+   */
+  producerVersion: string;
+}
+/**
+ * Per-wrapper kernel-singleton lifecycle. The next/vite/etc wrappers used
+ * to copy the same ~100 lines verbatim (init/close/getKernel/subscribe
+ * /consent/identity); this is the single source of truth so a fix once
+ * applies everywhere.
+ *
+ * Each wrapper holds its own `WrapperSingleton` in module scope so the
+ * kernel is per-wrapper, not per-process. (Microfrontends can run two
+ * different wrappers on the same page; each gets its own kernel.)
+ */
+declare function createWrapperSingleton(input: WrapperSingletonInput): WrapperSingleton;
+//#endregion
+export { WrapperSingleton, WrapperSingletonInput, createWrapperSingleton };

package/dist/internal/wrapper-singleton.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-singleton.d.mts","names":[],"sources":["../../src/internal/wrapper-singleton.ts"],"mappings":";;;;;UAaiB,gBAAA;EACf,KAAA,IAAS,OAAA;EACT,OAAA;IACE,GAAA,IAAO,YAAA;IACP,GAAA,CAAI,KAAA,GAAQ,YAAA;EAAA;EAEd,SAAA,IAAa,MAAA;EACb,eAAA,IAAmB,MAAA;EACnB,QAAA;IACE,GAAA,IAAO,cAAA;IACP,GAAA,CAAI,MAAA,EAAQ,cAAA,GAAiB,OAAA;EAAA;EAE/B,IAAA,CAAK,IAAA,GAAO,aAAA,GAAgB,OAAA,CAAQ,MAAA;EACpC,iBAAA,CAAkB,QAAA;AAAA;AAAA,UAGH,qBAAA;EAJoB;;;;;EAUnC,aAAA;EAnBS;;;;;EAyBT,eAAA;AAAA;;;;;;;;;;;iBAac,sBAAA,CACd,KAAA,EAAO,qBAAA,GACN,gBAAA"}

package/dist/internal/wrapper-singleton.mjs

@@ -0,0 +1,73 @@
+import { registerKernel, unregisterKernel } from "./kernel-registry.mjs";
+import { createKernel, isEnabledByEnvironment } from "./kernel.mjs";
+import { isBotUserAgent } from "../util/bot.mjs";
+//#region src/internal/wrapper-singleton.ts
+/**
+* Per-wrapper kernel-singleton lifecycle. The next/vite/etc wrappers used
+* to copy the same ~100 lines verbatim (init/close/getKernel/subscribe
+* /consent/identity); this is the single source of truth so a fix once
+* applies everywhere.
+*
+* Each wrapper holds its own `WrapperSingleton` in module scope so the
+* kernel is per-wrapper, not per-process. (Microfrontends can run two
+* different wrappers on the same page; each gets its own kernel.)
+*/
+function createWrapperSingleton(input) {
+	let kernel = null;
+	let pending = null;
+	const listeners = /* @__PURE__ */ new Set();
+	function emit() {
+		for (const listener of listeners) listener();
+	}
+	return {
+		init(opts = {}) {
+			if (kernel) return Promise.resolve(kernel);
+			if (pending) return pending;
+			if (!(opts.enabled ?? isEnabledByEnvironment())) return Promise.resolve(null);
+			if (isBotUserAgent()) return Promise.resolve(null);
+			pending = createKernel({ opts: {
+				...opts,
+				_wrapperVersions: [input.producerVersion]
+			} }).then((k) => {
+				kernel = k;
+				if (k) registerKernel(k);
+				emit();
+				return k;
+			}).finally(() => {
+				pending = null;
+			});
+			return pending;
+		},
+		getKernel() {
+			if (!kernel) throw new Error(`Interfere SDK not initialized. Call init() from your ${input.initEntryName} entrypoint.`);
+			return kernel;
+		},
+		getKernelOrNull() {
+			return kernel;
+		},
+		async close() {
+			if (!kernel) return;
+			const previous = kernel;
+			await previous.dispose();
+			kernel = null;
+			unregisterKernel(previous);
+			emit();
+		},
+		subscribeToKernel(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		consent: {
+			get: () => kernel?.consent.get() ?? null,
+			set: (value) => kernel?.consent.set(value)
+		},
+		identity: {
+			get: () => kernel?.identity.get() ?? null,
+			set: (params) => kernel?.identity.set(params) ?? Promise.resolve()
+		}
+	};
+}
+//#endregion
+export { createWrapperSingleton };

package/dist/internal/wrapper-singleton.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-singleton.mjs","names":[],"sources":["../../src/internal/wrapper-singleton.ts"],"sourcesContent":["import type { IdentifyParams } from \"@interfere/types/sdk/identify\";\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport { isBotUserAgent } from \"../util/bot.js\";\nimport {\n  createKernel,\n  isEnabledByEnvironment,\n  type Kernel,\n  type KernelInternalOptions,\n  type KernelOptions,\n} from \"./kernel.js\";\nimport { registerKernel, unregisterKernel } from \"./kernel-registry.js\";\n\nexport interface WrapperSingleton {\n  close(): Promise<void>;\n  consent: {\n    get(): ConsentState | null;\n    set(value?: ConsentState): void;\n  };\n  getKernel(): Kernel;\n  getKernelOrNull(): Kernel | null;\n  identity: {\n    get(): IdentifyParams | null;\n    set(params: IdentifyParams): Promise<void>;\n  };\n  init(opts?: KernelOptions): Promise<Kernel | null>;\n  subscribeToKernel(listener: () => void): () => void;\n}\n\nexport interface WrapperSingletonInput {\n  /**\n   * Surfaced in the \"kernel not initialized\" error so the message points\n   * customers at the right entry file (e.g. \"instrumentation-client\" /\n   * \"main.ts\"). Single concrete fact — no other behavior change.\n   */\n  initEntryName: string;\n  /**\n   * Wrapper SDK identifier injected as the first entry in\n   * `__INTERFERE_SDK_STACK__` (e.g. `@interfere/next@10.0.0`). Threaded\n   * through to the kernel so the OTel resource carries the full stack.\n   */\n  producerVersion: string;\n}\n\n/**\n * Per-wrapper kernel-singleton lifecycle. The next/vite/etc wrappers used\n * to copy the same ~100 lines verbatim (init/close/getKernel/subscribe\n * /consent/identity); this is the single source of truth so a fix once\n * applies everywhere.\n *\n * Each wrapper holds its own `WrapperSingleton` in module scope so the\n * kernel is per-wrapper, not per-process. (Microfrontends can run two\n * different wrappers on the same page; each gets its own kernel.)\n */\nexport function createWrapperSingleton(\n  input: WrapperSingletonInput\n): WrapperSingleton {\n  let kernel: Kernel | null = null;\n  let pending: Promise<Kernel | null> | null = null;\n  const listeners = new Set<() => void>();\n\n  function emit(): void {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  return {\n    init(opts: KernelOptions = {}): Promise<Kernel | null> {\n      if (kernel) {\n        return Promise.resolve(kernel);\n      }\n      if (pending) {\n        return pending;\n      }\n      if (!(opts.enabled ?? isEnabledByEnvironment())) {\n        return Promise.resolve(null);\n      }\n      if (isBotUserAgent()) {\n        return Promise.resolve(null);\n      }\n\n      const internalOpts: KernelInternalOptions = {\n        ...opts,\n        _wrapperVersions: [input.producerVersion],\n      };\n      pending = createKernel({ opts: internalOpts })\n        .then((k) => {\n          kernel = k;\n          if (k) {\n            registerKernel(k);\n          }\n          emit();\n          return k;\n        })\n        .finally(() => {\n          pending = null;\n        });\n\n      return pending;\n    },\n\n    getKernel(): Kernel {\n      if (!kernel) {\n        throw new Error(\n          `Interfere SDK not initialized. Call init() from your ${input.initEntryName} entrypoint.`\n        );\n      }\n      return kernel;\n    },\n\n    getKernelOrNull(): Kernel | null {\n      return kernel;\n    },\n\n    async close(): Promise<void> {\n      if (!kernel) {\n        return;\n      }\n      const previous = kernel;\n      await previous.dispose();\n      kernel = null;\n      unregisterKernel(previous);\n      emit();\n    },\n\n    subscribeToKernel(listener: () => void): () => void {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n\n    consent: {\n      get: () => kernel?.consent.get() ?? null,\n      set: (value) => kernel?.consent.set(value),\n    },\n\n    identity: {\n      get: () => kernel?.identity.get() ?? null,\n      set: (params) => kernel?.identity.set(params) ?? Promise.resolve(),\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAsDA,SAAgB,uBACd,OACkB;CAClB,IAAI,SAAwB;CAC5B,IAAI,UAAyC;CAC7C,MAAM,4BAAY,IAAI,KAAiB;CAEvC,SAAS,OAAa;EACpB,KAAK,MAAM,YAAY,WACrB,UAAU;;CAId,OAAO;EACL,KAAK,OAAsB,EAAE,EAA0B;GACrD,IAAI,QACF,OAAO,QAAQ,QAAQ,OAAO;GAEhC,IAAI,SACF,OAAO;GAET,IAAI,EAAE,KAAK,WAAW,wBAAwB,GAC5C,OAAO,QAAQ,QAAQ,KAAK;GAE9B,IAAI,gBAAgB,EAClB,OAAO,QAAQ,QAAQ,KAAK;GAO9B,UAAU,aAAa,EAAE,MAAM;IAH7B,GAAG;IACH,kBAAkB,CAAC,MAAM,gBAAgB;IAEA,EAAE,CAAC,CAC3C,MAAM,MAAM;IACX,SAAS;IACT,IAAI,GACF,eAAe,EAAE;IAEnB,MAAM;IACN,OAAO;KACP,CACD,cAAc;IACb,UAAU;KACV;GAEJ,OAAO;;EAGT,YAAoB;GAClB,IAAI,CAAC,QACH,MAAM,IAAI,MACR,wDAAwD,MAAM,cAAc,cAC7E;GAEH,OAAO;;EAGT,kBAAiC;GAC/B,OAAO;;EAGT,MAAM,QAAuB;GAC3B,IAAI,CAAC,QACH;GAEF,MAAM,WAAW;GACjB,MAAM,SAAS,SAAS;GACxB,SAAS;GACT,iBAAiB,SAAS;GAC1B,MAAM;;EAGR,kBAAkB,UAAkC;GAClD,UAAU,IAAI,SAAS;GACvB,aAAa;IACX,UAAU,OAAO,SAAS;;;EAI9B,SAAS;GACP,WAAW,QAAQ,QAAQ,KAAK,IAAI;GACpC,MAAM,UAAU,QAAQ,QAAQ,IAAI,MAAM;GAC3C;EAED,UAAU;GACR,WAAW,QAAQ,SAAS,KAAK,IAAI;GACrC,MAAM,WAAW,QAAQ,SAAS,IAAI,OAAO,IAAI,QAAQ,SAAS;GACnE;EACF"}

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
 var name = "@interfere/react";
-var version = "9.0.2";
+var version = "10.0.0";
 //#endregion
 export { name, version };

package/dist/plugins/errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/plugins/errors.ts"],"mappings":";;;cA2Ea,YAAA,EAAc,MAAA"}
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/plugins/errors.ts"],"mappings":";;;cAwDa,YAAA,EAAc,MAAA"}

package/dist/plugins/errors.mjs

@@ -1,5 +1,5 @@
-import { seen } from "../internal/errors.mjs";
-import { MECHANISM_TYPE, shouldDropBrowserExtensionNoise, shouldDropUnresolvableStack, toError, toExceptions } from "@interfere/types/sdk/errors";
+import { onConsoleCall } from "../internal/console-patch.mjs";
+import { MECHANISM_TYPE, isNonErrorException, toException } from "@interfere/types/sdk/errors";
 //#region src/plugins/errors.ts
 /**
 * V8's default stack limit is 10. Deep React trees routinely exceed that
@@ -7,19 +7,11 @@ import { MECHANISM_TYPE, shouldDropBrowserExtensionNoise, shouldDropUnresolvable
 * internals in the captured stack. Matches Sentry's browser SDK.
 */
 const STACK_TRACE_LIMIT = 50;
-let capturing = false;
 function capture(ctx, opts) {
-	if (capturing || seen.has(opts.error)) return;
-	seen.add(opts.error);
-	capturing = true;
-	try {
-		const exceptions = toExceptions(opts.error, opts.mechanism);
-		if (opts.fallbackFrame && exceptions[0]?.frames.length === 0) exceptions[0].frames.push(opts.fallbackFrame);
-		if (shouldDropBrowserExtensionNoise(exceptions) || shouldDropUnresolvableStack(exceptions)) return;
-		ctx.capture("error", { exceptions });
-	} finally {
-		capturing = false;
-	}
+	ctx.recordException(opts.error, {
+		mechanism: opts.mechanism,
+		...opts.fallbackFrame && !isNonErrorException(opts.error) ? { fallbackFrames: [opts.fallbackFrame] } : {}
+	});
 }
 /**
 * Finds the first `Error` instance in a list of `console.error` arguments.
@@ -35,15 +27,15 @@ const errorsPlugin = {
 	name: "errors",
 	setup(ctx) {
 		const originalOnError = globalThis.onerror;
-		const originalConsoleError = globalThis.console.error;
 		const originalStackTraceLimit = Error.stackTraceLimit;
 		if (Error.stackTraceLimit < STACK_TRACE_LIMIT) Error.stackTraceLimit = STACK_TRACE_LIMIT;
 		globalThis.onerror = (msg, source, line, col, error) => {
 			if (error instanceof Error) {
 				const fallbackFrame = typeof source === "string" ? {
-					fileName: source,
-					...typeof line === "number" ? { lineNumber: line } : {},
-					...typeof col === "number" ? { columnNumber: col } : {}
+					id: "fallback-0",
+					file: source,
+					...typeof line === "number" ? { line } : {},
+					...typeof col === "number" ? { column: col } : {}
 				} : null;
 				capture(ctx, {
 					error,
@@ -59,7 +51,7 @@ const errorsPlugin = {
 		};
 		const onUnhandledRejection = (event) => {
 			capture(ctx, {
-				error: toError(event.reason),
+				error: toException(event.reason),
 				mechanism: {
 					type: MECHANISM_TYPE.browser.onunhandledrejection,
 					handled: false,
@@ -67,9 +59,10 @@ const errorsPlugin = {
 				}
 			});
 		};
-		globalThis.addEventListener("unhandledrejection", onUnhandledRejection);
-		globalThis.console.error = (...args) => {
-			originalConsoleError.apply(globalThis.console, args);
+		const supportsEventTarget = typeof globalThis.addEventListener === "function" && typeof globalThis.removeEventListener === "function";
+		if (supportsEventTarget) globalThis.addEventListener("unhandledrejection", onUnhandledRejection);
+		const unsubscribeConsole = onConsoleCall((level, args) => {
+			if (level !== "error") return;
 			const error = findErrorArg(args);
 			if (error) capture(ctx, {
 				error,
@@ -78,12 +71,12 @@ const errorsPlugin = {
 					handled: true
 				}
 			});
-		};
+		});
 		return () => {
 			Error.stackTraceLimit = originalStackTraceLimit;
 			globalThis.onerror = originalOnError;
-			globalThis.removeEventListener("unhandledrejection", onUnhandledRejection);
-			globalThis.console.error = originalConsoleError;
+			if (supportsEventTarget) globalThis.removeEventListener("unhandledrejection", onUnhandledRejection);
+			unsubscribeConsole();
 		};
 	}
 };

package/dist/plugins/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/plugins/errors.ts"],"sourcesContent":["import type { IngestedFrame } from \"@interfere/types/data/frame\";\nimport {\n  MECHANISM_TYPE,\n  shouldDropBrowserExtensionNoise,\n  shouldDropUnresolvableStack,\n  toError,\n  toExceptions,\n} from \"@interfere/types/sdk/errors\";\nimport type { ErrorMechanism } from \"@interfere/types/sdk/plugins/payload/errors\";\n\nimport { seen } from \"../internal/errors.js\";\nimport type { Plugin, PluginContext } from \"./lib/types.js\";\n\n/**\n * V8's default stack limit is 10. Deep React trees routinely exceed that\n * before reaching the actual application frames, leaving only react-dom\n * internals in the captured stack. Matches Sentry's browser SDK.\n */\nconst STACK_TRACE_LIMIT = 50;\n\nlet capturing = false;\n\ninterface CaptureOpts {\n  readonly error: Error;\n  /**\n   * Fallback frame to inject when the parsed stack of the root exception is\n   * empty. Used for `window.onerror` calls where the browser provides\n   * `source`/`line`/`col` even though the Error object itself has a\n   * degenerate stack.\n   */\n  readonly fallbackFrame?: IngestedFrame;\n  readonly mechanism: ErrorMechanism;\n}\n\nfunction capture(ctx: PluginContext, opts: CaptureOpts) {\n  if (capturing || seen.has(opts.error)) {\n    return;\n  }\n\n  seen.add(opts.error);\n  capturing = true;\n  try {\n    const exceptions = toExceptions(opts.error, opts.mechanism);\n\n    if (opts.fallbackFrame && exceptions[0]?.frames.length === 0) {\n      exceptions[0].frames.push(opts.fallbackFrame);\n    }\n\n    if (\n      shouldDropBrowserExtensionNoise(exceptions) ||\n      shouldDropUnresolvableStack(exceptions)\n    ) {\n      return;\n    }\n    ctx.capture(\"error\", { exceptions });\n  } finally {\n    capturing = false;\n  }\n}\n\n/**\n * Finds the first `Error` instance in a list of `console.error` arguments.\n * React 18+ in production logs errors as\n * `console.error(\"The above error occurred in ...\", error, componentStack)`,\n * so scanning only `args[0]` misses React's own uncaught-error reports.\n */\nfunction findErrorArg(args: readonly unknown[]): Error | null {\n  for (const arg of args) {\n    if (arg instanceof Error) {\n      return arg;\n    }\n  }\n  return null;\n}\n\nexport const errorsPlugin: Plugin = {\n  name: \"errors\",\n\n  setup(ctx) {\n    const originalOnError = globalThis.onerror;\n    const originalConsoleError = globalThis.console.error;\n    const originalStackTraceLimit = Error.stackTraceLimit;\n    if (Error.stackTraceLimit < STACK_TRACE_LIMIT) {\n      Error.stackTraceLimit = STACK_TRACE_LIMIT;\n    }\n\n    globalThis.onerror = (msg, source, line, col, error) => {\n      if (error instanceof Error) {\n        const fallbackFrame =\n          typeof source === \"string\"\n            ? {\n                fileName: source,\n                ...(typeof line === \"number\" ? { lineNumber: line } : {}),\n                ...(typeof col === \"number\" ? { columnNumber: col } : {}),\n              }\n            : null;\n\n        capture(ctx, {\n          error,\n          mechanism: { type: MECHANISM_TYPE.browser.onerror, handled: false },\n          ...(fallbackFrame ? { fallbackFrame } : {}),\n        });\n      }\n      if (typeof originalOnError === \"function\") {\n        return originalOnError.call(globalThis, msg, source, line, col, error);\n      }\n      return false;\n    };\n\n    const onUnhandledRejection = (event: PromiseRejectionEvent) => {\n      capture(ctx, {\n        error: toError(event.reason),\n        mechanism: {\n          type: MECHANISM_TYPE.browser.onunhandledrejection,\n          handled: false,\n          ...(event.reason instanceof Error ? {} : { synthetic: true }),\n        },\n      });\n    };\n    globalThis.addEventListener(\"unhandledrejection\", onUnhandledRejection);\n\n    globalThis.console.error = (...args: unknown[]) => {\n      originalConsoleError.apply(globalThis.console, args);\n      const error = findErrorArg(args);\n      if (error) {\n        capture(ctx, {\n          error,\n          mechanism: {\n            type: MECHANISM_TYPE.browser.consoleError,\n            handled: true,\n          },\n        });\n      }\n    };\n\n    return () => {\n      Error.stackTraceLimit = originalStackTraceLimit;\n      globalThis.onerror = originalOnError;\n      globalThis.removeEventListener(\n        \"unhandledrejection\",\n        onUnhandledRejection\n      );\n      globalThis.console.error = originalConsoleError;\n    };\n  },\n};\n\nexport default errorsPlugin;\n"],"mappings":";;;;;;;;AAkBA,MAAM,oBAAoB;AAE1B,IAAI,YAAY;AAchB,SAAS,QAAQ,KAAoB,MAAmB;AACtD,KAAI,aAAa,KAAK,IAAI,KAAK,MAAM,CACnC;AAGF,MAAK,IAAI,KAAK,MAAM;AACpB,aAAY;AACZ,KAAI;EACF,MAAM,aAAa,aAAa,KAAK,OAAO,KAAK,UAAU;AAE3D,MAAI,KAAK,iBAAiB,WAAW,IAAI,OAAO,WAAW,EACzD,YAAW,GAAG,OAAO,KAAK,KAAK,cAAc;AAG/C,MACE,gCAAgC,WAAW,IAC3C,4BAA4B,WAAW,CAEvC;AAEF,MAAI,QAAQ,SAAS,EAAE,YAAY,CAAC;WAC5B;AACR,cAAY;;;;;;;;;AAUhB,SAAS,aAAa,MAAwC;AAC5D,MAAK,MAAM,OAAO,KAChB,KAAI,eAAe,MACjB,QAAO;AAGX,QAAO;;AAGT,MAAa,eAAuB;CAClC,MAAM;CAEN,MAAM,KAAK;EACT,MAAM,kBAAkB,WAAW;EACnC,MAAM,uBAAuB,WAAW,QAAQ;EAChD,MAAM,0BAA0B,MAAM;AACtC,MAAI,MAAM,kBAAkB,kBAC1B,OAAM,kBAAkB;AAG1B,aAAW,WAAW,KAAK,QAAQ,MAAM,KAAK,UAAU;AACtD,OAAI,iBAAiB,OAAO;IAC1B,MAAM,gBACJ,OAAO,WAAW,WACd;KACE,UAAU;KACV,GAAI,OAAO,SAAS,WAAW,EAAE,YAAY,MAAM,GAAG,EAAE;KACxD,GAAI,OAAO,QAAQ,WAAW,EAAE,cAAc,KAAK,GAAG,EAAE;KACzD,GACD;AAEN,YAAQ,KAAK;KACX;KACA,WAAW;MAAE,MAAM,eAAe,QAAQ;MAAS,SAAS;MAAO;KACnE,GAAI,gBAAgB,EAAE,eAAe,GAAG,EAAE;KAC3C,CAAC;;AAEJ,OAAI,OAAO,oBAAoB,WAC7B,QAAO,gBAAgB,KAAK,YAAY,KAAK,QAAQ,MAAM,KAAK,MAAM;AAExE,UAAO;;EAGT,MAAM,wBAAwB,UAAiC;AAC7D,WAAQ,KAAK;IACX,OAAO,QAAQ,MAAM,OAAO;IAC5B,WAAW;KACT,MAAM,eAAe,QAAQ;KAC7B,SAAS;KACT,GAAI,MAAM,kBAAkB,QAAQ,EAAE,GAAG,EAAE,WAAW,MAAM;KAC7D;IACF,CAAC;;AAEJ,aAAW,iBAAiB,sBAAsB,qBAAqB;AAEvE,aAAW,QAAQ,SAAS,GAAG,SAAoB;AACjD,wBAAqB,MAAM,WAAW,SAAS,KAAK;GACpD,MAAM,QAAQ,aAAa,KAAK;AAChC,OAAI,MACF,SAAQ,KAAK;IACX;IACA,WAAW;KACT,MAAM,eAAe,QAAQ;KAC7B,SAAS;KACV;IACF,CAAC;;AAIN,eAAa;AACX,SAAM,kBAAkB;AACxB,cAAW,UAAU;AACrB,cAAW,oBACT,sBACA,qBACD;AACD,cAAW,QAAQ,QAAQ;;;CAGhC"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/plugins/errors.ts"],"sourcesContent":["import type { IngestedFrame } from \"@interfere/types/data/frame\";\nimport {\n  isNonErrorException,\n  MECHANISM_TYPE,\n  type NonErrorException,\n  toException,\n} from \"@interfere/types/sdk/errors\";\nimport type { ErrorMechanism } from \"@interfere/types/sdk/plugins/payload/errors\";\n\nimport { onConsoleCall } from \"../internal/console-patch.js\";\nimport type { Plugin, PluginContext } from \"./lib/types.js\";\n\n/**\n * V8's default stack limit is 10. Deep React trees routinely exceed that\n * before reaching the actual application frames, leaving only react-dom\n * internals in the captured stack. Matches Sentry's browser SDK.\n */\nconst STACK_TRACE_LIMIT = 50;\n\ninterface CaptureOpts {\n  readonly error: Error | NonErrorException;\n  /**\n   * Fallback frame to inject when the parsed stack of the root exception is\n   * empty. Used for `window.onerror` calls where the browser provides\n   * `source`/`line`/`col` even though the Error object itself has a\n   * degenerate stack. Ignored for non-Error captures — there's no stack\n   * to fall back into.\n   */\n  readonly fallbackFrame?: IngestedFrame;\n  readonly mechanism: ErrorMechanism;\n}\n\nfunction capture(ctx: PluginContext, opts: CaptureOpts) {\n  ctx.recordException(opts.error, {\n    mechanism: opts.mechanism,\n    ...(opts.fallbackFrame && !isNonErrorException(opts.error)\n      ? { fallbackFrames: [opts.fallbackFrame] }\n      : {}),\n  });\n}\n\n/**\n * Finds the first `Error` instance in a list of `console.error` arguments.\n * React 18+ in production logs errors as\n * `console.error(\"The above error occurred in ...\", error, componentStack)`,\n * so scanning only `args[0]` misses React's own uncaught-error reports.\n */\nfunction findErrorArg(args: readonly unknown[]): Error | null {\n  for (const arg of args) {\n    if (arg instanceof Error) {\n      return arg;\n    }\n  }\n  return null;\n}\n\nexport const errorsPlugin: Plugin = {\n  name: \"errors\",\n\n  setup(ctx) {\n    const originalOnError = globalThis.onerror;\n    const originalStackTraceLimit = Error.stackTraceLimit;\n    if (Error.stackTraceLimit < STACK_TRACE_LIMIT) {\n      Error.stackTraceLimit = STACK_TRACE_LIMIT;\n    }\n\n    globalThis.onerror = (msg, source, line, col, error) => {\n      if (error instanceof Error) {\n        const fallbackFrame =\n          typeof source === \"string\"\n            ? {\n                id: \"fallback-0\",\n                file: source,\n                ...(typeof line === \"number\" ? { line } : {}),\n                ...(typeof col === \"number\" ? { column: col } : {}),\n              }\n            : null;\n\n        capture(ctx, {\n          error,\n          mechanism: { type: MECHANISM_TYPE.browser.onerror, handled: false },\n          ...(fallbackFrame ? { fallbackFrame } : {}),\n        });\n      }\n      if (typeof originalOnError === \"function\") {\n        return originalOnError.call(globalThis, msg, source, line, col, error);\n      }\n      return false;\n    };\n\n    const onUnhandledRejection = (event: PromiseRejectionEvent) => {\n      // `toException` returns a real Error when the rejection carries a\n      // recoverable one (direct Error, nested Error inside an object, or\n      // a plain string), or a `NonErrorException` carrying the original\n      // structured payload otherwise. The `synthetic: true` flag was\n      // historically a \"we lied about the shape\" tag; with structured\n      // capture it now means \"this isn't a JS Error\" — same intent,\n      // honest signal.\n      capture(ctx, {\n        error: toException(event.reason),\n        mechanism: {\n          type: MECHANISM_TYPE.browser.onunhandledrejection,\n          handled: false,\n          ...(event.reason instanceof Error ? {} : { synthetic: true }),\n        },\n      });\n    };\n    // Some non-browser runtimes (notably Node test forks vitest spawns under\n    // `pool: \"forks\"`) don't expose `addEventListener` on globalThis. Skip the\n    // unhandledrejection hook there rather than crashing plugin setup; the\n    // browser path is unaffected.\n    const supportsEventTarget =\n      typeof globalThis.addEventListener === \"function\" &&\n      typeof globalThis.removeEventListener === \"function\";\n    if (supportsEventTarget) {\n      globalThis.addEventListener(\"unhandledrejection\", onUnhandledRejection);\n    }\n\n    const unsubscribeConsole = onConsoleCall((level, args) => {\n      if (level !== \"error\") {\n        return;\n      }\n      const error = findErrorArg(args);\n      if (error) {\n        capture(ctx, {\n          error,\n          mechanism: {\n            type: MECHANISM_TYPE.browser.consoleError,\n            handled: true,\n          },\n        });\n      }\n    });\n\n    return () => {\n      Error.stackTraceLimit = originalStackTraceLimit;\n      globalThis.onerror = originalOnError;\n      if (supportsEventTarget) {\n        globalThis.removeEventListener(\n          \"unhandledrejection\",\n          onUnhandledRejection\n        );\n      }\n      unsubscribeConsole();\n    };\n  },\n};\n\nexport default errorsPlugin;\n"],"mappings":";;;;;;;;AAiBA,MAAM,oBAAoB;AAe1B,SAAS,QAAQ,KAAoB,MAAmB;CACtD,IAAI,gBAAgB,KAAK,OAAO;EAC9B,WAAW,KAAK;EAChB,GAAI,KAAK,iBAAiB,CAAC,oBAAoB,KAAK,MAAM,GACtD,EAAE,gBAAgB,CAAC,KAAK,cAAc,EAAE,GACxC,EAAE;EACP,CAAC;;;;;;;;AASJ,SAAS,aAAa,MAAwC;CAC5D,KAAK,MAAM,OAAO,MAChB,IAAI,eAAe,OACjB,OAAO;CAGX,OAAO;;AAGT,MAAa,eAAuB;CAClC,MAAM;CAEN,MAAM,KAAK;EACT,MAAM,kBAAkB,WAAW;EACnC,MAAM,0BAA0B,MAAM;EACtC,IAAI,MAAM,kBAAkB,mBAC1B,MAAM,kBAAkB;EAG1B,WAAW,WAAW,KAAK,QAAQ,MAAM,KAAK,UAAU;GACtD,IAAI,iBAAiB,OAAO;IAC1B,MAAM,gBACJ,OAAO,WAAW,WACd;KACE,IAAI;KACJ,MAAM;KACN,GAAI,OAAO,SAAS,WAAW,EAAE,MAAM,GAAG,EAAE;KAC5C,GAAI,OAAO,QAAQ,WAAW,EAAE,QAAQ,KAAK,GAAG,EAAE;KACnD,GACD;IAEN,QAAQ,KAAK;KACX;KACA,WAAW;MAAE,MAAM,eAAe,QAAQ;MAAS,SAAS;MAAO;KACnE,GAAI,gBAAgB,EAAE,eAAe,GAAG,EAAE;KAC3C,CAAC;;GAEJ,IAAI,OAAO,oBAAoB,YAC7B,OAAO,gBAAgB,KAAK,YAAY,KAAK,QAAQ,MAAM,KAAK,MAAM;GAExE,OAAO;;EAGT,MAAM,wBAAwB,UAAiC;GAQ7D,QAAQ,KAAK;IACX,OAAO,YAAY,MAAM,OAAO;IAChC,WAAW;KACT,MAAM,eAAe,QAAQ;KAC7B,SAAS;KACT,GAAI,MAAM,kBAAkB,QAAQ,EAAE,GAAG,EAAE,WAAW,MAAM;KAC7D;IACF,CAAC;;EAMJ,MAAM,sBACJ,OAAO,WAAW,qBAAqB,cACvC,OAAO,WAAW,wBAAwB;EAC5C,IAAI,qBACF,WAAW,iBAAiB,sBAAsB,qBAAqB;EAGzE,MAAM,qBAAqB,eAAe,OAAO,SAAS;GACxD,IAAI,UAAU,SACZ;GAEF,MAAM,QAAQ,aAAa,KAAK;GAChC,IAAI,OACF,QAAQ,KAAK;IACX;IACA,WAAW;KACT,MAAM,eAAe,QAAQ;KAC7B,SAAS;KACV;IACF,CAAC;IAEJ;EAEF,aAAa;GACX,MAAM,kBAAkB;GACxB,WAAW,UAAU;GACrB,IAAI,qBACF,WAAW,oBACT,sBACA,qBACD;GAEH,oBAAoB;;;CAGzB"}

package/dist/plugins/lib/loader.d.mts

@@ -5,6 +5,5 @@ import { PluginKey } from "@interfere/types/sdk/plugins/manifest";
 type PluginOverrides = Partial<Record<PluginKey, boolean>>;
 declare function resolveFeatures(overrides?: PluginOverrides): Record<PluginKey, boolean>;
 declare function loadPlugin(key: PluginKey, context: PluginContext): Promise<PluginCleanup | null>;
-declare function loadPlugins(overrides: PluginOverrides | undefined, context: PluginContext): Promise<PluginCleanup[]>;
 //#endregion
-export { PluginOverrides, loadPlugin, loadPlugins, resolveFeatures };
+export { PluginOverrides, loadPlugin, resolveFeatures };

package/dist/plugins/lib/loader.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.mts","names":[],"sources":["../../../src/plugins/lib/loader.ts"],"mappings":";;;;KAwBY,eAAA,GAAkB,OAAA,CAAQ,MAAA,CAAO,SAAA;AAAA,iBAE7B,eAAA,CACd,SAAA,GAAY,eAAA,GACX,MAAA,CAAO,SAAA;AAAA,iBAUY,UAAA,CACpB,GAAA,EAAK,SAAA,EACL,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,aAAA;AAAA,iBAkBW,WAAA,CACpB,SAAA,EAAW,eAAA,cACX,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"loader.d.mts","names":[],"sources":["../../../src/plugins/lib/loader.ts"],"mappings":";;;;KA4BY,eAAA,GAAkB,OAAA,CAAQ,MAAA,CAAO,SAAA;AAAA,iBAE7B,eAAA,CACd,SAAA,GAAY,eAAA,GACX,MAAA,CAAO,SAAA;AAAA,iBAUY,UAAA,CACpB,GAAA,EAAK,SAAA,EACL,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,aAAA"}

package/dist/plugins/lib/loader.mjs

@@ -4,8 +4,7 @@ import { PLUGIN_MANIFEST } from "@interfere/types/sdk/plugins/manifest";
 const log = createLogger("plugins");
 const LOADERS = {
 	errors: () => import("../errors.mjs"),
-	device: () => import("../device.mjs"),
-	pageEvents: () => import("../pages.mjs"),
+	logs: () => import("../logs.mjs"),
 	rageClick: () => import("../rage-clicks.mjs"),
 	replay: () => import("../replay.mjs")
 };
@@ -31,13 +30,5 @@ async function loadPlugin(key, context) {
 		return null;
 	}
 }
-async function loadPlugins(overrides, context) {
-	const resolved = {
-		...DEFAULTS,
-		...overrides
-	};
-	const keys = Object.entries(resolved).filter(([key, enabled]) => enabled && key in LOADERS).map(([key]) => key);
-	return (await Promise.all(keys.map(async (key) => loadPlugin(key, context)))).filter((cleanup) => cleanup !== null);
-}
 //#endregion
-export { loadPlugin, loadPlugins, resolveFeatures };
+export { loadPlugin, resolveFeatures };

package/dist/plugins/lib/loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader.mjs","names":[],"sources":["../../../src/plugins/lib/loader.ts"],"sourcesContent":["import {\n  PLUGIN_MANIFEST,\n  type PluginKey,\n} from \"@interfere/types/sdk/plugins/manifest\";\n\nimport { createLogger } from \"../../util/log.js\";\nimport type { Plugin, PluginCleanup, PluginContext } from \"./types.js\";\n\nconst log = createLogger(\"plugins\");\n\ntype PluginLoader = () => Promise<{ default: Plugin } | Plugin>;\n\nconst LOADERS: Partial<Record<PluginKey, PluginLoader>> = {\n  errors: () => import(\"../errors.js\"),\n  device: () => import(\"../device.js\"),\n  pageEvents: () => import(\"../pages.js\"),\n  rageClick: () => import(\"../rage-clicks.js\"),\n  replay: () => import(\"../replay.js\"),\n};\n\nconst DEFAULTS: Record<PluginKey, boolean> = Object.fromEntries(\n  PLUGIN_MANIFEST.map((p) => [p.name, p.defaultEnabled])\n) as Record<PluginKey, boolean>;\n\nexport type PluginOverrides = Partial<Record<PluginKey, boolean>>;\n\nexport function resolveFeatures(\n  overrides?: PluginOverrides\n): Record<PluginKey, boolean> {\n  return { ...DEFAULTS, ...overrides };\n}\n\nfunction resolvePlugin(mod: { default: Plugin } | Plugin): Plugin {\n  return \"default\" in mod && typeof (mod.default as Plugin).setup === \"function\"\n    ? mod.default\n    : (mod as Plugin);\n}\n\nexport async function loadPlugin(\n  key: PluginKey,\n  context: PluginContext\n): Promise<PluginCleanup | null> {\n  const loader = LOADERS[key];\n  if (!loader) {\n    return null;\n  }\n\n  try {\n    const mod = await loader();\n    const plugin = resolvePlugin(mod);\n    const cleanup = plugin.setup(context);\n    log.debug(\"loaded %s\", key);\n    return typeof cleanup === \"function\" ? cleanup : null;\n  } catch {\n    log.error(\"failed to load plugin %s\", key);\n    return null;\n  }\n}\n\nexport async function loadPlugins(\n  overrides: PluginOverrides | undefined,\n  context: PluginContext\n): Promise<PluginCleanup[]> {\n  const resolved = { ...DEFAULTS, ...overrides };\n  const keys = (Object.entries(resolved) as [PluginKey, boolean][])\n    .filter(([key, enabled]) => enabled && key in LOADERS)\n    .map(([key]) => key);\n\n  const cleanups = await Promise.all(\n    keys.map(async (key) => loadPlugin(key, context))\n  );\n  return cleanups.filter((cleanup) => cleanup !== null);\n}\n"],"mappings":";;;AAQA,MAAM,MAAM,aAAa,UAAU;AAInC,MAAM,UAAoD;CACxD,cAAc,OAAO;CACrB,cAAc,OAAO;CACrB,kBAAkB,OAAO;CACzB,iBAAiB,OAAO;CACxB,cAAc,OAAO;CACtB;AAED,MAAM,WAAuC,OAAO,YAClD,gBAAgB,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CACvD;AAID,SAAgB,gBACd,WAC4B;AAC5B,QAAO;EAAE,GAAG;EAAU,GAAG;EAAW;;AAGtC,SAAS,cAAc,KAA2C;AAChE,QAAO,aAAa,OAAO,OAAQ,IAAI,QAAmB,UAAU,aAChE,IAAI,UACH;;AAGP,eAAsB,WACpB,KACA,SAC+B;CAC/B,MAAM,SAAS,QAAQ;AACvB,KAAI,CAAC,OACH,QAAO;AAGT,KAAI;EAGF,MAAM,UADS,cAAc,MADX,QAAQ,CAEJ,CAAC,MAAM,QAAQ;AACrC,MAAI,MAAM,aAAa,IAAI;AAC3B,SAAO,OAAO,YAAY,aAAa,UAAU;SAC3C;AACN,MAAI,MAAM,4BAA4B,IAAI;AAC1C,SAAO;;;AAIX,eAAsB,YACpB,WACA,SAC0B;CAC1B,MAAM,WAAW;EAAE,GAAG;EAAU,GAAG;EAAW;CAC9C,MAAM,OAAQ,OAAO,QAAQ,SAAS,CACnC,QAAQ,CAAC,KAAK,aAAa,WAAW,OAAO,QAAQ,CACrD,KAAK,CAAC,SAAS,IAAI;AAKtB,SAAO,MAHgB,QAAQ,IAC7B,KAAK,IAAI,OAAO,QAAQ,WAAW,KAAK,QAAQ,CAAC,CAClD,EACe,QAAQ,YAAY,YAAY,KAAK"}
+{"version":3,"file":"loader.mjs","names":[],"sources":["../../../src/plugins/lib/loader.ts"],"sourcesContent":["import {\n  PLUGIN_MANIFEST,\n  type PluginKey,\n} from \"@interfere/types/sdk/plugins/manifest\";\n\nimport { createLogger } from \"../../util/log.js\";\nimport type { Plugin, PluginCleanup, PluginContext } from \"./types.js\";\n\nconst log = createLogger(\"plugins\");\n\ntype PluginLoader = () => Promise<{ default: Plugin } | Plugin>;\n\n// `pageEvents` from PLUGIN_MANIFEST has no loader: pageviews / clicks /\n// pageleaves are covered by the OTel `BrowserNavigationInstrumentation` +\n// `UserInteractionInstrumentation` auto-instruments instead. The\n// manifest entry stays for the legacy `/v1/ingest` server-side validators\n// (old SDK 9.x clients still emit these envelopes).\nconst LOADERS: Partial<Record<PluginKey, PluginLoader>> = {\n  errors: () => import(\"../errors.js\"),\n  logs: () => import(\"../logs.js\"),\n  rageClick: () => import(\"../rage-clicks.js\"),\n  replay: () => import(\"../replay.js\"),\n};\n\nconst DEFAULTS: Record<PluginKey, boolean> = Object.fromEntries(\n  PLUGIN_MANIFEST.map((p) => [p.name, p.defaultEnabled])\n) as Record<PluginKey, boolean>;\n\nexport type PluginOverrides = Partial<Record<PluginKey, boolean>>;\n\nexport function resolveFeatures(\n  overrides?: PluginOverrides\n): Record<PluginKey, boolean> {\n  return { ...DEFAULTS, ...overrides };\n}\n\nfunction resolvePlugin(mod: { default: Plugin } | Plugin): Plugin {\n  return \"default\" in mod && typeof (mod.default as Plugin).setup === \"function\"\n    ? mod.default\n    : (mod as Plugin);\n}\n\nexport async function loadPlugin(\n  key: PluginKey,\n  context: PluginContext\n): Promise<PluginCleanup | null> {\n  const loader = LOADERS[key];\n  if (!loader) {\n    return null;\n  }\n\n  try {\n    const mod = await loader();\n    const plugin = resolvePlugin(mod);\n    const cleanup = plugin.setup(context);\n    log.debug(\"loaded %s\", key);\n    return typeof cleanup === \"function\" ? cleanup : null;\n  } catch {\n    log.error(\"failed to load plugin %s\", key);\n    return null;\n  }\n}\n"],"mappings":";;;AAQA,MAAM,MAAM,aAAa,UAAU;AASnC,MAAM,UAAoD;CACxD,cAAc,OAAO;CACrB,YAAY,OAAO;CACnB,iBAAiB,OAAO;CACxB,cAAc,OAAO;CACtB;AAED,MAAM,WAAuC,OAAO,YAClD,gBAAgB,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CACvD;AAID,SAAgB,gBACd,WAC4B;CAC5B,OAAO;EAAE,GAAG;EAAU,GAAG;EAAW;;AAGtC,SAAS,cAAc,KAA2C;CAChE,OAAO,aAAa,OAAO,OAAQ,IAAI,QAAmB,UAAU,aAChE,IAAI,UACH;;AAGP,eAAsB,WACpB,KACA,SAC+B;CAC/B,MAAM,SAAS,QAAQ;CACvB,IAAI,CAAC,QACH,OAAO;CAGT,IAAI;EAGF,MAAM,UADS,cAAc,MADX,QAAQ,CAEJ,CAAC,MAAM,QAAQ;EACrC,IAAI,MAAM,aAAa,IAAI;EAC3B,OAAO,OAAO,YAAY,aAAa,UAAU;SAC3C;EACN,IAAI,MAAM,4BAA4B,IAAI;EAC1C,OAAO"}

package/dist/plugins/lib/types.d.mts

@@ -1,10 +1,11 @@
-import { EnvelopePayload, EventType } from "@interfere/types/sdk/envelope";
+import { RecordExceptionOpts } from "../../internal/kernel.mjs";
+import { NonErrorException } from "@interfere/types/sdk/errors";
 
 //#region src/plugins/lib/types.d.ts
 type PluginCleanup = () => void;
 interface PluginContext {
-  capture<T extends EventType>(type: T, payload: EnvelopePayload<T>): void;
   getSessionId(): string;
+  recordException(value: Error | NonErrorException, opts: RecordExceptionOpts): void;
 }
 interface Plugin {
   readonly name: string;

package/dist/plugins/lib/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/plugins/lib/types.ts"],"mappings":";;;KAEY,aAAA;AAAA,UAEK,aAAA;EACf,OAAA,WAAkB,SAAA,EAAW,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,eAAA,CAAgB,CAAA;EAC/D,YAAA;AAAA;AAAA,UAGe,MAAA;EAAA,SACN,IAAA;EACT,KAAA,CAAM,GAAA,EAAK,aAAA,GAAgB,aAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/plugins/lib/types.ts"],"mappings":";;;;KAIY,aAAA;AAAA,UAEK,aAAA;EACf,YAAA;EACA,eAAA,CACE,KAAA,EAAO,KAAA,GAAQ,iBAAA,EACf,IAAA,EAAM,mBAAA;AAAA;AAAA,UAIO,MAAA;EAAA,SACN,IAAA;EACT,KAAA,CAAM,GAAA,EAAK,aAAA,GAAgB,aAAA;AAAA"}