react-native-purchases 9.0.0 → 9.2.0

package/dist/browser/typeGuards.d.ts

@@ -0,0 +1,23 @@
+import { CustomerInfo, MakePurchaseResult, PurchasesOffering, PurchasesOfferings } from '@revenuecat/purchases-typescript-internal';
+/**
+ * Type guard function type - returns true if value matches type T
+ */
+type TypeGuard<T> = (value: any) => value is T;
+/**
+ * Type-safe transformation function that validates purchases-js output matches expected type
+ * @param value - The value from purchases-js
+ * @param typeGuard - Runtime type guard function that validates the structure
+ * @param typeName - String description of expected type for logging
+ * @returns The value cast to expected type T
+ * @throws {Error} If type validation fails
+ */
+export declare function validateAndTransform<T>(value: any, typeGuard: TypeGuard<T>, typeName: string): T;
+export declare function isCustomerInfo(value: any): value is CustomerInfo;
+export declare function isPurchasesOfferings(value: any): value is PurchasesOfferings;
+export declare function isPurchasesOffering(value: any): value is PurchasesOffering;
+export declare function isLogInResult(value: any): value is {
+    customerInfo: CustomerInfo;
+    created: boolean;
+};
+export declare function isMakePurchaseResult(value: any): value is MakePurchaseResult;
+export {};

package/dist/browser/typeGuards.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMakePurchaseResult = exports.isLogInResult = exports.isPurchasesOffering = exports.isPurchasesOfferings = exports.isCustomerInfo = exports.validateAndTransform = void 0;
+/**
+ * Type-safe transformation function that validates purchases-js output matches expected type
+ * @param value - The value from purchases-js
+ * @param typeGuard - Runtime type guard function that validates the structure
+ * @param typeName - String description of expected type for logging
+ * @returns The value cast to expected type T
+ * @throws {Error} If type validation fails
+ */
+function validateAndTransform(value, typeGuard, typeName) {
+    if (value === null || value === undefined) {
+        if (typeName.includes('null')) {
+            return value;
+        }
+        console.error("Type validation failed: Expected ".concat(typeName, ", got ").concat(value));
+        throw new Error("Type validation failed: Expected ".concat(typeName, ", got ").concat(value));
+    }
+    if (typeGuard(value)) {
+        return value;
+    }
+    console.error("Type validation failed: Expected ".concat(typeName, ", got:"), value);
+    throw new Error("Type validation failed: Expected ".concat(typeName, ", received invalid structure"));
+}
+exports.validateAndTransform = validateAndTransform;
+// Type guards for the interfaces we use
+function isCustomerInfo(value) {
+    return value && typeof value === 'object' &&
+        typeof value.originalAppUserId === 'string' &&
+        typeof value.entitlements === 'object';
+}
+exports.isCustomerInfo = isCustomerInfo;
+function isPurchasesOfferings(value) {
+    return value && typeof value === 'object' &&
+        typeof value.all === 'object' &&
+        (value.current === null || typeof value.current === 'object');
+}
+exports.isPurchasesOfferings = isPurchasesOfferings;
+function isPurchasesOffering(value) {
+    return value && typeof value === 'object' &&
+        typeof value.identifier === 'string' &&
+        typeof value.serverDescription === 'string' &&
+        Array.isArray(value.availablePackages);
+}
+exports.isPurchasesOffering = isPurchasesOffering;
+function isLogInResult(value) {
+    return value && typeof value === 'object' &&
+        typeof value.customerInfo === 'object' &&
+        typeof value.created === 'boolean' &&
+        isCustomerInfo(value.customerInfo);
+}
+exports.isLogInResult = isLogInResult;
+function isMakePurchaseResult(value) {
+    return value && typeof value === 'object' &&
+        typeof value.productIdentifier === 'string' &&
+        typeof value.customerInfo === 'object' &&
+        isCustomerInfo(value.customerInfo) &&
+        typeof value.transaction === 'object';
+}
+exports.isMakePurchaseResult = isMakePurchaseResult;

package/dist/browser/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Helper function to ensure PurchasesCommon is configured before making API calls
+ * @throws {Error} If PurchasesCommon is not configured
+ */
+export declare function ensurePurchasesConfigured(): void;
+export declare function methodNotSupportedOnWeb(methodName: string): void;

package/dist/browser/utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.methodNotSupportedOnWeb = exports.ensurePurchasesConfigured = void 0;
+var purchases_js_hybrid_mappings_1 = require("@revenuecat/purchases-js-hybrid-mappings");
+/**
+ * Helper function to ensure PurchasesCommon is configured before making API calls
+ * @throws {Error} If PurchasesCommon is not configured
+ */
+function ensurePurchasesConfigured() {
+    if (!purchases_js_hybrid_mappings_1.PurchasesCommon.isConfigured()) {
+        throw new Error('PurchasesCommon is not configured. Call setupPurchases first.');
+    }
+}
+exports.ensurePurchasesConfigured = ensurePurchasesConfigured;
+function methodNotSupportedOnWeb(methodName) {
+    throw new Error("".concat(methodName, " is not supported on web platform."));
+}
+exports.methodNotSupportedOnWeb = methodNotSupportedOnWeb;

package/dist/purchases.d.ts

@@ -1,4 +1,4 @@
-import { PURCHASES_ERROR_CODE, UninitializedPurchasesError, UnsupportedPlatformError, CustomerInfo, PurchasesEntitlementInfo, PRORATION_MODE, PACKAGE_TYPE, INTRO_ELIGIBILITY_STATUS, PurchasesOfferings, PurchasesStoreProduct, UpgradeInfo, PurchasesPromotionalOffer, PurchasesPackage, IntroEligibility, PurchasesStoreProductDiscount, SubscriptionOption, PRODUCT_CATEGORY, GoogleProductChangeInfo, PURCHASE_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, IN_APP_MESSAGE_TYPE, ENTITLEMENT_VERIFICATION_MODE, VERIFICATION_RESULT, STOREKIT_VERSION, PurchasesStoreTransaction, PurchasesOffering, PURCHASES_ARE_COMPLETED_BY_TYPE, PurchasesWinBackOffer, WebPurchaseRedemption, WebPurchaseRedemptionResult, Storefront } from "@revenuecat/purchases-typescript-internal";
+import { PURCHASES_ERROR_CODE, UninitializedPurchasesError, UnsupportedPlatformError, CustomerInfo, PurchasesEntitlementInfo, PRORATION_MODE, PACKAGE_TYPE, INTRO_ELIGIBILITY_STATUS, PurchasesOfferings, PurchasesStoreProduct, UpgradeInfo, PurchasesPromotionalOffer, PurchasesPackage, IntroEligibility, PurchasesStoreProductDiscount, SubscriptionOption, PRODUCT_CATEGORY, GoogleProductChangeInfo, PURCHASE_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, IN_APP_MESSAGE_TYPE, ENTITLEMENT_VERIFICATION_MODE, VERIFICATION_RESULT, STOREKIT_VERSION, PurchasesStoreTransaction, PurchasesOffering, PURCHASES_ARE_COMPLETED_BY_TYPE, PurchasesVirtualCurrencies, PurchasesWinBackOffer, WebPurchaseRedemption, WebPurchaseRedemptionResult, Storefront } from "@revenuecat/purchases-typescript-internal";
 export { PURCHASE_TYPE, PurchasesAreCompletedBy, PurchasesAreCompletedByMyApp, PURCHASES_ARE_COMPLETED_BY_TYPE, BILLING_FEATURE, REFUND_REQUEST_STATUS, LOG_LEVEL, STOREKIT_VERSION, PurchasesConfiguration, CustomerInfoUpdateListener, ShouldPurchasePromoProductListener, MakePurchaseResult, LogHandler, LogInResult, } from "@revenuecat/purchases-typescript-internal";
 export default class Purchases {
     /**
@@ -780,6 +780,33 @@ export default class Purchases {
      * WebPurchaseRedemption parameter is passed or Purchases is not configured.
      */
     static redeemWebPurchase(webPurchaseRedemption: WebPurchaseRedemption): Promise<WebPurchaseRedemptionResult>;
+    /**
+     * Fetches the virtual currencies for the current subscriber.
+     *
+     * @returns {Promise<PurchasesVirtualCurrencies>} A PurchasesVirtualCurrencies object containing the subscriber's virtual currencies.
+     * The promise will be rejected if configure has not been called yet or if an error occurs.
+     */
+    static getVirtualCurrencies(): Promise<PurchasesVirtualCurrencies>;
+    /**
+     * Invalidates the cache for virtual currencies.
+     *
+     * This is useful for cases where a virtual currency's balance might have been updated
+     * outside of the app, like if you decreased a user's balance from the user spending a virtual currency,
+     * or if you increased the balance from your backend using the server APIs.
+     *
+     * @returns {Promise<void>} The promise will be rejected if configure has not been called yet or there's an error
+     * invalidating the virtual currencies cache.
+     */
+    static invalidateVirtualCurrenciesCache(): Promise<void>;
+    /**
+     * The currently cached [PurchasesVirtualCurrencies] if one is available.
+     * This value will remain null until virtual currencies have been fetched at
+     * least once with [Purchases.getVirtualCurrencies] or an equivalent function.
+     *
+     * @returns {Promise<PurchasesVirtualCurrencies | null>} The currently cached virtual currencies for the current subscriber.
+     * The promise will be rejected if configure has not been called yet or there's an error.
+     */
+    static getCachedVirtualCurrencies(): Promise<PurchasesVirtualCurrencies | null>;
     /**
      * Check if configure has finished and Purchases has been configured.
      *
@@ -787,7 +814,6 @@ export default class Purchases {
      */
     static isConfigured(): Promise<boolean>;
     private static throwIfNotConfigured;
-    private static logWarningIfPreviewAPIMode;
     private static throwIfAndroidPlatform;
     private static throwIfIOSPlatform;
     private static isPurchasesAreCompletedByMyApp;