@interfere/react 0.1.0-alpha.6 → 0.2.0-alpha.1

package/README.md

@@ -0,0 +1,90 @@
+<p align="center">
+  <a href="https://interfere.com">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://qyzkf4cgb8ydxtq1.public.blob.vercel-storage.com/v2/header/logo-dark.png">
+      <img src="https://qyzkf4cgb8ydxtq1.public.blob.vercel-storage.com/v2/header/logo-light.png" height="64">
+    </picture>
+  </a>
+  <h1 align="center">@interfere/react</h1>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@interfere/react"><img src="https://img.shields.io/npm/v/@interfere/react.svg" /></a>
+  <a href="https://github.com/interfere-inc/interfere/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@interfere/react.svg" /></a>
+  <a href="https://www.npmjs.com/package/@interfere/react"><img src="https://img.shields.io/npm/dm/@interfere/react.svg" /></a>
+</p>
+
+<p align="center">
+  Client-side React SDK for <a href="https://interfere.com">Interfere</a> — error tracking, session replay, and analytics.
+</p>
+
+<p align="center">
+  <a href="https://interfere.com/docs">Documentation</a>
+  ·
+  <a href="https://github.com/interfere-inc/interfere/issues/new">Report a Bug</a>
+  ·
+  <a href="mailto:support@interfere.com">Get Help</a>
+</p>
+
+---
+
+> **Using Next.js?** You probably want [`@interfere/next`](https://www.npmjs.com/package/@interfere/next) instead — This is currently a work-in-progress that will add support for Vite and other React frameworks. 
+
+## Installation
+
+```bash
+npm install @interfere/react
+```
+
+### Prerequisites
+
+- React `>=19`
+
+## Quick Start
+
+```tsx
+import { InterfereProvider } from "@interfere/react/provider";
+
+function App() {
+  return (
+    <InterfereProvider>
+      <YourApp />
+    </InterfereProvider>
+  );
+}
+```
+
+## Features
+
+- **Error tracking** — automatic capture of uncaught errors and unhandled rejections
+- **Session replay** — full visual playback of user sessions
+- **Page analytics** — SPA-aware pageviews and UI interaction events
+- **Rage click detection** — surface frustrated user behavior
+- **User identity** — attach user context to sessions
+- **Offline resilient** — events are persisted and delivered in the background
+
+## Hooks
+
+```tsx
+import { useInterfere } from "@interfere/react/provider";
+
+function MyComponent() {
+  const { identity, session } = useInterfere();
+
+  identity.set({
+    identifier: "usr_123",
+    email: "jane@example.com",
+    name: "Jane",
+  });
+
+  const sessionId = session.getId();
+}
+```
+
+## Documentation
+
+Visit [interfere.com/docs](https://interfere.com/docs) for the full documentation.
+
+## License
+
+MIT

package/dist/error-boundary.d.mts

@@ -0,0 +1,27 @@
+import { Component, ErrorInfo, ReactNode } from "react";
+
+//#region src/error-boundary.d.ts
+interface ErrorBoundaryProps {
+  children: ReactNode;
+  fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+  onError?: (error: Error, info: ErrorInfo) => void;
+}
+interface ErrorBoundaryState {
+  error: Error | null;
+}
+/**
+ * Catches render-phase React errors, reports them to the SDK, and renders a
+ * fallback. Must be placed inside `<InterfereProvider>` so the client is
+ * initialised when `capture` is called.
+ *
+ * Class component required — React has no hook-based error boundary API.
+ */
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+  state: ErrorBoundaryState;
+  static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+  componentDidCatch(error: Error, info: ErrorInfo): void;
+  private readonly reset;
+  render(): ReactNode;
+}
+//#endregion
+export { ErrorBoundary, ErrorBoundaryProps };

package/dist/error-boundary.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.mts","names":[],"sources":["../src/error-boundary.tsx"],"mappings":";;;UASiB,kBAAA;EACf,QAAA,EAAU,SAAA;EACV,QAAA,GAAW,SAAA,KAAc,KAAA,EAAO,KAAA,EAAO,KAAA,iBAAsB,SAAA;EAC7D,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,SAAA;AAAA;AAAA,UAGvB,kBAAA;EACR,KAAA,EAAO,KAAA;AAAA;;;;;;;;cAUI,aAAA,SAAsB,SAAA,CACjC,kBAAA,EACA,kBAAA;EAES,KAAA,EAAO,kBAAA;EAAA,OAET,wBAAA,CAAyB,KAAA,EAAO,KAAA,GAAQ,kBAAA;EAItC,iBAAA,CAAkB,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,SAAA;EAAA,iBAa9B,KAAA;EAIR,MAAA,CAAA,GAAM,SAAA;AAAA"}

package/dist/error-boundary.mjs

@@ -0,0 +1,42 @@
+"use client";
+import { seen } from "./internal/errors.mjs";
+import { capture } from "./internal/client.mjs";
+import { toExceptions } from "@interfere/types/sdk/errors";
+import { Component } from "react";
+//#region src/error-boundary.tsx
+/**
+* Catches render-phase React errors, reports them to the SDK, and renders a
+* fallback. Must be placed inside `<InterfereProvider>` so the client is
+* initialised when `capture` is called.
+*
+* Class component required — React has no hook-based error boundary API.
+*/
+var ErrorBoundary = class extends Component {
+	state = { error: null };
+	static getDerivedStateFromError(error) {
+		return { error };
+	}
+	componentDidCatch(error, info) {
+		if (seen.has(error)) return;
+		seen.add(error);
+		capture("error", { exceptions: toExceptions(error, {
+			type: "react",
+			handled: true
+		}) });
+		this.props.onError?.(error, info);
+	}
+	reset = () => {
+		this.setState({ error: null });
+	};
+	render() {
+		const { error } = this.state;
+		if (error) {
+			const { fallback } = this.props;
+			if (typeof fallback === "function") return fallback(error, this.reset);
+			return fallback ?? null;
+		}
+		return this.props.children;
+	}
+};
+//#endregion
+export { ErrorBoundary };

package/dist/error-boundary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.mjs","names":[],"sources":["../src/error-boundary.tsx"],"sourcesContent":["\"use client\";\n\nimport { toExceptions } from \"@interfere/types/sdk/errors\";\n\nimport { Component, type ErrorInfo, type ReactNode } from \"react\";\n\nimport { capture } from \"./internal/client.js\";\nimport { seen } from \"./internal/errors.js\";\n\nexport interface ErrorBoundaryProps {\n  children: ReactNode;\n  fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);\n  onError?: (error: Error, info: ErrorInfo) => void;\n}\n\ninterface ErrorBoundaryState {\n  error: Error | null;\n}\n\n/**\n * Catches render-phase React errors, reports them to the SDK, and renders a\n * fallback. Must be placed inside `<InterfereProvider>` so the client is\n * initialised when `capture` is called.\n *\n * Class component required — React has no hook-based error boundary API.\n */\nexport class ErrorBoundary extends Component<\n  ErrorBoundaryProps,\n  ErrorBoundaryState\n> {\n  override state: ErrorBoundaryState = { error: null };\n\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n    return { error };\n  }\n\n  override componentDidCatch(error: Error, info: ErrorInfo) {\n    if (seen.has(error)) {\n      return;\n    }\n    seen.add(error);\n\n    capture(\"error\", {\n      exceptions: toExceptions(error, { type: \"react\", handled: true }),\n    });\n\n    this.props.onError?.(error, info);\n  }\n\n  private readonly reset = () => {\n    this.setState({ error: null });\n  };\n\n  override render() {\n    const { error } = this.state;\n\n    if (error) {\n      const { fallback } = this.props;\n      if (typeof fallback === \"function\") {\n        return fallback(error, this.reset);\n      }\n      return fallback ?? null;\n    }\n\n    return this.props.children;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA0BA,IAAa,gBAAb,cAAmC,UAGjC;CACA,QAAqC,EAAE,OAAO,MAAM;CAEpD,OAAO,yBAAyB,OAAkC;AAChE,SAAO,EAAE,OAAO;;CAGlB,kBAA2B,OAAc,MAAiB;AACxD,MAAI,KAAK,IAAI,MAAM,CACjB;AAEF,OAAK,IAAI,MAAM;AAEf,UAAQ,SAAS,EACf,YAAY,aAAa,OAAO;GAAE,MAAM;GAAS,SAAS;GAAM,CAAC,EAClE,CAAC;AAEF,OAAK,MAAM,UAAU,OAAO,KAAK;;CAGnC,cAA+B;AAC7B,OAAK,SAAS,EAAE,OAAO,MAAM,CAAC;;CAGhC,SAAkB;EAChB,MAAM,EAAE,UAAU,KAAK;AAEvB,MAAI,OAAO;GACT,MAAM,EAAE,aAAa,KAAK;AAC1B,OAAI,OAAO,aAAa,WACtB,QAAO,SAAS,OAAO,KAAK,MAAM;AAEpC,UAAO,YAAY;;AAGrB,SAAO,KAAK,MAAM"}

package/dist/internal/client.d.mts

@@ -0,0 +1,13 @@
+import { PluginOverrides } from "../plugins/lib/loader.mjs";
+import { EnvelopePayload, EventType } from "@interfere/types/sdk/envelope";
+
+//#region src/internal/client.d.ts
+interface ClientOptions {
+  plugins?: PluginOverrides;
+}
+declare function init(opts?: ClientOptions): void;
+declare function capture<T extends EventType>(type: T, payload: EnvelopePayload<T>): void;
+declare function flush(): void;
+declare function close(): void;
+//#endregion
+export { ClientOptions, capture, close, flush, init };

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../../src/internal/client.ts"],"mappings":";;;;UAiBiB,aAAA;EACf,OAAA,GAAU,eAAA;AAAA;AAAA,iBAQI,IAAA,CAAK,IAAA,GAAM,aAAA;AAAA,iBA0DX,OAAA,WAAkB,SAAA,CAAA,CAChC,IAAA,EAAM,CAAA,EACN,OAAA,EAAS,eAAA,CAAgB,CAAA;AAAA,iBAeX,KAAA,CAAA;AAAA,iBAIA,KAAA,CAAA"}

package/dist/internal/client.mjs

@@ -0,0 +1,80 @@
+import errorsPlugin from "../plugins/errors.mjs";
+import { createLogger } from "../util/log.mjs";
+import { loadPlugins } from "../plugins/lib/loader.mjs";
+import { bootstrap, session, teardown } from "../tracking/api.mjs";
+import { HttpTransport } from "../transport/http.mjs";
+import { BatchQueue } from "../transport/queue.mjs";
+import { resolveTargets } from "./config.mjs";
+import { collectContext } from "./context.mjs";
+import { buildEnvelope } from "./envelope.mjs";
+import { registerServiceWorker } from "./sw.mjs";
+import { inferRuntime, normalizeEnv } from "@interfere/types/sdk/runtime";
+//#region src/internal/client.ts
+const log = createLogger("client");
+let state = "idle";
+let queue = null;
+let metadata = null;
+let cleanups = [];
+function init(opts = {}) {
+	if (state !== "idle") return;
+	const buildId = globalThis.__INTERFERE_BUILD_ID__;
+	const releaseId = globalThis.__INTERFERE_RELEASE_ID__;
+	if (!buildId) {
+		log.error("buildId not found — ensure withInterfere() is configured in next.config and instrumentation-client.ts exists in your project root.");
+		return;
+	}
+	const targets = resolveTargets();
+	bootstrap(targets.session, opts.plugins);
+	log.info("target: %s", targets.ingest.url);
+	metadata = {
+		context: collectContext(),
+		environment: normalizeEnv(typeof process !== "undefined" ? process.env.NODE_ENV : void 0),
+		runtime: inferRuntime(),
+		buildId,
+		releaseId: releaseId ?? null
+	};
+	registerServiceWorker();
+	queue = new BatchQueue({ transport: new HttpTransport(targets.ingest) });
+	queue.start();
+	const pluginCtx = {
+		capture: (type, payload) => capture(type, payload),
+		getSessionId: () => session.getId() ?? ""
+	};
+	const errorCleanup = errorsPlugin.setup(pluginCtx);
+	cleanups = errorCleanup ? [errorCleanup] : [];
+	state = "ready";
+	loadPlugins({
+		...opts.plugins,
+		errors: false
+	}, pluginCtx).then((c) => {
+		cleanups.push(...c);
+	}).catch(() => {
+		log.warn("non-critical plugin loading failed");
+	});
+}
+function capture(type, payload) {
+	try {
+		const sessionId = session.getId();
+		if (state !== "ready" || !sessionId || !queue || !metadata) return;
+		queue.enqueue(buildEnvelope(type, payload, sessionId, metadata));
+	} catch (err) {
+		log.warn("capture failed", err);
+	}
+}
+function flush() {
+	queue?.flush();
+}
+function close() {
+	if (state === "closed") return;
+	state = "closed";
+	for (const cleanup of cleanups) try {
+		cleanup();
+	} catch {}
+	cleanups = [];
+	teardown();
+	queue?.dispose();
+	queue = null;
+	metadata = null;
+}
+//#endregion
+export { capture, close, flush, init };

package/dist/internal/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../../src/internal/client.ts"],"sourcesContent":["import type { EnvelopePayload, EventType } from \"@interfere/types/sdk/envelope\";\nimport { inferRuntime, normalizeEnv } from \"@interfere/types/sdk/runtime\";\n\nimport errorsPlugin from \"../plugins/errors.js\";\nimport { loadPlugins, type PluginOverrides } from \"../plugins/lib/loader.js\";\nimport type { PluginCleanup, PluginContext } from \"../plugins/lib/types.js\";\nimport { bootstrap, session, teardown } from \"../tracking/api.js\";\nimport { HttpTransport } from \"../transport/http.js\";\nimport { BatchQueue } from \"../transport/queue.js\";\nimport { createLogger } from \"../util/log.js\";\nimport { resolveTargets } from \"./config.js\";\nimport { collectContext } from \"./context.js\";\nimport { buildEnvelope, type EnvelopeMetadata } from \"./envelope.js\";\nimport { registerServiceWorker } from \"./sw.js\";\n\nconst log = createLogger(\"client\");\n\nexport interface ClientOptions {\n  plugins?: PluginOverrides;\n}\n\nlet state: \"idle\" | \"ready\" | \"closed\" = \"idle\";\nlet queue: BatchQueue | null = null;\nlet metadata: EnvelopeMetadata | null = null;\nlet cleanups: PluginCleanup[] = [];\n\nexport function init(opts: ClientOptions = {}): void {\n  if (state !== \"idle\") {\n    return;\n  }\n\n  const buildId = (globalThis as Record<string, unknown>)\n    .__INTERFERE_BUILD_ID__ as string | undefined;\n\n  const releaseId = (globalThis as Record<string, unknown>)\n    .__INTERFERE_RELEASE_ID__ as string | null | undefined;\n\n  if (!buildId) {\n    log.error(\n      \"buildId not found — ensure withInterfere() is configured in \" +\n        \"next.config and instrumentation-client.ts exists in your project root.\"\n    );\n    return;\n  }\n\n  const targets = resolveTargets();\n  bootstrap(targets.session, opts.plugins);\n\n  log.info(\"target: %s\", targets.ingest.url);\n\n  metadata = {\n    context: collectContext(),\n    environment: normalizeEnv(\n      typeof process !== \"undefined\" ? process.env.NODE_ENV : undefined\n    ),\n    runtime: inferRuntime(),\n    buildId,\n    releaseId: releaseId ?? null,\n  };\n\n  registerServiceWorker();\n\n  const transport = new HttpTransport(targets.ingest);\n  queue = new BatchQueue({ transport });\n  queue.start();\n\n  const pluginCtx: PluginContext = {\n    capture: (type, payload) => capture(type, payload),\n    getSessionId: () => session.getId() ?? \"\",\n  };\n\n  const errorCleanup = errorsPlugin.setup(pluginCtx);\n  cleanups = errorCleanup ? [errorCleanup] : [];\n  state = \"ready\";\n\n  loadPlugins({ ...opts.plugins, errors: false }, pluginCtx)\n    .then((c) => {\n      cleanups.push(...c);\n    })\n    .catch(() => {\n      log.warn(\"non-critical plugin loading failed\");\n    });\n}\n\nexport function capture<T extends EventType>(\n  type: T,\n  payload: EnvelopePayload<T>\n): void {\n  try {\n    const sessionId = session.getId();\n\n    if (state !== \"ready\" || !sessionId || !queue || !metadata) {\n      return;\n    }\n\n    queue.enqueue(buildEnvelope(type, payload, sessionId, metadata));\n  } catch (err) {\n    log.warn(\"capture failed\", err);\n  }\n}\n\nexport function flush(): void {\n  queue?.flush();\n}\n\nexport function close(): void {\n  if (state === \"closed\") {\n    return;\n  }\n  state = \"closed\";\n\n  for (const cleanup of cleanups) {\n    try {\n      cleanup();\n    } catch {\n      /* best-effort */\n    }\n  }\n  cleanups = [];\n  teardown();\n\n  queue?.dispose();\n  queue = null;\n  metadata = null;\n}\n"],"mappings":";;;;;;;;;;;;AAeA,MAAM,MAAM,aAAa,SAAS;AAMlC,IAAI,QAAqC;AACzC,IAAI,QAA2B;AAC/B,IAAI,WAAoC;AACxC,IAAI,WAA4B,EAAE;AAElC,SAAgB,KAAK,OAAsB,EAAE,EAAQ;AACnD,KAAI,UAAU,OACZ;CAGF,MAAM,UAAW,WACd;CAEH,MAAM,YAAa,WAChB;AAEH,KAAI,CAAC,SAAS;AACZ,MAAI,MACF,qIAED;AACD;;CAGF,MAAM,UAAU,gBAAgB;AAChC,WAAU,QAAQ,SAAS,KAAK,QAAQ;AAExC,KAAI,KAAK,cAAc,QAAQ,OAAO,IAAI;AAE1C,YAAW;EACT,SAAS,gBAAgB;EACzB,aAAa,aACX,OAAO,YAAY,cAAc,QAAQ,IAAI,WAAW,KAAA,EACzD;EACD,SAAS,cAAc;EACvB;EACA,WAAW,aAAa;EACzB;AAED,wBAAuB;AAGvB,SAAQ,IAAI,WAAW,EAAE,WADP,IAAI,cAAc,QAAQ,OAAO,EACf,CAAC;AACrC,OAAM,OAAO;CAEb,MAAM,YAA2B;EAC/B,UAAU,MAAM,YAAY,QAAQ,MAAM,QAAQ;EAClD,oBAAoB,QAAQ,OAAO,IAAI;EACxC;CAED,MAAM,eAAe,aAAa,MAAM,UAAU;AAClD,YAAW,eAAe,CAAC,aAAa,GAAG,EAAE;AAC7C,SAAQ;AAER,aAAY;EAAE,GAAG,KAAK;EAAS,QAAQ;EAAO,EAAE,UAAU,CACvD,MAAM,MAAM;AACX,WAAS,KAAK,GAAG,EAAE;GACnB,CACD,YAAY;AACX,MAAI,KAAK,qCAAqC;GAC9C;;AAGN,SAAgB,QACd,MACA,SACM;AACN,KAAI;EACF,MAAM,YAAY,QAAQ,OAAO;AAEjC,MAAI,UAAU,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,SAChD;AAGF,QAAM,QAAQ,cAAc,MAAM,SAAS,WAAW,SAAS,CAAC;UACzD,KAAK;AACZ,MAAI,KAAK,kBAAkB,IAAI;;;AAInC,SAAgB,QAAc;AAC5B,QAAO,OAAO;;AAGhB,SAAgB,QAAc;AAC5B,KAAI,UAAU,SACZ;AAEF,SAAQ;AAER,MAAK,MAAM,WAAW,SACpB,KAAI;AACF,WAAS;SACH;AAIV,YAAW,EAAE;AACb,WAAU;AAEV,QAAO,SAAS;AAChB,SAAQ;AACR,YAAW"}

package/dist/internal/config.d.mts

@@ -0,0 +1,9 @@
+import { IngestTarget } from "../transport/http.mjs";
+
+//#region src/internal/config.d.ts
+declare function resolveTargets(): {
+  ingest: IngestTarget;
+  session: IngestTarget;
+};
+//#endregion
+export { resolveTargets };

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/internal/config.ts"],"mappings":";;;iBAcgB,cAAA,CAAA;EACd,MAAA,EAAQ,YAAA;EACR,OAAA,EAAS,YAAA;AAAA"}

package/dist/internal/config.mjs

@@ -0,0 +1,27 @@
+import { API_PATHS, API_URL } from "@interfere/constants/api";
+//#region src/internal/config.ts
+const DEFAULT_PROXY_URL = "/api/interfere";
+const DEFAULT_SESSION_PATH = "/v1/session";
+function resolvePublicKey() {
+	if (typeof process === "undefined") return;
+	return process.env.INTERFERE_PUBLIC_KEY ?? void 0;
+}
+function resolveTargets() {
+	const publicKey = resolvePublicKey();
+	const headers = new Headers({ "content-type": "application/json" });
+	if (publicKey) headers.set("x-interfere-pub-token", publicKey);
+	const baseUrl = publicKey ? API_URL : DEFAULT_PROXY_URL;
+	const sessionPath = API_PATHS.SESSION ?? DEFAULT_SESSION_PATH;
+	return {
+		ingest: {
+			url: `${baseUrl}${API_PATHS.INGEST}`,
+			headers
+		},
+		session: {
+			url: `${baseUrl}${sessionPath}`,
+			headers
+		}
+	};
+}
+//#endregion
+export { resolveTargets };

package/dist/internal/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/internal/config.ts"],"sourcesContent":["import { API_PATHS, API_URL } from \"@interfere/constants/api\";\n\nimport type { IngestTarget } from \"../transport/http.js\";\n\nconst DEFAULT_PROXY_URL = \"/api/interfere\";\nconst DEFAULT_SESSION_PATH = \"/v1/session\";\n\nfunction resolvePublicKey(): string | undefined {\n  if (typeof process === \"undefined\") {\n    return undefined;\n  }\n  return process.env.INTERFERE_PUBLIC_KEY ?? undefined;\n}\n\nexport function resolveTargets(): {\n  ingest: IngestTarget;\n  session: IngestTarget;\n} {\n  const publicKey = resolvePublicKey();\n  const headers = new Headers({ \"content-type\": \"application/json\" });\n  if (publicKey) {\n    headers.set(\"x-interfere-pub-token\", publicKey);\n  }\n\n  const baseUrl = publicKey ? API_URL : DEFAULT_PROXY_URL;\n  const sessionPath =\n    (API_PATHS as { SESSION?: string }).SESSION ?? DEFAULT_SESSION_PATH;\n\n  return {\n    ingest: {\n      url: `${baseUrl}${API_PATHS.INGEST}`,\n      headers,\n    },\n    session: {\n      url: `${baseUrl}${sessionPath}`,\n      headers,\n    },\n  };\n}\n"],"mappings":";;AAIA,MAAM,oBAAoB;AAC1B,MAAM,uBAAuB;AAE7B,SAAS,mBAAuC;AAC9C,KAAI,OAAO,YAAY,YACrB;AAEF,QAAO,QAAQ,IAAI,wBAAwB,KAAA;;AAG7C,SAAgB,iBAGd;CACA,MAAM,YAAY,kBAAkB;CACpC,MAAM,UAAU,IAAI,QAAQ,EAAE,gBAAgB,oBAAoB,CAAC;AACnE,KAAI,UACF,SAAQ,IAAI,yBAAyB,UAAU;CAGjD,MAAM,UAAU,YAAY,UAAU;CACtC,MAAM,cACH,UAAmC,WAAW;AAEjD,QAAO;EACL,QAAQ;GACN,KAAK,GAAG,UAAU,UAAU;GAC5B;GACD;EACD,SAAS;GACP,KAAK,GAAG,UAAU;GAClB;GACD;EACF"}

package/dist/internal/context.d.mts

@@ -0,0 +1,6 @@
+import { BrowserContext } from "@interfere/types/sdk/plugins/context/browser";
+
+//#region src/internal/context.d.ts
+declare function collectContext(): BrowserContext;
+//#endregion
+export { collectContext };

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","names":[],"sources":["../../src/internal/context.ts"],"mappings":";;;iBAwCgB,cAAA,CAAA,GAAkB,cAAA"}

package/dist/internal/context.mjs

@@ -0,0 +1,32 @@
+import { UAParser } from "@ua-parser-js/pro-enterprise";
+//#region src/internal/context.ts
+function getDeviceMetadata() {
+	if (typeof navigator === "undefined") return null;
+	return UAParser(navigator.userAgent) ?? null;
+}
+function getBrowserMetadata() {
+	if ([
+		typeof navigator,
+		typeof screen,
+		typeof globalThis
+	].some((x) => x === "undefined")) return null;
+	const { language } = navigator;
+	return {
+		language,
+		timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+		display: { screen: {
+			height: screen.availHeight,
+			width: screen.availWidth,
+			orientation: screen.orientation?.type
+		} }
+	};
+}
+function collectContext() {
+	return {
+		runtime: "browser",
+		browser: getBrowserMetadata(),
+		device: getDeviceMetadata()
+	};
+}
+//#endregion
+export { collectContext };

package/dist/internal/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","names":[],"sources":["../../src/internal/context.ts"],"sourcesContent":["import type {\n  BrowserContext,\n  BrowserMetadata,\n  DeviceMetadata,\n} from \"@interfere/types/sdk/plugins/context/browser\";\n\nimport { UAParser } from \"@ua-parser-js/pro-enterprise\";\n\nfunction getDeviceMetadata(): DeviceMetadata | null {\n  if (typeof navigator === \"undefined\") {\n    return null;\n  }\n\n  return UAParser(navigator.userAgent) ?? null;\n}\n\nfunction getBrowserMetadata(): BrowserMetadata | null {\n  if (\n    [typeof navigator, typeof screen, typeof globalThis].some(\n      (x) => x === \"undefined\"\n    )\n  ) {\n    return null;\n  }\n\n  const { language } = navigator;\n\n  return {\n    language,\n    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n    display: {\n      screen: {\n        height: screen.availHeight,\n        width: screen.availWidth,\n        orientation: screen.orientation?.type,\n      },\n    },\n  };\n}\n\nexport function collectContext(): BrowserContext {\n  return {\n    runtime: \"browser\",\n    browser: getBrowserMetadata(),\n    device: getDeviceMetadata(),\n  };\n}\n"],"mappings":";;AAQA,SAAS,oBAA2C;AAClD,KAAI,OAAO,cAAc,YACvB,QAAO;AAGT,QAAO,SAAS,UAAU,UAAU,IAAI;;AAG1C,SAAS,qBAA6C;AACpD,KACE;EAAC,OAAO;EAAW,OAAO;EAAQ,OAAO;EAAW,CAAC,MAClD,MAAM,MAAM,YACd,CAED,QAAO;CAGT,MAAM,EAAE,aAAa;AAErB,QAAO;EACL;EACA,UAAU,KAAK,gBAAgB,CAAC,iBAAiB,CAAC;EAClD,SAAS,EACP,QAAQ;GACN,QAAQ,OAAO;GACf,OAAO,OAAO;GACd,aAAa,OAAO,aAAa;GAClC,EACF;EACF;;AAGH,SAAgB,iBAAiC;AAC/C,QAAO;EACL,SAAS;EACT,SAAS,oBAAoB;EAC7B,QAAQ,mBAAmB;EAC5B"}

package/dist/internal/envelope.d.mts

@@ -0,0 +1,14 @@
+import { Env, Runtime } from "@interfere/types/sdk/runtime";
+import { Envelope, EnvelopeContext, EnvelopePayload, EventType } from "@interfere/types/sdk/envelope";
+
+//#region src/internal/envelope.d.ts
+interface EnvelopeMetadata {
+  buildId: string;
+  context: EnvelopeContext;
+  environment: Env;
+  releaseId: string | null;
+  runtime: Runtime;
+}
+declare function buildEnvelope<T extends EventType>(type: T, payload: EnvelopePayload<T>, sessionId: string, metadata: EnvelopeMetadata): Envelope<T>;
+//#endregion
+export { EnvelopeMetadata, buildEnvelope };

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

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.mts","names":[],"sources":["../../src/internal/envelope.ts"],"mappings":";;;;UAUiB,gBAAA;EACf,OAAA;EACA,OAAA,EAAS,eAAA;EACT,WAAA,EAAa,GAAA;EACb,SAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,iBAGK,aAAA,WAAwB,SAAA,CAAA,CACtC,IAAA,EAAM,CAAA,EACN,OAAA,EAAS,eAAA,CAAgB,CAAA,GACzB,SAAA,UACA,QAAA,EAAU,gBAAA,GACT,QAAA,CAAS,CAAA"}

package/dist/internal/envelope.mjs

@@ -0,0 +1,20 @@
+import { v7 } from "uuid";
+//#region src/internal/envelope.ts
+function buildEnvelope(type, payload, sessionId, metadata) {
+	return {
+		uuid: v7(),
+		v: 0,
+		type,
+		payload,
+		context: metadata.context,
+		runtime: metadata.runtime,
+		environment: metadata.environment,
+		buildId: metadata.buildId,
+		releaseId: metadata.releaseId,
+		clientTs: Date.now(),
+		sessionId,
+		sessionSource: "client"
+	};
+}
+//#endregion
+export { buildEnvelope };

package/dist/internal/envelope.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.mjs","names":["uuidv7"],"sources":["../../src/internal/envelope.ts"],"sourcesContent":["import type {\n  Envelope,\n  EnvelopeContext,\n  EnvelopePayload,\n  EventType,\n} from \"@interfere/types/sdk/envelope\";\nimport type { Env, Runtime } from \"@interfere/types/sdk/runtime\";\n\nimport { v7 as uuidv7 } from \"uuid\";\n\nexport interface EnvelopeMetadata {\n  buildId: string;\n  context: EnvelopeContext;\n  environment: Env;\n  releaseId: string | null;\n  runtime: Runtime;\n}\n\nexport function buildEnvelope<T extends EventType>(\n  type: T,\n  payload: EnvelopePayload<T>,\n  sessionId: string,\n  metadata: EnvelopeMetadata\n): Envelope<T> {\n  return {\n    uuid: uuidv7(),\n    v: 0 as const,\n    type,\n    payload,\n    context: metadata.context,\n    runtime: metadata.runtime,\n    environment: metadata.environment,\n    buildId: metadata.buildId,\n    releaseId: metadata.releaseId,\n    clientTs: Date.now(),\n    sessionId,\n    sessionSource: \"client\" as const,\n  } as Envelope<T>;\n}\n"],"mappings":";;AAkBA,SAAgB,cACd,MACA,SACA,WACA,UACa;AACb,QAAO;EACL,MAAMA,IAAQ;EACd,GAAG;EACH;EACA;EACA,SAAS,SAAS;EAClB,SAAS,SAAS;EAClB,aAAa,SAAS;EACtB,SAAS,SAAS;EAClB,WAAW,SAAS;EACpB,UAAU,KAAK,KAAK;EACpB;EACA,eAAe;EAChB"}

package/dist/internal/errors.d.mts

@@ -0,0 +1,4 @@
+//#region src/internal/errors.d.ts
+declare const seen: WeakSet<Error>;
+//#endregion
+export { seen };

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/internal/errors.ts"],"mappings":";cAAa,IAAA,EAAI,OAAA,CAAA,KAAA"}

package/dist/internal/errors.mjs

@@ -0,0 +1,4 @@
+//#region src/internal/errors.ts
+const seen = /* @__PURE__ */ new WeakSet();
+//#endregion
+export { seen };

package/dist/internal/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/internal/errors.ts"],"sourcesContent":["export const seen = new WeakSet<Error>();\n"],"mappings":";AAAA,MAAa,uBAAO,IAAI,SAAgB"}

package/dist/internal/sw.d.mts

@@ -0,0 +1,4 @@
+//#region src/internal/sw.d.ts
+declare function registerServiceWorker(): void;
+//#endregion
+export { registerServiceWorker };

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

@@ -0,0 +1 @@
+{"version":3,"file":"sw.d.mts","names":[],"sources":["../../src/internal/sw.ts"],"mappings":";iBAMgB,qBAAA,CAAA"}

package/dist/internal/sw.mjs

@@ -0,0 +1,10 @@
+import { createLogger } from "../util/log.mjs";
+//#region src/internal/sw.ts
+const log = createLogger("sw");
+const SW_PATH = "/api/interfere/sw";
+function registerServiceWorker() {
+	if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) return;
+	navigator.serviceWorker.register(SW_PATH, { scope: "/" }).then(() => log.debug("registered")).catch(() => log.warn("registration failed, using direct fetch"));
+}
+//#endregion
+export { registerServiceWorker };

package/dist/internal/sw.mjs.map

@@ -0,0 +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: \"/\" })\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,KAAK,CAAC,CACjC,WAAW,IAAI,MAAM,aAAa,CAAC,CACnC,YAAY,IAAI,KAAK,0CAA0C,CAAC"}

package/dist/plugins/errors.d.mts

@@ -0,0 +1,6 @@
+import { Plugin } from "./lib/types.mjs";
+
+//#region src/plugins/errors.d.ts
+declare const errorsPlugin: Plugin;
+//#endregion
+export { errorsPlugin as default, errorsPlugin };

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

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

package/dist/plugins/errors.mjs

@@ -0,0 +1,59 @@
+import { seen } from "../internal/errors.mjs";
+import { toExceptions } from "@interfere/types/sdk/errors";
+//#region src/plugins/errors.ts
+let capturing = false;
+function capture(ctx, opts) {
+	if (capturing || seen.has(opts.error)) return;
+	seen.add(opts.error);
+	capturing = true;
+	try {
+		ctx.capture("error", { exceptions: toExceptions(opts.error, opts.mechanism) });
+	} finally {
+		capturing = false;
+	}
+}
+const errorsPlugin = {
+	name: "errors",
+	setup(ctx) {
+		const originalOnError = globalThis.onerror;
+		const originalConsoleError = globalThis.console.error;
+		globalThis.onerror = (msg, source, line, col, error) => {
+			if (error instanceof Error) capture(ctx, {
+				error,
+				mechanism: {
+					type: "onerror",
+					handled: false
+				}
+			});
+			if (typeof originalOnError === "function") return originalOnError.call(globalThis, msg, source, line, col, error);
+			return false;
+		};
+		const onUnhandledRejection = (event) => {
+			if (event.reason instanceof Error) capture(ctx, {
+				error: event.reason,
+				mechanism: {
+					type: "unhandledrejection",
+					handled: false
+				}
+			});
+		};
+		globalThis.addEventListener("unhandledrejection", onUnhandledRejection);
+		globalThis.console.error = (...args) => {
+			originalConsoleError.apply(globalThis.console, args);
+			if (args[0] instanceof Error) capture(ctx, {
+				error: args[0],
+				mechanism: {
+					type: "console.error",
+					handled: true
+				}
+			});
+		};
+		return () => {
+			globalThis.onerror = originalOnError;
+			globalThis.removeEventListener("unhandledrejection", onUnhandledRejection);
+			globalThis.console.error = originalConsoleError;
+		};
+	}
+};
+//#endregion
+export { errorsPlugin as default, errorsPlugin };

package/dist/plugins/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/plugins/errors.ts"],"sourcesContent":["import { toExceptions } 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\nlet capturing = false;\n\nfunction capture(\n  ctx: PluginContext,\n  opts: { error: Error; mechanism: ErrorMechanism }\n) {\n  if (capturing || seen.has(opts.error)) {\n    return;\n  }\n\n  seen.add(opts.error);\n  capturing = true;\n  try {\n    ctx.capture(\"error\", {\n      exceptions: toExceptions(opts.error, opts.mechanism),\n    });\n  } finally {\n    capturing = false;\n  }\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\n    globalThis.onerror = (msg, source, line, col, error) => {\n      if (error instanceof Error) {\n        capture(ctx, {\n          error,\n          mechanism: { type: \"onerror\", handled: false },\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      if (event.reason instanceof Error) {\n        capture(ctx, {\n          error: event.reason,\n          mechanism: { type: \"unhandledrejection\", handled: false },\n        });\n      }\n    };\n    globalThis.addEventListener(\"unhandledrejection\", onUnhandledRejection);\n\n    globalThis.console.error = (...args: unknown[]) => {\n      originalConsoleError.apply(globalThis.console, args);\n      if (args[0] instanceof Error) {\n        capture(ctx, {\n          error: args[0],\n          mechanism: { type: \"console.error\", handled: true },\n        });\n      }\n    };\n\n    return () => {\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":";;;AAMA,IAAI,YAAY;AAEhB,SAAS,QACP,KACA,MACA;AACA,KAAI,aAAa,KAAK,IAAI,KAAK,MAAM,CACnC;AAGF,MAAK,IAAI,KAAK,MAAM;AACpB,aAAY;AACZ,KAAI;AACF,MAAI,QAAQ,SAAS,EACnB,YAAY,aAAa,KAAK,OAAO,KAAK,UAAU,EACrD,CAAC;WACM;AACR,cAAY;;;AAIhB,MAAa,eAAuB;CAClC,MAAM;CAEN,MAAM,KAAK;EACT,MAAM,kBAAkB,WAAW;EACnC,MAAM,uBAAuB,WAAW,QAAQ;AAEhD,aAAW,WAAW,KAAK,QAAQ,MAAM,KAAK,UAAU;AACtD,OAAI,iBAAiB,MACnB,SAAQ,KAAK;IACX;IACA,WAAW;KAAE,MAAM;KAAW,SAAS;KAAO;IAC/C,CAAC;AAEJ,OAAI,OAAO,oBAAoB,WAC7B,QAAO,gBAAgB,KAAK,YAAY,KAAK,QAAQ,MAAM,KAAK,MAAM;AAExE,UAAO;;EAGT,MAAM,wBAAwB,UAAiC;AAC7D,OAAI,MAAM,kBAAkB,MAC1B,SAAQ,KAAK;IACX,OAAO,MAAM;IACb,WAAW;KAAE,MAAM;KAAsB,SAAS;KAAO;IAC1D,CAAC;;AAGN,aAAW,iBAAiB,sBAAsB,qBAAqB;AAEvE,aAAW,QAAQ,SAAS,GAAG,SAAoB;AACjD,wBAAqB,MAAM,WAAW,SAAS,KAAK;AACpD,OAAI,KAAK,cAAc,MACrB,SAAQ,KAAK;IACX,OAAO,KAAK;IACZ,WAAW;KAAE,MAAM;KAAiB,SAAS;KAAM;IACpD,CAAC;;AAIN,eAAa;AACX,cAAW,UAAU;AACrB,cAAW,oBACT,sBACA,qBACD;AACD,cAAW,QAAQ,QAAQ;;;CAGhC"}

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

@@ -0,0 +1,9 @@
+import { PluginCleanup, PluginContext } from "./types.mjs";
+import { PluginKey } from "@interfere/types/sdk/plugins/manifest";
+
+//#region src/plugins/lib/loader.d.ts
+type PluginOverrides = Partial<Record<PluginKey, boolean>>;
+declare function resolveFeatures(overrides?: PluginOverrides): Record<PluginKey, boolean>;
+declare function loadPlugins(overrides: PluginOverrides | undefined, context: PluginContext): Promise<PluginCleanup[]>;
+//#endregion
+export { PluginOverrides, loadPlugins, resolveFeatures };

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

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

package/dist/plugins/lib/loader.mjs

@@ -0,0 +1,47 @@
+import { createLogger } from "../../util/log.mjs";
+import { PLUGIN_MANIFEST } from "@interfere/types/sdk/plugins/manifest";
+//#region src/plugins/lib/loader.ts
+const log = createLogger("plugins");
+const LOADERS = {
+	errors: () => import("../errors.mjs"),
+	pageEvents: () => import("../pages.mjs"),
+	rageClick: () => import("../rage-clicks.mjs"),
+	replay: () => import("../replay.mjs")
+};
+const DEFAULTS = Object.fromEntries(PLUGIN_MANIFEST.map((p) => [p.name, p.defaultEnabled]));
+function resolveFeatures(overrides) {
+	return {
+		...DEFAULTS,
+		...overrides
+	};
+}
+function resolvePlugin(mod) {
+	return "default" in mod && typeof mod.default.setup === "function" ? mod.default : mod;
+}
+async function loadPlugins(overrides, context) {
+	const resolved = {
+		...DEFAULTS,
+		...overrides
+	};
+	const entries = Object.entries(resolved).filter(([key, enabled]) => enabled && key in LOADERS);
+	const modules = await Promise.all(entries.map(async ([key]) => {
+		const loader = LOADERS[key];
+		if (!loader) return null;
+		try {
+			return await loader();
+		} catch {
+			log.error("failed to load plugin %s", key);
+			return null;
+		}
+	}));
+	const cleanups = [];
+	for (const [i, mod] of modules.entries()) {
+		if (!mod) continue;
+		const cleanup = resolvePlugin(mod).setup(context);
+		if (typeof cleanup === "function") cleanups.push(cleanup);
+		log.debug("loaded %s", entries[i]?.[0]);
+	}
+	return cleanups;
+}
+//#endregion
+export { loadPlugins, resolveFeatures };

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

@@ -0,0 +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  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 loadPlugins(\n  overrides: PluginOverrides | undefined,\n  context: PluginContext\n): Promise<PluginCleanup[]> {\n  const resolved = { ...DEFAULTS, ...overrides };\n  const entries = (Object.entries(resolved) as [PluginKey, boolean][]).filter(\n    ([key, enabled]) => enabled && key in LOADERS\n  );\n\n  const modules = await Promise.all(\n    entries.map(async ([key]) => {\n      const loader = LOADERS[key];\n      if (!loader) {\n        return null;\n      }\n      try {\n        return await loader();\n      } catch {\n        log.error(\"failed to load plugin %s\", key);\n        return null;\n      }\n    })\n  );\n\n  const cleanups: PluginCleanup[] = [];\n\n  for (const [i, mod] of modules.entries()) {\n    if (!mod) {\n      continue;\n    }\n    const plugin = resolvePlugin(mod);\n    const cleanup = plugin.setup(context);\n    if (typeof cleanup === \"function\") {\n      cleanups.push(cleanup);\n    }\n    log.debug(\"loaded %s\", entries[i]?.[0]);\n  }\n\n  return cleanups;\n}\n"],"mappings":";;;AAQA,MAAM,MAAM,aAAa,UAAU;AAInC,MAAM,UAAoD;CACxD,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,YACpB,WACA,SAC0B;CAC1B,MAAM,WAAW;EAAE,GAAG;EAAU,GAAG;EAAW;CAC9C,MAAM,UAAW,OAAO,QAAQ,SAAS,CAA4B,QAClE,CAAC,KAAK,aAAa,WAAW,OAAO,QACvC;CAED,MAAM,UAAU,MAAM,QAAQ,IAC5B,QAAQ,IAAI,OAAO,CAAC,SAAS;EAC3B,MAAM,SAAS,QAAQ;AACvB,MAAI,CAAC,OACH,QAAO;AAET,MAAI;AACF,UAAO,MAAM,QAAQ;UACf;AACN,OAAI,MAAM,4BAA4B,IAAI;AAC1C,UAAO;;GAET,CACH;CAED,MAAM,WAA4B,EAAE;AAEpC,MAAK,MAAM,CAAC,GAAG,QAAQ,QAAQ,SAAS,EAAE;AACxC,MAAI,CAAC,IACH;EAGF,MAAM,UADS,cAAc,IAAI,CACV,MAAM,QAAQ;AACrC,MAAI,OAAO,YAAY,WACrB,UAAS,KAAK,QAAQ;AAExB,MAAI,MAAM,aAAa,QAAQ,KAAK,GAAG;;AAGzC,QAAO"}

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

@@ -0,0 +1,14 @@
+import { EnvelopePayload, EventType } from "@interfere/types/sdk/envelope";
+
+//#region src/plugins/lib/types.d.ts
+type PluginCleanup = () => void;
+interface PluginContext {
+  capture<T extends EventType>(type: T, payload: EnvelopePayload<T>): void;
+  getSessionId(): string;
+}
+interface Plugin {
+  readonly name: string;
+  setup(ctx: PluginContext): PluginCleanup | undefined;
+}
+//#endregion
+export { Plugin, PluginCleanup, PluginContext };