react-native-revnix 1.4.2 → 1.6.0

package/src/index.ts

@@ -12,6 +12,11 @@ export {
   RevnixTimeoutError,
 } from "./errors.js";
 export { purchaseInputFromIap, type IapPurchase } from "./iap.js";
+export {
+  setStoreAdapter,
+  type StoreAdapter,
+  type StoreTransaction,
+} from "./store.js";
 export { memoryStorage, generateAnonymousId } from "./storage.js";
 export { SDK_VERSION } from "./version.js";
 export { DEVICE_HEADER, encodeDeviceHeader } from "./device.js";

package/src/store/index.ts

@@ -0,0 +1,44 @@
+import { NativeEventEmitter, NativeModules } from "react-native";
+
+import {
+  setStoreAdapter,
+  type StoreAdapter,
+  type StoreTransaction,
+} from "../store.js";
+
+interface NativeRevnixStore {
+  purchase(productId: string, customerId: string): Promise<StoreTransaction | null>;
+  restore(): Promise<StoreTransaction[]>;
+  finish(transactionId: string): Promise<void>;
+}
+
+const native: NativeRevnixStore | undefined = NativeModules.RevnixStore;
+
+const missing = (): Promise<never> =>
+  Promise.reject(
+    new Error(
+      "Revnix: RevnixStore native module not found. Run pod install / rebuild the app (Expo: use a development build)."
+    )
+  );
+
+export const RevnixStore: StoreAdapter = native
+  ? {
+      purchase: (productId, { customerId }) => native.purchase(productId, customerId),
+      restore: () => native.restore(),
+      finish: (transactionId) => native.finish(transactionId),
+      observe(onTransaction) {
+        const sub = new NativeEventEmitter(NativeModules.RevnixStore).addListener(
+          "revnixStoreTransaction",
+          (tx) => onTransaction(tx as StoreTransaction)
+        );
+        return () => sub.remove();
+      },
+    }
+  : {
+      purchase: missing,
+      restore: missing,
+      finish: missing,
+      observe: () => () => {},
+    };
+
+if (native) setStoreAdapter(RevnixStore);

package/src/store.ts

@@ -0,0 +1,41 @@
+import type { Store } from "./types.js";
+
+export interface StoreTransaction {
+  store: Store;
+  productId: string;
+  /** Apple: transaction id · Google: purchaseToken. */
+  transactionId: string;
+  /** Apple: originalTransactionId · Google: purchaseToken. */
+  token: string;
+  /** Unix ms. */
+  occurredAt?: number;
+  /** Unix ms. */
+  expiresAt?: number;
+  /** Apple only: the StoreKit 2 JWS. */
+  signedTransactionInfo?: string;
+}
+
+export interface StoreAdapter {
+  /** Resolves null when the customer cancelled or the purchase is pending. */
+  purchase(
+    productId: string,
+    opts: { customerId: string }
+  ): Promise<StoreTransaction | null>;
+  restore(): Promise<StoreTransaction[]>;
+  finish(transactionId: string): Promise<void>;
+  /** Transactions arriving outside purchase(): renewals, other devices, Ask
+   *  to Buy, refunds. Returns an unsubscribe. */
+  observe(onTransaction: (tx: StoreTransaction) => void): () => void;
+}
+
+let adapter: StoreAdapter | null = null;
+
+/** Installs the store that `RevnixClient.purchase()` / `restore()` drive.
+ *  `import "react-native-revnix/store"` calls this with the native bridge. */
+export function setStoreAdapter(next: StoreAdapter | null): void {
+  adapter = next;
+}
+
+export function getStoreAdapter(): StoreAdapter | null {
+  return adapter;
+}

package/src/ui/RevnixPaywall.tsx

@@ -34,8 +34,12 @@ import type {
   PaywallConfig,
   PaywallInteraction,
   PaywallPurchaseOutcome,
+  PlacementResolution,
+  RegisterPurchaseResult,
 } from "../types.js";
 import { PREVIEW_PLACEMENT_KEY } from "../implicit.js";
+import { getStoreAdapter } from "../store.js";
+import { paywallImageUrls, type RevnixClient } from "../client.js";
 import type { PaywallBlockDoc } from "../blocks/types.js";
 import type { FontFamilyMap } from "../blocks/style.js";
 import { withAlpha } from "../blocks/color.js";
@@ -142,8 +146,11 @@ export interface RevnixPaywallProps {
    *  `paywall.purchase_failed`, and a promise that REJECTS is reported as a
    *  failure carrying the error's message. Returning nothing keeps today's
    *  behavior exactly — the start is reported, the outcome is not, and you
-   *  can still report it yourself with `client.logPaywallEvent`. */
-  onPurchase: (
+   *  can still report it yourself with `client.logPaywallEvent`.
+   *
+   *  Omit it to let the paywall buy through `client.purchase()`, which needs
+   *  `import "react-native-revnix/store"`. */
+  onPurchase?: (
     packageId: string
   ) => void | PaywallPurchaseOutcome | Promise<PaywallPurchaseOutcome | void>;
   /** Controlled selection; omit to let the paywall manage it (initial
@@ -152,7 +159,10 @@ export interface RevnixPaywallProps {
   onSelectPackage?: (packageId: string) => void;
   /** Renders a spinner in the CTA and disables purchasing. */
   loading?: boolean;
+  /** Omit it to restore through `client.restore()`. */
   onRestore?: () => void;
+  /** Fires when the paywall's own purchase (no `onPurchase`) succeeds. */
+  onPurchaseCompleted?: (result: RegisterPurchaseResult) => void;
   onTerms?: () => void;
   onPrivacy?: () => void;
   /** Called when the customer dismisses the paywall (REV-252) — either by
@@ -201,6 +211,9 @@ export interface RevnixPaywallProps {
         eventId?: string;
       }
     ) => void;
+    /** Used when `onPurchase` / `onRestore` are omitted. */
+    purchase?: RevnixClient["purchase"];
+    restore?: RevnixClient["restore"];
   };
   /** Placement/paywall attribution attached to the view report. */
   placementKey?: string;
@@ -243,6 +256,19 @@ export interface RevnixPaywallProps {
   locale?: string;
 }
 
+/** Warms React Native's image cache with every image `resolution`'s paywall
+ *  loads, so it paints without waiting on the network. Pair it with
+ *  `client.preload` / `resolvePlacement`. Never throws. */
+export async function prefetchPaywallImages(
+  resolution: PlacementResolution | null
+): Promise<void> {
+  await Promise.all(
+    paywallImageUrls(resolution?.paywall).map((url) =>
+      Image.prefetch(url).catch(() => false)
+    )
+  );
+}
+
 export function RevnixPaywall(props: RevnixPaywallProps) {
   // One view per mount: remounting (a re-shown paywall) is a genuine new
   // display; re-renders are not.
@@ -338,7 +364,7 @@ export function RevnixPaywall(props: RevnixPaywallProps) {
     [onSelectPackage, report, productOf]
   );
 
-  const { onPurchase } = props;
+  const { onPurchase, onPurchaseCompleted } = props;
   // Rises per attempt so a retry after a failure is its own occurrence rather
   // than being absorbed as a duplicate of the first try.
   const attemptRef = React.useRef(0);
@@ -368,9 +394,26 @@ export function RevnixPaywall(props: RevnixPaywallProps) {
           }
         );
       };
-      let returned: ReturnType<RevnixPaywallProps["onPurchase"]>;
+      const purchase =
+        onPurchase ??
+        (async (): Promise<PaywallPurchaseOutcome> => {
+          if (!productId) {
+            return { status: "failed", message: "package has no productId" };
+          }
+          if (!client?.purchase) {
+            return { status: "failed", message: "pass client or onPurchase" };
+          }
+          const result = await client.purchase(productId, {
+            viewId: viewIdRef.current,
+            placementKey,
+            paywallId,
+          });
+          if (result) onPurchaseCompleted?.(result);
+          return { status: result ? "completed" : "cancelled" };
+        });
+      let returned: ReturnType<typeof purchase>;
       try {
-        returned = onPurchase(packageId);
+        returned = purchase(packageId);
       } catch (err) {
         // A host that throws synchronously has failed the purchase as surely
         // as one whose promise rejects.
@@ -386,20 +429,26 @@ export function RevnixPaywall(props: RevnixPaywallProps) {
       }
       settle(returned as PaywallPurchaseOutcome | void);
     },
-    [onPurchase, report, productOf, placementKey]
+    [onPurchase, onPurchaseCompleted, report, productOf, placementKey, paywallId, client]
   );
 
   const { onRestore } = props;
-  const handleRestore = React.useMemo(
-    () =>
-      onRestore
-        ? () => {
-            report("restore");
-            onRestore();
-          }
-        : undefined,
-    [onRestore, report]
-  );
+  const handleRestore = React.useMemo(() => {
+    if (onRestore) {
+      return () => {
+        report("restore");
+        onRestore();
+      };
+    }
+    const restore = client?.restore?.bind(client);
+    if (!restore || !getStoreAdapter()) return undefined;
+    return () => {
+      report("restore");
+      void restore().catch((err) =>
+        client?.reportRenderDiagnostic?.(String(err?.message ?? err))
+      );
+    };
+  }, [onRestore, report, client]);
 
   // The host's dismissal runs whatever happens to the beacon — an analytics
   // failure must never trap the customer on the screen (REV-252).
@@ -532,7 +581,9 @@ function ClassicClose({
 
 /** The nine `template` layouts — every paywall published before the block
  *  builder, and the fallback for any config that carries no block tree. */
-function ClassicPaywall(props: RevnixPaywallProps) {
+function ClassicPaywall(
+  props: RevnixPaywallProps & { onPurchase: (packageId: string) => void }
+) {
   const { config, packages, loading } = props;
   // Base scheme comes from the dashboard config (mode: dark|light, absent =
   // dark for legacy configs); the host app's explicit theme prop wins on top.

package/src/ui/index.ts

@@ -2,6 +2,7 @@ export {
   RevnixPaywall,
   DEFAULT_PAYWALL_THEME,
   LIGHT_PAYWALL_THEME,
+  prefetchPaywallImages,
   type RevnixPaywallPackage,
   type RevnixPaywallProps,
   type RevnixPaywallTheme,

package/src/version.ts

@@ -1,4 +1,4 @@
 // L3: the single source of the SDK version inside src/. Must match
 // package.json "version" — version.test.ts fails the build when they drift
 // (they had: client.ts said 0.7.0 while the package shipped 0.9.0).
-export const SDK_VERSION = "1.4.2";
+export const SDK_VERSION = "1.6.0";

package/store.d.ts

@@ -0,0 +1 @@
+export * from "./dist/store/index";

package/store.js

@@ -0,0 +1 @@
+module.exports = require("./dist/store/index.js");