@softprobe/web-record 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @softprobe/web-record
+
+Browser session recording SDK. Captures DOM mutations with [rrweb](https://github.com/rrweb-io/rrweb)
+and exports batches to Softprobe **thelake** via OTLP `POST {baseUrl}/v1/traces`.
+
+## Install
+
+```bash
+npm install @softprobe/web-record
+```
+
+## Usage
+
+```ts
+import { RecordSdk } from "@softprobe/web-record";
+
+const recorder = RecordSdk.init({
+  publicKey: process.env.SOFTPROBE_PUBLIC_KEY!,
+  baseUrl: process.env.SOFTPROBE_BASE_URL!,
+  sessionId: openCodeSessionId, // becomes sp.session.id
+  serviceName: "softprobe-code",
+  maskAllInputs: true,
+});
+
+// When the chat session changes:
+recorder.setSessionId(nextSessionId);
+
+// On teardown:
+recorder.stop();
+```
+
+Missing credentials soft-disable the SDK (warn + no-op) so hosts keep running.
+
+## Session header
+
+While recording is enabled, the SDK patches `fetch` / XHR to inject
+`x-sp-session-id` on **same-origin** requests only (relative URLs and
+`location.origin`). Third-party / CDN calls are left untouched.
+
+## OTLP contract
+
+Each flush emits one span:
+
+| Field | Value |
+|---|---|
+| name | `softprobe.web.recording` |
+| `sp.observation.type` | `recording` |
+| `sp.session.id` | correlation id |
+| `sp.recording.batch_index` | monotonic batch counter |
+| event `sp.recording.batch` | attribute `sp.recording.events` = JSON rrweb events |
+
+Auth: `Authorization: Bearer <publicKey>`.
+
+Credentials and `{baseUrl}/v1/traces` derivation come from `@softprobe/tracing/config`
+(same product semantics as the LLM SDK).

package/dist/http-interceptor.d.ts

@@ -0,0 +1,12 @@
+type SessionIdProvider = () => string;
+export declare function getSessionIdHeaderName(): string;
+/**
+ * Patches XHR + fetch to inject `x-sp-session-id` on same-origin requests only.
+ * Provider is consulted on each request so session switches take effect.
+ */
+export declare function initializeHttpInterceptor(getSessionId: SessionIdProvider): void;
+export declare function updateHttpInterceptorSessionId(getSessionId: SessionIdProvider): void;
+/** Relative URLs and same `location.origin` only — skip third-party/CDN. */
+export declare function isSameOriginRequest(resource: RequestInfo | URL): boolean;
+export {};
+//# sourceMappingURL=http-interceptor.d.ts.map

package/dist/http-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-interceptor.d.ts","sourceRoot":"","sources":["../src/http-interceptor.ts"],"names":[],"mappings":"AAEA,KAAK,iBAAiB,GAAG,MAAM,MAAM,CAAC;AAItC,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAI/E;AAED,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAEpF;AAMD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,GAAG,GAAG,OAAO,CA2BxE"}

package/dist/http-interceptor.js

@@ -0,0 +1,126 @@
+const HEADER_X_SP_SESSION_ID = "x-sp-session-id";
+let sessionIdProvider = null;
+export function getSessionIdHeaderName() {
+    return HEADER_X_SP_SESSION_ID;
+}
+/**
+ * Patches XHR + fetch to inject `x-sp-session-id` on same-origin requests only.
+ * Provider is consulted on each request so session switches take effect.
+ */
+export function initializeHttpInterceptor(getSessionId) {
+    sessionIdProvider = getSessionId;
+    patchXMLHttpRequest();
+    patchFetchAPI();
+}
+export function updateHttpInterceptorSessionId(getSessionId) {
+    sessionIdProvider = getSessionId;
+}
+function currentSessionId() {
+    return sessionIdProvider?.() ?? "";
+}
+/** Relative URLs and same `location.origin` only — skip third-party/CDN. */
+export function isSameOriginRequest(resource) {
+    try {
+        let href;
+        if (typeof Request !== "undefined" && resource instanceof Request) {
+            href = resource.url;
+        }
+        else if (resource instanceof URL) {
+            href = resource.href;
+        }
+        else {
+            href = String(resource);
+        }
+        // Scheme-relative or absolute with a scheme → compare origins.
+        // Bare paths (`/api`, `./x`) resolve against location and are same-origin.
+        if (typeof location === "undefined") {
+            // No browsing context (e.g. unit tests without jsdom location): treat
+            // relative paths as same-origin; absolute http(s) as cross-origin.
+            if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(href) && !href.startsWith("//")) {
+                return true;
+            }
+            return false;
+        }
+        const resolved = new URL(href, location.href);
+        return resolved.origin === location.origin;
+    }
+    catch {
+        return false;
+    }
+}
+function patchXMLHttpRequest() {
+    if (typeof XMLHttpRequest === "undefined")
+        return;
+    if (XMLHttpRequest.__sp_sdk_patched_xhr) {
+        return;
+    }
+    const originalOpen = XMLHttpRequest.prototype.open;
+    const originalSend = XMLHttpRequest.prototype.send;
+    XMLHttpRequest.prototype.open = function (method, url, async, username, password) {
+        this.__sp_request_url =
+            url;
+        return originalOpen.call(this, method, url, async ?? true, username, password);
+    };
+    XMLHttpRequest.prototype.send = function (body) {
+        const sid = currentSessionId();
+        const url = this
+            .__sp_request_url;
+        if (sid && url !== undefined && isSameOriginRequest(url)) {
+            try {
+                this.setRequestHeader(HEADER_X_SP_SESSION_ID, sid);
+            }
+            catch {
+                // Headers may already be sent; never block the request.
+            }
+        }
+        return originalSend.call(this, body);
+    };
+    XMLHttpRequest.__sp_sdk_patched_xhr = true;
+}
+function patchFetchAPI() {
+    if (typeof globalThis.fetch === "undefined")
+        return;
+    const g = globalThis;
+    if (g.fetch.__sp_sdk_patched_fetch)
+        return;
+    const originalFetch = g.fetch.bind(globalThis);
+    g.fetch = (async function patchedFetch(resource, options) {
+        const sid = currentSessionId();
+        if (!sid || !isSameOriginRequest(resource)) {
+            return originalFetch(resource, options);
+        }
+        try {
+            if (typeof Request !== "undefined" && resource instanceof Request) {
+                const headers = new Headers(resource.headers);
+                if (options?.headers) {
+                    new Headers(options.headers).forEach((value, key) => {
+                        headers.set(key, value);
+                    });
+                }
+                headers.set(HEADER_X_SP_SESSION_ID, sid);
+                return originalFetch(resource, { ...options, headers });
+            }
+            const next = { ...(options ?? {}) };
+            const headers = next.headers ?? {};
+            if (headers instanceof Headers) {
+                headers.set(HEADER_X_SP_SESSION_ID, sid);
+                next.headers = headers;
+            }
+            else if (Array.isArray(headers)) {
+                next.headers = [...headers, [HEADER_X_SP_SESSION_ID, sid]];
+            }
+            else {
+                next.headers = {
+                    ...headers,
+                    [HEADER_X_SP_SESSION_ID]: sid,
+                };
+            }
+            return originalFetch(resource, next);
+        }
+        catch {
+            return originalFetch(resource, options);
+        }
+    });
+    g.fetch.__sp_sdk_patched_fetch = true;
+}
+//# sourceMappingURL=http-interceptor.js.map

package/dist/http-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-interceptor.js","sourceRoot":"","sources":["../src/http-interceptor.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAIjD,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AAEvD,MAAM,UAAU,sBAAsB;IACpC,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAA+B;IACvE,iBAAiB,GAAG,YAAY,CAAC;IACjC,mBAAmB,EAAE,CAAC;IACtB,aAAa,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,YAA+B;IAC5E,iBAAiB,GAAG,YAAY,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,QAA2B;IAC7D,IAAI,CAAC;QACH,IAAI,IAAY,CAAC;QACjB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YAClE,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC;aAAM,IAAI,QAAQ,YAAY,GAAG,EAAE,CAAC;YACnC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAED,+DAA+D;QAC/D,2EAA2E;QAC3E,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,sEAAsE;YACtE,mEAAmE;YACnE,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB;IAC1B,IAAI,OAAO,cAAc,KAAK,WAAW;QAAE,OAAO;IAClD,IAAK,cAAgE,CAAC,oBAAoB,EAAE,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC;IACnD,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC;IAEnD,cAAc,CAAC,SAAS,CAAC,IAAI,GAAG,UAE9B,MAAc,EACd,GAAiB,EACjB,KAAe,EACf,QAAwB,EACxB,QAAwB;QAEvB,IAA6D,CAAC,gBAAgB;YAC7E,GAAG,CAAC;QACN,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC,CAAC;IAEF,cAAc,CAAC,SAAS,CAAC,IAAI,GAAG,UAE9B,IAA+C;QAE/C,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAI,IAA6D;aACvE,gBAAgB,CAAC;QACpB,IAAI,GAAG,IAAI,GAAG,KAAK,SAAS,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,IAAI,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC;IAED,cAAgE,CAAC,oBAAoB,GAAG,IAAI,CAAC;AAChG,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO;IACpD,MAAM,CAAC,GAAG,UAET,CAAC;IACF,IAAI,CAAC,CAAC,KAAK,CAAC,sBAAsB;QAAE,OAAO;IAE3C,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE/C,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,UAAU,YAAY,CACpC,QAA2B,EAC3B,OAAqB;QAErB,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,OAAO,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC;YACH,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;gBAClE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC9C,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;oBACrB,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;wBAClD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBAC1B,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;gBACzC,OAAO,aAAa,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,MAAM,IAAI,GAAgB,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;YACnC,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;gBACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACzB,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,GAAG;oBACb,GAAI,OAAkC;oBACtC,CAAC,sBAAsB,CAAC,EAAE,GAAG;iBAC9B,CAAC;YACJ,CAAC;YACD,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAiB,CAAC;IAEnB,CAAC,CAAC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { RecordSdk } from "./sdk.js";
+export { buildRecordingExport, msToUnixNano, randomHexId, EVENT_NAME, EVENTS_ATTR, SPAN_NAME, } from "./otlp.js";
+export { getSessionIdHeaderName, initializeHttpInterceptor, updateHttpInterceptorSessionId, } from "./http-interceptor.js";
+export type { CompressedRrwebEvent, RecordingHandle, RrwebEventBatchItem, SystemInfo, Tags, WebRecordController, WebRecordCredentials, WebRecordInitOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,IAAI,EACJ,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { RecordSdk } from "./sdk.js";
+export { buildRecordingExport, msToUnixNano, randomHexId, EVENT_NAME, EVENTS_ATTR, SPAN_NAME, } from "./otlp.js";
+export { getSessionIdHeaderName, initializeHttpInterceptor, updateHttpInterceptorSessionId, } from "./http-interceptor.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC"}

package/dist/otlp.d.ts

@@ -0,0 +1,37 @@
+import type { RrwebEventBatchItem } from "./types.js";
+declare const SPAN_NAME = "softprobe.web.recording";
+declare const EVENT_NAME = "sp.recording.batch";
+declare const EVENTS_ATTR = "sp.recording.events";
+export type OtlpStringAttr = {
+    key: string;
+    value: {
+        stringValue: string;
+    };
+};
+export type OtlpIntAttr = {
+    key: string;
+    value: {
+        intValue: string;
+    };
+};
+export type OtlpAttr = OtlpStringAttr | OtlpIntAttr;
+export type BuildRecordingSpanInput = {
+    traceId: string;
+    spanId: string;
+    sessionId: string;
+    batchIndex: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    events: RrwebEventBatchItem[];
+    attributes: Record<string, string | number | boolean | null | undefined>;
+    serviceName?: string;
+    environment?: string;
+};
+/** Build an OTLP JSON ExportTraceServiceRequest for one recording flush. */
+export declare function buildRecordingExport(input: BuildRecordingSpanInput): {
+    resourceSpans: unknown[];
+};
+export declare function randomHexId(bytes: number): string;
+export declare function msToUnixNano(ms: number): string;
+export { SPAN_NAME, EVENT_NAME, EVENTS_ATTR };
+//# sourceMappingURL=otlp.d.ts.map

package/dist/otlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../src/otlp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,QAAA,MAAM,SAAS,4BAA4B,CAAC;AAC5C,QAAA,MAAM,UAAU,uBAAuB,CAAC;AACxC,QAAA,MAAM,WAAW,wBAAwB,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,WAAW,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAyBF,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG;IACpE,aAAa,EAAE,OAAO,EAAE,CAAC;CAC1B,CAmDA;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/otlp.js

@@ -0,0 +1,81 @@
+const SPAN_NAME = "softprobe.web.recording";
+const EVENT_NAME = "sp.recording.batch";
+const EVENTS_ATTR = "sp.recording.events";
+function stringAttr(key, value) {
+    return { key, value: { stringValue: value } };
+}
+function intAttr(key, value) {
+    return { key, value: { intValue: String(Math.trunc(value)) } };
+}
+function toAttrs(attributes) {
+    const out = [];
+    for (const [key, raw] of Object.entries(attributes)) {
+        if (raw === undefined || raw === null)
+            continue;
+        if (typeof raw === "number" && Number.isFinite(raw)) {
+            out.push(intAttr(key, raw));
+            continue;
+        }
+        out.push(stringAttr(key, String(raw)));
+    }
+    return out;
+}
+/** Build an OTLP JSON ExportTraceServiceRequest for one recording flush. */
+export function buildRecordingExport(input) {
+    const attrs = [
+        stringAttr("sp.session.id", input.sessionId),
+        stringAttr("sp.observation.type", "recording"),
+        intAttr("sp.recording.batch_index", input.batchIndex),
+        ...toAttrs(input.attributes),
+    ];
+    const resourceAttrs = [];
+    if (input.serviceName) {
+        resourceAttrs.push(stringAttr("service.name", input.serviceName));
+    }
+    if (input.environment) {
+        resourceAttrs.push(stringAttr("deployment.environment.name", input.environment));
+    }
+    return {
+        resourceSpans: [
+            {
+                resource: { attributes: resourceAttrs },
+                scopeSpans: [
+                    {
+                        scope: { name: "softprobe.web.record", version: "0.1.0" },
+                        spans: [
+                            {
+                                traceId: input.traceId,
+                                spanId: input.spanId,
+                                name: SPAN_NAME,
+                                kind: 1,
+                                startTimeUnixNano: input.startTimeUnixNano,
+                                endTimeUnixNano: input.endTimeUnixNano,
+                                attributes: attrs,
+                                events: [
+                                    {
+                                        timeUnixNano: input.endTimeUnixNano,
+                                        name: EVENT_NAME,
+                                        attributes: [
+                                            stringAttr(EVENTS_ATTR, JSON.stringify(input.events)),
+                                        ],
+                                    },
+                                ],
+                                status: { code: 1 },
+                            },
+                        ],
+                    },
+                ],
+            },
+        ],
+    };
+}
+export function randomHexId(bytes) {
+    const buf = new Uint8Array(bytes);
+    crypto.getRandomValues(buf);
+    return Array.from(buf, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+export function msToUnixNano(ms) {
+    return `${BigInt(Math.trunc(ms)) * 1000000n}`;
+}
+export { SPAN_NAME, EVENT_NAME, EVENTS_ATTR };
+//# sourceMappingURL=otlp.js.map

package/dist/otlp.js.map

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

package/dist/sdk.d.ts

@@ -0,0 +1,53 @@
+import { type eventWithTime } from "@rrweb/types";
+import type { RecordingHandle, Tags, WebRecordController, WebRecordInitOptions } from "./types.js";
+type Compressible = eventWithTime & {
+    data?: unknown;
+    isCompressed?: boolean;
+    eventIndex?: number;
+};
+export declare class RecordSdk implements WebRecordController {
+    readonly enabled: boolean;
+    private _sessionId;
+    private readonly otlpEndpoint;
+    private readonly publicKey;
+    private readonly intervalMs;
+    private readonly serviceName?;
+    private readonly environment?;
+    private readonly userId?;
+    private readonly maskAllInputs;
+    private readonly recordOptions;
+    private readonly replacers;
+    private tags;
+    private events;
+    private eventIndex;
+    private lastSnapshotIndex;
+    private batchIndex;
+    private visitorId;
+    private systemInfo;
+    private stopHandle;
+    private saving;
+    private fetchImpl;
+    /** Serializes setSessionId drains so overlapping navigations cannot race. */
+    private sessionSwitch;
+    private constructor();
+    get sessionId(): string;
+    static init(options?: WebRecordInitOptions): WebRecordController;
+    record(opts?: {
+        tags?: Tags;
+    }): RecordingHandle | null;
+    stop(): void;
+    setTags(tags: Tags, override?: boolean): void;
+    setSessionId(sessionId: string): Promise<void>;
+    private switchSessionId;
+    /**
+     * Wait out in-flight exports, then flush until the buffer is empty.
+     * Stops after a failed flush so we do not spin forever when OTLP is down
+     * (events stay queued under the old session for a later attempt / stop).
+     */
+    private drainFlush;
+    compressEvent(event: Compressible): Compressible;
+    flush(): Promise<boolean>;
+    private collectSystemInfo;
+}
+export {};
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB7D,OAAO,KAAK,EACV,eAAe,EAEf,IAAI,EACJ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB,KAAK,YAAY,GAAG,aAAa,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,SAAU,YAAW,mBAAmB;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAuD;IACzE,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,6EAA6E;IAC7E,OAAO,CAAC,aAAa,CAAoC;IAEzD,OAAO;IAgCP,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,oBAAiD,GAAG,mBAAmB;IAsC5F,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,eAAe,GAAG,IAAI;IA2CtD,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,UAAQ,GAAG,IAAI;IAI3C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAUhC,eAAe;IAQ7B;;;;OAIG;YACW,UAAU;IAcxB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IAkB1C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;YA0DjB,iBAAiB;CAqDhC"}

package/dist/sdk.js

@@ -0,0 +1,356 @@
+import { EventType } from "@rrweb/types";
+import { pack, record as rrwebRecord } from "rrweb";
+import { asNonEmptyString, deriveOtlpEndpoint, resolveSoftprobeConfigFromObject, MissingSoftprobeCredentialsError, } from "@softprobe/tracing/config";
+import { initializeHttpInterceptor, updateHttpInterceptorSessionId, } from "./http-interceptor.js";
+import { buildRecordingExport, msToUnixNano, randomHexId, } from "./otlp.js";
+const MAX_EVENTS = 500;
+const COOKIE_NAME = "_sp_vid";
+const COOKIE_MAX_AGE = 365 * 24 * 60 * 60;
+export class RecordSdk {
+    enabled;
+    _sessionId;
+    otlpEndpoint;
+    publicKey;
+    intervalMs;
+    serviceName;
+    environment;
+    userId;
+    maskAllInputs;
+    recordOptions;
+    replacers;
+    tags;
+    events = [];
+    eventIndex = 0;
+    lastSnapshotIndex = 0;
+    batchIndex = 0;
+    visitorId;
+    systemInfo = null;
+    stopHandle = null;
+    saving = false;
+    fetchImpl;
+    /** Serializes setSessionId drains so overlapping navigations cannot race. */
+    sessionSwitch = Promise.resolve();
+    constructor(options) {
+        this.enabled = options.enabled;
+        this.publicKey = options.publicKey ?? "";
+        this.otlpEndpoint = options.otlpEndpoint;
+        this._sessionId = asNonEmptyString(options.sessionId) ?? uuid();
+        this.intervalMs = Math.max(options.interval ?? 5000, 5000);
+        this.serviceName = options.serviceName;
+        this.environment = options.environment;
+        this.userId = options.userId;
+        this.maskAllInputs = options.maskAllInputs !== false;
+        this.recordOptions = options.recordOptions ?? {};
+        this.replacers = options.replacers ?? {};
+        this.tags = { ...(options.tags ?? {}) };
+        if (this.userId && !this.tags.userId)
+            this.tags.userId = this.userId;
+        this.visitorId = getOrCreateVisitorId();
+        this.fetchImpl =
+            typeof globalThis.fetch === "function"
+                ? globalThis.fetch.bind(globalThis)
+                : (async () => {
+                    throw new Error("fetch is not available");
+                });
+        if (this.enabled) {
+            initializeHttpInterceptor(() => this._sessionId);
+            if (!options.manual) {
+                this.record();
+            }
+        }
+    }
+    get sessionId() {
+        return this._sessionId;
+    }
+    static init(options = {}) {
+        const softDisable = options.softDisable !== false;
+        try {
+            const resolved = resolveSoftprobeConfigFromObject({
+                publicKey: options.publicKey,
+                baseUrl: options.baseUrl,
+                otlpEndpoint: options.otlpEndpoint,
+                environment: options.environment,
+                userId: options.userId,
+                serviceName: options.serviceName ?? "softprobe-web",
+            });
+            return new RecordSdk({
+                ...options,
+                publicKey: resolved.publicKey,
+                baseUrl: resolved.baseUrl,
+                otlpEndpoint: resolved.otlpEndpoint,
+                environment: resolved.environment,
+                userId: resolved.userId,
+                serviceName: resolved.serviceName,
+                enabled: true,
+            });
+        }
+        catch (err) {
+            if (softDisable && err instanceof MissingSoftprobeCredentialsError) {
+                console.warn("[@softprobe/web-record] Softprobe credentials missing; recording disabled.");
+                return new RecordSdk({
+                    publicKey: "",
+                    baseUrl: "",
+                    otlpEndpoint: deriveOtlpEndpoint("http://127.0.0.1"),
+                    enabled: false,
+                    manual: true,
+                });
+            }
+            throw err;
+        }
+    }
+    record(opts) {
+        if (!this.enabled)
+            return null;
+        if (this.stopHandle)
+            return this.stopHandle;
+        if (opts?.tags)
+            this.setTags(opts.tags);
+        const stopFn = rrwebRecord({
+            maskAllInputs: this.maskAllInputs,
+            ...this.recordOptions,
+            emit: (raw) => {
+                const event = raw;
+                if (this.events.length >= MAX_EVENTS)
+                    this.events.shift();
+                const withIndex = this.compressEvent({
+                    ...event,
+                    eventIndex: ++this.eventIndex,
+                });
+                this.events.push(withIndex);
+            },
+        });
+        const intervalId = setInterval(() => {
+            void this.flush();
+            if (this.events.length) {
+                const last = this.events[this.events.length - 1];
+                const lastIndex = Number(last?.eventIndex ?? 0);
+                if (this.lastSnapshotIndex + 50 < lastIndex) {
+                    rrwebRecord.takeFullSnapshot();
+                    this.lastSnapshotIndex = lastIndex;
+                }
+            }
+        }, this.intervalMs);
+        this.stopHandle = {
+            stop: () => {
+                clearInterval(intervalId);
+                stopFn?.();
+                void this.flush();
+                this.stopHandle = null;
+            },
+        };
+        return this.stopHandle;
+    }
+    stop() {
+        this.stopHandle?.stop();
+    }
+    setTags(tags, override = false) {
+        this.tags = override ? { ...tags } : { ...this.tags, ...tags };
+    }
+    setSessionId(sessionId) {
+        const next = asNonEmptyString(sessionId);
+        if (!next || next === this._sessionId)
+            return Promise.resolve();
+        // Serialize switches so overlapping navigations cannot race the drain.
+        this.sessionSwitch = this.sessionSwitch
+            .catch(() => undefined)
+            .then(() => this.switchSessionId(next));
+        return this.sessionSwitch;
+    }
+    async switchSessionId(next) {
+        await this.drainFlush();
+        this._sessionId = next;
+        if (this.enabled) {
+            updateHttpInterceptorSessionId(() => this._sessionId);
+        }
+    }
+    /**
+     * Wait out in-flight exports, then flush until the buffer is empty.
+     * Stops after a failed flush so we do not spin forever when OTLP is down
+     * (events stay queued under the old session for a later attempt / stop).
+     */
+    async drainFlush() {
+        for (;;) {
+            while (this.saving) {
+                await new Promise((r) => setTimeout(r, 0));
+            }
+            if (this.events.length === 0)
+                return;
+            const before = this.events.length;
+            const ok = await this.flush();
+            if (!ok)
+                return;
+            // flush is a no-op when saving raced; avoid busy-loop.
+            if (this.events.length >= before)
+                return;
+        }
+    }
+    compressEvent(event) {
+        if (event.type === EventType.FullSnapshot) {
+            try {
+                const compressedData = pack(event.data);
+                return {
+                    type: event.type,
+                    data: compressedData,
+                    timestamp: event.timestamp,
+                    isCompressed: true,
+                    eventIndex: event.eventIndex,
+                };
+            }
+            catch (e) {
+                console.error("Failed to compress FullSnapshot:", e);
+            }
+        }
+        return event;
+    }
+    async flush() {
+        if (!this.enabled || this.events.length === 0 || this.saving)
+            return true;
+        this.saving = true;
+        // Splice out the batch BEFORE await so events recorded while export is in
+        // flight stay in `this.events` and are not dropped on success.
+        const batch = this.events.splice(0, this.events.length);
+        const batchIndex = this.batchIndex;
+        try {
+            if (!this.systemInfo)
+                this.systemInfo = await this.collectSystemInfo();
+            const tags = {
+                ...this.systemInfo,
+                ...this.tags,
+            };
+            for (const [key, value] of Object.entries(this.replacers)) {
+                if (key in tags && value)
+                    tags[key] = value;
+            }
+            const now = Date.now();
+            const startMs = typeof batch[0]?.timestamp === "number" ? batch[0].timestamp : now;
+            const body = buildRecordingExport({
+                traceId: randomHexId(16),
+                spanId: randomHexId(8),
+                sessionId: this._sessionId,
+                batchIndex,
+                startTimeUnixNano: msToUnixNano(startMs),
+                endTimeUnixNano: msToUnixNano(now),
+                events: batch,
+                attributes: tags,
+                serviceName: this.serviceName,
+                environment: this.environment,
+            });
+            const res = await this.fetchImpl(this.otlpEndpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.publicKey}`,
+                },
+                body: JSON.stringify(body),
+                redirect: "follow",
+            });
+            if (!res.ok) {
+                throw new Error(`OTLP export failed: ${res.status} ${await res.text()}`);
+            }
+            this.batchIndex = batchIndex + 1;
+            return true;
+        }
+        catch (error) {
+            console.error("[@softprobe/web-record] Failed to flush recording:", error);
+            this.events.unshift(...batch);
+            return false;
+        }
+        finally {
+            this.saving = false;
+        }
+    }
+    async collectSystemInfo() {
+        let ua = "";
+        let os = "Unknown";
+        let osVersion = "Unknown";
+        let browser = "Unknown";
+        let browserVersion = "Unknown";
+        let cpu = "Unknown";
+        let device = "desktop";
+        try {
+            const { UAParser } = await import("ua-parser-js");
+            const parser = new UAParser();
+            const result = await parser.getResult().withClientHints();
+            ua = result.ua;
+            os = result.os.name || "Unknown";
+            osVersion = result.os.version || "Unknown";
+            browser = result.browser.name || "Unknown";
+            browserVersion = result.browser.version || "Unknown";
+            cpu = result.cpu.architecture || "Unknown";
+            device = result.device.type || "desktop";
+        }
+        catch {
+            ua = typeof navigator !== "undefined" ? navigator.userAgent : "";
+        }
+        return {
+            _sp_ua: ua,
+            _sp_url: typeof window !== "undefined"
+                ? window.location.hostname + window.location.pathname
+                : "",
+            _sp_search: typeof window !== "undefined" ? window.location.search : "",
+            _sp_referer: typeof document !== "undefined" ? document.referrer || null : null,
+            _sp_os: os,
+            _sp_osVersion: osVersion,
+            _sp_browser: browser,
+            _sp_browserVersion: browserVersion,
+            _sp_cpu: cpu,
+            _sp_device: device,
+            _sp_width: typeof window !== "undefined" ? window.innerWidth : 0,
+            _sp_height: typeof window !== "undefined" ? window.innerHeight : 0,
+            _sp_scrollWidth: typeof document !== "undefined"
+                ? document.documentElement.scrollWidth
+                : 0,
+            _sp_scrollHeight: typeof document !== "undefined"
+                ? document.documentElement.scrollHeight
+                : 0,
+            _sp_vid: this.visitorId,
+        };
+    }
+}
+function uuid() {
+    return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (c) => {
+        const n = Number(c);
+        return (n ^
+            (crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (n / 4)))).toString(16);
+    });
+}
+function getOrCreateVisitorId() {
+    if (typeof document === "undefined")
+        return uuid();
+    const existing = getCookie(COOKIE_NAME);
+    if (existing)
+        return existing;
+    const id = uuid();
+    setCookie(COOKIE_NAME, id);
+    return id;
+}
+function setCookie(name, value) {
+    try {
+        const isLocalhost = typeof window !== "undefined" && window.location.hostname === "localhost";
+        const parts = [
+            `${name}=${encodeURIComponent(value)}`,
+            `max-age=${COOKIE_MAX_AGE}`,
+            "path=/",
+        ];
+        if (!isLocalhost && typeof window !== "undefined") {
+            const host = window.location.hostname;
+            const base = host.split(".").slice(-2).join(".");
+            parts.push(`domain=.${base}`, "SameSite=None", "Secure");
+        }
+        document.cookie = parts.join("; ");
+    }
+    catch {
+        // ignore cookie failures
+    }
+}
+function getCookie(name) {
+    if (typeof document === "undefined")
+        return null;
+    for (const cookie of document.cookie.split(";")) {
+        const [cookieName, cookieValue] = cookie.trim().split("=");
+        if (cookieName === name)
+            return cookieValue ?? null;
+    }
+    return null;
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+/** Browser session metadata tags collected from UA / viewport. */
+export type SystemInfo = {
+    _sp_ua: string;
+    _sp_url: string;
+    _sp_search: string;
+    _sp_referer: string | null;
+    _sp_os: string;
+    _sp_osVersion: string;
+    _sp_browser: string;
+    _sp_browserVersion: string;
+    _sp_cpu: string;
+    _sp_device: string;
+    _sp_width: number;
+    _sp_height: number;
+    _sp_scrollWidth: number;
+    _sp_scrollHeight: number;
+    _sp_vid: string;
+};
+export type Tags = {
+    userId?: string;
+    clientId?: string;
+    email?: string;
+    phoneNo?: string;
+    [key: string]: string | undefined;
+};
+export type WebRecordCredentials = {
+    publicKey: string;
+    baseUrl: string;
+    /** Defaults to `{baseUrl}/v1/traces`. */
+    otlpEndpoint?: string;
+    environment?: string;
+    userId?: string;
+    serviceName?: string;
+};
+export type WebRecordInitOptions = WebRecordCredentials & {
+    /** Correlate with LLM / OpenCode session (`sp.session.id`). */
+    sessionId?: string;
+    /** Flush interval in ms (minimum 5000). */
+    interval?: number;
+    /** When true, do not auto-start rrweb. */
+    manual?: boolean;
+    tags?: Tags;
+    replacers?: Record<string, string>;
+    /** Soft-disable instead of throwing when credentials are incomplete. Default true. */
+    softDisable?: boolean;
+    /** rrweb: mask all inputs. Default true for agent IDEs. */
+    maskAllInputs?: boolean;
+    /** Extra rrweb record options (emit is owned by the SDK). */
+    recordOptions?: Record<string, unknown>;
+};
+export type CompressedRrwebEvent = {
+    type: number;
+    data: string;
+    timestamp: number;
+    isCompressed: true;
+    eventIndex?: number;
+};
+export type RrwebEventBatchItem = Record<string, unknown> & {
+    type: number;
+    timestamp: number;
+    eventIndex?: number;
+    isCompressed?: boolean;
+};
+export type RecordingHandle = {
+    stop: () => void;
+};
+export type WebRecordController = {
+    readonly enabled: boolean;
+    readonly sessionId: string;
+    record: (opts?: {
+        tags?: Tags;
+    }) => RecordingHandle | null;
+    stop: () => void;
+    setTags: (tags: Tags, override?: boolean) => void;
+    /** Switch correlation id (e.g. when OpenCode chat session changes). */
+    setSessionId: (sessionId: string) => void | Promise<void>;
+    flush: () => Promise<boolean>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACxD,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,KAAK,eAAe,GAAG,IAAI,CAAC;IAC3D,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,uEAAuE;IACvE,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/B,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@softprobe/web-record",
+  "version": "0.1.0",
+  "description": "Browser session recording SDK that exports rrweb batches to Softprobe via OTLP",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@rrweb/types": "2.0.0-alpha.4",
+    "@softprobe/tracing": "0.1.5",
+    "rrweb": "2.0.0-alpha.4",
+    "ua-parser-js": "^2.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "jsdom": "^26.0.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.8"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "softprobe",
+    "session-replay",
+    "rrweb",
+    "opentelemetry",
+    "otlp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/softprobe/softprobe-js.git",
+    "directory": "packages/web-record"
+  },
+  "license": "MIT"
+}