react-native-purchases 4.3.3 → 4.5.1

package/dist/purchases.d.ts

@@ -1,4 +1,4 @@
-import { PURCHASES_ERROR_CODE } from "./errors";
+import { PURCHASES_ERROR_CODE, UninitializedPurchasesError } from "./errors";
 import { PurchaserInfo } from "./purchaserInfo";
 import { PRORATION_MODE, PACKAGE_TYPE, INTRO_ELIGIBILITY_STATUS, PurchasesOfferings, PurchasesProduct, UpgradeInfo, PurchasesPaymentDiscount, PurchasesPackage, IntroEligibility, PurchasesDiscount } from "./offerings";
 /**
@@ -7,11 +7,11 @@ import { PRORATION_MODE, PACKAGE_TYPE, INTRO_ELIGIBILITY_STATUS, PurchasesOfferi
  * @param {Object} purchaserInfo Object containing info for the purchaser
  */
 export declare type PurchaserInfoUpdateListener = (purchaserInfo: PurchaserInfo) => void;
-export declare type ShouldPurchasePromoProductListener = (deferredPurchase: () => MakePurchasePromise) => void;
-declare type MakePurchasePromise = Promise<{
+export declare type ShouldPurchasePromoProductListener = (deferredPurchase: () => Promise<MakePurchaseResult>) => void;
+declare type MakePurchaseResult = {
     productIdentifier: string;
     purchaserInfo: PurchaserInfo;
-}>;
+};
 export declare enum ATTRIBUTION_NETWORK {
     APPLE_SEARCH_ADS = 0,
     ADJUST = 1,
@@ -123,6 +123,7 @@ export default class Purchases {
      * @enum {string}
      */
     static PURCHASES_ERROR_CODE: typeof PURCHASES_ERROR_CODE;
+    static UninitializedPurchasesError: typeof UninitializedPurchasesError;
     /**
      * Sets up Purchases with your API key and an app user id.
      * @param {String} apiKey RevenueCat API Key. Needs to be a String
@@ -135,21 +136,26 @@ export default class Purchases {
     static setup(apiKey: string, appUserID?: string | null, observerMode?: boolean, userDefaultsSuiteName?: string): 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, we will treat it as a restore and alias
-     * the new ID with the previous id.
-     * @param {boolean} allowSharing Set this to true if you are passing in an appUserID but it is anonymous, this is true by default if you didn't pass an appUserID
+     * If an user tries to purchase a product that is active on the current app store account,
+     * we will treat it as a restore and alias the new ID with the previous id.
+     * @param {boolean} allowSharing Set this to true if you are passing in an appUserID but it is anonymous,
+     * this is true by default if you didn't pass an appUserID
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet.
      */
-    static setAllowSharingStoreAccount(allowSharing: boolean): void;
+    static setAllowSharingStoreAccount(allowSharing: boolean): Promise<void>;
     /**
-     * @param {boolean} finishTransactions Set finishTransactions to false if you aren't using Purchases SDK to make the purchase
+     * @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 setup has not been called yet.
      */
-    static setFinishTransactions(finishTransactions: boolean): void;
+    static setFinishTransactions(finishTransactions: boolean): Promise<void>;
     /**
      * iOS only.
-     * @param {boolean} simulatesAskToBuyInSandbox Set this property to true *only* when testing the ask-to-buy / SCA purchases flow.
-     * More information: http://errors.rev.cat/ask-to-buy
+     * @param {boolean} simulatesAskToBuyInSandbox Set this property to true *only* when testing the ask-to-buy / SCA
+     * purchases flow. More information: http://errors.rev.cat/ask-to-buy
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet.
      */
-    static setSimulatesAskToBuyInSandbox(simulatesAskToBuyInSandbox: boolean): void;
+    static setSimulatesAskToBuyInSandbox(simulatesAskToBuyInSandbox: boolean): Promise<void>;
     /**
      * Sets a function to be called on updated purchaser info
      * @param {PurchaserInfoUpdateListener} purchaserInfoUpdateListener PurchaserInfo update listener
@@ -173,7 +179,8 @@ export default class Purchases {
     static addShouldPurchasePromoProductListener(shouldPurchasePromoProductListener: ShouldPurchasePromoProductListener): void;
     /**
      * Removes a given ShouldPurchasePromoProductListener
-     * @param {ShouldPurchasePromoProductListener} listenerToRemove ShouldPurchasePromoProductListener reference of the listener to remove
+     * @param {ShouldPurchasePromoProductListener} listenerToRemove ShouldPurchasePromoProductListener reference of
+     * the listener to remove
      * @returns {boolean} True if listener was removed, false otherwise
      */
     static removeShouldPurchasePromoProductListener(listenerToRemove: ShouldPurchasePromoProductListener): boolean;
@@ -184,21 +191,25 @@ export default class Purchases {
      * @param {Dict} data Attribution data from AppsFlyer, Adjust, or Branch
      * @param {ATTRIBUTION_NETWORKS} network Which network, see Purchases.ATTRIBUTION_NETWORKS
      * @param {String?} networkUserId An optional unique id for identifying the user. Needs to be a string.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet.
      */
     static addAttributionData(data: {
         [key: string]: any;
-    }, network: ATTRIBUTION_NETWORK, networkUserId?: string): void;
+    }, network: ATTRIBUTION_NETWORK, networkUserId?: string): Promise<void>;
     /**
      * Gets the map of entitlements -> offerings -> products
-     * @returns {Promise<PurchasesOfferings>} Promise of entitlements structure
+     * @returns {Promise<PurchasesOfferings>} Promise of entitlements structure. The promise will be rejected if setup
+     * has not been called yet.
      */
     static getOfferings(): Promise<PurchasesOfferings>;
     /**
      * Fetch the product info
      * @param {String[]} productIdentifiers Array of product identifiers
      * @param {String} type Optional type of products to fetch, can be inapp or subs. Subs by default
-     * @returns {Promise<PurchasesProduct[]>} A promise containing an array of products. The promise will be rejected if the products are not properly
-     * configured in RevenueCat or if there is another error retrieving them. Rejections return an error code, and a userInfo object with more information.
+     * @returns {Promise<PurchasesProduct[]>} A promise containing an array of products. The promise will be rejected
+     * if the products are not properly configured in RevenueCat or if there is another error retrieving them.
+     * Rejections return an error code, and a userInfo object with more information. The promise will also be rejected
+     * if setup has not been called yet.
      */
     static getProducts(productIdentifiers: string[], type?: PURCHASE_TYPE): Promise<PurchasesProduct[]>;
     /**
@@ -210,9 +221,10 @@ export default class Purchases {
      * @param {String} type Optional type of product, can be inapp or subs. Subs by default
      * @returns {Promise<{ productIdentifier: string, purchaserInfo:PurchaserInfo }>} A promise of an object containing
      * a purchaser info object and a product identifier. Rejections return an error code,
-     * a boolean indicating if the user cancelled the purchase, and an object with more information.
+     * a boolean indicating if the user cancelled the purchase, and an object with more information. The promise will
+     * also be rejected if setup has not been called yet.
      */
-    static purchaseProduct(productIdentifier: string, upgradeInfo?: UpgradeInfo | null, type?: PURCHASE_TYPE): MakePurchasePromise;
+    static purchaseProduct(productIdentifier: string, upgradeInfo?: UpgradeInfo | null, type?: PURCHASE_TYPE): Promise<MakePurchaseResult>;
     /**
      * iOS only. Purchase a product applying a given discount.
      *
@@ -220,9 +232,10 @@ export default class Purchases {
      * @param {PurchasesPaymentDiscount} discount Discount to apply to this package. Retrieve this discount using getPaymentDiscount.
      * @returns {Promise<{ productIdentifier: string, purchaserInfo:PurchaserInfo }>} A promise of an object containing
      * a purchaser info object and a product identifier. Rejections return an error code,
-     * a boolean indicating if the user cancelled the purchase, and an object with more information.
+     * a boolean indicating if the user cancelled the purchase, and an object with more information. The promise will be
+     * rejected if setup has not been called yet.
      */
-    static purchaseDiscountedProduct(product: PurchasesProduct, discount: PurchasesPaymentDiscount): MakePurchasePromise;
+    static purchaseDiscountedProduct(product: PurchasesProduct, discount: PurchasesPaymentDiscount): Promise<MakePurchaseResult>;
     /**
      * Make a purchase
      *
@@ -230,112 +243,136 @@ export default class Purchases {
      * @param {UpgradeInfo} upgradeInfo Android only. Optional UpgradeInfo you wish to upgrade from containing the oldSKU
      * and the optional prorationMode.
      * @returns {Promise<{ productIdentifier: string, purchaserInfo: PurchaserInfo }>} A promise of an object containing
-     * a purchaser info object and a product identifier. Rejections return an error code,
-     * a boolean indicating if the user cancelled the purchase, and an object with more information.
+     * a purchaser info object and a product identifier. Rejections return an error code, a boolean indicating if the
+     * user cancelled the purchase, and an object with more information. The promise will be also be rejected if setup
+     * has not been called yet.
      */
-    static purchasePackage(aPackage: PurchasesPackage, upgradeInfo?: UpgradeInfo | null): MakePurchasePromise;
+    static purchasePackage(aPackage: PurchasesPackage, upgradeInfo?: UpgradeInfo | null): Promise<MakePurchaseResult>;
     /**
      * iOS only. Purchase a package applying a given discount.
      *
      * @param {PurchasesPackage} aPackage The Package you wish to purchase. You can get the Packages by calling getOfferings
      * @param {PurchasesPaymentDiscount} discount Discount to apply to this package. Retrieve this discount using getPaymentDiscount.
      * @returns {Promise<{ productIdentifier: string, purchaserInfo: PurchaserInfo }>} A promise of an object containing
-     * a purchaser info object and a product identifier. Rejections return an error code,
-     * a boolean indicating if the user cancelled the purchase, and an object with more information.
+     * a purchaser info object and a product identifier. Rejections return an error code, a boolean indicating if the
+     * user cancelled the purchase, and an object with more information. The promise will be also be rejected if setup
+     * has not been called yet.
      */
-    static purchaseDiscountedPackage(aPackage: PurchasesPackage, discount: PurchasesPaymentDiscount): MakePurchasePromise;
+    static purchaseDiscountedPackage(aPackage: PurchasesPackage, discount: PurchasesPaymentDiscount): Promise<MakePurchaseResult>;
     /**
      * Restores a user's previous purchases and links their appUserIDs to any user's also using those purchases.
-     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a userInfo object with more information.
+     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and an
+     * userInfo object with more information. The promise will be also be rejected if setup has not been called yet.
      */
     static restoreTransactions(): Promise<PurchaserInfo>;
     /**
      * Get the appUserID
-     * @returns {string} The app user id in a promise
+     * @returns {Promise<string>} The app user id in a promise
      */
-    static getAppUserID(): string;
+    static getAppUserID(): Promise<string>;
     /**
      * This function will logIn the current user with an appUserID. Typically this would be used after a log in
      * to identify a user without calling configure.
      * @param {String} appUserID The appUserID that should be linked to the currently user
-     * @returns {Promise<LogInResult>} A promise of an object that contains the purchaserInfo after logging in, as well as a boolean indicating
-     * whether the user has just been created for the first time in the RevenueCat backend.
+     * @returns {Promise<LogInResult>} A promise of an object that contains the purchaserInfo after logging in, as well
+     * as a boolean indicating whether the user has just been created for the first time in the RevenueCat backend. The
+     * promise will be rejected if setup has not been called yet or if there's an issue logging in.
      */
     static logIn(appUserID: string): Promise<LogInResult>;
     /**
      * Logs out the Purchases client clearing the saved appUserID. This will generate a random user id and save it in the cache.
-     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a userInfo object with more information.
+     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code,
+     * and a userInfo object with more information. The promise will be rejected if setup has not been called yet or if
+     * there's an issue logging out.
      */
     static logOut(): Promise<PurchaserInfo>;
     /**
      * @deprecated, use logIn instead.
      * This function will alias two appUserIDs together.
-     * @param {String} newAppUserID The new appUserID that should be linked to the currently identified appUserID. Needs to be a string.
-     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a userInfo object with more information.
+     * @param {String} newAppUserID The new appUserID that should be linked to the currently identified appUserID.
+     * Needs to be a string.
+     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a
+     * userInfo object with more information. The promise will be rejected if setup has not been called yet or if
+     * there's an issue creating the alias.
      */
     static createAlias(newAppUserID: string): Promise<PurchaserInfo>;
     /**
      * @deprecated, use logIn instead.
-     * This function will identify the current user with an appUserID. Typically this would be used after a logout to identify a new user without calling configure
+     * This function will identify the current user with an appUserID. Typically this would be used after a logout to
+     * identify a new user without calling configure
      * @param {String} newAppUserID The appUserID that should be linked to the currently user
-     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a userInfo object with more information.
+     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and an
+     * userInfo object with more information. The promise will be rejected if setup has not been called yet or if
+     * there's an issue identifying the user.
      */
     static identify(newAppUserID: string): Promise<PurchaserInfo>;
     /**
      * @deprecated, use logOut instead.
-     * Resets the Purchases client clearing the saved appUserID. This will generate a random user id and save it in the cache.
-     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a userInfo object with more information.
+     * Resets the Purchases client clearing the saved appUserID. This will generate a random user id and save it in the
+     *  cache.
+     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and an
+     * userInfo object with more information. The promise will be rejected if setup has not been called yet or if
+     * there's an issue resetting the user.
      */
     static reset(): Promise<PurchaserInfo>;
     /**
      * Enables/Disables debugs logs
      * @param {boolean} enabled Enable or not debug logs
      */
-    static setDebugLogsEnabled(enabled: boolean): void;
+    static setDebugLogsEnabled(enabled: boolean): Promise<void>;
     /**
      * Gets current purchaser info
-     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and a userInfo object with more information.
+     * @returns {Promise<PurchaserInfo>} A promise of a purchaser info object. Rejections return an error code, and an
+     * userInfo object with more information. The promise will be rejected if setup has not been called yet or if
+     * there's an issue getting the purchaser information.
      */
     static getPurchaserInfo(): Promise<PurchaserInfo>;
     /**
      * This method will send all the purchases to the RevenueCat backend. Call this when using your own implementation
      * for subscriptions anytime a sync is needed, like after a successful purchase.
      *
-     * @warning This function should only be called if you're not calling makePurchase.
+     * @warning This function should only be called if you're not calling purchaseProduct/purchasePackage.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * syncing purchases.
      */
-    static syncPurchases(): void;
+    static syncPurchases(): Promise<void>;
     /**
      * 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 setup has not been called yet.
      */
-    static setAutomaticAppleSearchAdsAttributionCollection(enabled: boolean): void;
+    static setAutomaticAppleSearchAdsAttributionCollection(enabled: boolean): Promise<void>;
     /**
      * @returns { Promise<boolean> } If the `appUserID` has been generated by RevenueCat or not.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet.
      */
     static isAnonymous(): Promise<boolean>;
     /**
-     *  iOS only. Computes whether or not a user is eligible for the introductory pricing period of a given product.
-     *  You should use this method to determine whether or not you show the user the normal product price or the
-     *  introductory price. This also applies to trials (trials are considered a type of introductory pricing).
+     * iOS only. Computes whether or not a user is eligible for the introductory pricing period of a given product.
+     * You should use this method to determine whether or not you show the user the normal product price or the
+     * introductory price. This also applies to trials (trials are considered a type of introductory pricing).
      *
-     *  @note Subscription groups are automatically collected for determining eligibility. If RevenueCat can't
-     *  definitively compute the eligibility, most likely because of missing group information, it will return
-     *  `INTRO_ELIGIBILITY_STATUS_UNKNOWN`. The best course of action on unknown status is to display the non-intro
-     *  pricing, to not create a misleading situation. To avoid this, make sure you are testing with the latest version of
-     *  iOS so that the subscription group can be collected by the SDK. Android always returns INTRO_ELIGIBILITY_STATUS_UNKNOWN.
+     * @note Subscription groups are automatically collected for determining eligibility. If RevenueCat can't
+     * definitively compute the eligibility, most likely because of missing group information, it will return
+     * `INTRO_ELIGIBILITY_STATUS_UNKNOWN`. The best course of action on unknown status is to display the non-intro
+     * pricing, to not create a misleading situation. To avoid this, make sure you are testing with the latest version of
+     * iOS so that the subscription group can be collected by the SDK. Android always returns INTRO_ELIGIBILITY_STATUS_UNKNOWN.
      *
-     *  @param productIdentifiers Array of product identifiers for which you want to compute eligibility
-     *  @returns { Promise<[productId: string]: IntroEligibility> } A map of IntroEligility per productId
+     * @param productIdentifiers Array of product identifiers for which you want to compute eligibility
+     * @returns { Promise<[productId: string]: IntroEligibility> } A map of IntroEligility per productId. The promise
+     * will be rejected if setup has not been called yet or if there's in an error checking eligibility.
      */
     static checkTrialOrIntroductoryPriceEligibility(productIdentifiers: string[]): Promise<{
         [productId: string]: IntroEligibility;
     }>;
     /**
-     *  iOS only. Use this function to retrieve the `PurchasesPaymentDiscount` for a given `PurchasesPackage`.
+     * iOS only. Use this function to retrieve the `PurchasesPaymentDiscount` for a given `PurchasesPackage`.
      *
-     *  @param product The `PurchasesProduct` the user intends to purchase.
-     *  @param discount The `PurchasesDiscount` to apply to the product.
-     *  @returns { Promise<PurchasesPaymentDiscount> } Returns when the `PurchasesPaymentDiscount` is returned. Null is returned for Android and incompatible iOS versions.
+     * @param product The `PurchasesProduct` the user intends to purchase.
+     * @param discount The `PurchasesDiscount` to apply to the product.
+     * @returns { Promise<PurchasesPaymentDiscount> } Returns when the `PurchasesPaymentDiscount` is returned.
+     * Null is returned for Android and incompatible iOS versions. The promise will be rejected if setup has not been
+     * called yet or if there's an error getting the payment discount.
      */
     static getPaymentDiscount(product: PurchasesProduct, discount: PurchasesDiscount): Promise<PurchasesPaymentDiscount | undefined>;
     /**
@@ -347,13 +384,17 @@ export default class Purchases {
      *
      * This is useful for cases where purchaser information might have been updated outside of the app, like if a
      * promotional subscription is granted through the RevenueCat dashboard.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or there's an error
+     * invalidating the purchaser info cache.
      */
-    static invalidatePurchaserInfoCache(): void;
+    static invalidatePurchaserInfoCache(): Promise<void>;
     /** iOS only. Presents a code redemption sheet, useful for redeeming offer codes
      * Refer to https://docs.revenuecat.com/docs/ios-subscription-offers#offer-codes for more information on how
      * to configure and use offer codes
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or there's an error
+     * presenting the code redemption sheet.
      */
-    static presentCodeRedemptionSheet(): void;
+    static presentCodeRedemptionSheet(): Promise<void>;
     /**
      * Subscriber attributes are useful for storing additional, structured information on a user.
      * Since attributes are writable using a public key they should not be used for
@@ -363,124 +404,178 @@ export default class Purchases {
      * restrictions refer to our guide: https://docs.revenuecat.com/docs/subscriber-attributes
      *
      * @param attributes Map of attributes by key. Set the value as an empty string to delete an attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or there's an error
+     * setting the subscriber attributes.
      */
     static setAttributes(attributes: {
         [key: string]: string | null;
-    }): void;
+    }): Promise<void>;
     /**
      * Subscriber attribute associated with the email address for the user
      *
      * @param email Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the email.
      */
-    static setEmail(email: string | null): void;
+    static setEmail(email: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the phone number for the user
      *
      * @param phoneNumber Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the phone number.
      */
-    static setPhoneNumber(phoneNumber: string | null): void;
+    static setPhoneNumber(phoneNumber: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the display name for the user
      *
      * @param displayName Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the display name.
      */
-    static setDisplayName(displayName: string | null): void;
+    static setDisplayName(displayName: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the push token for the user
      *
      * @param pushToken null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the push token.
      */
-    static setPushToken(pushToken: string | null): void;
+    static setPushToken(pushToken: string | null): Promise<void>;
     /**
-     * Set this property to your proxy URL before configuring Purchases *only* if you've received a proxy key value from your RevenueCat contact.
+     * 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 setup has not been called yet or if there's an error
+     * setting the proxy url.
      */
-    static setProxyURL(url: string): void;
+    static setProxyURL(url: string): Promise<void>;
     /**
      * Automatically collect subscriber attributes associated with the device identifiers.
      * $idfa, $idfv, $ip on iOS
      * $gpsAdId, $androidId, $ip on Android
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting collecting the device identifiers.
      */
-    static collectDeviceIdentifiers(): void;
+    static collectDeviceIdentifiers(): Promise<void>;
     /**
      * Subscriber attribute associated with the Adjust Id for the user
      * Required for the RevenueCat Adjust integration
      *
      * @param adjustID Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting Adjust ID.
      */
-    static setAdjustID(adjustID: string | null): void;
+    static setAdjustID(adjustID: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the AppsFlyer Id for the user
      * Required for the RevenueCat AppsFlyer integration
      * @param appsflyerID Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the Appsflyer ID.
      */
-    static setAppsflyerID(appsflyerID: string | null): void;
+    static setAppsflyerID(appsflyerID: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the Facebook SDK Anonymous Id for the user
      * Recommended for the RevenueCat Facebook integration
      *
      * @param fbAnonymousID Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the Facebook Anonymous ID.
      */
-    static setFBAnonymousID(fbAnonymousID: string | null): void;
+    static setFBAnonymousID(fbAnonymousID: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the mParticle Id for the user
      * Recommended for the RevenueCat mParticle integration
      *
      * @param mparticleID Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the Mparticle ID.
      */
-    static setMparticleID(mparticleID: string | null): void;
+    static setMparticleID(mparticleID: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the OneSignal Player Id for the user
      * Required for the RevenueCat OneSignal integration
      *
      * @param onesignalID Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the Onesignal ID.
+     */
+    static setOnesignalID(onesignalID: string | null): Promise<void>;
+    /**
+     * Subscriber attribute associated with the Airship Channel Id for the user
+     * Required for the RevenueCat Airship integration
+     *
+     * @param airshipChannelID Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the Airship Channel ID.
      */
-    static setOnesignalID(onesignalID: string | null): void;
+    static setAirshipChannelID(airshipChannelID: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the install media source for the user
      *
      * @param mediaSource Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the media source.
      */
-    static setMediaSource(mediaSource: string | null): void;
+    static setMediaSource(mediaSource: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the install campaign for the user
      *
      * @param campaign Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the campaign.
      */
-    static setCampaign(campaign: string | null): void;
+    static setCampaign(campaign: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the install ad group for the user
      *
      * @param adGroup Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting ad group.
      */
-    static setAdGroup(adGroup: string | null): void;
+    static setAdGroup(adGroup: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the install ad for the user
      *
      * @param ad Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the ad subscriber attribute.
      */
-    static setAd(ad: string | null): void;
+    static setAd(ad: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the install keyword for the user
      *
      * @param keyword Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the keyword.
      */
-    static setKeyword(keyword: string | null): void;
+    static setKeyword(keyword: string | null): Promise<void>;
     /**
      * Subscriber attribute associated with the install ad creative for the user
      *
      * @param creative Empty String or null will delete the subscriber attribute.
+     * @returns {Promise<void>} The promise will be rejected if setup has not been called yet or if there's an error
+     * setting the creative subscriber attribute.
      */
-    static setCreative(creative: string | null): void;
+    static setCreative(creative: string | null): Promise<void>;
     /**
      * Check if billing is supported for the current user (meaning IN-APP purchases are supported)
      * and optionally, whether a list of specified feature types are supported.
      *
      * Note: Billing features are only relevant to Google Play Android users.
      * For other stores and platforms, billing features won't be checked.
+     *
      * @param feature An array of feature types to check for support. Feature types must be one of
      *       [BILLING_FEATURE]. By default, is an empty list and no specific feature support will be checked.
-     * @returns {Promise<Boolean>} promise with boolean response
+     * @returns {Promise<Boolean>} promise with boolean response. True if billing is supported, false otherwise.
      */
     static canMakePayments(features?: BILLING_FEATURE[]): Promise<boolean>;
+    /**
+     * Check if setup has finished and Purchases has been configured.
+     *
+     * @returns {Promise<Boolean>} promise with boolean response
+     */
+    static isConfigured(): Promise<boolean>;
+    private static throwIfNotConfigured;
 }
 export {};