@revenuecat/purchases-js 1.52.0 → 1.52.2

package/dist/Purchases.es.d.ts

@@ -529,7 +529,27 @@ declare enum LocalizationKeys {
     PriceUpdateTitle = "price_update.title",
     PriceUpdateBaseMessage = "price_update.base_message",
     PriceUpdateTrialMessage = "price_update.trial_message",
-    ApplePayFreeTrial = "apple_pay.free_trial"
+    ApplePayFreeTrial = "apple_pay.free_trial",
+    UpgradeProductInfoChangeSubscriptionTitle = "upgrade_product_info.change_subscription_title",
+    UpgradeProductInfoUpgradeSubscriptionTitle = "upgrade_product_info.upgrade_subscription_title",
+    UpgradeProductInfoTaxEstimated = "upgrade_product_info.tax_estimated",
+    UpgradeProductInfoEstimatedAtNextRenewal = "upgrade_product_info.estimated_at_next_renewal",
+    UpgradeProductInfoCalculatedLater = "upgrade_product_info.calculated_later",
+    PlanCardCurrent = "plan_card.current",
+    PlanCardNew = "plan_card.new",
+    RefundForUnusedTimeTitle = "refund_for_unused_time.title",
+    RefundForUnusedTimeMessage = "refund_for_unused_time.message",
+    UpgradeConfirmPageTitle = "upgrade_confirm_page.title",
+    UpgradeConfirmPageSubtitleImmediate = "upgrade_confirm_page.subtitle_immediate",
+    UpgradeConfirmPageSubtitleDeferred = "upgrade_confirm_page.subtitle_deferred",
+    UpgradeConfirmPageConfirming = "upgrade_confirm_page.confirming",
+    UpgradeConfirmPageConfirmSchedule = "upgrade_confirm_page.confirm_schedule",
+    UpgradeConfirmPageConfirmUpgrade = "upgrade_confirm_page.confirm_upgrade",
+    UpgradeConfirmPageConfirmUpgradeWithPrice = "upgrade_confirm_page.confirm_upgrade_with_price",
+    UpgradeConfirmPageOnFile = "upgrade_confirm_page.on_file",
+    UpgradeConfirmPageEmail = "upgrade_confirm_page.email",
+    UpgradeConfirmPagePaymentMethod = "upgrade_confirm_page.payment_method",
+    UpgradeConfirmPageBillingAddress = "upgrade_confirm_page.billing_address"
 }
 
 /**
@@ -1078,6 +1098,7 @@ export declare interface PresentPaywallParams {
      * ```
      */
     readonly customVariables?: CustomVariables;
+    /* Excluded from this release type: productChangeInfo */
 }
 
 /**
@@ -1535,7 +1556,9 @@ export declare class Purchases {
         * @param params - The parameters object to customise the offerings fetch. Check {@link GetOfferingsParams}
         */
        getCurrentOfferingForPlacement(placementIdentifier: string, params?: GetOfferingsParams): Promise<Offering | null>;
+       private findOfferingById;
        private getAllOfferings;
+       private fetchProductsForOfferings;
        /**
         * Convenience method to check whether a user is entitled to a specific
         * entitlement. This will use {@link Purchases.getCustomerInfo} under the hood.
@@ -1573,8 +1596,10 @@ export declare class Purchases {
           * form on your site, using the given HTML element as the mount point, if
           * provided, or as a modal if not.
           *
-          * When {@link PurchaseParams.productChangeInfo} is set, presents upgrade-mode
-          * checkout for an existing RC Billing subscription instead of a new purchase.
+          * When {@link PurchaseParams.productChangeInfo} is set with a subscriber token,
+          * checkout starts in product-change mode: if the backend can change the
+          * existing subscription, an upgrade-confirm page is shown; otherwise the
+          * same checkout session continues as a normal purchase.
           *
           * @param params - The parameters object to customise the purchase flow. Check {@link PurchaseParams}
           * @returns a Promise for the customer and redemption info after the purchase is completed successfully.
@@ -1637,11 +1662,11 @@ export declare class Purchases {
                  */
              identifyUser(appUserId: string): Promise<IdentifyResult>;
              /**
-              * Presents upgrade-mode checkout to change the customer's Web Billing
-              * subscription to {@link PurchaseParams.rcPackage}'s product along a
-              * configured product change path.
+              * Resolves {@link PurchaseParams.productChangeInfo} into the product-change
+              * context passed to the checkout UI, or undefined when the purchase should
+              * proceed as a normal purchase (no info, no token, or non-Web Billing key).
               */
-             private productChangePurchase;
+             private resolveProductChange;
              /**
               * Rejects anything shaped like a RevenueCat API key so a secret or public
               * key is never sent (or exposed) where a subscriber token belongs.