@lib-acr/browser 0.0.0-stage → 0.0.1

package/dist/esm/fetch-tracker.js

@@ -0,0 +1,60 @@
+import { markCaptured } from './captured.js';
+import { describeUrl } from './url.js';
+function methodOf(input, init) {
+    const method = init?.method ?? (typeof input === 'object' && 'method' in input ? input.method : 'GET');
+    return (method || 'GET').toUpperCase();
+}
+function urlOf(input) {
+    if (typeof input === 'string')
+        return input;
+    if (input instanceof URL)
+        return input.toString();
+    return input.url;
+}
+/**
+ * Wraps fetch to record duration and outcome per request. Request and response bodies and headers are never read.
+ * URLs are reduced to origin and a normalized path. Network failures are also reported as frontend errors, and then
+ * rethrown so the application behaves as before. A rethrown failure is marked as captured, so it is not reported a
+ * second time as an unhandled rejection.
+ */
+export function wrapFetch(original, client, options) {
+    return async function acrTrackedFetch(input, init) {
+        const url = urlOf(input);
+        if (options.ignoreUrlPrefixes.some((prefix) => url.startsWith(prefix)))
+            return original(input, init);
+        const method = methodOf(input, init);
+        const described = describeUrl(url, options.base);
+        const started = typeof performance !== 'undefined' ? performance.now() : Date.now();
+        const elapsed = () => Math.round(((typeof performance !== 'undefined' ? performance.now() : Date.now()) - started) * 100) / 100;
+        try {
+            const response = await original(input, init);
+            client.trackEvent('api_request', {
+                method,
+                host: described?.host,
+                path: described?.path,
+                status: response.status,
+                ok: response.ok,
+                durationMs: elapsed(),
+            });
+            return response;
+        }
+        catch (err) {
+            client.trackEvent('api_request', {
+                method,
+                host: described?.host,
+                path: described?.path,
+                status: 0,
+                ok: false,
+                durationMs: elapsed(),
+            });
+            client.captureError(err, {
+                handled: false,
+                source: 'frontend',
+                attributes: { kind: 'network', method, host: described?.host ?? 'unknown', path: described?.path ?? '/' },
+            });
+            markCaptured(err);
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=fetch-tracker.js.map

package/dist/esm/fetch-tracker.js.map

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

package/dist/esm/identity.js

@@ -0,0 +1,112 @@
+export const ANONYMOUS_KEY = 'acr.anonymousId';
+export const SESSION_KEY = 'acr.session';
+/** ISO time this browser first ran the SDK. Commands issued before it are skipped (nothing stale to clear). */
+export const FIRST_SEEN_KEY = 'acr.firstSeen';
+export function randomId() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === 'function')
+        return c.randomUUID();
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
+}
+/** Stable id for one browser profile. Kept in localStorage when available, in memory otherwise. */
+export function getOrCreateAnonymousId(store, memory) {
+    try {
+        const existing = store?.getItem(ANONYMOUS_KEY);
+        if (existing)
+            return existing;
+        const id = randomId();
+        store?.setItem(ANONYMOUS_KEY, id);
+        return id;
+    }
+    catch {
+        memory.id ?? (memory.id = randomId());
+        return memory.id;
+    }
+}
+/**
+ * Returns `acr.firstSeen`, writing the current time when it is missing (a new visitor, or a visitor whose anonymous id
+ * predates this key). It is never changed afterwards, not even by reset(). With storage blocked the value lives in
+ * memory for this page only.
+ */
+export function ensureFirstSeen(store, memory, now = () => Date.now()) {
+    try {
+        const existing = store?.getItem(FIRST_SEEN_KEY);
+        if (existing && !Number.isNaN(Date.parse(existing)))
+            return existing;
+        const value = new Date(now()).toISOString();
+        store?.setItem(FIRST_SEEN_KEY, value);
+        if (store && store.getItem(FIRST_SEEN_KEY) !== value)
+            throw new Error('not persisted');
+        return value;
+    }
+    catch {
+        memory.firstSeen ?? (memory.firstSeen = new Date(now()).toISOString());
+        return memory.firstSeen;
+    }
+}
+/** Replaces the anonymous id with a new one (for example on logout) and returns it. */
+export function resetAnonymousId(store, memory) {
+    const id = randomId();
+    memory.id = id;
+    try {
+        store?.setItem(ANONYMOUS_KEY, id);
+    }
+    catch {
+        /* the memory copy is used while storage is blocked */
+    }
+    return id;
+}
+/**
+ * Browser session: a new id after `timeoutMs` without activity, or when the tab is new. The state lives in
+ * sessionStorage, so it survives reloads of the same tab but not a new tab.
+ */
+export class SessionTracker {
+    constructor(store, timeoutMs, now = () => Date.now()) {
+        this.store = store;
+        this.timeoutMs = timeoutMs;
+        this.now = now;
+        this.memory = null;
+    }
+    /** Returns the current session and marks it active. */
+    touch() {
+        const current = this.read();
+        const t = this.now();
+        if (current && t - current.last <= this.timeoutMs) {
+            this.write({ id: current.id, last: t });
+            return { id: current.id, isNew: false };
+        }
+        const fresh = { id: randomId(), last: t };
+        this.write(fresh);
+        return { id: fresh.id, isNew: true };
+    }
+    /** Ends the current session and starts a new one now. */
+    reset() {
+        const fresh = { id: randomId(), last: this.now() };
+        this.write(fresh);
+        return { id: fresh.id, isNew: true };
+    }
+    read() {
+        try {
+            const raw = this.store?.getItem(SESSION_KEY);
+            if (raw) {
+                const parsed = JSON.parse(raw);
+                if (typeof parsed.id === 'string' && typeof parsed.last === 'number')
+                    return { id: parsed.id, last: parsed.last };
+            }
+        }
+        catch {
+            /* fall through to memory */
+        }
+        return this.memory;
+    }
+    write(state) {
+        this.memory = state;
+        try {
+            this.store?.setItem(SESSION_KEY, JSON.stringify(state));
+        }
+        catch {
+            /* memory copy is enough */
+        }
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/esm/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,+GAA+G;AAC/G,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AAE9C,MAAM,UAAU,QAAQ;IACtB,MAAM,CAAC,GAAI,UAAkC,CAAC,MAAM,CAAC;IACrD,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IACnE,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,sBAAsB,CAAC,KAA2B,EAAE,MAAuB;IACzF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,EAAE,KAAT,MAAM,CAAC,EAAE,GAAK,QAAQ,EAAE,EAAC;QACzB,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B,EAAE,MAA8B,EAAE,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IAC/H,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAChD,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,SAAS,KAAhB,MAAM,CAAC,SAAS,GAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,EAAC;QACnD,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,KAA2B,EAAE,MAAuB;IACnF,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,IAAI,CAAC;QACH,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAOD;;;GAGG;AACH,MAAM,OAAO,cAAc;IAGzB,YACmB,KAA2B,EAC3B,SAAiB,EACjB,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAFpC,UAAK,GAAL,KAAK,CAAsB;QAC3B,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAiC;QAL/C,WAAM,GAAwC,IAAI,CAAC;IAMxD,CAAC;IAEJ,uDAAuD;IACvD,KAAK;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACxC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,yDAAyD;IACzD,KAAK;QACH,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqC,CAAC;gBACnE,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACpH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,KAAmC;QAC/C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,13 @@
+export { BrowserACR, BROWSER_SDK, DISMISSED_KEY, FORCE_RELOAD_KEY, QUEUE_KEY, assertPublishableOptions } from './browser-acr.js';
+export { normalizePath, describeUrl } from './url.js';
+export { getDeviceInfo, parseUserAgent } from './device.js';
+export { ANONYMOUS_KEY, FIRST_SEEN_KEY, SessionTracker, ensureFirstSeen, getOrCreateAnonymousId, resetAnonymousId } from './identity.js';
+export { CommandRunner, clearCaches, COMMANDS_KEY, COMMAND_APPLIED_EVENT, RELOAD_GUARD_KEY, RESERVED_PREFIX } from './control/command-runner.js';
+export { ControlUI, UI_HOST_TAG, resolveUiOptions } from './control/ui.js';
+export { VitalsCollector } from './web-vitals.js';
+export { wrapFetch } from './fetch-tracker.js';
+export { markCaptured, wasCaptured } from './captured.js';
+// Shared helpers and types from @lib-acr/core. The core client, transport and config resolver are deliberately not
+// re-exported: AcrClient accepts a secret key, and a browser entry point must not offer a way to bundle one.
+export { AcrError, CORE_SDK, REDACTED, REDACTED_EMAIL, SCHEMA_VERSION, EMPTY_CONTROL_STATE, clearCacheParams, compareSemver, describeError, evaluateFlag, fnv1a32, formatTraceparent, generateId, generateSpanId, generateTraceId, inRollout, isSensitiveKey, parseSemver, parseSnapshot, parseTraceparent, planCommands, redactAttributes, redactString, reloadParams, rolloutBucket, sessionSampled, typedFlagValue, } from '@lib-acr/core';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjI,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzI,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEjJ,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE1D,mHAAmH;AACnH,6GAA6G;AAC7G,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,eAAe,EACf,SAAS,EACT,cAAc,EACd,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/sdk-info.js

@@ -0,0 +1,3 @@
+// Generated by scripts/sync-sdk-info.mjs from package.json. Do not edit by hand.
+export const SDK_INFO = { name: '@lib-acr/browser', version: '0.0.1' };
+//# sourceMappingURL=sdk-info.js.map

package/dist/esm/sdk-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-info.js","sourceRoot":"","sources":["../../src/sdk-info.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC"}

package/dist/esm/url.js

@@ -0,0 +1,27 @@
+const UUID_SEGMENT = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const NUMERIC_SEGMENT = /^\d+$/;
+const LONG_HEX_SEGMENT = /^[0-9a-f]{16,}$/i;
+/**
+ * Path for telemetry: no query string, no fragment, and ids replaced with :id so that /orders/42 and /orders/43 group
+ * together. Query strings often carry tokens or personal data, so they are never sent.
+ */
+export function normalizePath(pathname) {
+    const path = (pathname || '/').split(/[?#]/)[0] || '/';
+    const segments = path.split('/').map((segment) => {
+        if (UUID_SEGMENT.test(segment) || NUMERIC_SEGMENT.test(segment) || LONG_HEX_SEGMENT.test(segment))
+            return ':id';
+        return segment;
+    });
+    return segments.join('/').slice(0, 512) || '/';
+}
+/** Absolute URL to origin + normalized path, for api_request events. */
+export function describeUrl(input, base) {
+    try {
+        const url = new URL(input, base);
+        return { host: url.host, path: normalizePath(url.pathname) };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=url.js.map

package/dist/esm/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/url.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,iEAAiE,CAAC;AACvF,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/C,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAChH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC;AACjD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAY;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/web-vitals.js

@@ -0,0 +1,156 @@
+const EMPTY = { fcp: null, lcp: null, cls: null, ttfb: null, inpMaxMs: null, pageLoadMs: null };
+/**
+ * Collects Core Web Vitals with PerformanceObserver. It degrades silently where an entry type is unsupported, which is
+ * the case in older browsers and in jsdom.
+ */
+export class VitalsCollector {
+    constructor() {
+        this.state = { ...EMPTY };
+        /** Stable reference, replaced only when a value changes, so useSyncExternalStore does not loop. */
+        this.current = { ...EMPTY };
+        this.observers = [];
+        this.listeners = new Set();
+        this.clsWindow = { value: 0, start: 0, last: 0 };
+        this.clsMax = 0;
+        this.loadListener = null;
+        this.loadTimer = null;
+    }
+    start() {
+        this.observeEntries();
+        this.readNavigation();
+        this.watchLoad();
+    }
+    stop() {
+        for (const o of this.observers)
+            o.disconnect();
+        this.observers = [];
+        if (this.loadListener && typeof window !== 'undefined')
+            window.removeEventListener('load', this.loadListener);
+        this.loadListener = null;
+        if (this.loadTimer)
+            clearTimeout(this.loadTimer);
+        this.loadTimer = null;
+    }
+    snapshot() {
+        return this.current;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    observeEntries() {
+        if (typeof PerformanceObserver === 'undefined')
+            return;
+        this.observe('paint', (entries) => {
+            const fcp = entries.find((e) => e.name === 'first-contentful-paint');
+            if (fcp)
+                this.update({ fcp: round(fcp.startTime) });
+        });
+        this.observe('largest-contentful-paint', (entries) => {
+            const last = entries[entries.length - 1];
+            if (last)
+                this.update({ lcp: round(last.startTime) });
+        });
+        this.observe('layout-shift', (entries) => {
+            for (const entry of entries) {
+                if (entry.hadRecentInput)
+                    continue;
+                this.addLayoutShift(entry.startTime, entry.value);
+            }
+        });
+        this.observe('event', (entries) => {
+            for (const entry of entries) {
+                if (!entry.interactionId)
+                    continue;
+                this.update({ inpMaxMs: Math.max(this.state.inpMaxMs ?? 0, round(entry.duration)) });
+            }
+        }, { durationThreshold: 40 });
+    }
+    /**
+     * `loadEventEnd` is only known once the load event has finished. When start() runs earlier (the usual case for an
+     * SDK loaded in the page head), read the navigation entry again just after `load`.
+     */
+    watchLoad() {
+        if (this.state.pageLoadMs !== null || typeof window === 'undefined' || typeof document === 'undefined')
+            return;
+        const readSoon = () => {
+            this.loadTimer = setTimeout(() => {
+                this.loadTimer = null;
+                this.readNavigation();
+            }, 0);
+        };
+        if (document.readyState === 'complete') {
+            readSoon();
+            return;
+        }
+        const onLoad = () => {
+            this.loadListener = null;
+            readSoon();
+        };
+        this.loadListener = onLoad;
+        window.addEventListener('load', onLoad, { once: true });
+    }
+    observe(type, handle, options = {}) {
+        try {
+            const observer = new PerformanceObserver((list) => handle(list.getEntries()));
+            observer.observe({ type, buffered: true, ...options });
+            this.observers.push(observer);
+        }
+        catch {
+            /* entry type not supported here */
+        }
+    }
+    /** Session windows: a window ends after 1 s of quiet or 5 s in total; CLS is the largest window. */
+    addLayoutShift(time, value) {
+        const w = this.clsWindow;
+        if (w.value === 0 || time - w.last > 1000 || time - w.start > 5000) {
+            this.clsWindow = { value, start: time, last: time };
+        }
+        else {
+            this.clsWindow = { value: w.value + value, start: w.start, last: time };
+        }
+        this.clsMax = Math.max(this.clsMax, this.clsWindow.value);
+        this.publish();
+    }
+    readNavigation() {
+        if (typeof performance === 'undefined' || typeof performance.getEntriesByType !== 'function')
+            return;
+        let nav;
+        try {
+            nav = performance.getEntriesByType('navigation')[0];
+        }
+        catch {
+            return;
+        }
+        if (!nav)
+            return;
+        this.update({
+            ttfb: round(nav.responseStart),
+            pageLoadMs: nav.loadEventEnd > 0 ? round(nav.loadEventEnd) : this.state.pageLoadMs,
+        });
+    }
+    update(patch) {
+        this.state = { ...this.state, ...patch };
+        this.publish();
+    }
+    publish() {
+        const next = { ...this.state, cls: this.clsMax > 0 ? round(this.clsMax, 4) : this.state.cls };
+        const changed = Object.keys(next).some((k) => next[k] !== this.current[k]);
+        if (!changed)
+            return;
+        this.current = next;
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(this.current);
+            }
+            catch {
+                /* a faulty listener must not stop collection */
+            }
+        }
+    }
+}
+function round(value, digits = 2) {
+    const f = 10 ** digits;
+    return Math.round(value * f) / f;
+}
+//# sourceMappingURL=web-vitals.js.map

package/dist/esm/web-vitals.js.map

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

package/dist/types/browser-acr.d.ts

@@ -0,0 +1,142 @@
+import { AcrClient, type AcrOptions, type LogLevel, type SdkInfo } from '@lib-acr/core';
+import { type ControlUiOptions } from './control/ui.js';
+import { type VitalsSnapshot } from './web-vitals.js';
+export declare const BROWSER_SDK: SdkInfo;
+/** localStorage key holding telemetry that was still unsent when the page was hidden. */
+export declare const QUEUE_KEY = "acr.queue";
+/** localStorage: ids of announcements the visitor dismissed (last 50). */
+export declare const DISMISSED_KEY = "acr.dismissed";
+/** sessionStorage: the minimumVersion a `force` release already reloaded this tab for. */
+export declare const FORCE_RELOAD_KEY = "acr.forceReload";
+/** Browser options. A secret can never be configured here: browsers use publishable (client) keys only. */
+export interface BrowserAcrOptions extends Omit<AcrOptions, 'apiSecret' | 'secretKey' | 'minLogLevel'> {
+    apiSecret?: never;
+    secretKey?: never;
+    /** Logs below this level are dropped in the page. Default `warn`. */
+    minLogLevel?: LogLevel;
+    /** Report uncaught errors and unhandled rejections. Default true. */
+    trackErrors?: boolean;
+    /** Record page views, including client-side route changes. Default true. */
+    trackPageViews?: boolean;
+    /** Time API calls made with fetch. Default true. */
+    trackFetch?: boolean;
+    /** Collect Core Web Vitals and report them when the page is hidden. Default true. */
+    trackWebVitals?: boolean;
+    /** Minutes of inactivity before a new session starts. Default 30. */
+    sessionTimeoutMinutes?: number;
+    /** Do not collect when the browser sends Do Not Track. Default true. */
+    respectDoNotTrack?: boolean;
+    /**
+     * Minutes between `acr.active` events while the tab is visible, so ACR can count live visitors. Nothing is sent
+     * while the tab is hidden. 0 turns it off. Default 5.
+     */
+    activePingMinutes?: number;
+    /**
+     * Keep telemetry that is still unsent when the page is hidden in localStorage (bounded) and send it on the next
+     * start(). Default true.
+     */
+    persistQueue?: boolean;
+    /**
+     * Built-in remote-control UI rendered in a Shadow DOM (maintenance screen, announcement banner, "new version
+     * available" prompt). `false` turns all of it off, an object turns off single parts, so a framework can render its
+     * own from getControlState(). Default true. Commands, the kill switch and forced reloads work either way.
+     */
+    ui?: boolean | ControlUiOptions;
+}
+export type Teardown = () => void;
+/**
+ * Throws when browser options carry a secret. BrowserACR calls it in its constructor; framework wrappers can call it
+ * where no client is created (for example during server-side rendering) so the mistake still surfaces.
+ */
+export declare function assertPublishableOptions(options: unknown): void;
+/**
+ * Browser client. It takes a publishable key only: a secret key is rejected in the constructor, so it can never be
+ * bundled into a page. Call start() to install automatic collection and stop() to remove it.
+ */
+export declare class BrowserACR extends AcrClient {
+    private started;
+    private lastPath;
+    private teardowns;
+    private readonly vitals;
+    private readonly sessions;
+    private readonly anonymousMemory;
+    private readonly opts;
+    private readonly endpointPrefix;
+    private vitalsReported;
+    private readonly respectDnt;
+    private readonly activePingMs;
+    /** Session id last applied to the client context. */
+    private currentSessionId;
+    /** True while the SDK records something that is not user activity (session_start, active pings). */
+    private passive;
+    private readonly uiOptions;
+    private readonly runner;
+    private readonly firstSeenMemory;
+    private readonly dismissedMemory;
+    /** Snapshot revision whose commands and release check were last handled. */
+    private handledRevision;
+    private ui;
+    /** `sdk` lets framework wrappers (React, Angular) report their own package name and version. */
+    constructor(options: BrowserAcrOptions, sdk?: SdkInfo);
+    /**
+     * Installs listeners and hooks, sends telemetry persisted by an earlier page, then records the first page view.
+     * Calling it again does nothing.
+     */
+    start(): void;
+    /** Removes everything start() installed. Telemetry already buffered is still sent on the next flush. */
+    stop(): void;
+    /** Current web vitals, for example to display them in a UI. */
+    getVitals(): VitalsSnapshot;
+    /** Listens for vitals updates. Returns an unsubscribe function. */
+    onVitals(listener: (snapshot: VitalsSnapshot) => void): () => void;
+    /**
+     * Records a page view. Query strings and fragments are dropped; repeated paths are ignored. Pass a path when the
+     * router state differs from window.location (for example with an in-memory router).
+     */
+    trackPageView(pathOverride?: string): void;
+    /** Stops collection, discards unsent telemetry (in memory and persisted) and remembers the choice on this browser. */
+    optOut(): void;
+    /** Resumes collection after optOut(). Do Not Track still wins when respected. */
+    optIn(): void;
+    /**
+     * Forgets the current visitor, for example on logout: clears the user id, replaces the anonymous id (stored in
+     * localStorage `acr.anonymousId`) and starts a new session, which sends its own `session_start`.
+     */
+    reset(): void;
+    /**
+     * Hides an announcement for this visitor. Remembered per announcement id in localStorage `acr.dismissed`. Only
+     * dismissible announcements can be dismissed.
+     */
+    dismissAnnouncement(id: string): void;
+    /** Reloads the page. Used by `reload` commands, forced releases and the built-in prompt. */
+    protected reloadPage(): void;
+    protected isAnnouncementDismissed(id: string): boolean;
+    /** Every event, log and error counts as activity: it keeps the session alive or rolls it over after a timeout. */
+    protected onTrack(): void;
+    private refreshSession;
+    private emitSessionStart;
+    private recordPassively;
+    private hookErrors;
+    private hookNavigation;
+    private hookFetch;
+    private hookVitals;
+    /** Sends web vitals once per page, when the page is first hidden. */
+    private reportVitals;
+    private hookLifecycle;
+    /**
+     * The page may be about to go away. Every kind is sent at once with keepalive requests (sendBeacon cannot carry the
+     * key header). A bounded copy of what is still undelivered is kept in localStorage first; if the page survives, the
+     * copy is updated once the requests finish. Replayed items keep their ids, so the API drops any duplicates.
+     */
+    private onHidden;
+    private hookControl;
+    private handleControlState;
+    /**
+     * `release.mode = force` and `appVersion` below `minimumVersion`: reload once per tab and minimum version. If the
+     * page is still outdated after that reload (for example a stale CDN copy), the prompt is shown instead of looping.
+     */
+    private forceReloadIfRequired;
+    private hookActivePing;
+    private persistPending;
+    private replayPersistedQueue;
+}

package/dist/types/captured.d.ts

@@ -0,0 +1,4 @@
+/** Records that `error` was reported. Primitives cannot be tracked and are ignored. */
+export declare function markCaptured(error: unknown): void;
+/** True when `error` was already reported through markCaptured(). */
+export declare function wasCaptured(error: unknown): boolean;

package/dist/types/control/command-runner.d.ts

@@ -0,0 +1,57 @@
+import { type Attributes, type ClearCacheParams, type ControlCommand } from '@lib-acr/core';
+/** Ids of commands already applied on this browser, newest last. */
+export declare const COMMANDS_KEY = "acr.cmds";
+/** sessionStorage: epoch ms of the last reload the SDK triggered, a second guard against reload loops. */
+export declare const RELOAD_GUARD_KEY = "acr.reloadAt";
+/** Storage keys starting with this prefix belong to the SDK and survive `clear_cache`. */
+export declare const RESERVED_PREFIX = "acr.";
+export declare const COMMAND_APPLIED_EVENT = "acr.command_applied";
+export type CacheCategory = 'cacheStorage' | 'serviceWorkers' | 'localStorage' | 'sessionStorage' | 'indexedDb' | 'cookies';
+export type CategoryResult = 'ok' | 'partial' | 'failed';
+export type CommandResult = 'ok' | 'partial' | 'failed';
+export interface CommandOutcome {
+    commandId: string;
+    type: string;
+    result: CommandResult;
+    /** Categories that were cleared completely. */
+    cleared: CacheCategory[];
+}
+export interface CommandRunnerDeps {
+    localStorage: () => Storage | null;
+    sessionStorage: () => Storage | null;
+    /** `acr.firstSeen`. */
+    firstSeen: () => string | null;
+    /** Records the acknowledgement event. */
+    track: (name: string, attributes: Attributes) => void;
+    flush: () => Promise<void>;
+    /** Reloads the page now. */
+    reload: () => void;
+    /** Asks the user to reload (the "new version available" prompt). */
+    promptReload: () => void;
+    now?: () => number;
+}
+/**
+ * Runs remote commands at most once per browser (docs/SDK-PROTOCOL.md §5): plans them with planCommands(), records
+ * each id in `localStorage['acr.cmds']` before acting (a command whose id cannot be recorded is not run, so a reload
+ * can never loop), acts, sends `acr.command_applied` and flushes. A reload, if any command asked for one, happens once
+ * at the end, after the acknowledgements were sent.
+ */
+export declare class CommandRunner {
+    private readonly deps;
+    private chain;
+    constructor(deps: CommandRunnerDeps);
+    /** Runs are serialised: a run started while another is in progress waits for it. Never rejects. */
+    run(commands: readonly ControlCommand[]): Promise<CommandOutcome[]>;
+    /** Ids recorded in `acr.cmds`. */
+    appliedIds(): string[];
+    private execute;
+    /** Appends the id to `acr.cmds` (last 50 kept) and reads it back. False when storage is unavailable. */
+    private record;
+    /** No second SDK-triggered reload within 30 s in this tab. */
+    private reloadAllowed;
+}
+/** Clears the categories set in `params`. Returns the overall result and the categories cleared completely. */
+export declare function clearCaches(params: ClearCacheParams, stores: Pick<CommandRunnerDeps, 'localStorage' | 'sessionStorage'>): Promise<{
+    result: CommandResult;
+    cleared: CacheCategory[];
+}>;