@interfere/react 0.0.1

package/dist/lib/session/replay.js

@@ -0,0 +1,106 @@
+/* Session replay capture using rrweb, chunked streaming to ingest */
+"use client";
+import { REPLAY_CHUNK_MS } from "@interfere/constants";
+import { capture, flush } from "../../client.js";
+let started = false;
+let stopFn = null;
+export function setupReplay() {
+    if (started) {
+        return;
+    }
+    if (typeof window === "undefined") {
+        return;
+    }
+    started = true;
+    Promise.all([import("rrweb"), import("@rrweb/packer")])
+        .then(([rrwebModule, packerModule]) => {
+        // Handle different module export patterns
+        const rrweb = rrwebModule;
+        const record = rrweb.record || rrweb;
+        const { pack } = packerModule;
+        const events = [];
+        // Check if record is a function
+        if (typeof record !== "function") {
+            // biome-ignore lint/suspicious/noConsole: error logging needed
+            console.error("rrweb.record is not available");
+            return;
+        }
+        const stopRecord = record({
+            emit(event) {
+                // Compress the event before storing it
+                const packedEvent = pack(event);
+                events.push(packedEvent);
+            },
+            maskAllInputs: true, // Privacy: mask all text inputs by default
+        });
+        const sendChunk = () => {
+            if (events.length === 0) {
+                return;
+            }
+            const chunk = events.splice(0, events.length);
+            try {
+                capture("replay_chunk", {
+                    version: 1,
+                    chunkTs: Date.now(),
+                    count: chunk.length,
+                    // rrweb events are pre-compressed with @rrweb/packer
+                    events: chunk,
+                });
+                flush();
+            }
+            catch {
+                // swallow
+            }
+        };
+        const intervalId = window.setInterval(sendChunk, REPLAY_CHUNK_MS);
+        const flushNow = () => {
+            try {
+                sendChunk();
+            }
+            catch {
+                // swallow
+            }
+        };
+        const beforeUnload = () => flushNow();
+        const visibility = () => {
+            if (document.visibilityState === "hidden") {
+                flushNow();
+            }
+        };
+        window.addEventListener("beforeunload", beforeUnload);
+        document.addEventListener("visibilitychange", visibility);
+        stopFn = () => {
+            try {
+                if (typeof stopRecord === "function") {
+                    stopRecord();
+                }
+            }
+            catch {
+                /* no-op */
+            }
+            try {
+                window.clearInterval(intervalId);
+            }
+            catch {
+                /* no-op */
+            }
+            try {
+                window.removeEventListener("beforeunload", beforeUnload);
+                document.removeEventListener("visibilitychange", visibility);
+            }
+            catch {
+                /* no-op */
+            }
+            started = false;
+            stopFn = null;
+        };
+    })
+        .catch((error) => {
+        // biome-ignore lint/suspicious/noConsole: Just for testing
+        console.error("Failed to load rrweb:", error);
+    });
+}
+export function stopReplay() {
+    stopFn?.();
+}
+//# sourceMappingURL=replay.js.map

package/dist/lib/session/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../../src/lib/session/replay.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,YAAY,CAAC;AAEb,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAEjD,IAAI,OAAO,GAAG,KAAgB,CAAC;AAC/B,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,MAAM,UAAU,WAAW;IACzB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IAED,OAAO,GAAG,IAAI,CAAC;IAEf,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;SACpD,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE;QACpC,0CAA0C;QAC1C,MAAM,KAAK,GAAG,WAAW,CAAC;QAE1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC;QACrC,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC;QAE9B,MAAM,MAAM,GAAc,EAAE,CAAC;QAE7B,gCAAgC;QAChC,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,+DAA+D;YAC/D,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAY,MAAM,CAAC;YACjC,IAAI,CAAC,KAAc;gBACjB,uCAAuC;gBACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAsB,CAAC,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3B,CAAC;YACD,aAAa,EAAE,IAAI,EAAE,2CAA2C;SACjE,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACH,OAAO,CAAC,cAAc,EAAE;oBACtB,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;oBACnB,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,qDAAqD;oBACrD,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;gBACH,KAAK,EAAE,CAAC;YACV,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC;gBACH,SAAS,EAAE,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC,CAAC;QACF,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,GAAG,EAAE;YACtB,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;gBAC1C,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QACtD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;QAE1D,MAAM,GAAG,GAAG,EAAE;YACZ,IAAI,CAAC;gBACH,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;oBACpC,UAAyB,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;gBACzD,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,2DAA2D;QAC3D,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,EAAE,CAAC;AACb,CAAC"}

package/dist/lib/session/session-summary.d.ts

@@ -0,0 +1,3 @@
+export declare function setupSessionSummary(): (() => void) | undefined;
+export declare function stopSessionSummary(): void;
+//# sourceMappingURL=session-summary.d.ts.map

package/dist/lib/session/session-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-summary.d.ts","sourceRoot":"","sources":["../../../src/lib/session/session-summary.ts"],"names":[],"mappings":"AAsFA,wBAAgB,mBAAmB,6BA4BlC;AAED,wBAAgB,kBAAkB,SAKjC"}

package/dist/lib/session/session-summary.js

@@ -0,0 +1,79 @@
+/* Session summary using AI */
+"use client";
+import { SESSION_SUMMARY_INTERVAL } from "@interfere/constants";
+import { capture, flush } from "../../client.js";
+let intervalId = null;
+let isCapturingSummary = false;
+async function captureSessionSummary() {
+    if (isCapturingSummary) {
+        return;
+    }
+    isCapturingSummary = true;
+    const w = window;
+    try {
+        if (!w.ai?.summarizer) {
+            return;
+        }
+        // Get page content for summarization
+        const textContent = document.body.innerText || "";
+        const MIN_CONTENT_LENGTH = 100;
+        const MAX_CONTENT_LENGTH = 5000;
+        if (textContent.length < MIN_CONTENT_LENGTH) {
+            // Not enough content to summarize
+            return;
+        }
+        // @ts-expect-error - experimental API
+        const canSummarize = await window.ai.summarizer.capabilities();
+        if (canSummarize.available !== "readily") {
+            return;
+        }
+        // @ts-expect-error - experimental API
+        const session = await window.ai.summarizer.create();
+        const summary = await session.summarize(textContent.substring(0, MAX_CONTENT_LENGTH));
+        capture("session_summary", {
+            summary,
+            pageTitle: document.title,
+            pageUrl: window.location.href,
+            contentLength: textContent.length,
+            timestamp: Date.now(),
+        });
+        flush();
+    }
+    catch (error) {
+        // biome-ignore lint/suspicious/noConsole: Just for testing
+        console.warn("Failed to capture session summary - this is expected if Chrome AI is not available.", error);
+    }
+    finally {
+        isCapturingSummary = false;
+    }
+}
+export function setupSessionSummary() {
+    if (typeof window === "undefined") {
+        return;
+    }
+    const INITIAL_DELAY = 5000;
+    // Initial capture after a delay
+    setTimeout(captureSessionSummary, INITIAL_DELAY);
+    // Regular interval captures
+    intervalId = setInterval(captureSessionSummary, SESSION_SUMMARY_INTERVAL);
+    // Capture on visibility change
+    const handleVisibilityChange = () => {
+        if (document.visibilityState === "hidden") {
+            captureSessionSummary();
+        }
+    };
+    document.addEventListener("visibilitychange", handleVisibilityChange);
+    return () => {
+        if (intervalId) {
+            clearInterval(intervalId);
+        }
+        document.removeEventListener("visibilitychange", handleVisibilityChange);
+    };
+}
+export function stopSessionSummary() {
+    if (intervalId) {
+        clearInterval(intervalId);
+        intervalId = null;
+    }
+}
+//# sourceMappingURL=session-summary.js.map

package/dist/lib/session/session-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-summary.js","sourceRoot":"","sources":["../../../src/lib/session/session-summary.ts"],"names":[],"mappings":"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"}

package/dist/provider.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Interfere Provider
+ *
+ * Sets up error boundaries, session monitoring features,
+ * and provides context for the SDK.
+ */
+import { type PropsWithChildren, type ReactNode } from "react";
+import { capture, captureCustom, captureError, captureUIEvent, flush, getDebugInfo, getSessionId, getWindowId, resetSession } from "./client.js";
+type InterfereContextValue = {
+    capture: typeof capture;
+    captureError: typeof captureError;
+    captureCustom: typeof captureCustom;
+    captureUIEvent: typeof captureUIEvent;
+    flush: typeof flush;
+    getSessionId: typeof getSessionId;
+    getWindowId: typeof getWindowId;
+    resetSession: typeof resetSession;
+    getDebugInfo: typeof getDebugInfo;
+};
+/**
+ * Provider props
+ */
+export interface InterfereProviderProps extends PropsWithChildren {
+    /**
+     * Whether to capture unhandled errors
+     * @default true
+     */
+    captureErrors?: boolean;
+    /**
+     * Whether to capture unhandled promise rejections
+     * @default true
+     */
+    captureRejections?: boolean;
+    /**
+     * Whether to enable session replay recording
+     * @default true
+     */
+    enableReplay?: boolean;
+    /**
+     * Whether to enable rage click detection
+     * @default true
+     */
+    enableRageClick?: boolean;
+    /**
+     * Whether to enable session summary (requires Chrome with AI features)
+     * @default true
+     */
+    enableSessionSummary?: boolean;
+    /**
+     * Custom debug logger
+     */
+    debugLogger?: (message: string, error?: Error) => void;
+}
+/**
+ * Interfere Provider Component
+ *
+ * Usage:
+ * ```tsx
+ * export default function RootLayout({ children }: { children: ReactNode }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <InterfereProvider>{children}</InterfereProvider>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export declare function InterfereProvider({ children, captureErrors, captureRejections, enableReplay, enableRageClick, enableSessionSummary, debugLogger, }: InterfereProviderProps): ReactNode;
+/**
+ * Hook to access Interfere SDK functions
+ */
+export declare function useInterfere(): InterfereContextValue;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAGH,OAAc,EAEZ,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,cAAc,EACd,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EAEb,MAAM,aAAa,CAAC;AAOrB,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,YAAY,EAAE,OAAO,YAAY,CAAC;CACnC,CAAC;AAcF;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CACxD;AAyDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,aAAoB,EACpB,iBAAwB,EACxB,YAAmB,EACnB,eAAsB,EACtB,oBAA2B,EAC3B,WAAW,GACZ,EAAE,sBAAsB,GAAG,SAAS,CAgEpC;AAED;;GAEG;AACH,wBAAgB,YAAY,0BAE3B"}

package/dist/provider.js

@@ -0,0 +1,138 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Interfere Provider
+ *
+ * Sets up error boundaries, session monitoring features,
+ * and provides context for the SDK.
+ */
+// biome-ignore lint/correctness/noUnusedImports: React is required for JSX runtime
+import React, { createContext, useContext, useEffect, } from "react";
+import { capture, captureCustom, captureError, captureUIEvent, flush, getDebugInfo, getSessionId, getWindowId, resetSession, setDebugLogger, } from "./client.js";
+import { setupRageClick } from "./lib/session/rage-click.js";
+import { setupReplay, stopReplay } from "./lib/session/replay.js";
+import { setupSessionSummary } from "./lib/session/session-summary.js";
+const InterfereContext = createContext({
+    capture,
+    captureError,
+    captureCustom,
+    captureUIEvent,
+    flush,
+    getSessionId,
+    getWindowId,
+    resetSession,
+    getDebugInfo,
+});
+// Setup helper functions to reduce complexity
+function setupErrorHandlers(handlers) {
+    const errorHandler = (event) => {
+        captureError({
+            message: event.message,
+            stack: event.error?.stack,
+            filename: event.filename,
+            lineno: event.lineno,
+            colno: event.colno,
+        });
+    };
+    window.addEventListener("error", errorHandler);
+    handlers.push(() => window.removeEventListener("error", errorHandler));
+}
+function setupRejectionHandlers(handlers) {
+    const rejectionHandler = (event) => {
+        captureError({
+            message: `Unhandled Promise Rejection: ${event.reason}`,
+            stack: event.reason?.stack,
+            type: "unhandledrejection",
+        });
+    };
+    window.addEventListener("unhandledrejection", rejectionHandler);
+    handlers.push(() => window.removeEventListener("unhandledrejection", rejectionHandler));
+}
+function setupSessionFeatures(handlers, enableReplay, enableRageClick, enableSessionSummary) {
+    if (enableReplay) {
+        setupReplay();
+        handlers.push(() => stopReplay());
+    }
+    if (enableRageClick) {
+        const cleanupRageClick = setupRageClick();
+        if (cleanupRageClick) {
+            handlers.push(cleanupRageClick);
+        }
+    }
+    if (enableSessionSummary) {
+        const cleanupSummary = setupSessionSummary();
+        if (cleanupSummary) {
+            handlers.push(cleanupSummary);
+        }
+    }
+}
+/**
+ * Interfere Provider Component
+ *
+ * Usage:
+ * ```tsx
+ * export default function RootLayout({ children }: { children: ReactNode }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <InterfereProvider>{children}</InterfereProvider>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export function InterfereProvider({ children, captureErrors = true, captureRejections = true, enableReplay = true, enableRageClick = true, enableSessionSummary = true, debugLogger, }) {
+    useEffect(() => {
+        if (typeof window === "undefined") {
+            return;
+        }
+        const handlers = [];
+        // Set debug logger if provided
+        if (debugLogger) {
+            setDebugLogger(debugLogger);
+        }
+        // Set up error handlers
+        if (captureErrors) {
+            setupErrorHandlers(handlers);
+        }
+        // Set up rejection handlers
+        if (captureRejections) {
+            setupRejectionHandlers(handlers);
+        }
+        // Set up session features
+        setupSessionFeatures(handlers, enableReplay, enableRageClick, enableSessionSummary);
+        // Cleanup
+        return () => {
+            for (const cleanup of handlers) {
+                cleanup();
+            }
+            flush(); // Flush any pending events on unmount
+        };
+    }, [
+        captureErrors,
+        captureRejections,
+        enableReplay,
+        enableRageClick,
+        enableSessionSummary,
+        debugLogger,
+    ]);
+    return (_jsx(InterfereContext.Provider, { value: {
+            capture,
+            captureError,
+            captureCustom,
+            captureUIEvent,
+            flush,
+            getSessionId,
+            getWindowId,
+            resetSession,
+            getDebugInfo,
+        }, children: children }));
+}
+/**
+ * Hook to access Interfere SDK functions
+ */
+export function useInterfere() {
+    return useContext(InterfereContext);
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@interfere/react",
+  "version": "0.0.1",
+  "license": "MIT",
+  "description": "Build apps that never break.",
+  "keywords": [
+    "observability",
+    "typescript",
+    "react",
+    "logging",
+    "error-tracking",
+    "session-replay"
+  ],
+  "homepage": "https://interfere.com",
+  "bugs": {
+    "url": "mailto:support@interfere.com"
+  },
+  "author": "Interfere <support@interfere.com> (https://interfere.com)",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "default": "./dist/provider.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@rrweb/packer": "2.0.0-alpha.18",
+    "@rrweb/types": "2.0.0-alpha.18",
+    "nanoid": "^5.1.6",
+    "rrweb": "2.0.0-alpha.18",
+    "uuid": "^13.0.0",
+    "@interfere/constants": "0.0.1",
+    "@interfere/schemas": "0.0.7"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "22.15.29",
+    "@types/react": "19.1.16",
+    "@types/react-dom": "19.1.9",
+    "@vitest/coverage-v8": "^3.2.4",
+    "jsdom": "^27.0.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "typescript": "5.9.3",
+    "vitest": "^3.2.4",
+    "@interfere/typescript-config": "1.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "check-types": "tsc --noEmit --incremental",
+    "test": "vitest run --coverage"
+  }
+}