@rocapine/rocalytics-sdk 0.0.0-stage → 0.2.0

package/dist/client/native.d.ts

@@ -0,0 +1,68 @@
+/** The members of `expo-application` the client reads. The module itself fits as is. */
+export interface ApplicationModule {
+    readonly applicationId: string | null;
+    readonly applicationName: string | null;
+    readonly nativeApplicationVersion: string | null;
+    readonly nativeBuildVersion: string | null;
+    getIosIdForVendorAsync(): Promise<string | null>;
+    getAndroidId(): string;
+    getInstallationTimeAsync(): Promise<Date>;
+}
+/** The native capabilities the client uses, shaped like the Expo modules and react-native, which fit as they are. */
+export interface RocalyticsModules {
+    application: ApplicationModule;
+    crypto: {
+        randomUUID(): string;
+    };
+    device: {
+        readonly brand: string | null;
+        readonly modelName: string | null;
+        readonly manufacturer: string | null;
+        readonly osName: string | null;
+        readonly osVersion: string | null;
+    };
+    network: {
+        getIpAddressAsync(): Promise<string>;
+    };
+    secureStore: {
+        getItemAsync(key: string): Promise<string | null>;
+        setItemAsync(key: string, value: string): Promise<void>;
+    };
+    /** react-native's `Platform`. */
+    platform: {
+        readonly OS: string;
+        readonly Version: string | number;
+    };
+    /** react-native's `Dimensions`. */
+    dimensions: {
+        get(dim: "screen"): {
+            width: number;
+            height: number;
+            scale: number;
+        };
+    };
+}
+/** How each package is loaded. Injected by tests; the defaults are the literal requires. */
+export interface ExpoModuleLoaders {
+    core: () => unknown;
+    application: () => unknown;
+    crypto: () => unknown;
+    device: () => unknown;
+    network: () => unknown;
+    secureStore: () => unknown;
+    reactNative: () => unknown;
+}
+export type LoadResult = {
+    ok: true;
+    modules: RocalyticsModules;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Loads the Expo modules and react-native, or explains why it could not.
+ * Never throws: a missing package, a native module absent from the binary, or
+ * a wrapper that throws while loading all come back as `{ ok: false, reason }`.
+ */
+export declare function loadExpoModules(loaders?: ExpoModuleLoaders): LoadResult;
+//# sourceMappingURL=native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/client/native.ts"],"names":[],"mappings":"AAuBA,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,YAAY,IAAI,MAAM,CAAC;IACvB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,qHAAqH;AACrH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,MAAM,EAAE;QAAE,UAAU,IAAI,MAAM,CAAA;KAAE,CAAC;IACjC,MAAM,EAAE;QACN,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,OAAO,EAAE;QAAE,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IAClD,WAAW,EAAE;QACX,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAClD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzD,CAAC;IACF,iCAAiC;IACjC,QAAQ,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACrE,mCAAmC;IACnC,UAAU,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACtF;AAED,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAelG;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,iBAAmC,GAAG,UAAU,CAqBxF"}

package/dist/client/native.js

@@ -0,0 +1,64 @@
+"use strict";
+// The one file in the package that loads another package.
+//
+// The Rocalytics client needs five Expo native modules and react-native. They
+// are optional peer dependencies: an app that only uses /onboarding installs
+// none of them, and nothing outside this file references them.
+//
+// They are loaded lazily, at client start, never at import time. An Expo
+// module's JS wrapper calls `requireNativeModule("ExpoXxx")` when it is first
+// evaluated, which throws when the app binary predates the module (a JS update
+// shipped over the air onto an older build). So each native module is first
+// probed through `requireOptionalNativeModule` (expo-modules-core), which
+// returns null instead of throwing, and no wrapper is required unless every
+// probe succeeds. The probe must not be `TurboModuleRegistry.get`: on the New
+// Architecture, Expo modules are registered with the Expo modules registry,
+// not the TurboModule registry, so that probe reports a linked module as
+// missing.
+//
+// Every require is a string literal, so a bundler can see it. Metro resolves
+// them at bundle time: an app that imports /client without installing a
+// peer fails to bundle, rather than going inert at run time.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadExpoModules = loadExpoModules;
+/** The native module names the wrappers pass to `requireNativeModule`. */
+const NATIVE_MODULES = ["ExpoApplication", "ExpoCrypto", "ExpoDevice", "ExpoNetwork", "ExpoSecureStore"];
+const DEFAULT_LOADERS = {
+    core: () => require("expo-modules-core"),
+    application: () => require("expo-application"),
+    crypto: () => require("expo-crypto"),
+    device: () => require("expo-device"),
+    network: () => require("expo-network"),
+    secureStore: () => require("expo-secure-store"),
+    reactNative: () => require("react-native"),
+};
+/**
+ * Loads the Expo modules and react-native, or explains why it could not.
+ * Never throws: a missing package, a native module absent from the binary, or
+ * a wrapper that throws while loading all come back as `{ ok: false, reason }`.
+ */
+function loadExpoModules(loaders = DEFAULT_LOADERS) {
+    try {
+        const core = loaders.core();
+        const missing = NATIVE_MODULES.find((name) => core.requireOptionalNativeModule(name) == null);
+        if (missing)
+            return { ok: false, reason: `native module ${missing} is not in this binary` };
+        const reactNative = loaders.reactNative();
+        return {
+            ok: true,
+            modules: {
+                application: loaders.application(),
+                crypto: loaders.crypto(),
+                device: loaders.device(),
+                network: loaders.network(),
+                secureStore: loaders.secureStore(),
+                platform: reactNative.Platform,
+                dimensions: reactNative.Dimensions,
+            },
+        };
+    }
+    catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=native.js.map

package/dist/client/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/client/native.ts"],"names":[],"mappings":";AAAA,0DAA0D;AAC1D,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,yEAAyE;AACzE,WAAW;AACX,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,6DAA6D;;AAoE7D,0CAqBC;AAvCD,0EAA0E;AAC1E,MAAM,cAAc,GAAG,CAAC,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAEzG,MAAM,eAAe,GAAsB;IACzC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACxC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;IACpC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;IACpC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;IACtC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IAC/C,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;CAC3C,CAAC;AAEF;;;;GAIG;AACH,SAAgB,eAAe,CAAC,UAA6B,eAAe;IAC1E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAA4D,CAAC;QACtF,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAC9F,IAAI,OAAO;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,OAAO,wBAAwB,EAAE,CAAC;QAC5F,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAA8F,CAAC;QACtI,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE;gBACP,WAAW,EAAE,OAAO,CAAC,WAAW,EAAsC;gBACtE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAiC;gBACvD,MAAM,EAAE,OAAO,CAAC,MAAM,EAAiC;gBACvD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAkC;gBAC1D,WAAW,EAAE,OAAO,CAAC,WAAW,EAAsC;gBACtE,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,UAAU,EAAE,WAAW,CAAC,UAAU;aACnC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC"}

package/dist/client/onboardingSink.d.ts

@@ -0,0 +1,63 @@
+import type { SinkResult, Sink } from "../core/sink";
+import type { OnboardingRunSnapshot } from "../onboarding/contract";
+import type { RocalyticsClient } from "./client";
+import type { OnboardingResponsePayload } from "./types";
+/**
+ * A v1 onboarding run snapshot in the pre-v1 `/onboarding-response` shape,
+ * which is the only onboarding payload the Rocalytics ingest reads. The keys
+ * follow docs/onboarding-run-contract.md, section 9, which is how the ingest
+ * reads such a payload back into a run.
+ *
+ * - Each entry is a response: `step_key` becomes `step_id`, timestamps are kept.
+ * - Answers become `{ [question_key]: value }`. A numeric answer's `unit` has
+ *   no place in that shape and is dropped.
+ * - `onboarding_metadata` carries the keys section 9 reads: `onboardingId`
+ *   (the Studio onboarding) or, with none, `onboarding_id` (the onboarding
+ *   key, as a hand-coded sender sets it), `audienceId`, `deployment_id`,
+ *   `locale` (from the run's context) and `draft: true` for a draft. It also
+ *   carries `onboarding_key`, `onboarding_version`, `variant_key`, `run_id`
+ *   and `seq`, which section 9 does not read.
+ * - `sent_at` is NOT the device's send time. The ingest keeps one snapshot
+ *   per sender and replaces it only when the incoming `sent_at` is strictly
+ *   later, answering 2xx either way, so two sends in one millisecond, or a
+ *   device clock stepping back, would drop a snapshot (the completion
+ *   included) while it reads as delivered. So `sent_at` is the run's latest
+ *   recorded timestamp plus `seq` milliseconds. A snapshot only ever adds
+ *   timestamps to the one before it and `seq` rises with every send, so this
+ *   strictly increases across a run's sends whatever the device clock does.
+ *   Only within a run: the ingest keeps one row per sender, so after the
+ *   clock steps back between runs, a later run's snapshots can still be
+ *   dropped while answered 2xx, as pre-v1 reporting already could.
+ *   It depends on the snapshot alone, so a retry, even after a relaunch,
+ *   resends the identical body.
+ */
+export declare function toOnboardingResponsePayload(snapshot: OnboardingRunSnapshot): OnboardingResponsePayload;
+/**
+ * Reads an `/onboarding-response` answer as a sink outcome. The endpoint
+ * answers success with a 2xx and no body, so a 2xx is accepted. Otherwise,
+ * as the contract's section 5 requires, only a body that says
+ * `{"outcome": "rejected"}` is permanent: every other status, whatever its
+ * body, is transient and the snapshot is retried.
+ */
+export declare function rocalyticsOutcome(status: number, body?: unknown): SinkResult;
+/**
+ * A sink for the onboarding run tracker (`@rocapine/rocalytics-sdk/onboarding`)
+ * that delivers each snapshot to Rocalytics through `client`, as the pre-v1
+ * onboarding payload (see `toOnboardingResponsePayload`).
+ *
+ * Once a completed snapshot is accepted, the sink also sends the
+ * `onboarding_completed` event, which is where consumers of the pre-v1 data
+ * read completion from. It is deduplicated per device, like any `track`
+ * event; if it fails, the send is transient, so the tracker's retry sends it.
+ *
+ * The ingest keeps one onboarding snapshot per roca id, so a new run replaces
+ * the previous one there, and an app should report a flow through this sink
+ * or through `client.trackOnboarding`, not both.
+ *
+ * While the client is inert every send is transient: the tracker keeps the
+ * snapshot, persisted when it has storage, for a launch where the client works.
+ *
+ * Its `destination` is the client's `onboardingRunDestination`.
+ */
+export declare function createRocalyticsOnboardingSink(client: RocalyticsClient): Sink<OnboardingRunSnapshot>;
+//# sourceMappingURL=onboardingSink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingSink.d.ts","sourceRoot":"","sources":["../../src/client/onboardingSink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAU,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAsB,yBAAyB,EAAyB,MAAM,SAAS,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,yBAAyB,CA2BtG;AAsBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAO5E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAEpG"}

package/dist/client/onboardingSink.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOnboardingResponsePayload = toOnboardingResponsePayload;
+exports.rocalyticsOutcome = rocalyticsOutcome;
+exports.createRocalyticsOnboardingSink = createRocalyticsOnboardingSink;
+/**
+ * A v1 onboarding run snapshot in the pre-v1 `/onboarding-response` shape,
+ * which is the only onboarding payload the Rocalytics ingest reads. The keys
+ * follow docs/onboarding-run-contract.md, section 9, which is how the ingest
+ * reads such a payload back into a run.
+ *
+ * - Each entry is a response: `step_key` becomes `step_id`, timestamps are kept.
+ * - Answers become `{ [question_key]: value }`. A numeric answer's `unit` has
+ *   no place in that shape and is dropped.
+ * - `onboarding_metadata` carries the keys section 9 reads: `onboardingId`
+ *   (the Studio onboarding) or, with none, `onboarding_id` (the onboarding
+ *   key, as a hand-coded sender sets it), `audienceId`, `deployment_id`,
+ *   `locale` (from the run's context) and `draft: true` for a draft. It also
+ *   carries `onboarding_key`, `onboarding_version`, `variant_key`, `run_id`
+ *   and `seq`, which section 9 does not read.
+ * - `sent_at` is NOT the device's send time. The ingest keeps one snapshot
+ *   per sender and replaces it only when the incoming `sent_at` is strictly
+ *   later, answering 2xx either way, so two sends in one millisecond, or a
+ *   device clock stepping back, would drop a snapshot (the completion
+ *   included) while it reads as delivered. So `sent_at` is the run's latest
+ *   recorded timestamp plus `seq` milliseconds. A snapshot only ever adds
+ *   timestamps to the one before it and `seq` rises with every send, so this
+ *   strictly increases across a run's sends whatever the device clock does.
+ *   Only within a run: the ingest keeps one row per sender, so after the
+ *   clock steps back between runs, a later run's snapshots can still be
+ *   dropped while answered 2xx, as pre-v1 reporting already could.
+ *   It depends on the snapshot alone, so a retry, even after a relaunch,
+ *   resends the identical body.
+ */
+function toOnboardingResponsePayload(snapshot) {
+    var _a, _b, _c;
+    const metadata = {};
+    const set = (key, value) => {
+        if (value !== undefined && value !== null)
+            metadata[key] = value;
+    };
+    const studioOnboardingId = (_a = snapshot.studio) === null || _a === void 0 ? void 0 : _a.onboarding_id;
+    if (studioOnboardingId != null)
+        set("onboardingId", studioOnboardingId);
+    else
+        set("onboarding_id", snapshot.onboarding.key);
+    set("audienceId", (_b = snapshot.studio) === null || _b === void 0 ? void 0 : _b.audience_id);
+    set("deployment_id", (_c = snapshot.studio) === null || _c === void 0 ? void 0 : _c.deployment_id);
+    set("locale", snapshot.context.locale);
+    if (snapshot.onboarding.version === "draft")
+        set("draft", true);
+    set("onboarding_key", snapshot.onboarding.key);
+    set("onboarding_version", snapshot.onboarding.version);
+    set("variant_key", snapshot.onboarding.variant_key);
+    set("run_id", snapshot.run_id);
+    set("seq", snapshot.seq);
+    return {
+        onboarding_metadata: metadata,
+        sent_at: new Date(latestRecorded(snapshot) + snapshot.seq).toISOString(),
+        responses: snapshot.steps.map((entry) => ({
+            step_id: entry.step_key,
+            entered_at: entry.entered_at,
+            exited_at: entry.exited_at,
+            answers: toAnswers(entry.answers),
+        })),
+    };
+}
+/** The latest timestamp the run has recorded: its start, entries, exits and completion. Not `sent_at`. */
+function latestRecorded(snapshot) {
+    let latest = Date.parse(snapshot.started_at);
+    const consider = (ts) => {
+        if (ts !== null)
+            latest = Math.max(latest, Date.parse(ts));
+    };
+    for (const entry of snapshot.steps) {
+        consider(entry.entered_at);
+        consider(entry.exited_at);
+    }
+    consider(snapshot.completed_at);
+    return latest;
+}
+function toAnswers(answers) {
+    const out = {};
+    for (const answer of answers)
+        out[answer.question_key] = Array.isArray(answer.value) ? [...answer.value] : answer.value;
+    return out;
+}
+/**
+ * Reads an `/onboarding-response` answer as a sink outcome. The endpoint
+ * answers success with a 2xx and no body, so a 2xx is accepted. Otherwise,
+ * as the contract's section 5 requires, only a body that says
+ * `{"outcome": "rejected"}` is permanent: every other status, whatever its
+ * body, is transient and the snapshot is retried.
+ */
+function rocalyticsOutcome(status, body) {
+    if (status >= 200 && status < 300)
+        return { outcome: "accepted" };
+    if (body && typeof body === "object" && body.outcome === "rejected") {
+        const reason = body.reason;
+        return typeof reason === "string" ? { outcome: "rejected", reason } : { outcome: "rejected" };
+    }
+    return { outcome: "transient", reason: `status ${status}` };
+}
+/**
+ * A sink for the onboarding run tracker (`@rocapine/rocalytics-sdk/onboarding`)
+ * that delivers each snapshot to Rocalytics through `client`, as the pre-v1
+ * onboarding payload (see `toOnboardingResponsePayload`).
+ *
+ * Once a completed snapshot is accepted, the sink also sends the
+ * `onboarding_completed` event, which is where consumers of the pre-v1 data
+ * read completion from. It is deduplicated per device, like any `track`
+ * event; if it fails, the send is transient, so the tracker's retry sends it.
+ *
+ * The ingest keeps one onboarding snapshot per roca id, so a new run replaces
+ * the previous one there, and an app should report a flow through this sink
+ * or through `client.trackOnboarding`, not both.
+ *
+ * While the client is inert every send is transient: the tracker keeps the
+ * snapshot, persisted when it has storage, for a launch where the client works.
+ *
+ * Its `destination` is the client's `onboardingRunDestination`.
+ */
+function createRocalyticsOnboardingSink(client) {
+    return { destination: client.onboardingRunDestination, send: (snapshot) => client.sendOnboardingRun(snapshot) };
+}
+//# sourceMappingURL=onboardingSink.js.map

package/dist/client/onboardingSink.js.map

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

package/dist/client/paywallSink.d.ts

@@ -0,0 +1,13 @@
+import type { Sink, SinkResult } from "../core/sink";
+import type { PaywallPresentationSnapshot } from "../paywall/contract";
+import type { RocalyticsClient } from "./client";
+/**
+ * Reads a `/paywall-presentations` answer per the paywall contract's section 5
+ * (onboarding D27): the body's `outcome` decides. A rejected body is permanent
+ * whatever the status. Accepted or ignored counts only on a 2xx. Anything
+ * else, including a 2xx without an outcome, is transient and retried.
+ */
+export declare function paywallIngestOutcome(status: number, body?: unknown): SinkResult;
+/** Delivers the paywall tracker's snapshots to Rocalytics. Its `destination` is the client's `paywallPresentationDestination`. */
+export declare function createRocalyticsPaywallSink(client: RocalyticsClient): Sink<PaywallPresentationSnapshot>;
+//# sourceMappingURL=paywallSink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paywallSink.d.ts","sourceRoot":"","sources":["../../src/client/paywallSink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAO/E;AAED,kIAAkI;AAClI,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,2BAA2B,CAAC,CAEvG"}

package/dist/client/paywallSink.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paywallIngestOutcome = paywallIngestOutcome;
+exports.createRocalyticsPaywallSink = createRocalyticsPaywallSink;
+const OUTCOMES = new Set(["accepted", "ignored", "rejected"]);
+/**
+ * Reads a `/paywall-presentations` answer per the paywall contract's section 5
+ * (onboarding D27): the body's `outcome` decides. A rejected body is permanent
+ * whatever the status. Accepted or ignored counts only on a 2xx. Anything
+ * else, including a 2xx without an outcome, is transient and retried.
+ */
+function paywallIngestOutcome(status, body) {
+    const o = body && typeof body === "object" ? body : undefined;
+    const outcome = typeof (o === null || o === void 0 ? void 0 : o.outcome) === "string" && OUTCOMES.has(o.outcome) ? o.outcome : undefined;
+    const reason = typeof (o === null || o === void 0 ? void 0 : o.reason) === "string" ? o.reason : undefined;
+    if (outcome === "rejected")
+        return reason ? { outcome, reason } : { outcome };
+    if (outcome && status >= 200 && status < 300)
+        return { outcome };
+    return { outcome: "transient", reason: `status ${status}` };
+}
+/** Delivers the paywall tracker's snapshots to Rocalytics. Its `destination` is the client's `paywallPresentationDestination`. */
+function createRocalyticsPaywallSink(client) {
+    return { destination: client.paywallPresentationDestination, send: (s) => client.sendPaywallPresentation(s) };
+}
+//# sourceMappingURL=paywallSink.js.map

package/dist/client/paywallSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paywallSink.js","sourceRoot":"","sources":["../../src/client/paywallSink.ts"],"names":[],"mappings":";;AAYA,oDAOC;AAGD,kEAEC;AApBD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,MAAc,EAAE,IAAc;IACjE,MAAM,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgD,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,OAAO,GAAG,OAAO,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,CAAA,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,OAA+C,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3I,MAAM,MAAM,GAAG,OAAO,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,MAAM,CAAA,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9E,IAAI,OAAO,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,kIAAkI;AAClI,SAAgB,2BAA2B,CAAC,MAAwB;IAClE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,8BAA8B,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;AAChH,CAAC"}

package/dist/client/requests.d.ts

@@ -0,0 +1,66 @@
+import type { DemandScoreSignals, IdentifyParams, OnboardingResponsePayload } from "./types";
+import type { PaywallPresentationSnapshot } from "../paywall/contract";
+export declare const ROCALYTICS_API_BASE = "https://rocalytics-api.rocapine.io";
+/** What every request carries: the device's roca id, the app id and the platform. There is no auth token. */
+export interface RequestContext {
+    rocaId: string;
+    /** The app's bundle id or package name; sent as `unknown` when null. */
+    applicationId: string | null;
+    /** `Platform.OS`. */
+    platform: string;
+    /** Defaults to `ROCALYTICS_API_BASE`. */
+    baseUrl?: string;
+}
+/** A request, ready to hand to `fetch(url, init)`. */
+export interface RocalyticsRequest {
+    url: string;
+    init: {
+        method: "POST";
+        headers: Record<string, string>;
+        body?: string;
+    };
+}
+export interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}
+/** The subset of `fetch` the client uses. */
+export type FetchLike = (url: string, init: RocalyticsRequest["init"]) => Promise<FetchResponseLike>;
+export declare function rocalyticsHeaders(context: RequestContext): Record<string, string>;
+/** `/identify`. The payload is sent as given: drop null identifiers first (the client does). */
+export declare function buildIdentifyRequest(context: RequestContext, payload: Partial<IdentifyParams>): RocalyticsRequest;
+export interface TrackRequestInput {
+    name: string;
+    properties: Record<string, unknown>;
+    deviceContext: Record<string, unknown> | null;
+    /** Defaults to `${rocaId}-${name}`. */
+    deduplicationId?: string;
+    /** A custom event is not stored as an analytics event: the API passes it on to drive automations. */
+    customEvent?: boolean;
+}
+/** `/track`. */
+export declare function buildTrackRequest(context: RequestContext, input: TrackRequestInput): RocalyticsRequest;
+/** `/onboarding-response`. */
+export declare function buildOnboardingResponseRequest(context: RequestContext, payload: OnboardingResponsePayload): RocalyticsRequest;
+/** `/demand-score`. The body is optional server-side, so none is sent without signals. */
+export declare function buildDemandScoreRequest(context: RequestContext, signals?: DemandScoreSignals): RocalyticsRequest;
+/**
+ * Sends a request and resolves its response, or rejects with
+ * `[ROCALYTICS] <endpoint> failed: <status>` (plus ` (<detail>)` when given)
+ * when the status is not 2xx.
+ */
+export declare function sendRocalyticsRequest(fetch: FetchLike, request: RocalyticsRequest, endpoint: string, detail?: string): Promise<FetchResponseLike>;
+/**
+ * The cross-network event id for an event, or `undefined` when its properties
+ * carry no transaction identifier: `${name}-${originalTransactionIdentifier}`.
+ *
+ * Use it as the `event_id` (Meta CAPI or Pixel, TikTok Events API) or
+ * `callback_id` (Adjust S2S) when the app also fires the conversion to those
+ * networks itself. Rocalytics derives the same id when it forwards the event,
+ * so the network deduplicates the two.
+ */
+export declare function getEventId(name: string, properties?: Record<string, unknown> | null): string | undefined;
+/** `/paywall-presentations` (I3): the body is the bare snapshot; identity is in the headers `post` sets. */
+export declare function buildPaywallPresentationRequest(context: RequestContext, snapshot: PaywallPresentationSnapshot): RocalyticsRequest;
+//# sourceMappingURL=requests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../src/client/requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEvE,eAAO,MAAM,mBAAmB,uCAAuC,CAAC;AAExE,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAErG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjF;AAWD,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAEjH;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qGAAqG;IACrG,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAQtG;AAED,8BAA8B;AAC9B,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,yBAAyB,GAAG,iBAAiB,CAE7H;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAEhH;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAM5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAQxG;AAED,4GAA4G;AAC5G,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,2BAA2B,GAAG,iBAAiB,CAEjI"}

package/dist/client/requests.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROCALYTICS_API_BASE = void 0;
+exports.rocalyticsHeaders = rocalyticsHeaders;
+exports.buildIdentifyRequest = buildIdentifyRequest;
+exports.buildTrackRequest = buildTrackRequest;
+exports.buildOnboardingResponseRequest = buildOnboardingResponseRequest;
+exports.buildDemandScoreRequest = buildDemandScoreRequest;
+exports.sendRocalyticsRequest = sendRocalyticsRequest;
+exports.getEventId = getEventId;
+exports.buildPaywallPresentationRequest = buildPaywallPresentationRequest;
+exports.ROCALYTICS_API_BASE = "https://rocalytics-api.rocapine.io";
+function rocalyticsHeaders(context) {
+    var _a;
+    return {
+        "Content-Type": "application/json",
+        "X-Roca-ID": context.rocaId,
+        "X-Application-ID": (_a = context.applicationId) !== null && _a !== void 0 ? _a : "unknown",
+        "X-Platform": context.platform,
+    };
+}
+const post = (context, endpoint, body) => {
+    var _a;
+    return ({
+        url: `${(_a = context.baseUrl) !== null && _a !== void 0 ? _a : exports.ROCALYTICS_API_BASE}/functions/v1/${endpoint}`,
+        init: {
+            method: "POST",
+            headers: rocalyticsHeaders(context),
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        },
+    });
+};
+/** `/identify`. The payload is sent as given: drop null identifiers first (the client does). */
+function buildIdentifyRequest(context, payload) {
+    return post(context, "identify", payload);
+}
+/** `/track`. */
+function buildTrackRequest(context, input) {
+    var _a;
+    return post(context, "track", {
+        name: input.name,
+        deduplication_id: (_a = input.deduplicationId) !== null && _a !== void 0 ? _a : `${context.rocaId}-${input.name}`,
+        properties: input.properties,
+        device_context: input.deviceContext,
+        ...(input.customEvent ? { custom_event: true } : {}),
+    });
+}
+/** `/onboarding-response`. */
+function buildOnboardingResponseRequest(context, payload) {
+    return post(context, "onboarding-response", payload);
+}
+/** `/demand-score`. The body is optional server-side, so none is sent without signals. */
+function buildDemandScoreRequest(context, signals) {
+    return post(context, "demand-score", signals && Object.keys(signals).length > 0 ? signals : undefined);
+}
+/**
+ * Sends a request and resolves its response, or rejects with
+ * `[ROCALYTICS] <endpoint> failed: <status>` (plus ` (<detail>)` when given)
+ * when the status is not 2xx.
+ */
+async function sendRocalyticsRequest(fetch, request, endpoint, detail) {
+    const response = await fetch(request.url, request.init);
+    if (!response.ok) {
+        throw new Error(`[ROCALYTICS] ${endpoint} failed: ${response.status}${detail ? ` (${detail})` : ""}`);
+    }
+    return response;
+}
+/**
+ * The cross-network event id for an event, or `undefined` when its properties
+ * carry no transaction identifier: `${name}-${originalTransactionIdentifier}`.
+ *
+ * Use it as the `event_id` (Meta CAPI or Pixel, TikTok Events API) or
+ * `callback_id` (Adjust S2S) when the app also fires the conversion to those
+ * networks itself. Rocalytics derives the same id when it forwards the event,
+ * so the network deduplicates the two.
+ */
+function getEventId(name, properties) {
+    var _a, _b, _c;
+    if (!properties)
+        return undefined;
+    const txId = (_b = (_a = properties.original_transaction_identifier) !== null && _a !== void 0 ? _a : properties.originalTransactionIdentifier) !== null && _b !== void 0 ? _b : (_c = properties.transaction) === null || _c === void 0 ? void 0 : _c.originalTransactionIdentifier;
+    if (!txId)
+        return undefined;
+    return `${name}-${txId}`;
+}
+/** `/paywall-presentations` (I3): the body is the bare snapshot; identity is in the headers `post` sets. */
+function buildPaywallPresentationRequest(context, snapshot) {
+    return post(context, "paywall-presentations", snapshot);
+}
+//# sourceMappingURL=requests.js.map

package/dist/client/requests.js.map

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