react-native-revnix 1.4.0 → 1.5.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import type { RevnixConfig } from "./types.js";
 export { RevnixClient } from "./client.js";
 export { PurchaseBlockedError, RevnixAuthError, RevnixError, RevnixNetworkError, RevnixRateLimitError, 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/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Revnix = exports.PREVIEW_PLACEMENT_KEY = exports.IMPLICIT_PLACEMENTS = exports.HOST_CALL_PLACEMENT = exports.DEFAULT_SESSION_TIMEOUT_MS = exports.browserLifecycle = exports.encodeDeviceHeader = exports.DEVICE_HEADER = exports.SDK_VERSION = exports.generateAnonymousId = exports.memoryStorage = exports.purchaseInputFromIap = exports.RevnixTimeoutError = exports.RevnixRateLimitError = exports.RevnixNetworkError = exports.RevnixError = exports.RevnixAuthError = exports.PurchaseBlockedError = exports.RevnixClient = void 0;
+exports.Revnix = exports.PREVIEW_PLACEMENT_KEY = exports.IMPLICIT_PLACEMENTS = exports.HOST_CALL_PLACEMENT = exports.DEFAULT_SESSION_TIMEOUT_MS = exports.browserLifecycle = exports.encodeDeviceHeader = exports.DEVICE_HEADER = exports.SDK_VERSION = exports.generateAnonymousId = exports.memoryStorage = exports.setStoreAdapter = exports.purchaseInputFromIap = exports.RevnixTimeoutError = exports.RevnixRateLimitError = exports.RevnixNetworkError = exports.RevnixError = exports.RevnixAuthError = exports.PurchaseBlockedError = exports.RevnixClient = void 0;
 const client_js_1 = require("./client.js");
 const locale_js_1 = require("./blocks/locale.js");
 var client_js_2 = require("./client.js");
@@ -14,6 +14,8 @@ Object.defineProperty(exports, "RevnixRateLimitError", { enumerable: true, get:
 Object.defineProperty(exports, "RevnixTimeoutError", { enumerable: true, get: function () { return errors_js_1.RevnixTimeoutError; } });
 var iap_js_1 = require("./iap.js");
 Object.defineProperty(exports, "purchaseInputFromIap", { enumerable: true, get: function () { return iap_js_1.purchaseInputFromIap; } });
+var store_js_1 = require("./store.js");
+Object.defineProperty(exports, "setStoreAdapter", { enumerable: true, get: function () { return store_js_1.setStoreAdapter; } });
 var storage_js_1 = require("./storage.js");
 Object.defineProperty(exports, "memoryStorage", { enumerable: true, get: function () { return storage_js_1.memoryStorage; } });
 Object.defineProperty(exports, "generateAnonymousId", { enumerable: true, get: function () { return storage_js_1.generateAnonymousId; } });

package/dist/store/index.d.ts

@@ -0,0 +1,2 @@
+import { type StoreAdapter } from "../store.js";
+export declare const RevnixStore: StoreAdapter;

package/dist/store/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevnixStore = void 0;
+const react_native_1 = require("react-native");
+const store_js_1 = require("../store.js");
+const native = react_native_1.NativeModules.RevnixStore;
+const missing = () => Promise.reject(new Error("Revnix: RevnixStore native module not found. Run pod install / rebuild the app (Expo: use a development build)."));
+exports.RevnixStore = native
+    ? {
+        purchase: (productId, { customerId }) => native.purchase(productId, customerId),
+        restore: () => native.restore(),
+        finish: (transactionId) => native.finish(transactionId),
+        observe(onTransaction) {
+            const sub = new react_native_1.NativeEventEmitter(react_native_1.NativeModules.RevnixStore).addListener("revnixStoreTransaction", (tx) => onTransaction(tx));
+            return () => sub.remove();
+        },
+    }
+    : {
+        purchase: missing,
+        restore: missing,
+        finish: missing,
+        observe: () => () => { },
+    };
+if (native)
+    (0, store_js_1.setStoreAdapter)(exports.RevnixStore);

package/dist/store.d.ts

@@ -0,0 +1,30 @@
+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;
+}
+/** Installs the store that `RevnixClient.purchase()` / `restore()` drive.
+ *  `import "react-native-revnix/store"` calls this with the native bridge. */
+export declare function setStoreAdapter(next: StoreAdapter | null): void;
+export declare function getStoreAdapter(): StoreAdapter | null;

package/dist/store.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setStoreAdapter = setStoreAdapter;
+exports.getStoreAdapter = getStoreAdapter;
+let adapter = null;
+/** Installs the store that `RevnixClient.purchase()` / `restore()` drive.
+ *  `import "react-native-revnix/store"` calls this with the native bridge. */
+function setStoreAdapter(next) {
+    adapter = next;
+}
+function getStoreAdapter() {
+    return adapter;
+}

package/dist/types.d.ts

@@ -379,7 +379,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/dist/ui/RevnixPaywall.d.ts

@@ -1,6 +1,7 @@
 import * as React from "react";
 import { type StyleProp, type ViewStyle } from "react-native";
-import type { PaywallConfig, PaywallInteraction, PaywallPurchaseOutcome } from "../types.js";
+import type { PaywallConfig, PaywallInteraction, PaywallPurchaseOutcome, RegisterPurchaseResult } from "../types.js";
+import type { RevnixClient } from "../client.js";
 import type { FontFamilyMap } from "../blocks/style.js";
 import { type RevnixBlurComponent, type RevnixGradientComponent } from "./RevnixBlockPaywall.js";
 /** One purchasable row. `priceLabel` must come from the store (localized). */
@@ -51,15 +52,21 @@ 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: (packageId: string) => void | PaywallPurchaseOutcome | Promise<PaywallPurchaseOutcome | void>;
+     *  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
      *  selection is the config's highlight package, else the first package). */
     selectedPackageId?: string;
     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
@@ -104,6 +111,9 @@ export interface RevnixPaywallProps {
             message?: string;
             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;

package/dist/ui/RevnixPaywall.js

@@ -13,7 +13,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.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -54,6 +54,7 @@ exports.RevnixPaywall = RevnixPaywall;
 const React = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const implicit_js_1 = require("../implicit.js");
+const store_js_1 = require("../store.js");
 const color_js_1 = require("../blocks/color.js");
 const RevnixBlockPaywall_js_1 = require("./RevnixBlockPaywall.js");
 /** `config.blocks` is opaque on the core config (the non-UI entrypoint must
@@ -178,7 +179,7 @@ function RevnixPaywall(props) {
         });
         onSelectPackage?.(packageId);
     }, [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);
@@ -205,9 +206,26 @@ function RevnixPaywall(props) {
                 eventId: occurrence,
             });
         };
+        const purchase = onPurchase ??
+            (async () => {
+                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;
         try {
-            returned = onPurchase(packageId);
+            returned = purchase(packageId);
         }
         catch (err) {
             // A host that throws synchronously has failed the purchase as surely
@@ -220,14 +238,23 @@ function RevnixPaywall(props) {
             return;
         }
         settle(returned);
-    }, [onPurchase, report, productOf, placementKey]);
+    }, [onPurchase, onPurchaseCompleted, report, productOf, placementKey, paywallId, client]);
     const { onRestore } = props;
-    const handleRestore = React.useMemo(() => onRestore
-        ? () => {
-            report("restore");
-            onRestore();
+    const handleRestore = React.useMemo(() => {
+        if (onRestore) {
+            return () => {
+                report("restore");
+                onRestore();
+            };
         }
-        : undefined, [onRestore, report]);
+        const restore = client?.restore?.bind(client);
+        if (!restore || !(0, store_js_1.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).
     const { onClose } = props;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.4.0";
+export declare const SDK_VERSION = "1.5.0";

package/dist/version.js

@@ -4,4 +4,4 @@ exports.SDK_VERSION = void 0;
 // 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).
-exports.SDK_VERSION = "1.4.0";
+exports.SDK_VERSION = "1.5.0";

package/ios/RevnixStore.m

@@ -0,0 +1,18 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(RevnixStore, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(purchase:(NSString *)productId
+                  customerId:(NSString *)customerId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(restore:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(finish:(NSString *)transactionId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/RevnixStore.swift

@@ -0,0 +1,106 @@
+import Foundation
+import React
+import StoreKit
+
+@available(iOS 15.0, *)
+@objc(RevnixStore)
+class RevnixStore: RCTEventEmitter {
+  private var updates: Task<Void, Never>?
+
+  @objc override static func requiresMainQueueSetup() -> Bool {
+    false
+  }
+
+  override func supportedEvents() -> [String]! {
+    ["revnixStoreTransaction"]
+  }
+
+  override func startObserving() {
+    updates?.cancel()
+    updates = Task { [weak self] in
+      for await update in Transaction.updates where update.unsafePayloadValue.revocationDate == nil {
+        self?.sendEvent(withName: "revnixStoreTransaction", body: RevnixStore.payload(update))
+      }
+    }
+  }
+
+  override func stopObserving() {
+    updates?.cancel()
+    updates = nil
+  }
+
+  @objc(purchase:customerId:resolver:rejecter:)
+  func purchase(
+    _ productId: String,
+    customerId: String,
+    resolver resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    Task {
+      do {
+        guard let product = try await Product.products(for: [productId]).first else {
+          reject("product_not_found", "No App Store product with id \(productId)", nil)
+          return
+        }
+        switch try await product.purchase() {
+        case .success(let verification):
+          resolve(RevnixStore.payload(verification))
+        default:
+          resolve(nil)
+        }
+      } catch {
+        reject("store_error", error.localizedDescription, error)
+      }
+    }
+  }
+
+  @objc(restore:rejecter:)
+  func restore(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    Task {
+      try? await AppStore.sync()
+      var transactions: [[String: Any]] = []
+      for await entitlement in Transaction.currentEntitlements
+      where entitlement.unsafePayloadValue.revocationDate == nil {
+        transactions.append(RevnixStore.payload(entitlement))
+      }
+      resolve(transactions)
+    }
+  }
+
+  @objc(finish:resolver:rejecter:)
+  func finish(
+    _ transactionId: String,
+    resolver resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    Task {
+      for await unfinished in Transaction.unfinished {
+        let transaction = unfinished.unsafePayloadValue
+        if String(transaction.id) == transactionId {
+          await transaction.finish()
+          break
+        }
+      }
+      resolve(nil)
+    }
+  }
+
+  private static func payload(_ verification: VerificationResult<Transaction>) -> [String: Any] {
+    let transaction = verification.unsafePayloadValue
+    var payload: [String: Any] = [
+      "store": "apple",
+      "productId": transaction.productID,
+      "transactionId": String(transaction.id),
+      "token": String(transaction.originalID),
+      "occurredAt": Int(transaction.purchaseDate.timeIntervalSince1970 * 1000),
+      "signedTransactionInfo": verification.jwsRepresentation,
+    ]
+    if let expiresAt = transaction.expirationDate {
+      payload["expiresAt"] = Int(expiresAt.timeIntervalSince1970 * 1000)
+    }
+    return payload
+  }
+}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "react-native-revnix",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Revnix SDK for React, React Native & Next.js: purchase registration, entitlements, identity, and placements over the Revnix /v1 API.",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Oth-tech/revnix-sdk.git"
   },
+  "homepage": "https://www.revnix.io/docs/react-native",
+  "bugs": {
+    "email": "support@revnix.io"
+  },
   "keywords": [
     "revnix",
     "react-native",
@@ -24,7 +28,11 @@
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/index.d.ts",
-  "sideEffects": false,
+  "sideEffects": [
+    "./store.js",
+    "./dist/store/index.js",
+    "./dist/esm/store/index.js"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -36,6 +44,11 @@
       "import": "./dist/esm/ui/index.js",
       "require": "./ui.js"
     },
+    "./store": {
+      "types": "./store.d.ts",
+      "import": "./dist/esm/store/index.js",
+      "require": "./store.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -43,6 +56,11 @@
     "src",
     "ui.js",
     "ui.d.ts",
+    "store.js",
+    "store.d.ts",
+    "ios",
+    "android",
+    "react-native-revnix.podspec",
     "!src/**/*.test.ts"
   ],
   "scripts": {

package/react-native-revnix.podspec

@@ -0,0 +1,22 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name          = "react-native-revnix"
+  s.version       = package["version"]
+  s.summary       = package["description"]
+  s.homepage      = package["homepage"]
+  s.license       = package["license"]
+  s.author        = "Revnix"
+  s.platforms     = { :ios => "15.1" }
+  s.source        = { :git => "https://github.com/Oth-tech/revnix-sdk.git", :tag => "v#{s.version}" }
+  s.source_files  = "ios/**/*.{h,m,swift}"
+  s.swift_version = "5.0"
+
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+end

package/src/client.ts

@@ -20,6 +20,11 @@ import {
   encodeDeviceHeader,
 } from "./device.js";
 import { SDK_VERSION } from "./version.js";
+import {
+  getStoreAdapter,
+  type StoreAdapter,
+  type StoreTransaction,
+} from "./store.js";
 import {
   browserLifecycle,
   DEFAULT_SESSION_TIMEOUT_MS,
@@ -185,6 +190,7 @@ export class RevnixClient {
   private implicitConfigPromise: Promise<ReadonlySet<string>> | null = null;
   private implicitConfigRetryAt = 0;
   private lifecycleUnsubscribe: (() => void) | null = null;
+  private stopStoreObserver: (() => void) | null = null;
   /** The cold-start batch while it runs, resolving to whether it presented a
    *  paywall. A deep link delivered on the first frame — SwiftUI's onOpenURL,
    *  RN's getInitialURL — must wait for it, or the customer gets the launch
@@ -253,6 +259,14 @@ export class RevnixClient {
     void this.retryPendingPurchases().catch((err) =>
       this.diag("retryPendingPurchases", err)
     );
+    const store = getStoreAdapter();
+    if (store) {
+      this.stopStoreObserver = store.observe((tx) =>
+        void this.registerStoreTransaction(store, tx).catch((err) =>
+          this.diag("storeObserver", err)
+        )
+      );
+    }
     // REV-157: warm the placement cache at launch, so the first paywall of the
     // session can render offline. Fire-and-forget; a failed key just stays on
     // whatever an earlier launch cached.
@@ -425,6 +439,77 @@ export class RevnixClient {
     }
   }
 
+  /** Buys `productId` through the native store (StoreKit 2 / Play Billing),
+   *  registers it with Revnix, then finishes the store transaction. Resolves
+   *  null when the customer cancelled or the purchase is pending approval.
+   *  Needs `import "react-native-revnix/store"` before configure(). A refused
+   *  claim (PurchaseBlockedError) is never finished, so Google refunds it. */
+  async purchase(
+    productId: string,
+    opts?: Pick<RegisterPurchaseInput, "viewId" | "paywallId" | "placementKey">
+  ): Promise<RegisterPurchaseResult | null> {
+    const store = this.requireStore();
+    const customerId = await this.customerIdPromise;
+    const tx = await store.purchase(productId, { customerId });
+    if (!tx) return null;
+    return this.registerStoreTransaction(store, tx, opts);
+  }
+
+  /** Re-registers every purchase the store still holds for this device and
+   *  resolves how many registered. Per-purchase failures go to onDiagnostic. */
+  async restore(): Promise<number> {
+    const store = this.requireStore();
+    let restored = 0;
+    for (const tx of await store.restore()) {
+      try {
+        await this.registerStoreTransaction(store, tx, undefined, tx.store === "google");
+        restored += 1;
+      } catch (err) {
+        this.diag("storeRestore", err);
+      }
+    }
+    return restored;
+  }
+
+  private requireStore(): StoreAdapter {
+    const store = getStoreAdapter();
+    if (!store) {
+      throw new Error(
+        'Revnix: native purchases need `import "react-native-revnix/store"` before Revnix.configure(...) and a rebuilt app (pod install / Expo development build)'
+      );
+    }
+    return store;
+  }
+
+  private async registerStoreTransaction(
+    store: StoreAdapter,
+    tx: StoreTransaction,
+    opts?: Pick<RegisterPurchaseInput, "viewId" | "paywallId" | "placementKey">,
+    finish = true
+  ): Promise<RegisterPurchaseResult> {
+    const finishTx = () =>
+      finish
+        ? store.finish(tx.transactionId).catch((err) => this.diag("storeFinish", err))
+        : undefined;
+    try {
+      const result = await this.registerPurchase({
+        source: tx.store,
+        token: tx.token,
+        productId: tx.productId,
+        transactionId: tx.transactionId,
+        occurredAt: tx.occurredAt,
+        expiresAt: tx.expiresAt,
+        signedTransactionInfo: tx.signedTransactionInfo,
+        ...opts,
+      });
+      await finishTx();
+      return result;
+    } catch (err) {
+      if (!(err instanceof PurchaseBlockedError)) await finishTx();
+      throw err;
+    }
+  }
+
   private postPurchase(
     customerId: string,
     input: RegisterPurchaseInput
@@ -1532,6 +1617,8 @@ export class RevnixClient {
     // every return alongside its successor.
     this.lifecycleUnsubscribe?.();
     this.lifecycleUnsubscribe = null;
+    this.stopStoreObserver?.();
+    this.stopStoreObserver = null;
   }
 
   /** A block paywall reporting a paint string it could not read. Routed to the
@@ -1922,7 +2009,7 @@ export class RevnixClient {
           Authorization: `Bearer ${this.apiKey}`,
           // L3: identify the SDK on EVERY request (reads included) so the
           // backend can triage by version without depending on body fields.
-          "X-Revnix-SDK": `revnix-react/${SDK_VERSION}`,
+          "X-Revnix-SDK": `react-native-revnix/${SDK_VERSION}`,
           ...(reportedBgFailures > 0
             ? { "X-Revnix-Bg-Failures": String(reportedBgFailures) }
             : {}),

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);