@rocapine/rocalytics-sdk 0.0.0-stage → 0.3.0

package/dist/client/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Event names `track` accepts. The union of every name the copied clients
+ * allowed; the API rejects a name it does not know. Any other name goes
+ * through `trackCustomEvent`, which the API forwards instead of storing.
+ */
+export type TrackEventName = "install" | "onboarding_completed" | "purchase" | "subscription_started" | "trial_started";
+/** Adjust attribution, as the Adjust SDK reports it. */
+export type AdjustAttribution = {
+    trackerToken?: string | null;
+    trackerName?: string | null;
+    network?: string | null;
+    campaign?: string | null;
+    adgroup?: string | null;
+    creative?: string | null;
+    clickLabel?: string | null;
+    adid?: string | null;
+    costType?: string | null;
+    costAmount?: number | null;
+    costCurrency?: string | null;
+    fbInstallReferrer?: string | null;
+};
+/** Identifiers for `identify`. Null and undefined values are dropped before sending. */
+export type IdentifyParams = {
+    revenue_cat_id?: string | null;
+    qonversion_id?: string | null;
+    adjust_id?: string | null;
+    adjust_attribution?: AdjustAttribution | null;
+    user_id?: string | null;
+    email?: string | null;
+    amplitude_device_id?: string | null;
+    idfa?: string | null;
+    idfv?: string | null;
+    android_id?: string | null;
+    customerio_id?: string | null;
+    segment_id?: string | null;
+    gaid?: string | null;
+    /** BCP 47 tag of the language the app is shown in. */
+    locale?: string | null;
+};
+/**
+ * A store product, from any purchase SDK. Forwarded whole under
+ * `experimental.product`; its `productIdentifier` is the product id when
+ * `productId` is not given.
+ */
+export type PurchaseProduct = object;
+/** A store transaction, from any purchase SDK. Forwarded whole under `experimental.transaction`. */
+export type PurchaseTransaction = object;
+export type TrackPurchaseParams = {
+    isTrial: boolean;
+    /** The price charged: 0 for a free trial. */
+    value: number;
+    /** ISO 4217 code. */
+    currency: string;
+    /** Links renewals to the first purchase, and keys the event's deduplication id. */
+    originalTransactionIdentifier: string;
+    /** The store product id. Defaults to `product.productIdentifier`. */
+    productId?: string;
+    product?: PurchaseProduct;
+    transaction?: PurchaseTransaction;
+    /** A web-checkout redemption result, for a purchase made outside the store. Forwarded under `experimental.redemption_result`. */
+    redemptionResult?: unknown;
+};
+/** Answers given on one onboarding step, by question or element id. */
+export type OnboardingStepAnswers = Record<string, unknown>;
+/** Free-form context about which onboarding was shown, e.g. `onboarding_id`, `audience_id`, `deployment_id`. */
+export type OnboardingMetadata = Record<string, unknown>;
+export type OnboardingStepResponse = {
+    step_id: string;
+    entered_at: string;
+    /** Null while the user is still on the step. */
+    exited_at: string | null;
+    answers: OnboardingStepAnswers;
+};
+/** The body of `/onboarding-response`: every step seen so far, resent whole on each call. */
+export type OnboardingResponsePayload = {
+    onboarding_metadata?: OnboardingMetadata;
+    /** When the snapshot was produced. The API ignores a snapshot older than the one it has. */
+    sent_at: string;
+    responses: OnboardingStepResponse[];
+};
+/** Device facts sent with every tracked event. */
+export type DeviceContext = {
+    ip: string | null;
+    user_agent: string;
+    device_model: string | null;
+    device_brand: string | null;
+    device_manufacturer: string | null;
+    os_name: string | null;
+    os_version: string | null;
+    screen_width: number;
+    screen_height: number;
+    screen_scale: number;
+    timezone: string;
+    locale: string;
+    app_version: string | null;
+    app_build: string | null;
+};
+/**
+ * Optional client-side signals for the demand score. Anything omitted falls
+ * back server-side or drops out of the score, so send only what the app has;
+ * never invent a value.
+ */
+export type DemandScoreSignals = {
+    /** Native model identifier, e.g. `iPhone15,3`. */
+    device_model?: string;
+    /** Hardware release year. */
+    device_release_year?: number;
+    /** OS version, e.g. `17.4`. Only the major number is read. */
+    os_version?: string;
+    connection_type?: "wifi" | "cellular" | "other";
+    /** Two-letter storefront country, e.g. `US`. */
+    store_country?: string;
+    app_open_count?: number;
+    /** Send 0 only for a real zero: the server reads its own 0 as "not tracked". */
+    paywall_view_count?: number;
+    /** BCP 47 locale, e.g. `en-US`. */
+    locale?: string;
+};
+export type DemandScoreSignalScore = {
+    signal: string;
+    /** Normalized 0 to 1 sub-score; null when the signal was unavailable. */
+    value: number | null;
+    weight: number;
+    /** Contribution to the final score after weight renormalization. */
+    weighted: number;
+};
+/** Scoring models the endpoint computes. */
+export type DemandScoreVersion = "v1" | "v2";
+/** v1: a weighted-signal model over behavioural history and device context. */
+export type DemandScoreV1 = {
+    /** Integer 1 to 100. */
+    score: number;
+    /** True when the identity has no event history yet. */
+    coldStart: boolean;
+    signals: DemandScoreSignalScore[];
+};
+export type DemandScoreV2Signal = {
+    signal: string;
+    /** The level looked up, after normalization. */
+    level: string;
+    /** Smoothed conversion rate for that level. */
+    rate: number;
+    /** Contribution to the total, in log-odds. */
+    logOdds: number;
+    /** False when the level was absent from the rates table and the fallback was used. */
+    matched: boolean;
+};
+/** v2: a learned-rates scorecard, calibrated to a percentile. */
+export type DemandScoreV2 = {
+    /** Integer 1 to 100. */
+    score: number;
+    /** Raw additive score before calibration. */
+    logOdds: number;
+    /** How many scorecard fields resolved to a known level. */
+    matchedSignals: number;
+    /** `app` when scored with this app's own rates, `portfolio` when it fell back to the pooled table. */
+    ratesSource: "app" | "portfolio";
+    signals: DemandScoreV2Signal[];
+};
+/**
+ * The demand score response. `selectedVersion` and `versions` are optional,
+ * and `signals` is kept, so a response from before the score was versioned
+ * still fits.
+ */
+export type DemandScoreResult = {
+    /** Integer 1 to 100: the likelihood this install converts to a paying customer. Mirrors `versions[selectedVersion].score`. */
+    demandScore: number;
+    /** Which version `demandScore` mirrors: a server-side setting. */
+    selectedVersion?: DemandScoreVersion;
+    /** True when the identity has no event history yet. */
+    coldStart: boolean;
+    versions?: {
+        v1: DemandScoreV1;
+        /** Absent when no rates table exists for the app or the portfolio. */
+        v2?: DemandScoreV2;
+    };
+    /** The unversioned response's breakdown. */
+    signals?: DemandScoreSignalScore[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

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

package/dist/client/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Wire types of the Rocalytics API, as the client sends and reads them.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":";AAAA,wEAAwE"}

package/dist/core/context.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Device and app facts for a run, supplied by the host (the core reads no
+ * platform API). Captured once when a run starts.
+ */
+export interface RunContextInput {
+    /** Marketing version, e.g. `2.4.0`. */
+    appVersion: string;
+    /** Build number, or null on a platform with none. */
+    build: string | null;
+    platform: "ios" | "android" | "web";
+    /** OS version, or null when the platform cannot report one. */
+    osVersion: string | null;
+    /** BCP 47 tag of the language the flow is shown in, e.g. `fr-FR`. */
+    locale: string;
+    /** IANA time zone, e.g. `Europe/Paris`. */
+    timezone: string;
+}
+/** The context in its wire form. Country is deliberately absent: the server derives it. */
+export interface WireRunContext {
+    app_version: string;
+    build: string | null;
+    platform: "ios" | "android" | "web";
+    os_version: string | null;
+    locale: string;
+    timezone: string;
+    library_version?: string;
+}
+/**
+ * Maps the host's context to its wire form, copying only the known fields.
+ * Returns the list of problems instead when a field would fail the schema.
+ */
+export declare function captureRunContext(input: RunContextInput, libraryVersion: string): {
+    ok: true;
+    context: WireRunContext;
+} | {
+    ok: false;
+    errors: string[];
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;IACpC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BzE"}

package/dist/core/context.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureRunContext = captureRunContext;
+const text_1 = require("./text");
+const LOCALE = /^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8})*$/;
+const TIMEZONE = /^[A-Za-z][A-Za-z0-9_+-]*(\/[A-Za-z0-9_+-]+)*$/;
+const shortText = (v) => typeof v === "string" && (0, text_1.codePointLength)(v) >= 1 && (0, text_1.codePointLength)(v) <= 32;
+/**
+ * Maps the host's context to its wire form, copying only the known fields.
+ * Returns the list of problems instead when a field would fail the schema.
+ */
+function captureRunContext(input, libraryVersion) {
+    const errors = [];
+    if (!input || typeof input !== "object")
+        return { ok: false, errors: ["context is not an object"] };
+    if (!shortText(input.appVersion))
+        errors.push("appVersion must be 1 to 32 characters");
+    if (input.build !== null && !shortText(input.build))
+        errors.push("build must be null or 1 to 32 characters");
+    if (input.platform !== "ios" && input.platform !== "android" && input.platform !== "web") {
+        errors.push("platform must be ios, android or web");
+    }
+    if (input.osVersion !== null && !shortText(input.osVersion))
+        errors.push("osVersion must be null or 1 to 32 characters");
+    if (typeof input.locale !== "string" || !LOCALE.test(input.locale))
+        errors.push("locale must be a BCP 47 tag");
+    if (typeof input.timezone !== "string" || input.timezone.length > 64 || !TIMEZONE.test(input.timezone)) {
+        errors.push("timezone must be an IANA name of at most 64 characters");
+    }
+    if (errors.length)
+        return { ok: false, errors };
+    return {
+        ok: true,
+        context: {
+            app_version: input.appVersion,
+            build: input.build,
+            platform: input.platform,
+            os_version: input.osVersion,
+            locale: input.locale,
+            timezone: input.timezone,
+            library_version: libraryVersion,
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":";;AAuCA,8CA6BC;AApED,iCAAyC;AA+BzC,MAAM,MAAM,GAAG,qCAAqC,CAAC;AACrD,MAAM,QAAQ,GAAG,+CAA+C,CAAC;AACjE,MAAM,SAAS,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAA,sBAAe,EAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAA,sBAAe,EAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAE/G;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,KAAsB,EACtB,cAAsB;IAEtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IACpG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC7G,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QACzF,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IACzH,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC/G,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvG,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE;YACP,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe,EAAE,cAAc;SAChC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/delivery.d.ts

@@ -0,0 +1,63 @@
+import { type Sink, type SinkResult } from "./sink";
+import type { Timers } from "./time";
+/** One send: a full snapshot and the `seq` it carries. A retry reuses both, unchanged. */
+export interface Outbound<T> {
+    seq: number;
+    body: T;
+}
+export interface RetryPolicy {
+    /** Delay before the first retry. Default 1,000 ms. */
+    initialDelayMs?: number;
+    /** Multiplier per further retry. Default 2. */
+    factor?: number;
+    /** Ceiling on the delay. Default 60,000 ms. */
+    maxDelayMs?: number;
+}
+export interface DeliveryOptions<T> {
+    sink: Sink<T>;
+    timers: Timers;
+    retry?: RetryPolicy;
+    /** A send that has not answered after this long counts as transient. Default 30,000 ms. */
+    attemptTimeoutMs?: number;
+    /** Called once a snapshot is settled for good: accepted, ignored or rejected. */
+    onSettled?(item: Outbound<T>, result: SinkResult): void;
+    /** Called whenever the pending snapshot changes, so it can be persisted. */
+    onPendingChange?(pending: Outbound<T> | null): void;
+}
+export interface Delivery<T> {
+    /**
+     * Hands over a snapshot. It replaces any pending one with a lower `seq`: full
+     * snapshots supersede each other, so only the latest needs to arrive.
+     */
+    enqueue(item: Outbound<T>): void;
+    /** Sends the pending snapshot now, without waiting out a backoff. */
+    flush(): void;
+    /** The snapshot not yet settled, if any. */
+    pending(): Outbound<T> | null;
+    /** Stops all timers. The pending snapshot is kept. */
+    stop(): void;
+    /**
+     * Winds down: skips any backoff to give the pending snapshot (and any
+     * handed over later) one last attempt each, and never schedules a retry.
+     * A snapshot that still fails stays pending, so it is not lost.
+     */
+    close(): void;
+    /**
+     * Resolves once no attempt is in flight. After `close()` nothing is retried,
+     * so this is when the last attempts are over, and `pending()` is what the
+     * sink did not take.
+     */
+    idle(): Promise<void>;
+}
+/**
+ * Delivers the latest snapshot of one run through a sink, one send at a time.
+ *
+ * - Only `accepted`, `ignored` and `rejected` settle a snapshot. Everything
+ *   else (a throw, a timeout, a result without an outcome) is transient and
+ *   the same snapshot is sent again after an exponential backoff.
+ * - A settled `seq` is never sent again, so a rejected snapshot is never
+ *   resent unchanged.
+ * - Nothing here throws into the caller.
+ */
+export declare function createDelivery<T>(options: DeliveryOptions<T>): Delivery<T>;
+//# sourceMappingURL=delivery.d.ts.map

package/dist/core/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/core/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,0FAA0F;AAC1F,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,SAAS,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACxD,4EAA4E;IAC5E,eAAe,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACjC,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;IACd,4CAA4C;IAC5C,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,sDAAsD;IACtD,IAAI,IAAI,IAAI,CAAC;IACb;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAkH1E"}

package/dist/core/delivery.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDelivery = createDelivery;
+const sink_1 = require("./sink");
+/**
+ * Delivers the latest snapshot of one run through a sink, one send at a time.
+ *
+ * - Only `accepted`, `ignored` and `rejected` settle a snapshot. Everything
+ *   else (a throw, a timeout, a result without an outcome) is transient and
+ *   the same snapshot is sent again after an exponential backoff.
+ * - A settled `seq` is never sent again, so a rejected snapshot is never
+ *   resent unchanged.
+ * - Nothing here throws into the caller.
+ */
+function createDelivery(options) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const { sink, timers } = options;
+    const initial = (_b = (_a = options.retry) === null || _a === void 0 ? void 0 : _a.initialDelayMs) !== null && _b !== void 0 ? _b : 1000;
+    const factor = (_d = (_c = options.retry) === null || _c === void 0 ? void 0 : _c.factor) !== null && _d !== void 0 ? _d : 2;
+    const max = (_f = (_e = options.retry) === null || _e === void 0 ? void 0 : _e.maxDelayMs) !== null && _f !== void 0 ? _f : 60000;
+    const timeoutMs = (_g = options.attemptTimeoutMs) !== null && _g !== void 0 ? _g : 30000;
+    let pending = null;
+    let inFlight = null;
+    let settledSeq = 0;
+    let failures = 0;
+    let retryTimer = null;
+    let stopped = false;
+    let closed = false;
+    let idleWaiters = [];
+    const safe = (fn) => {
+        try {
+            fn();
+        }
+        catch {
+            // A host callback that throws must not break delivery.
+        }
+    };
+    const setPending = (next) => {
+        pending = next;
+        safe(() => { var _a; return (_a = options.onPendingChange) === null || _a === void 0 ? void 0 : _a.call(options, next); });
+    };
+    const clearRetry = () => {
+        if (retryTimer !== null)
+            timers.clearTimeout(retryTimer);
+        retryTimer = null;
+    };
+    const callSink = (item) => new Promise((resolve) => {
+        const timer = timers.setTimeout(() => resolve({ outcome: "transient", reason: "timeout" }), timeoutMs);
+        const done = (r) => {
+            timers.clearTimeout(timer);
+            resolve(r);
+        };
+        try {
+            Promise.resolve(sink.send(item.body)).then((value) => done((0, sink_1.normalizeResult)(value)), (error) => done({ outcome: "transient", reason: String(error) }));
+        }
+        catch (error) {
+            done({ outcome: "transient", reason: String(error) });
+        }
+    });
+    const wakeIdle = () => {
+        if (inFlight)
+            return;
+        const waiters = idleWaiters;
+        idleWaiters = [];
+        for (const resolve of waiters)
+            resolve();
+    };
+    const attempt = () => {
+        if (stopped || inFlight || !pending)
+            return;
+        clearRetry();
+        const item = pending;
+        inFlight = item;
+        void callSink(item).then((result) => {
+            inFlight = null;
+            if (result.outcome === "transient") {
+                if (closed) {
+                    // No retry after close; a newer snapshot handed over meanwhile still gets its one attempt.
+                    if (pending && pending.seq > item.seq)
+                        attempt();
+                    return wakeIdle();
+                }
+                failures += 1;
+                const delay = Math.min(max, initial * Math.pow(factor, failures - 1));
+                if (!stopped)
+                    retryTimer = timers.setTimeout(() => {
+                        retryTimer = null;
+                        attempt();
+                    }, delay);
+                return wakeIdle();
+            }
+            failures = 0;
+            settledSeq = Math.max(settledSeq, item.seq);
+            if (pending && pending.seq <= item.seq)
+                setPending(null);
+            safe(() => { var _a; return (_a = options.onSettled) === null || _a === void 0 ? void 0 : _a.call(options, item, result); });
+            attempt(); // a newer snapshot may have arrived meanwhile
+            wakeIdle();
+        });
+    };
+    return {
+        enqueue(item) {
+            if (item.seq <= settledSeq)
+                return;
+            if (pending && item.seq <= pending.seq)
+                return;
+            setPending(item);
+            if (retryTimer === null)
+                attempt();
+        },
+        flush() {
+            clearRetry();
+            attempt();
+        },
+        pending: () => pending,
+        stop() {
+            stopped = true;
+            clearRetry();
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            clearRetry();
+            attempt();
+        },
+        idle: () => new Promise((resolve) => {
+            idleWaiters.push(resolve);
+            wakeIdle();
+        }),
+    };
+}
+//# sourceMappingURL=delivery.js.map

package/dist/core/delivery.js.map

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

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Something the SDK chose not to do, or could not do, reported instead of
+ * thrown: tracking must never break the app it runs in.
+ */
+export interface Diagnostic {
+    /** Stable machine-readable code, e.g. `unknown-step`, `rejected`, `truncated`. */
+    code: string;
+    message: string;
+    runId?: string;
+}
+export type DiagnosticHandler = (diagnostic: Diagnostic) => void;
+/** The default handler: a console warning, when a console exists. */
+export declare const consoleDiagnostics: DiagnosticHandler;
+/** Wraps a host handler so that a handler which throws cannot break the caller. */
+export declare function safeDiagnostics(handler: DiagnosticHandler | undefined): DiagnosticHandler;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,iBAGhC,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,CASzF"}

package/dist/core/diagnostics.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleDiagnostics = void 0;
+exports.safeDiagnostics = safeDiagnostics;
+/** The default handler: a console warning, when a console exists. */
+const consoleDiagnostics = (d) => {
+    var _a;
+    const c = globalThis.console;
+    (_a = c === null || c === void 0 ? void 0 : c.warn) === null || _a === void 0 ? void 0 : _a.call(c, `[rocalytics-sdk] ${d.code}: ${d.message}`);
+};
+exports.consoleDiagnostics = consoleDiagnostics;
+/** Wraps a host handler so that a handler which throws cannot break the caller. */
+function safeDiagnostics(handler) {
+    const h = handler !== null && handler !== void 0 ? handler : exports.consoleDiagnostics;
+    return (d) => {
+        try {
+            h(d);
+        }
+        catch {
+            // ignored on purpose
+        }
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/core/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":";;;AAoBA,0CASC;AAhBD,qEAAqE;AAC9D,MAAM,kBAAkB,GAAsB,CAAC,CAAC,EAAE,EAAE;;IACzD,MAAM,CAAC,GAAI,UAAiE,CAAC,OAAO,CAAC;IACrF,MAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,kDAAG,oBAAoB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC;AAHW,QAAA,kBAAkB,sBAG7B;AAEF,mFAAmF;AACnF,SAAgB,eAAe,CAAC,OAAsC;IACpE,MAAM,CAAC,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,0BAAkB,CAAC;IACxC,OAAO,CAAC,CAAC,EAAE,EAAE;QACX,IAAI,CAAC;YACH,CAAC,CAAC,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/httpSink.d.ts

@@ -0,0 +1,35 @@
+import { type Sink } from "./sink";
+type Headers = Record<string, string>;
+export interface HttpSinkOptions {
+    /** The collector endpoint. Each payload is POSTed to it as JSON. */
+    url: string;
+    /** Extra request headers, such as an authorization token. A function is called for every send. */
+    headers?: Headers | (() => Headers | Promise<Headers>);
+    /** Defaults to the global `fetch`. */
+    fetch?: (url: string, init: {
+        method: string;
+        headers: Headers;
+        body: string;
+        signal?: unknown;
+    }) => Promise<{
+        text(): Promise<string>;
+    }>;
+    /** Gives up on a request after this long; the send is then transient. Default 15,000 ms. */
+    timeoutMs?: number;
+}
+/**
+ * A sink that POSTs each payload to an HTTP collector.
+ *
+ * The outcome comes from the response BODY only: `{"outcome": "accepted" |
+ * "ignored" | "rejected"}`. The status code is not read, because a proxy or
+ * gateway can answer 401, 404 or 413 without having looked at the payload, so
+ * any response without an outcome, and no response at all, is transient.
+ * It never throws.
+ *
+ * Its `destination` is `url`, marked ` (custom fetch)` when a `fetch` is
+ * passed: that one may never reach `url` (a test double), so it never counts
+ * as the same destination as the real one. Headers are not part of it.
+ */
+export declare function createHttpSink(options: HttpSinkOptions): Sink<unknown>;
+export {};
+//# sourceMappingURL=httpSink.d.ts.map

package/dist/core/httpSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSink.d.ts","sourceRoot":"","sources":["../../src/core/httpSink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,IAAI,EAAmB,MAAM,QAAQ,CAAC;AAErE,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,sCAAsC;IACtC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;QAC3G,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;KACzB,CAAC,CAAC;IACH,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,CAuCtE"}