@capgo/native-purchases 7.12.7 → 7.13.0

package/README.md

@@ -1450,14 +1450,14 @@ Restores a user's previous  and links their appUserIDs to any user's also using
 ### purchaseProduct(...)
 
 ```typescript
-purchaseProduct(options: { productIdentifier: string; planIdentifier?: string; productType?: PURCHASE_TYPE; quantity?: number; appAccountToken?: string; }) => Promise<Transaction>
+purchaseProduct(options: { productIdentifier: string; planIdentifier?: string; productType?: PURCHASE_TYPE; quantity?: number; appAccountToken?: string; isConsumable?: boolean; }) => Promise<Transaction>
 ```
 
 Started purchase process for the given product.
 
-| Param         | Type                                                                                                                                                                        | Description               |
-| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
-| **`options`** | <code>{ productIdentifier: string; planIdentifier?: string; productType?: <a href="#purchase_type">PURCHASE_TYPE</a>; quantity?: number; appAccountToken?: string; }</code> | - The product to purchase |
+| Param         | Type                                                                                                                                                                                                | Description               |
+| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| **`options`** | <code>{ productIdentifier: string; planIdentifier?: string; productType?: <a href="#purchase_type">PURCHASE_TYPE</a>; quantity?: number; appAccountToken?: string; isConsumable?: boolean; }</code> | - The product to purchase |
 
 **Returns:** <code>Promise&lt;<a href="#transaction">Transaction</a>&gt;</code>
 

package/android/src/main/java/ee/forgr/nativepurchases/NativePurchasesPlugin.java

@@ -39,7 +39,7 @@ import org.json.JSONArray;
 @CapacitorPlugin(name = "NativePurchases")
 public class NativePurchasesPlugin extends Plugin {
 
-    private final String pluginVersion = "7.12.7";
+    private final String pluginVersion = "7.13.0";
     public static final String TAG = "NativePurchases";
     private static final Phaser semaphoreReady = new Phaser(1);
     private BillingClient billingClient;
@@ -120,19 +120,27 @@ public class NativePurchasesPlugin extends Plugin {
 
         if (purchase.getPurchaseState() == Purchase.PurchaseState.PURCHASED) {
             Log.d(TAG, "Purchase state is PURCHASED");
-            // Grant entitlement to the user, then acknowledge the purchase
-            //     if sub then acknowledgePurchase
-            //      if one time then consumePurchase
+            boolean isConsumable = purchaseCall != null && purchaseCall.getBoolean("isConsumable", false);
+            PurchaseAction action = PurchaseActionDecider.decide(isConsumable, purchase);
+
             AccountIdentifiers accountIdentifiers = purchase.getAccountIdentifiers();
             String purchaseAccountId = accountIdentifiers != null ? accountIdentifiers.getObfuscatedAccountId() : null;
             Log.d(TAG, "Purchase account identifier present: " + (purchaseAccountId != null ? "[REDACTED]" : "none"));
-            if (purchase.isAcknowledged()) {
-                Log.d(TAG, "Purchase already acknowledged, consuming...");
-                ConsumeParams consumeParams = ConsumeParams.newBuilder().setPurchaseToken(purchase.getPurchaseToken()).build();
-                billingClient.consumeAsync(consumeParams, this::onConsumeResponse);
-            } else {
-                Log.d(TAG, "Purchase not acknowledged, acknowledging...");
-                acknowledgePurchase(purchase.getPurchaseToken());
+
+            switch (action) {
+                case CONSUME:
+                    Log.d(TAG, "Purchase flagged as consumable, consuming...");
+                    ConsumeParams consumeParams = ConsumeParams.newBuilder().setPurchaseToken(purchase.getPurchaseToken()).build();
+                    billingClient.consumeAsync(consumeParams, this::onConsumeResponse);
+                    break;
+                case ACKNOWLEDGE:
+                    Log.d(TAG, "Purchase not acknowledged, acknowledging...");
+                    acknowledgePurchase(purchase.getPurchaseToken());
+                    break;
+                case NONE:
+                default:
+                    Log.d(TAG, "No additional purchase handling required");
+                    break;
             }
 
             JSObject ret = new JSObject();
@@ -307,12 +315,14 @@ public class NativePurchasesPlugin extends Plugin {
         Number quantity = call.getInt("quantity", 1);
         String appAccountToken = call.getString("appAccountToken");
         final String accountIdentifier = appAccountToken != null && !appAccountToken.isEmpty() ? appAccountToken : null;
+        boolean isConsumable = call.getBoolean("isConsumable", false);
 
         Log.d(TAG, "Product identifier: " + productIdentifier);
         Log.d(TAG, "Plan identifier: " + planIdentifier);
         Log.d(TAG, "Product type: " + productType);
         Log.d(TAG, "Quantity: " + quantity);
         Log.d(TAG, "Account identifier provided: " + (accountIdentifier != null ? "[REDACTED]" : "none"));
+        Log.d(TAG, "Is consumable: " + isConsumable);
 
         // cannot use quantity, because it's done in native modal
         Log.d("CapacitorPurchases", "purchaseProduct: " + productIdentifier);
@@ -341,6 +351,12 @@ public class NativePurchasesPlugin extends Plugin {
             call.reject("quantity is less than 1");
             return;
         }
+        if (isConsumable && productType.equals("subs")) {
+            Log.d(TAG, "isConsumable is not supported for subscriptions, ignoring flag");
+            isConsumable = false;
+        }
+
+        call.getData().put("isConsumable", isConsumable);
 
         // For subscriptions, always use the productIdentifier (subscription ID) to query
         // The planIdentifier is used later when setting the offer token
@@ -456,13 +472,12 @@ public class NativePurchasesPlugin extends Plugin {
                 Log.d(TAG, "Processing purchase: " + purchase.getOrderId());
                 Log.d(TAG, "Purchase state: " + purchase.getPurchaseState());
                 if (purchase.getPurchaseState() == Purchase.PurchaseState.PURCHASED) {
-                    if (purchase.isAcknowledged()) {
-                        Log.d(TAG, "Purchase already acknowledged, consuming");
-                        ConsumeParams consumeParams = ConsumeParams.newBuilder().setPurchaseToken(purchase.getPurchaseToken()).build();
-                        billingClient.consumeAsync(consumeParams, this::onConsumeResponse);
-                    } else {
+                    PurchaseAction action = PurchaseActionDecider.decide(false, purchase);
+                    if (action == PurchaseAction.ACKNOWLEDGE) {
                         Log.d(TAG, "Purchase not acknowledged, acknowledging");
                         acknowledgePurchase(purchase.getPurchaseToken());
+                    } else {
+                        Log.d(TAG, "Purchase already acknowledged, skipping consume");
                     }
                 }
             }

package/android/src/main/java/ee/forgr/nativepurchases/PurchaseActionDecider.java

@@ -0,0 +1,58 @@
+package ee.forgr.nativepurchases;
+
+import com.android.billingclient.api.Purchase;
+
+enum PurchaseAction {
+    CONSUME,
+    ACKNOWLEDGE,
+    NONE
+}
+
+final class PurchaseActionDecider {
+
+    private PurchaseActionDecider() {}
+
+    static PurchaseAction decide(boolean isConsumable, Purchase purchase) {
+        return decide(isConsumable, purchase == null ? null : new PurchaseDetailsAdapter(purchase));
+    }
+
+    static PurchaseAction decide(boolean isConsumable, PurchaseDetails purchase) {
+        if (purchase == null) {
+            return PurchaseAction.NONE;
+        }
+        if (purchase.getPurchaseState() != Purchase.PurchaseState.PURCHASED) {
+            return PurchaseAction.NONE;
+        }
+        if (isConsumable) {
+            return PurchaseAction.CONSUME;
+        }
+        if (purchase.isAcknowledged()) {
+            return PurchaseAction.NONE;
+        }
+        return PurchaseAction.ACKNOWLEDGE;
+    }
+
+    interface PurchaseDetails {
+        int getPurchaseState();
+        boolean isAcknowledged();
+    }
+
+    private static final class PurchaseDetailsAdapter implements PurchaseDetails {
+
+        private final Purchase purchase;
+
+        PurchaseDetailsAdapter(Purchase purchase) {
+            this.purchase = purchase;
+        }
+
+        @Override
+        public int getPurchaseState() {
+            return purchase.getPurchaseState();
+        }
+
+        @Override
+        public boolean isAcknowledged() {
+            return purchase.isAcknowledged();
+        }
+    }
+}

package/dist/docs.json

@@ -17,12 +17,12 @@
       },
       {
         "name": "purchaseProduct",
-        "signature": "(options: { productIdentifier: string; planIdentifier?: string; productType?: PURCHASE_TYPE; quantity?: number; appAccountToken?: string; }) => Promise<Transaction>",
+        "signature": "(options: { productIdentifier: string; planIdentifier?: string; productType?: PURCHASE_TYPE; quantity?: number; appAccountToken?: string; isConsumable?: boolean; }) => Promise<Transaction>",
         "parameters": [
           {
             "name": "options",
             "docs": "- The product to purchase",
-            "type": "{ productIdentifier: string; planIdentifier?: string | undefined; productType?: PURCHASE_TYPE | undefined; quantity?: number | undefined; appAccountToken?: string | undefined; }"
+            "type": "{ productIdentifier: string; planIdentifier?: string | undefined; productType?: PURCHASE_TYPE | undefined; quantity?: number | undefined; appAccountToken?: string | undefined; isConsumable?: boolean | undefined; }"
           }
         ],
         "returns": "Promise<Transaction>",
@@ -50,6 +50,10 @@
           {
             "name": "param",
             "text": "options.appAccountToken - Optional identifier uniquely associated with the user's account in your app.\n  PLATFORM REQUIREMENTS:\n  - iOS: Must be a valid UUID format (StoreKit 2 requirement)\n  - Android: Can be any obfuscated string (max 64 chars), maps to ObfuscatedAccountId\n  SECURITY: DO NOT use PII like emails in cleartext - use UUID or hashed value.\n  RECOMMENDED: Use UUID v5 with deterministic generation for cross-platform compatibility."
+          },
+          {
+            "name": "param",
+            "text": "options.isConsumable - Only Android, when true the purchase token is consumed after granting entitlement (for consumable in-app items). Defaults to false."
           }
         ],
         "docs": "Started purchase process for the given product.",

package/dist/esm/definitions.d.ts

@@ -459,6 +459,7 @@ export interface NativePurchasesPlugin {
      *                                  - Android: Can be any obfuscated string (max 64 chars), maps to ObfuscatedAccountId
      *                                  SECURITY: DO NOT use PII like emails in cleartext - use UUID or hashed value.
      *                                  RECOMMENDED: Use UUID v5 with deterministic generation for cross-platform compatibility.
+     * @param options.isConsumable - Only Android, when true the purchase token is consumed after granting entitlement (for consumable in-app items). Defaults to false.
      */
     purchaseProduct(options: {
         productIdentifier: string;
@@ -466,6 +467,7 @@ export interface NativePurchasesPlugin {
         productType?: PURCHASE_TYPE;
         quantity?: number;
         appAccountToken?: string;
+        isConsumable?: boolean;
     }): Promise<Transaction>;
     /**
      * Gets the product info associated with a list of product identifiers.

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,qFAAoB,CAAA;IACpB,iEAAU,CAAA;IACV,uEAAa,CAAA;IACb,iEAAU,CAAA;IACV,iEAAU,CAAA;IACV,qEAAY,CAAA;AACd,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B;AAED,MAAM,CAAN,IAAY,aAUX;AAVD,WAAY,aAAa;IACvB;;OAEG;IACH,gCAAe,CAAA;IAEf;;OAEG;IACH,8BAAa,CAAA;AACf,CAAC,EAVW,aAAa,KAAb,aAAa,QAUxB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,eAyBX;AAzBD,WAAY,eAAe;IACzB;;OAEG;IACH,uEAAa,CAAA;IAEb;;OAEG;IACH,qFAAoB,CAAA;IAEpB;;OAEG;IACH,iFAAkB,CAAA;IAElB;;OAEG;IACH,mFAAmB,CAAA;IAEnB;;OAEG;IACH,+FAAyB,CAAA;AAC3B,CAAC,EAzBW,eAAe,KAAf,eAAe,QAyB1B;AACD,MAAM,CAAN,IAAY,cA2BX;AA3BD,WAAY,cAAc;IACxB,qIAAiD,CAAA;IAEjD;;;OAGG;IACH,qGAAiC,CAAA;IAEjC;;;;OAIG;IACH,iHAAuC,CAAA;IAEvC;;;OAGG;IACH,iGAA+B,CAAA;IAE/B;;;OAGG;IACH,2DAAY,CAAA;AACd,CAAC,EA3BW,cAAc,KAAd,cAAc,QA2BzB;AAED,MAAM,CAAN,IAAY,YA6CX;AA7CD,WAAY,YAAY;IACtB;;OAEG;IACH,mCAAmB,CAAA;IAEnB;;OAEG;IACH,iCAAiB,CAAA;IAEjB;;OAEG;IACH,qCAAqB,CAAA;IAErB;;OAEG;IACH,iCAAiB,CAAA;IAEjB;;OAEG;IACH,uCAAuB,CAAA;IAEvB;;OAEG;IACH,2CAA2B,CAAA;IAE3B;;OAEG;IACH,uCAAuB,CAAA;IAEvB;;OAEG;IACH,mCAAmB,CAAA;IAEnB;;OAEG;IACH,iCAAiB,CAAA;AACnB,CAAC,EA7CW,YAAY,KAAZ,YAAY,QA6CvB;AAED,MAAM,CAAN,IAAY,wBAaX;AAbD,WAAY,wBAAwB;IAClC;;OAEG;IACH,+HAAoC,CAAA;IACpC;;OAEG;IACH,qIAAmC,CAAA;IACnC;;OAEG;IACH,iIAAiC,CAAA;AACnC,CAAC,EAbW,wBAAwB,KAAxB,wBAAwB,QAanC","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport enum ATTRIBUTION_NETWORK {\n  APPLE_SEARCH_ADS = 0,\n  ADJUST = 1,\n  APPSFLYER = 2,\n  BRANCH = 3,\n  TENJIN = 4,\n  FACEBOOK = 5,\n}\n\nexport enum PURCHASE_TYPE {\n  /**\n   * A type of SKU for in-app products.\n   */\n  INAPP = 'inapp',\n\n  /**\n   * A type of SKU for subscriptions.\n   */\n  SUBS = 'subs',\n}\n\n/**\n * Enum for billing features.\n * Currently, these are only relevant for Google Play Android users:\n * https://developer.android.com/reference/com/android/billingclient/api/BillingClient.FeatureType\n */\nexport enum BILLING_FEATURE {\n  /**\n   * Purchase/query for subscriptions.\n   */\n  SUBSCRIPTIONS,\n\n  /**\n   * Subscriptions update/replace.\n   */\n  SUBSCRIPTIONS_UPDATE,\n\n  /**\n   * Purchase/query for in-app items on VR.\n   */\n  IN_APP_ITEMS_ON_VR,\n\n  /**\n   * Purchase/query for subscriptions on VR.\n   */\n  SUBSCRIPTIONS_ON_VR,\n\n  /**\n   * Launch a price change confirmation flow.\n   */\n  PRICE_CHANGE_CONFIRMATION,\n}\nexport enum PRORATION_MODE {\n  UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY = 0,\n\n  /**\n   * Replacement takes effect immediately, and the remaining time will be\n   * prorated and credited to the user. This is the current default behavior.\n   */\n  IMMEDIATE_WITH_TIME_PRORATION = 1,\n\n  /**\n   * Replacement takes effect immediately, and the billing cycle remains the\n   * same. The price for the remaining period will be charged. This option is\n   * only available for subscription upgrade.\n   */\n  IMMEDIATE_AND_CHARGE_PRORATED_PRICE = 2,\n\n  /**\n   * Replacement takes effect immediately, and the new price will be charged on\n   * next recurrence time. The billing cycle stays the same.\n   */\n  IMMEDIATE_WITHOUT_PRORATION = 3,\n\n  /**\n   * Replacement takes effect when the old plan expires, and the new price will\n   * be charged at the same time.\n   */\n  DEFERRED = 4,\n}\n\nexport enum PACKAGE_TYPE {\n  /**\n   * A package that was defined with a custom identifier.\n   */\n  UNKNOWN = 'UNKNOWN',\n\n  /**\n   * A package that was defined with a custom identifier.\n   */\n  CUSTOM = 'CUSTOM',\n\n  /**\n   * A package configured with the predefined lifetime identifier.\n   */\n  LIFETIME = 'LIFETIME',\n\n  /**\n   * A package configured with the predefined annual identifier.\n   */\n  ANNUAL = 'ANNUAL',\n\n  /**\n   * A package configured with the predefined six month identifier.\n   */\n  SIX_MONTH = 'SIX_MONTH',\n\n  /**\n   * A package configured with the predefined three month identifier.\n   */\n  THREE_MONTH = 'THREE_MONTH',\n\n  /**\n   * A package configured with the predefined two month identifier.\n   */\n  TWO_MONTH = 'TWO_MONTH',\n\n  /**\n   * A package configured with the predefined monthly identifier.\n   */\n  MONTHLY = 'MONTHLY',\n\n  /**\n   * A package configured with the predefined weekly identifier.\n   */\n  WEEKLY = 'WEEKLY',\n}\n\nexport enum INTRO_ELIGIBILITY_STATUS {\n  /**\n   * doesn't have enough information to determine eligibility.\n   */\n  INTRO_ELIGIBILITY_STATUS_UNKNOWN = 0,\n  /**\n   * The user is not eligible for a free trial or intro pricing for this product.\n   */\n  INTRO_ELIGIBILITY_STATUS_INELIGIBLE,\n  /**\n   * The user is eligible for a free trial or intro pricing for this product.\n   */\n  INTRO_ELIGIBILITY_STATUS_ELIGIBLE,\n}\n\nexport interface Transaction {\n  /**\n   * Unique identifier for the transaction.\n   *\n   * @since 1.0.0\n   * @platform ios Numeric string (e.g., \"2000001043762129\")\n   * @platform android Alphanumeric string (e.g., \"GPA.1234-5678-9012-34567\")\n   */\n  readonly transactionId: string;\n  /**\n   * Receipt data for validation (base64 encoded StoreKit receipt).\n   *\n   * Send this to your backend for server-side validation with Apple's receipt verification API.\n   * The receipt remains available even after refund - server validation is required to detect refunded transactions.\n   *\n   * @since 1.0.0\n   * @platform ios Always present\n   * @platform android Not available (use purchaseToken instead)\n   */\n  readonly receipt?: string;\n  /**\n   * An optional obfuscated identifier that uniquely associates the transaction with a user account in your app.\n   *\n   * PURPOSE:\n   * - Fraud detection: Helps platforms detect irregular activity (e.g., many devices purchasing on the same account)\n   * - User linking: Links purchases to in-game characters, avatars, or in-app profiles\n   *\n   * PLATFORM DIFFERENCES:\n   * - iOS: Must be a valid UUID format (e.g., \"550e8400-e29b-41d4-a716-446655440000\")\n   *        Apple's StoreKit 2 requires UUID format for the appAccountToken parameter\n   * - Android: Can be any obfuscated string (max 64 chars), maps to Google Play's ObfuscatedAccountId\n   *           Google recommends using encryption or one-way hash\n   *\n   * SECURITY REQUIREMENTS (especially for Android):\n   * - DO NOT store Personally Identifiable Information (PII) like emails in cleartext\n   * - Use encryption or a one-way hash to generate an obfuscated identifier\n   * - Maximum length: 64 characters (both platforms)\n   * - Storing PII in cleartext will result in purchases being blocked by Google Play\n   *\n   * IMPLEMENTATION EXAMPLE:\n   * ```typescript\n   * // For iOS: Generate a deterministic UUID from user ID\n   * import { v5 as uuidv5 } from 'uuid';\n   * const NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8'; // Your app's namespace UUID\n   * const appAccountToken = uuidv5(userId, NAMESPACE);\n   *\n   * // For Android: Can also use UUID or any hashed value\n   * // The same UUID approach works for both platforms\n   * ```\n   */\n  readonly appAccountToken?: string | null;\n  /**\n   * Product identifier associated with the transaction.\n   *\n   * @since 1.0.0\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly productIdentifier: string;\n  /**\n   * Purchase date of the transaction in ISO 8601 format.\n   *\n   * @since 1.0.0\n   * @example \"2025-10-28T06:03:19Z\"\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly purchaseDate: string;\n  /**\n   * Original purchase date of the transaction in ISO 8601 format.\n   *\n   * For subscription renewals, this shows the date of the original subscription purchase,\n   * while purchaseDate shows the date of the current renewal.\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions only\n   * @platform android Not available\n   */\n  readonly originalPurchaseDate?: string;\n  /**\n   * Expiration date of the transaction in ISO 8601 format.\n   *\n   * Check this date to determine if a subscription is still valid.\n   * Compare with current date: if expirationDate > now, subscription is active.\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions only\n   * @platform android Not available (query Google Play Developer API instead)\n   */\n  readonly expirationDate?: string;\n  /**\n   * Whether the subscription is still active/valid.\n   *\n   * For iOS subscriptions, check if isActive === true to verify an active subscription.\n   * For expired or refunded iOS subscriptions, this will be false.\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions only (true if expiration date is in the future)\n   * @platform android Not available (check purchaseState === \"1\" instead)\n   */\n  readonly isActive?: boolean;\n  /**\n   * Whether the subscription will be cancelled at the end of the billing cycle.\n   *\n   * - `true`: User has cancelled but subscription remains active until expiration\n   * - `false`: Subscription will auto-renew\n   * - `null`: Status unknown or not available\n   *\n   * @since 1.0.0\n   * @default null\n   * @platform ios Present for subscriptions only (boolean or null)\n   * @platform android Always null (use Google Play Developer API for cancellation status)\n   */\n  readonly willCancel: boolean | null;\n  /**\n   * Purchase state of the transaction (numeric string value).\n   *\n   * **Android Values:**\n   * - `\"1\"`: Purchase completed and valid (PURCHASED state)\n   * - `\"0\"`: Payment pending (PENDING state, e.g., cash payment processing)\n   * - Other numeric values: Various other states\n   *\n   * Always check `purchaseState === \"1\"` on Android to verify a valid purchase.\n   * Refunded purchases typically disappear from getPurchases() rather than showing a different state.\n   *\n   * @since 1.0.0\n   * @platform ios Not available (use isActive for subscriptions or receipt validation for IAP)\n   * @platform android Always present\n   */\n  readonly purchaseState?: string;\n  /**\n   * Order ID associated with the transaction.\n   *\n   * Use this for server-side verification on Android. This is the Google Play order ID.\n   *\n   * @since 1.0.0\n   * @example \"GPA.1234-5678-9012-34567\"\n   * @platform ios Not available\n   * @platform android Always present\n   */\n  readonly orderId?: string;\n  /**\n   * Purchase token associated with the transaction.\n   *\n   * Send this to your backend for server-side validation with Google Play Developer API.\n   * This is the Android equivalent of iOS's receipt field.\n   *\n   * @since 1.0.0\n   * @platform ios Not available (use receipt instead)\n   * @platform android Always present\n   */\n  readonly purchaseToken?: string;\n  /**\n   * Whether the purchase has been acknowledged.\n   *\n   * Purchases must be acknowledged within 3 days or they will be refunded.\n   * This plugin automatically acknowledges purchases.\n   *\n   * @since 1.0.0\n   * @platform ios Not available\n   * @platform android Always present (should be true after successful purchase)\n   */\n  readonly isAcknowledged?: boolean;\n  /**\n   * Quantity purchased.\n   *\n   * @since 1.0.0\n   * @default 1\n   * @platform ios 1 or higher (as specified in purchaseProduct call)\n   * @platform android Always 1 (Google Play doesn't support quantity > 1)\n   */\n  readonly quantity?: number;\n  /**\n   * Product type.\n   *\n   * - `\"inapp\"`: One-time in-app purchase\n   * - `\"subs\"`: Subscription\n   *\n   * @since 1.0.0\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly productType?: string;\n  /**\n   * Whether the transaction is in a trial period.\n   *\n   * - `true`: Currently in free trial period\n   * - `false`: Not in trial period\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions with trial offers\n   * @platform android Present for subscriptions with trial offers\n   */\n  readonly isTrialPeriod?: boolean;\n  /**\n   * Whether the transaction is in an introductory price period.\n   *\n   * Introductory pricing is a discounted rate, different from a free trial.\n   *\n   * - `true`: Currently using introductory pricing\n   * - `false`: Not in intro period\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions with intro pricing\n   * @platform android Present for subscriptions with intro pricing\n   */\n  readonly isInIntroPricePeriod?: boolean;\n  /**\n   * Whether the transaction is in a grace period.\n   *\n   * Grace period allows users to fix payment issues while maintaining access.\n   * You typically want to continue providing access during this time.\n   *\n   * - `true`: Subscription payment failed but user still has access\n   * - `false`: Not in grace period\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions in grace period\n   * @platform android Present for subscriptions in grace period\n   */\n  readonly isInGracePeriod?: boolean;\n}\n\nexport interface SubscriptionPeriod {\n  /**\n   * The Subscription Period number of unit.\n   */\n  readonly numberOfUnits: number;\n  /**\n   * The Subscription Period unit.\n   */\n  readonly unit: number;\n}\nexport interface SKProductDiscount {\n  /**\n   * The Product discount identifier.\n   */\n  readonly identifier: string;\n  /**\n   * The Product discount type.\n   */\n  readonly type: number;\n  /**\n   * The Product discount price.\n   */\n  readonly price: number;\n  /**\n   * Formatted price of the item, including its currency sign, such as €3.99.\n   */\n  readonly priceString: string;\n  /**\n   * The Product discount currency symbol.\n   */\n  readonly currencySymbol: string;\n  /**\n   * The Product discount currency code.\n   */\n  readonly currencyCode: string;\n  /**\n   * The Product discount paymentMode.\n   */\n  readonly paymentMode: number;\n  /**\n   * The Product discount number Of Periods.\n   */\n  readonly numberOfPeriods: number;\n  /**\n   * The Product discount subscription period.\n   */\n  readonly subscriptionPeriod: SubscriptionPeriod;\n}\nexport interface Product {\n  /**\n   * Product Id.\n   */\n  readonly identifier: string;\n  /**\n   * Description of the product.\n   */\n  readonly description: string;\n  /**\n   * Title of the product.\n   */\n  readonly title: string;\n  /**\n   * Price of the product in the local currency.\n   */\n  readonly price: number;\n  /**\n   * Formatted price of the item, including its currency sign, such as €3.99.\n   */\n  readonly priceString: string;\n  /**\n   * Currency code for price and original price.\n   */\n  readonly currencyCode: string;\n  /**\n   * Currency symbol for price and original price.\n   */\n  readonly currencySymbol: string;\n  /**\n   * Boolean indicating if the product is sharable with family\n   */\n  readonly isFamilyShareable: boolean;\n  /**\n   * Group identifier for the product.\n   */\n  readonly subscriptionGroupIdentifier: string;\n  /**\n   * The Product subcription group identifier.\n   */\n  readonly subscriptionPeriod: SubscriptionPeriod;\n  /**\n   * The Product introductory Price.\n   */\n  readonly introductoryPrice: SKProductDiscount | null;\n  /**\n   * The Product discounts list.\n   */\n  readonly discounts: SKProductDiscount[];\n}\n\nexport interface NativePurchasesPlugin {\n  /**\n   * Restores a user's previous  and links their appUserIDs to any user's also using those .\n   */\n  restorePurchases(): Promise<void>;\n\n  /**\n   * Started purchase process for the given product.\n   *\n   * @param options - The product to purchase\n   * @param options.productIdentifier - The product identifier of the product you want to purchase.\n   * @param options.productType - Only Android, the type of product, can be inapp or subs. Will use inapp by default.\n   * @param options.planIdentifier - Only Android, the identifier of the base plan you want to purchase from Google Play Console. REQUIRED for Android subscriptions, ignored on iOS.\n   * @param options.quantity - Only iOS, the number of items you wish to purchase. Will use 1 by default.\n   * @param options.appAccountToken - Optional identifier uniquely associated with the user's account in your app.\n   *                                  PLATFORM REQUIREMENTS:\n   *                                  - iOS: Must be a valid UUID format (StoreKit 2 requirement)\n   *                                  - Android: Can be any obfuscated string (max 64 chars), maps to ObfuscatedAccountId\n   *                                  SECURITY: DO NOT use PII like emails in cleartext - use UUID or hashed value.\n   *                                  RECOMMENDED: Use UUID v5 with deterministic generation for cross-platform compatibility.\n   */\n  purchaseProduct(options: {\n    productIdentifier: string;\n    planIdentifier?: string;\n    productType?: PURCHASE_TYPE;\n    quantity?: number;\n    appAccountToken?: string;\n  }): Promise<Transaction>;\n\n  /**\n   * Gets the product info associated with a list of product identifiers.\n   *\n   * @param options - The product identifiers you wish to retrieve information for\n   * @param options.productIdentifiers - Array of product identifiers\n   * @param options.productType - Only Android, the type of product, can be inapp or subs. Will use inapp by default.\n   * @returns - The requested product info\n   */\n  getProducts(options: { productIdentifiers: string[]; productType?: PURCHASE_TYPE }): Promise<{ products: Product[] }>;\n\n  /**\n   * Gets the product info for a single product identifier.\n   *\n   * @param options - The product identifier you wish to retrieve information for\n   * @param options.productIdentifier - The product identifier\n   * @param options.productType - Only Android, the type of product, can be inapp or subs. Will use inapp by default.\n   * @returns - The requested product info\n   */\n  getProduct(options: { productIdentifier: string; productType?: PURCHASE_TYPE }): Promise<{ product: Product }>;\n\n  /**\n   * Check if billing is supported for the current device.\n   *\n   *\n   */\n  isBillingSupported(): Promise<{ isBillingSupported: boolean }>;\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Gets all the user's purchases (both in-app purchases and subscriptions).\n   * This method queries the platform's purchase history for the current user.\n   *\n   * @param options - Optional parameters for filtering purchases\n   * @param options.productType - Only Android, filter by product type (inapp or subs). If not specified, returns both types.\n   * @param options.appAccountToken - Optional filter to restrict results to purchases that used the provided account token.\n   *                                   Must be the same identifier used during purchase (UUID format for iOS, any obfuscated string for Android).\n   *                                   iOS: UUID format required. Android: Maps to ObfuscatedAccountId.\n   * @returns {Promise<{ purchases: Transaction[] }>} Promise that resolves with array of user's purchases\n   * @throws An error if the purchase query fails\n   * @since 7.2.0\n   */\n  getPurchases(options?: {\n    productType?: PURCHASE_TYPE;\n    appAccountToken?: string;\n  }): Promise<{ purchases: Transaction[] }>;\n\n  /**\n   * Opens the platform's native subscription management page.\n   * This allows users to view, modify, or cancel their subscriptions.\n   *\n   * - iOS: Opens the App Store subscription management page for the current app\n   * - Android: Opens the Google Play subscription management page\n   *\n   * @returns {Promise<void>} Promise that resolves when the management page is opened\n   * @throws An error if the subscription management page cannot be opened\n   * @since 7.10.0\n   */\n  manageSubscriptions(): Promise<void>;\n\n  /**\n   * Listen for StoreKit transaction updates delivered by Apple's Transaction.updates.\n   * Fires on app launch if there are unfinished transactions, and for any updates afterward.\n   * iOS only.\n   */\n  addListener(\n    eventName: 'transactionUpdated',\n    listenerFunc: (transaction: Transaction) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /** Remove all registered listeners */\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,qFAAoB,CAAA;IACpB,iEAAU,CAAA;IACV,uEAAa,CAAA;IACb,iEAAU,CAAA;IACV,iEAAU,CAAA;IACV,qEAAY,CAAA;AACd,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B;AAED,MAAM,CAAN,IAAY,aAUX;AAVD,WAAY,aAAa;IACvB;;OAEG;IACH,gCAAe,CAAA;IAEf;;OAEG;IACH,8BAAa,CAAA;AACf,CAAC,EAVW,aAAa,KAAb,aAAa,QAUxB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,eAyBX;AAzBD,WAAY,eAAe;IACzB;;OAEG;IACH,uEAAa,CAAA;IAEb;;OAEG;IACH,qFAAoB,CAAA;IAEpB;;OAEG;IACH,iFAAkB,CAAA;IAElB;;OAEG;IACH,mFAAmB,CAAA;IAEnB;;OAEG;IACH,+FAAyB,CAAA;AAC3B,CAAC,EAzBW,eAAe,KAAf,eAAe,QAyB1B;AACD,MAAM,CAAN,IAAY,cA2BX;AA3BD,WAAY,cAAc;IACxB,qIAAiD,CAAA;IAEjD;;;OAGG;IACH,qGAAiC,CAAA;IAEjC;;;;OAIG;IACH,iHAAuC,CAAA;IAEvC;;;OAGG;IACH,iGAA+B,CAAA;IAE/B;;;OAGG;IACH,2DAAY,CAAA;AACd,CAAC,EA3BW,cAAc,KAAd,cAAc,QA2BzB;AAED,MAAM,CAAN,IAAY,YA6CX;AA7CD,WAAY,YAAY;IACtB;;OAEG;IACH,mCAAmB,CAAA;IAEnB;;OAEG;IACH,iCAAiB,CAAA;IAEjB;;OAEG;IACH,qCAAqB,CAAA;IAErB;;OAEG;IACH,iCAAiB,CAAA;IAEjB;;OAEG;IACH,uCAAuB,CAAA;IAEvB;;OAEG;IACH,2CAA2B,CAAA;IAE3B;;OAEG;IACH,uCAAuB,CAAA;IAEvB;;OAEG;IACH,mCAAmB,CAAA;IAEnB;;OAEG;IACH,iCAAiB,CAAA;AACnB,CAAC,EA7CW,YAAY,KAAZ,YAAY,QA6CvB;AAED,MAAM,CAAN,IAAY,wBAaX;AAbD,WAAY,wBAAwB;IAClC;;OAEG;IACH,+HAAoC,CAAA;IACpC;;OAEG;IACH,qIAAmC,CAAA;IACnC;;OAEG;IACH,iIAAiC,CAAA;AACnC,CAAC,EAbW,wBAAwB,KAAxB,wBAAwB,QAanC","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport enum ATTRIBUTION_NETWORK {\n  APPLE_SEARCH_ADS = 0,\n  ADJUST = 1,\n  APPSFLYER = 2,\n  BRANCH = 3,\n  TENJIN = 4,\n  FACEBOOK = 5,\n}\n\nexport enum PURCHASE_TYPE {\n  /**\n   * A type of SKU for in-app products.\n   */\n  INAPP = 'inapp',\n\n  /**\n   * A type of SKU for subscriptions.\n   */\n  SUBS = 'subs',\n}\n\n/**\n * Enum for billing features.\n * Currently, these are only relevant for Google Play Android users:\n * https://developer.android.com/reference/com/android/billingclient/api/BillingClient.FeatureType\n */\nexport enum BILLING_FEATURE {\n  /**\n   * Purchase/query for subscriptions.\n   */\n  SUBSCRIPTIONS,\n\n  /**\n   * Subscriptions update/replace.\n   */\n  SUBSCRIPTIONS_UPDATE,\n\n  /**\n   * Purchase/query for in-app items on VR.\n   */\n  IN_APP_ITEMS_ON_VR,\n\n  /**\n   * Purchase/query for subscriptions on VR.\n   */\n  SUBSCRIPTIONS_ON_VR,\n\n  /**\n   * Launch a price change confirmation flow.\n   */\n  PRICE_CHANGE_CONFIRMATION,\n}\nexport enum PRORATION_MODE {\n  UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY = 0,\n\n  /**\n   * Replacement takes effect immediately, and the remaining time will be\n   * prorated and credited to the user. This is the current default behavior.\n   */\n  IMMEDIATE_WITH_TIME_PRORATION = 1,\n\n  /**\n   * Replacement takes effect immediately, and the billing cycle remains the\n   * same. The price for the remaining period will be charged. This option is\n   * only available for subscription upgrade.\n   */\n  IMMEDIATE_AND_CHARGE_PRORATED_PRICE = 2,\n\n  /**\n   * Replacement takes effect immediately, and the new price will be charged on\n   * next recurrence time. The billing cycle stays the same.\n   */\n  IMMEDIATE_WITHOUT_PRORATION = 3,\n\n  /**\n   * Replacement takes effect when the old plan expires, and the new price will\n   * be charged at the same time.\n   */\n  DEFERRED = 4,\n}\n\nexport enum PACKAGE_TYPE {\n  /**\n   * A package that was defined with a custom identifier.\n   */\n  UNKNOWN = 'UNKNOWN',\n\n  /**\n   * A package that was defined with a custom identifier.\n   */\n  CUSTOM = 'CUSTOM',\n\n  /**\n   * A package configured with the predefined lifetime identifier.\n   */\n  LIFETIME = 'LIFETIME',\n\n  /**\n   * A package configured with the predefined annual identifier.\n   */\n  ANNUAL = 'ANNUAL',\n\n  /**\n   * A package configured with the predefined six month identifier.\n   */\n  SIX_MONTH = 'SIX_MONTH',\n\n  /**\n   * A package configured with the predefined three month identifier.\n   */\n  THREE_MONTH = 'THREE_MONTH',\n\n  /**\n   * A package configured with the predefined two month identifier.\n   */\n  TWO_MONTH = 'TWO_MONTH',\n\n  /**\n   * A package configured with the predefined monthly identifier.\n   */\n  MONTHLY = 'MONTHLY',\n\n  /**\n   * A package configured with the predefined weekly identifier.\n   */\n  WEEKLY = 'WEEKLY',\n}\n\nexport enum INTRO_ELIGIBILITY_STATUS {\n  /**\n   * doesn't have enough information to determine eligibility.\n   */\n  INTRO_ELIGIBILITY_STATUS_UNKNOWN = 0,\n  /**\n   * The user is not eligible for a free trial or intro pricing for this product.\n   */\n  INTRO_ELIGIBILITY_STATUS_INELIGIBLE,\n  /**\n   * The user is eligible for a free trial or intro pricing for this product.\n   */\n  INTRO_ELIGIBILITY_STATUS_ELIGIBLE,\n}\n\nexport interface Transaction {\n  /**\n   * Unique identifier for the transaction.\n   *\n   * @since 1.0.0\n   * @platform ios Numeric string (e.g., \"2000001043762129\")\n   * @platform android Alphanumeric string (e.g., \"GPA.1234-5678-9012-34567\")\n   */\n  readonly transactionId: string;\n  /**\n   * Receipt data for validation (base64 encoded StoreKit receipt).\n   *\n   * Send this to your backend for server-side validation with Apple's receipt verification API.\n   * The receipt remains available even after refund - server validation is required to detect refunded transactions.\n   *\n   * @since 1.0.0\n   * @platform ios Always present\n   * @platform android Not available (use purchaseToken instead)\n   */\n  readonly receipt?: string;\n  /**\n   * An optional obfuscated identifier that uniquely associates the transaction with a user account in your app.\n   *\n   * PURPOSE:\n   * - Fraud detection: Helps platforms detect irregular activity (e.g., many devices purchasing on the same account)\n   * - User linking: Links purchases to in-game characters, avatars, or in-app profiles\n   *\n   * PLATFORM DIFFERENCES:\n   * - iOS: Must be a valid UUID format (e.g., \"550e8400-e29b-41d4-a716-446655440000\")\n   *        Apple's StoreKit 2 requires UUID format for the appAccountToken parameter\n   * - Android: Can be any obfuscated string (max 64 chars), maps to Google Play's ObfuscatedAccountId\n   *           Google recommends using encryption or one-way hash\n   *\n   * SECURITY REQUIREMENTS (especially for Android):\n   * - DO NOT store Personally Identifiable Information (PII) like emails in cleartext\n   * - Use encryption or a one-way hash to generate an obfuscated identifier\n   * - Maximum length: 64 characters (both platforms)\n   * - Storing PII in cleartext will result in purchases being blocked by Google Play\n   *\n   * IMPLEMENTATION EXAMPLE:\n   * ```typescript\n   * // For iOS: Generate a deterministic UUID from user ID\n   * import { v5 as uuidv5 } from 'uuid';\n   * const NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8'; // Your app's namespace UUID\n   * const appAccountToken = uuidv5(userId, NAMESPACE);\n   *\n   * // For Android: Can also use UUID or any hashed value\n   * // The same UUID approach works for both platforms\n   * ```\n   */\n  readonly appAccountToken?: string | null;\n  /**\n   * Product identifier associated with the transaction.\n   *\n   * @since 1.0.0\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly productIdentifier: string;\n  /**\n   * Purchase date of the transaction in ISO 8601 format.\n   *\n   * @since 1.0.0\n   * @example \"2025-10-28T06:03:19Z\"\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly purchaseDate: string;\n  /**\n   * Original purchase date of the transaction in ISO 8601 format.\n   *\n   * For subscription renewals, this shows the date of the original subscription purchase,\n   * while purchaseDate shows the date of the current renewal.\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions only\n   * @platform android Not available\n   */\n  readonly originalPurchaseDate?: string;\n  /**\n   * Expiration date of the transaction in ISO 8601 format.\n   *\n   * Check this date to determine if a subscription is still valid.\n   * Compare with current date: if expirationDate > now, subscription is active.\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions only\n   * @platform android Not available (query Google Play Developer API instead)\n   */\n  readonly expirationDate?: string;\n  /**\n   * Whether the subscription is still active/valid.\n   *\n   * For iOS subscriptions, check if isActive === true to verify an active subscription.\n   * For expired or refunded iOS subscriptions, this will be false.\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions only (true if expiration date is in the future)\n   * @platform android Not available (check purchaseState === \"1\" instead)\n   */\n  readonly isActive?: boolean;\n  /**\n   * Whether the subscription will be cancelled at the end of the billing cycle.\n   *\n   * - `true`: User has cancelled but subscription remains active until expiration\n   * - `false`: Subscription will auto-renew\n   * - `null`: Status unknown or not available\n   *\n   * @since 1.0.0\n   * @default null\n   * @platform ios Present for subscriptions only (boolean or null)\n   * @platform android Always null (use Google Play Developer API for cancellation status)\n   */\n  readonly willCancel: boolean | null;\n  /**\n   * Purchase state of the transaction (numeric string value).\n   *\n   * **Android Values:**\n   * - `\"1\"`: Purchase completed and valid (PURCHASED state)\n   * - `\"0\"`: Payment pending (PENDING state, e.g., cash payment processing)\n   * - Other numeric values: Various other states\n   *\n   * Always check `purchaseState === \"1\"` on Android to verify a valid purchase.\n   * Refunded purchases typically disappear from getPurchases() rather than showing a different state.\n   *\n   * @since 1.0.0\n   * @platform ios Not available (use isActive for subscriptions or receipt validation for IAP)\n   * @platform android Always present\n   */\n  readonly purchaseState?: string;\n  /**\n   * Order ID associated with the transaction.\n   *\n   * Use this for server-side verification on Android. This is the Google Play order ID.\n   *\n   * @since 1.0.0\n   * @example \"GPA.1234-5678-9012-34567\"\n   * @platform ios Not available\n   * @platform android Always present\n   */\n  readonly orderId?: string;\n  /**\n   * Purchase token associated with the transaction.\n   *\n   * Send this to your backend for server-side validation with Google Play Developer API.\n   * This is the Android equivalent of iOS's receipt field.\n   *\n   * @since 1.0.0\n   * @platform ios Not available (use receipt instead)\n   * @platform android Always present\n   */\n  readonly purchaseToken?: string;\n  /**\n   * Whether the purchase has been acknowledged.\n   *\n   * Purchases must be acknowledged within 3 days or they will be refunded.\n   * This plugin automatically acknowledges purchases.\n   *\n   * @since 1.0.0\n   * @platform ios Not available\n   * @platform android Always present (should be true after successful purchase)\n   */\n  readonly isAcknowledged?: boolean;\n  /**\n   * Quantity purchased.\n   *\n   * @since 1.0.0\n   * @default 1\n   * @platform ios 1 or higher (as specified in purchaseProduct call)\n   * @platform android Always 1 (Google Play doesn't support quantity > 1)\n   */\n  readonly quantity?: number;\n  /**\n   * Product type.\n   *\n   * - `\"inapp\"`: One-time in-app purchase\n   * - `\"subs\"`: Subscription\n   *\n   * @since 1.0.0\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly productType?: string;\n  /**\n   * Whether the transaction is in a trial period.\n   *\n   * - `true`: Currently in free trial period\n   * - `false`: Not in trial period\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions with trial offers\n   * @platform android Present for subscriptions with trial offers\n   */\n  readonly isTrialPeriod?: boolean;\n  /**\n   * Whether the transaction is in an introductory price period.\n   *\n   * Introductory pricing is a discounted rate, different from a free trial.\n   *\n   * - `true`: Currently using introductory pricing\n   * - `false`: Not in intro period\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions with intro pricing\n   * @platform android Present for subscriptions with intro pricing\n   */\n  readonly isInIntroPricePeriod?: boolean;\n  /**\n   * Whether the transaction is in a grace period.\n   *\n   * Grace period allows users to fix payment issues while maintaining access.\n   * You typically want to continue providing access during this time.\n   *\n   * - `true`: Subscription payment failed but user still has access\n   * - `false`: Not in grace period\n   *\n   * @since 1.0.0\n   * @platform ios Present for subscriptions in grace period\n   * @platform android Present for subscriptions in grace period\n   */\n  readonly isInGracePeriod?: boolean;\n}\n\nexport interface SubscriptionPeriod {\n  /**\n   * The Subscription Period number of unit.\n   */\n  readonly numberOfUnits: number;\n  /**\n   * The Subscription Period unit.\n   */\n  readonly unit: number;\n}\nexport interface SKProductDiscount {\n  /**\n   * The Product discount identifier.\n   */\n  readonly identifier: string;\n  /**\n   * The Product discount type.\n   */\n  readonly type: number;\n  /**\n   * The Product discount price.\n   */\n  readonly price: number;\n  /**\n   * Formatted price of the item, including its currency sign, such as €3.99.\n   */\n  readonly priceString: string;\n  /**\n   * The Product discount currency symbol.\n   */\n  readonly currencySymbol: string;\n  /**\n   * The Product discount currency code.\n   */\n  readonly currencyCode: string;\n  /**\n   * The Product discount paymentMode.\n   */\n  readonly paymentMode: number;\n  /**\n   * The Product discount number Of Periods.\n   */\n  readonly numberOfPeriods: number;\n  /**\n   * The Product discount subscription period.\n   */\n  readonly subscriptionPeriod: SubscriptionPeriod;\n}\nexport interface Product {\n  /**\n   * Product Id.\n   */\n  readonly identifier: string;\n  /**\n   * Description of the product.\n   */\n  readonly description: string;\n  /**\n   * Title of the product.\n   */\n  readonly title: string;\n  /**\n   * Price of the product in the local currency.\n   */\n  readonly price: number;\n  /**\n   * Formatted price of the item, including its currency sign, such as €3.99.\n   */\n  readonly priceString: string;\n  /**\n   * Currency code for price and original price.\n   */\n  readonly currencyCode: string;\n  /**\n   * Currency symbol for price and original price.\n   */\n  readonly currencySymbol: string;\n  /**\n   * Boolean indicating if the product is sharable with family\n   */\n  readonly isFamilyShareable: boolean;\n  /**\n   * Group identifier for the product.\n   */\n  readonly subscriptionGroupIdentifier: string;\n  /**\n   * The Product subcription group identifier.\n   */\n  readonly subscriptionPeriod: SubscriptionPeriod;\n  /**\n   * The Product introductory Price.\n   */\n  readonly introductoryPrice: SKProductDiscount | null;\n  /**\n   * The Product discounts list.\n   */\n  readonly discounts: SKProductDiscount[];\n}\n\nexport interface NativePurchasesPlugin {\n  /**\n   * Restores a user's previous  and links their appUserIDs to any user's also using those .\n   */\n  restorePurchases(): Promise<void>;\n\n  /**\n   * Started purchase process for the given product.\n   *\n   * @param options - The product to purchase\n   * @param options.productIdentifier - The product identifier of the product you want to purchase.\n   * @param options.productType - Only Android, the type of product, can be inapp or subs. Will use inapp by default.\n   * @param options.planIdentifier - Only Android, the identifier of the base plan you want to purchase from Google Play Console. REQUIRED for Android subscriptions, ignored on iOS.\n   * @param options.quantity - Only iOS, the number of items you wish to purchase. Will use 1 by default.\n   * @param options.appAccountToken - Optional identifier uniquely associated with the user's account in your app.\n   *                                  PLATFORM REQUIREMENTS:\n   *                                  - iOS: Must be a valid UUID format (StoreKit 2 requirement)\n   *                                  - Android: Can be any obfuscated string (max 64 chars), maps to ObfuscatedAccountId\n   *                                  SECURITY: DO NOT use PII like emails in cleartext - use UUID or hashed value.\n   *                                  RECOMMENDED: Use UUID v5 with deterministic generation for cross-platform compatibility.\n   * @param options.isConsumable - Only Android, when true the purchase token is consumed after granting entitlement (for consumable in-app items). Defaults to false.\n   */\n  purchaseProduct(options: {\n    productIdentifier: string;\n    planIdentifier?: string;\n    productType?: PURCHASE_TYPE;\n    quantity?: number;\n    appAccountToken?: string;\n    isConsumable?: boolean;\n  }): Promise<Transaction>;\n\n  /**\n   * Gets the product info associated with a list of product identifiers.\n   *\n   * @param options - The product identifiers you wish to retrieve information for\n   * @param options.productIdentifiers - Array of product identifiers\n   * @param options.productType - Only Android, the type of product, can be inapp or subs. Will use inapp by default.\n   * @returns - The requested product info\n   */\n  getProducts(options: { productIdentifiers: string[]; productType?: PURCHASE_TYPE }): Promise<{ products: Product[] }>;\n\n  /**\n   * Gets the product info for a single product identifier.\n   *\n   * @param options - The product identifier you wish to retrieve information for\n   * @param options.productIdentifier - The product identifier\n   * @param options.productType - Only Android, the type of product, can be inapp or subs. Will use inapp by default.\n   * @returns - The requested product info\n   */\n  getProduct(options: { productIdentifier: string; productType?: PURCHASE_TYPE }): Promise<{ product: Product }>;\n\n  /**\n   * Check if billing is supported for the current device.\n   *\n   *\n   */\n  isBillingSupported(): Promise<{ isBillingSupported: boolean }>;\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Gets all the user's purchases (both in-app purchases and subscriptions).\n   * This method queries the platform's purchase history for the current user.\n   *\n   * @param options - Optional parameters for filtering purchases\n   * @param options.productType - Only Android, filter by product type (inapp or subs). If not specified, returns both types.\n   * @param options.appAccountToken - Optional filter to restrict results to purchases that used the provided account token.\n   *                                   Must be the same identifier used during purchase (UUID format for iOS, any obfuscated string for Android).\n   *                                   iOS: UUID format required. Android: Maps to ObfuscatedAccountId.\n   * @returns {Promise<{ purchases: Transaction[] }>} Promise that resolves with array of user's purchases\n   * @throws An error if the purchase query fails\n   * @since 7.2.0\n   */\n  getPurchases(options?: {\n    productType?: PURCHASE_TYPE;\n    appAccountToken?: string;\n  }): Promise<{ purchases: Transaction[] }>;\n\n  /**\n   * Opens the platform's native subscription management page.\n   * This allows users to view, modify, or cancel their subscriptions.\n   *\n   * - iOS: Opens the App Store subscription management page for the current app\n   * - Android: Opens the Google Play subscription management page\n   *\n   * @returns {Promise<void>} Promise that resolves when the management page is opened\n   * @throws An error if the subscription management page cannot be opened\n   * @since 7.10.0\n   */\n  manageSubscriptions(): Promise<void>;\n\n  /**\n   * Listen for StoreKit transaction updates delivered by Apple's Transaction.updates.\n   * Fires on app launch if there are unfinished transactions, and for any updates afterward.\n   * iOS only.\n   */\n  addListener(\n    eventName: 'transactionUpdated',\n    listenerFunc: (transaction: Transaction) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /** Remove all registered listeners */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/ios/Sources/NativePurchasesPlugin/NativePurchasesPlugin.swift

@@ -21,7 +21,7 @@ public class NativePurchasesPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "manageSubscriptions", returnType: CAPPluginReturnPromise)
     ]
 
-    private let pluginVersion: String = "7.12.7"
+    private let pluginVersion: String = "7.13.0"
     private var transactionUpdatesTask: Task<Void, Never>?
 
     @objc func getPluginVersion(_ call: CAPPluginCall) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/native-purchases",
-  "version": "7.12.7",
+  "version": "7.13.0",
   "description": "In-app Subscriptions Made Easy",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",