@apex-inc/capacitor-plugin 2.4.1 → 2.5.1

package/dist/deferred-link.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Deferred deep-link resolution.
+ *
+ * The problem this solves: a user taps a link in Safari or Chrome, does
+ * not have your app, installs it from the store, and opens it. The tap
+ * and the launch share no cookie and no storage, so by default your app
+ * has no idea the user was headed for a specific screen and drops them
+ * on your home screen. The tap that cost you money lands nowhere.
+ *
+ * Apex matches the launch back to the tap server-side and hands you the
+ * destination. Call it once, early, and route on the result:
+ *
+ * ```ts
+ * const link = await Apex.getDeferredDeepLink();
+ * if (link) router.navigateByUrl(link.deepLinkHint ?? new URL(link.url).pathname);
+ * ```
+ *
+ * Two properties worth knowing before you build on it:
+ *
+ *   - **One-shot.** The match key is coarse (network + OS), so a link can
+ *     only be claimed once. Call this on first launch and persist what
+ *     you get; a second call returns null.
+ *   - **Best-effort.** Matching is probabilistic and returns null more
+ *     often than it returns a link — no network address, a VPN between
+ *     tap and install, or a slow install all produce a miss. Treat a
+ *     link as a bonus that improves the first run, never as a
+ *     precondition for it.
+ *
+ * Implemented in TypeScript rather than in the native bridges because it
+ * is one HTTPS call with no platform APIs involved, and the webview can
+ * make it identically on iOS, Android, and in browser preview.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchDeferredDeepLink = fetchDeferredDeepLink;
+const DEFAULT_TIMEOUT_MS = 5000;
+async function fetchDeferredDeepLink(options) {
+    const { apiUrl, workspaceKey, platform, apiKey } = options;
+    if (!workspaceKey)
+        return null;
+    // First launch is the most latency-sensitive moment in the app's life.
+    // A slow or unreachable Apex must never hold up the first screen, so
+    // the call is bounded and every failure resolves to null.
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+            "x-apex-workspace": workspaceKey,
+        };
+        if (apiKey)
+            headers["x-apex-api-key"] = apiKey;
+        const response = await fetch(`${apiUrl.replace(/\/+$/, "")}/api/mobile/deferred-link`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ workspaceKey, platform }),
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return null;
+        const payload = (await response.json());
+        return payload.data ?? null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=deferred-link.js.map

package/dist/deferred-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-link.js","sourceRoot":"","sources":["../src/deferred-link.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AA6CH,sDA0CC;AA5CD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEzB,KAAK,UAAU,qBAAqB,CACzC,OAAqC;IAErC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,uEAAuE;IACvE,qEAAqE;IACrE,0DAA0D;IAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,OAAO,CAAC,SAAS,IAAI,kBAAkB,CACxC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,kBAAkB,EAAE,YAAY;SACjC,CAAC;QACF,IAAI,MAAM;YAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,EACxD;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;YAChD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAErC,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/definitions.d.ts

@@ -10,6 +10,10 @@
  * See `plans/mobile-measurement-platform.md` Phase 1b for scope and rationale.
  */
 import type { PluginListenerHandle } from "@capacitor/core";
+import type { DeferredDeepLinkResult } from "./deferred-link";
+import type { SkanSchemaSnapshot } from "./skan-conversion-values";
+export type { DeferredDeepLinkResult } from "./deferred-link";
+export type { SkanConversionSchema, SkanConversionValueEntry, SkanConversionWindow, SkanSchemaSnapshot, SkanWindow, } from "./skan-conversion-values";
 /** iOS App Tracking Transparency authorization status. */
 export type AttStatus = "authorized" | "denied" | "restricted" | "not-determined";
 /** User-notification permission state returned by `registerForPushNotifications`. */
@@ -163,23 +167,20 @@ export interface InitializeOptions {
     /** API base URL. Defaults to `https://app.apex.inc`. */
     apiUrl?: string;
     /**
-     * Optional workspace-bound API key (`apex_uk_*` or `apex_sk_*`).
+     * Optional app key (`apex_pk_*`), made under Settings, Organization,
+     * API keys with the App key preset. Safe to ship in a released app.
      *
      * When set, the plugin attaches it as `x-apex-api-key` on every
-     * outbound request to `/api/events` and `/api/identity/stitch`. The
-     * server uses this to authorize quarantine-mode auto-stitch
-     * (Phase 2-quarantine) and explicit `identify()` calls
-     * (Phase 2-prep `stitchIdentity` verified mode).
+     * outbound request to `/api/events` and `/api/identity/stitch`. It
+     * gives the app its own rate limit and lets a `user_signed_up` event
+     * with an email add a new person (held until a signed `identify()`).
+     * It never touches a person already in Apex, never counts revenue as a
+     * server, and never sends anything to ad platforms.
      *
-     * Without an API key, events still flow but auto-stitch is
-     * suppressed and `identify()` calls are accepted only for workspaces
-     * whose visitor->Contact link can be derived from the request
-     * workspace key alone.
-     *
-     * IMPORTANT: only embed API keys in mobile apps when the workspace
-     * is dedicated to that app. Treat the value like a publishable key,
-     * not a secret — assume it will leak via reverse-engineering. Apex
-     * rate-limits per key + per visitor to make leaked keys low-yield.
+     * Never ship a server key (`apex_sk_*`) or personal key (`apex_uk_*`)
+     * in a released app. Anyone can extract it from the bundle, and either
+     * key lets them send purchases Apex counts as revenue and forwards to
+     * ad platforms. Send purchases from your server instead.
      */
     apiKey?: string;
     /**
@@ -227,6 +228,25 @@ export interface InitializeOptions {
      * server stamps `releaseChannelSource: "auto"` regardless.
      */
     releaseChannel?: ReleaseChannel;
+    /**
+     * Mobile Measurement P2 — let Apex drive SKAdNetwork conversion values.
+     *
+     * When true (the default on iOS), the plugin fetches what Apple's 0–63
+     * numbers mean for this app — the table Set up Apex derives from "which
+     * event means an install was worth it?" — caches it for a day, and
+     * calls `updatePostbackConversionValue` whenever `track()` sees an
+     * event in that table. The first manual `updateConversionValue` call
+     * switches this off for the install, so a hand-rolled ladder always
+     * wins. No-op on Android and web.
+     *
+     * Set false to keep full manual control.
+     */
+    autoConversionValues?: boolean;
+    /**
+     * Which registered app's conversion value table to use, when the
+     * workspace has more than one. Defaults to the workspace's first app.
+     */
+    mobileAppId?: string;
 }
 /**
  * Options for {@link ApexCapacitorPlugin.identify}.
@@ -261,6 +281,13 @@ export interface IdentifyOptions {
      * source, plan tier, locale). Merged into the Contact's traits.
      */
     traits?: Record<string, unknown>;
+    /**
+     * Signed sign-in: the hash your server made from this email with the
+     * workspace's sign-in secret. Fetch it from your backend at sign-in;
+     * never put the secret in the app. Without it, a workspace that requires
+     * signed sign-ins holds the sign-in instead of attaching it to a person.
+     */
+    userHash?: string;
 }
 /** Return value of {@link ApexCapacitorPlugin.getAdvertisingId}. */
 export interface AdvertisingIdResult {
@@ -377,11 +404,19 @@ export interface ApexCapacitorPlugin {
      */
     getAdvertisingId(): Promise<AdvertisingIdResult>;
     /**
-     * Android: returns decoded Play Install Referrer string on first launch.
-     * iOS: returns `{ referrer: null }` (no equivalent).
+     * Android: returns the decoded Play Install Referrer string, waiting
+     * briefly for Play to connect if the call arrives during first launch.
+     * `clickTimestamp` is the Unix-seconds time of the original ad tap
+     * (0 when Play didn't report one), which is what makes a stale
+     * referrer detectable — Play keeps the string forever.
+     *
+     * iOS: returns `{ referrer: null, clickTimestamp: 0 }`. The App Store
+     * forwards nothing across an install, which is why iOS deferred deep
+     * linking has to fall back to a probabilistic server match.
      */
     getInstallReferrer(): Promise<{
         referrer: string | null;
+        clickTimestamp: number;
     }>;
     /** Gets the plugin-managed visitor ID. */
     getVisitorId(): Promise<{
@@ -411,20 +446,55 @@ export interface ApexCapacitorPlugin {
     /**
      * Updates the SKAdNetwork 4.0 postback conversion value. No-op on Android.
      * `fineValue` is 0-63 (fine conversion value); `coarseValue` is optional
-     * for SKAN 4.0's coarse-grained reporting.
+     * for SKAN 4.0's coarse-grained reporting; `lockWindow` asks Apple to
+     * send the current window's postback now rather than waiting it out.
+     *
+     * Calling this yourself turns off `autoConversionValues` for the
+     * install — manual always wins.
      */
     updateConversionValue(options: {
         fineValue: number;
         coarseValue?: SkanCoarseValue;
+        lockWindow?: boolean;
     }): Promise<void>;
+    /**
+     * The conversion value table the plugin is acting on: what each of
+     * Apple's numbers means for this app, as set in Set up Apex. `schema`
+     * is null until the shop has answered the SKAN question (or before
+     * the first fetch lands). Read-only; edit it in the Apex dashboard.
+     */
+    getConversionValueSchema(): Promise<SkanSchemaSnapshot>;
     /**
      * Returns the URL the app was opened with on cold start (Universal Link on
      * iOS, App Link on Android). Returns `{ url: null }` if launched without a
      * link. Use the `deepLink` listener for subsequent warm-start links.
+     *
+     * `deepLinkHint` is the `apex_dl` value the Apex Link carried, already pulled
+     * off the query string — null when the link had none. It is whatever the
+     * merchant put on the link in Apex; nothing interprets it but your router.
      */
     getInitialDeepLink(): Promise<{
         url: string | null;
+        deepLinkHint: string | null;
     }>;
+    /**
+     * Resolve the link the user tapped BEFORE they installed the app.
+     *
+     * `getInitialDeepLink()` above covers the case where the app already
+     * exists and the OS hands it a URL. This covers the other case: the
+     * user tapped an Apex Link in a browser, did not have the app, went
+     * through the store, and is now opening it for the first time. No URL
+     * reaches the app in that flow, so Apex matches the launch back to the
+     * tap server-side and returns the destination it was headed for.
+     *
+     * Returns null when there is no match, which is the common case — call
+     * it, route on a hit, and carry on normally otherwise. Resolution is
+     * one-shot per tap, so call it once at first launch and persist the
+     * result rather than calling it again later.
+     *
+     * See `deferred-link.ts` for the matching properties and their limits.
+     */
+    getDeferredDeepLink(): Promise<DeferredDeepLinkResult | null>;
     getDeviceInfo(): Promise<DeviceInfo>;
     /** Force-starts a new session, ending any current one. */
     startSession(): Promise<{
@@ -514,9 +584,15 @@ export interface ApexCapacitorPlugin {
     getConsent(): Promise<{
         granted: boolean;
     }>;
-    /** Fires when a deep link opens the app while it is already running. */
+    /**
+     * Fires when a deep link opens the app while it is already running.
+     *
+     * `deepLinkHint` carries the link's `apex_dl` value when it had one — see
+     * `getInitialDeepLink()`.
+     */
     addListener(eventName: "deepLink", listenerFunc: (event: {
         url: string;
+        deepLinkHint: string | null;
     }) => void): Promise<PluginListenerHandle>;
     /** Fires when the app moves between foreground and background. */
     addListener(eventName: "appStateChange", listenerFunc: (event: {

package/dist/definitions.d.ts.map

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

package/dist/esm/deferred-link.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Deferred deep-link resolution.
+ *
+ * The problem this solves: a user taps a link in Safari or Chrome, does
+ * not have your app, installs it from the store, and opens it. The tap
+ * and the launch share no cookie and no storage, so by default your app
+ * has no idea the user was headed for a specific screen and drops them
+ * on your home screen. The tap that cost you money lands nowhere.
+ *
+ * Apex matches the launch back to the tap server-side and hands you the
+ * destination. Call it once, early, and route on the result:
+ *
+ * ```ts
+ * const link = await Apex.getDeferredDeepLink();
+ * if (link) router.navigateByUrl(link.deepLinkHint ?? new URL(link.url).pathname);
+ * ```
+ *
+ * Two properties worth knowing before you build on it:
+ *
+ *   - **One-shot.** The match key is coarse (network + OS), so a link can
+ *     only be claimed once. Call this on first launch and persist what
+ *     you get; a second call returns null.
+ *   - **Best-effort.** Matching is probabilistic and returns null more
+ *     often than it returns a link — no network address, a VPN between
+ *     tap and install, or a slow install all produce a miss. Treat a
+ *     link as a bonus that improves the first run, never as a
+ *     precondition for it.
+ *
+ * Implemented in TypeScript rather than in the native bridges because it
+ * is one HTTPS call with no platform APIs involved, and the webview can
+ * make it identically on iOS, Android, and in browser preview.
+ */
+export interface DeferredDeepLinkResult {
+    /**
+     * The destination the tap was headed for, with Apex's own routing
+     * params (`apex_dl`, `apex_link`) already stripped.
+     */
+    url: string;
+    /**
+     * The link's `apex_dl` value — whatever screen identifier you put on
+     * the link in Apex. Null when the link carried none.
+     */
+    deepLinkHint: string | null;
+    /** Apex Link slug the tap came through, when it came through one. */
+    slug?: string;
+    /** Affiliate handle, for namespaced partner links. */
+    handle?: string;
+    source?: string;
+    campaign?: string;
+    /** ISO timestamp of the original tap. */
+    clickedAt: string;
+    /**
+     * How the launch was matched to the tap.
+     *
+     * `deterministic` means Google Play handed us the exact link the user
+     * tapped, via the install referrer — there is no guesswork in it.
+     * `probabilistic` means we matched on network address and OS, which is
+     * the best available on iOS and can, on a shared network, be wrong.
+     * Route on either; only gate irreversible actions (granting a credit,
+     * applying a referral bonus) on `deterministic`.
+     */
+    matchType: "deterministic" | "probabilistic";
+}
+export interface FetchDeferredDeepLinkOptions {
+    apiUrl: string;
+    workspaceKey: string;
+    platform: "ios" | "android";
+    apiKey?: string;
+    /** Abort the call after this many ms. Defaults to 5000. */
+    timeoutMs?: number;
+}
+export declare function fetchDeferredDeepLink(options: FetchDeferredDeepLinkOptions): Promise<DeferredDeepLinkResult | null>;
+//# sourceMappingURL=deferred-link.d.ts.map

package/dist/esm/deferred-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-link.d.ts","sourceRoot":"","sources":["../../src/deferred-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;OASG;IACH,SAAS,EAAE,eAAe,GAAG,eAAe,CAAC;CAC9C;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAwCxC"}

package/dist/esm/deferred-link.js

@@ -0,0 +1,68 @@
+/**
+ * Deferred deep-link resolution.
+ *
+ * The problem this solves: a user taps a link in Safari or Chrome, does
+ * not have your app, installs it from the store, and opens it. The tap
+ * and the launch share no cookie and no storage, so by default your app
+ * has no idea the user was headed for a specific screen and drops them
+ * on your home screen. The tap that cost you money lands nowhere.
+ *
+ * Apex matches the launch back to the tap server-side and hands you the
+ * destination. Call it once, early, and route on the result:
+ *
+ * ```ts
+ * const link = await Apex.getDeferredDeepLink();
+ * if (link) router.navigateByUrl(link.deepLinkHint ?? new URL(link.url).pathname);
+ * ```
+ *
+ * Two properties worth knowing before you build on it:
+ *
+ *   - **One-shot.** The match key is coarse (network + OS), so a link can
+ *     only be claimed once. Call this on first launch and persist what
+ *     you get; a second call returns null.
+ *   - **Best-effort.** Matching is probabilistic and returns null more
+ *     often than it returns a link — no network address, a VPN between
+ *     tap and install, or a slow install all produce a miss. Treat a
+ *     link as a bonus that improves the first run, never as a
+ *     precondition for it.
+ *
+ * Implemented in TypeScript rather than in the native bridges because it
+ * is one HTTPS call with no platform APIs involved, and the webview can
+ * make it identically on iOS, Android, and in browser preview.
+ */
+const DEFAULT_TIMEOUT_MS = 5000;
+export async function fetchDeferredDeepLink(options) {
+    const { apiUrl, workspaceKey, platform, apiKey } = options;
+    if (!workspaceKey)
+        return null;
+    // First launch is the most latency-sensitive moment in the app's life.
+    // A slow or unreachable Apex must never hold up the first screen, so
+    // the call is bounded and every failure resolves to null.
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+            "x-apex-workspace": workspaceKey,
+        };
+        if (apiKey)
+            headers["x-apex-api-key"] = apiKey;
+        const response = await fetch(`${apiUrl.replace(/\/+$/, "")}/api/mobile/deferred-link`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ workspaceKey, platform }),
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return null;
+        const payload = (await response.json());
+        return payload.data ?? null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=deferred-link.js.map

package/dist/esm/deferred-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-link.js","sourceRoot":"","sources":["../../src/deferred-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AA2CH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAqC;IAErC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,uEAAuE;IACvE,qEAAqE;IACrE,0DAA0D;IAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,OAAO,CAAC,SAAS,IAAI,kBAAkB,CACxC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,kBAAkB,EAAE,YAAY;SACjC,CAAC;QACF,IAAI,MAAM;YAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,EACxD;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;YAChD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAErC,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/esm/definitions.d.ts

@@ -10,6 +10,10 @@
  * See `plans/mobile-measurement-platform.md` Phase 1b for scope and rationale.
  */
 import type { PluginListenerHandle } from "@capacitor/core";
+import type { DeferredDeepLinkResult } from "./deferred-link";
+import type { SkanSchemaSnapshot } from "./skan-conversion-values";
+export type { DeferredDeepLinkResult } from "./deferred-link";
+export type { SkanConversionSchema, SkanConversionValueEntry, SkanConversionWindow, SkanSchemaSnapshot, SkanWindow, } from "./skan-conversion-values";
 /** iOS App Tracking Transparency authorization status. */
 export type AttStatus = "authorized" | "denied" | "restricted" | "not-determined";
 /** User-notification permission state returned by `registerForPushNotifications`. */
@@ -163,23 +167,20 @@ export interface InitializeOptions {
     /** API base URL. Defaults to `https://app.apex.inc`. */
     apiUrl?: string;
     /**
-     * Optional workspace-bound API key (`apex_uk_*` or `apex_sk_*`).
+     * Optional app key (`apex_pk_*`), made under Settings, Organization,
+     * API keys with the App key preset. Safe to ship in a released app.
      *
      * When set, the plugin attaches it as `x-apex-api-key` on every
-     * outbound request to `/api/events` and `/api/identity/stitch`. The
-     * server uses this to authorize quarantine-mode auto-stitch
-     * (Phase 2-quarantine) and explicit `identify()` calls
-     * (Phase 2-prep `stitchIdentity` verified mode).
+     * outbound request to `/api/events` and `/api/identity/stitch`. It
+     * gives the app its own rate limit and lets a `user_signed_up` event
+     * with an email add a new person (held until a signed `identify()`).
+     * It never touches a person already in Apex, never counts revenue as a
+     * server, and never sends anything to ad platforms.
      *
-     * Without an API key, events still flow but auto-stitch is
-     * suppressed and `identify()` calls are accepted only for workspaces
-     * whose visitor->Contact link can be derived from the request
-     * workspace key alone.
-     *
-     * IMPORTANT: only embed API keys in mobile apps when the workspace
-     * is dedicated to that app. Treat the value like a publishable key,
-     * not a secret — assume it will leak via reverse-engineering. Apex
-     * rate-limits per key + per visitor to make leaked keys low-yield.
+     * Never ship a server key (`apex_sk_*`) or personal key (`apex_uk_*`)
+     * in a released app. Anyone can extract it from the bundle, and either
+     * key lets them send purchases Apex counts as revenue and forwards to
+     * ad platforms. Send purchases from your server instead.
      */
     apiKey?: string;
     /**
@@ -227,6 +228,25 @@ export interface InitializeOptions {
      * server stamps `releaseChannelSource: "auto"` regardless.
      */
     releaseChannel?: ReleaseChannel;
+    /**
+     * Mobile Measurement P2 — let Apex drive SKAdNetwork conversion values.
+     *
+     * When true (the default on iOS), the plugin fetches what Apple's 0–63
+     * numbers mean for this app — the table Set up Apex derives from "which
+     * event means an install was worth it?" — caches it for a day, and
+     * calls `updatePostbackConversionValue` whenever `track()` sees an
+     * event in that table. The first manual `updateConversionValue` call
+     * switches this off for the install, so a hand-rolled ladder always
+     * wins. No-op on Android and web.
+     *
+     * Set false to keep full manual control.
+     */
+    autoConversionValues?: boolean;
+    /**
+     * Which registered app's conversion value table to use, when the
+     * workspace has more than one. Defaults to the workspace's first app.
+     */
+    mobileAppId?: string;
 }
 /**
  * Options for {@link ApexCapacitorPlugin.identify}.
@@ -261,6 +281,13 @@ export interface IdentifyOptions {
      * source, plan tier, locale). Merged into the Contact's traits.
      */
     traits?: Record<string, unknown>;
+    /**
+     * Signed sign-in: the hash your server made from this email with the
+     * workspace's sign-in secret. Fetch it from your backend at sign-in;
+     * never put the secret in the app. Without it, a workspace that requires
+     * signed sign-ins holds the sign-in instead of attaching it to a person.
+     */
+    userHash?: string;
 }
 /** Return value of {@link ApexCapacitorPlugin.getAdvertisingId}. */
 export interface AdvertisingIdResult {
@@ -377,11 +404,19 @@ export interface ApexCapacitorPlugin {
      */
     getAdvertisingId(): Promise<AdvertisingIdResult>;
     /**
-     * Android: returns decoded Play Install Referrer string on first launch.
-     * iOS: returns `{ referrer: null }` (no equivalent).
+     * Android: returns the decoded Play Install Referrer string, waiting
+     * briefly for Play to connect if the call arrives during first launch.
+     * `clickTimestamp` is the Unix-seconds time of the original ad tap
+     * (0 when Play didn't report one), which is what makes a stale
+     * referrer detectable — Play keeps the string forever.
+     *
+     * iOS: returns `{ referrer: null, clickTimestamp: 0 }`. The App Store
+     * forwards nothing across an install, which is why iOS deferred deep
+     * linking has to fall back to a probabilistic server match.
      */
     getInstallReferrer(): Promise<{
         referrer: string | null;
+        clickTimestamp: number;
     }>;
     /** Gets the plugin-managed visitor ID. */
     getVisitorId(): Promise<{
@@ -411,20 +446,55 @@ export interface ApexCapacitorPlugin {
     /**
      * Updates the SKAdNetwork 4.0 postback conversion value. No-op on Android.
      * `fineValue` is 0-63 (fine conversion value); `coarseValue` is optional
-     * for SKAN 4.0's coarse-grained reporting.
+     * for SKAN 4.0's coarse-grained reporting; `lockWindow` asks Apple to
+     * send the current window's postback now rather than waiting it out.
+     *
+     * Calling this yourself turns off `autoConversionValues` for the
+     * install — manual always wins.
      */
     updateConversionValue(options: {
         fineValue: number;
         coarseValue?: SkanCoarseValue;
+        lockWindow?: boolean;
     }): Promise<void>;
+    /**
+     * The conversion value table the plugin is acting on: what each of
+     * Apple's numbers means for this app, as set in Set up Apex. `schema`
+     * is null until the shop has answered the SKAN question (or before
+     * the first fetch lands). Read-only; edit it in the Apex dashboard.
+     */
+    getConversionValueSchema(): Promise<SkanSchemaSnapshot>;
     /**
      * Returns the URL the app was opened with on cold start (Universal Link on
      * iOS, App Link on Android). Returns `{ url: null }` if launched without a
      * link. Use the `deepLink` listener for subsequent warm-start links.
+     *
+     * `deepLinkHint` is the `apex_dl` value the Apex Link carried, already pulled
+     * off the query string — null when the link had none. It is whatever the
+     * merchant put on the link in Apex; nothing interprets it but your router.
      */
     getInitialDeepLink(): Promise<{
         url: string | null;
+        deepLinkHint: string | null;
     }>;
+    /**
+     * Resolve the link the user tapped BEFORE they installed the app.
+     *
+     * `getInitialDeepLink()` above covers the case where the app already
+     * exists and the OS hands it a URL. This covers the other case: the
+     * user tapped an Apex Link in a browser, did not have the app, went
+     * through the store, and is now opening it for the first time. No URL
+     * reaches the app in that flow, so Apex matches the launch back to the
+     * tap server-side and returns the destination it was headed for.
+     *
+     * Returns null when there is no match, which is the common case — call
+     * it, route on a hit, and carry on normally otherwise. Resolution is
+     * one-shot per tap, so call it once at first launch and persist the
+     * result rather than calling it again later.
+     *
+     * See `deferred-link.ts` for the matching properties and their limits.
+     */
+    getDeferredDeepLink(): Promise<DeferredDeepLinkResult | null>;
     getDeviceInfo(): Promise<DeviceInfo>;
     /** Force-starts a new session, ending any current one. */
     startSession(): Promise<{
@@ -514,9 +584,15 @@ export interface ApexCapacitorPlugin {
     getConsent(): Promise<{
         granted: boolean;
     }>;
-    /** Fires when a deep link opens the app while it is already running. */
+    /**
+     * Fires when a deep link opens the app while it is already running.
+     *
+     * `deepLinkHint` carries the link's `apex_dl` value when it had one — see
+     * `getInitialDeepLink()`.
+     */
     addListener(eventName: "deepLink", listenerFunc: (event: {
         url: string;
+        deepLinkHint: string | null;
     }) => void): Promise<PluginListenerHandle>;
     /** Fires when the app moves between foreground and background. */
     addListener(eventName: "appStateChange", listenerFunc: (event: {