@qoretechnologies/reqraft 0.10.56 → 0.10.57-pr.127.g0a792ea

package/dist/tracking/core/queue.js

@@ -0,0 +1,205 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventQueue = exports.MAX_BACKLOG = exports.MAX_BATCH_BYTES = exports.MAX_EVENTS_PER_BATCH = void 0;
+/** Collector limits (§4): at most 100 events and 64 KB per batch. We stay under both. */
+exports.MAX_EVENTS_PER_BATCH = 100;
+exports.MAX_BATCH_BYTES = 60 * 1024;
+/** Events kept while the collector is unreachable; the oldest are dropped past this. */
+exports.MAX_BACKLOG = 500;
+var size = function (s) { return (typeof TextEncoder !== 'undefined' ? new TextEncoder().encode(s).length : s.length * 2); };
+/**
+ * Batches events: sends every `flushIntervalMs`, as soon as `maxQueued` are waiting,
+ * and immediately (as a beacon) when the page is going away.
+ */
+var EventQueue = /** @class */ (function () {
+    function EventQueue(o) {
+        this.o = o;
+        this.events = [];
+        this.timer = null;
+        this.sending = false;
+    }
+    Object.defineProperty(EventQueue.prototype, "length", {
+        get: function () {
+            return this.events.length;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    EventQueue.prototype.push = function (event) {
+        this.events.push(event);
+        if (this.events.length > exports.MAX_BACKLOG)
+            this.events.splice(0, this.events.length - exports.MAX_BACKLOG);
+        if (this.events.length >= this.o.maxQueued)
+            void this.flush('fetch');
+        else
+            this.schedule();
+    };
+    /** Forget everything unsent (consent withdrawn). */
+    EventQueue.prototype.clear = function () {
+        this.events = [];
+        if (this.timer != null)
+            this.o.clearTimer(this.timer);
+        this.timer = null;
+    };
+    EventQueue.prototype.schedule = function () {
+        var _this = this;
+        if (this.timer != null)
+            return;
+        this.timer = this.o.setTimer(function () {
+            _this.timer = null;
+            void _this.flush('fetch');
+        }, this.o.flushIntervalMs);
+    };
+    /** Splits `events` into batches that fit the collector's limits. */
+    EventQueue.chunk = function (events, envelope, sentAt) {
+        var batches = [];
+        var current = [];
+        var bodyOf = function (evts) { return JSON.stringify(__assign(__assign({}, envelope), { sent_at: sentAt, events: evts })); };
+        for (var _i = 0, events_1 = events; _i < events_1.length; _i++) {
+            var e = events_1[_i];
+            var next = __spreadArray(__spreadArray([], current, true), [e], false);
+            if (current.length && (next.length > exports.MAX_EVENTS_PER_BATCH || size(bodyOf(next)) > exports.MAX_BATCH_BYTES)) {
+                batches.push(__assign(__assign({}, envelope), { sent_at: sentAt, events: current }));
+                current = [e];
+            }
+            else {
+                current = next;
+            }
+        }
+        if (current.length)
+            batches.push(__assign(__assign({}, envelope), { sent_at: sentAt, events: current }));
+        // A single event larger than the limit is dropped rather than rejected forever.
+        return batches.filter(function (b) { return b.events.length > 1 || size(JSON.stringify(b)) <= exports.MAX_BATCH_BYTES; });
+    };
+    EventQueue.prototype.flush = function () {
+        return __awaiter(this, arguments, void 0, function (mode) {
+            var envelope, pending, batches, failed, _i, batches_1, batch, ok, _a;
+            var _b, _c;
+            if (mode === void 0) { mode = 'fetch'; }
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        if (this.timer != null) {
+                            this.o.clearTimer(this.timer);
+                            this.timer = null;
+                        }
+                        if (!this.events.length)
+                            return [2 /*return*/];
+                        // A fetch in flight owns the queue; a beacon (page going away) sends what is left now.
+                        if (this.sending && mode === 'fetch') {
+                            this.schedule();
+                            return [2 /*return*/];
+                        }
+                        envelope = this.o.envelope();
+                        if (!envelope) {
+                            this.events = [];
+                            return [2 /*return*/];
+                        }
+                        pending = this.events;
+                        this.events = [];
+                        batches = EventQueue.chunk(pending, envelope, new Date(this.o.now()).toISOString());
+                        this.sending = true;
+                        failed = [];
+                        _d.label = 1;
+                    case 1:
+                        _d.trys.push([1, , 9, 10]);
+                        _i = 0, batches_1 = batches;
+                        _d.label = 2;
+                    case 2:
+                        if (!(_i < batches_1.length)) return [3 /*break*/, 8];
+                        batch = batches_1[_i];
+                        (_c = (_b = this.o).debug) === null || _c === void 0 ? void 0 : _c.call(_b, batch);
+                        ok = false;
+                        _d.label = 3;
+                    case 3:
+                        _d.trys.push([3, 5, , 6]);
+                        return [4 /*yield*/, this.o.transport.send(JSON.stringify(batch), mode)];
+                    case 4:
+                        ok = _d.sent();
+                        return [3 /*break*/, 6];
+                    case 5:
+                        _a = _d.sent();
+                        ok = false;
+                        return [3 /*break*/, 6];
+                    case 6:
+                        if (!ok)
+                            failed.push.apply(failed, batch.events);
+                        _d.label = 7;
+                    case 7:
+                        _i++;
+                        return [3 /*break*/, 2];
+                    case 8: return [3 /*break*/, 10];
+                    case 9:
+                        this.sending = false;
+                        return [7 /*endfinally*/];
+                    case 10:
+                        if (failed.length) {
+                            // Kept for the next flush, which the next event schedules (no retry loop against a
+                            // collector that is down); event ids make a double delivery harmless.
+                            this.events = __spreadArray(__spreadArray([], failed, true), this.events, true).slice(-exports.MAX_BACKLOG);
+                        }
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return EventQueue;
+}());
+exports.EventQueue = EventQueue;
+//# sourceMappingURL=queue.js.map

package/dist/tracking/core/queue.js.map

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

package/dist/tracking/core/sections.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Attention per section, as plain arithmetic over time (no DOM): the browser layer
+ * feeds it visibility changes from an IntersectionObserver and tab visibility, and
+ * asks it for the page summary.
+ *
+ * - `visible_ms`: time any part of the section was on screen while the tab was visible.
+ * - `seen`: the section was at least 50% visible for at least 1 s in one stretch — the
+ *   attention definition the contract uses everywhere (§4). "50% visible" is 50% of
+ *   the section *or* 50% of the viewport covered by it: a section taller than two
+ *   screens can never show half of itself, and it would otherwise never count.
+ * - `first_seen_ms`: when that stretch began, measured from the start of the page view.
+ */
+export declare const SEEN_RATIO = 0.5;
+export declare const SEEN_MS = 1000;
+export interface ISectionSummary {
+    id: string;
+    visible_ms: number;
+    seen: boolean;
+    first_seen_ms: number | null;
+}
+export declare class SectionClock {
+    private start;
+    private sections;
+    private tabVisible;
+    private seenListeners;
+    constructor(start: number);
+    /** A new page view: everything starts from zero at `now`. */
+    reset(now: number): void;
+    onSeen(listener: (id: string) => void): () => any;
+    isSeen: (id: string) => boolean;
+    private ensure;
+    /** Registers a section so it shows up in the summary even if it is never on screen. */
+    register(id: string, report?: boolean): void;
+    /** The section's effective visibility changed. */
+    update(id: string, ratio: number, now: number): void;
+    /** The tab became visible or hidden: time stops counting while hidden. */
+    setTabVisible(visible: boolean, now: number): void;
+    /** Promotes stretches that have lasted long enough to `seen`. Call ~every second. */
+    tick(now: number): void;
+    /** Closes the open stretches up to `now` (visible time, seen). */
+    private settle;
+    private tickOne;
+    /** Opens stretches for the current state. */
+    private arm;
+    /** The section most on screen now (ties: the lower one on the page, i.e. the later registered). */
+    current(): string | null;
+    summary(now: number): ISectionSummary[];
+}
+/**
+ * Effective visibility from an IntersectionObserver entry: the larger of the share
+ * of the section on screen and the share of the viewport the section fills.
+ */
+export declare const effectiveRatio: (intersectionRatio: number, intersectionHeight: number, viewportHeight: number) => number;
+//# sourceMappingURL=sections.d.ts.map

package/dist/tracking/core/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../src/tracking/core/sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,OAAO,OAAO,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAeD,qBAAa,YAAY;IAKX,OAAO,CAAC,KAAK;IAJzB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAmC;gBAEpC,KAAK,EAAE,MAAM;IAEjC,6DAA6D;IAC7D,KAAK,CAAC,GAAG,EAAE,MAAM;IAOjB,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;IAKrC,MAAM,OAAQ,MAAM,aAA2C;IAE/D,OAAO,CAAC,MAAM;IASd,uFAAuF;IACvF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,UAAO;IAIlC,kDAAkD;IAClD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAsB7C,0EAA0E;IAC1E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM;IAO3C,qFAAqF;IACrF,IAAI,CAAC,GAAG,EAAE,MAAM;IAIhB,kEAAkE;IAClE,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,OAAO;IAQf,6CAA6C;IAC7C,OAAO,CAAC,GAAG;IAMX,mGAAmG;IACnG,OAAO,IAAI,MAAM,GAAG,IAAI;IAQxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE;CAWxC;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,sBACN,MAAM,sBACL,MAAM,kBACV,MAAM,KACrB,MAIF,CAAC"}

package/dist/tracking/core/sections.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Attention per section, as plain arithmetic over time (no DOM): the browser layer
+ * feeds it visibility changes from an IntersectionObserver and tab visibility, and
+ * asks it for the page summary.
+ *
+ * - `visible_ms`: time any part of the section was on screen while the tab was visible.
+ * - `seen`: the section was at least 50% visible for at least 1 s in one stretch — the
+ *   attention definition the contract uses everywhere (§4). "50% visible" is 50% of
+ *   the section *or* 50% of the viewport covered by it: a section taller than two
+ *   screens can never show half of itself, and it would otherwise never count.
+ * - `first_seen_ms`: when that stretch began, measured from the start of the page view.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.effectiveRatio = exports.SectionClock = exports.SEEN_MS = exports.SEEN_RATIO = void 0;
+exports.SEEN_RATIO = 0.5;
+exports.SEEN_MS = 1000;
+var SectionClock = /** @class */ (function () {
+    function SectionClock(start) {
+        var _this = this;
+        this.start = start;
+        this.sections = new Map();
+        this.tabVisible = true;
+        this.seenListeners = new Set();
+        this.isSeen = function (id) { var _a; return ((_a = _this.sections.get(id)) === null || _a === void 0 ? void 0 : _a.seenAt) != null; };
+    }
+    /** A new page view: everything starts from zero at `now`. */
+    SectionClock.prototype.reset = function (now) {
+        var _this = this;
+        this.start = now;
+        var ids = Array.from(this.sections.values()).map(function (s) { return [s.id, s.report]; });
+        this.sections.clear();
+        ids.forEach(function (_a) {
+            var id = _a[0], report = _a[1];
+            return _this.ensure(id, report);
+        });
+    };
+    SectionClock.prototype.onSeen = function (listener) {
+        var _this = this;
+        this.seenListeners.add(listener);
+        return function () { return void _this.seenListeners.delete(listener); };
+    };
+    SectionClock.prototype.ensure = function (id, report) {
+        if (report === void 0) { report = true; }
+        var s = this.sections.get(id);
+        if (!s) {
+            s = { id: id, ratio: 0, visibleMs: 0, visibleSince: null, halfSince: null, seenAt: null, firstSeenMs: null, report: report };
+            this.sections.set(id, s);
+        }
+        return s;
+    };
+    /** Registers a section so it shows up in the summary even if it is never on screen. */
+    SectionClock.prototype.register = function (id, report) {
+        var _a;
+        if (report === void 0) { report = true; }
+        (_a = this.ensure(id, report)).report || (_a.report = report);
+    };
+    /** The section's effective visibility changed. */
+    SectionClock.prototype.update = function (id, ratio, now) {
+        var s = this.ensure(id);
+        if (this.tabVisible) {
+            var wasVisible = s.ratio > 0;
+            var isVisible = ratio > 0;
+            if (wasVisible && !isVisible && s.visibleSince != null) {
+                s.visibleMs += Math.max(0, now - s.visibleSince);
+                s.visibleSince = null;
+            }
+            if (!wasVisible && isVisible)
+                s.visibleSince = now;
+            // A stretch at >= 50% continues through ratio changes above the line.
+            var wasHalf = s.ratio >= exports.SEEN_RATIO;
+            var isHalf = ratio >= exports.SEEN_RATIO;
+            if (wasHalf && !isHalf) {
+                this.tickOne(s, now);
+                s.halfSince = null;
+            }
+            if (!wasHalf && isHalf)
+                s.halfSince = now;
+        }
+        s.ratio = ratio;
+    };
+    /** The tab became visible or hidden: time stops counting while hidden. */
+    SectionClock.prototype.setTabVisible = function (visible, now) {
+        var _this = this;
+        if (visible === this.tabVisible)
+            return;
+        this.sections.forEach(function (s) { return _this.settle(s, now); });
+        this.tabVisible = visible;
+        this.sections.forEach(function (s) { return _this.arm(s, now); });
+    };
+    /** Promotes stretches that have lasted long enough to `seen`. Call ~every second. */
+    SectionClock.prototype.tick = function (now) {
+        var _this = this;
+        this.sections.forEach(function (s) { return _this.tickOne(s, now); });
+    };
+    /** Closes the open stretches up to `now` (visible time, seen). */
+    SectionClock.prototype.settle = function (s, now) {
+        if (s.visibleSince != null)
+            s.visibleMs += Math.max(0, now - s.visibleSince);
+        s.visibleSince = null;
+        this.tickOne(s, now);
+        s.halfSince = null;
+    };
+    SectionClock.prototype.tickOne = function (s, now) {
+        if (s.seenAt == null && s.halfSince != null && now - s.halfSince >= exports.SEEN_MS) {
+            s.seenAt = now;
+            s.firstSeenMs = Math.max(0, s.halfSince - this.start);
+            this.seenListeners.forEach(function (l) { return l(s.id); });
+        }
+    };
+    /** Opens stretches for the current state. */
+    SectionClock.prototype.arm = function (s, now) {
+        if (!this.tabVisible)
+            return;
+        if (s.ratio > 0)
+            s.visibleSince = now;
+        if (s.ratio >= exports.SEEN_RATIO)
+            s.halfSince = now;
+    };
+    /** The section most on screen now (ties: the lower one on the page, i.e. the later registered). */
+    SectionClock.prototype.current = function () {
+        var _a;
+        var best = null;
+        for (var _i = 0, _b = Array.from(this.sections.values()); _i < _b.length; _i++) {
+            var s = _b[_i];
+            if (s.report && s.ratio > 0 && (!best || s.ratio >= best.ratio))
+                best = s;
+        }
+        return (_a = best === null || best === void 0 ? void 0 : best.id) !== null && _a !== void 0 ? _a : null;
+    };
+    SectionClock.prototype.summary = function (now) {
+        this.tick(now);
+        return Array.from(this.sections.values())
+            .filter(function (s) { return s.report; })
+            .map(function (s) { return ({
+            id: s.id,
+            visible_ms: Math.round(s.visibleMs + (s.visibleSince != null ? Math.max(0, now - s.visibleSince) : 0)),
+            seen: s.seenAt != null,
+            first_seen_ms: s.firstSeenMs,
+        }); });
+    };
+    return SectionClock;
+}());
+exports.SectionClock = SectionClock;
+/**
+ * Effective visibility from an IntersectionObserver entry: the larger of the share
+ * of the section on screen and the share of the viewport the section fills.
+ */
+var effectiveRatio = function (intersectionRatio, intersectionHeight, viewportHeight) {
+    if (intersectionRatio <= 0)
+        return 0;
+    var cover = viewportHeight > 0 ? intersectionHeight / viewportHeight : 0;
+    return Math.min(1, Math.max(intersectionRatio, cover));
+};
+exports.effectiveRatio = effectiveRatio;
+//# sourceMappingURL=sections.js.map

package/dist/tracking/core/sections.js.map

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

package/dist/tracking/core/storage.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Storage that never throws: private windows, blocked site data and sandboxed
+ * iframes make `localStorage` throw on access. The tracker then keeps its state in
+ * memory for the page's lifetime and the site behaves exactly as without consent.
+ */
+export interface IStorage {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+export declare const memoryStorage: () => IStorage;
+export declare const safeStorage: (pick: () => Storage | undefined) => IStorage;
+export declare const readJson: <T>(storage: IStorage, key: string) => T | null;
+export declare const writeJson: (storage: IStorage, key: string, value: unknown) => void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/tracking/core/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/tracking/core/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,aAAa,QAAO,QAOhC,CAAC;AAEF,eAAO,MAAM,WAAW,SAAU,MAAM,OAAO,GAAG,SAAS,KAAG,QAoC7D,CAAC;AAEF,eAAO,MAAM,QAAQ,eAAgB,QAAQ,OAAO,MAAM,KAAG,CAAC,GAAG,IAQhE,CAAC;AAEF,eAAO,MAAM,SAAS,YAAa,QAAQ,OAAO,MAAM,SAAS,OAAO,SAA4C,CAAC"}

package/dist/tracking/core/storage.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeJson = exports.readJson = exports.safeStorage = exports.memoryStorage = void 0;
+var memoryStorage = function () {
+    var data = new Map();
+    return {
+        get: function (k) { var _a; return (_a = data.get(k)) !== null && _a !== void 0 ? _a : null; },
+        set: function (k, v) { return void data.set(k, v); },
+        remove: function (k) { return void data.delete(k); },
+    };
+};
+exports.memoryStorage = memoryStorage;
+var safeStorage = function (pick) {
+    var fallback = (0, exports.memoryStorage)();
+    var store = function () {
+        try {
+            return pick();
+        }
+        catch (_a) {
+            return undefined;
+        }
+    };
+    return {
+        get: function (k) {
+            try {
+                var s = store();
+                return s ? s.getItem(k) : fallback.get(k);
+            }
+            catch (_a) {
+                return fallback.get(k);
+            }
+        },
+        set: function (k, v) {
+            try {
+                var s = store();
+                if (s)
+                    s.setItem(k, v);
+                else
+                    fallback.set(k, v);
+            }
+            catch (_a) {
+                fallback.set(k, v);
+            }
+        },
+        remove: function (k) {
+            var _a;
+            fallback.remove(k);
+            try {
+                (_a = store()) === null || _a === void 0 ? void 0 : _a.removeItem(k);
+            }
+            catch (_b) {
+                /* ignore */
+            }
+        },
+    };
+};
+exports.safeStorage = safeStorage;
+var readJson = function (storage, key) {
+    var raw = storage.get(key);
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        return null;
+    }
+};
+exports.readJson = readJson;
+var writeJson = function (storage, key, value) { return storage.set(key, JSON.stringify(value)); };
+exports.writeJson = writeJson;
+//# sourceMappingURL=storage.js.map

package/dist/tracking/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/tracking/core/storage.ts"],"names":[],"mappings":";;;AAWO,IAAM,aAAa,GAAG;IAC3B,IAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,OAAO;QACL,GAAG,EAAE,UAAC,CAAC,YAAK,OAAA,MAAA,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAA,EAAA;QAC/B,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAnB,CAAmB;QAClC,MAAM,EAAE,UAAC,CAAC,IAAK,OAAA,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAnB,CAAmB;KACnC,CAAC;AACJ,CAAC,CAAC;AAPW,QAAA,aAAa,iBAOxB;AAEK,IAAM,WAAW,GAAG,UAAC,IAA+B;IACzD,IAAM,QAAQ,GAAG,IAAA,qBAAa,GAAE,CAAC;IACjC,IAAM,KAAK,GAAG;QACZ,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,GAAG,EAAE,UAAC,CAAC;YACL,IAAI,CAAC;gBACH,IAAM,CAAC,GAAG,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;YAAC,WAAM,CAAC;gBACP,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,GAAG,EAAE,UAAC,CAAC,EAAE,CAAC;YACR,IAAI,CAAC;gBACH,IAAM,CAAC,GAAG,KAAK,EAAE,CAAC;gBAClB,IAAI,CAAC;oBAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;oBAClB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,CAAC;YAAC,WAAM,CAAC;gBACP,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,MAAM,EAAE,UAAC,CAAC;;YACR,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC;gBACH,MAAA,KAAK,EAAE,0CAAE,UAAU,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;YAAC,WAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AApCW,QAAA,WAAW,eAoCtB;AAEK,IAAM,QAAQ,GAAG,UAAI,OAAiB,EAAE,GAAW;IACxD,IAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AARW,QAAA,QAAQ,YAQnB;AAEK,IAAM,SAAS,GAAG,UAAC,OAAiB,EAAE,GAAW,EAAE,KAAc,IAAK,OAAA,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAvC,CAAuC,CAAC;AAAxG,QAAA,SAAS,aAA+F"}

package/dist/tracking/core/tracker.d.ts

@@ -0,0 +1,122 @@
+import { ConsentStore } from './consent';
+import { ExperimentStore, type IAssignContext, type IAssignment } from './experiments';
+import { Observable } from './observable';
+import { type ITransport } from './queue';
+import { SectionClock } from './sections';
+import { type IStorage } from './storage';
+import { type ITrackingConfig, type TEventType, type TProps, type TStorageKeys, type TTrackingOptions } from './types';
+/** What the page looks like right now (the browser layer reads it from `window`). */
+export interface IPageInfo {
+    /** `https://example.com` */
+    origin: string;
+    path: string;
+    search: string;
+    title: string;
+    referrer: string;
+    lang: string;
+    viewport: [number, number];
+    device?: IAssignContext['device'];
+}
+/** Everything the tracker needs from its host; tests pass fakes. */
+export interface ITrackerEnv {
+    local: IStorage;
+    session: IStorage;
+    transport: ITransport;
+    now: () => number;
+    setTimer: (fn: () => void, ms: number) => unknown;
+    clearTimer: (handle: unknown) => void;
+    page: () => IPageInfo;
+    fetchJson: (url: string, timeoutMs: number) => Promise<unknown>;
+    log?: (...args: unknown[]) => void;
+}
+/**
+ * The tracker: identity, consent, the event queue, page views and their summaries,
+ * experiment assignment and exposure. It has no DOM code of its own (see
+ * `browser/attach.ts`), so it runs unchanged in tests and in any web property.
+ * Everything product-specific (property, endpoints, storage prefix) is in `config`.
+ *
+ * Never throws into the page: every public method is wrapped.
+ */
+export declare class Tracker {
+    private readonly env;
+    readonly consent: ConsentStore;
+    readonly experiments: ExperimentStore;
+    readonly sections: SectionClock;
+    private readonly engagement;
+    private readonly queue;
+    private pv;
+    private lastUrl;
+    private readonly firstTouchUtm;
+    private watches;
+    private started;
+    /** The current page view id (null without consent): the browser layer re-measures sections on change. */
+    readonly pageViewId: Observable<string>;
+    /** The storage keys under `config.storagePrefix`. */
+    readonly keys: TStorageKeys;
+    readonly config: ITrackingConfig;
+    constructor(options: TTrackingOptions, env: ITrackerEnv);
+    /** Runs `fn` and swallows any error: analytics never breaks the page. */
+    private safe;
+    private active;
+    /** The tracker's clock (the browser layer times sections with it). */
+    now: () => number;
+    /** The visitor id: exists only with consent. */
+    vid(): string | null;
+    /** The session id: a new one after `sessionTimeoutMs` without an event. */
+    private sid;
+    private envelope;
+    grant(): void;
+    /** Declines or withdraws: the visitor id and everything tied to it are deleted, nothing more is sent. */
+    deny(): void;
+    private onConsentChange;
+    /** Call once when the page has loaded: starts the first page view if consent was given earlier. */
+    start(): void;
+    /** A route change in a single-page app: closes the current page view and starts a new one. */
+    pageview(): void;
+    private beginPageView;
+    /**
+     * A cumulative summary of the page view. Sent when the tab is hidden (`final:
+     * false`, the visitor may come back) and when the page is left (`final: true`);
+     * the one with the highest `seq` for a `pv_id` is the complete one.
+     */
+    summary(final: boolean): void;
+    activity(): void;
+    scrolled(pct: number): void;
+    setTabVisible(visible: boolean): void;
+    /** The page is going away (`pagehide`). */
+    leave(): void;
+    flush(mode?: 'fetch' | 'beacon'): Promise<void>;
+    /** Queues an event of any type (nothing happens without consent). */
+    record(type: TEventType, props?: TProps): void;
+    heartbeat(): void;
+    click(props: {
+        target: string;
+        placement?: string | null;
+        label?: string | null;
+        href?: string | null;
+    }): void;
+    /** A conversion the server's goals can match (`signup-started`, …). */
+    goal(name: string, value?: number): void;
+    /** A named event with free-form props (`form-submitted`, `plan-picked`, …). */
+    custom(name: string, props?: TProps): void;
+    /**
+     * The variant for this visitor. Preview override first, then the running
+     * definition; the control whenever consent, the definitions or targeting say no.
+     */
+    decide(key: string, fallbackControl?: string): IAssignment;
+    /**
+     * Logs the exposure once per page view when the trigger section is seen (or at
+     * once for `trigger: null`). Returns an unsubscribe for when the variant unmounts.
+     */
+    watchExposure(assignment: IAssignment): () => void;
+    private onSectionSeen;
+    private expose;
+    /**
+     * Adds `qa_exp=key:variant,…` (experiments this visitor was exposed to; the server's
+     * sign-up flow reads this parameter, §5.4 of the contract) and the
+     * session's first-touch `utm_*` to a sign-up URL — nothing else, never the vid.
+     * Without consent the URL is returned unchanged.
+     */
+    decorateSignupUrl(url: string): string;
+}
+//# sourceMappingURL=tracker.d.ts.map