react-native-purchases-ui 7.16.1 → 7.17.1

package/RNPaywalls.podspec

@@ -17,6 +17,6 @@ Pod::Spec.new do |spec|
   spec.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }
 
   spec.dependency   "React-Core"
-  spec.dependency   "PurchasesHybridCommon", '8.11.2'
+  spec.dependency   "PurchasesHybridCommonUI", '9.2.0'
   spec.swift_version    = '5.7'
 end

package/android/build.gradle

@@ -59,7 +59,7 @@ android {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
     versionCode 1
-    versionName '7.16.1'
+    versionName '7.17.1'
   }
 
   buildTypes {
@@ -91,7 +91,7 @@ dependencies {
   //noinspection GradleDynamicVersion
   implementation "com.facebook.react:react-native:+"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation 'com.revenuecat.purchases:purchases-hybrid-common-ui:8.11.2'
+  implementation 'com.revenuecat.purchases:purchases-hybrid-common-ui:9.2.0'
   implementation 'androidx.compose.ui:ui-android:1.5.4'
   implementation "androidx.appcompat:appcompat:1.6.1"
 }

package/android/src/main/java/com/revenuecat/purchases/react/ui/RNPaywallsModule.kt

@@ -8,6 +8,8 @@ import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.ReadableMap
 import com.revenuecat.purchases.hybridcommon.ui.PaywallResultListener
+import com.revenuecat.purchases.hybridcommon.ui.PaywallSource
+import com.revenuecat.purchases.hybridcommon.ui.PresentPaywallOptions
 import com.revenuecat.purchases.hybridcommon.ui.presentPaywallFromFragment
 
 internal class RNPaywallsModule(reactContext: ReactApplicationContext) :
@@ -33,13 +35,10 @@ internal class RNPaywallsModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     fun presentPaywall(
-        options: ReadableMap,
+        offeringIdentifier: String?,
+        displayCloseButton: Boolean?,
         promise: Promise
     ) {
-        val hashMap = options.toHashMap()
-        val offeringIdentifier = hashMap["offeringIdentifier"] as String?
-        val displayCloseButton = hashMap["displayCloseButton"] as Boolean?
-
         presentPaywall(
             null,
             offeringIdentifier,
@@ -50,14 +49,11 @@ internal class RNPaywallsModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     fun presentPaywallIfNeeded(
-        options: ReadableMap,
+        requiredEntitlementIdentifier: String,
+        offeringIdentifier: String?,
+        displayCloseButton: Boolean,
         promise: Promise
     ) {
-        val hashMap = options.toHashMap()
-        val requiredEntitlementIdentifier = hashMap["requiredEntitlementIdentifier"] as String?
-        val offeringIdentifier = hashMap["offeringIdentifier"] as String?
-        val displayCloseButton = hashMap["displayCloseButton"] as Boolean?
-
         presentPaywall(
             requiredEntitlementIdentifier,
             offeringIdentifier,
@@ -74,16 +70,20 @@ internal class RNPaywallsModule(reactContext: ReactApplicationContext) :
     ) {
         val fragment = currentActivityFragment ?: return
 
-        // TODO wire offeringIdentifier
         presentPaywallFromFragment(
             fragment = fragment,
-            requiredEntitlementIdentifier = requiredEntitlementIdentifier,
-            shouldDisplayDismissButton = displayCloseButton,
-            paywallResultListener = object : PaywallResultListener {
-                override fun onPaywallResult(paywallResult: String) {
-                    promise.resolve(paywallResult)
+            PresentPaywallOptions(
+                requiredEntitlementIdentifier = requiredEntitlementIdentifier,
+                shouldDisplayDismissButton = displayCloseButton,
+                paywallSource = offeringIdentifier?.let {
+                    PaywallSource.OfferingIdentifier(it)
+                } ?: PaywallSource.DefaultOffering,
+                paywallResultListener = object : PaywallResultListener {
+                    override fun onPaywallResult(paywallResult: String) {
+                        promise.resolve(paywallResult)
+                    }
                 }
-            }
+            )
         )
     }
 }

package/ios/PaywallViewManager.m

@@ -7,7 +7,10 @@
 //
 
 #import "PaywallViewManager.h"
-@import PurchasesHybridCommon;
+#import "PaywallViewWrapper.h"
+
+@import PurchasesHybridCommonUI;
+@import RevenueCatUI;
 
 @implementation PaywallViewManager
 
@@ -17,7 +20,8 @@ RCT_EXPORT_MODULE(Paywall)
 {
     if (@available(iOS 15.0, *)) {
         PaywallProxy *proxy = [[PaywallProxy alloc] init];
-        return [proxy createPaywallView].view;
+
+        return [[PaywallViewWrapper alloc] initWithPaywallViewController:[proxy createPaywallView]];
     } else {
         NSLog(@"Error: attempted to present paywalls on unsupported iOS version.");
         return nil;

package/ios/PaywallViewWrapper.h

@@ -0,0 +1,21 @@
+//
+//  PaywallViewWrapper.h
+//  RNPaywalls
+//
+//  Created by Nacho Soto on 1/23/24.
+//
+
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface PaywallViewWrapper : UIView
+
+- (instancetype)initWithCoder:(NSCoder *)coder NS_UNAVAILABLE;
+- (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
+
+- (instancetype)initWithPaywallViewController:(UIViewController *)paywallViewController NS_DESIGNATED_INITIALIZER;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/PaywallViewWrapper.m

@@ -0,0 +1,61 @@
+//
+//  PaywallViewWrapper.m
+//  RNPaywalls
+//
+//  Created by Nacho Soto on 1/23/24.
+//
+
+#import "PaywallViewWrapper.h"
+
+#import "UIView+Extensions.h"
+
+@import PurchasesHybridCommonUI;
+@import RevenueCatUI;
+
+@interface PaywallViewWrapper () <RCPaywallViewControllerDelegate>
+
+@property (strong, nonatomic) UIViewController *paywallViewController;
+
+@property (nonatomic) BOOL addedToHierarchy;
+
+@end
+
+@implementation PaywallViewWrapper
+
+- (instancetype)initWithPaywallViewController:(UIViewController *)paywallViewController {
+    NSParameterAssert(paywallViewController);
+
+    if ((self = [super initWithFrame:paywallViewController.view.bounds])) {
+        _paywallViewController = paywallViewController;
+    }
+
+    return self;
+}
+
+- (void)layoutSubviews {
+    [super layoutSubviews];
+
+    // Need to wait for this view to be in the hierarchy to look for the parent UIVC.
+    // This is required to add a SwiftUI `UIHostingController` to the hierarchy in a way that allows
+    // UIKit to read properties from the environment, like traits and safe area.
+    if (!self.addedToHierarchy) {
+        UIViewController *parentController = self.parentViewController;
+        if (parentController) {
+            self.paywallViewController.view.translatesAutoresizingMaskIntoConstraints = NO;
+            [parentController addChildViewController:self.paywallViewController];
+            [self addSubview:self.paywallViewController.view];
+            [self.paywallViewController didMoveToParentViewController:parentController];
+
+            [NSLayoutConstraint activateConstraints:@[
+                [self.paywallViewController.view.topAnchor constraintEqualToAnchor:self.topAnchor],
+                [self.paywallViewController.view.bottomAnchor constraintEqualToAnchor:self.bottomAnchor],
+                [self.paywallViewController.view.leftAnchor constraintEqualToAnchor:self.leftAnchor],
+                [self.paywallViewController.view.rightAnchor constraintEqualToAnchor:self.rightAnchor]
+            ]];
+
+            self.addedToHierarchy = YES;
+        }
+    }
+}
+
+@end

package/ios/RCPaywallFooterViewManager.m

@@ -9,9 +9,9 @@
 #import "RCPaywallFooterViewManager.h"
 
 @import RevenueCatUI;
-@import PurchasesHybridCommon;
+@import PurchasesHybridCommonUI;
 
-#import "UIView+Extensions.h"
+#import "PaywallViewWrapper.h"
 
 #import <React/RCTShadowView.h>
 #import <React/RCTUIManager.h>
@@ -22,7 +22,7 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-@interface FooterViewWrapper : UIView
+@interface FooterViewWrapper: PaywallViewWrapper
 
 - (instancetype)initWithFooterViewController:(UIViewController *)footerViewController 
                                       bridge:(RCTBridge *)bridge;
@@ -33,7 +33,6 @@ NS_ASSUME_NONNULL_END
 
 @interface FooterViewWrapper () <RCPaywallViewControllerDelegate>
 
-@property (strong, nonatomic) UIViewController *footerViewController;
 @property (strong, nonatomic) RCTBridge *bridge;
 
 @property BOOL addedToHierarchy;
@@ -43,9 +42,8 @@ NS_ASSUME_NONNULL_END
 @implementation FooterViewWrapper
 
 - (instancetype)initWithFooterViewController:(UIViewController *)footerViewController bridge:(RCTBridge *)bridge {
-    if ((self = [super initWithFrame:footerViewController.view.bounds])) {
+    if ((self = [super initWithPaywallViewController:footerViewController])) {
         _bridge = bridge;
-        _footerViewController = footerViewController;
     }
 
     return self;
@@ -70,33 +68,7 @@ NS_ASSUME_NONNULL_END
 }
 
 - (void)paywallViewController:(RCPaywallViewController *)controller didChangeSizeTo:(CGSize)size API_AVAILABLE(ios(15.0)){
-    [_bridge.uiManager setSize:size forView:self];
-}
-
-- (void)layoutSubviews {
-    [super layoutSubviews];
-
-    // Need to wait for this view to be in the hierarchy to look for the parent UIVC.
-    // This is required to add a SwiftUI `UIHostingController` to the hierarchy in a way that allows
-    // UIKit to read properties from the environment, like traits and safe area.
-    if (!self.addedToHierarchy) {
-        UIViewController *parentController = self.parentViewController;
-        if (parentController) {
-            self.footerViewController.view.translatesAutoresizingMaskIntoConstraints = NO;
-            [parentController addChildViewController:self.footerViewController];
-            [self addSubview:self.footerViewController.view];
-            [self.footerViewController didMoveToParentViewController:parentController];
-
-            [NSLayoutConstraint activateConstraints:@[
-                [self.footerViewController.view.topAnchor constraintEqualToAnchor:self.topAnchor],
-                [self.footerViewController.view.bottomAnchor constraintEqualToAnchor:self.bottomAnchor],
-                [self.footerViewController.view.leftAnchor constraintEqualToAnchor:self.leftAnchor],
-                [self.footerViewController.view.rightAnchor constraintEqualToAnchor:self.rightAnchor]
-            ]];
-
-            self.addedToHierarchy = YES;
-        }
-    }
+    [_bridge.uiManager setIntrinsicContentSize:CGSizeMake(UIViewNoIntrinsicMetric, size.height) forView:self];
 }
 
 @end

package/ios/RNPaywalls.h

@@ -5,9 +5,6 @@
 
 #import <React/RCTEventEmitter.h>
 
-@import PurchasesHybridCommon;
-@import RevenueCat;
-
 static NSString *const safeAreaInsetsDidChangeEvent = @"safeAreaInsetsDidChange";
 
 @interface RNPaywalls : RCTEventEmitter <RCTBridgeModule>

package/ios/RNPaywalls.m

@@ -6,6 +6,9 @@
 
 #import "RNPaywalls.h"
 
+@import PurchasesHybridCommonUI;
+@import RevenueCat;
+
 @interface RNPaywalls ()
 
 @property (nonatomic, strong) id paywallProxy;
@@ -58,21 +61,20 @@ RCT_EXPORT_MODULE();
 
 // MARK: -
 
-RCT_EXPORT_METHOD(presentPaywall:(NSDictionary *)options
+RCT_EXPORT_METHOD(presentPaywall:(nullable NSString *)offeringIdentifier
+                  shouldDisplayCloseButton:(BOOL)displayCloseButton
                   withResolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {
     if (@available(iOS 15.0, *)) {
-        // TODO wire offeringIdentifier
-        NSString *offeringIdentifier = options[@"offeringIdentifier"];
-        NSNumber *displayCloseButton = options[@"displayCloseButton"];
-
-        if (displayCloseButton == nil) {
-            [self.paywallProxy presentPaywallWithPaywallResultHandler:^(NSString *result) {
+        if (offeringIdentifier != nil) {
+            [self.paywalls presentPaywallWithOfferingIdentifier:offeringIdentifier
+                                             displayCloseButton:displayCloseButton
+                                           paywallResultHandler:^(NSString *result) {
                 resolve(result);
             }];
             return;
         }
-        [self.paywalls presentPaywallWithDisplayCloseButton:displayCloseButton.boolValue
+        [self.paywalls presentPaywallWithDisplayCloseButton:displayCloseButton
                                        paywallResultHandler:^(NSString *result) {
             resolve(result);
         }];
@@ -81,24 +83,23 @@ RCT_EXPORT_METHOD(presentPaywall:(NSDictionary *)options
     }
 }
 
-RCT_EXPORT_METHOD(presentPaywallIfNeeded:(NSDictionary *)options
+RCT_EXPORT_METHOD(presentPaywallIfNeeded:(NSString *)requiredEntitlementIdentifier
+                  withOfferingIdentifier:(nullable NSString *)offeringIdentifier
+                  shouldDisplayCloseButton:(BOOL)displayCloseButton
                   withResolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject) {
     if (@available(iOS 15.0, *)) {
-        NSString *requiredEntitlementIdentifier = options[@"requiredEntitlementIdentifier"];
-        // TODO wire offeringIdentifier
-        NSString *offeringIdentifier = options[@"offeringIdentifier"];
-        NSNumber *displayCloseButton = options[@"displayCloseButton"];
-        if (displayCloseButton == nil) {
+        if (offeringIdentifier != nil) {
             [self.paywalls presentPaywallIfNeededWithRequiredEntitlementIdentifier:requiredEntitlementIdentifier
+                                                                offeringIdentifier:offeringIdentifier
+                                                                displayCloseButton:displayCloseButton
                                                               paywallResultHandler:^(NSString *result) {
                 resolve(result);
             }];
             return;
         }
-
         [self.paywalls presentPaywallIfNeededWithRequiredEntitlementIdentifier:requiredEntitlementIdentifier
-                                                            displayCloseButton:displayCloseButton.boolValue
+                                                            displayCloseButton:displayCloseButton
                                                           paywallResultHandler:^(NSString *result) {
             resolve(result);
         }];

package/ios/UIView+Extensions.h

@@ -10,6 +10,6 @@
 
 @interface UIView (ParentViewController)
 
-- (UIViewController *)parentViewController;
+@property (nonatomic, readonly) UIViewController *_Nullable parentViewController;
 
 @end

package/ios/UIView+Extensions.m

@@ -9,7 +9,7 @@
 
 @implementation UIView (ParentViewController)
 
-- (UIViewController *)parentViewController {
+- (UIViewController * _Nullable)parentViewController {
     UIResponder *responder = self;
     while (responder) {
         responder = responder.nextResponder;

package/lib/commonjs/index.js

@@ -29,17 +29,53 @@ const InternalPaywallFooterView = _reactNative.UIManager.getViewManagerConfig('P
   throw new Error(LINKING_ERROR);
 };
 class RevenueCatUI {
+  static Defaults = {
+    PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON: true
+  };
+
   /**
    * The result of presenting a paywall. This will be the last situation the user experienced before the paywall closed.
    * @readonly
    * @enum {string}
    */
   static PAYWALL_RESULT = _purchasesTypescriptInternal.PAYWALL_RESULT;
-  static presentPaywall(params = {}) {
-    return RNPaywalls.presentPaywall(params);
+
+  /**
+   * Presents a paywall to the user with optional customization.
+   *
+   * This method allows for presenting a specific offering's paywall to the user. The caller
+   * can decide whether to display a close button on the paywall through the `displayCloseButton`
+   * parameter. By default, the close button is displayed.
+   *
+   * @param {PresentPaywallParams} params - The options for presenting the paywall.
+   * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+   */
+  static presentPaywall({
+    offering,
+    displayCloseButton = RevenueCatUI.Defaults.PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON
+  } = {}) {
+    return RNPaywalls.presentPaywall((offering === null || offering === void 0 ? void 0 : offering.identifier) ?? null, displayCloseButton);
   }
-  static presentPaywallIfNeeded(params) {
-    return RNPaywalls.presentPaywallIfNeeded(params);
+
+  /**
+   * Presents a paywall to the user if a specific entitlement is not already owned.
+   *
+   * This method evaluates whether the user already owns the specified entitlement.
+   * If the entitlement is not owned, it presents a paywall for the specified offering (if provided), or the
+   * default offering (if no offering is provided), to the user. The paywall will be presented
+   * allowing the user the opportunity to purchase the offering. The caller
+   * can decide whether to display a close button on the paywall through the `displayCloseButton`
+   * parameter. By default, the close button is displayed.
+   *
+   * @param {PresentPaywallIfNeededParams} params - The parameters for presenting the paywall.
+   * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+   */
+  static presentPaywallIfNeeded({
+    requiredEntitlementIdentifier,
+    offering,
+    displayCloseButton = RevenueCatUI.Defaults.PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON
+  }) {
+    return RNPaywalls.presentPaywallIfNeeded(requiredEntitlementIdentifier, (offering === null || offering === void 0 ? void 0 : offering.identifier) ?? null, displayCloseButton);
   }
   static Paywall = props => /*#__PURE__*/_react.default.createElement(InternalPaywall, _extends({}, props, {
     style: [{

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_purchasesTypescriptInternal","_react","_interopRequireWildcard","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","prototype","hasOwnProperty","call","i","set","_extends","assign","bind","target","arguments","length","source","key","apply","LINKING_ERROR","Platform","select","ios","RNPaywalls","NativeModules","eventEmitter","NativeEventEmitter","InternalPaywall","UIManager","getViewManagerConfig","requireNativeComponent","Error","InternalPaywallFooterView","RevenueCatUI","PAYWALL_RESULT","presentPaywall","params","presentPaywallIfNeeded","Paywall","props","createElement","style","flex","PaywallFooterContainerView","children","paddingBottom","setPaddingBottom","useState","useEffect","handleSafeAreaInsetsChange","bottom","subscription","addListener","remove","View","ScrollView","contentContainerStyle","flexGrow","marginTop","exports"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}
+{"version":3,"names":["_reactNative","require","_purchasesTypescriptInternal","_react","_interopRequireWildcard","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","prototype","hasOwnProperty","call","i","set","_extends","assign","bind","target","arguments","length","source","key","apply","LINKING_ERROR","Platform","select","ios","RNPaywalls","NativeModules","eventEmitter","NativeEventEmitter","InternalPaywall","UIManager","getViewManagerConfig","requireNativeComponent","Error","InternalPaywallFooterView","RevenueCatUI","Defaults","PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON","PAYWALL_RESULT","presentPaywall","offering","displayCloseButton","identifier","presentPaywallIfNeeded","requiredEntitlementIdentifier","Paywall","props","createElement","style","flex","PaywallFooterContainerView","children","paddingBottom","setPaddingBottom","useState","useEffect","handleSafeAreaInsetsChange","bottom","subscription","addListener","remove","View","ScrollView","contentContainerStyle","flexGrow","marginTop","exports"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}

package/lib/module/index.js

@@ -16,17 +16,53 @@ const InternalPaywallFooterView = UIManager.getViewManagerConfig('Paywall') != n
   throw new Error(LINKING_ERROR);
 };
 export default class RevenueCatUI {
+  static Defaults = {
+    PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON: true
+  };
+
   /**
    * The result of presenting a paywall. This will be the last situation the user experienced before the paywall closed.
    * @readonly
    * @enum {string}
    */
   static PAYWALL_RESULT = PAYWALL_RESULT;
-  static presentPaywall(params = {}) {
-    return RNPaywalls.presentPaywall(params);
+
+  /**
+   * Presents a paywall to the user with optional customization.
+   *
+   * This method allows for presenting a specific offering's paywall to the user. The caller
+   * can decide whether to display a close button on the paywall through the `displayCloseButton`
+   * parameter. By default, the close button is displayed.
+   *
+   * @param {PresentPaywallParams} params - The options for presenting the paywall.
+   * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+   */
+  static presentPaywall({
+    offering,
+    displayCloseButton = RevenueCatUI.Defaults.PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON
+  } = {}) {
+    return RNPaywalls.presentPaywall((offering === null || offering === void 0 ? void 0 : offering.identifier) ?? null, displayCloseButton);
   }
-  static presentPaywallIfNeeded(params) {
-    return RNPaywalls.presentPaywallIfNeeded(params);
+
+  /**
+   * Presents a paywall to the user if a specific entitlement is not already owned.
+   *
+   * This method evaluates whether the user already owns the specified entitlement.
+   * If the entitlement is not owned, it presents a paywall for the specified offering (if provided), or the
+   * default offering (if no offering is provided), to the user. The paywall will be presented
+   * allowing the user the opportunity to purchase the offering. The caller
+   * can decide whether to display a close button on the paywall through the `displayCloseButton`
+   * parameter. By default, the close button is displayed.
+   *
+   * @param {PresentPaywallIfNeededParams} params - The parameters for presenting the paywall.
+   * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+   */
+  static presentPaywallIfNeeded({
+    requiredEntitlementIdentifier,
+    offering,
+    displayCloseButton = RevenueCatUI.Defaults.PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON
+  }) {
+    return RNPaywalls.presentPaywallIfNeeded(requiredEntitlementIdentifier, (offering === null || offering === void 0 ? void 0 : offering.identifier) ?? null, displayCloseButton);
   }
   static Paywall = props => /*#__PURE__*/React.createElement(InternalPaywall, _extends({}, props, {
     style: [{

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","requireNativeComponent","ScrollView","UIManager","View","PAYWALL_RESULT","React","useEffect","useState","LINKING_ERROR","select","ios","default","RNPaywalls","eventEmitter","InternalPaywall","getViewManagerConfig","Error","InternalPaywallFooterView","RevenueCatUI","presentPaywall","params","presentPaywallIfNeeded","Paywall","props","createElement","_extends","style","flex","PaywallFooterContainerView","children","paddingBottom","setPaddingBottom","handleSafeAreaInsetsChange","bottom","subscription","addListener","remove","contentContainerStyle","flexGrow","marginTop"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";AAAA,SACEA,kBAAkB,EAClBC,aAAa,EACbC,QAAQ,EACRC,sBAAsB,EACtBC,UAAU,EAEVC,SAAS,EACTC,IAAI,QAEC,cAAc;AACrB,SAASC,cAAc,QAAQ,2CAA2C;AAC1E,OAAOC,KAAK,IAAoBC,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAElE,SAASH,cAAc,QAAQ,2CAA2C;AAE1E,MAAMI,aAAa,GAChB,sFAAqF,GACtFT,QAAQ,CAACU,MAAM,CAAC;EAACC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAE,CAAC,CAAC,GACrE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,UAAU,GAAGd,aAAa,CAACc,UAAU;AAE3C,MAAMC,YAAY,GAAG,IAAIhB,kBAAkB,CAACe,UAAU,CAAC;AAOvD,MAAME,eAAe,GACnBZ,SAAS,CAACa,oBAAoB,CAAC,SAAS,CAAC,IAAI,IAAI,GAC7Cf,sBAAsB,CAAmB,SAAS,CAAC,GACnD,MAAM;EACN,MAAM,IAAIgB,KAAK,CAACR,aAAa,CAAC;AAChC,CAAC;AAEL,MAAMS,yBAAyB,GAAGf,SAAS,CAACa,oBAAoB,CAAC,SAAS,CAAC,IAAI,IAAI,GAC/Ef,sBAAsB,CAAmB,qBAAqB,CAAC,GAC/D,MAAM;EACN,MAAM,IAAIgB,KAAK,CAACR,aAAa,CAAC;AAChC,CAAC;AAgBH,eAAe,MAAMU,YAAY,CAAC;EAEhC;AACF;AACA;AACA;AACA;EACE,OAAcd,cAAc,GAAGA,cAAc;EAE7C,OAAce,cAAcA,CAACC,MAA4B,GAAG,CAAC,CAAC,EAA2B;IACvF,OAAOR,UAAU,CAACO,cAAc,CAACC,MAAM,CAAC;EAC1C;EAEA,OAAcC,sBAAsBA,CAACD,MAAoC,EAA2B;IAClG,OAAOR,UAAU,CAACS,sBAAsB,CAACD,MAAM,CAAC;EAClD;EAEA,OAAcE,OAAO,GAAgCC,KAAK,iBACxDlB,KAAA,CAAAmB,aAAA,CAACV,eAAe,EAAAW,QAAA,KAAKF,KAAK;IAAEG,KAAK,EAAE,CAAC;MAACC,IAAI,EAAE;IAAC,CAAC,EAAEJ,KAAK,CAACG,KAAK;EAAE,EAAC,CAC9D;EAED,OAAcE,0BAA0B,GAA+BA,CAAC;IAACF,KAAK;IAAEG;EAAQ,CAAC,KAAK;IAC5F;IACA;IACA;IACA;IACA,MAAM,CAACC,aAAa,EAAEC,gBAAgB,CAAC,GAAGxB,QAAQ,CAAC,EAAE,CAAC;IAEtDD,SAAS,CAAC,MAAM;MAKd,MAAM0B,0BAA0B,GAAGA,CAAC;QAACC;MAAwC,CAAC,KAAK;QACjFF,gBAAgB,CAAC,EAAE,GAAGE,MAAM,CAAC;MAC/B,CAAC;MAED,MAAMC,YAAY,GAAGrB,YAAY,CAACsB,WAAW,CAC3C,yBAAyB,EACzBH,0BACF,CAAC;MAED,OAAO,MAAM;QACXE,YAAY,CAACE,MAAM,CAAC,CAAC;MACvB,CAAC;IACH,CAAC,EAAE,EAAE,CAAC;IAEN,oBACE/B,KAAA,CAAAmB,aAAA,CAACrB,IAAI;MAACuB,KAAK,EAAE,CAAC;QAACC,IAAI,EAAE;MAAC,CAAC,EAAED,KAAK;IAAE,gBAC9BrB,KAAA,CAAAmB,aAAA,CAACvB,UAAU;MAACoC,qBAAqB,EAAE;QAACC,QAAQ,EAAE,CAAC;QAAER;MAAa;IAAE,GAC7DD,QACS,CAAC,eAEbxB,KAAA,CAAAmB,aAAA,CAACP,yBAAyB;MAACS,KAAK,EAAE;QAACa,SAAS,EAAE,CAAC;MAAE;IAAE,CAAC,CAChD,CAAC;EAEX,CAAC;AACH"}
+{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","requireNativeComponent","ScrollView","UIManager","View","PAYWALL_RESULT","React","useEffect","useState","LINKING_ERROR","select","ios","default","RNPaywalls","eventEmitter","InternalPaywall","getViewManagerConfig","Error","InternalPaywallFooterView","RevenueCatUI","Defaults","PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON","presentPaywall","offering","displayCloseButton","identifier","presentPaywallIfNeeded","requiredEntitlementIdentifier","Paywall","props","createElement","_extends","style","flex","PaywallFooterContainerView","children","paddingBottom","setPaddingBottom","handleSafeAreaInsetsChange","bottom","subscription","addListener","remove","contentContainerStyle","flexGrow","marginTop"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -1,5 +1,5 @@
 import { type StyleProp, type ViewStyle } from "react-native";
-import { PAYWALL_RESULT } from "@revenuecat/purchases-typescript-internal";
+import { PAYWALL_RESULT, type PurchasesOffering } from "@revenuecat/purchases-typescript-internal";
 import React, { type ReactNode } from "react";
 export { PAYWALL_RESULT } from "@revenuecat/purchases-typescript-internal";
 type PaywallViewProps = {
@@ -11,6 +11,10 @@ export interface PresentPaywallParams {
      * Whether to display the close button or not.
      */
     displayCloseButton?: boolean;
+    /**
+     * The offering to load the paywall with. This will be the "current" offering by default.
+     */
+    offering?: PurchasesOffering;
 }
 export type PresentPaywallIfNeededParams = PresentPaywallParams & {
     /**
@@ -19,14 +23,38 @@ export type PresentPaywallIfNeededParams = PresentPaywallParams & {
     requiredEntitlementIdentifier: string;
 };
 export default class RevenueCatUI {
+    private static Defaults;
     /**
      * The result of presenting a paywall. This will be the last situation the user experienced before the paywall closed.
      * @readonly
      * @enum {string}
      */
     static PAYWALL_RESULT: typeof PAYWALL_RESULT;
-    static presentPaywall(params?: PresentPaywallParams): Promise<PAYWALL_RESULT>;
-    static presentPaywallIfNeeded(params: PresentPaywallIfNeededParams): Promise<PAYWALL_RESULT>;
+    /**
+     * Presents a paywall to the user with optional customization.
+     *
+     * This method allows for presenting a specific offering's paywall to the user. The caller
+     * can decide whether to display a close button on the paywall through the `displayCloseButton`
+     * parameter. By default, the close button is displayed.
+     *
+     * @param {PresentPaywallParams} params - The options for presenting the paywall.
+     * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+     */
+    static presentPaywall({ offering, displayCloseButton }?: PresentPaywallParams): Promise<PAYWALL_RESULT>;
+    /**
+     * Presents a paywall to the user if a specific entitlement is not already owned.
+     *
+     * This method evaluates whether the user already owns the specified entitlement.
+     * If the entitlement is not owned, it presents a paywall for the specified offering (if provided), or the
+     * default offering (if no offering is provided), to the user. The paywall will be presented
+     * allowing the user the opportunity to purchase the offering. The caller
+     * can decide whether to display a close button on the paywall through the `displayCloseButton`
+     * parameter. By default, the close button is displayed.
+     *
+     * @param {PresentPaywallIfNeededParams} params - The parameters for presenting the paywall.
+     * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+     */
+    static presentPaywallIfNeeded({ requiredEntitlementIdentifier, offering, displayCloseButton }: PresentPaywallIfNeededParams): Promise<PAYWALL_RESULT>;
     static Paywall: React.FC<PaywallViewProps>;
     static PaywallFooterContainerView: React.FC<PaywallViewProps>;
 }

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EAGd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAY3E,KAAK,gBAAgB,GAAG;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAeF,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,GAAG;IAChE;;OAEG;IACH,6BAA6B,EAAE,MAAM,CAAC;CACvC,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAE/B;;;;OAIG;IACH,OAAc,cAAc,wBAAkB;WAEhC,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;WAI1E,sBAAsB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,cAAc,CAAC;IAInG,OAAc,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAE/C;IAEF,OAAc,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAmClE;CACH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EAGd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AACnG,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAY3E,KAAK,gBAAgB,GAAG;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAeF,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,GAAG;IAChE;;OAEG;IACH,6BAA6B,EAAE,MAAM,CAAC;CACvC,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAE/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAEtB;IAED;;;;OAIG;IACH,OAAc,cAAc,wBAAkB;IAE9C;;;;;;;;;OASG;WACW,cAAc,CAAC,EACE,QAAQ,EACR,kBAA+E,EAChF,GAAE,oBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;IAInF;;;;;;;;;;;;OAYG;WACW,sBAAsB,CAAC,EACE,6BAA6B,EAC7B,QAAQ,EACR,kBAA+E,EAChF,EAAE,4BAA4B,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9F,OAAc,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAE/C;IAEF,OAAc,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAmClE;CACH"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-purchases-ui",
   "title": "React Native Purchases UI",
-  "version": "7.16.1",
+  "version": "7.17.1",
   "description": "React Native in-app purchases and subscriptions made easy. Supports iOS and Android.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -112,6 +112,6 @@
   },
   "dependencies": {
     "@revenuecat/purchases-typescript-internal": "8.10.1",
-    "react-native-purchases": "7.16.1"
+    "react-native-purchases": "7.17.1"
   }
 }

package/src/index.tsx

@@ -9,7 +9,7 @@ import {
   View,
   type ViewStyle,
 } from "react-native";
-import { PAYWALL_RESULT } from "@revenuecat/purchases-typescript-internal";
+import { PAYWALL_RESULT, type PurchasesOffering } from "@revenuecat/purchases-typescript-internal";
 import React, { type ReactNode, useEffect, useState } from "react";
 
 export { PAYWALL_RESULT } from "@revenuecat/purchases-typescript-internal";
@@ -47,6 +47,11 @@ export interface PresentPaywallParams {
    * Whether to display the close button or not.
    */
   displayCloseButton?: boolean;
+
+  /**
+   * The offering to load the paywall with. This will be the "current" offering by default.
+   */
+  offering?: PurchasesOffering;
 }
 
 export type PresentPaywallIfNeededParams = PresentPaywallParams & {
@@ -58,6 +63,10 @@ export type PresentPaywallIfNeededParams = PresentPaywallParams & {
 
 export default class RevenueCatUI {
 
+  private static Defaults = {
+    PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON: true
+  }
+
   /**
    * The result of presenting a paywall. This will be the last situation the user experienced before the paywall closed.
    * @readonly
@@ -65,12 +74,42 @@ export default class RevenueCatUI {
    */
   public static PAYWALL_RESULT = PAYWALL_RESULT;
 
-  public static presentPaywall(params: PresentPaywallParams = {}): Promise<PAYWALL_RESULT> {
-    return RNPaywalls.presentPaywall(params);
+  /**
+   * Presents a paywall to the user with optional customization.
+   *
+   * This method allows for presenting a specific offering's paywall to the user. The caller
+   * can decide whether to display a close button on the paywall through the `displayCloseButton`
+   * parameter. By default, the close button is displayed.
+   *
+   * @param {PresentPaywallParams} params - The options for presenting the paywall.
+   * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+   */
+  public static presentPaywall({
+                                 offering,
+                                 displayCloseButton = RevenueCatUI.Defaults.PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON
+                               }: PresentPaywallParams = {}): Promise<PAYWALL_RESULT> {
+    return RNPaywalls.presentPaywall(offering?.identifier ?? null, displayCloseButton)
   }
 
-  public static presentPaywallIfNeeded(params: PresentPaywallIfNeededParams): Promise<PAYWALL_RESULT> {
-    return RNPaywalls.presentPaywallIfNeeded(params);
+  /**
+   * Presents a paywall to the user if a specific entitlement is not already owned.
+   *
+   * This method evaluates whether the user already owns the specified entitlement.
+   * If the entitlement is not owned, it presents a paywall for the specified offering (if provided), or the
+   * default offering (if no offering is provided), to the user. The paywall will be presented
+   * allowing the user the opportunity to purchase the offering. The caller
+   * can decide whether to display a close button on the paywall through the `displayCloseButton`
+   * parameter. By default, the close button is displayed.
+   *
+   * @param {PresentPaywallIfNeededParams} params - The parameters for presenting the paywall.
+   * @returns {Promise<PAYWALL_RESULT>} A promise that resolves with the result of the paywall presentation.
+   */
+  public static presentPaywallIfNeeded({
+                                         requiredEntitlementIdentifier,
+                                         offering,
+                                         displayCloseButton = RevenueCatUI.Defaults.PRESENT_PAYWALL_DISPLAY_CLOSE_BUTTON
+                                       }: PresentPaywallIfNeededParams): Promise<PAYWALL_RESULT> {
+    return RNPaywalls.presentPaywallIfNeeded(requiredEntitlementIdentifier, offering?.identifier ?? null, displayCloseButton)
   }
 
   public static Paywall: React.FC<PaywallViewProps> = (props) => (