@spanwise/rum 0.4.3 → 0.6.0

package/README.md

@@ -0,0 +1,403 @@
+# @spanwise/rum
+
+Real User Monitoring SDK for browser applications. Captures page views, clicks, errors, Web Vitals, and session replays.
+
+## Installation
+
+```bash
+npm install @spanwise/rum
+# or
+pnpm add @spanwise/rum
+# or
+yarn add @spanwise/rum
+```
+
+## Quick Start
+
+```typescript
+import { createSpanwiseBrowser } from "@spanwise/rum"
+
+const spanwise = createSpanwiseBrowser({
+  apiKey: "sw_...",
+  serviceName: "my-app",
+})
+
+// That's it! Page views, clicks, errors, and vitals are tracked automatically.
+```
+
+## Configuration
+
+```typescript
+const spanwise = createSpanwiseBrowser({
+  // Required
+  apiKey: "sw_...",
+
+  // Optional
+  serviceName: "my-app",           // Service name for filtering
+  sampleRate: 1.0,                 // Sample 100% of sessions (default: 1.0)
+  trackPageViews: true,            // Track page views (default: true)
+  trackClicks: true,               // Track clicks (default: true)
+  trackVitals: true,               // Track Web Vitals (default: true)
+  trackErrors: true,               // Track errors (default: true)
+  trackResources: true,            // Track fetch/XHR requests (default: true)
+  sessionStorage: "cookie",        // "cookie" or "sessionStorage" (default: "cookie")
+
+  // Distributed Tracing
+  tracing: {
+    enabled: true,                 // Inject traceparent headers (default: true)
+    propagateToOrigins: [          // Origins to propagate trace context to
+      "https://api.example.com",
+      /\.example\.com$/,
+    ],
+  },
+
+  // Session Replay (opt-in)
+  replay: {
+    enabled: true,                 // Enable replay recording (default: false)
+    sampleRate: 0.1,               // Record 10% of sessions (default: 0.1)
+    onErrorSampleRate: 1.0,        // Record 100% of sessions with errors (default: 1.0)
+    privacyMode: "strict",         // Privacy mode (default: "strict")
+  },
+})
+```
+
+## API
+
+### `spanwise.trackEvent(name, properties?)`
+
+Track a custom event.
+
+```typescript
+spanwise.trackEvent("purchase", {
+  productId: "123",
+  amount: 99.99,
+})
+```
+
+### `spanwise.trackPageView(url?)`
+
+Manually track a page view. Called automatically on navigation.
+
+```typescript
+spanwise.trackPageView("/checkout")
+```
+
+### `spanwise.trackError(error, options?)`
+
+Manually track an error.
+
+```typescript
+try {
+  await riskyOperation()
+} catch (error) {
+  spanwise.trackError(error, {
+    requestId: "req_123",
+    traceId: "trace_abc",
+  })
+}
+```
+
+### `spanwise.setUser(id, traits?)`
+
+Identify the current user.
+
+```typescript
+spanwise.setUser("user_123", {
+  email: "user@example.com",
+  plan: "pro",
+})
+```
+
+### `spanwise.getSessionId()`
+
+Get the current session ID.
+
+```typescript
+const sessionId = spanwise.getSessionId()
+```
+
+### `spanwise.startReplay()` / `spanwise.stopReplay()`
+
+Manually control replay recording (overrides sampling).
+
+```typescript
+// Start recording for VIP users regardless of sample rate
+if (user.isVIP) {
+  spanwise.startReplay()
+}
+```
+
+---
+
+## Session Replay
+
+Session Replay records user interactions as a video-like playback. It captures DOM mutations, mouse movements, clicks, and scrolls.
+
+### Enabling Replay
+
+```typescript
+const spanwise = createSpanwiseBrowser({
+  apiKey: "sw_...",
+  replay: {
+    enabled: true,
+  },
+})
+```
+
+### Sampling
+
+By default, only 10% of sessions are recorded to manage costs and storage:
+
+```typescript
+replay: {
+  enabled: true,
+  sampleRate: 0.1,         // 10% of sessions
+  onErrorSampleRate: 1.0,  // 100% if an error occurs
+}
+```
+
+When an error occurs in a session that wasn't initially sampled, recording automatically starts to capture the error context.
+
+---
+
+## Privacy & Data Protection
+
+Session Replay is designed with privacy as the default. **No configuration is required for most applications** - sensitive data is automatically protected.
+
+### Privacy Modes
+
+| Mode | Text | Inputs | Use Case |
+|------|------|--------|----------|
+| `"strict"` (default) | Masked | Masked | Most applications |
+| `"balanced"` | Visible | Masked | Marketing sites, blogs |
+| `"permissive"` | Visible | Visible | Internal tools only |
+
+```typescript
+replay: {
+  enabled: true,
+  privacyMode: "strict",  // Default - masks everything
+}
+```
+
+### What Each Mode Does
+
+#### Strict Mode (Default)
+
+All text content is replaced with `****`. Form inputs show `•••••`. You see the page structure and user interactions, but no actual content.
+
+```
+┌─────────────────────────────┐
+│  **** ********              │  ← Masked heading
+│                             │
+│  ******** **** ** *******   │  ← Masked paragraph
+│  ******* ** *** ****        │
+│                             │
+│  Email: [•••••••••••••]     │  ← Masked input
+│  Password: [••••••••]       │
+│                             │
+│  [**********]               │  ← Masked button
+└─────────────────────────────┘
+```
+
+#### Balanced Mode
+
+Text is visible, but all form inputs are masked. Good for content-heavy sites.
+
+```
+┌─────────────────────────────┐
+│  Welcome Back               │  ← Visible heading
+│                             │
+│  Please sign in to continue │  ← Visible text
+│                             │
+│  Email: [•••••••••••••]     │  ← Masked input
+│  Password: [••••••••]       │
+│                             │
+│  [Sign In]                  │  ← Visible button
+└─────────────────────────────┘
+```
+
+#### Permissive Mode
+
+Everything is recorded as-is. **Only use for internal tools or with explicit user consent.**
+
+### Fine-Grained Control with HTML Attributes
+
+Regardless of privacy mode, you can control specific elements:
+
+#### Block Elements Completely
+
+Use `data-sw-block` to completely hide an element. It will appear as a gray placeholder in replays.
+
+```html
+<!-- Credit card form - never record -->
+<div data-sw-block>
+  <input type="text" placeholder="Card number" />
+  <input type="text" placeholder="CVV" />
+</div>
+
+<!-- Sensitive user data -->
+<div data-sw-block class="user-profile">
+  <p>SSN: 123-45-6789</p>
+</div>
+```
+
+#### Mask Specific Elements
+
+Use `data-sw-mask` to mask text while preserving structure (useful in balanced/permissive modes).
+
+```html
+<!-- Mask email in a visible section -->
+<p>Contact: <span data-sw-mask>user@example.com</span></p>
+```
+
+#### Unmask Elements in Strict Mode
+
+Use `data-sw-unmask` to show content even when using strict mode.
+
+```html
+<!-- Show navigation labels in strict mode -->
+<nav data-sw-unmask>
+  <a href="/">Home</a>
+  <a href="/products">Products</a>
+  <a href="/about">About</a>
+</nav>
+
+<!-- Show static content -->
+<footer data-sw-unmask>
+  <p>© 2024 My Company</p>
+</footer>
+```
+
+#### rrweb Classes (Alternative)
+
+The standard rrweb classes also work:
+
+```html
+<div class="rr-block">Hidden content</div>
+<div class="rr-mask">Masked content</div>
+```
+
+### Best Practices
+
+1. **Start with strict mode** - It's the safest default. Only relax if needed.
+
+2. **Block sensitive sections entirely** - For areas with PII (profile pages, account settings), use `data-sw-block`.
+
+3. **Review before production** - Test your app with replay enabled and verify no sensitive data appears.
+
+4. **Consider user consent** - For GDPR compliance, inform users that sessions may be recorded.
+
+5. **Use unmask sparingly** - Only unmask truly static, non-sensitive content like navigation labels.
+
+### What's Automatically Protected
+
+Even without configuration:
+
+- All `<input>` values are masked (except in permissive mode)
+- Password fields are always masked
+- Credit card patterns are detected and masked
+- `<script>` content is never recorded
+- `<head>` metadata is stripped
+
+### Sensitive Data Checklist
+
+Before enabling replay, ensure these are blocked or masked:
+
+- [ ] User profile information (name, email, phone)
+- [ ] Payment forms and credit card inputs
+- [ ] Social security numbers, government IDs
+- [ ] Medical or health information
+- [ ] Authentication tokens displayed on screen
+- [ ] Private messages or chat content
+- [ ] Financial account numbers
+- [ ] Any PII in confirmation pages
+
+---
+
+## Distributed Tracing
+
+The SDK automatically injects `traceparent` headers into fetch/XHR requests, connecting frontend sessions to backend traces.
+
+```typescript
+const spanwise = createSpanwiseBrowser({
+  apiKey: "sw_...",
+  tracing: {
+    enabled: true,
+    propagateToOrigins: [
+      "https://api.myapp.com",
+      /\.myapp\.com$/,
+    ],
+  },
+})
+```
+
+Your backend will receive headers like:
+
+```
+traceparent: 00-{traceId}-{spanId}-01
+```
+
+---
+
+## Browser Support
+
+- Chrome 64+
+- Firefox 67+
+- Safari 12+
+- Edge 79+
+
+Session Replay requires:
+- MutationObserver
+- WeakMap
+- requestAnimationFrame
+
+---
+
+## Bundle Size
+
+The base SDK is ~8KB gzipped. Session Replay adds ~40KB gzipped (rrweb).
+
+Replay is dynamically imported only when enabled, so it won't affect your bundle if not used.
+
+---
+
+## TypeScript
+
+Full TypeScript support with exported types:
+
+```typescript
+import {
+  createSpanwiseBrowser,
+  type BrowserConfig,
+  type SpanwiseBrowser,
+  type ReplayConfig,
+  type PrivacyMode,
+  type TracingConfig,
+} from "@spanwise/rum"
+```
+
+---
+
+## Troubleshooting
+
+### Replay not recording
+
+1. Check that `replay.enabled` is `true`
+2. Verify you're within the sample rate (try `sampleRate: 1.0` for testing)
+3. Check browser console for errors
+
+### High data volume
+
+1. Reduce `sampleRate` (e.g., `0.05` for 5%)
+2. Use `"strict"` privacy mode (smaller payloads due to masked content)
+
+### Missing trace correlation
+
+1. Ensure `tracing.propagateToOrigins` includes your API domain
+2. Check that your backend parses the `traceparent` header
+
+---
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -1,3 +1,4 @@
+import { type ReplayConfig } from "./replay.js";
 import { type StorageMode } from "./session.js";
 export type TracingConfig = {
     /** Enable distributed tracing (default: true) */
@@ -30,6 +31,8 @@ export type BrowserConfig = {
      *                     No cookie consent required.
      */
     sessionStorage?: StorageMode;
+    /** Session replay configuration */
+    replay?: ReplayConfig;
 };
 export declare function createSpanwiseBrowser(config: BrowserConfig): {
     trackEvent: () => void;
@@ -37,6 +40,8 @@ export declare function createSpanwiseBrowser(config: BrowserConfig): {
     trackError: () => void;
     setUser: () => void;
     getSessionId: () => null;
+    startReplay: () => void;
+    stopReplay: () => void;
 } | {
     trackEvent: (name: string, properties?: Record<string, unknown>) => void;
     trackPageView: (url?: string) => void;
@@ -46,6 +51,10 @@ export declare function createSpanwiseBrowser(config: BrowserConfig): {
     }) => void;
     setUser: (id: string, traits?: Record<string, unknown>) => void;
     getSessionId: () => string;
+    /** Start replay recording manually (overrides sampling) */
+    startReplay: () => void | undefined;
+    /** Stop replay recording */
+    stopReplay: () => void | undefined;
 };
 export type SpanwiseBrowser = ReturnType<typeof createSpanwiseBrowser>;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAYA,OAAO,EACN,KAAK,WAAW,EAIhB,MAAM,cAAc,CAAA;AAIrB,MAAM,MAAM,aAAa,GAAG;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACxC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,wCAAwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,WAAW,CAAA;CAC5B,CAAA;AAmBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa;;;;;;;uBA4CnD,MAAM,eACC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,IAAI;0BAhBsB,MAAM,KAAG,IAAI;wBA6BlC,KAAK,YACF;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAChD,IAAI;kBAKc,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAWtC,MAAM;EAgIpC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,aAAa,CAAA;AACrE,OAAO,EACN,KAAK,WAAW,EAIhB,MAAM,cAAc,CAAA;AAIrB,MAAM,MAAM,aAAa,GAAG;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACxC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,wCAAwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,WAAW,CAAA;IAC5B,mCAAmC;IACnC,MAAM,CAAC,EAAE,YAAY,CAAA;CACrB,CAAA;AAmBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa;;;;;;;;;uBAuDnD,MAAM,eACC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,IAAI;0BAhBsB,MAAM,KAAG,IAAI;wBA6BlC,KAAK,YACF;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAChD,IAAI;kBAOc,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAWtC,MAAM;IAiInC,2DAA2D;;IAE3D,4BAA4B;;EAG7B;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/client.js

@@ -2,6 +2,7 @@ import { captureError, setupErrorTracking } from "./errors.js";
 import { createBaseEvent } from "./events.js";
 import { instrumentFetch, updateFetchConfig } from "./instrumentation/fetch.js";
 import { instrumentXHR, updateXHRConfig } from "./instrumentation/xhr.js";
+import { createReplayRecorder } from "./replay.js";
 import { getOrCreateSession, refreshSession, setStorageMode, } from "./session.js";
 import { createTransport } from "./transport.js";
 import { setupVitalsTracking } from "./vitals.js";
@@ -30,6 +31,8 @@ export function createSpanwiseBrowser(config) {
             trackError: () => { },
             setUser: () => { },
             getSessionId: () => null,
+            startReplay: () => { },
+            stopReplay: () => { },
         };
     }
     const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
@@ -41,6 +44,14 @@ export function createSpanwiseBrowser(config) {
         baseUrl,
         serviceName: config.serviceName,
     });
+    // Initialize replay recorder if configured
+    const replayRecorder = config.replay?.enabled
+        ? createReplayRecorder(config.replay, {
+            apiKey: config.apiKey,
+            baseUrl,
+            sessionId,
+        })
+        : null;
     function enqueueEvent(event) {
         refreshSession();
         transport.enqueue(event);
@@ -71,6 +82,8 @@ export function createSpanwiseBrowser(config) {
     function trackError(error, options) {
         const event = captureError(error, sessionId, userId, options);
         enqueueEvent(event);
+        // Mark replay for error correlation
+        replayRecorder?.markError();
     }
     function setUser(id, traits) {
         userId = id;
@@ -145,6 +158,8 @@ export function createSpanwiseBrowser(config) {
     if (config.trackErrors !== false) {
         setupErrorTracking(sessionId, userId, (event) => {
             enqueueEvent(event);
+            // Mark replay for error correlation (auto-captured errors)
+            replayRecorder?.markError();
         });
     }
     // Resource tracking: capture HTTP requests with timing and trace correlation
@@ -181,6 +196,10 @@ export function createSpanwiseBrowser(config) {
         trackError,
         setUser,
         getSessionId: getSessionIdValue,
+        /** Start replay recording manually (overrides sampling) */
+        startReplay: () => replayRecorder?.start(),
+        /** Stop replay recording */
+        stopReplay: () => replayRecorder?.stop(),
     };
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { createSpanwiseBrowser, type BrowserConfig, type SpanwiseBrowser, type TracingConfig, } from "./client.js";
+export type { ReplayConfig, PrivacyMode } from "./replay.js";
 export type { RumEvent, RumEventType, PageViewEvent, ClickEvent, VitalsEvent, ErrorEvent, CustomEvent, ResourceEvent, } from "./events.js";
 export { getSessionId, endSession, type StorageMode } from "./session.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,GAIrB,MAAM,aAAa,CAAA;AAWpB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,GAIrB,MAAM,aAAa,CAAA;AAYpB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAA"}

package/dist/replay.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Privacy mode for session replay recording.
+ *
+ * - `"strict"` (default): Masks ALL text and input values. Recommended for most apps.
+ *   Only element structure and interactions are visible.
+ *
+ * - `"balanced"`: Masks input values only. Text content is visible but form data is protected.
+ *   Good for marketing sites with minimal user input.
+ *
+ * - `"permissive"`: Records everything as-is. Only use for internal tools or after
+ *   explicit user consent. You must ensure no PII is captured.
+ */
+export type PrivacyMode = "strict" | "balanced" | "permissive";
+export type ReplayConfig = {
+    /** Enable replay recording (default: false) */
+    enabled?: boolean;
+    /** Sample rate for replays 0-1 (default: 0.1 = 10%) */
+    sampleRate?: number;
+    /** Sample rate when error occurs 0-1 (default: 1.0 = 100%) */
+    onErrorSampleRate?: number;
+    /**
+     * Privacy mode controls what data is captured (default: "strict")
+     *
+     * - "strict": Masks all text and inputs (recommended)
+     * - "balanced": Masks inputs only, text is visible
+     * - "permissive": Records everything (use with caution)
+     *
+     * Regardless of mode, you can use HTML attributes for fine-grained control:
+     * - `data-sw-block`: Completely hides element (shows placeholder)
+     * - `data-sw-mask`: Masks text content with asterisks
+     * - `data-sw-unmask`: Shows content even in strict mode
+     *
+     * rrweb built-in classes are also supported:
+     * - `.rr-block`: Same as data-sw-block
+     * - `.rr-mask`: Same as data-sw-mask
+     */
+    privacyMode?: PrivacyMode;
+};
+type ReplayTransportConfig = {
+    apiKey: string;
+    baseUrl: string;
+    sessionId: string;
+};
+export declare function createReplayRecorder(config: ReplayConfig, transportConfig: ReplayTransportConfig, onError?: () => void): {
+    start: () => void;
+    stop: () => void;
+    markError: () => void;
+    isRecording: () => boolean;
+    wasUpgradedByError: () => boolean;
+};
+export type ReplayRecorder = ReturnType<typeof createReplayRecorder>;
+export {};
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAE9D,MAAM,MAAM,YAAY,GAAG;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAmBD,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,qBAAqB,EACtC,OAAO,CAAC,EAAE,MAAM,IAAI;iBAsIF,IAAI;gBAcL,IAAI;qBAgCC,IAAI;;;EA2B1B;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/replay.js

@@ -0,0 +1,201 @@
+import { gzipSync } from "fflate";
+import { record } from "rrweb";
+const MAX_CHUNK_SIZE = 64 * 1024; // 64KB uncompressed
+const FLUSH_INTERVAL = 5000; // 5 seconds
+// Selectors for privacy control
+const BLOCK_SELECTOR = "[data-sw-block], .rr-block";
+const MASK_SELECTOR = "[data-sw-mask], .rr-mask";
+const UNMASK_SELECTOR = "[data-sw-unmask]";
+// Efficient base64 encoding for Uint8Array (avoids spread operator on large arrays)
+function uint8ToBase64(bytes) {
+    let binary = "";
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+export function createReplayRecorder(config, transportConfig, onError) {
+    const events = [];
+    let estimatedSize = 0; // Track size incrementally
+    let chunkIndex = 0;
+    let flushTimer = null;
+    let isRecording = false;
+    let hasStartedRecording = false;
+    let stopRecording = null;
+    let hasErrors = false;
+    // Sampling logic
+    const shouldRecord = Math.random() < (config.sampleRate ?? 0.1);
+    let wasUpgradedByError = false;
+    function getRecordOptions() {
+        const privacyMode = config.privacyMode ?? "strict";
+        // Build privacy settings based on mode
+        const maskAllInputs = privacyMode !== "permissive";
+        const maskAllText = privacyMode === "strict";
+        // In strict mode, mask everything except explicitly unmasked elements
+        // In balanced/permissive modes, only mask elements with data-sw-mask
+        const maskTextSelector = maskAllText
+            ? `*:not(${UNMASK_SELECTOR}):not(${UNMASK_SELECTOR} *)`
+            : MASK_SELECTOR;
+        return {
+            emit: (event) => handleEvent(event),
+            sampling: {
+                mousemove: true,
+                mouseInteraction: true,
+                scroll: 150,
+                input: "last",
+            },
+            // Privacy settings
+            maskAllInputs,
+            maskTextSelector,
+            blockSelector: BLOCK_SELECTOR,
+            // Slimmer DOM for performance
+            slimDOMOptions: {
+                script: true,
+                comment: true,
+                headFavicon: true,
+                headWhitespace: true,
+                headMetaSocial: true,
+                headMetaRobots: true,
+                headMetaHttpEquiv: true,
+                headMetaVerification: true,
+                headMetaAuthorship: true,
+            },
+        };
+    }
+    function handleEvent(event) {
+        events.push(event);
+        // Estimate event size (faster than JSON.stringify entire array)
+        estimatedSize += JSON.stringify(event).length + 1; // +1 for comma
+        if (estimatedSize >= MAX_CHUNK_SIZE) {
+            flush();
+        }
+        else {
+            scheduleFlush();
+        }
+    }
+    function scheduleFlush() {
+        if (flushTimer)
+            return;
+        flushTimer = setTimeout(() => {
+            flushTimer = null;
+            flush();
+        }, FLUSH_INTERVAL);
+    }
+    function preparePayload(batch) {
+        const compressed = gzipSync(new TextEncoder().encode(JSON.stringify(batch)));
+        const isFullSnapshot = chunkIndex === 0;
+        return JSON.stringify({
+            sessionId: transportConfig.sessionId,
+            chunkIndex,
+            data: uint8ToBase64(compressed),
+            isFullSnapshot,
+            timestamp: Date.now(),
+            hasErrors,
+        });
+    }
+    async function flush() {
+        if (events.length === 0)
+            return;
+        const batch = events.splice(0);
+        estimatedSize = 0;
+        try {
+            await fetch(`${transportConfig.baseUrl}/v1/ingest/replays`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": transportConfig.apiKey,
+                },
+                body: preparePayload(batch),
+                keepalive: true,
+            });
+            chunkIndex++;
+        }
+        catch (error) {
+            console.warn("[Spanwise Replay] Failed to send chunk:", error);
+        }
+    }
+    function flushBeacon() {
+        if (events.length === 0)
+            return;
+        const batch = events.splice(0);
+        estimatedSize = 0;
+        try {
+            fetch(`${transportConfig.baseUrl}/v1/ingest/replays`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": transportConfig.apiKey,
+                },
+                body: preparePayload(batch),
+                keepalive: true,
+            }).catch(() => {
+                // Silently ignore - page is likely unloading
+            });
+            chunkIndex++;
+        }
+        catch {
+            // Ignore errors during page unload
+        }
+    }
+    function start() {
+        if (isRecording || hasStartedRecording)
+            return;
+        hasStartedRecording = true;
+        isRecording = true;
+        const stop = record(getRecordOptions());
+        stopRecording = stop ?? null;
+        // Setup unload handlers
+        window.addEventListener("visibilitychange", handleVisibilityChange);
+        window.addEventListener("pagehide", handlePageHide);
+    }
+    function stop() {
+        if (!isRecording)
+            return;
+        isRecording = false;
+        if (stopRecording) {
+            stopRecording();
+            stopRecording = null;
+        }
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+            flushTimer = null;
+        }
+        // Final flush
+        flush();
+        window.removeEventListener("visibilitychange", handleVisibilityChange);
+        window.removeEventListener("pagehide", handlePageHide);
+    }
+    function handleVisibilityChange() {
+        if (document.visibilityState === "hidden") {
+            flushBeacon();
+        }
+    }
+    function handlePageHide() {
+        flushBeacon();
+    }
+    function markError() {
+        hasErrors = true;
+        // Upgrade to recording if sampled out but within onErrorSampleRate
+        if (!hasStartedRecording && !shouldRecord) {
+            const onErrorRate = config.onErrorSampleRate ?? 1.0;
+            if (Math.random() < onErrorRate) {
+                wasUpgradedByError = true;
+                start();
+                onError?.();
+            }
+        }
+    }
+    // Auto-start if sampled in
+    if (config.enabled && shouldRecord) {
+        // Defer to next tick to ensure DOM is ready
+        setTimeout(start, 0);
+    }
+    return {
+        start,
+        stop,
+        markError,
+        isRecording: () => isRecording,
+        wasUpgradedByError: () => wasUpgradedByError,
+    };
+}
+//# sourceMappingURL=replay.js.map

package/dist/replay.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@spanwise/rum",
-	"version": "0.4.3",
+	"version": "0.6.0",
 	"description": "Real User Monitoring SDK for Spanwise - track sessions, page views, clicks, and Core Web Vitals",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -30,6 +30,9 @@
 	],
 	"license": "MIT",
 	"dependencies": {
+		"@rrweb/types": "2.0.0-alpha.18",
+		"fflate": "^0.8.2",
+		"rrweb": "2.0.0-alpha.4",
 		"web-vitals": "^4.2.4"
 	},
 	"devDependencies": {