@revenuecat/purchases-js 1.52.3 → 1.53.1

package/dist/Purchases.es.d.ts

@@ -1016,6 +1016,23 @@ export declare interface PresentPaywallParams {
      * If passed the checkout flow will not ask for it to the customer.
      */
     readonly customerEmail?: string;
+    /**
+     * The purchase metadata to be passed to the backend when a purchase is started
+     * from the paywall.
+     * Any information provided here will be propagated to the payment gateway and
+     * to the RC transaction as metadata.
+     */
+    readonly metadata?: PurchaseMetadata;
+    /**
+     * Overrides the branding appearance for the purchase started from this
+     * paywall. Only the provided values are overridden. These values take
+     * precedence over the override passed to `Purchases.configure()`.
+     *
+     * For Stripe Checkout, this customizes the supported mobile wallet experience.
+     * The Stripe-hosted fallback opened through "Pay another way" remains light and
+     * cannot currently be customized.
+     */
+    readonly brandingAppearanceOverride?: Partial<BrandingAppearance>;
     /**
      * @experimental
      * If set to true, the Web Billing checkout shown from the paywall
@@ -1419,7 +1436,16 @@ export declare interface PurchaseParams {
      * in sync with the checkout.
      */
     onDiscountCodeChanged?: (discountCode: string | null) => void;
-    /* Excluded from this release type: brandingAppearanceOverride */
+    /**
+     * Overrides the Dashboard branding appearance for this purchase.
+     * Only the provided values are overridden; all other values keep their
+     * Dashboard configuration.
+     *
+     * For Stripe Checkout, this customizes the supported mobile wallet experience.
+     * The Stripe-hosted fallback opened through "Pay another way" remains light and
+     * cannot currently be customized.
+     */
+    brandingAppearanceOverride?: Partial<BrandingAppearance>;
     /* Excluded from this release type: labelsOverride */
     /**
      * Link to the terms and conditions that should be shown in the checkout footer.
@@ -1468,6 +1494,7 @@ export declare class Purchases {
     /* Excluded from this release type: _loadingResourcesPromise */
     /* Excluded from this release type: _flags */
     /* Excluded from this release type: _subscriberToken */
+    /* Excluded from this release type: _brandingAppearanceOverride */
     /* Excluded from this release type: _context */
     /* Excluded from this release type: backend */
     /* Excluded from this release type: purchaseOperationHelper */
@@ -1765,6 +1792,18 @@ export declare class Purchases {
                  * Advanced functionality configuration {@link FlagsConfig}.
                  */
                 flags?: FlagsConfig;
+                /**
+                 * Overrides the Dashboard branding appearance for purchases created by this
+                 * instance, including purchases started through {@link Purchases.presentPaywall}.
+                 * Only the provided values are overridden. A value passed directly to
+                 * {@link PurchaseParams.brandingAppearanceOverride} takes precedence for that
+                 * purchase.
+                 *
+                 * For Stripe Checkout, this customizes the supported mobile wallet experience.
+                 * The Stripe-hosted fallback opened through "Pay another way" remains light and
+                 * cannot currently be customized.
+                 */
+                brandingAppearanceOverride?: Partial<BrandingAppearance>;
                 /* Excluded from this release type: subscriberToken */
                 /* Excluded from this release type: context */
                 /* Excluded from this release type: trace_id */