react-native-revnix 1.5.0 → 1.6.0

package/dist/client.d.ts

@@ -1,4 +1,5 @@
 import type { AdRevenue, AliasResult, CustomerEntitlements, IdentifyResult, IdentifyStrategy, IdentityInfo, LastDeepLink, MmpAttribution, PaywallInteraction, PlacementResolution, RegisterPurchaseInput, RegisterPurchaseResult, RevnixAttribution, RevnixConfig } from "./types.js";
+export declare function paywallImageUrls(value: unknown): string[];
 export declare class RevnixClient {
     private readonly apiKey;
     private readonly baseUrl;
@@ -56,6 +57,9 @@ export declare class RevnixClient {
      *  /v1/installs uses, and independent of the device header (which an app
      *  can turn off entirely). */
     private freshInstall;
+    private eventFlush;
+    private eventTimer;
+    private eventRetryAt;
     constructor(config: RevnixConfig);
     /** The id every call is made as: the stored identified/canonical id, or a
      *  generated-and-persisted anonymous id (rvx_anon_…) on first launch. */
@@ -105,7 +109,8 @@ export declare class RevnixClient {
     private postPurchase;
     /** C7: retry purchases that failed to register and were persisted locally.
      *  Runs automatically at construction; call again when connectivity returns.
-     *  Idempotent and safe to call repeatedly. */
+     *  Idempotent and safe to call repeatedly. Purchases queued more than 30
+     *  days ago are dropped with a diagnostic. */
     retryPendingPurchases(): Promise<void>;
     private freshEntitlements;
     private inflightEntitlements;
@@ -150,12 +155,22 @@ export declare class RevnixClient {
      *  RevnixAuthError locally, before any network call, like identify(). */
     getIdentity(): Promise<IdentityInfo>;
     /** Resolve a named in-app location to the currently published offering —
-     *  the one-line paywall call. REV-157: reads the network first and caches
-     *  the result; if that read FAILS (offline / incident) it falls back to the
-     *  last cached resolution with `stale: true`, so the paywall renders the
-     *  last published version rather than not at all. Throws only when there
-     *  is nothing cached. */
+     *  the one-line paywall call. Served instantly from a cache under 24 h old
+     *  that was fetched for this customer since the last `setAttributes` or
+     *  purchase, refreshed in the background. Otherwise reads the network and
+     *  caches the result; if that read FAILS (offline / incident) it falls back
+     *  to the last cached resolution with `stale: true`, so the paywall renders
+     *  the last published version rather than not at all. Throws only when
+     *  there is nothing cached. A deliberate rejection seen by the background
+     *  refresh drops the cache, so the next resolve throws it. */
     resolvePlacement(placementKey: string): Promise<PlacementResolution>;
+    /** Fetch these placements now so the next `resolvePlacement` answers from
+     *  the cache. Never throws; failures report to `onDiagnostic`. Paywall
+     *  images are warmed by `prefetchPaywallImages` from
+     *  `react-native-revnix/ui`. */
+    preload(placementKeys: string[]): Promise<void>;
+    private refreshPlacement;
+    private fetchPlacement;
     /** REV-157: the last resolution cached for `placementKey`, with NO network
      *  call — for an instant, offline-safe paywall at launch. Always
      *  `stale: true`; follow with resolvePlacement() to revalidate. Null if
@@ -207,7 +222,8 @@ export declare class RevnixClient {
      *    - `restore` — restore purchases was tapped
      *    - `error` — the paywall itself failed (config, products, render)
      *
-     *  Fire-and-forget like the other beacons: never blocks, never throws.
+     *  Queued and sent in batches (see `flushEvents`): resolves once queued,
+     *  never throws.
      *
      *  `viewId` is the id `logPaywallShown` returned for THIS display. Passing
      *  it is what threads the whole life of one impression together and puts
@@ -233,15 +249,28 @@ export declare class RevnixClient {
         message?: string;
         /** Idempotency key for this occurrence; defaults to `viewId`. */
         eventId?: string;
-    }): void;
+    }): Promise<void>;
     /** Reports one ad impression's payout (POST /v1/ad-revenue).
      *  Fire-and-forget like the other beacons: never blocks, never throws. */
     logAdRevenue(input: AdRevenue): void;
     /** Reports one custom in-app event (POST /v1/events), not for purchases.
-     *  Fire-and-forget like the other beacons: never blocks, never throws. */
+     *  Queued and sent in batches (see `flushEvents`): resolves once queued,
+     *  never throws. */
     track(event: string, properties?: Record<string, string | number | boolean>, options?: {
         eventId?: string;
-    }): void;
+    }): Promise<void>;
+    /** Send every queued `track` and paywall interaction event now. Events are
+     *  otherwise sent in batches: at 20 queued, 10 s after the first, when the
+     *  app goes to the background, and on the next launch. Never throws; a
+     *  transient failure keeps the events and holds further sends for 30 s. */
+    flushEvents(): Promise<void>;
+    private readEvents;
+    private mutateEvents;
+    private enqueueEvent;
+    private armEventTimer;
+    private startEventFlush;
+    private runEventFlush;
+    private removeEvents;
     /** PT11: forward an MMP's attribution callback (Adjust, AppsFlyer, …) so
      *  Revnix credits revenue to the right network/campaign. */
     setAttribution(attribution: MmpAttribution): void;
@@ -361,6 +390,7 @@ export declare class RevnixClient {
      *  cold start to ONE paywall. Never throws past its caller's catch. */
     private triggerImplicit;
     private consumePreviousSessionMs;
+    private subscribeLifecycle;
     /** REV-272: the launch-time moments, plus the foreground listener that
      *  `session_start` is built on.
      *
@@ -405,7 +435,12 @@ export declare class RevnixClient {
     private readPlacementMap;
     private readPlacementCache;
     private writePlacementCache;
-    private queueLock;
+    private deletePlacementCache;
+    private mutatePlacements;
+    private placementsInvalidatedAt;
+    private invalidatePlacements;
+    private storageLock;
+    private withStorageLock;
     private mutateQueue;
     private readPurchaseQueue;
     private writePurchaseQueue;