react-native-purchases 7.28.1 → 8.0.0

package/README.md

@@ -53,61 +53,11 @@ Our full SDK reference [can be found here](https://revenuecat.github.io/react-na
 
 ## Installation
 
-ExpoKit projects of version 33 or higher can successfully use react-native-purchases. If you haven't upgraded, you can follow [the instructions here to upgrade](https://docs.expo.io/versions/latest/expokit/expokit/#upgrading-expokit). 
+Expo supports in-app payments and is compatible with react-native-purchases. To use the library, [create a new project](https://docs.expo.dev/get-started/create-a-project/) and set up a [development build](https://docs.expo.dev/get-started/set-up-your-environment/?mode=development-build). A development build helps you iterate quickly and provides a complete development environment. After you've created the project, install the library:
 
-> ❗️ If you're planning on ejecting from Expo, upgrade your expo version _first_, THEN eject. It'll save you a whole lot of hassle. ❗️
-
-### 1. Add the library to the project
-
-```
-$ npm install react-native-purchases --save
-```
-
-or
-
-```
-$ yarn add react-native-purchases
-```
-
-### 2. Link library to the project
-
-```
-$ react-native link react-native-purchases
 ```
-
-### Additional iOS Setup
-
-#### If your project uses Cocoapods
-If your project already uses Cocoapods to install iOS dependencies, common in ExpoKit projects, linking the library should have added it to the podfile. If it hasn't, add the following to your project's podfile to reference the library from your node_modules folder:
-
-```ruby
-pod 'RNPurchases', :path => '../node_modules/react-native-purchases'
-    :inhibit_warnings => true
+$ npx expo install react-native-purchases
 ```
 
-In your `ios` folder, run `pod install`. If you've just upgraded ExpoKit, you might need to upgrade cocoapods to the newest version: `sudo gem install cocoapods`. 
-
-#### Migrating from manual installation (if your project doesn't use CocoapodsCreate)
-
-##### Remove the Framework Reference from your project
-
-1. Remove `Purchases.framework` and `PurchasesHybridCommon.framework` from the libraries section of the project. 
-
-##### Remove iOS Frameworks to Embedded Binaries
-1. In Xcode, in project manager, select your app target.
-1. Select the general tab
-1. Look for `Purchases.framework` and `PurchasesHybridCommon.framework` in the Embedded Binaries section and remove them.
-
-Remove `$(PROJECT_DIR)/../node_modules/react-native-purchases/ios` from Framework Search paths in build settings
-
-##### Remove Strip Frameworks Phase
-During the old manual installation instructions, now deprecated, we indicated to add a build phase to strip fat frameworks. 
-1. In Xcode, in project manager, select your app target.
-2. Open the `Build Phases` tab
-3. Remove the added `Strip Frameworks` phase
-4. Clean `Derived Data` 
-
-##### Link static library
-The `react-native link` command should have added the `libRNPurchases.a` library to the _Linked Frameworks and Libraries_ section of your app target. If it hasn't add it like this:
-
-![](https://media.giphy.com/media/U2MMgrdYlkRhEcy80J/giphy.gif)
+### Bare workflow
+If you are using [bare workflow](https://docs.expo.dev/bare/overview/) (that is, your project is created using `react-native init`), [install `expo`](https://docs.expo.dev/bare/installing-expo-modules/) into your project and [leverage Expo CLI](https://docs.expo.dev/bare/using-expo-cli/) to use Expo tooling and services.

package/RNPurchases.podspec

@@ -10,7 +10,7 @@ Pod::Spec.new do |spec|
   spec.authors      = package['author']
   spec.homepage     = "https://github.com/RevenueCat/react-native-purchases"
   spec.license      = package['license']
-  spec.platforms     = {:ios => "11.0", :tvos => "11.0"}
+  spec.platforms     = {:ios => "13.0", :tvos => "13.0"}
 
   spec.source       = { :git => "https://github.com/RevenueCat/react-native-purchases.git" }
   spec.source_files = "ios/**/*.{h,m,swift}"
@@ -25,6 +25,6 @@ Pod::Spec.new do |spec|
   ]
 
   spec.dependency   "React-Core"
-  spec.dependency   "PurchasesHybridCommon", '11.1.1'
+  spec.dependency   "PurchasesHybridCommon", '13.0.0'
   spec.swift_version    = '5.7'
 end

package/android/build.gradle

@@ -29,7 +29,7 @@ android {
         minSdkVersion getExtOrIntegerDefault('minSdkVersion')
         targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
         versionCode 1
-        versionName '7.28.1'
+        versionName '8.0.0'
     }
 
     buildTypes {
@@ -121,6 +121,6 @@ def kotlin_version = getExtOrDefault('kotlinVersion')
 dependencies {
     //noinspection GradleDynamicVersion
     api 'com.facebook.react:react-native:+'
-    implementation 'com.revenuecat.purchases:purchases-hybrid-common:11.1.1'
+    implementation 'com.revenuecat.purchases:purchases-hybrid-common:13.0.0'
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
 }

package/android/gradle.properties

@@ -1,5 +1,5 @@
 android.useAndroidX=true
-Purchases_kotlinVersion=1.7.21
-Purchases_compileSdkVersion=28
-Purchases_targetSdkVersion=28
-Purchases_minSdkVersion=19
+Purchases_kotlinVersion=1.8.22
+Purchases_compileSdkVersion=34
+Purchases_targetSdkVersion=34
+Purchases_minSdkVersion=21

package/android/src/main/java/com/revenuecat/purchases/react/RNPurchasesModule.java

@@ -47,7 +47,7 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
     private static final String CUSTOMER_INFO_UPDATED = "Purchases-CustomerInfoUpdated";
     private static final String LOG_HANDLER_EVENT = "Purchases-LogHandlerEvent";
     public static final String PLATFORM_NAME = "react-native";
-    public static final String PLUGIN_VERSION = "7.28.1";
+    public static final String PLUGIN_VERSION = "8.0.0";
 
     private final ReactApplicationContext reactContext;
 
@@ -83,10 +83,11 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
 
     @ReactMethod
     public void setupPurchases(String apiKey, @Nullable String appUserID,
-                               boolean observerMode, @Nullable String userDefaultsSuiteName,
-                               @Nullable Boolean usesStoreKit2IfAvailable, boolean useAmazon,
+                               @Nullable String purchasesAreCompletedBy, @Nullable String userDefaultsSuiteName,
+                               @Nullable String storeKitVersion, boolean useAmazon,
                                boolean shouldShowInAppMessagesAutomatically,
-                               @Nullable String entitlementVerificationMode) {
+                               @Nullable String entitlementVerificationMode,
+                               boolean pendingTransactionsForPrepaidPlansEnabled) {
         PlatformInfo platformInfo = new PlatformInfo(PLATFORM_NAME, PLUGIN_VERSION);
         Store store = Store.PLAY_STORE;
         if (useAmazon) {
@@ -96,12 +97,13 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
             reactContext,
             apiKey,
             appUserID,
-            observerMode ? PurchasesAreCompletedBy.MY_APP : PurchasesAreCompletedBy.REVENUECAT,
+            purchasesAreCompletedBy,
             platformInfo,
             store,
             new DangerousSettings(),
             shouldShowInAppMessagesAutomatically,
-            entitlementVerificationMode
+            entitlementVerificationMode,
+            pendingTransactionsForPrepaidPlansEnabled
         );
         Purchases.getSharedInstance().setUpdatedCustomerInfoListener(this);
     }
@@ -275,12 +277,6 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
         CommonKt.getCustomerInfo(getOnResult(promise));
     }
 
-    @ReactMethod
-    public void setFinishTransactions(boolean enabled) {
-        CommonKt.setPurchasesAreCompletedBy(enabled ?
-          PurchasesAreCompletedBy.REVENUECAT : PurchasesAreCompletedBy.MY_APP);
-    }
-
     @ReactMethod
     public void syncPurchases() {
         CommonKt.syncPurchases();
@@ -463,14 +459,23 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
     }
 
     @ReactMethod
-    public void syncObserverModeAmazonPurchase(String productID, String receiptID,
+    public void syncAmazonPurchase(String productID, String receiptID,
                                                String amazonUserID, String isoCurrencyCode,
                                                Double price, final Promise promise) {
-      Purchases.getSharedInstance().syncObserverModeAmazonPurchase(productID, receiptID,
+      Purchases.getSharedInstance().syncAmazonPurchase(productID, receiptID,
         amazonUserID, isoCurrencyCode, price);
       promise.resolve(null);
     }
 
+    @ReactMethod
+    @Deprecated // Use syncAmazonPurchase instead
+    public void syncObserverModeAmazonPurchase(String productID, String receiptID,
+                                            String amazonUserID, String isoCurrencyCode,
+                                            Double price, final Promise promise) {
+        syncAmazonPurchase(productID, receiptID, amazonUserID, isoCurrencyCode, price, promise);
+    }
+
+
     @ReactMethod
     public void showInAppMessages(ReadableArray messageTypes, final Promise promise) {
         if (messageTypes == null) {

package/dist/purchases.d.ts

@@ -1,5 +1,5 @@
-import { PURCHASES_ERROR_CODE, UninitializedPurchasesError, UnsupportedPlatformError, CustomerInfo, PurchasesEntitlementInfo, PRORATION_MODE, PACKAGE_TYPE, INTRO_ELIGIBILITY_STATUS, PurchasesOfferings, PurchasesStoreProduct, UpgradeInfo, PurchasesPromotionalOffer, PurchasesPackage, IntroEligibility, PurchasesStoreProductDiscount, SubscriptionOption, PRODUCT_CATEGORY, GoogleProductChangeInfo, PURCHASE_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, IN_APP_MESSAGE_TYPE, ENTITLEMENT_VERIFICATION_MODE, VERIFICATION_RESULT, PurchasesOffering } from "@revenuecat/purchases-typescript-internal";
-export { PURCHASE_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, } from "@revenuecat/purchases-typescript-internal";
+import { PURCHASES_ERROR_CODE, UninitializedPurchasesError, UnsupportedPlatformError, CustomerInfo, PurchasesEntitlementInfo, PRORATION_MODE, PACKAGE_TYPE, INTRO_ELIGIBILITY_STATUS, PurchasesOfferings, PurchasesStoreProduct, UpgradeInfo, PurchasesPromotionalOffer, PurchasesPackage, IntroEligibility, PurchasesStoreProductDiscount, SubscriptionOption, PRODUCT_CATEGORY, GoogleProductChangeInfo, PURCHASE_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, IN_APP_MESSAGE_TYPE, ENTITLEMENT_VERIFICATION_MODE, VERIFICATION_RESULT, STOREKIT_VERSION, PurchasesStoreTransaction, PurchasesOffering, PURCHASES_ARE_COMPLETED_BY_TYPE } from "@revenuecat/purchases-typescript-internal";
+export { PURCHASE_TYPE, PurchasesAreCompletedBy, PurchasesAreCompletedByMyApp, PURCHASES_ARE_COMPLETED_BY_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, STOREKIT_VERSION, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, } from "@revenuecat/purchases-typescript-internal";
 export default class Purchases {
     /**
      * Supported SKU types.
@@ -76,6 +76,18 @@ export default class Purchases {
      * @enum {string}
      */
     static VERIFICATION_RESULT: typeof VERIFICATION_RESULT;
+    /**
+     * Enum of StoreKit version.
+     * @readonly
+     * @enum {string}
+     */
+    static STOREKIT_VERSION: typeof STOREKIT_VERSION;
+    /**
+     * Enum of PurchasesAreCompletedByType.
+     * @readonly
+     * @enum {string}
+     */
+    static PURCHASES_ARE_COMPLETED_BY_TYPE: typeof PURCHASES_ARE_COMPLETED_BY_TYPE;
     /**
      * @internal
      */
@@ -88,16 +100,18 @@ export default class Purchases {
      * Sets up Purchases with your API key and an app user id.
      * @param {String} apiKey RevenueCat API Key. Needs to be a String
      * @param {String?} appUserID An optional unique id for identifying the user. Needs to be a string.
-     * @param {boolean} [observerMode=false] An optional boolean. Set this to TRUE if you have your own IAP implementation and want to use only RevenueCat's backend. Default is FALSE.
-     * @param {boolean} [usesStoreKit2IfAvailable=false] DEPRECATED. An optional boolean. iOS-only. Defaults to FALSE. Setting this to TRUE will enable StoreKit2 on compatible devices.
-     * We recommend not using this parameter, letting RevenueCat decide for you which StoreKit implementation to use.
+     * @param {PurchasesAreCompletedBy} [purchasesAreCompletedBy=PURCHASES_ARE_COMPLETED_BY_TYPE.REVENUECAT] Set this to an instance of PurchasesAreCompletedByMyApp if you have your own IAP implementation and want to use only RevenueCat's backend. Default is PURCHASES_ARE_COMPLETED_BY_TYPE.REVENUECAT.
+     * @param {STOREKIT_VERSION} [storeKitVersion=DEFAULT] iOS-only. Defaults to STOREKIT_2. StoreKit 2 is only available on iOS 16+. StoreKit 1 will be used for previous iOS versions regardless of this setting.
      * @param {ENTITLEMENT_VERIFICATION_MODE} [entitlementVerificationMode=ENTITLEMENT_VERIFICATION_MODE.DISABLED] Sets the entitlement verifciation mode to use. For more details, check https://rev.cat/trusted-entitlements
      * @param {boolean} [useAmazon=false] An optional boolean. Android-only. Set this to TRUE to enable Amazon on compatible devices.
      * @param {String?} userDefaultsSuiteName An optional string. iOS-only, will be ignored for Android.
      * Set this if you would like the RevenueCat SDK to store its preferences in a different NSUserDefaults suite, otherwise it will use standardUserDefaults.
      * Default is null, which will make the SDK use standardUserDefaults.
+     * @param {boolean} [pendingTransactionsForPrepaidPlansEnabled=false] An optional boolean. Android-only. Set this to TRUE to enable pending transactions for prepaid subscriptions in Google Play.
+     *
+     * @warning If you use purchasesAreCompletedBy=PurchasesAreCompletedByMyApp, you must also provide a value for storeKitVersion.
      */
-    static configure({ apiKey, appUserID, observerMode, userDefaultsSuiteName, usesStoreKit2IfAvailable, useAmazon, shouldShowInAppMessagesAutomatically, entitlementVerificationMode, }: PurchasesConfiguration): void;
+    static configure({ apiKey, appUserID, purchasesAreCompletedBy, userDefaultsSuiteName, storeKitVersion, useAmazon, shouldShowInAppMessagesAutomatically, entitlementVerificationMode, pendingTransactionsForPrepaidPlansEnabled, }: PurchasesConfiguration): void;
     /**
      * @deprecated, configure behavior through the RevenueCat dashboard instead.
      * If an user tries to purchase a product that is active on the current app store account,
@@ -107,12 +121,6 @@ export default class Purchases {
      * @returns {Promise<void>} The promise will be rejected if configure has not been called yet.
      */
     static setAllowSharingStoreAccount(allowSharing: boolean): Promise<void>;
-    /**
-     * @param {boolean} finishTransactions Set finishTransactions to false if you aren't using Purchases SDK to
-     * make the purchase
-     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet.
-     */
-    static setFinishTransactions(finishTransactions: boolean): Promise<void>;
     /**
      * iOS only.
      * @param {boolean} simulatesAskToBuyInSandbox Set this property to true *only* when testing the ask-to-buy / SCA
@@ -338,14 +346,40 @@ export default class Purchases {
      * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or if there's an error
      * syncing purchases.
      */
+    static syncAmazonPurchase(productID: string, receiptID: string, amazonUserID: string, isoCurrencyCode?: string | null, price?: number | null): Promise<void>;
+    /**
+     * @deprecated, use syncAmazonPurchase instead.
+     *
+     * This method will send a purchase to the RevenueCat backend. This function should only be called if you are
+     * in Amazon observer mode or performing a client side migration of your current users to RevenueCat.
+     *
+     * The receipt IDs are cached if successfully posted so they are not posted more than once.
+     *
+     * @param {string} productID Product ID associated to the purchase.
+     * @param {string} receiptID ReceiptId that represents the Amazon purchase.
+     * @param {string} amazonUserID Amazon's userID. This parameter will be ignored when syncing a Google purchase.
+     * @param {(string|null|undefined)} isoCurrencyCode Product's currency code in ISO 4217 format.
+     * @param {(number|null|undefined)} price Product's price.
+     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or if there's an error
+     * syncing purchases.
+     */
     static syncObserverModeAmazonPurchase(productID: string, receiptID: string, amazonUserID: string, isoCurrencyCode?: string | null, price?: number | null): Promise<void>;
     /**
-     * @deprecated, use enableAdServicesAttributionTokenCollection instead.
-     * Enable automatic collection of Apple Search Ad attribution. Disabled by default
-     * @param {boolean} enabled Enable or not automatic apple search ads attribution collection
-     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet.
+     * iOS only. Always returns an error on iOS < 15.
+     *
+     * Use this method only if you already have your own IAP implementation using StoreKit 2 and want to use
+     * RevenueCat's backend. If you are using StoreKit 1 for your implementation, you do not need this method.
+     *
+     * You only need to use this method with *new* purchases. Subscription updates are observed automatically.
+     *
+     * Important: This should only be used if you have set PurchasesAreCompletedBy to MY_APP during SDK configuration.
+     *
+     * @warning You need to finish the transaction yourself after calling this method.
+     *
+     * @param {string} productID Product ID that was just purchased
+     * @returns {Promise<PurchasesStoreTransaction>} If there was a transacton found and handled for the provided product ID.
      */
-    static setAutomaticAppleSearchAdsAttributionCollection(enabled: boolean): Promise<void>;
+    static recordPurchase(productID: string): Promise<PurchasesStoreTransaction>;
     /**
      * Enable automatic collection of Apple Search Ad attribution on iOS. Disabled by default
      * @returns {Promise<void>} The promise will be rejected if configure has not been called yet.
@@ -666,5 +700,6 @@ export default class Purchases {
     private static throwIfNotConfigured;
     private static throwIfAndroidPlatform;
     private static throwIfIOSPlatform;
+    private static isPurchasesAreCompletedByMyApp;
     private static convertIntToRefundRequestStatus;
 }

package/dist/purchases.js

@@ -36,15 +36,17 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOG_LEVEL = exports.REFUND_REQUEST_STATUS = exports.BILLING_FEATURE = exports.PURCHASE_TYPE = void 0;
+exports.STOREKIT_VERSION = exports.LOG_LEVEL = exports.REFUND_REQUEST_STATUS = exports.BILLING_FEATURE = exports.PURCHASES_ARE_COMPLETED_BY_TYPE = exports.PURCHASE_TYPE = void 0;
 var react_native_1 = require("react-native");
 var purchases_typescript_internal_1 = require("@revenuecat/purchases-typescript-internal");
 // This export is kept to keep backwards compatibility to any possible users using this file directly
 var purchases_typescript_internal_2 = require("@revenuecat/purchases-typescript-internal");
 Object.defineProperty(exports, "PURCHASE_TYPE", { enumerable: true, get: function () { return purchases_typescript_internal_2.PURCHASE_TYPE; } });
+Object.defineProperty(exports, "PURCHASES_ARE_COMPLETED_BY_TYPE", { enumerable: true, get: function () { return purchases_typescript_internal_2.PURCHASES_ARE_COMPLETED_BY_TYPE; } });
 Object.defineProperty(exports, "BILLING_FEATURE", { enumerable: true, get: function () { return purchases_typescript_internal_2.BILLING_FEATURE; } });
 Object.defineProperty(exports, "REFUND_REQUEST_STATUS", { enumerable: true, get: function () { return purchases_typescript_internal_2.REFUND_REQUEST_STATUS; } });
 Object.defineProperty(exports, "LOG_LEVEL", { enumerable: true, get: function () { return purchases_typescript_internal_2.LOG_LEVEL; } });
+Object.defineProperty(exports, "STOREKIT_VERSION", { enumerable: true, get: function () { return purchases_typescript_internal_2.STOREKIT_VERSION; } });
 var react_native_2 = require("react-native");
 var RNPurchases = react_native_1.NativeModules.RNPurchases;
 var eventEmitter = new react_native_1.NativeEventEmitter(RNPurchases);
@@ -72,17 +74,19 @@ var Purchases = /** @class */ (function () {
      * Sets up Purchases with your API key and an app user id.
      * @param {String} apiKey RevenueCat API Key. Needs to be a String
      * @param {String?} appUserID An optional unique id for identifying the user. Needs to be a string.
-     * @param {boolean} [observerMode=false] An optional boolean. Set this to TRUE if you have your own IAP implementation and want to use only RevenueCat's backend. Default is FALSE.
-     * @param {boolean} [usesStoreKit2IfAvailable=false] DEPRECATED. An optional boolean. iOS-only. Defaults to FALSE. Setting this to TRUE will enable StoreKit2 on compatible devices.
-     * We recommend not using this parameter, letting RevenueCat decide for you which StoreKit implementation to use.
+     * @param {PurchasesAreCompletedBy} [purchasesAreCompletedBy=PURCHASES_ARE_COMPLETED_BY_TYPE.REVENUECAT] Set this to an instance of PurchasesAreCompletedByMyApp if you have your own IAP implementation and want to use only RevenueCat's backend. Default is PURCHASES_ARE_COMPLETED_BY_TYPE.REVENUECAT.
+     * @param {STOREKIT_VERSION} [storeKitVersion=DEFAULT] iOS-only. Defaults to STOREKIT_2. StoreKit 2 is only available on iOS 16+. StoreKit 1 will be used for previous iOS versions regardless of this setting.
      * @param {ENTITLEMENT_VERIFICATION_MODE} [entitlementVerificationMode=ENTITLEMENT_VERIFICATION_MODE.DISABLED] Sets the entitlement verifciation mode to use. For more details, check https://rev.cat/trusted-entitlements
      * @param {boolean} [useAmazon=false] An optional boolean. Android-only. Set this to TRUE to enable Amazon on compatible devices.
      * @param {String?} userDefaultsSuiteName An optional string. iOS-only, will be ignored for Android.
      * Set this if you would like the RevenueCat SDK to store its preferences in a different NSUserDefaults suite, otherwise it will use standardUserDefaults.
      * Default is null, which will make the SDK use standardUserDefaults.
+     * @param {boolean} [pendingTransactionsForPrepaidPlansEnabled=false] An optional boolean. Android-only. Set this to TRUE to enable pending transactions for prepaid subscriptions in Google Play.
+     *
+     * @warning If you use purchasesAreCompletedBy=PurchasesAreCompletedByMyApp, you must also provide a value for storeKitVersion.
      */
     Purchases.configure = function (_a) {
-        var apiKey = _a.apiKey, _b = _a.appUserID, appUserID = _b === void 0 ? null : _b, _c = _a.observerMode, observerMode = _c === void 0 ? false : _c, userDefaultsSuiteName = _a.userDefaultsSuiteName, _d = _a.usesStoreKit2IfAvailable, usesStoreKit2IfAvailable = _d === void 0 ? false : _d, _e = _a.useAmazon, useAmazon = _e === void 0 ? false : _e, _f = _a.shouldShowInAppMessagesAutomatically, shouldShowInAppMessagesAutomatically = _f === void 0 ? true : _f, _g = _a.entitlementVerificationMode, entitlementVerificationMode = _g === void 0 ? purchases_typescript_internal_1.ENTITLEMENT_VERIFICATION_MODE.DISABLED : _g;
+        var apiKey = _a.apiKey, _b = _a.appUserID, appUserID = _b === void 0 ? null : _b, _c = _a.purchasesAreCompletedBy, purchasesAreCompletedBy = _c === void 0 ? purchases_typescript_internal_1.PURCHASES_ARE_COMPLETED_BY_TYPE.REVENUECAT : _c, userDefaultsSuiteName = _a.userDefaultsSuiteName, _d = _a.storeKitVersion, storeKitVersion = _d === void 0 ? purchases_typescript_internal_1.STOREKIT_VERSION.DEFAULT : _d, _e = _a.useAmazon, useAmazon = _e === void 0 ? false : _e, _f = _a.shouldShowInAppMessagesAutomatically, shouldShowInAppMessagesAutomatically = _f === void 0 ? true : _f, _g = _a.entitlementVerificationMode, entitlementVerificationMode = _g === void 0 ? purchases_typescript_internal_1.ENTITLEMENT_VERIFICATION_MODE.DISABLED : _g, _h = _a.pendingTransactionsForPrepaidPlansEnabled, pendingTransactionsForPrepaidPlansEnabled = _h === void 0 ? false : _h;
         if (apiKey === undefined || typeof apiKey !== "string") {
             throw new Error('Invalid API key. It must be called with an Object: configure({apiKey: "key"})');
         }
@@ -91,7 +95,20 @@ var Purchases = /** @class */ (function () {
             typeof appUserID !== "string") {
             throw new Error("appUserID needs to be a string");
         }
-        RNPurchases.setupPurchases(apiKey, appUserID, observerMode, userDefaultsSuiteName, usesStoreKit2IfAvailable, useAmazon, shouldShowInAppMessagesAutomatically, entitlementVerificationMode);
+        var purchasesCompletedByToUse = purchases_typescript_internal_1.PURCHASES_ARE_COMPLETED_BY_TYPE.REVENUECAT;
+        var storeKitVersionToUse = storeKitVersion;
+        if (Purchases.isPurchasesAreCompletedByMyApp(purchasesAreCompletedBy)) {
+            purchasesCompletedByToUse = purchases_typescript_internal_1.PURCHASES_ARE_COMPLETED_BY_TYPE.MY_APP;
+            storeKitVersionToUse = purchasesAreCompletedBy.storeKitVersion;
+            if (storeKitVersionToUse !== storeKitVersion) {
+                // Typically, console messages aren't used in TS libraries, but in this case it's worth calling out the difference in
+                // StoreKit versions, and since the difference isn't possible farther down the call chain, we should go ahead
+                // and log it here.
+                // tslint:disable-next-line:no-console
+                console.warn("Warning: The storeKitVersion in purchasesAreCompletedBy does not match the function's storeKitVersion parameter. We will use the value found in purchasesAreCompletedBy.");
+            }
+        }
+        RNPurchases.setupPurchases(apiKey, appUserID, purchasesCompletedByToUse, userDefaultsSuiteName, storeKitVersionToUse, useAmazon, shouldShowInAppMessagesAutomatically, entitlementVerificationMode, pendingTransactionsForPrepaidPlansEnabled);
     };
     /**
      * @deprecated, configure behavior through the RevenueCat dashboard instead.
@@ -114,24 +131,6 @@ var Purchases = /** @class */ (function () {
             });
         });
     };
-    /**
-     * @param {boolean} finishTransactions Set finishTransactions to false if you aren't using Purchases SDK to
-     * make the purchase
-     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet.
-     */
-    Purchases.setFinishTransactions = function (finishTransactions) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, Purchases.throwIfNotConfigured()];
-                    case 1:
-                        _a.sent();
-                        RNPurchases.setFinishTransactions(finishTransactions);
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
     /**
      * iOS only.
      * @param {boolean} simulatesAskToBuyInSandbox Set this property to true *only* when testing the ask-to-buy / SCA
@@ -263,9 +262,9 @@ var Purchases = /** @class */ (function () {
      * Rejections return an error code, and a userInfo object with more information. The promise will also be rejected
      * if configure has not been called yet.
      */
-    Purchases.getProducts = function (productIdentifiers, type) {
-        if (type === void 0) { type = purchases_typescript_internal_1.PRODUCT_CATEGORY.SUBSCRIPTION; }
-        return __awaiter(this, void 0, void 0, function () {
+    Purchases.getProducts = function (productIdentifiers_1) {
+        return __awaiter(this, arguments, void 0, function (productIdentifiers, type) {
+            if (type === void 0) { type = purchases_typescript_internal_1.PRODUCT_CATEGORY.SUBSCRIPTION; }
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0: return [4 /*yield*/, Purchases.throwIfNotConfigured()];
@@ -285,9 +284,9 @@ var Purchases = /** @class */ (function () {
      * @param {String} type Optional type of product, can be inapp or subs. Subs by default
      * @deprecated, use purchaseStoreProduct instead
      */
-    Purchases.purchaseProduct = function (productIdentifier, upgradeInfo, type) {
-        if (type === void 0) { type = purchases_typescript_internal_1.PURCHASE_TYPE.SUBS; }
-        return __awaiter(this, void 0, void 0, function () {
+    Purchases.purchaseProduct = function (productIdentifier_1, upgradeInfo_1) {
+        return __awaiter(this, arguments, void 0, function (productIdentifier, upgradeInfo, type) {
+            if (type === void 0) { type = purchases_typescript_internal_1.PURCHASE_TYPE.SUBS; }
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0: return [4 /*yield*/, Purchases.throwIfNotConfigured()];
@@ -628,6 +627,38 @@ var Purchases = /** @class */ (function () {
      * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or if there's an error
      * syncing purchases.
      */
+    Purchases.syncAmazonPurchase = function (productID, receiptID, amazonUserID, isoCurrencyCode, price) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, Purchases.throwIfIOSPlatform()];
+                    case 1:
+                        _a.sent();
+                        return [4 /*yield*/, Purchases.throwIfNotConfigured()];
+                    case 2:
+                        _a.sent();
+                        RNPurchases.syncAmazonPurchase(productID, receiptID, amazonUserID, isoCurrencyCode, price);
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * @deprecated, use syncAmazonPurchase instead.
+     *
+     * This method will send a purchase to the RevenueCat backend. This function should only be called if you are
+     * in Amazon observer mode or performing a client side migration of your current users to RevenueCat.
+     *
+     * The receipt IDs are cached if successfully posted so they are not posted more than once.
+     *
+     * @param {string} productID Product ID associated to the purchase.
+     * @param {string} receiptID ReceiptId that represents the Amazon purchase.
+     * @param {string} amazonUserID Amazon's userID. This parameter will be ignored when syncing a Google purchase.
+     * @param {(string|null|undefined)} isoCurrencyCode Product's currency code in ISO 4217 format.
+     * @param {(number|null|undefined)} price Product's price.
+     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or if there's an error
+     * syncing purchases.
+     */
     Purchases.syncObserverModeAmazonPurchase = function (productID, receiptID, amazonUserID, isoCurrencyCode, price) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -645,18 +676,32 @@ var Purchases = /** @class */ (function () {
         });
     };
     /**
-     * @deprecated, use enableAdServicesAttributionTokenCollection instead.
-     * Enable automatic collection of Apple Search Ad attribution. Disabled by default
-     * @param {boolean} enabled Enable or not automatic apple search ads attribution collection
-     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet.
+     * iOS only. Always returns an error on iOS < 15.
+     *
+     * Use this method only if you already have your own IAP implementation using StoreKit 2 and want to use
+     * RevenueCat's backend. If you are using StoreKit 1 for your implementation, you do not need this method.
+     *
+     * You only need to use this method with *new* purchases. Subscription updates are observed automatically.
+     *
+     * Important: This should only be used if you have set PurchasesAreCompletedBy to MY_APP during SDK configuration.
+     *
+     * @warning You need to finish the transaction yourself after calling this method.
+     *
+     * @param {string} productID Product ID that was just purchased
+     * @returns {Promise<PurchasesStoreTransaction>} If there was a transacton found and handled for the provided product ID.
      */
-    Purchases.setAutomaticAppleSearchAdsAttributionCollection = function (enabled) {
+    Purchases.recordPurchase = function (productID) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                if (react_native_2.Platform.OS === "ios") {
-                    RNPurchases.setAutomaticAppleSearchAdsAttributionCollection(enabled);
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, Purchases.throwIfAndroidPlatform()];
+                    case 1:
+                        _a.sent();
+                        return [4 /*yield*/, Purchases.throwIfNotConfigured()];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/, RNPurchases.recordPurchaseForProductID(productID)];
                 }
-                return [2 /*return*/];
             });
         });
     };
@@ -1427,6 +1472,12 @@ var Purchases = /** @class */ (function () {
             });
         });
     };
+    Purchases.isPurchasesAreCompletedByMyApp = function (obj) {
+        return (typeof obj === "object" &&
+            obj !== null &&
+            obj.type ===
+                purchases_typescript_internal_1.PURCHASES_ARE_COMPLETED_BY_TYPE.MY_APP);
+    };
     Purchases.convertIntToRefundRequestStatus = function (refundRequestStatusInt) {
         switch (refundRequestStatusInt) {
             case 0:
@@ -1512,6 +1563,18 @@ var Purchases = /** @class */ (function () {
      * @enum {string}
      */
     Purchases.VERIFICATION_RESULT = purchases_typescript_internal_1.VERIFICATION_RESULT;
+    /**
+     * Enum of StoreKit version.
+     * @readonly
+     * @enum {string}
+     */
+    Purchases.STOREKIT_VERSION = purchases_typescript_internal_1.STOREKIT_VERSION;
+    /**
+     * Enum of PurchasesAreCompletedByType.
+     * @readonly
+     * @enum {string}
+     */
+    Purchases.PURCHASES_ARE_COMPLETED_BY_TYPE = purchases_typescript_internal_1.PURCHASES_ARE_COMPLETED_BY_TYPE;
     /**
      * @internal
      */

package/ios/RNPurchases.m

@@ -39,19 +39,20 @@ RCT_EXPORT_MODULE();
 
 RCT_EXPORT_METHOD(setupPurchases:(NSString *)apiKey
                   appUserID:(nullable NSString *)appUserID
-                  observerMode:(BOOL)observerMode
+                  purchasesAreCompletedBy:(nullable NSString *)purchasesAreCompletedBy
                   userDefaultsSuiteName:(nullable NSString *)userDefaultsSuiteName
-                  usesStoreKit2IfAvailable:(BOOL)usesStoreKit2IfAvailable
+                  storeKitVersion:(nullable NSString *)storeKitVersion
                   useAmazon:(BOOL)useAmazon
                   shouldShowInAppMessagesAutomatically:(BOOL)shouldShowInAppMessagesAutomatically
-                  entitlementVerificationMode:(nullable NSString *)entitlementVerificationMode) {
+                  entitlementVerificationMode:(nullable NSString *)entitlementVerificationMode
+                  pendingTransactionsForPrepaidPlansEnabled:(BOOL)pendingTransactionsForPrepaidPlansEnabled) {
     RCPurchases *purchases = [RCPurchases configureWithAPIKey:apiKey
                                                     appUserID:appUserID
-                                      purchasesAreCompletedBy:(observerMode ? RCPurchasesAreCompletedByMyApp : RCPurchasesAreCompletedByRevenueCat)
+                                      purchasesAreCompletedBy:purchasesAreCompletedBy
                                         userDefaultsSuiteName:userDefaultsSuiteName
                                                platformFlavor:self.platformFlavor
                                         platformFlavorVersion:self.platformFlavorVersion
-                                     usesStoreKit2IfAvailable:usesStoreKit2IfAvailable
+                                              storeKitVersion:storeKitVersion
                                             dangerousSettings:nil
                          shouldShowInAppMessagesAutomatically:shouldShowInAppMessagesAutomatically
                                              verificationMode:entitlementVerificationMode];
@@ -65,14 +66,6 @@ RCT_EXPORT_METHOD(setAllowSharingStoreAccount:(BOOL)allowSharingStoreAccount) {
 #pragma GCC diagnostic pop
 }
 
-RCT_EXPORT_METHOD(setFinishTransactions:(BOOL)finishTransactions) {
-    if (finishTransactions) {
-        [RCCommonFunctionality setPurchasesAreCompletedBy:RCPurchasesAreCompletedByRevenueCat];
-    } else {
-        [RCCommonFunctionality setPurchasesAreCompletedBy:RCPurchasesAreCompletedByMyApp];
-    }
-}
-
 RCT_REMAP_METHOD(getOfferings,
                  getOfferingsWithResolve:(RCTPromiseResolveBlock)resolve
                  reject:(RCTPromiseRejectBlock)reject) {
@@ -187,11 +180,6 @@ RCT_REMAP_METHOD(getCustomerInfo,
     [RCCommonFunctionality getCustomerInfoWithCompletionBlock:[self getResponseCompletionBlockWithResolve:resolve reject:reject]];
 }
 
-RCT_EXPORT_METHOD(setAutomaticAppleSearchAdsAttributionCollection:(BOOL)automaticAppleSearchAdsAttributionCollection)
-{
-    [RCCommonFunctionality setAutomaticAppleSearchAdsAttributionCollection:automaticAppleSearchAdsAttributionCollection];
-}
-
 RCT_EXPORT_METHOD(enableAdServicesAttributionTokenCollection)
 {
     #if !TARGET_OS_TV
@@ -445,6 +433,24 @@ RCT_EXPORT_METHOD(setLogHandler) {
     }];
 }
 
+#pragma mark -
+#pragma mark PurchasesAreCompletedBy Helper Functions
+RCT_EXPORT_METHOD(recordPurchaseForProductID:(nonnull NSString *)productID
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+    if (@available(iOS 15.0, *)) {
+        [RCCommonFunctionality recordPurchaseForProductID:productID
+                                               completion:[self getResponseCompletionBlockWithResolve:resolve
+                                                                                               reject:reject]];
+    } else {
+        NSString* description = @"Tried to handle transaction made by your app, but this functionality is only available on iOS 15.0 or greater.";
+        NSError* error = [[NSError alloc] initWithDomain: RCPurchasesErrorCodeDomain
+                                                    code: RCUnsupportedError
+                                                userInfo: @{NSLocalizedDescriptionKey : description}];
+        reject([NSString stringWithFormat:@"%ld", (long) error.code], [error localizedDescription], error);
+    }
+}
+
 #pragma mark -
 #pragma mark Delegate Methods
 - (void)purchases:(RCPurchases *)purchases receivedUpdatedCustomerInfo:(RCCustomerInfo *)customerInfo {
@@ -501,7 +507,7 @@ readyForPromotedProduct:(RCStoreProduct *)product
 }
 
 - (NSString *)platformFlavorVersion {
-    return @"7.28.1";
+    return @"8.0.0";
 }
 
 @end

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-purchases",
   "title": "React Native Purchases",
-  "version": "7.28.1",
+  "version": "8.0.0",
   "description": "React Native in-app purchases and subscriptions made easy. Supports iOS and Android. ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -100,6 +100,6 @@
     ]
   },
   "dependencies": {
-    "@revenuecat/purchases-typescript-internal": "11.1.1"
+    "@revenuecat/purchases-typescript-internal": "13.0.0"
   }
 }