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

package/dist/tracking/browser/env.js

@@ -0,0 +1,150 @@
+"use strict";
+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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserEnv = exports.deviceOf = exports.browserTransport = void 0;
+var storage_1 = require("../core/storage");
+/**
+ * Sends a batch. `beacon` (page going away): `navigator.sendBeacon`, falling back
+ * to `fetch(…, { keepalive: true })` when the beacon is refused (too big, or the
+ * browser has none). Any HTTP answer counts as delivered — the collector always
+ * answers 204, and a 404 (collector not installed) must not turn into a retry loop;
+ * only a network error keeps the batch for the next flush.
+ */
+var browserTransport = function (endpoint) { return ({
+    send: function (body, mode) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (mode === 'beacon' && typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+                            try {
+                                if (navigator.sendBeacon(endpoint, new Blob([body], { type: 'application/json' })))
+                                    return [2 /*return*/, true];
+                            }
+                            catch (_c) {
+                                /* fall through to fetch */
+                            }
+                        }
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, fetch(endpoint, {
+                                method: 'POST',
+                                body: body,
+                                headers: { 'Content-Type': 'application/json' },
+                                // Batches stay under 60 KB (queue.ts), inside keepalive's 64 KB budget.
+                                keepalive: true,
+                                credentials: 'same-origin',
+                            })];
+                    case 2:
+                        _b.sent();
+                        return [2 /*return*/, true];
+                    case 3:
+                        _a = _b.sent();
+                        return [2 /*return*/, false];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    },
+}); };
+exports.browserTransport = browserTransport;
+var fetchJson = function (url, timeoutMs) { return __awaiter(void 0, void 0, void 0, function () {
+    var ctrl, timer, res;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                ctrl = typeof AbortController !== 'undefined' ? new AbortController() : undefined;
+                timer = setTimeout(function () { return ctrl === null || ctrl === void 0 ? void 0 : ctrl.abort(); }, timeoutMs);
+                _a.label = 1;
+            case 1:
+                _a.trys.push([1, , 4, 5]);
+                return [4 /*yield*/, fetch(url, { headers: { Accept: 'application/json' }, signal: ctrl === null || ctrl === void 0 ? void 0 : ctrl.signal, credentials: 'same-origin' })];
+            case 2:
+                res = _a.sent();
+                if (!res.ok)
+                    throw new Error("HTTP ".concat(res.status));
+                return [4 /*yield*/, res.json()];
+            case 3: return [2 /*return*/, _a.sent()];
+            case 4:
+                clearTimeout(timer);
+                return [7 /*endfinally*/];
+            case 5: return [2 /*return*/];
+        }
+    });
+}); };
+/** desktop / tablet / mobile from the user agent (targeting only; the server classifies for reports). */
+var deviceOf = function (ua) {
+    if (/iPad|Tablet|PlayBook|Silk|Android(?!.*Mobile)/i.test(ua))
+        return 'tablet';
+    if (/Mobi|iPhone|iPod|Android.*Mobile|Opera Mini|IEMobile/i.test(ua))
+        return 'mobile';
+    return 'desktop';
+};
+exports.deviceOf = deviceOf;
+var readPage = function () { return ({
+    origin: window.location.origin,
+    path: window.location.pathname,
+    search: window.location.search,
+    title: document.title,
+    referrer: document.referrer,
+    lang: navigator.language || 'en',
+    viewport: [window.innerWidth, window.innerHeight],
+    device: (0, exports.deviceOf)(navigator.userAgent || ''),
+}); };
+var browserEnv = function (endpoint) { return ({
+    local: (0, storage_1.safeStorage)(function () { return window.localStorage; }),
+    session: (0, storage_1.safeStorage)(function () { return window.sessionStorage; }),
+    transport: (0, exports.browserTransport)(endpoint),
+    now: function () { return Date.now(); },
+    setTimer: function (fn, ms) { return setTimeout(fn, ms); },
+    clearTimer: function (h) { return clearTimeout(h); },
+    page: readPage,
+    fetchJson: fetchJson,
+    // eslint-disable-next-line no-console
+    log: function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return console.info.apply(console, args);
+    },
+}); };
+exports.browserEnv = browserEnv;
+//# sourceMappingURL=env.js.map

package/dist/tracking/browser/env.js.map

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

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

@@ -0,0 +1,21 @@
+import type { IStorage } from './storage';
+import { Observable } from './observable';
+import { type TConsentState, type TStorageKeys } from './types';
+/**
+ * The visitor's answer (§3 of the contract): `localStorage["<prefix>consent"]` is
+ * `granted` | `denied`, `<prefix>consent.v` the version of the text they answered
+ * (prefix `qa.` by default). An answer to an older version counts as no answer, so
+ * the consent prompt asks again.
+ */
+export declare class ConsentStore {
+    private readonly storage;
+    private readonly version;
+    private readonly keys;
+    readonly state: Observable<TConsentState>;
+    constructor(storage: IStorage, version: number, keys?: TStorageKeys);
+    private read;
+    get: () => TConsentState;
+    granted: () => boolean;
+    answer(state: 'granted' | 'denied'): void;
+}
+//# sourceMappingURL=consent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../../src/tracking/core/consent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;GAKG;AACH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;gBAGvB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,YAAmB;IAK5C,OAAO,CAAC,IAAI;IAOZ,GAAG,QAAO,aAAa,CAAqB;IAC5C,OAAO,QAAO,OAAO,CAAmC;IAExD,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ;CAKnC"}

package/dist/tracking/core/consent.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsentStore = void 0;
+var observable_1 = require("./observable");
+var types_1 = require("./types");
+/**
+ * The visitor's answer (§3 of the contract): `localStorage["<prefix>consent"]` is
+ * `granted` | `denied`, `<prefix>consent.v` the version of the text they answered
+ * (prefix `qa.` by default). An answer to an older version counts as no answer, so
+ * the consent prompt asks again.
+ */
+var ConsentStore = /** @class */ (function () {
+    function ConsentStore(storage, version, keys) {
+        if (keys === void 0) { keys = types_1.KEYS; }
+        var _this = this;
+        this.storage = storage;
+        this.version = version;
+        this.keys = keys;
+        this.get = function () { return _this.state.get(); };
+        this.granted = function () { return _this.state.get() === 'granted'; };
+        this.state = new observable_1.Observable(this.read());
+    }
+    ConsentStore.prototype.read = function () {
+        var _a;
+        var answer = this.storage.get(this.keys.consent);
+        var version = Number((_a = this.storage.get(this.keys.consentVersion)) !== null && _a !== void 0 ? _a : 0);
+        if ((answer === 'granted' || answer === 'denied') && version >= this.version)
+            return answer;
+        return 'unknown';
+    };
+    ConsentStore.prototype.answer = function (state) {
+        this.storage.set(this.keys.consent, state);
+        this.storage.set(this.keys.consentVersion, String(this.version));
+        this.state.set(state);
+    };
+    return ConsentStore;
+}());
+exports.ConsentStore = ConsentStore;
+//# sourceMappingURL=consent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../../src/tracking/core/consent.ts"],"names":[],"mappings":";;;AACA,2CAA0C;AAC1C,iCAAsE;AAEtE;;;;;GAKG;AACH;IAGE,sBACmB,OAAiB,EACjB,OAAe,EACf,IAAyB;QAAzB,qBAAA,EAAA,OAAqB,YAAI;QAH5C,iBAMC;QALkB,YAAO,GAAP,OAAO,CAAU;QACjB,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAqB;QAY5C,QAAG,GAAG,cAAqB,OAAA,KAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAhB,CAAgB,CAAC;QAC5C,YAAO,GAAG,cAAe,OAAA,KAAI,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,SAAS,EAA9B,CAA8B,CAAC;QAXtD,IAAI,CAAC,KAAK,GAAG,IAAI,uBAAU,CAAgB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAEO,2BAAI,GAAZ;;QACE,IAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,IAAM,OAAO,GAAG,MAAM,CAAC,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,mCAAI,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAC5F,OAAO,SAAS,CAAC;IACnB,CAAC;IAKD,6BAAM,GAAN,UAAO,KAA2B;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACH,mBAAC;AAAD,CAAC,AA1BD,IA0BC;AA1BY,oCAAY"}

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

@@ -0,0 +1,20 @@
+/**
+ * Engaged time: the tab is visible AND the visitor did something (scroll, pointer,
+ * key, touch) within the last `windowMs`. Each interaction extends the engaged
+ * stretch to `interaction + windowMs`; hiding the tab ends it at once.
+ */
+export declare class EngagementClock {
+    private readonly windowMs;
+    private engagedMs;
+    /** Start and end of the current engaged stretch (end is in the future while active). */
+    private from;
+    private until;
+    private tabVisible;
+    constructor(windowMs: number);
+    reset(): void;
+    activity(now: number): void;
+    setTabVisible(visible: boolean, now: number): void;
+    private close;
+    total(now: number): number;
+}
+//# sourceMappingURL=engagement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../../../src/tracking/core/engagement.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,eAAe;IAOd,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,SAAS,CAAK;IACtB,wFAAwF;IACxF,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,UAAU,CAAQ;gBAEG,QAAQ,EAAE,MAAM;IAE7C,KAAK;IAML,QAAQ,CAAC,GAAG,EAAE,MAAM;IAWpB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM;IAK3C,OAAO,CAAC,KAAK;IAMb,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAI3B"}

package/dist/tracking/core/engagement.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EngagementClock = void 0;
+/**
+ * Engaged time: the tab is visible AND the visitor did something (scroll, pointer,
+ * key, touch) within the last `windowMs`. Each interaction extends the engaged
+ * stretch to `interaction + windowMs`; hiding the tab ends it at once.
+ */
+var EngagementClock = /** @class */ (function () {
+    function EngagementClock(windowMs) {
+        this.windowMs = windowMs;
+        this.engagedMs = 0;
+        /** Start and end of the current engaged stretch (end is in the future while active). */
+        this.from = null;
+        this.until = 0;
+        this.tabVisible = true;
+    }
+    EngagementClock.prototype.reset = function () {
+        this.engagedMs = 0;
+        this.from = null;
+        this.until = 0;
+    };
+    EngagementClock.prototype.activity = function (now) {
+        if (!this.tabVisible)
+            return;
+        if (this.from != null && now <= this.until) {
+            this.until = now + this.windowMs;
+            return;
+        }
+        this.close(now);
+        this.from = now;
+        this.until = now + this.windowMs;
+    };
+    EngagementClock.prototype.setTabVisible = function (visible, now) {
+        if (!visible)
+            this.close(now);
+        this.tabVisible = visible;
+    };
+    EngagementClock.prototype.close = function (now) {
+        if (this.from == null)
+            return;
+        this.engagedMs += Math.max(0, Math.min(now, this.until) - this.from);
+        this.from = null;
+    };
+    EngagementClock.prototype.total = function (now) {
+        var open = this.from != null ? Math.max(0, Math.min(now, this.until) - this.from) : 0;
+        return Math.round(this.engagedMs + open);
+    };
+    return EngagementClock;
+}());
+exports.EngagementClock = EngagementClock;
+//# sourceMappingURL=engagement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../../../src/tracking/core/engagement.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH;IAOE,yBAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QANrC,cAAS,GAAG,CAAC,CAAC;QACtB,wFAAwF;QAChF,SAAI,GAAkB,IAAI,CAAC;QAC3B,UAAK,GAAG,CAAC,CAAC;QACV,eAAU,GAAG,IAAI,CAAC;IAEsB,CAAC;IAEjD,+BAAK,GAAL;QACE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,kCAAQ,GAAR,UAAS,GAAW;QAClB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAC7B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YACjC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,uCAAa,GAAb,UAAc,OAAgB,EAAE,GAAW;QACzC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,CAAC;IAEO,+BAAK,GAAb,UAAc,GAAW;QACvB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI;YAAE,OAAO;QAC9B,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,+BAAK,GAAL,UAAM,GAAW;QACf,IAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;IACH,sBAAC;AAAD,CAAC,AAzCD,IAyCC;AAzCY,0CAAe"}

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

@@ -0,0 +1,109 @@
+import { Observable } from './observable';
+import { type IStorage } from './storage';
+import { type IExperimentDefinition, type IExperimentVariant, type TStorageKeys } from './types';
+/**
+ * Client-side assignment (§5 of the contract). No round trip: the running
+ * experiments are fetched once (public fields only) and every visitor is bucketed
+ * locally from their `vid`, the same way every time, on any page.
+ */
+export type TAssignmentReason = 
+/** Bucketed into a variant: an exposure is logged when the trigger is seen. */
+'assigned'
+/** Outside the experiment's traffic share: control, no exposure. */
+ | 'not-enrolled'
+/** Targeting (path, device, language) does not match: control, no exposure. */
+ | 'not-targeted'
+/** No consent (no vid) or tracking disabled: control, no exposure. */
+ | 'no-consent'
+/** Definitions not loaded (yet, or the endpoint is missing) or experiment not running: control. */
+ | 'not-running'
+/** A preview link (`?qa_variant=`) or the in-app version switch: that variant, never logged. */
+ | 'preview'
+/** The experiment ended: everybody sees the winner, nothing is logged. */
+ | 'concluded';
+export interface IAssignment {
+    key: string;
+    variant: string;
+    /** Whether this visitor counts for the experiment (exposure is logged). */
+    enrolled: boolean;
+    reason: TAssignmentReason;
+    /** The section whose being seen logs the exposure; null → on render. */
+    trigger: string | null;
+}
+export interface IAssignContext {
+    path: string;
+    device?: 'desktop' | 'tablet' | 'mobile';
+    lang?: string;
+}
+export declare const controlOf: (variants: IExperimentVariant[], fallback?: string) => string;
+/**
+ * GrowthBook's bucket ranges: variant i owns `[c_i, c_i + traffic * w_i)` where
+ * `c_i` is the sum of the weights before it. The enrolled share equals `traffic`,
+ * and raising `traffic` later never moves an enrolled visitor to another variant.
+ * Weights that do not add up to 1 are normalised.
+ */
+export declare const bucketRanges: (weights: number[], traffic: number) => [number, number][];
+/** `/` matches `/` only; `/blog/*` matches `/blog/` and everything under it. */
+export declare const pathMatches: (patterns: string[] | null | undefined, path: string) => boolean;
+/** Pure assignment of one visitor to one experiment. */
+export declare const assign: (def: IExperimentDefinition, vid: string | null, ctx: IAssignContext) => IAssignment;
+/** The default preview query parameter. */
+export declare const DEFAULT_PREVIEW_PARAM = "qa_variant";
+/**
+ * `?qa_variant=signup-cta:b,other:a` → `{ 'signup-cta': 'b', other: 'a' }`.
+ * `?qa_variant=clear` (or `off`) → `{}` and clears the saved preview.
+ * Returns null when the parameter is absent. `param` names the query parameter.
+ */
+export declare const parsePreview: (search: string, param?: string) => Record<string, string> | null;
+export type TExperimentsStatus = 'idle' | 'loading' | 'ready' | 'failed';
+/** A usable entry, normalised (a concluded entry gets `variants: []`); null for junk. */
+export declare const normaliseDefinition: (x: unknown) => IExperimentDefinition | null;
+export interface IExperimentsDeps {
+    property: string;
+    endpoint: string;
+    local: IStorage;
+    session: IStorage;
+    now: () => number;
+    fetchJson: (url: string, timeoutMs: number) => Promise<unknown>;
+    /** Storage keys (default prefix `qa.`). */
+    keys?: TStorageKeys;
+    /** The preview query parameter (default `qa_variant`). */
+    previewParam?: string;
+}
+/** Holds the running experiments and the preview overrides. */
+export declare class ExperimentStore {
+    private readonly d;
+    readonly status: Observable<TExperimentsStatus>;
+    /**
+     * An in-app version switch, per experiment (`{ key: variant }`), in this browser's
+     * localStorage (an editor lets its user see each version). A preview: never logged.
+     * Rendered variants follow it live.
+     */
+    readonly editorOverrides: Observable<Record<string, string>>;
+    /**
+     * Bumped by `refresh()` (an editor, after it accepted a winner or removed a version): mounted
+     * experiments decide again, so an accepted test shows its winner at once. Visitors never
+     * trigger it, so their variant stays fixed for the page view.
+     */
+    readonly revision: Observable<number>;
+    private definitions;
+    private preview;
+    private readonly keys;
+    constructor(d: IExperimentsDeps);
+    /** Reads the preview parameter (`?qa_variant=`) from the URL; the preview sticks for the browser session. */
+    applyPreviewFrom(search: string): void;
+    /** The in-app switch first, then a preview link. */
+    previewOf: (key: string) => string | undefined;
+    editorOverrideOf: (key: string) => string | undefined;
+    /** The in-app version switch for one experiment; `null` goes back to the visitor's own variant. */
+    setEditorOverride(key: string, variant: string | null): void;
+    /** Re-reads the switches (another window of the same app changed them). */
+    reloadEditorOverrides(): void;
+    /** Loads the definitions again and makes mounted experiments decide again (for an editor, never for visitors). */
+    refresh(): Promise<void>;
+    private setDefinitions;
+    get(key: string): IExperimentDefinition;
+    /** Fetches the running experiments; a missing endpoint leaves everyone on the control. */
+    load(force?: boolean): Promise<void>;
+}
+//# sourceMappingURL=experiments.d.ts.map

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

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