@owlpane/browser 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Owlpane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @owlpane/browser
+
+Zero-dependency real-user-monitoring SDK for browsers. Sends OTLP/HTTP JSON traces to the Owlpane ingest gateway.
+
+## Install and use
+
+```ts
+import { init } from "@owlpane/browser";
+
+init({
+  endpoint: "https://ingest.example.com",     // `/v1/traces` is appended
+  projectKey: "owl_ing_...",                   // sent as `Authorization: Bearer <key>`
+  serviceName: "web-shop",
+  environment: "production",
+  release: "1.4.2",
+  sampleRate: 1,                               // 0..1, decided per trace
+  propagateTraceTo: ["https://api.example.com", /^https:\/\/[a-z]+\.internal\.io\//],
+});
+```
+
+Script tag: `npm run build:iife -w @owlpane/browser` produces `dist/owlpane-browser.iife.js` (global `OwlpaneBrowser`). It uses `esbuild`, which is not a dependency of this package; it must be present in the workspace `node_modules`.
+
+`init()` never throws, is a no-op if called twice, and returns `{ sessionId, flush(), shutdown(), captureException(err) }`.
+
+## What it captures
+
+| Signal | Span name | Notes |
+| --- | --- | --- |
+| Page load | `documentLoad` | Root span of the page-view trace, navigation start to `loadEventEnd`. Phase timings are attributes, not child spans. |
+| Web Vitals | `webvital.LCP`, `webvital.CLS`, `webvital.INP` | Spans (not metrics) so they need no extra ingest path and share the page trace. Reported once, when the page becomes hidden. Child of `documentLoad`. |
+| JS errors | `exception` | `error` and `unhandledrejection`, with an `exception` span event (`exception.type`, `exception.message`, `exception.stacktrace`). Capped at 20 per page view. |
+| fetch / XHR | `HTTP <METHOD>` | Client spans, each its own trace. |
+
+### Attributes
+
+Resource: `service.name`, `service.version`, `deployment.environment.name`, `deployment.environment`, `telemetry.sdk.name=owlpane-browser`, `telemetry.sdk.language=webjs`, `telemetry.sdk.version`, `owlpane.rum=true`.
+
+Every span: `owlpane.rum="true"`, `session.id`, `browser.page.url` (origin + path), `browser.page.path`, `user_agent.original`, `browser.language`, `browser.platform`, `browser.mobile`.
+
+- `documentLoad`: `browser.navigation.type`, `browser.timing.{redirect,dns,connect,ttfb,response,dom_interactive,dom_content_loaded,load}_ms`, `browser.timing.transfer_size_bytes`.
+- `webvital.*`: `webvital.name`, `webvital.value`, `webvital.unit` (`ms` or `score`), `webvital.rating` (`good|needs-improvement|poor`), INP also `webvital.interactions`.
+- `exception`: `owlpane.error.source` (`onerror|unhandledrejection|manual`), `code.filepath`, `code.lineno`, `code.column`; span status ERROR.
+- HTTP: `http.request.method`, `url.full`, `server.address`, `http.response.status_code`, `error.type`; status ERROR for >= 400 or network failure.
+
+## Trace propagation
+
+A W3C `traceparent` header is added to requests to the page's own origin, and to any URL matching `propagateTraceTo` (string = URL prefix, RegExp = tested against the absolute URL). An existing `traceparent` is left alone. Cross-origin targets must allow the header in their CORS config (`Access-Control-Allow-Headers: traceparent`), otherwise the browser will fail the preflight and the request itself breaks. Only list origins you control.
+
+## Privacy
+
+Query strings, hashes and URL credentials are stripped from recorded URLs. `keepQuery: true` keeps the query (still never the hash). Request/response bodies and headers are never recorded. Page paths are recorded as-is, so avoid putting identifiers in paths you do not want stored.
+
+## Delivery and limits
+
+- Batched every 5s or 100 spans, bodies capped at 60,000 bytes (browsers limit `keepalive` bodies to 64 KiB), queue capped at 500 spans (oldest dropped).
+- Uses `fetch` with `keepalive: true` and flushes on `pagehide` and when the page becomes hidden. `navigator.sendBeacon` is deliberately not used: it cannot set an `Authorization` header.
+- Failures are dropped silently, no retry. Telemetry is best-effort.
+- The export request is never instrumented (the original `fetch` is captured before patching and the ingest endpoint is skipped).
+- The project key is visible to anyone who loads your page. Use a dedicated, revocable key for the browser.
+- The ingest gateway must answer CORS preflight for the browser to deliver anything (see the gateway notes from the platform team).
+- INP uses the `event` timing observer, LCP/CLS the standard entry types; unsupported browsers (e.g. Safari for INP/LCP in some versions) simply report fewer vitals. Values are approximations of the `web-vitals` library, not bit-identical. Vitals are reported once per page view (no SPA soft-navigation vitals).
+- XHR instrumentation patches `XMLHttpRequest.prototype`; it does not capture `sendBeacon`, WebSocket or resource-loading errors.
+- SPA route changes are not tracked as separate page views; `browser.page.path` reflects the path at span end.
+
+## Tests
+
+`npm test -w @owlpane/browser` (node:test + tsx, no DOM library; browser globals are injected fakes).

package/dist/dom-replay.d.ts

@@ -0,0 +1,13 @@
+import { type LogFetchLike } from "./log-otlp.js";
+import type { Attrs } from "./otlp.js";
+export type DomReplayOptions = {
+    logsUrl: string;
+    projectKey: string;
+    sessionId: string;
+    resource: Attrs;
+    fetch: LogFetchLike | undefined;
+    /** Max rrweb events buffered before flush (default 8). */
+    batchSize?: number;
+};
+/** Starts rrweb recording and ships events as OTLP logs. Returns stop handle. */
+export declare function startDomReplay(opts: DomReplayOptions): () => void;

package/dist/dom-replay.js

@@ -0,0 +1,40 @@
+import { buildLogsRequestBody, postLogs } from "./log-otlp.js";
+/** Starts rrweb recording and ships events as OTLP logs. Returns stop handle. */
+export function startDomReplay(opts) {
+    let seq = 0;
+    let buffer = [];
+    let stopRecord;
+    const flush = async () => {
+        if (!buffer.length)
+            return;
+        const batch = buffer;
+        buffer = [];
+        const records = batch.map((ev) => ({
+            timeMs: ev.timestamp,
+            body: JSON.stringify(ev),
+            attributes: {
+                "owlpane.replay.kind": "rrweb",
+                "owlpane.replay.session_id": opts.sessionId,
+                "owlpane.replay.seq": seq++,
+            },
+        }));
+        const body = buildLogsRequestBody(opts.resource, records);
+        await postLogs(opts.logsUrl, opts.projectKey, body, opts.fetch);
+    };
+    void import("rrweb").then(({ record }) => {
+        stopRecord = record({
+            emit(event) {
+                buffer.push(event);
+                if (buffer.length >= (opts.batchSize ?? 8))
+                    void flush();
+            },
+            maskAllInputs: true,
+            blockClass: "owlpane-replay-block",
+        });
+    });
+    return () => {
+        stopRecord?.();
+        void flush();
+    };
+}
+//# sourceMappingURL=dom-replay.js.map

package/dist/dom-replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-replay.js","sourceRoot":"","sources":["../src/dom-replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAelF,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,IAAsB;IACnD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,MAAM,GAAiB,EAAE,CAAC;IAC9B,IAAI,UAAoC,CAAC;IAEzC,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,EAAE,EAAE,CAAC,SAAS;YACpB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACxB,UAAU,EAAE;gBACV,qBAAqB,EAAE,OAAO;gBAC9B,2BAA2B,EAAE,IAAI,CAAC,SAAS;gBAC3C,oBAAoB,EAAE,GAAG,EAAE;aAC5B;SACF,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACvC,UAAU,GAAG,MAAM,CAAC;YAClB,IAAI,CAAC,KAAK;gBACR,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;oBAAE,KAAK,KAAK,EAAE,CAAC;YAC3D,CAAC;YACD,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,sBAAsB;SACnC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,UAAU,EAAE,EAAE,CAAC;QACf,KAAK,KAAK,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,43 @@
+/** Everything the SDK needs from the browser, injectable so it can be tested with fakes. */
+export type Env = {
+    /** Object whose `fetch` we patch (window). */
+    global: Record<string, any>;
+    fetch?: (...a: any[]) => Promise<any>;
+    Headers?: any;
+    Request?: any;
+    XMLHttpRequest?: any;
+    PerformanceObserver?: any;
+    addEventListener?: (type: string, fn: (ev: any) => void, opts?: any) => void;
+    location?: {
+        href: string;
+        origin?: string;
+    };
+    document?: {
+        visibilityState?: string;
+        readyState?: string;
+    };
+    navigator?: {
+        userAgent?: string;
+        language?: string;
+        platform?: string;
+        userAgentData?: {
+            mobile?: boolean;
+            platform?: string;
+        };
+    };
+    performance?: {
+        timeOrigin?: number;
+        now(): number;
+        getEntriesByType?: (t: string) => any[];
+    };
+    storage?: {
+        getItem(k: string): string | null;
+        setItem(k: string, v: string): void;
+    };
+    setTimeout?: (fn: () => void, ms: number) => unknown;
+    clearTimeout?: (h: unknown) => void;
+    now(): number;
+    random(): number;
+    randomBytes?: (n: number) => Uint8Array;
+};
+export declare function browserEnv(): Env;

package/dist/env.js

@@ -0,0 +1,29 @@
+export function browserEnv() {
+    const g = globalThis;
+    let storage;
+    try {
+        storage = g.sessionStorage;
+    }
+    catch {
+        storage = undefined;
+    }
+    return {
+        global: g,
+        fetch: typeof g.fetch === "function" ? g.fetch.bind(g) : undefined,
+        Headers: g.Headers,
+        Request: g.Request,
+        XMLHttpRequest: g.XMLHttpRequest,
+        PerformanceObserver: g.PerformanceObserver,
+        addEventListener: typeof g.addEventListener === "function" ? g.addEventListener.bind(g) : undefined,
+        location: g.location,
+        document: g.document,
+        navigator: g.navigator,
+        performance: g.performance,
+        storage,
+        setTimeout: (fn, ms) => g.setTimeout(fn, ms),
+        clearTimeout: (h) => g.clearTimeout(h),
+        now: () => Date.now(),
+        random: () => Math.random(),
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,GAAG,UAAiB,CAAC;IAC5B,IAAI,OAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,CAAC,cAAc,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,SAAS,CAAC;IACtB,CAAC;IACD,OAAO;QACL,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAClE,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,mBAAmB,EAAE,CAAC,CAAC,mBAAmB;QAC1C,gBAAgB,EAAE,OAAO,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACnG,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO;QACP,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;QAC5C,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACtC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/exporter.d.ts

@@ -0,0 +1,33 @@
+import { Attrs, SpanData } from "./otlp.js";
+import { SpanQueue } from "./queue.js";
+export type FetchLike = (input: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+    keepalive: boolean;
+    credentials?: "omit";
+}) => Promise<unknown>;
+export type ExporterOptions = {
+    /** Full OTLP traces URL, e.g. https://ingest.example.com/v1/traces */
+    url: string;
+    projectKey: string;
+    resource: Attrs;
+    version: string;
+    /** The ORIGINAL (un-instrumented) fetch. */
+    fetch: FetchLike | undefined;
+    setTimeout?: (fn: () => void, ms: number) => unknown;
+    clearTimeout?: (h: unknown) => void;
+    flushIntervalMs?: number;
+    maxBatchSpans?: number;
+    maxQueueSpans?: number;
+    /** Per-request body cap. Browsers cap keepalive fetch bodies at 64 KiB, so stay under it. */
+    maxPayloadBytes?: number;
+};
+export type Exporter = {
+    enqueue(span: SpanData): void;
+    flush(): Promise<void>;
+    readonly queue: SpanQueue;
+    stop(): void;
+};
+/** Batches spans and posts OTLP/HTTP JSON. Never throws and never rejects. */
+export declare function createExporter(o: ExporterOptions): Exporter;

package/dist/exporter.js

@@ -0,0 +1,85 @@
+import { buildRequestBody, encodeSpan } from "./otlp.js";
+import { SpanQueue } from "./queue.js";
+/** Batches spans and posts OTLP/HTTP JSON. Never throws and never rejects. */
+export function createExporter(o) {
+    const st = o.setTimeout ?? ((fn, ms) => setTimeout(fn, ms));
+    const ct = o.clearTimeout ?? ((h) => clearTimeout(h));
+    const interval = o.flushIntervalMs ?? 5000;
+    const maxBatch = o.maxBatchSpans ?? 100;
+    const maxPayload = o.maxPayloadBytes ?? 60_000;
+    const queue = new SpanQueue(o.maxQueueSpans ?? 500);
+    let timer;
+    let stopped = false;
+    // Leave room for the envelope (resource + scope) when sizing batches.
+    const envelope = buildRequestBody(o.resource, [], o.version).length + 64;
+    function schedule() {
+        if (timer !== undefined || stopped)
+            return;
+        timer = st(() => {
+            timer = undefined;
+            void flush();
+        }, interval);
+    }
+    function enqueue(span) {
+        if (stopped)
+            return;
+        try {
+            const json = JSON.stringify(encodeSpan(span));
+            queue.push({ json, bytes: json.length + 1 });
+            if (queue.size >= maxBatch)
+                void flush();
+            else
+                schedule();
+        }
+        catch {
+            /* never throw into the host app */
+        }
+    }
+    /** Starts every request synchronously (important on pagehide), then resolves when all settle. */
+    function flush() {
+        if (timer !== undefined) {
+            ct(timer);
+            timer = undefined;
+        }
+        const pending = [];
+        try {
+            while (queue.size) {
+                const batch = queue.take(maxBatch, Math.max(1000, maxPayload - envelope));
+                if (!batch.length)
+                    continue;
+                const body = buildRequestBody(o.resource, batch.map((b) => b.json), o.version);
+                try {
+                    const f = o.fetch;
+                    if (!f)
+                        continue;
+                    pending.push(Promise.resolve(f(o.url, {
+                        method: "POST",
+                        headers: { "content-type": "application/json", authorization: `Bearer ${o.projectKey}` },
+                        body,
+                        keepalive: true,
+                        credentials: "omit",
+                    })).catch(() => undefined));
+                }
+                catch {
+                    /* dropped: telemetry is best-effort */
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return Promise.all(pending).then(() => undefined);
+    }
+    return {
+        enqueue,
+        flush,
+        queue,
+        stop() {
+            stopped = true;
+            if (timer !== undefined)
+                ct(timer);
+            timer = undefined;
+        },
+    };
+}
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,19 @@
+/** Fills a Uint8Array with random bytes. Injected so tests are deterministic. */
+export type RandomBytes = (n: number) => Uint8Array;
+export declare function defaultRandomBytes(g?: {
+    crypto?: {
+        getRandomValues?: (a: Uint8Array) => Uint8Array;
+    };
+}): RandomBytes;
+/** Non-zero random hex id of `bytes` bytes (16 for trace ids, 8 for span ids). */
+export declare function randomId(rand: RandomBytes, bytes: number): string;
+export declare const newTraceId: (rand: RandomBytes) => string;
+export declare const newSpanId: (rand: RandomBytes) => string;
+export declare function formatTraceparent(traceId: string, spanId: string, sampled: boolean): string;
+export type Traceparent = {
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+};
+/** Parses a W3C traceparent (version 00 layout; unknown future versions accepted per spec). */
+export declare function parseTraceparent(value: string): Traceparent | null;

package/dist/ids.js

@@ -0,0 +1,46 @@
+export function defaultRandomBytes(g = globalThis) {
+    return (n) => {
+        const out = new Uint8Array(n);
+        if (g.crypto?.getRandomValues)
+            g.crypto.getRandomValues(out);
+        else
+            for (let i = 0; i < n; i++)
+                out[i] = Math.floor(Math.random() * 256);
+        return out;
+    };
+}
+function hex(bytes) {
+    let s = "";
+    for (const b of bytes)
+        s += (b < 16 ? "0" : "") + b.toString(16);
+    return s;
+}
+/** Non-zero random hex id of `bytes` bytes (16 for trace ids, 8 for span ids). */
+export function randomId(rand, bytes) {
+    for (let i = 0; i < 4; i++) {
+        const id = hex(rand(bytes));
+        if (/[1-9a-f]/.test(id))
+            return id;
+    }
+    return "0".repeat(bytes * 2 - 1) + "1";
+}
+export const newTraceId = (rand) => randomId(rand, 16);
+export const newSpanId = (rand) => randomId(rand, 8);
+export function formatTraceparent(traceId, spanId, sampled) {
+    return `00-${traceId}-${spanId}-${sampled ? "01" : "00"}`;
+}
+/** Parses a W3C traceparent (version 00 layout; unknown future versions accepted per spec). */
+export function parseTraceparent(value) {
+    const m = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})(-.*)?$/.exec(value.trim());
+    if (!m)
+        return null;
+    const [, ver, traceId, spanId, flags, rest] = m;
+    if (ver === "ff")
+        return null;
+    if (ver === "00" && rest)
+        return null;
+    if (/^0+$/.test(traceId) || /^0+$/.test(spanId))
+        return null;
+    return { traceId, spanId, sampled: (parseInt(flags, 16) & 1) === 1 };
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,kBAAkB,CAAC,IAAsE,UAAmB;IAC1H,OAAO,CAAC,CAAC,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC,MAAM,EAAE,eAAe;YAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;;YACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAC1E,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,KAAiB;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,IAAiB,EAAE,KAAa;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAiB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAiB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAElE,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc,EAAE,OAAgB;IACjF,OAAO,MAAM,OAAO,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC;AAID,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,CAAC,GAAG,mEAAmE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjG,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { Env } from "./env.js";
+import { newSpanId, newTraceId } from "./ids.js";
+export type OwlpaneBrowserOptions = {
+    /** Ingest base URL, e.g. 'https://ingest.example.com'. `/v1/traces` is appended. */
+    endpoint?: string;
+    /** Ingest key ('owl_ing_...'), sent as `Authorization: Bearer <key>`. */
+    projectKey: string;
+    serviceName: string;
+    environment?: string;
+    release?: string;
+    /** 0..1 share of page views/requests/errors kept (decided per trace). Default 1. */
+    sampleRate?: number;
+    /** Extra URL prefixes / regexes that receive a `traceparent` header. Same-origin always does. */
+    propagateTraceTo?: (string | RegExp)[];
+    /** Keep the query string in recorded URLs (default false: stripped to avoid leaking PII). */
+    keepQuery?: boolean;
+    /** Max exception spans per page view (default 20). */
+    maxErrorsPerPage?: number;
+    /** Test seam: replaces browser globals. */
+    env?: Env;
+    /** Record rrweb DOM to OTLP logs (requires server OWLPANE_DOM_REPLAY_ENABLED). */
+    recordDomReplay?: boolean;
+};
+export type OwlpaneBrowser = {
+    sessionId: string;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    captureException(error: unknown): void;
+};
+export declare const DEFAULT_ENDPOINT = "https://ingest.owlpane.com";
+/** Starts RUM collection. Safe to call once per page; never throws. */
+export declare function init(options: OwlpaneBrowserOptions): OwlpaneBrowser;
+export { newSpanId, newTraceId };
+export { formatTraceparent, parseTraceparent } from "./ids.js";
+export { sanitizeUrl, shouldPropagate } from "./url.js";
+export { startDomReplay } from "./dom-replay.js";

package/dist/index.js

@@ -0,0 +1,131 @@
+import { browserEnv } from "./env.js";
+import { createExporter } from "./exporter.js";
+import { defaultRandomBytes, newSpanId, newTraceId } from "./ids.js";
+import { instrumentFetch, instrumentXhr } from "./instrument-http.js";
+import { captureDocumentLoad, captureErrors, captureVitals, createErrorReporter } from "./observers.js";
+import { startDomReplay } from "./dom-replay.js";
+import { VERSION, createTracer } from "./tracer.js";
+import { sanitizeUrl, urlPath } from "./url.js";
+export const DEFAULT_ENDPOINT = "https://ingest.owlpane.com";
+let active;
+const NOOP = { sessionId: "", flush: async () => undefined, shutdown: async () => undefined, captureException: () => undefined };
+function sessionIdFor(env, rand) {
+    const K = "owlpane.sid";
+    try {
+        const v = env.storage?.getItem(K);
+        if (v && /^[0-9a-f]{16}$/.test(v))
+            return v;
+    }
+    catch {
+        /* storage may throw (privacy mode) */
+    }
+    const id = newSpanId(rand);
+    try {
+        env.storage?.setItem(K, id);
+    }
+    catch {
+        /* ignore */
+    }
+    return id;
+}
+/** Starts RUM collection. Safe to call once per page; never throws. */
+export function init(options) {
+    try {
+        if (active)
+            return active;
+        const env = options.env ?? browserEnv();
+        if (!options.projectKey || !options.serviceName)
+            return NOOP;
+        const opts = {
+            endpoint: (options.endpoint || DEFAULT_ENDPOINT).replace(/\/+$/, ""),
+            projectKey: options.projectKey,
+            serviceName: options.serviceName,
+            environment: options.environment,
+            release: options.release,
+            sampleRate: options.sampleRate ?? 1,
+            propagateTraceTo: options.propagateTraceTo ?? [],
+            keepQuery: options.keepQuery ?? false,
+            maxErrorsPerPage: options.maxErrorsPerPage ?? 20,
+        };
+        const tracesUrl = `${opts.endpoint}/v1/traces`;
+        const originalFetch = env.fetch; // captured BEFORE patching: exports must not be instrumented
+        const rand = env.randomBytes ?? defaultRandomBytes();
+        const sessionId = sessionIdFor(env, rand);
+        const resource = {
+            "service.name": opts.serviceName,
+            "service.version": opts.release,
+            "deployment.environment.name": opts.environment,
+            "deployment.environment": opts.environment,
+            "telemetry.sdk.name": "owlpane-browser",
+            "telemetry.sdk.language": "webjs",
+            "telemetry.sdk.version": VERSION,
+            "owlpane.rum": "true",
+        };
+        const exporter = createExporter({
+            url: tracesUrl,
+            projectKey: opts.projectKey,
+            version: VERSION,
+            fetch: originalFetch,
+            setTimeout: env.setTimeout,
+            clearTimeout: env.clearTimeout,
+            resource,
+        });
+        const pageUrl = () => {
+            const href = env.location?.href ?? "";
+            return { url: sanitizeUrl(href, undefined, opts.keepQuery), path: urlPath(href, undefined) };
+        };
+        const tracer = createTracer(env, opts, (s) => exporter.enqueue(s), sessionId, pageUrl);
+        const isOwnUrl = (abs) => abs.startsWith(opts.endpoint + "/") || abs === opts.endpoint;
+        // One trace per page view: 'documentLoad' is its root; vitals and errors hang off it.
+        const page = tracer.start("documentLoad", 1, { traceId: newTraceId(rand), startMs: env.performance?.timeOrigin ?? env.now() });
+        const ctx = { env, opts, tracer, page };
+        const undo = [];
+        if (originalFetch)
+            undo.push(instrumentFetch({ env, opts, tracer, isOwnUrl }, originalFetch));
+        undo.push(instrumentXhr({ env, opts, tracer, isOwnUrl }));
+        const report = createErrorReporter(ctx);
+        captureErrors(ctx, report);
+        captureDocumentLoad(ctx);
+        const vitals = captureVitals(ctx);
+        const hide = () => {
+            vitals.report();
+            void exporter.flush();
+        };
+        env.addEventListener?.("visibilitychange", () => {
+            if (env.document?.visibilityState === "hidden")
+                hide();
+        });
+        env.addEventListener?.("pagehide", hide);
+        let stopDomReplay;
+        if (options.recordDomReplay) {
+            stopDomReplay = startDomReplay({
+                logsUrl: `${opts.endpoint}/v1/logs`,
+                projectKey: opts.projectKey,
+                sessionId,
+                resource,
+                fetch: originalFetch,
+            });
+        }
+        active = {
+            sessionId,
+            flush: () => exporter.flush(),
+            captureException: (e) => report(e, "manual"),
+            async shutdown() {
+                stopDomReplay?.();
+                undo.forEach((u) => u());
+                exporter.stop();
+                await exporter.flush();
+                active = undefined;
+            },
+        };
+        return active;
+    }
+    catch {
+        return NOOP;
+    }
+}
+export { newSpanId, newTraceId };
+export { formatTraceparent, parseTraceparent } from "./ids.js";
+export { sanitizeUrl, shouldPropagate } from "./url.js";
+export { startDomReplay } from "./dom-replay.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":"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"}

package/dist/instrument-http.d.ts

@@ -0,0 +1,13 @@
+import type { Env } from "./env.js";
+import type { ResolvedOptions, Tracer } from "./tracer.js";
+type Ctx = {
+    env: Env;
+    opts: ResolvedOptions;
+    tracer: Tracer;
+    isOwnUrl: (abs: string) => boolean;
+};
+/** Replaces `global.fetch` with an instrumented wrapper. Returns an undo function. */
+export declare function instrumentFetch(c: Ctx, original: NonNullable<Env["fetch"]>): () => void;
+/** Patches XMLHttpRequest.prototype open/send. Returns an undo function. */
+export declare function instrumentXhr(c: Ctx): () => void;
+export {};