@spanwise/rum 0.4.3

package/dist/trace-context.d.ts

@@ -0,0 +1,37 @@
+/**
+ * W3C Trace Context utilities for browser-side distributed tracing.
+ * Implements the W3C Trace Context specification:
+ * https://www.w3.org/TR/trace-context/
+ *
+ * traceparent format: version-traceId-spanId-flags
+ * Example: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01
+ */
+export type TraceparentData = {
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+};
+/**
+ * Generate a random 32-character hex trace ID (16 bytes).
+ * Uses crypto.getRandomValues for cryptographically secure randomness.
+ */
+export declare function generateTraceId(): string;
+/**
+ * Generate a random 16-character hex span ID (8 bytes).
+ */
+export declare function generateSpanId(): string;
+/**
+ * Parse a W3C traceparent header into its components.
+ * Returns null if the header is invalid.
+ */
+export declare function parseTraceparent(header: string): TraceparentData | null;
+/**
+ * Create a W3C traceparent header value.
+ */
+export declare function createTraceparent(traceId: string, spanId: string, sampled: boolean): string;
+/**
+ * Check if a URL should have trace context propagated.
+ * Propagates to same-origin, same root domain, or explicitly allowed origins.
+ */
+export declare function shouldPropagate(url: string, propagateToOrigins?: (string | RegExp)[]): boolean;
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAkBvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACd,MAAM,CAGR;AAeD;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,kBAAkB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACtC,OAAO,CAuCT"}

package/dist/trace-context.js

@@ -0,0 +1,113 @@
+/**
+ * W3C Trace Context utilities for browser-side distributed tracing.
+ * Implements the W3C Trace Context specification:
+ * https://www.w3.org/TR/trace-context/
+ *
+ * traceparent format: version-traceId-spanId-flags
+ * Example: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01
+ */
+const TRACEPARENT_REGEX = /^00-([a-f0-9]{32})-([a-f0-9]{16})-([a-f0-9]{2})$/;
+/**
+ * Generate a random 32-character hex trace ID (16 bytes).
+ * Uses crypto.getRandomValues for cryptographically secure randomness.
+ */
+export function generateTraceId() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+/**
+ * Generate a random 16-character hex span ID (8 bytes).
+ */
+export function generateSpanId() {
+    const bytes = new Uint8Array(8);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+/**
+ * Parse a W3C traceparent header into its components.
+ * Returns null if the header is invalid.
+ */
+export function parseTraceparent(header) {
+    const match = header.match(TRACEPARENT_REGEX);
+    if (!match)
+        return null;
+    const [, traceId, spanId, flags] = match;
+    if (!traceId || !spanId || !flags)
+        return null;
+    // Validate trace ID is not all zeros
+    if (traceId === "00000000000000000000000000000000")
+        return null;
+    // Validate span ID is not all zeros
+    if (spanId === "0000000000000000")
+        return null;
+    return {
+        traceId,
+        spanId,
+        sampled: (Number.parseInt(flags, 16) & 0x01) === 1,
+    };
+}
+/**
+ * Create a W3C traceparent header value.
+ */
+export function createTraceparent(traceId, spanId, sampled) {
+    const flags = sampled ? "01" : "00";
+    return `00-${traceId}-${spanId}-${flags}`;
+}
+/**
+ * Extract the root domain from a hostname (e.g., "app.example.com" -> "example.com")
+ */
+function getRootDomain(hostname) {
+    const parts = hostname.split(".");
+    // Handle localhost and IP addresses
+    if (parts.length <= 2 || hostname === "localhost") {
+        return hostname;
+    }
+    // Return last two parts (e.g., "example.com")
+    return parts.slice(-2).join(".");
+}
+/**
+ * Check if a URL should have trace context propagated.
+ * Propagates to same-origin, same root domain, or explicitly allowed origins.
+ */
+export function shouldPropagate(url, propagateToOrigins) {
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url, window.location.origin);
+    }
+    catch {
+        return false;
+    }
+    // Always propagate to same origin
+    if (parsedUrl.origin === window.location.origin) {
+        return true;
+    }
+    // Auto-propagate to same root domain (e.g., app.example.com -> api.example.com)
+    const currentRootDomain = getRootDomain(window.location.hostname);
+    const targetRootDomain = getRootDomain(parsedUrl.hostname);
+    if (currentRootDomain === targetRootDomain) {
+        return true;
+    }
+    // Check against allowlist
+    if (propagateToOrigins && propagateToOrigins.length > 0) {
+        for (const pattern of propagateToOrigins) {
+            if (typeof pattern === "string") {
+                if (parsedUrl.origin === pattern ||
+                    parsedUrl.href.startsWith(pattern)) {
+                    return true;
+                }
+            }
+            else if (pattern instanceof RegExp) {
+                if (pattern.test(parsedUrl.href)) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=trace-context.js.map

package/dist/trace-context.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,15 @@
+import type { RumEvent } from "./events.js";
+export type TransportConfig = {
+    apiKey: string;
+    baseUrl: string;
+    serviceName?: string;
+    flushInterval?: number;
+    maxBatchSize?: number;
+};
+export declare function createTransport(config: TransportConfig): {
+    enqueue: (event: RumEvent) => void;
+    flush: () => Promise<void>;
+    flushBeacon: () => void;
+};
+export type Transport = ReturnType<typeof createTransport>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe;qBAgF9B,QAAQ,KAAG,IAAI;iBAlEf,OAAO,CAAC,IAAI,CAAC;uBAiCb,IAAI;EA8D5B;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/transport.js

@@ -0,0 +1,101 @@
+const DEFAULT_FLUSH_INTERVAL = 5000;
+const DEFAULT_MAX_BATCH_SIZE = 10;
+export function createTransport(config) {
+    const queue = [];
+    let flushTimer = null;
+    const flushInterval = config.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+    const maxBatchSize = config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+    function scheduleFlush() {
+        if (flushTimer)
+            return;
+        flushTimer = setTimeout(() => {
+            flushTimer = null;
+            flush();
+        }, flushInterval);
+    }
+    async function flush() {
+        if (queue.length === 0)
+            return;
+        const batch = queue.splice(0, maxBatchSize);
+        try {
+            const response = await fetch(`${config.baseUrl}/v1/ingest/rum`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": config.apiKey,
+                },
+                body: JSON.stringify({
+                    serviceName: config.serviceName,
+                    events: batch,
+                }),
+                keepalive: true,
+            });
+            if (!response.ok) {
+                // Re-queue failed events (but limit retries)
+                console.warn("[Spanwise RUM] Failed to send events:", response.status);
+            }
+        }
+        catch (error) {
+            console.warn("[Spanwise RUM] Failed to send events:", error);
+        }
+        // Continue flushing if more events in queue
+        if (queue.length > 0) {
+            scheduleFlush();
+        }
+    }
+    function flushBeacon() {
+        if (queue.length === 0)
+            return;
+        const batch = queue.splice(0);
+        const body = JSON.stringify({
+            serviceName: config.serviceName,
+            events: batch,
+        });
+        // Use fetch with keepalive for better reliability during page unload
+        // Falls back to sendBeacon if fetch fails
+        try {
+            fetch(`${config.baseUrl}/v1/ingest/rum`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": config.apiKey,
+                },
+                body,
+                keepalive: true,
+            }).catch(() => {
+                // Silently ignore - page is likely unloading
+            });
+        }
+        catch {
+            // Fallback to sendBeacon
+            const blob = new Blob([body], { type: "application/json" });
+            navigator.sendBeacon(`${config.baseUrl}/v1/ingest/rum?key=${config.apiKey}`, blob);
+        }
+    }
+    function enqueue(event) {
+        queue.push(event);
+        if (queue.length >= maxBatchSize) {
+            flush();
+        }
+        else {
+            scheduleFlush();
+        }
+    }
+    function setupUnloadHandler() {
+        window.addEventListener("visibilitychange", () => {
+            if (document.visibilityState === "hidden") {
+                flushBeacon();
+            }
+        });
+        window.addEventListener("pagehide", () => {
+            flushBeacon();
+        });
+    }
+    setupUnloadHandler();
+    return {
+        enqueue,
+        flush,
+        flushBeacon,
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/vitals.d.ts

@@ -0,0 +1,12 @@
+import type { VitalsEvent } from "./events.js";
+export type VitalsData = {
+    lcp?: number;
+    fid?: number;
+    cls?: number;
+    inp?: number;
+    ttfb?: number;
+    fcp?: number;
+};
+export type VitalsCallback = (event: VitalsEvent) => void;
+export declare function setupVitalsTracking(sessionId: string, userId: string | undefined, onVitals: VitalsCallback, onFlush?: () => void): void;
+//# sourceMappingURL=vitals.d.ts.map

package/dist/vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../src/vitals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C,MAAM,MAAM,UAAU,GAAG;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;AAEzD,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,MAAM,IAAI,GAClB,IAAI,CA8CN"}

package/dist/vitals.js

@@ -0,0 +1,48 @@
+import { onCLS, onFCP, onFID, onINP, onLCP, onTTFB } from "web-vitals";
+import { createBaseEvent } from "./events.js";
+export function setupVitalsTracking(sessionId, userId, onVitals, onFlush) {
+    const vitalsData = {};
+    let sent = false;
+    // Send all accumulated vitals once
+    function sendVitals() {
+        if (sent)
+            return;
+        if (Object.keys(vitalsData).length === 0)
+            return;
+        sent = true;
+        const event = {
+            ...createBaseEvent("vitals", sessionId, userId),
+            type: "vitals",
+            data: { ...vitalsData },
+        };
+        onVitals(event);
+        onFlush?.();
+    }
+    // Register web-vitals callbacks FIRST - they add internal visibilitychange
+    // listeners that will fire before ours and populate vitalsData
+    onLCP((metric) => {
+        vitalsData.lcp = metric.value;
+    });
+    onFID((metric) => {
+        vitalsData.fid = metric.value;
+    });
+    onCLS((metric) => {
+        vitalsData.cls = metric.value;
+    });
+    onINP((metric) => {
+        vitalsData.inp = metric.value;
+    });
+    onTTFB((metric) => {
+        vitalsData.ttfb = metric.value;
+    });
+    onFCP((metric) => {
+        vitalsData.fcp = metric.value;
+    });
+    // Register our listener AFTER web-vitals - fires after their callbacks populate data
+    document.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden") {
+            sendVitals();
+        }
+    });
+}
+//# sourceMappingURL=vitals.js.map

package/dist/vitals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.js","sourceRoot":"","sources":["../src/vitals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAa7C,MAAM,UAAU,mBAAmB,CAClC,SAAiB,EACjB,MAA0B,EAC1B,QAAwB,EACxB,OAAoB;IAEpB,MAAM,UAAU,GAAe,EAAE,CAAA;IACjC,IAAI,IAAI,GAAG,KAAK,CAAA;IAEhB,mCAAmC;IACnC,SAAS,UAAU;QAClB,IAAI,IAAI;YAAE,OAAM;QAChB,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEhD,IAAI,GAAG,IAAI,CAAA;QACX,MAAM,KAAK,GAAgB;YAC1B,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;YAC/C,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,EAAE,GAAG,UAAU,EAAE;SACvB,CAAA;QACD,QAAQ,CAAC,KAAK,CAAC,CAAA;QACf,OAAO,EAAE,EAAE,CAAA;IACZ,CAAC;IAED,2EAA2E;IAC3E,+DAA+D;IAC/D,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAChB,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAChB,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAChB,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAChB,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC,CAAC,CAAA;IACF,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACjB,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAA;IAC/B,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAChB,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,qFAAqF;IACrF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAClD,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;YAC3C,UAAU,EAAE,CAAA;QACb,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@spanwise/rum",
+	"version": "0.4.3",
+	"description": "Real User Monitoring SDK for Spanwise - track sessions, page views, clicks, and Core Web Vitals",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"files": ["dist"],
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"clean": "rm -rf dist"
+	},
+	"keywords": [
+		"spanwise",
+		"rum",
+		"monitoring",
+		"apm",
+		"web-vitals",
+		"analytics"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"web-vitals": "^4.2.4"
+	},
+	"devDependencies": {
+		"typescript": "^5.7.2"
+	}
+}