@revenuecat/purchases-js 1.27.0 → 1.29.0

package/dist/Purchases.es.d.ts

@@ -1,3 +1,5 @@
+import { CustomVariables } from '@revenuecat/purchases-ui-js';
+import { CustomVariableValue } from '@revenuecat/purchases-ui-js';
 import { PaywallData } from '@revenuecat/purchases-ui-js';
 import { UIConfig } from '@revenuecat/purchases-ui-js';
 
@@ -146,6 +148,10 @@ declare type CustomTranslations = {
     };
 };
 
+export { CustomVariables }
+
+export { CustomVariableValue }
+
 /* Excluded from this release type: DiscountPhase */
 
 declare type EmptyString = "";
@@ -309,6 +315,13 @@ export declare interface FlagsConfig {
     collectAnalyticsEvents?: boolean;
     /* Excluded from this release type: rcSource */
     /* Excluded from this release type: forceEnableWalletMethods */
+    /**
+     * Determines when the store module (e.g. Stripe) is loaded.
+     * - `"configuration"`: Preloaded when the SDK is configured (default).
+     * - `"purchase_start"`: Loaded on demand when a purchase is started.
+     * @defaultValue "configuration"
+     */
+    storeLoadTime?: StoreLoadTime;
 }
 
 /**
@@ -873,6 +886,25 @@ export declare interface PresentPaywallParams {
      * Whether to hide back buttons in the paywall. Defaults to false.
      */
     readonly hideBackButtons?: boolean;
+    /**
+     * Custom variables to pass to the paywall at runtime, overriding defaults set
+     * in the RevenueCat dashboard.
+     *
+     * Variables must be defined in the dashboard first. Reference them in paywall
+     * text using the `custom.` prefix (e.g. `{{ custom.player_name }}`).
+     *
+     * @example
+     * ```ts
+     * presentPaywall({
+     *   customVariables: {
+     *     player_name: CustomVariableValue.string('Ada'),
+     *     level: CustomVariableValue.number(42),
+     *     is_premium: CustomVariableValue.boolean(true),
+     *   },
+     * });
+     * ```
+     */
+    readonly customVariables?: CustomVariables;
 }
 
 /**
@@ -1126,6 +1158,7 @@ export declare interface PurchaseParams {
      */
     customerEmail?: string;
     /* Excluded from this release type: workflowPurchaseContext */
+    /* Excluded from this release type: paywallId */
     /**
      * The locale to use for the purchase flow. If not specified, English will be used
      */
@@ -1307,6 +1340,7 @@ export declare class Purchases {
           * @throws {@link PurchasesError} if there is an error while performing the purchase. If the {@link PurchasesError.errorCode} is {@link ErrorCode.UserCancelledError}, the user cancelled the purchase.
               */
           purchase(params: PurchaseParams): Promise<PurchaseResult>;
+          private performStripePurchase;
           private performWebBillingPurchase;
           private performPaddlePurchase;
           /**
@@ -1733,6 +1767,14 @@ export declare class Purchases {
              */
             export declare type Store = "app_store" | "mac_app_store" | "play_store" | "amazon" | "stripe" | "rc_billing" | "promotional" | "paddle" | "test_store" | "unknown";
 
+            /**
+             * Determines when the store module (e.g. Stripe) is loaded.
+             * - `"configuration"`: The store module is preloaded when the SDK is configured.
+             * - `"purchase_start"`: The store module is loaded on demand when a purchase is started.
+             * @public
+             */
+            export declare type StoreLoadTime = "configuration" | "purchase_start";
+
             /**
              * Represents a transaction made in the store.
              * @public