@debugbundle/sdk-browser 1.4.0 → 1.5.0

package/README.md

@@ -102,6 +102,33 @@ Network wrapping is designed to preserve normal browser behavior. The SDK suppor
 
 `tracePropagationTargets` is separate from the relay `endpoint`. Same-origin application requests receive trace headers by default. For split frontend/backend deployments, add the backend API origin, such as `https://api.example.com`, when cross-origin first-party requests should receive `X-DebugBundle-Trace-Id` and be eligible for policy-driven request-failure promotion. Third-party absolute URLs are not traced by default.
 
+### AnalyticsBundle Capture
+
+Analytics is opt-in and remains separate from debug capture:
+
+```ts
+debugbundle.init({
+  transportMode: "relay",
+  endpoint: "/debugbundle/browser",
+  service: "checkout-web",
+  environment: "production",
+  analytics: {
+    enabled: true,
+    trackActions: true
+  }
+});
+
+debugbundle.analytics.marker("checkout.validation_failed", {
+  attempt_bucket: 3
+});
+```
+
+`marker()` emits a bounded `journey_marker` with a privacy-safe marker key and optional low-cardinality dimensions. `trackActions: true` additionally emits generic structural action keys such as `click.button` and `click.link`; it is independent from debug `captureClicks` and never retains target text, selectors, IDs, URLs, attributes, or form values. `trackFrictionSignals` defaults to true and emits only fixed `friction.repeated_click`, `friction.dead_click`, and `friction.backtrack` markers from bounded in-memory click timing and route reversal heuristics; it never serializes target-derived data. The SDK emits one `session_summary` before a non-persisted `pagehide` and reuses its existing beacon/keepalive flush path. It does not emit a summary when a page enters the back-forward cache.
+
+For direct-cloud installs, `privacyMode: "standard"` keeps an opaque first-party anonymous visitor value in browser storage under a key derived from the SHA-256 digest of the public write-only project token. Events contain only a separate SHA-256-derived `visitor_id_hash`, enabling returning-visitor metrics without persisting or emitting the token or raw value. The SDK removes that value when consent is withdrawn or server settings force strict privacy. If browser storage or Web Crypto is unavailable, it safely falls back to session-only analytics. Relay installs remain session-only for visitor identity until the relay has an authenticated project-scope bootstrap; the relay/ingestion path still enforces project settings.
+
+For direct-cloud installs, the SDK explicitly requests the project analytics capture block from `GET /v1/sdk/config` once during initialization. That server block can only restrict a local analytics opt-in: it can disable capture, turn off page/route/action capture, require explicit consent, or force strict privacy. It cannot enable analytics or broaden capture. Relay installs do not fetch it because the browser must not hold a project token.
+
 Handled HTTP responses do not need to throw an exception to become request incidents. A failed response can emit a standalone `request_event` when it is first-party for trace propagation and matches the active capture preset, `immediate_client_error_statuses`, or an `immediate_client_error_path_rules` entry. Unpromoted `4xx` responses remain breadcrumbs/context.
 
 ### Local beforeSend hook

package/dist/analytics-friction.d.ts

@@ -0,0 +1,8 @@
+export declare class BrowserAnalyticsFrictionTracker {
+    private clickStates;
+    private recentRouteTransition;
+    reset(): void;
+    recordClick(targetIdentity: unknown, isStructuralTarget: boolean, isDeadClickCandidate: boolean, nowMs: number): "friction.repeated_click" | "friction.dead_click" | null;
+    recordRouteTransition(fromPath: string | null, toPath: string | null, nowMs: number): "friction.backtrack" | null;
+}
+//# sourceMappingURL=analytics-friction.d.ts.map

package/dist/analytics-friction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-friction.d.ts","sourceRoot":"","sources":["../src/analytics-friction.ts"],"names":[],"mappings":"AAiBA,qBAAa,+BAA+B;IAC1C,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,qBAAqB,CAAqC;IAE3D,KAAK,IAAI,IAAI;IAKb,WAAW,CAChB,cAAc,EAAE,OAAO,EACvB,kBAAkB,EAAE,OAAO,EAC3B,oBAAoB,EAAE,OAAO,EAC7B,KAAK,EAAE,MAAM,GACZ,yBAAyB,GAAG,qBAAqB,GAAG,IAAI;IAuCpD,qBAAqB,CAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,MAAM,GACZ,oBAAoB,GAAG,IAAI;CAc/B"}

package/dist/analytics-friction.js

@@ -0,0 +1,59 @@
+const FRICTION_CLICK_THRESHOLD = 3;
+const FRICTION_CLICK_WINDOW_MS = 2_000;
+const FRICTION_CLICK_COOLDOWN_MS = 10_000;
+const FRICTION_BACKTRACK_WINDOW_MS = 10_000;
+export class BrowserAnalyticsFrictionTracker {
+    clickStates = new WeakMap();
+    recentRouteTransition = null;
+    reset() {
+        this.clickStates = new WeakMap();
+        this.recentRouteTransition = null;
+    }
+    recordClick(targetIdentity, isStructuralTarget, isDeadClickCandidate, nowMs) {
+        if (targetIdentity === null || typeof targetIdentity !== "object") {
+            return null;
+        }
+        const prior = this.clickStates.get(targetIdentity);
+        if (prior !== undefined && nowMs < prior.cooldownUntilMs) {
+            return null;
+        }
+        const count = prior !== undefined && nowMs - prior.lastClickedAtMs <= FRICTION_CLICK_WINDOW_MS ? prior.count + 1 : 1;
+        const nextState = {
+            count,
+            lastClickedAtMs: nowMs,
+            cooldownUntilMs: 0
+        };
+        if (count < FRICTION_CLICK_THRESHOLD) {
+            this.clickStates.set(targetIdentity, nextState);
+            return null;
+        }
+        const markerKey = isStructuralTarget
+            ? "friction.repeated_click"
+            : isDeadClickCandidate
+                ? "friction.dead_click"
+                : null;
+        if (markerKey === null) {
+            this.clickStates.set(targetIdentity, nextState);
+            return null;
+        }
+        this.clickStates.set(targetIdentity, {
+            count: 0,
+            lastClickedAtMs: nowMs,
+            cooldownUntilMs: nowMs + FRICTION_CLICK_COOLDOWN_MS
+        });
+        return markerKey;
+    }
+    recordRouteTransition(fromPath, toPath, nowMs) {
+        if (fromPath === null || toPath === null || fromPath === toPath) {
+            return null;
+        }
+        const prior = this.recentRouteTransition;
+        const isBacktrack = prior !== null &&
+            nowMs - prior.occurredAtMs <= FRICTION_BACKTRACK_WINDOW_MS &&
+            prior.fromPath === toPath &&
+            prior.toPath === fromPath;
+        this.recentRouteTransition = { fromPath, toPath, occurredAtMs: nowMs };
+        return isBacktrack ? "friction.backtrack" : null;
+    }
+}
+//# sourceMappingURL=analytics-friction.js.map

package/dist/analytics-friction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-friction.js","sourceRoot":"","sources":["../src/analytics-friction.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AACvC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAc5C,MAAM,OAAO,+BAA+B;IAClC,WAAW,GAAG,IAAI,OAAO,EAA8B,CAAC;IACxD,qBAAqB,GAAgC,IAAI,CAAC;IAE3D,KAAK;QACV,IAAI,CAAC,WAAW,GAAG,IAAI,OAAO,EAA8B,CAAC;QAC7D,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACpC,CAAC;IAEM,WAAW,CAChB,cAAuB,EACvB,kBAA2B,EAC3B,oBAA6B,EAC7B,KAAa;QAEb,IAAI,cAAc,KAAK,IAAI,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,eAAe,IAAI,wBAAwB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrH,MAAM,SAAS,GAAuB;YACpC,KAAK;YACL,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,CAAC;SACnB,CAAC;QACF,IAAI,KAAK,GAAG,wBAAwB,EAAE,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,kBAAkB;YAClC,CAAC,CAAC,yBAAyB;YAC3B,CAAC,CAAC,oBAAoB;gBACpB,CAAC,CAAC,qBAAqB;gBACvB,CAAC,CAAC,IAAI,CAAC;QACX,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE;YACnC,KAAK,EAAE,CAAC;YACR,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,KAAK,GAAG,0BAA0B;SACpD,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,qBAAqB,CAC1B,QAAuB,EACvB,MAAqB,EACrB,KAAa;QAEb,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC;QACzC,MAAM,WAAW,GACf,KAAK,KAAK,IAAI;YACd,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,4BAA4B;YAC1D,KAAK,CAAC,QAAQ,KAAK,MAAM;YACzB,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC5B,IAAI,CAAC,qBAAqB,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;QACvE,OAAO,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;CACF"}

package/dist/analytics-normalization.d.ts

@@ -0,0 +1,17 @@
+import type { ActiveConfig, BrowserAnalyticsCustomDimensions, BrowserAnalyticsDimensions, BrowserAnalyticsEventEnvelope, BrowserAnalyticsPrivacyMode, BrowserDeviceInfo } from "./types.js";
+export interface StandardAnalyticsVisitor {
+    storageKey: string;
+    visitorIdHash: string;
+}
+export declare function resolveStandardAnalyticsVisitor(projectToken: string): Promise<StandardAnalyticsVisitor | null>;
+export declare function removeStoredAnalyticsVisitor(storageKey: string): void;
+export declare function normalizeAnalyticsPrivacyMode(value: unknown): BrowserAnalyticsPrivacyMode;
+export declare function getAnalyticsProjectTokenFields(config: ActiveConfig): Record<string, string>;
+export declare function normalizeAnalyticsSignal(signal: Partial<BrowserAnalyticsEventEnvelope["payload"]["signal"]>): BrowserAnalyticsEventEnvelope["payload"]["signal"];
+export declare function getStructuralActionKey(target: Record<string, unknown>): string | null;
+export declare function isDeadClickCandidate(target: Record<string, unknown>): boolean;
+export declare function normalizeAnalyticsRoute(path: string | null | undefined, title: string | null): BrowserAnalyticsEventEnvelope["payload"]["route"];
+export declare function sanitizeAnalyticsCustomDimensions(input: Record<string, unknown>): BrowserAnalyticsCustomDimensions;
+export declare function omitBuiltInAnalyticsDimensions(dimensions: BrowserAnalyticsCustomDimensions): BrowserAnalyticsCustomDimensions;
+export declare function buildAnalyticsDimensions(device: BrowserDeviceInfo | null, trackReferrers: boolean, customDimensions: BrowserAnalyticsCustomDimensions): BrowserAnalyticsDimensions;
+//# sourceMappingURL=analytics-normalization.d.ts.map

package/dist/analytics-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-normalization.d.ts","sourceRoot":"","sources":["../src/analytics-normalization.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,YAAY,EACZ,gCAAgC,EAEhC,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA6CpB,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAcpH;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMrE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,CAEzF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3F;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,GAClE,6BAA6B,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAQpD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAiBrF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAG7E;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,6BAA6B,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAqBnD;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gCAAgC,CAgBlH;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,gCAAgC,GAC3C,gCAAgC,CAMlC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAChC,cAAc,EAAE,OAAO,EACvB,gBAAgB,EAAE,gCAAgC,GACjD,0BAA0B,CAqB5B"}

package/dist/analytics-normalization.js

@@ -0,0 +1,276 @@
+import { createBrowserTraceId, getCryptoSource, getDocumentSource, getLocalStorageSource, getLocationSource } from "./runtime.js";
+const MAX_CUSTOM_DIMENSIONS = 8;
+const MAX_CUSTOM_KEY_LENGTH = 64;
+const MAX_CUSTOM_STRING_LENGTH = 128;
+const SIGNAL_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_.:-]*$/;
+const CUSTOM_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_.-]*$/;
+const SENSITIVE_KEY_PATTERN = /(password|passwd|secret|token|authorization|cookie|email|phone|address|card|credit|ssn|user.?id|order.?id|ticket.?id|workspace.?id)/i;
+const STRUCTURAL_ACTION_KEYS_BY_TAG = {
+    a: "click.link",
+    button: "click.button",
+    input: "click.input",
+    select: "click.select",
+    summary: "click.summary"
+};
+const STRUCTURAL_ACTION_KEYS_BY_ROLE = {
+    button: "click.button",
+    checkbox: "click.checkbox",
+    link: "click.link",
+    menuitem: "click.menuitem",
+    radio: "click.radio",
+    switch: "click.switch",
+    tab: "click.tab"
+};
+const STRUCTURAL_INPUT_TYPES = new Set(["button", "checkbox", "radio", "reset", "submit"]);
+const NON_FRICTION_CONTROL_TAGS = new Set(["input", "textarea", "select", "option", "label"]);
+const STANDARD_VISITOR_STORAGE_PREFIX = "debugbundle.analytics.visitor.v1";
+const BUILT_IN_DIMENSION_KEYS = new Set([
+    "auth_state",
+    "device_type",
+    "browser_family",
+    "browser_major",
+    "os_family",
+    "os_major",
+    "language",
+    "locale",
+    "viewport_bucket",
+    "referrer_domain",
+    "utm_source",
+    "utm_medium",
+    "utm_campaign",
+    "country_code",
+    "region_code"
+]);
+export async function resolveStandardAnalyticsVisitor(projectToken) {
+    const projectScopeHash = await hashAnalyticsValue(projectToken);
+    if (projectScopeHash === null) {
+        return null;
+    }
+    const storageKey = `${STANDARD_VISITOR_STORAGE_PREFIX}.${projectScopeHash.slice("sha256:".length)}`;
+    const visitorId = getOrCreateStoredVisitor(storageKey);
+    if (visitorId === null) {
+        return null;
+    }
+    const visitorIdHash = await hashAnalyticsValue(`${projectScopeHash}:${visitorId}`);
+    return visitorIdHash === null ? null : { storageKey, visitorIdHash };
+}
+export function removeStoredAnalyticsVisitor(storageKey) {
+    try {
+        getLocalStorageSource()?.removeItem(storageKey);
+    }
+    catch {
+        // Storage access must never affect host application behavior.
+    }
+}
+export function normalizeAnalyticsPrivacyMode(value) {
+    return value === "standard" || value === "custom" ? value : "strict";
+}
+export function getAnalyticsProjectTokenFields(config) {
+    return config.projectToken === null ? {} : { project_token: config.projectToken };
+}
+export function normalizeAnalyticsSignal(signal) {
+    return {
+        action_key: normalizeSignalKey(signal.action_key),
+        funnel_key: normalizeSignalKey(signal.funnel_key),
+        step_key: normalizeSignalKey(signal.step_key),
+        conversion_key: normalizeSignalKey(signal.conversion_key),
+        marker_key: normalizeSignalKey(signal.marker_key)
+    };
+}
+export function getStructuralActionKey(target) {
+    const role = normalizeStructuralActionValue(target["role"]);
+    if (role !== null && STRUCTURAL_ACTION_KEYS_BY_ROLE[role] !== undefined) {
+        return STRUCTURAL_ACTION_KEYS_BY_ROLE[role];
+    }
+    const tagName = normalizeStructuralActionValue(target["tagName"]);
+    if (tagName === null) {
+        return null;
+    }
+    if (tagName === "input") {
+        const inputType = normalizeStructuralActionValue(target["type"]);
+        if (inputType !== null && STRUCTURAL_INPUT_TYPES.has(inputType)) {
+            return `click.input.${inputType}`;
+        }
+    }
+    return STRUCTURAL_ACTION_KEYS_BY_TAG[tagName] ?? null;
+}
+export function isDeadClickCandidate(target) {
+    const tagName = normalizeStructuralActionValue(target["tagName"]);
+    return tagName !== null && !NON_FRICTION_CONTROL_TAGS.has(tagName);
+}
+export function normalizeAnalyticsRoute(path, title) {
+    if (typeof path !== "string" || path.trim().length === 0) {
+        return null;
+    }
+    try {
+        const parsed = new URL(path, getLocationSource()?.href ?? "https://debugbundle.local");
+        return { path: parsed.pathname || "/", normalized_path: parsed.pathname || "/", title: normalizeTitle(title) };
+    }
+    catch {
+        const queryIndex = path.indexOf("?");
+        const fragmentIndex = path.indexOf("#");
+        const end = queryIndex === -1
+            ? (fragmentIndex === -1 ? path.length : fragmentIndex)
+            : fragmentIndex === -1 ? queryIndex : Math.min(queryIndex, fragmentIndex);
+        const normalized = path.slice(0, end).trim();
+        if (normalized.length === 0) {
+            return null;
+        }
+        const normalizedPath = normalized.startsWith("/") ? normalized : `/${normalized}`;
+        return { path: normalizedPath, normalized_path: normalizedPath, title: normalizeTitle(title) };
+    }
+}
+export function sanitizeAnalyticsCustomDimensions(input) {
+    const output = {};
+    for (const [rawKey, rawValue] of Object.entries(input)) {
+        if (Object.keys(output).length >= MAX_CUSTOM_DIMENSIONS) {
+            break;
+        }
+        const key = normalizeCustomDimensionKey(rawKey);
+        if (key === null || BUILT_IN_DIMENSION_KEYS.has(key)) {
+            continue;
+        }
+        const value = normalizeCustomDimensionValue(key, rawValue);
+        if (value !== undefined) {
+            output[key] = value;
+        }
+    }
+    return output;
+}
+export function omitBuiltInAnalyticsDimensions(dimensions) {
+    const output = { ...dimensions };
+    for (const key of BUILT_IN_DIMENSION_KEYS) {
+        delete output[key];
+    }
+    return output;
+}
+export function buildAnalyticsDimensions(device, trackReferrers, customDimensions) {
+    const language = normalizeLocale(device?.language ?? null);
+    const locationSource = getLocationSource();
+    const params = new URLSearchParams(typeof locationSource?.search === "string" ? locationSource.search.replace(/^\?/, "") : "");
+    return {
+        auth_state: normalizeAuthState(customDimensions["auth_state"]),
+        device_type: device?.device_type ?? "unknown",
+        browser_family: normalizeDimensionText(device?.browser.name ?? null, 80),
+        browser_major: parseMajorVersion(device?.browser.version ?? null),
+        os_family: normalizeDimensionText(device?.os.name ?? null, 80),
+        os_major: parseMajorVersion(device?.os.version ?? null),
+        language,
+        locale: language,
+        viewport_bucket: getViewportBucket(device),
+        referrer_domain: trackReferrers ? getReferrerDomain() : null,
+        utm_source: normalizeDimensionText(params.get("utm_source"), 128),
+        utm_medium: normalizeDimensionText(params.get("utm_medium"), 128),
+        utm_campaign: normalizeDimensionText(params.get("utm_campaign"), 128),
+        country_code: null,
+        region_code: null
+    };
+}
+function getOrCreateStoredVisitor(storageKey) {
+    const storage = getLocalStorageSource();
+    if (storage === null) {
+        return null;
+    }
+    try {
+        const existing = storage.getItem(storageKey);
+        if (typeof existing === "string" && /^[a-f0-9-]{16,128}$/i.test(existing)) {
+            return existing;
+        }
+        const visitorId = createBrowserTraceId();
+        if (!/^[a-f0-9-]{16,128}$/i.test(visitorId)) {
+            return null;
+        }
+        storage.setItem(storageKey, visitorId);
+        return visitorId;
+    }
+    catch {
+        return null;
+    }
+}
+async function hashAnalyticsValue(value) {
+    const cryptoSource = getCryptoSource();
+    const TextEncoderConstructor = globalThis["TextEncoder"];
+    if (typeof cryptoSource?.subtle?.digest !== "function" || TextEncoderConstructor === undefined) {
+        return null;
+    }
+    const digest = await cryptoSource.subtle.digest("SHA-256", new TextEncoderConstructor().encode(value));
+    return `sha256:${Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+}
+function normalizeSignalKey(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return SIGNAL_KEY_PATTERN.test(trimmed) && trimmed.length <= 120 ? trimmed : null;
+}
+function normalizeStructuralActionValue(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized.length > 0 && normalized.length <= 32 ? normalized : null;
+}
+function normalizeTitle(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed.slice(0, 200) : null;
+}
+function normalizeCustomDimensionKey(value) {
+    const trimmed = value.trim();
+    return trimmed.length > 0 && trimmed.length <= MAX_CUSTOM_KEY_LENGTH && CUSTOM_KEY_PATTERN.test(trimmed) && !SENSITIVE_KEY_PATTERN.test(trimmed)
+        ? trimmed
+        : null;
+}
+function normalizeCustomDimensionValue(key, value) {
+    if (value === null || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number" && Number.isFinite(value) && value >= -1_000_000 && value <= 1_000_000) {
+        return value;
+    }
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 && trimmed.length <= MAX_CUSTOM_STRING_LENGTH && !SENSITIVE_KEY_PATTERN.test(trimmed) && !SENSITIVE_KEY_PATTERN.test(key)
+        ? trimmed
+        : undefined;
+}
+function normalizeAuthState(value) {
+    return value === "authenticated" || value === "unknown" ? value : "anonymous";
+}
+function normalizeDimensionText(value, maxLength) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed.slice(0, maxLength) : null;
+}
+function normalizeLocale(value) {
+    const normalized = normalizeDimensionText(value, 35);
+    return normalized !== null && /^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$/.test(normalized) ? normalized : null;
+}
+function parseMajorVersion(value) {
+    const major = typeof value === "string" ? Number.parseInt(value.split(".")[0] ?? "", 10) : Number.NaN;
+    return Number.isFinite(major) && major >= 0 ? major : null;
+}
+function getViewportBucket(device) {
+    const width = device?.viewport.width ?? 0;
+    return width <= 0 ? "unknown" : width < 640 ? "small" : width < 1024 ? "medium" : "large";
+}
+function getReferrerDomain() {
+    const referrer = getDocumentSource()?.referrer;
+    if (typeof referrer !== "string" || referrer.trim().length === 0) {
+        return null;
+    }
+    try {
+        const hostname = new URL(referrer).hostname;
+        return hostname.length > 0 && hostname.length <= 255 ? hostname : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=analytics-normalization.js.map

package/dist/analytics-normalization.js.map

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

package/dist/analytics.d.ts

@@ -0,0 +1,41 @@
+import { type ActiveConfig, type BrowserAnalyticsEventEnvelope, type BrowserRemoteAnalyticsConfig, type BrowserDeviceInfo, type DebugBundleBrowserAnalytics, type DebugBundleBrowserAnalyticsConfig } from "./types.js";
+export declare class BrowserAnalyticsController {
+    private readonly host;
+    private active;
+    private lastRoute;
+    private sessionSummaryCaptured;
+    private readonly frictionTracker;
+    constructor(host: {
+        getConfig(): ActiveConfig | null;
+        getDeviceInfo(): BrowserDeviceInfo | null;
+        getCurrentRoute(): string | null;
+        getSessionId(): string;
+        enqueue(event: BrowserAnalyticsEventEnvelope): void;
+    });
+    readonly api: DebugBundleBrowserAnalytics;
+    configure(config: DebugBundleBrowserAnalyticsConfig | undefined, options?: {
+        deferCapture?: boolean;
+    }): void;
+    markCaptureReady(): void;
+    reset(): void;
+    captureSessionStart(): void;
+    captureSessionSummary(): void;
+    prepareForUnload(): void;
+    captureInitialPageView(): void;
+    captureRouteChange(path: string): void;
+    applyRemoteSettings(remote: BrowserRemoteAnalyticsConfig): void;
+    shouldCaptureStructuralActions(): boolean;
+    shouldCaptureFrictionSignals(): boolean;
+    captureStructuralAction(target: Record<string, unknown>): void;
+    captureFrictionClick(target: Record<string, unknown>, targetIdentity: unknown): void;
+    private capturePageView;
+    private captureBacktrackFriction;
+    private captureSignal;
+    private enqueue;
+    private initializeStandardVisitor;
+    private clearStandardVisitor;
+    private flushPendingEvents;
+    private setContext;
+    private captureWhenReady;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAkBA,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,6BAA6B,EAGlC,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EAEvC,MAAM,YAAY,CAAC;AAiCpB,qBAAa,0BAA0B;IAOnC,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,SAAS,CAA2D;IAC5E,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;gBAGtD,IAAI,EAAE;QACrB,SAAS,IAAI,YAAY,GAAG,IAAI,CAAC;QACjC,aAAa,IAAI,iBAAiB,GAAG,IAAI,CAAC;QAC1C,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;QACjC,YAAY,IAAI,MAAM,CAAC;QACvB,OAAO,CAAC,KAAK,EAAE,6BAA6B,GAAG,IAAI,CAAC;KACrD;IAGH,SAAgB,GAAG,EAAE,2BAA2B,CAyC9C;IAEK,SAAS,CACd,MAAM,EAAE,iCAAiC,GAAG,SAAS,EACrD,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GACvC,IAAI;IAmDA,gBAAgB,IAAI,IAAI;IAgBxB,KAAK,IAAI,IAAI;IAOb,mBAAmB,IAAI,IAAI;IAQ3B,qBAAqB,IAAI,IAAI;IAU7B,gBAAgB,IAAI,IAAI;IAQxB,sBAAsB,IAAI,IAAI;IAQ9B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQtC,mBAAmB,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI;IA2B/D,8BAA8B,IAAI,OAAO;IAIzC,4BAA4B,IAAI,OAAO;IAIvC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiB9D,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI;IAqB3F,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,OAAO;YAuED,yBAAyB;IAwCvC,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,gBAAgB;CAazB"}