react-native-purchases 8.0.0-beta.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.platform     = :ios, "13.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", '10.0.0-beta.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 '8.0.0-beta.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:9.8.0'
+    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

@@ -19,10 +19,12 @@ import com.facebook.react.modules.core.DeviceEventManagerModule;
 import com.revenuecat.purchases.CustomerInfo;
 import com.revenuecat.purchases.DangerousSettings;
 import com.revenuecat.purchases.Purchases;
+import com.revenuecat.purchases.PurchasesAreCompletedBy;
 import com.revenuecat.purchases.Store;
 import com.revenuecat.purchases.common.PlatformInfo;
 import com.revenuecat.purchases.hybridcommon.CommonKt;
 import com.revenuecat.purchases.hybridcommon.ErrorContainer;
+import com.revenuecat.purchases.hybridcommon.OnNullableResult;
 import com.revenuecat.purchases.hybridcommon.OnResult;
 import com.revenuecat.purchases.hybridcommon.OnResultAny;
 import com.revenuecat.purchases.hybridcommon.OnResultList;
@@ -45,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 = "8.0.0-beta.1";
+    public static final String PLUGIN_VERSION = "8.0.0";
 
     private final ReactApplicationContext reactContext;
 
@@ -81,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 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) {
@@ -94,12 +97,13 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
             reactContext,
             apiKey,
             appUserID,
-            observerMode,
+            purchasesAreCompletedBy,
             platformInfo,
             store,
             new DangerousSettings(),
             shouldShowInAppMessagesAutomatically,
-            entitlementVerificationMode
+            entitlementVerificationMode,
+            pendingTransactionsForPrepaidPlansEnabled
         );
         Purchases.getSharedInstance().setUpdatedCustomerInfoListener(this);
     }
@@ -114,6 +118,16 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
         CommonKt.getOfferings(getOnResult(promise));
     }
 
+    @ReactMethod
+    public void getCurrentOfferingForPlacement(String placementIdentifier, final Promise promise) {
+      CommonKt.getCurrentOfferingForPlacement(placementIdentifier, getOnNullableResult(promise));
+    }
+
+    @ReactMethod
+    public void syncAttributesAndOfferingsIfNeeded(final Promise promise) {
+        CommonKt.syncAttributesAndOfferingsIfNeeded(getOnResult(promise));
+    }
+
     @ReactMethod
     public void getProductInfo(ReadableArray productIDs, String type, final Promise promise) {
         ArrayList<String> productIDList = new ArrayList<>();
@@ -144,12 +158,17 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
                                 final String type,
                                 @Nullable final String discountTimestamp,
                                 @Nullable final ReadableMap googleInfo,
-                                @Nullable final String presentedOfferingIdentifier,
+                                @Nullable final ReadableMap presentedOfferingContext,
                                 final Promise promise) {
         GoogleUpgradeInfo googleUpgradeInfo = getUpgradeInfo(googleProductChangeInfo);
 
         Boolean googleIsPersonalized = googleInfo != null && googleInfo.hasKey("isPersonalizedPrice") ? googleInfo.getBoolean("isPersonalizedPrice") : null;
 
+        Map<String, Object> mapPresentedOfferingContext = null;
+        if (presentedOfferingContext != null) {
+            mapPresentedOfferingContext = presentedOfferingContext.toHashMap();
+        }
+
         CommonKt.purchaseProduct(
             getCurrentActivity(),
             productIdentifier,
@@ -158,13 +177,13 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
             googleUpgradeInfo.getOldProductIdentifier(),
             googleUpgradeInfo.getProrationMode(),
             googleIsPersonalized,
-            presentedOfferingIdentifier,
+            mapPresentedOfferingContext,
             getOnResult(promise));
     }
 
     @ReactMethod
     public void purchasePackage(final String packageIdentifier,
-                                final String offeringIdentifier,
+                                final ReadableMap presentedOfferingContext,
                                 @Nullable final ReadableMap googleProductChangeInfo,
                                 @Nullable final String discountTimestamp,
                                 @Nullable final ReadableMap googleInfo,
@@ -173,10 +192,12 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
 
         Boolean googleIsPersonalized = googleInfo != null && googleInfo.hasKey("isPersonalizedPrice") ? googleInfo.getBoolean("isPersonalizedPrice") : null;
 
+        Map<String, Object> mapPresentedOfferingContext = presentedOfferingContext.toHashMap();
+
         CommonKt.purchasePackage(
             getCurrentActivity(),
             packageIdentifier,
-            offeringIdentifier,
+            mapPresentedOfferingContext,
             googleUpgradeInfo.getOldProductIdentifier(),
             googleUpgradeInfo.getProrationMode(),
             googleIsPersonalized,
@@ -189,12 +210,17 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
                                            @Nullable final ReadableMap upgradeInfo,
                                            @Nullable final String discountTimestamp,
                                            @Nullable final ReadableMap googleInfo,
-                                           @Nullable final String presentedOfferingIdentifier,
+                                           @Nullable final ReadableMap presentedOfferingContext,
                                            final Promise promise) {
         GoogleUpgradeInfo googleUpgradeInfo = getUpgradeInfo(upgradeInfo);
 
         Boolean googleIsPersonalized = googleInfo != null && googleInfo.hasKey("isPersonalizedPrice") ? googleInfo.getBoolean("isPersonalizedPrice") : null;
 
+        Map<String, Object> mapPresentedOfferingContext = null;
+        if (presentedOfferingContext != null) {
+            mapPresentedOfferingContext = presentedOfferingContext.toHashMap();
+        }
+
         CommonKt.purchaseSubscriptionOption(
             getCurrentActivity(),
             productIdentifer,
@@ -202,7 +228,7 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
             googleUpgradeInfo.getOldProductIdentifier(),
             googleUpgradeInfo.getProrationMode(),
             googleIsPersonalized,
-            presentedOfferingIdentifier,
+            mapPresentedOfferingContext,
             getOnResult(promise));
     }
 
@@ -251,11 +277,6 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
         CommonKt.getCustomerInfo(getOnResult(promise));
     }
 
-    @ReactMethod
-    public void setFinishTransactions(boolean enabled) {
-        CommonKt.setFinishTransactions(enabled);
-    }
-
     @ReactMethod
     public void syncPurchases() {
         CommonKt.syncPurchases();
@@ -288,8 +309,9 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
     }
 
     @ReactMethod
-    public void setProxyURLString(String proxyURLString) {
+    public void setProxyURLString(String proxyURLString, Promise promise) {
         CommonKt.setProxyURLString(proxyURLString);
+        promise.resolve(null); // Resolve the promise with no value
     }
 
     @ReactMethod
@@ -437,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) {
@@ -491,6 +522,26 @@ public class RNPurchasesModule extends ReactContextBaseJavaModule implements Upd
         };
     }
 
+  @NotNull
+  private OnNullableResult getOnNullableResult(final Promise promise) {
+    return new OnNullableResult() {
+      @Override
+      public void onReceived(@Nullable Map<String, ?> map) {
+        if (map != null) {
+          promise.resolve(convertMapToWriteableMap(map));
+        } else {
+          promise.resolve(null);
+        }
+      }
+
+      @Override
+      public void onError(ErrorContainer errorContainer) {
+        promise.reject(errorContainer.getCode() + "", errorContainer.getMessage(),
+          convertMapToWriteableMap(errorContainer.getInfo()));
+      }
+    };
+  }
+
     private static GoogleUpgradeInfo getUpgradeInfo(ReadableMap upgradeInfo) {
         String googleOldProductId = null;
         Integer googleProrationMode = 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, STOREKIT_VERSION, PurchasesStoreTransaction } 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.
@@ -82,6 +82,12 @@ export default class Purchases {
      * @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
      */
@@ -94,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 {STOREKIT_VERSION} [storeKitVersion=STOREKIT_2] iOS-only. Defaults to STOREKIT_2. StoreKit 2 is only available on iOS 15+. StoreKit 1 will be used for previous iOS versions regardless of this setting.
-     * 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, storeKitVersion, 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,
@@ -113,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
@@ -160,6 +162,22 @@ export default class Purchases {
      * has not been called yet.
      */
     static getOfferings(): Promise<PurchasesOfferings>;
+    /**
+     * Retrieves a current offering for a placement identifier, use this to access offerings defined by targeting
+     * placements configured in the RevenueCat dashboard.
+     * @param {String} placementIdentifier The placement identifier to fetch a current offeringn for
+     * @returns {Promise<PurchasesOffering | null>} Promise of an optional offering. The promise will be rejected if configure
+     * has not been called yet.
+     */
+    static getCurrentOfferingForPlacement(placementIdentifier: string): Promise<PurchasesOffering | null>;
+    /**
+     * Syncs subscriber attributes and then fetches the configured offerings for this user. This method is intended to
+     * be called when using Targeting Rules with Custom Attributes. Any subscriber attributes should be set before
+     * calling this method to ensure the returned offerings are applied with the latest subscriber attributes.
+     * @returns {Promise<PurchasesOfferings>} Promise of entitlements structure. The promise will be rejected if configure
+     * has not been called yet.
+     */
+    static syncAttributesAndOfferingsIfNeeded(): Promise<PurchasesOfferings>;
     /**
      * Fetch the product info
      * @param {String[]} productIdentifiers Array of product identifiers
@@ -328,6 +346,23 @@ 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>;
     /**
      * iOS only. Always returns an error on iOS < 15.
@@ -337,21 +372,14 @@ export default class Purchases {
      *
      * You only need to use this method with *new* purchases. Subscription updates are observed automatically.
      *
-     * Important: This should only be used if you have enabled observer mode during SDK configuration.
+     * 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 handleObserverModeTransaction(productID: string): Promise<PurchasesStoreTransaction>;
-    /**
-     * @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.
-     */
-    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.
@@ -460,8 +488,7 @@ export default class Purchases {
     /**
      * Set this property to your proxy URL before configuring Purchases *only* if you've received a proxy key value
      * from your RevenueCat contact.
-     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or if there's an error
-     * setting the proxy url.
+     * @returns {Promise<void>} The promise to be returned after setting the proxy has been completed.
      */
     static setProxyURL(url: string): Promise<void>;
     /**
@@ -673,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,24 +74,41 @@ 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 {STOREKIT_VERSION} [storeKitVersion=STOREKIT_2] iOS-only. Defaults to STOREKIT_2. StoreKit 2 is only available on iOS 15+. StoreKit 1 will be used for previous iOS versions regardless of this setting.
-     * 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.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;
+        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\"})");
+            throw new Error('Invalid API key. It must be called with an Object: configure({apiKey: "key"})');
         }
-        if (appUserID !== null && typeof appUserID !== "undefined" && typeof appUserID !== "string") {
+        if (appUserID !== null &&
+            typeof appUserID !== "undefined" &&
+            typeof appUserID !== "string") {
             throw new Error("appUserID needs to be a string");
         }
-        RNPurchases.setupPurchases(apiKey, appUserID, observerMode, userDefaultsSuiteName, storeKitVersion, 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.
@@ -112,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
@@ -191,7 +192,8 @@ var Purchases = /** @class */ (function () {
      */
     Purchases.removeShouldPurchasePromoProductListener = function (listenerToRemove) {
         if (shouldPurchasePromoProductListeners.includes(listenerToRemove)) {
-            shouldPurchasePromoProductListeners = shouldPurchasePromoProductListeners.filter(function (listener) { return listenerToRemove !== listener; });
+            shouldPurchasePromoProductListeners =
+                shouldPurchasePromoProductListeners.filter(function (listener) { return listenerToRemove !== listener; });
             return true;
         }
         return false;
@@ -213,6 +215,44 @@ var Purchases = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Retrieves a current offering for a placement identifier, use this to access offerings defined by targeting
+     * placements configured in the RevenueCat dashboard.
+     * @param {String} placementIdentifier The placement identifier to fetch a current offeringn for
+     * @returns {Promise<PurchasesOffering | null>} Promise of an optional offering. The promise will be rejected if configure
+     * has not been called yet.
+     */
+    Purchases.getCurrentOfferingForPlacement = function (placementIdentifier) {
+        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();
+                        return [2 /*return*/, RNPurchases.getCurrentOfferingForPlacement(placementIdentifier)];
+                }
+            });
+        });
+    };
+    /**
+     * Syncs subscriber attributes and then fetches the configured offerings for this user. This method is intended to
+     * be called when using Targeting Rules with Custom Attributes. Any subscriber attributes should be set before
+     * calling this method to ensure the returned offerings are applied with the latest subscriber attributes.
+     * @returns {Promise<PurchasesOfferings>} Promise of entitlements structure. The promise will be rejected if configure
+     * has not been called yet.
+     */
+    Purchases.syncAttributesAndOfferingsIfNeeded = function () {
+        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();
+                        return [2 /*return*/, RNPurchases.syncAttributesAndOfferingsIfNeeded()];
+                }
+            });
+        });
+    };
     /**
      * Fetch the product info
      * @param {String[]} productIdentifiers Array of product identifiers
@@ -222,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()];
@@ -244,16 +284,17 @@ 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()];
                     case 1:
                         _a.sent();
                         return [2 /*return*/, RNPurchases.purchaseProduct(productIdentifier, upgradeInfo, type, null, null, null).catch(function (error) {
-                                error.userCancelled = error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+                                error.userCancelled =
+                                    error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
                                 throw error;
                             })];
                 }
@@ -281,8 +322,11 @@ var Purchases = /** @class */ (function () {
                     case 0: return [4 /*yield*/, Purchases.throwIfNotConfigured()];
                     case 1:
                         _a.sent();
-                        return [2 /*return*/, RNPurchases.purchaseProduct(product.identifier, googleProductChangeInfo, product.productCategory, null, googleIsPersonalizedPrice == null ? null : { isPersonalizedPrice: googleIsPersonalizedPrice }, product.presentedOfferingIdentifier).catch(function (error) {
-                                error.userCancelled = error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+                        return [2 /*return*/, RNPurchases.purchaseProduct(product.identifier, googleProductChangeInfo, product.productCategory, null, googleIsPersonalizedPrice == null
+                                ? null
+                                : { isPersonalizedPrice: googleIsPersonalizedPrice }, product.presentedOfferingContext).catch(function (error) {
+                                error.userCancelled =
+                                    error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
                                 throw error;
                             })];
                 }
@@ -312,8 +356,9 @@ var Purchases = /** @class */ (function () {
                         if (typeof discount === "undefined" || discount == null) {
                             throw new Error("A discount is required");
                         }
-                        return [2 /*return*/, RNPurchases.purchaseProduct(product.identifier, null, null, discount.timestamp.toString(), null, product.presentedOfferingIdentifier).catch(function (error) {
-                                error.userCancelled = error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+                        return [2 /*return*/, RNPurchases.purchaseProduct(product.identifier, null, null, discount.timestamp.toString(), null, product.presentedOfferingContext).catch(function (error) {
+                                error.userCancelled =
+                                    error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
                                 throw error;
                             })];
                 }
@@ -342,8 +387,11 @@ var Purchases = /** @class */ (function () {
                     case 0: return [4 /*yield*/, Purchases.throwIfNotConfigured()];
                     case 1:
                         _a.sent();
-                        return [2 /*return*/, RNPurchases.purchasePackage(aPackage.identifier, aPackage.offeringIdentifier, googleProductChangeInfo || upgradeInfo, null, googleIsPersonalizedPrice == null ? null : { isPersonalizedPrice: googleIsPersonalizedPrice }).catch(function (error) {
-                                error.userCancelled = error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+                        return [2 /*return*/, RNPurchases.purchasePackage(aPackage.identifier, aPackage.presentedOfferingContext, googleProductChangeInfo || upgradeInfo, null, googleIsPersonalizedPrice == null
+                                ? null
+                                : { isPersonalizedPrice: googleIsPersonalizedPrice }).catch(function (error) {
+                                error.userCancelled =
+                                    error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
                                 throw error;
                             })];
                 }
@@ -374,8 +422,11 @@ var Purchases = /** @class */ (function () {
                         return [4 /*yield*/, Purchases.throwIfIOSPlatform()];
                     case 2:
                         _a.sent();
-                        return [2 /*return*/, RNPurchases.purchaseSubscriptionOption(subscriptionOption.productId, subscriptionOption.id, googleProductChangeInfo, null, googleIsPersonalizedPrice == null ? null : { isPersonalizedPrice: googleIsPersonalizedPrice }, subscriptionOption.presentedOfferingIdentifier).catch(function (error) {
-                                error.userCancelled = error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+                        return [2 /*return*/, RNPurchases.purchaseSubscriptionOption(subscriptionOption.productId, subscriptionOption.id, googleProductChangeInfo, null, googleIsPersonalizedPrice == null
+                                ? null
+                                : { isPersonalizedPrice: googleIsPersonalizedPrice }, subscriptionOption.presentedOfferingContext).catch(function (error) {
+                                error.userCancelled =
+                                    error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
                                 throw error;
                             })];
                 }
@@ -402,8 +453,9 @@ var Purchases = /** @class */ (function () {
                         if (typeof discount === "undefined" || discount == null) {
                             throw new Error("A discount is required");
                         }
-                        return [2 /*return*/, RNPurchases.purchasePackage(aPackage.identifier, aPackage.offeringIdentifier, null, discount.timestamp.toString(), null).catch(function (error) {
-                                error.userCancelled = error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+                        return [2 /*return*/, RNPurchases.purchasePackage(aPackage.identifier, aPackage.presentedOfferingContext, null, discount.timestamp.toString(), null).catch(function (error) {
+                                error.userCancelled =
+                                    error.code === purchases_typescript_internal_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
                                 throw error;
                             })];
                 }
@@ -575,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) {
@@ -599,14 +683,14 @@ var Purchases = /** @class */ (function () {
      *
      * You only need to use this method with *new* purchases. Subscription updates are observed automatically.
      *
-     * Important: This should only be used if you have enabled observer mode during SDK configuration.
+     * 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.handleObserverModeTransaction = function (productID) {
+    Purchases.recordPurchase = function (productID) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
@@ -616,24 +700,8 @@ var Purchases = /** @class */ (function () {
                         return [4 /*yield*/, Purchases.throwIfNotConfigured()];
                     case 2:
                         _a.sent();
-                        return [2 /*return*/, RNPurchases.handleObserverModeTransactionForProductID(productID)];
-                }
-            });
-        });
-    };
-    /**
-     * @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.
-     */
-    Purchases.setAutomaticAppleSearchAdsAttributionCollection = function (enabled) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                if (react_native_2.Platform.OS === "ios") {
-                    RNPurchases.setAutomaticAppleSearchAdsAttributionCollection(enabled);
+                        return [2 /*return*/, RNPurchases.recordPurchaseForProductID(productID)];
                 }
-                return [2 /*return*/];
             });
         });
     };
@@ -882,19 +950,12 @@ var Purchases = /** @class */ (function () {
     /**
      * Set this property to your proxy URL before configuring Purchases *only* if you've received a proxy key value
      * from your RevenueCat contact.
-     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or if there's an error
-     * setting the proxy url.
+     * @returns {Promise<void>} The promise to be returned after setting the proxy has been completed.
      */
     Purchases.setProxyURL = function (url) {
         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.setProxyURLString(url);
-                        return [2 /*return*/];
-                }
+                return [2 /*return*/, RNPurchases.setProxyURLString(url)];
             });
         });
     };
@@ -1411,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:
@@ -1502,6 +1569,12 @@ var Purchases = /** @class */ (function () {
      * @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,15 +39,16 @@ RCT_EXPORT_MODULE();
 
 RCT_EXPORT_METHOD(setupPurchases:(NSString *)apiKey
                   appUserID:(nullable NSString *)appUserID
-                  observerMode:(BOOL)observerMode
+                  purchasesAreCompletedBy:(nullable NSString *)purchasesAreCompletedBy
                   userDefaultsSuiteName:(nullable NSString *)userDefaultsSuiteName
                   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
-                                                 observerMode:observerMode
+                                      purchasesAreCompletedBy:purchasesAreCompletedBy
                                         userDefaultsSuiteName:userDefaultsSuiteName
                                                platformFlavor:self.platformFlavor
                                         platformFlavorVersion:self.platformFlavorVersion
@@ -65,10 +66,6 @@ RCT_EXPORT_METHOD(setAllowSharingStoreAccount:(BOOL)allowSharingStoreAccount) {
 #pragma GCC diagnostic pop
 }
 
-RCT_EXPORT_METHOD(setFinishTransactions:(BOOL)finishTransactions) {
-    [RCCommonFunctionality setFinishTransactions:finishTransactions];
-}
-
 RCT_REMAP_METHOD(getOfferings,
                  getOfferingsWithResolve:(RCTPromiseResolveBlock)resolve
                  reject:(RCTPromiseRejectBlock)reject) {
@@ -76,6 +73,24 @@ RCT_REMAP_METHOD(getOfferings,
                                                                                                 reject:reject]];
 }
 
+RCT_REMAP_METHOD(syncAttributesAndOfferingsIfNeeded,
+                 syncAttributesAndOfferingsIfNeededWithResolve:(RCTPromiseResolveBlock)resolve
+                 reject:(RCTPromiseRejectBlock)reject) {
+    [RCCommonFunctionality syncAttributesAndOfferingsIfNeededWithCompletionBlock:[self getResponseCompletionBlockWithResolve:resolve
+                                                                                                reject:reject]];
+}
+
+RCT_EXPORT_METHOD(getCurrentOfferingForPlacement:(NSString *)placementIdentifier
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject) {
+
+    [RCCommonFunctionality getCurrentOfferingForPlacement:placementIdentifier completionBlock:^(NSDictionary *offeringObject, RCErrorContainer *error) {
+        resolve(offeringObject);
+    }];
+}
+
+//syncAttributesAndOfferingsIfNeeded
+
 RCT_EXPORT_METHOD(getProductInfo:(NSArray *)products
                   type:(NSString *)type
                   resolve:(RCTPromiseResolveBlock)resolve
@@ -91,7 +106,7 @@ RCT_REMAP_METHOD(purchaseProduct,
                  type:(NSString *)type
                  signedDiscountTimestamp:(NSString *)signedDiscountTimestamp
                  googleInfo:(NSDictionary *)googleInfo
-                 presentedOfferingIdentifier:(NSString *)presentedOfferingIdentifier
+                 presentedOfferingContext:(NSDictionary *)presentedOfferingDictionary
                  resolve:(RCTPromiseResolveBlock)resolve
                  reject:(RCTPromiseRejectBlock)reject) {
     [RCCommonFunctionality purchaseProduct:productIdentifier
@@ -102,14 +117,14 @@ RCT_REMAP_METHOD(purchaseProduct,
 
 RCT_REMAP_METHOD(purchasePackage,
                  purchasePackage:(NSString *)packageIdentifier
-                 offeringIdentifier:(NSString *)offeringIdentifier
+                 presentedOfferingContext:(NSDictionary *)presentedOfferingContext
                  upgradeInfo:(NSDictionary *)upgradeInfo
                  signedDiscountTimestamp:(NSString *)signedDiscountTimestamp
                  googleInfo:(NSDictionary *)googleInfo
                  resolve:(RCTPromiseResolveBlock)resolve
                  reject:(RCTPromiseRejectBlock)reject) {
     [RCCommonFunctionality purchasePackage:packageIdentifier
-                                  offering:offeringIdentifier
+                  presentedOfferingContext:presentedOfferingContext
                    signedDiscountTimestamp:signedDiscountTimestamp
                            completionBlock:[self getResponseCompletionBlockWithResolve:resolve reject:reject]];
 }
@@ -165,18 +180,17 @@ 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
     if (@available(iOS 14.3, macOS 11.1, macCatalyst 14.3, *)) {
         [RCCommonFunctionality enableAdServicesAttributionTokenCollection];
     } else {
         NSLog(@"[Purchases] Warning: tried to enable AdServices attribution token collection, but it's only available on iOS 14.3 or greater or macOS 11.1 or greater.");
     }
+    #else
+    NSLog(@"[Purchases] Warning: AdServices attribution token collection is not available on tvOS.");
+    #endif
 }
 
 RCT_REMAP_METHOD(isAnonymous,
@@ -217,14 +231,14 @@ RCT_REMAP_METHOD(getPromotionalOffer,
 }
 
 RCT_EXPORT_METHOD(presentCodeRedemptionSheet) {
-    #if TARGET_OS_MACCATALYST
-    logUnavailablePresentCodeRedemptionSheet();
-    #else
+    #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
     if (@available(iOS 14.0, *)) {
         [RCCommonFunctionality presentCodeRedemptionSheet];
     } else {
         logUnavailablePresentCodeRedemptionSheet();
     }
+    #else
+    logUnavailablePresentCodeRedemptionSheet();
     #endif
 }
 
@@ -232,26 +246,13 @@ static void logUnavailablePresentCodeRedemptionSheet() {
     NSLog(@"[Purchases] Warning: tried to present codeRedemptionSheet, but it's only available on iOS 14.0 or greater.");
 }
 
-RCT_EXPORT_METHOD(handleObserverModeTransactionForProductID:(nonnull NSString *)productID
-                  resolve:(RCTPromiseResolveBlock)resolve
-                  reject:(RCTPromiseRejectBlock)reject) {
-    if (@available(iOS 15.0, *)) {
-        [RCCommonFunctionality handleObserverModeTransactionForProductID:productID
-                                                              completion:[self getResponseCompletionBlockWithResolve:resolve
-                                                                                                              reject:reject]];
-    } else {
-        NSString* description = @"Tried to handle Observer Mode transaction, but it's 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 - Subscriber Attributes
 
-RCT_EXPORT_METHOD(setProxyURLString:(nullable NSString *)proxyURLString) {
+RCT_EXPORT_METHOD(setProxyURLString:(nullable NSString *)proxyURLString
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
     [RCCommonFunctionality setProxyURLString:proxyURLString];
+    resolve(nil); // Resolve the promise with no value
 }
 
 RCT_EXPORT_METHOD(setAttributes:(NSDictionary *)attributes) {
@@ -351,7 +352,7 @@ RCT_REMAP_METHOD(canMakePayments,
 
 RCT_EXPORT_METHOD(beginRefundRequestForActiveEntitlement:(RCTPromiseResolveBlock)resolve
                                                   reject:(RCTPromiseRejectBlock)reject) {
-    #if TARGET_OS_IPHONE
+    #if TARGET_OS_IPHONE && !TARGET_OS_TV
     if (@available(iOS 15.0, *)) {
         [RCCommonFunctionality beginRefundRequestForActiveEntitlementCompletion:[self getBeginRefundResponseCompletionBlockWithResolve:resolve
                                                                                                                                 reject:reject]];
@@ -366,7 +367,7 @@ RCT_EXPORT_METHOD(beginRefundRequestForActiveEntitlement:(RCTPromiseResolveBlock
 RCT_EXPORT_METHOD(beginRefundRequestForEntitlementId:(NSString *)entitlementIdentifier
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {
-    #if TARGET_OS_IPHONE
+    #if TARGET_OS_IPHONE && !TARGET_OS_TV
     if (@available(iOS 15.0, *)) {
         [RCCommonFunctionality beginRefundRequestEntitlementId:entitlementIdentifier
                                                completionBlock:[self getBeginRefundResponseCompletionBlockWithResolve:resolve
@@ -382,7 +383,7 @@ RCT_EXPORT_METHOD(beginRefundRequestForEntitlementId:(NSString *)entitlementIden
 RCT_EXPORT_METHOD(beginRefundRequestForProductId:(NSString *)productIdentifier
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {
-    #if TARGET_OS_IPHONE
+    #if TARGET_OS_IPHONE && !TARGET_OS_TV
     if (@available(iOS 15.0, *)) {
         [RCCommonFunctionality beginRefundRequestProductId:productIdentifier
                                            completionBlock:[self getBeginRefundResponseCompletionBlockWithResolve:resolve
@@ -398,7 +399,7 @@ RCT_EXPORT_METHOD(beginRefundRequestForProductId:(NSString *)productIdentifier
 RCT_EXPORT_METHOD(showInAppMessages:(NSArray<NSNumber *> *)messageTypes
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {
-    #if TARGET_OS_IPHONE
+    #if TARGET_OS_IPHONE && !TARGET_OS_TV
     if (@available(iOS 16.0, *)) {
         if (messageTypes == nil) {
             [RCCommonFunctionality showStoreMessagesCompletion:^{
@@ -432,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 {
@@ -488,7 +507,7 @@ readyForPromotedProduct:(RCStoreProduct *)product
 }
 
 - (NSString *)platformFlavorVersion {
-    return @"8.0.0-beta.1";
+    return @"8.0.0";
 }
 
 @end

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-purchases",
   "title": "React Native Purchases",
-  "version": "8.0.0-beta.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",
@@ -44,6 +44,7 @@
     "examples/purchaseTesterTypescript",
     "react-native-purchases-ui"
   ],
+  "packageManager": "yarn@3.6.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/revenuecat/react-native-purchases.git",
@@ -63,27 +64,27 @@
   "readmeFilename": "README.md",
   "peerDependencies": {
     "react": ">= 16.6.3",
-    "react-native": ">= 0.58.2"
+    "react-native": "*"
   },
   "devDependencies": {
-    "@types/jest": "^28.1.2",
-    "@types/react": "~18.2.0",
+    "@types/jest": "^29.5.12",
+    "@types/react": "^18.2.44",
     "@types/react-dom": "~18.2.0",
-    "jest": "^28.1.1",
+    "jest": "^29.7.0",
     "jest-react-native": "^18.0.0",
     "pod-install": "^0.1.0",
     "prettier": "^2.0.5",
     "react": "18.2.0",
-    "react-native": "0.73.1",
-    "ts-jest": "^24.1.0",
+    "react-native": "0.73.5",
+    "ts-jest": "^29.1.2",
     "tslint": "^5.20.0",
     "tslint-config-prettier": "^1.18.0",
-    "typedoc": "^0.23.21",
-    "typescript": "^4.9.3"
+    "typedoc": "^0.25.11",
+    "typescript": "^5.2.2"
   },
   "resolutions": {
-    "@types/react": "18.2.0",
-    "@types/react-native": "0.73.1",
+    "@types/react": "^18.2.44",
+    "@types/react-native": "0.73.5",
     "@types/react-dom": "18.2.0"
   },
   "jest": {
@@ -99,6 +100,6 @@
     ]
   },
   "dependencies": {
-    "@revenuecat/purchases-typescript-internal": "10.0.0-beta.1"
+    "@revenuecat/purchases-typescript-internal": "13.0.0"
   }
 }