@squasher-ai/browser 0.1.0 → 0.2.0

package/dist/runtime/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/runtime/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,GAAG,SAAS,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAAC;IACxE,oBAAoB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzD;AAaD,eAAO,MAAM,4BAA4B,EAAE,qBAG1C,CAAC"}

package/dist/runtime/replay.js

@@ -0,0 +1,15 @@
+import { installReplayNetworkCapture } from "../replay-network.js";
+async function loadRecordingAdapter() {
+    const { record } = await import("rrweb");
+    const adapter = {
+        start: (options) => record(options),
+    };
+    if (record.addCustomEvent) {
+        adapter.emitCustomEvent = record.addCustomEvent;
+    }
+    return adapter;
+}
+export const defaultReplayRecorderRuntime = {
+    installNetworkCapture: installReplayNetworkCapture,
+    loadRecordingAdapter,
+};

package/dist/session.d.ts

@@ -1,13 +1,3 @@
-/**
- * Session management for the browser SDK.
- *
- * Generates a unique session ID per tab visit using crypto.randomUUID().
- * Stored in sessionStorage so it persists across SPA navigations but dies
- * when the tab closes — one session per tab visit.
- *
- * The session ID is attached to both error events and Web Vitals for
- * cross-correlation in the dashboard.
- */
 /**
  * Get (or create) the session ID for this tab.
  * Uses sessionStorage for persistence across SPA navigations.

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAOrC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC"}

package/dist/session.js

@@ -1,3 +1,4 @@
+import { attempt } from "@squasher-ai/result-utils";
 /**
  * Session management for the browser SDK.
  *
@@ -18,24 +19,22 @@ let cachedSessionId = null;
 export function getSessionId() {
     if (cachedSessionId)
         return cachedSessionId;
-    try {
-        const stored = sessionStorage.getItem(SESSION_KEY);
-        if (stored) {
-            cachedSessionId = stored;
-            return stored;
-        }
-    }
-    catch {
-        // sessionStorage unavailable (e.g. SSR, sandboxed iframes)
+    const stored = attempt({
+        try: () => sessionStorage.getItem(SESSION_KEY),
+        catch: () => null,
+    });
+    if (stored) {
+        cachedSessionId = stored;
+        return stored;
     }
     const id = crypto.randomUUID();
     cachedSessionId = id;
-    try {
-        sessionStorage.setItem(SESSION_KEY, id);
-    }
-    catch {
-        // Storage full or unavailable — fall back to in-memory
-    }
+    attempt({
+        try: () => {
+            sessionStorage.setItem(SESSION_KEY, id);
+        },
+        catch: () => undefined,
+    });
     return id;
 }
 /**
@@ -43,10 +42,10 @@ export function getSessionId() {
  */
 export function resetSessionId() {
     cachedSessionId = null;
-    try {
-        sessionStorage.removeItem(SESSION_KEY);
-    }
-    catch {
-        // Ignore
-    }
+    attempt({
+        try: () => {
+            sessionStorage.removeItem(SESSION_KEY);
+        },
+        catch: () => undefined,
+    });
 }

package/dist/telemetry.d.ts

@@ -1,4 +1,4 @@
-import type { Breadcrumb, BrowserErrorEvent, JsonObject, UserContext } from "./types";
+import type { Breadcrumb, BrowserErrorEvent, JsonObject, UserContext } from "./types.js";
 interface PrepareBrowserEventInput {
     beforeSend?: (event: BrowserErrorEvent) => BrowserErrorEvent | null;
     breadcrumbs: Breadcrumb[];

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtF,UAAU,wBAAwB;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACpE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAanB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAuBnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAQnB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,wBAAwB,GAC9B,iBAAiB,GAAG,IAAI,CAkC1B"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzF,UAAU,wBAAwB;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACpE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAanB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAqBnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAkBnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAYnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,iBAAiB,CAQnB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,wBAAwB,GAC9B,iBAAiB,GAAG,IAAI,CAkC1B"}

package/dist/telemetry.js

@@ -1,4 +1,4 @@
-import { getSessionId } from "./session";
+import { getSessionId } from "./session.js";
 export function mergeIdentifiedUser(currentUser, contextUser, distinctId) {
     return {
         ...currentUser,
@@ -54,10 +54,10 @@ export function buildPageEvent(name, properties, context) {
         page: {
             ...context.page,
             name: context.page?.name ?? name,
-            path: context.page?.path ?? (typeof location !== "undefined" ? location.pathname : undefined),
-            title: context.page?.title ?? (typeof document !== "undefined" ? document.title : undefined),
-            referrer: context.page?.referrer ?? (typeof document !== "undefined" ? document.referrer : undefined),
-            search: context.page?.search ?? (typeof location !== "undefined" ? location.search : undefined),
+            path: context.page?.path ?? globalThis.location?.pathname,
+            title: context.page?.title ?? globalThis.document?.title,
+            referrer: context.page?.referrer ?? globalThis.document?.referrer,
+            search: context.page?.search ?? globalThis.location?.search,
         },
     };
 }
@@ -126,19 +126,22 @@ export function prepareBrowserEvent(event, input) {
         environment: filtered.environment ?? input.environment,
         release: filtered.release ?? input.release,
         kind: filtered.kind ?? (filtered.level === "error" || filtered.level === "fatal" ? "error" : "log"),
-        ...(input.user ? { user: { ...input.user } } : {}),
-        ...(Object.keys(input.tags).length > 0 ? { tags: { ...input.tags, ...filtered.tags } } : {}),
-        ...(input.breadcrumbs.length > 0 ? { breadcrumbs: [...input.breadcrumbs] } : {}),
     };
+    if (input.user)
+        prepared.user = { ...input.user };
+    if (Object.keys(input.tags).length > 0)
+        prepared.tags = { ...input.tags, ...filtered.tags };
+    if (input.breadcrumbs.length > 0)
+        prepared.breadcrumbs = [...input.breadcrumbs];
     if (!prepared.visitor &&
         prepared.kind &&
         ["analytics", "identify", "page", "screen", "visitor"].includes(prepared.kind)) {
         prepared.visitor = { anonymous_id: prepared.session_id };
     }
-    if (typeof location !== "undefined") {
+    if (globalThis.location) {
         prepared.request = {
             ...prepared.request,
-            url: prepared.request?.url ?? location.href,
+            url: prepared.request?.url ?? globalThis.location.href,
         };
     }
     return prepared;

package/dist/trace-context.d.ts

@@ -0,0 +1,9 @@
+import type { TraceContext } from "./types.js";
+export declare function createTraceId(): string;
+export declare function createSpanId(): string;
+export declare function createTraceContext(parent?: Pick<TraceContext, "span_id" | "trace_id">): {
+    parent_span_id: string | undefined;
+    span_id: string;
+    trace_id: string;
+};
+//# 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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,aAAa,WAE5B;AAED,wBAAgB,YAAY,WAE3B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC;;;;EAMrF"}

package/dist/trace-context.js

@@ -0,0 +1,13 @@
+export function createTraceId() {
+    return crypto.randomUUID().replaceAll("-", "");
+}
+export function createSpanId() {
+    return crypto.randomUUID().replaceAll("-", "").slice(0, 16);
+}
+export function createTraceContext(parent) {
+    return {
+        parent_span_id: parent?.span_id,
+        span_id: createSpanId(),
+        trace_id: parent?.trace_id ?? createTraceId(),
+    };
+}

package/dist/transport.d.ts

@@ -1,19 +1,14 @@
 /**
- * Transport layer for the browser SDK.
+ * Browser transport.
  *
- * Two send paths:
- *   1. Errors → POST /v1/ingest/{project_id} (immediate, same wire format as sdk-node)
- *   2. Vitals → POST /v1/vitals/{project_id} (batched array)
+ * - Errors → POST /v1/ingest/{project_id} (per-event, immediate).
+ * - Vitals → POST /v1/vitals/{project_id} (batched).
  *
- * Primary transport: navigator.sendBeacon() — fire-and-forget, survives page unload.
- * Fallback: fetch() with keepalive: true.
- *
- * Vitals are buffered and flushed on:
- *   - Buffer reaching vitalsBufferSize (default: 10)
- *   - Timer tick (default: 10s)
- *   - Page visibility change to "hidden" (user leaving)
+ * Uses navigator.sendBeacon when available so requests survive page unload,
+ * falling back to `fetch({ keepalive: true })`. Vitals flush on buffer full,
+ * interval tick, and page visibilitychange/pagehide.
  */
-import type { BrowserErrorEvent, VitalEvent } from "./types";
+import type { BrowserErrorEvent, VitalEvent } from "./types.js";
 export interface TransportConfig {
     endpoint: string;
     projectId: string;
@@ -28,20 +23,17 @@ export declare class Transport {
     private flushTimer;
     private disposed;
     constructor(config: TransportConfig);
-    /** Send a single telemetry event immediately. Fire-and-forget. */
+    /** Fire-and-forget. */
     sendEvent(event: BrowserErrorEvent): void;
-    /** Backward-compatible alias for error events. */
+    /** @deprecated use {@link sendEvent}. */
     sendError(event: BrowserErrorEvent): void;
-    /** Buffer a vital event. Auto-flushes when buffer is full. */
     enqueueVital(event: VitalEvent): void;
-    /** Flush all buffered vitals immediately. */
     flushVitals(): void;
-    /** Stop all timers and flush remaining data. */
     dispose(): void;
     private buildIngestUrl;
-    /** Try sending via navigator.sendBeacon. Returns true if successful. */
+    private buildVitalsUrl;
+    private buildUrl;
     private trySendBeacon;
-    /** Send via fetch with keepalive and the API key header. */
     private sendFetch;
 }
 //# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,eAAe;IA2BnC,kEAAkE;IAClE,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAoBzC,kDAAkD;IAClD,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAMzC,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAUrC,6CAA6C;IAC7C,WAAW,IAAI,IAAI;IAoBnB,gDAAgD;IAChD,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,cAAc;IAQtB,wEAAwE;IACxE,OAAO,CAAC,aAAa;IAarB,4DAA4D;YAC9C,SAAS;CAoBxB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAa/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAWD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,eAAe;IAuBnC,uBAAuB;IACvB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAuBzC,yCAAyC;IACzC,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIzC,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAUrC,WAAW,IAAI,IAAI;IAuBnB,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,aAAa;YAcP,SAAS;CAwBxB"}

package/dist/transport.js

@@ -1,18 +1,31 @@
 /**
- * Transport layer for the browser SDK.
+ * Browser transport.
  *
- * Two send paths:
- *   1. Errors → POST /v1/ingest/{project_id} (immediate, same wire format as sdk-node)
- *   2. Vitals → POST /v1/vitals/{project_id} (batched array)
+ * - Errors → POST /v1/ingest/{project_id} (per-event, immediate).
+ * - Vitals → POST /v1/vitals/{project_id} (batched).
  *
- * Primary transport: navigator.sendBeacon() — fire-and-forget, survives page unload.
- * Fallback: fetch() with keepalive: true.
- *
- * Vitals are buffered and flushed on:
- *   - Buffer reaching vitalsBufferSize (default: 10)
- *   - Timer tick (default: 10s)
- *   - Page visibility change to "hidden" (user leaving)
+ * Uses navigator.sendBeacon when available so requests survive page unload,
+ * falling back to `fetch({ keepalive: true })`. Vitals flush on buffer full,
+ * interval tick, and page visibilitychange/pagehide.
  */
+import { attempt, attemptAsync } from "@squasher-ai/result-utils";
+import { getDefaultHeaders } from "@squasher-ai/sdk-core";
+const SDK_NAME = "@squasher-ai/browser";
+const SDK_VERSION = "0.2.0";
+const BEACON_CONTENT_TYPE = "text/plain";
+// One allocation per process; getDefaultHeaders is pure given package
+// metadata and platform detection memoizes inside sdk-core.
+const DEFAULT_TELEMETRY_HEADERS = getDefaultHeaders({
+    packageName: SDK_NAME,
+    packageVersion: SDK_VERSION,
+});
+function normalizeEndpoint(endpoint) {
+    const trimmed = endpoint.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    return trimmed.replace(/\/+$/, "");
+}
 export class Transport {
     config;
     vitalsBuffer = [];
@@ -20,50 +33,47 @@ export class Transport {
     disposed = false;
     constructor(config) {
         this.config = config;
-        // Start the vitals flush timer
         this.flushTimer = setInterval(() => {
             this.flushVitals();
         }, config.vitalsFlushIntervalMs);
-        // Flush vitals when the page is being hidden (user leaving/switching tabs)
-        if (typeof document !== "undefined") {
-            document.addEventListener("visibilitychange", () => {
-                if (document.visibilityState === "hidden") {
+        if (globalThis.document) {
+            globalThis.document.addEventListener("visibilitychange", () => {
+                if (globalThis.document.visibilityState === "hidden") {
                     this.flushVitals();
                 }
             });
         }
-        // Also flush on pagehide (more reliable than unload)
-        if (typeof window !== "undefined") {
-            window.addEventListener("pagehide", () => {
+        // `pagehide` fires in cases where `unload` does not (bfcache, iOS Safari).
+        if (globalThis.window) {
+            globalThis.window.addEventListener("pagehide", () => {
                 this.flushVitals();
             });
         }
     }
-    // ─── Error sending (immediate) ──────────────────────────────────────
-    /** Send a single telemetry event immediately. Fire-and-forget. */
+    /** Fire-and-forget. */
     sendEvent(event) {
         if (this.disposed)
             return;
         const url = this.buildIngestUrl();
+        const beaconUrl = this.buildIngestUrl({ beacon: true });
+        if (!url || !beaconUrl) {
+            return;
+        }
         const body = JSON.stringify(event);
-        // Try sendBeacon first (survives page unload)
-        if (this.trySendBeacon(this.buildIngestUrl({ beacon: true }), body)) {
+        if (this.trySendBeacon(beaconUrl, body)) {
             if (this.config.debug) {
                 console.log("[squasher] Error sent via sendBeacon");
             }
             return;
         }
-        // Fallback to fetch with keepalive
         this.sendFetch(url, body).catch(() => {
-            // Fire-and-forget — errors are best-effort in the browser
+            // Best-effort in the browser.
         });
     }
-    /** Backward-compatible alias for error events. */
+    /** @deprecated use {@link sendEvent}. */
     sendError(event) {
         this.sendEvent(event);
     }
-    // ─── Vitals buffering ───────────────────────────────────────────────
-    /** Buffer a vital event. Auto-flushes when buffer is full. */
     enqueueVital(event) {
         if (this.disposed)
             return;
@@ -72,25 +82,25 @@ export class Transport {
             this.flushVitals();
         }
     }
-    /** Flush all buffered vitals immediately. */
     flushVitals() {
         if (this.vitalsBuffer.length === 0)
             return;
+        const url = this.buildVitalsUrl();
+        const beaconUrl = this.buildVitalsUrl({ beacon: true });
+        if (!url || !beaconUrl) {
+            return;
+        }
         const events = this.vitalsBuffer.splice(0);
-        const url = `${this.config.endpoint}/v1/vitals/${this.config.projectId}`;
         const payload = { events };
         const body = JSON.stringify(payload);
-        if (this.trySendBeacon(url, body)) {
+        if (this.trySendBeacon(beaconUrl, body)) {
             if (this.config.debug) {
                 console.log(`[squasher] Flushed ${events.length} vitals via sendBeacon`);
             }
             return;
         }
-        this.sendFetch(url, body).catch(() => {
-            // Best-effort
-        });
+        this.sendFetch(url, body).catch(() => { });
     }
-    /** Stop all timers and flush remaining data. */
     dispose() {
         this.disposed = true;
         if (this.flushTimer) {
@@ -99,47 +109,57 @@ export class Transport {
         }
         this.flushVitals();
     }
-    // ─── Private helpers ────────────────────────────────────────────────
     buildIngestUrl(options) {
-        const baseUrl = `${this.config.endpoint}/v1/ingest/${this.config.projectId}`;
+        return this.buildUrl("ingest", options);
+    }
+    buildVitalsUrl(options) {
+        return this.buildUrl("vitals", options);
+    }
+    buildUrl(kind, options) {
+        const endpoint = normalizeEndpoint(this.config.endpoint);
+        if (!endpoint) {
+            return null;
+        }
+        const baseUrl = `${endpoint}/v1/${kind}/${this.config.projectId}`;
         if (!options?.beacon) {
             return baseUrl;
         }
         return `${baseUrl}?key=${encodeURIComponent(this.config.apiKey)}`;
     }
-    /** Try sending via navigator.sendBeacon. Returns true if successful. */
     trySendBeacon(url, body) {
-        if (typeof navigator === "undefined" || !navigator.sendBeacon) {
-            return false;
-        }
-        try {
-            const blob = new Blob([body], { type: "application/json" });
-            return navigator.sendBeacon(url, blob);
-        }
-        catch {
+        if (!globalThis.navigator?.sendBeacon) {
             return false;
         }
+        return attempt({
+            try: () => {
+                const blob = new Blob([body], { type: BEACON_CONTENT_TYPE });
+                return globalThis.navigator.sendBeacon(url, blob);
+            },
+            catch: () => false,
+        });
     }
-    /** Send via fetch with keepalive and the API key header. */
     async sendFetch(url, body) {
-        try {
-            await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    "x-squasher-key": this.config.apiKey,
-                },
-                body,
-                keepalive: true,
-            });
-            if (this.config.debug) {
-                console.log("[squasher] Event sent via fetch");
-            }
-        }
-        catch (err) {
-            if (this.config.debug) {
-                console.warn("[squasher] Failed to send event:", err);
-            }
-        }
+        await attemptAsync({
+            try: async () => {
+                await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        ...DEFAULT_TELEMETRY_HEADERS,
+                        "Content-Type": "application/json",
+                        "x-squasher-key": this.config.apiKey,
+                    },
+                    body,
+                    keepalive: true,
+                });
+                if (this.config.debug) {
+                    console.log("[squasher] Event sent via fetch");
+                }
+            },
+            catch: ({ cause }) => {
+                if (this.config.debug) {
+                    console.warn("[squasher] Failed to send event:", cause);
+                }
+            },
+        });
     }
 }