@capgo/native-purchases 7.16.0 → 7.16.2

package/README.md

@@ -1484,7 +1484,7 @@ and give them free access.
 ### isEntitledToOldBusinessModel(...)
 
 ```typescript
-isEntitledToOldBusinessModel(options: { targetVersion: string; }) => Promise<{ isOlderVersion: boolean; originalAppVersion: string; }>
+isEntitledToOldBusinessModel(options: { targetVersion?: string; targetBuildNumber?: string; }) => Promise<{ isOlderVersion: boolean; originalAppVersion: string; }>
 ```
 
 Compares the original app version from the App <a href="#transaction">Transaction</a> against a target version
@@ -1497,9 +1497,13 @@ more reliable than JavaScript-based comparison for semantic versioning.
 Check if the user's original download version is older than a specific version
 to determine if they should be grandfathered into free features.
 
-| Param         | Type                                    | Description              |
-| ------------- | --------------------------------------- | ------------------------ |
-| **`options`** | <code>{ targetVersion: string; }</code> | - The comparison options |
+**Platform Differences:**
+- iOS: Uses build number (CFBundleVersion) from <a href="#apptransaction">AppTransaction</a>. Requires iOS 16+.
+- Android: Uses version name from PackageInfo (current installed version, not original).
+
+| Param         | Type                                                                 | Description              |
+| ------------- | -------------------------------------------------------------------- | ------------------------ |
+| **`options`** | <code>{ targetVersion?: string; targetBuildNumber?: string; }</code> | - The comparison options |
 
 **Returns:** <code>Promise&lt;{ isOlderVersion: boolean; originalAppVersion: string; }&gt;</code>
 

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

@@ -42,7 +42,7 @@ import org.json.JSONArray;
 @CapacitorPlugin(name = "NativePurchases")
 public class NativePurchasesPlugin extends Plugin {
 
-    private final String pluginVersion = "7.16.0";
+    private final String pluginVersion = "7.16.2";
     public static final String TAG = "NativePurchases";
     private static final Phaser semaphoreReady = new Phaser(1);
     private BillingClient billingClient;
@@ -1080,7 +1080,7 @@ public class NativePurchasesPlugin extends Plugin {
 
         if (targetVersion == null || targetVersion.isEmpty()) {
             Log.d(TAG, "Error: targetVersion is empty");
-            call.reject("targetVersion is required");
+            call.reject("targetVersion is required on Android");
             return;
         }
 

package/dist/docs.json

@@ -50,12 +50,12 @@
       },
       {
         "name": "isEntitledToOldBusinessModel",
-        "signature": "(options: { targetVersion: string; }) => Promise<{ isOlderVersion: boolean; originalAppVersion: string; }>",
+        "signature": "(options: { targetVersion?: string; targetBuildNumber?: string; }) => Promise<{ isOlderVersion: boolean; originalAppVersion: string; }>",
         "parameters": [
           {
             "name": "options",
             "docs": "- The comparison options",
-            "type": "{ targetVersion: string; }"
+            "type": "{ targetVersion?: string | undefined; targetBuildNumber?: string | undefined; }"
           }
         ],
         "returns": "Promise<{ isOlderVersion: boolean; originalAppVersion: string; }>",
@@ -66,11 +66,15 @@
           },
           {
             "name": "param",
-            "text": "options.targetVersion - The version to compare against (e.g., \"2.0.0\")"
+            "text": "options.targetVersion - The Android version name to compare against (e.g., \"2.0.0\"). Used on Android only."
+          },
+          {
+            "name": "param",
+            "text": "options.targetBuildNumber - The iOS build number to compare against (e.g., \"42\"). Used on iOS only."
           },
           {
             "name": "returns",
-            "text": "- `isOlderVersion`: true if the user's original version is older than targetVersion\n- `originalAppVersion`: The user's original app version for reference"
+            "text": "- `isOlderVersion`: true if the user's original version is older than target\n- `originalAppVersion`: The user's original app version/build number for reference"
           },
           {
             "name": "throws",
@@ -82,10 +86,10 @@
           },
           {
             "name": "example",
-            "text": "```typescript\n// Check if user downloaded before version 2.0.0 (when subscription was added)\nconst result = await NativePurchases.isEntitledToOldBusinessModel({\n  targetVersion: '2.0.0'\n});\n\nif (result.isOlderVersion) {\n  console.log(`User downloaded v${result.originalAppVersion}, granting free access`);\n  grantFreeAccess();\n}\n```"
+            "text": "```typescript\n// Check if user downloaded before version 2.0.0/build 42 (when subscription was added)\nconst result = await NativePurchases.isEntitledToOldBusinessModel({\n  targetVersion: '2.0.0',\n  targetBuildNumber: '42'\n});\n\nif (result.isOlderVersion) {\n  console.log(`User downloaded v${result.originalAppVersion}, granting free access`);\n  grantFreeAccess();\n}\n```"
           }
         ],
-        "docs": "Compares the original app version from the App Transaction against a target version\nto determine if the user is entitled to features from an earlier business model.\n\nThis is a utility method that performs the version comparison natively, which can be\nmore reliable than JavaScript-based comparison for semantic versioning.\n\n**Use Case:**\nCheck if the user's original download version is older than a specific version\nto determine if they should be grandfathered into free features.",
+        "docs": "Compares the original app version from the App Transaction against a target version\nto determine if the user is entitled to features from an earlier business model.\n\nThis is a utility method that performs the version comparison natively, which can be\nmore reliable than JavaScript-based comparison for semantic versioning.\n\n**Use Case:**\nCheck if the user's original download version is older than a specific version\nto determine if they should be grandfathered into free features.\n\n**Platform Differences:**\n- iOS: Uses build number (CFBundleVersion) from AppTransaction. Requires iOS 16+.\n- Android: Uses version name from PackageInfo (current installed version, not original).",
         "complexTypes": [],
         "slug": "isentitledtooldbusinessmodel"
       },

package/dist/esm/definitions.d.ts

@@ -688,19 +688,25 @@ export interface NativePurchasesPlugin {
      * Check if the user's original download version is older than a specific version
      * to determine if they should be grandfathered into free features.
      *
+     * **Platform Differences:**
+     * - iOS: Uses build number (CFBundleVersion) from AppTransaction. Requires iOS 16+.
+     * - Android: Uses version name from PackageInfo (current installed version, not original).
+     *
      * @param options - The comparison options
-     * @param options.targetVersion - The version to compare against (e.g., "2.0.0")
+     * @param options.targetVersion - The Android version name to compare against (e.g., "2.0.0"). Used on Android only.
+     * @param options.targetBuildNumber - The iOS build number to compare against (e.g., "42"). Used on iOS only.
      * @returns {Promise<{ isOlderVersion: boolean; originalAppVersion: string }>}
-     *          - `isOlderVersion`: true if the user's original version is older than targetVersion
-     *          - `originalAppVersion`: The user's original app version for reference
+     *          - `isOlderVersion`: true if the user's original version is older than target
+     *          - `originalAppVersion`: The user's original app version/build number for reference
      * @throws An error if the app transaction cannot be retrieved
      * @since 7.16.0
      *
      * @example
      * ```typescript
-     * // Check if user downloaded before version 2.0.0 (when subscription was added)
+     * // Check if user downloaded before version 2.0.0/build 42 (when subscription was added)
      * const result = await NativePurchases.isEntitledToOldBusinessModel({
-     *   targetVersion: '2.0.0'
+     *   targetVersion: '2.0.0',
+     *   targetBuildNumber: '42'
      * });
      *
      * if (result.isOlderVersion) {
@@ -710,7 +716,8 @@ export interface NativePurchasesPlugin {
      * ```
      */
     isEntitledToOldBusinessModel(options: {
-        targetVersion: string;
+        targetVersion?: string;
+        targetBuildNumber?: string;
     }): Promise<{
         isOlderVersion: boolean;
         originalAppVersion: string;

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   * StoreKit 2 JSON Web Signature (JWS) payload describing the verified transaction.\n   *\n   * Send this to your backend when using Apple's App Store Server API v2 instead of raw receipts.\n   * Only available when the transaction originated from StoreKit 2 APIs (e.g. Transaction.updates).\n   *\n   * @since 7.13.2\n   * @platform ios Present for StoreKit 2 transactions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly jwsRepresentation?: 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   * Indicates whether this transaction is the result of a subscription upgrade.\n   *\n   * Useful for understanding when StoreKit generated the transaction because\n   * the customer moved from a lower tier to a higher tier plan.\n   *\n   * @since 7.13.2\n   * @platform ios Present for auto-renewable subscriptions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly isUpgraded?: boolean;\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   * Date the transaction was revoked/refunded, in ISO 8601 format.\n   *\n   * Present when Apple revokes access due to an issue (e.g., refund or developer issue).\n   *\n   * @since 7.13.2\n   * @platform ios Present for revoked transactions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly revocationDate?: string;\n  /**\n   * Reason why Apple revoked the transaction.\n   *\n   * Possible values:\n   * - `\"developerIssue\"`: Developer-initiated refund or issue\n   * - `\"other\"`: Apple-initiated (customer refund, billing problem, etc.)\n   * - `\"unknown\"`: StoreKit didn't report a specific reason\n   *\n   * @since 7.13.2\n   * @platform ios Present for revoked transactions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly revocationReason?: 'developerIssue' | 'other' | 'unknown';\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   * Current subscription state reported by StoreKit.\n   *\n   * Possible values:\n   * - `\"subscribed\"`: Auto-renewing and in good standing\n   * - `\"expired\"`: Lapsed with no access\n   * - `\"revoked\"`: Access removed due to refund or issue\n   * - `\"inGracePeriod\"`: Payment issue but still in grace access window\n   * - `\"inBillingRetryPeriod\"`: StoreKit retrying failed billing\n   * - `\"unknown\"`: StoreKit did not report a state\n   *\n   * @since 7.13.2\n   * @platform ios Present for auto-renewable subscriptions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly subscriptionState?:\n    | 'subscribed'\n    | 'expired'\n    | 'revoked'\n    | 'inGracePeriod'\n    | 'inBillingRetryPeriod'\n    | 'unknown';\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   * By default, this plugin automatically acknowledges purchases unless you set\n   * `autoAcknowledgePurchases: false` in purchaseProduct().\n   *\n   * @since 1.0.0\n   * @platform ios Not available\n   * @platform android Always present (should be true after successful purchase or manual acknowledgment)\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   * Indicates how the user obtained access to the product.\n   *\n   * - `\"purchased\"`: The user purchased the product directly\n   * - `\"familyShared\"`: The user has access through Family Sharing (another family member purchased it)\n   *\n   * This property is useful for:\n   * - Detecting family sharing usage for analytics\n   * - Implementing different features/limits for family-shared vs. directly purchased products\n   * - Understanding your user acquisition channels\n   *\n   * @since 7.12.8\n   * @platform ios Always present (iOS 15.0+, StoreKit 2)\n   * @platform android Not available\n   */\n  readonly ownershipType?: 'purchased' | 'familyShared';\n  /**\n   * Indicates the server environment where the transaction was processed.\n   *\n   * - `\"Sandbox\"`: Transaction belongs to testing in the sandbox environment\n   * - `\"Production\"`: Transaction belongs to a customer in the production environment\n   * - `\"Xcode\"`: Transaction from StoreKit Testing in Xcode\n   *\n   * This property is useful for:\n   * - Debugging and identifying test vs. production purchases\n   * - Analytics and reporting (filtering out sandbox transactions)\n   * - Server-side validation (knowing which Apple endpoint to use)\n   * - Preventing test purchases from affecting production metrics\n   *\n   * @since 7.12.8\n   * @platform ios Present on iOS 16.0+ only (not available on iOS 15)\n   * @platform android Not available\n   */\n  readonly environment?: 'Sandbox' | 'Production' | 'Xcode';\n  /**\n   * Reason StoreKit generated the transaction.\n   *\n   * - `\"purchase\"`: Initial purchase that user made manually\n   * - `\"renewal\"`: Automatically generated renewal for an auto-renewable subscription\n   * - `\"unknown\"`: StoreKit did not return a reason\n   *\n   * @since 7.13.2\n   * @platform ios Present on iOS 17.0+ (StoreKit 2 transactions)\n   * @platform android Not available\n   */\n  readonly transactionReason?: 'purchase' | 'renewal' | 'unknown';\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 TransactionVerificationFailedEvent {\n  /**\n   * Identifier of the transaction that failed verification.\n   *\n   * @since 7.13.2\n   * @platform ios Present when StoreKit reports an unverified transaction\n   * @platform android Not available\n   */\n  readonly transactionId: string;\n  /**\n   * Localized error message describing why verification failed.\n   *\n   * @since 7.13.2\n   * @platform ios Always present\n   * @platform android Not available\n   */\n  readonly error: string;\n}\n\n/**\n * Represents the App Transaction information from StoreKit 2.\n * This provides details about when the user originally downloaded or purchased the app,\n * which is useful for determining if users are entitled to features from earlier business models.\n *\n * @see https://developer.apple.com/documentation/storekit/supporting-business-model-changes-by-using-the-app-transaction\n * @since 7.16.0\n */\nexport interface AppTransaction {\n  /**\n   * The app version that the user originally purchased or downloaded.\n   *\n   * Use this to determine if users who originally downloaded an earlier version\n   * should be entitled to features that were previously free or included.\n   *\n   * For iOS: This is the `CFBundleShortVersionString` (e.g., \"1.0.0\")\n   * For Android: This is the `versionName` from Google Play (e.g., \"1.0.0\")\n   *\n   * @example \"1.0.0\"\n   * @since 7.16.0\n   * @platform ios Always present (iOS 16+)\n   * @platform android Always present\n   */\n  readonly originalAppVersion: string;\n\n  /**\n   * The date when the user originally purchased or downloaded the app.\n   * ISO 8601 format.\n   *\n   * @example \"2023-06-15T10:30:00Z\"\n   * @since 7.16.0\n   * @platform ios Always present (iOS 16+)\n   * @platform android Always present\n   */\n  readonly originalPurchaseDate: string;\n\n  /**\n   * The bundle identifier of the app.\n   *\n   * @example \"com.example.myapp\"\n   * @since 7.16.0\n   * @platform ios Always present (iOS 16+)\n   * @platform android Always present (package name)\n   */\n  readonly bundleId: string;\n\n  /**\n   * The current app version installed on the device.\n   *\n   * @example \"2.0.0\"\n   * @since 7.16.0\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly appVersion: string;\n\n  /**\n   * The server environment where the app was originally purchased.\n   *\n   * @since 7.16.0\n   * @platform ios Present (iOS 16+)\n   * @platform android Not available (always null)\n   */\n  readonly environment?: 'Sandbox' | 'Production' | 'Xcode' | null;\n\n  /**\n   * The JWS (JSON Web Signature) representation of the app transaction.\n   * Can be sent to your backend for server-side verification.\n   *\n   * @since 7.16.0\n   * @platform ios Present (iOS 16+)\n   * @platform android Not available\n   */\n  readonly jwsRepresentation?: string;\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 subscription 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   * Gets the App Transaction information, which provides details about when the user\n   * originally downloaded or purchased the app.\n   *\n   * This is useful for implementing business model changes where you want to\n   * grandfather users who originally downloaded an earlier version of the app.\n   *\n   * **Use Case Example:**\n   * If your app was originally free but you're adding a subscription, you can use\n   * `originalAppVersion` to check if users downloaded before the subscription was added\n   * and give them free access.\n   *\n   * **Platform Notes:**\n   * - **iOS**: Requires iOS 16.0+. Uses StoreKit 2's `AppTransaction.shared`.\n   * - **Android**: Uses Google Play's install referrer data when available.\n   *\n   * @returns {Promise<{ appTransaction: AppTransaction }>} The app transaction info\n   * @throws An error if the app transaction cannot be retrieved (iOS 15 or earlier)\n   * @since 7.16.0\n   *\n   * @example\n   * ```typescript\n   * const { appTransaction } = await NativePurchases.getAppTransaction();\n   *\n   * // Check if user downloaded before version 2.0.0 (when subscription was added)\n   * if (compareVersions(appTransaction.originalAppVersion, '2.0.0') < 0) {\n   *   // User gets free access - they downloaded before subscriptions\n   *   grantFreeAccess();\n   * }\n   * ```\n   *\n   * @see https://developer.apple.com/documentation/storekit/supporting-business-model-changes-by-using-the-app-transaction\n   */\n  getAppTransaction(): Promise<{ appTransaction: AppTransaction }>;\n\n  /**\n   * Compares the original app version from the App Transaction against a target version\n   * to determine if the user is entitled to features from an earlier business model.\n   *\n   * This is a utility method that performs the version comparison natively, which can be\n   * more reliable than JavaScript-based comparison for semantic versioning.\n   *\n   * **Use Case:**\n   * Check if the user's original download version is older than a specific version\n   * to determine if they should be grandfathered into free features.\n   *\n   * @param options - The comparison options\n   * @param options.targetVersion - The version to compare against (e.g., \"2.0.0\")\n   * @returns {Promise<{ isOlderVersion: boolean; originalAppVersion: string }>}\n   *          - `isOlderVersion`: true if the user's original version is older than targetVersion\n   *          - `originalAppVersion`: The user's original app version for reference\n   * @throws An error if the app transaction cannot be retrieved\n   * @since 7.16.0\n   *\n   * @example\n   * ```typescript\n   * // Check if user downloaded before version 2.0.0 (when subscription was added)\n   * const result = await NativePurchases.isEntitledToOldBusinessModel({\n   *   targetVersion: '2.0.0'\n   * });\n   *\n   * if (result.isOlderVersion) {\n   *   console.log(`User downloaded v${result.originalAppVersion}, granting free access`);\n   *   grantFreeAccess();\n   * }\n   * ```\n   */\n  isEntitledToOldBusinessModel(options: {\n    targetVersion: string;\n  }): Promise<{ isOlderVersion: boolean; originalAppVersion: string }>;\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   * @param options.autoAcknowledgePurchases - When false, the purchase/transaction will NOT be automatically acknowledged/finished. You must manually call acknowledgePurchase() or the purchase may be refunded. Defaults to true.\n   *                                           - **Android**: Must acknowledge within 3 days or Google Play will refund\n   *                                           - **iOS**: Unfinished transactions remain in the queue and may block future purchases\n   */\n  purchaseProduct(options: {\n    productIdentifier: string;\n    planIdentifier?: string;\n    productType?: PURCHASE_TYPE;\n    quantity?: number;\n    appAccountToken?: string;\n    isConsumable?: boolean;\n    autoAcknowledgePurchases?: 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   * Manually acknowledge/finish a purchase transaction.\n   *\n   * This method is only needed when you set `autoAcknowledgePurchases: false` in purchaseProduct().\n   *\n   * **Platform Behavior:**\n   * - **Android**: Acknowledges the purchase with Google Play. Must be called within 3 days or the purchase will be refunded.\n   * - **iOS**: Finishes the transaction with StoreKit 2. Unfinished transactions remain in the queue and may block future purchases.\n   *\n   * **Acknowledgment Options:**\n   *\n   * **1. Client-side (this method)**: Call from your app after validation\n   * ```typescript\n   * await NativePurchases.acknowledgePurchase({\n   *   purchaseToken: transaction.purchaseToken  // Android: purchaseToken, iOS: transactionId\n   * });\n   * ```\n   *\n   * **2. Server-side (Android only, recommended for security)**: Use Google Play Developer API v3\n   * - Endpoint: `POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge`\n   * - Requires OAuth 2.0 authentication with appropriate scopes\n   * - See: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.products/acknowledge\n   * - For subscriptions: Use `/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge` instead\n   * - Note: iOS has no server-side finish API\n   *\n   * **When to use manual acknowledgment:**\n   * - Server-side validation: Verify the purchase with your backend before acknowledging\n   * - Entitlement delivery: Ensure user receives content/features before acknowledging\n   * - Multi-step workflows: Complete all steps before final acknowledgment\n   * - Security: Prevent client-side manipulation by handling acknowledgment server-side (Android only)\n   *\n   * @param options - The purchase to acknowledge\n   * @param options.purchaseToken - The purchase token (Android) or transaction ID as string (iOS) from the Transaction object\n   * @returns {Promise<void>} Promise that resolves when the purchase is acknowledged/finished\n   * @throws An error if acknowledgment/finishing fails or transaction not found\n   * @platform android Acknowledges the purchase with Google Play\n   * @platform ios Finishes the transaction with StoreKit 2\n   * @since 7.14.0\n   *\n   * @example\n   * ```typescript\n   * // Client-side acknowledgment\n   * const transaction = await NativePurchases.purchaseProduct({\n   *   productIdentifier: 'premium_feature',\n   *   autoAcknowledgePurchases: false\n   * });\n   *\n   * // Validate with your backend\n   * const isValid = await fetch('/api/validate-purchase', {\n   *   method: 'POST',\n   *   body: JSON.stringify({ purchaseToken: transaction.purchaseToken })\n   * });\n   *\n   * if (isValid) {\n   *   // Option 1: Acknowledge from client\n   *   await NativePurchases.acknowledgePurchase({\n   *     purchaseToken: transaction.purchaseToken\n   *   });\n   *\n   *   // Option 2: Or let your backend acknowledge via Google Play API\n   *   // Your backend calls Google Play Developer API\n   * }\n   * ```\n   */\n  acknowledgePurchase(options: { purchaseToken: string }): 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   * Listen for StoreKit transaction verification failures delivered by Apple's Transaction.updates.\n   * Fires when the verification result is unverified.\n   * iOS only.\n   */\n  addListener(\n    eventName: 'transactionVerificationFailed',\n    listenerFunc: (payload: TransactionVerificationFailedEvent) => 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   * StoreKit 2 JSON Web Signature (JWS) payload describing the verified transaction.\n   *\n   * Send this to your backend when using Apple's App Store Server API v2 instead of raw receipts.\n   * Only available when the transaction originated from StoreKit 2 APIs (e.g. Transaction.updates).\n   *\n   * @since 7.13.2\n   * @platform ios Present for StoreKit 2 transactions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly jwsRepresentation?: 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   * Indicates whether this transaction is the result of a subscription upgrade.\n   *\n   * Useful for understanding when StoreKit generated the transaction because\n   * the customer moved from a lower tier to a higher tier plan.\n   *\n   * @since 7.13.2\n   * @platform ios Present for auto-renewable subscriptions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly isUpgraded?: boolean;\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   * Date the transaction was revoked/refunded, in ISO 8601 format.\n   *\n   * Present when Apple revokes access due to an issue (e.g., refund or developer issue).\n   *\n   * @since 7.13.2\n   * @platform ios Present for revoked transactions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly revocationDate?: string;\n  /**\n   * Reason why Apple revoked the transaction.\n   *\n   * Possible values:\n   * - `\"developerIssue\"`: Developer-initiated refund or issue\n   * - `\"other\"`: Apple-initiated (customer refund, billing problem, etc.)\n   * - `\"unknown\"`: StoreKit didn't report a specific reason\n   *\n   * @since 7.13.2\n   * @platform ios Present for revoked transactions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly revocationReason?: 'developerIssue' | 'other' | 'unknown';\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   * Current subscription state reported by StoreKit.\n   *\n   * Possible values:\n   * - `\"subscribed\"`: Auto-renewing and in good standing\n   * - `\"expired\"`: Lapsed with no access\n   * - `\"revoked\"`: Access removed due to refund or issue\n   * - `\"inGracePeriod\"`: Payment issue but still in grace access window\n   * - `\"inBillingRetryPeriod\"`: StoreKit retrying failed billing\n   * - `\"unknown\"`: StoreKit did not report a state\n   *\n   * @since 7.13.2\n   * @platform ios Present for auto-renewable subscriptions (iOS 15+)\n   * @platform android Not available\n   */\n  readonly subscriptionState?:\n    | 'subscribed'\n    | 'expired'\n    | 'revoked'\n    | 'inGracePeriod'\n    | 'inBillingRetryPeriod'\n    | 'unknown';\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   * By default, this plugin automatically acknowledges purchases unless you set\n   * `autoAcknowledgePurchases: false` in purchaseProduct().\n   *\n   * @since 1.0.0\n   * @platform ios Not available\n   * @platform android Always present (should be true after successful purchase or manual acknowledgment)\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   * Indicates how the user obtained access to the product.\n   *\n   * - `\"purchased\"`: The user purchased the product directly\n   * - `\"familyShared\"`: The user has access through Family Sharing (another family member purchased it)\n   *\n   * This property is useful for:\n   * - Detecting family sharing usage for analytics\n   * - Implementing different features/limits for family-shared vs. directly purchased products\n   * - Understanding your user acquisition channels\n   *\n   * @since 7.12.8\n   * @platform ios Always present (iOS 15.0+, StoreKit 2)\n   * @platform android Not available\n   */\n  readonly ownershipType?: 'purchased' | 'familyShared';\n  /**\n   * Indicates the server environment where the transaction was processed.\n   *\n   * - `\"Sandbox\"`: Transaction belongs to testing in the sandbox environment\n   * - `\"Production\"`: Transaction belongs to a customer in the production environment\n   * - `\"Xcode\"`: Transaction from StoreKit Testing in Xcode\n   *\n   * This property is useful for:\n   * - Debugging and identifying test vs. production purchases\n   * - Analytics and reporting (filtering out sandbox transactions)\n   * - Server-side validation (knowing which Apple endpoint to use)\n   * - Preventing test purchases from affecting production metrics\n   *\n   * @since 7.12.8\n   * @platform ios Present on iOS 16.0+ only (not available on iOS 15)\n   * @platform android Not available\n   */\n  readonly environment?: 'Sandbox' | 'Production' | 'Xcode';\n  /**\n   * Reason StoreKit generated the transaction.\n   *\n   * - `\"purchase\"`: Initial purchase that user made manually\n   * - `\"renewal\"`: Automatically generated renewal for an auto-renewable subscription\n   * - `\"unknown\"`: StoreKit did not return a reason\n   *\n   * @since 7.13.2\n   * @platform ios Present on iOS 17.0+ (StoreKit 2 transactions)\n   * @platform android Not available\n   */\n  readonly transactionReason?: 'purchase' | 'renewal' | 'unknown';\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 TransactionVerificationFailedEvent {\n  /**\n   * Identifier of the transaction that failed verification.\n   *\n   * @since 7.13.2\n   * @platform ios Present when StoreKit reports an unverified transaction\n   * @platform android Not available\n   */\n  readonly transactionId: string;\n  /**\n   * Localized error message describing why verification failed.\n   *\n   * @since 7.13.2\n   * @platform ios Always present\n   * @platform android Not available\n   */\n  readonly error: string;\n}\n\n/**\n * Represents the App Transaction information from StoreKit 2.\n * This provides details about when the user originally downloaded or purchased the app,\n * which is useful for determining if users are entitled to features from earlier business models.\n *\n * @see https://developer.apple.com/documentation/storekit/supporting-business-model-changes-by-using-the-app-transaction\n * @since 7.16.0\n */\nexport interface AppTransaction {\n  /**\n   * The app version that the user originally purchased or downloaded.\n   *\n   * Use this to determine if users who originally downloaded an earlier version\n   * should be entitled to features that were previously free or included.\n   *\n   * For iOS: This is the `CFBundleShortVersionString` (e.g., \"1.0.0\")\n   * For Android: This is the `versionName` from Google Play (e.g., \"1.0.0\")\n   *\n   * @example \"1.0.0\"\n   * @since 7.16.0\n   * @platform ios Always present (iOS 16+)\n   * @platform android Always present\n   */\n  readonly originalAppVersion: string;\n\n  /**\n   * The date when the user originally purchased or downloaded the app.\n   * ISO 8601 format.\n   *\n   * @example \"2023-06-15T10:30:00Z\"\n   * @since 7.16.0\n   * @platform ios Always present (iOS 16+)\n   * @platform android Always present\n   */\n  readonly originalPurchaseDate: string;\n\n  /**\n   * The bundle identifier of the app.\n   *\n   * @example \"com.example.myapp\"\n   * @since 7.16.0\n   * @platform ios Always present (iOS 16+)\n   * @platform android Always present (package name)\n   */\n  readonly bundleId: string;\n\n  /**\n   * The current app version installed on the device.\n   *\n   * @example \"2.0.0\"\n   * @since 7.16.0\n   * @platform ios Always present\n   * @platform android Always present\n   */\n  readonly appVersion: string;\n\n  /**\n   * The server environment where the app was originally purchased.\n   *\n   * @since 7.16.0\n   * @platform ios Present (iOS 16+)\n   * @platform android Not available (always null)\n   */\n  readonly environment?: 'Sandbox' | 'Production' | 'Xcode' | null;\n\n  /**\n   * The JWS (JSON Web Signature) representation of the app transaction.\n   * Can be sent to your backend for server-side verification.\n   *\n   * @since 7.16.0\n   * @platform ios Present (iOS 16+)\n   * @platform android Not available\n   */\n  readonly jwsRepresentation?: string;\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 subscription 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   * Gets the App Transaction information, which provides details about when the user\n   * originally downloaded or purchased the app.\n   *\n   * This is useful for implementing business model changes where you want to\n   * grandfather users who originally downloaded an earlier version of the app.\n   *\n   * **Use Case Example:**\n   * If your app was originally free but you're adding a subscription, you can use\n   * `originalAppVersion` to check if users downloaded before the subscription was added\n   * and give them free access.\n   *\n   * **Platform Notes:**\n   * - **iOS**: Requires iOS 16.0+. Uses StoreKit 2's `AppTransaction.shared`.\n   * - **Android**: Uses Google Play's install referrer data when available.\n   *\n   * @returns {Promise<{ appTransaction: AppTransaction }>} The app transaction info\n   * @throws An error if the app transaction cannot be retrieved (iOS 15 or earlier)\n   * @since 7.16.0\n   *\n   * @example\n   * ```typescript\n   * const { appTransaction } = await NativePurchases.getAppTransaction();\n   *\n   * // Check if user downloaded before version 2.0.0 (when subscription was added)\n   * if (compareVersions(appTransaction.originalAppVersion, '2.0.0') < 0) {\n   *   // User gets free access - they downloaded before subscriptions\n   *   grantFreeAccess();\n   * }\n   * ```\n   *\n   * @see https://developer.apple.com/documentation/storekit/supporting-business-model-changes-by-using-the-app-transaction\n   */\n  getAppTransaction(): Promise<{ appTransaction: AppTransaction }>;\n\n  /**\n   * Compares the original app version from the App Transaction against a target version\n   * to determine if the user is entitled to features from an earlier business model.\n   *\n   * This is a utility method that performs the version comparison natively, which can be\n   * more reliable than JavaScript-based comparison for semantic versioning.\n   *\n   * **Use Case:**\n   * Check if the user's original download version is older than a specific version\n   * to determine if they should be grandfathered into free features.\n   *\n   * **Platform Differences:**\n   * - iOS: Uses build number (CFBundleVersion) from AppTransaction. Requires iOS 16+.\n   * - Android: Uses version name from PackageInfo (current installed version, not original).\n   *\n   * @param options - The comparison options\n   * @param options.targetVersion - The Android version name to compare against (e.g., \"2.0.0\"). Used on Android only.\n   * @param options.targetBuildNumber - The iOS build number to compare against (e.g., \"42\"). Used on iOS only.\n   * @returns {Promise<{ isOlderVersion: boolean; originalAppVersion: string }>}\n   *          - `isOlderVersion`: true if the user's original version is older than target\n   *          - `originalAppVersion`: The user's original app version/build number for reference\n   * @throws An error if the app transaction cannot be retrieved\n   * @since 7.16.0\n   *\n   * @example\n   * ```typescript\n   * // Check if user downloaded before version 2.0.0/build 42 (when subscription was added)\n   * const result = await NativePurchases.isEntitledToOldBusinessModel({\n   *   targetVersion: '2.0.0',\n   *   targetBuildNumber: '42'\n   * });\n   *\n   * if (result.isOlderVersion) {\n   *   console.log(`User downloaded v${result.originalAppVersion}, granting free access`);\n   *   grantFreeAccess();\n   * }\n   * ```\n   */\n  isEntitledToOldBusinessModel(options: {\n    targetVersion?: string;\n    targetBuildNumber?: string;\n  }): Promise<{ isOlderVersion: boolean; originalAppVersion: string }>;\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   * @param options.autoAcknowledgePurchases - When false, the purchase/transaction will NOT be automatically acknowledged/finished. You must manually call acknowledgePurchase() or the purchase may be refunded. Defaults to true.\n   *                                           - **Android**: Must acknowledge within 3 days or Google Play will refund\n   *                                           - **iOS**: Unfinished transactions remain in the queue and may block future purchases\n   */\n  purchaseProduct(options: {\n    productIdentifier: string;\n    planIdentifier?: string;\n    productType?: PURCHASE_TYPE;\n    quantity?: number;\n    appAccountToken?: string;\n    isConsumable?: boolean;\n    autoAcknowledgePurchases?: 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   * Manually acknowledge/finish a purchase transaction.\n   *\n   * This method is only needed when you set `autoAcknowledgePurchases: false` in purchaseProduct().\n   *\n   * **Platform Behavior:**\n   * - **Android**: Acknowledges the purchase with Google Play. Must be called within 3 days or the purchase will be refunded.\n   * - **iOS**: Finishes the transaction with StoreKit 2. Unfinished transactions remain in the queue and may block future purchases.\n   *\n   * **Acknowledgment Options:**\n   *\n   * **1. Client-side (this method)**: Call from your app after validation\n   * ```typescript\n   * await NativePurchases.acknowledgePurchase({\n   *   purchaseToken: transaction.purchaseToken  // Android: purchaseToken, iOS: transactionId\n   * });\n   * ```\n   *\n   * **2. Server-side (Android only, recommended for security)**: Use Google Play Developer API v3\n   * - Endpoint: `POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge`\n   * - Requires OAuth 2.0 authentication with appropriate scopes\n   * - See: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.products/acknowledge\n   * - For subscriptions: Use `/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge` instead\n   * - Note: iOS has no server-side finish API\n   *\n   * **When to use manual acknowledgment:**\n   * - Server-side validation: Verify the purchase with your backend before acknowledging\n   * - Entitlement delivery: Ensure user receives content/features before acknowledging\n   * - Multi-step workflows: Complete all steps before final acknowledgment\n   * - Security: Prevent client-side manipulation by handling acknowledgment server-side (Android only)\n   *\n   * @param options - The purchase to acknowledge\n   * @param options.purchaseToken - The purchase token (Android) or transaction ID as string (iOS) from the Transaction object\n   * @returns {Promise<void>} Promise that resolves when the purchase is acknowledged/finished\n   * @throws An error if acknowledgment/finishing fails or transaction not found\n   * @platform android Acknowledges the purchase with Google Play\n   * @platform ios Finishes the transaction with StoreKit 2\n   * @since 7.14.0\n   *\n   * @example\n   * ```typescript\n   * // Client-side acknowledgment\n   * const transaction = await NativePurchases.purchaseProduct({\n   *   productIdentifier: 'premium_feature',\n   *   autoAcknowledgePurchases: false\n   * });\n   *\n   * // Validate with your backend\n   * const isValid = await fetch('/api/validate-purchase', {\n   *   method: 'POST',\n   *   body: JSON.stringify({ purchaseToken: transaction.purchaseToken })\n   * });\n   *\n   * if (isValid) {\n   *   // Option 1: Acknowledge from client\n   *   await NativePurchases.acknowledgePurchase({\n   *     purchaseToken: transaction.purchaseToken\n   *   });\n   *\n   *   // Option 2: Or let your backend acknowledge via Google Play API\n   *   // Your backend calls Google Play Developer API\n   * }\n   * ```\n   */\n  acknowledgePurchase(options: { purchaseToken: string }): 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   * Listen for StoreKit transaction verification failures delivered by Apple's Transaction.updates.\n   * Fires when the verification result is unverified.\n   * iOS only.\n   */\n  addListener(\n    eventName: 'transactionVerificationFailed',\n    listenerFunc: (payload: TransactionVerificationFailedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /** Remove all registered listeners */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -36,7 +36,8 @@ export declare class NativePurchasesWeb extends WebPlugin implements NativePurch
         appTransaction: AppTransaction;
     }>;
     isEntitledToOldBusinessModel(_options: {
-        targetVersion: string;
+        targetVersion?: string;
+        targetBuildNumber?: string;
     }): Promise<{
         isOlderVersion: boolean;
         originalAppVersion: string;

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,KAAK,CAAC,gBAAgB;QACpB,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAyC;QACzD,OAAO,CAAC,KAAK,CAAC,iCAAiC,GAAG,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAsC;QACrD,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,OAAO,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,EAAS,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAIrB;QACC,OAAO,CAAC,KAAK,CAAC,oCAAoC,GAAG,OAAO,CAAC,CAAC;QAC9D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAS,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACvD,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,gBAAgB;QACpB,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,OAAyC;QAC1D,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,OAAO,CAAC,CAAC;QAC5D,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IACD,KAAK,CAAC,mBAAmB;QACvB,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAmC;QAC3D,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACtD,OAAO;YACL,cAAc,EAAE;gBACd,kBAAkB,EAAE,OAAO;gBAC3B,oBAAoB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC9C,QAAQ,EAAE,iBAAiB;gBAC3B,UAAU,EAAE,OAAO;gBACnB,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,4BAA4B,CAAC,QAElC;QACC,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,kBAAkB,EAAE,OAAO;SAC5B,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AppTransaction, NativePurchasesPlugin, Product, PURCHASE_TYPE, Transaction } from './definitions';\n\nexport class NativePurchasesWeb extends WebPlugin implements NativePurchasesPlugin {\n  async restorePurchases(): Promise<void> {\n    console.error('restorePurchases only mocked in web');\n  }\n\n  async getProducts(options: { productIdentifiers: string[] }): Promise<{ products: Product[] }> {\n    console.error('getProducts only mocked in web ' + options);\n    return { products: [] };\n  }\n\n  async getProduct(options: { productIdentifier: string }): Promise<{ product: Product }> {\n    console.error('getProduct only mocked in web ' + options);\n    return { product: {} as any };\n  }\n\n  async purchaseProduct(options: {\n    productIdentifier: string;\n    planIdentifier: string;\n    quantity: number;\n  }): Promise<Transaction> {\n    console.error('purchaseProduct only mocked in web' + options);\n    return { transactionId: 'transactionId' } as any;\n  }\n\n  async isBillingSupported(): Promise<{ isBillingSupported: boolean }> {\n    console.error('isBillingSupported only mocked in web');\n    return { isBillingSupported: false };\n  }\n  async getPluginVersion(): Promise<{ version: string }> {\n    console.warn('Cannot get plugin version in web');\n    return { version: 'default' };\n  }\n  async getPurchases(options?: { productType?: PURCHASE_TYPE }): Promise<{ purchases: Transaction[] }> {\n    console.error('getPurchases only mocked in web ' + options);\n    return { purchases: [] };\n  }\n  async manageSubscriptions(): Promise<void> {\n    console.error('manageSubscriptions only mocked in web');\n  }\n\n  async acknowledgePurchase(_options: { purchaseToken: string }): Promise<void> {\n    console.error('acknowledgePurchase only mocked in web');\n  }\n\n  async getAppTransaction(): Promise<{ appTransaction: AppTransaction }> {\n    console.error('getAppTransaction only mocked in web');\n    return {\n      appTransaction: {\n        originalAppVersion: '1.0.0',\n        originalPurchaseDate: new Date().toISOString(),\n        bundleId: 'com.example.app',\n        appVersion: '1.0.0',\n        environment: null,\n      },\n    };\n  }\n\n  async isEntitledToOldBusinessModel(_options: {\n    targetVersion: string;\n  }): Promise<{ isOlderVersion: boolean; originalAppVersion: string }> {\n    console.error('isEntitledToOldBusinessModel only mocked in web');\n    return {\n      isOlderVersion: false,\n      originalAppVersion: '1.0.0',\n    };\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,KAAK,CAAC,gBAAgB;QACpB,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAyC;QACzD,OAAO,CAAC,KAAK,CAAC,iCAAiC,GAAG,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAsC;QACrD,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,OAAO,CAAC,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,EAAS,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAIrB;QACC,OAAO,CAAC,KAAK,CAAC,oCAAoC,GAAG,OAAO,CAAC,CAAC;QAC9D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAS,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACvD,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,gBAAgB;QACpB,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,OAAyC;QAC1D,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,OAAO,CAAC,CAAC;QAC5D,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IACD,KAAK,CAAC,mBAAmB;QACvB,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAmC;QAC3D,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACtD,OAAO;YACL,cAAc,EAAE;gBACd,kBAAkB,EAAE,OAAO;gBAC3B,oBAAoB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC9C,QAAQ,EAAE,iBAAiB;gBAC3B,UAAU,EAAE,OAAO;gBACnB,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,4BAA4B,CAAC,QAGlC;QACC,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,kBAAkB,EAAE,OAAO;SAC5B,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AppTransaction, NativePurchasesPlugin, Product, PURCHASE_TYPE, Transaction } from './definitions';\n\nexport class NativePurchasesWeb extends WebPlugin implements NativePurchasesPlugin {\n  async restorePurchases(): Promise<void> {\n    console.error('restorePurchases only mocked in web');\n  }\n\n  async getProducts(options: { productIdentifiers: string[] }): Promise<{ products: Product[] }> {\n    console.error('getProducts only mocked in web ' + options);\n    return { products: [] };\n  }\n\n  async getProduct(options: { productIdentifier: string }): Promise<{ product: Product }> {\n    console.error('getProduct only mocked in web ' + options);\n    return { product: {} as any };\n  }\n\n  async purchaseProduct(options: {\n    productIdentifier: string;\n    planIdentifier: string;\n    quantity: number;\n  }): Promise<Transaction> {\n    console.error('purchaseProduct only mocked in web' + options);\n    return { transactionId: 'transactionId' } as any;\n  }\n\n  async isBillingSupported(): Promise<{ isBillingSupported: boolean }> {\n    console.error('isBillingSupported only mocked in web');\n    return { isBillingSupported: false };\n  }\n  async getPluginVersion(): Promise<{ version: string }> {\n    console.warn('Cannot get plugin version in web');\n    return { version: 'default' };\n  }\n  async getPurchases(options?: { productType?: PURCHASE_TYPE }): Promise<{ purchases: Transaction[] }> {\n    console.error('getPurchases only mocked in web ' + options);\n    return { purchases: [] };\n  }\n  async manageSubscriptions(): Promise<void> {\n    console.error('manageSubscriptions only mocked in web');\n  }\n\n  async acknowledgePurchase(_options: { purchaseToken: string }): Promise<void> {\n    console.error('acknowledgePurchase only mocked in web');\n  }\n\n  async getAppTransaction(): Promise<{ appTransaction: AppTransaction }> {\n    console.error('getAppTransaction only mocked in web');\n    return {\n      appTransaction: {\n        originalAppVersion: '1.0.0',\n        originalPurchaseDate: new Date().toISOString(),\n        bundleId: 'com.example.app',\n        appVersion: '1.0.0',\n        environment: null,\n      },\n    };\n  }\n\n  async isEntitledToOldBusinessModel(_options: {\n    targetVersion?: string;\n    targetBuildNumber?: string;\n  }): Promise<{ isOlderVersion: boolean; originalAppVersion: string }> {\n    console.error('isEntitledToOldBusinessModel only mocked in web');\n    return {\n      isOlderVersion: false,\n      originalAppVersion: '1.0.0',\n    };\n  }\n}\n"]}

package/ios/Sources/NativePurchasesPlugin/NativePurchasesPlugin.swift

@@ -24,7 +24,7 @@ public class NativePurchasesPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "isEntitledToOldBusinessModel", returnType: CAPPluginReturnPromise)
     ]
 
-    private let pluginVersion: String = "7.16.0"
+    private let pluginVersion: String = "7.16.2"
     private var transactionUpdatesTask: Task<Void, Never>?
 
     @objc func getPluginVersion(_ call: CAPPluginCall) {
@@ -371,7 +371,7 @@ public class NativePurchasesPlugin: CAPPlugin, CAPBridgedPlugin {
                     case .verified(let appTransaction):
                         var response: [String: Any] = [:]
 
-                        // originalAppVersion is the CFBundleShortVersionString at the time of original download
+                        // originalAppVersion is the CFBundleVersion (build number) at the time of original download
                         response["originalAppVersion"] = appTransaction.originalAppVersion
 
                         // Original purchase date
@@ -380,8 +380,8 @@ public class NativePurchasesPlugin: CAPPlugin, CAPBridgedPlugin {
                         // Bundle ID
                         response["bundleId"] = appTransaction.bundleID
 
-                        // Current app version
-                        response["appVersion"] = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? ""
+                        // Current app version (build number)
+                        response["appVersion"] = Bundle.main.infoDictionary?["CFBundleVersion"] as? String ?? ""
 
                         // Environment
                         switch appTransaction.environment {
@@ -415,26 +415,26 @@ public class NativePurchasesPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc func isEntitledToOldBusinessModel(_ call: CAPPluginCall) {
-        guard let targetVersion = call.getString("targetVersion"), !targetVersion.isEmpty else {
-            call.reject("targetVersion is required")
+        guard let targetBuildNumber = call.getString("targetBuildNumber"), !targetBuildNumber.isEmpty else {
+            call.reject("targetBuildNumber is required on iOS")
             return
         }
 
         if #available(iOS 16.0, *) {
-            print("isEntitledToOldBusinessModel called with targetVersion: \(targetVersion)")
+            print("isEntitledToOldBusinessModel called with targetBuildNumber: \(targetBuildNumber)")
             Task { @MainActor in
                 do {
                     let verificationResult = try await AppTransaction.shared
                     switch verificationResult {
                     case .verified(let appTransaction):
-                        let originalVersion = appTransaction.originalAppVersion
+                        let originalBuildNumber = appTransaction.originalAppVersion
 
-                        // Compare versions using semantic versioning
-                        let isOlder = self.compareVersions(originalVersion, targetVersion) < 0
+                        // Compare build numbers (integers)
+                        let isOlder = self.compareVersions(originalBuildNumber, targetBuildNumber) < 0
 
                         call.resolve([
                             "isOlderVersion": isOlder,
-                            "originalAppVersion": originalVersion
+                            "originalAppVersion": originalBuildNumber
                         ])
 
                     case .unverified(_, let error):
@@ -453,26 +453,12 @@ public class NativePurchasesPlugin: CAPPlugin, CAPBridgedPlugin {
 
     // MARK: - Version Comparison Helper
 
-    /// Compares two semantic version strings.
+    /// Compares two build numbers as integers.
     /// Returns: negative if v1 < v2, zero if v1 == v2, positive if v1 > v2
     private func compareVersions(_ version1: String, _ version2: String) -> Int {
-        let v1Components = version1.split(separator: ".").compactMap { Int($0) }
-        let v2Components = version2.split(separator: ".").compactMap { Int($0) }
-
-        let maxLength = max(v1Components.count, v2Components.count)
-
-        for i in 0..<maxLength {
-            let v1Value = i < v1Components.count ? v1Components[i] : 0
-            let v2Value = i < v2Components.count ? v2Components[i] : 0
-
-            if v1Value < v2Value {
-                return -1
-            } else if v1Value > v2Value {
-                return 1
-            }
-        }
-
-        return 0
+        let v1Int = Int(version1) ?? 0
+        let v2Int = Int(version2) ?? 0
+        return v1Int - v2Int
     }
 
 }

package/package.json

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