react-native-revnix 1.4.0 → 1.5.0

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/types.ts

@@ -427,7 +427,7 @@ export interface PaywallConfig {
    *  When present RevnixPaywall renders THIS and the fields above act as the
    *  fallback for clients that predate block rendering — so an older app
    *  keeps showing a sane classic screen instead of nothing. Typed as the
-   *  block document in "revnix-react/ui"; the core entrypoint keeps it opaque
+   *  block document in "react-native-revnix/ui"; the core entrypoint keeps it opaque
    *  so non-UI consumers pull in no renderer types. */
   blocks?: unknown;
 }

package/src/ui/RevnixPaywall.tsx

@@ -12,7 +12,7 @@
 // An unrecognized template (config published by a newer dashboard) falls
 // back to the classic structure instead of rendering nothing.
 //
-// Import from "revnix-react/ui" — the core entrypoint stays free of
+// Import from "react-native-revnix/ui" — the core entrypoint stays free of
 // react / react-native so non-RN consumers are unaffected.
 
 import * as React from "react";
@@ -34,8 +34,11 @@ import type {
   PaywallConfig,
   PaywallInteraction,
   PaywallPurchaseOutcome,
+  RegisterPurchaseResult,
 } from "../types.js";
 import { PREVIEW_PLACEMENT_KEY } from "../implicit.js";
+import { getStoreAdapter } from "../store.js";
+import 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 +145,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 +158,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 +210,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;
@@ -338,7 +350,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 +380,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 +415,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 +567,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/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.0";
+export const SDK_VERSION = "1.5.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");

package/ui.js

@@ -1,4 +1,4 @@
-// Subpath entry: require("revnix-react/ui"). Kept at the package root
+// Subpath entry: require("react-native-revnix/ui"). Kept at the package root
 // so every resolver (Metro, Node, TS "node" moduleResolution) finds it
 // without an "exports" map. UI pulls in react/react-native peers — keep it
 // out of the core index so pure-JS consumers never load them.