@capgo/native-purchases 7.7.13 → 7.8.3

package/README.md

@@ -401,7 +401,7 @@ const buyInAppProduct = async () => {
       productIdentifier: 'com.yourapp.premium_features',
       productType: PURCHASE_TYPE.INAPP,
       quantity: 1,
-      appAccountToken: userUUID // Optional: iOS only - for linking purchases to user accounts
+      appAccountToken: userUUID // Optional: iOS & Android - links purchases to a user (maps to Google Play ObfuscatedAccountId)
     });
 
     alert('Purchase successful! Transaction ID: ' + result.transactionId);
@@ -443,7 +443,7 @@ const buySubscription = async () => {
       planIdentifier: 'monthly-plan',           // REQUIRED for Android subscriptions
       productType: PURCHASE_TYPE.SUBS,          // REQUIRED for subscriptions
       quantity: 1,
-      appAccountToken: userUUID                 // Optional: iOS only - for linking purchases to user accounts
+      appAccountToken: userUUID                 // Optional: iOS & Android - links purchases to a user (maps to Google Play ObfuscatedAccountId)
     });
 
     alert('Subscription successful! Transaction ID: ' + result.transactionId);
@@ -828,15 +828,15 @@ Get the native Capacitor plugin version
 ### getPurchases(...)
 
 ```typescript
-getPurchases(options?: { productType?: PURCHASE_TYPE | undefined; } | undefined) => Promise<{ purchases: Transaction[]; }>
+getPurchases(options?: { productType?: PURCHASE_TYPE | undefined; appAccountToken?: string | undefined; } | undefined) => Promise<{ purchases: Transaction[]; }>
 ```
 
 Gets all the user's purchases (both in-app purchases and subscriptions).
 This method queries the platform's purchase history for the current user.
 
-| Param         | Type                                                                       | Description                                   |
-| ------------- | -------------------------------------------------------------------------- | --------------------------------------------- |
-| **`options`** | <code>{ productType?: <a href="#purchase_type">PURCHASE_TYPE</a>; }</code> | - Optional parameters for filtering purchases |
+| Param         | Type                                                                                                 | Description                                   |
+| ------------- | ---------------------------------------------------------------------------------------------------- | --------------------------------------------- |
+| **`options`** | <code>{ productType?: <a href="#purchase_type">PURCHASE_TYPE</a>; appAccountToken?: string; }</code> | - Optional parameters for filtering purchases |
 
 **Returns:** <code>Promise&lt;{ purchases: Transaction[]; }&gt;</code>
 
@@ -848,7 +848,7 @@ This method queries the platform's purchase history for the current user.
 ### addListener('transactionUpdated', ...)
 
 ```typescript
-addListener(eventName: "transactionUpdated", listenerFunc: (transaction: Transaction) => void) => Promise<PluginListenerHandle>
+addListener(eventName: 'transactionUpdated', listenerFunc: (transaction: Transaction) => void) => Promise<PluginListenerHandle>
 ```
 
 Listen for StoreKit transaction updates delivered by Apple's <a href="#transaction">Transaction</a>.updates.
@@ -883,8 +883,9 @@ Remove all registered listeners
 
 | Prop                       | Type                         | Description                                                                                                                  |
 | -------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| **`transactionId`**        | <code>string</code>          | RevenueCat Id associated to the transaction.                                                                                 |
+| **`transactionId`**        | <code>string</code>          | Id associated to the transaction.                                                                                            |
 | **`receipt`**              | <code>string</code>          | Receipt data for validation (iOS only - base64 encoded receipt)                                                              |
+| **`appAccountToken`**      | <code>string \| null</code>  | Account token provided during purchase. Works on both platforms and maps to Google Play's ObfuscatedAccountId on Android.    |
 | **`productIdentifier`**    | <code>string</code>          | <a href="#product">Product</a> Id associated with the transaction.                                                           |
 | **`purchaseDate`**         | <code>string</code>          | Purchase date of the transaction in ISO 8601 format.                                                                         |
 | **`originalPurchaseDate`** | <code>string</code>          | Original purchase date of the transaction in ISO 8601 format (for subscriptions).                                            |
@@ -957,8 +958,8 @@ Remove all registered listeners
 
 | Members     | Value                | Description                        |
 | ----------- | -------------------- | ---------------------------------- |
-| **`INAPP`** | <code>"inapp"</code> | A type of SKU for in-app products. |
-| **`SUBS`**  | <code>"subs"</code>  | A type of SKU for subscriptions.   |
+| **`INAPP`** | <code>'inapp'</code> | A type of SKU for in-app products. |
+| **`SUBS`**  | <code>'subs'</code>  | A type of SKU for subscriptions.   |
 
 </docgen-api>