@choochmeque/tauri-plugin-iap-api 0.7.1 → 0.8.2

package/README.md

@@ -21,6 +21,7 @@ A Tauri plugin for In-App Purchases (IAP) with support for subscriptions on iOS
 - Fraud prevention with obfuscated account/profile IDs (Android)
 - App account token support for tracking (iOS)
 - Automatic offer token selection (Android)
+- Subscription upgrades/downgrades with proration modes (Android)
 
 ## Platform Support
 
@@ -45,7 +46,7 @@ Add the plugin to your Tauri project's `Cargo.toml`:
 
 ```toml
 [dependencies]
-tauri-plugin-iap = "0.7"
+tauri-plugin-iap = "0.8"
 ```
 
 Configure the plugin permissions in your `capabilities/default.json`:
@@ -148,6 +149,15 @@ const purchaseResult = await purchase('subscription_id_1', 'subs', {
   appAccountToken: '550e8400-e29b-41d4-a716-446655440000'
 });
 
+// Upgrade/downgrade subscription (Android)
+import { SubscriptionReplacementMode } from '@choochmeque/tauri-plugin-iap-api';
+
+const upgraded = await purchase('premium_subscription', 'subs', {
+  offerToken: 'premium_offer_token',
+  oldPurchaseToken: currentSubscription.purchaseToken,
+  subscriptionReplacementMode: SubscriptionReplacementMode.WITH_TIME_PRORATION
+});
+
 // Restore purchases (specify product type)
 const restored = await restorePurchases('subs');
 
@@ -251,6 +261,8 @@ Initiates a purchase flow with enhanced options for fraud prevention and account
   - `obfuscatedAccountId`: (Android) Hashed account ID for fraud prevention
   - `obfuscatedProfileId`: (Android) Hashed profile ID for fraud prevention
   - `appAccountToken`: (iOS) UUID string for account tracking and fraud prevention
+  - `oldPurchaseToken`: (Android) Purchase token of existing subscription to replace for upgrades/downgrades
+  - `subscriptionReplacementMode`: (Android) Proration mode using `SubscriptionReplacementMode` enum (defaults to `WITH_TIME_PRORATION`)
 
 **Returns:** Purchase object with transaction details
 

package/dist-js/index.cjs

@@ -11,6 +11,24 @@ exports.PurchaseState = void 0;
     PurchaseState[PurchaseState["CANCELED"] = 1] = "CANCELED";
     PurchaseState[PurchaseState["PENDING"] = 2] = "PENDING";
 })(exports.PurchaseState || (exports.PurchaseState = {}));
+/**
+ * Google Play subscription replacement modes for upgrades/downgrades.
+ * Used with `subscriptionReplacementMode` in `PurchaseOptions`.
+ * @see https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.SubscriptionUpdateParams.ReplacementMode
+ */
+exports.SubscriptionReplacementMode = void 0;
+(function (SubscriptionReplacementMode) {
+    /** Replacement takes effect when the old plan expires, and the new price is charged at the same time. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["DEFERRED"] = 6] = "DEFERRED";
+    /** Replacement takes effect immediately. The billing cycle remains the same. The remaining value from the old price is prorated for the new plan. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["WITH_TIME_PRORATION"] = 1] = "WITH_TIME_PRORATION";
+    /** Replacement takes effect immediately. The new price is charged immediately and in full. Any remaining period from the old plan is used to extend the new billing date. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["CHARGE_FULL_PRICE"] = 5] = "CHARGE_FULL_PRICE";
+    /** Replacement takes effect immediately. The new plan price is reduced by the prorated cost of the old plan for the remaining period. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["CHARGE_PRORATED_PRICE"] = 2] = "CHARGE_PRORATED_PRICE";
+    /** Replacement takes effect immediately with no proration. The user is charged full price for the new plan. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["WITHOUT_PRORATION"] = 3] = "WITHOUT_PRORATION";
+})(exports.SubscriptionReplacementMode || (exports.SubscriptionReplacementMode = {}));
 /**
  * Initialize the IAP plugin.
  *
@@ -65,6 +83,13 @@ async function getProducts(productIds, productType = "subs") {
  *   obfuscatedAccountId: 'user_account_id',
  *   obfuscatedProfileId: 'user_profile_id'
  * });
+ *
+ * // Subscription upgrade/downgrade (Android)
+ * const purchase = await purchase('com.example.premium', 'subs', {
+ *   offerToken: 'new_plan_offer_token',
+ *   oldPurchaseToken: 'existing_subscription_purchase_token',
+ *   subscriptionReplacementMode: SubscriptionReplacementMode.WITH_TIME_PRORATION
+ * });
  * ```
  */
 async function purchase(productId, productType = "subs", options) {

package/dist-js/index.d.ts

@@ -131,6 +131,23 @@ export interface ProductStatus {
     isAcknowledged?: boolean;
     purchaseToken?: string;
 }
+/**
+ * Google Play subscription replacement modes for upgrades/downgrades.
+ * Used with `subscriptionReplacementMode` in `PurchaseOptions`.
+ * @see https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.SubscriptionUpdateParams.ReplacementMode
+ */
+export declare enum SubscriptionReplacementMode {
+    /** Replacement takes effect when the old plan expires, and the new price is charged at the same time. */
+    DEFERRED = 6,
+    /** Replacement takes effect immediately. The billing cycle remains the same. The remaining value from the old price is prorated for the new plan. */
+    WITH_TIME_PRORATION = 1,
+    /** Replacement takes effect immediately. The new price is charged immediately and in full. Any remaining period from the old plan is used to extend the new billing date. */
+    CHARGE_FULL_PRICE = 5,
+    /** Replacement takes effect immediately. The new plan price is reduced by the prorated cost of the old plan for the remaining period. */
+    CHARGE_PRORATED_PRICE = 2,
+    /** Replacement takes effect immediately with no proration. The user is charged full price for the new plan. */
+    WITHOUT_PRORATION = 3
+}
 /**
  * Optional parameters for purchase requests
  */
@@ -143,6 +160,20 @@ export interface PurchaseOptions {
     obfuscatedProfileId?: string;
     /** App account token - must be a valid UUID string (iOS only) */
     appAccountToken?: string;
+    /**
+     * Purchase token of the existing subscription to replace (Android only).
+     * When set, the purchase becomes a subscription upgrade/downgrade.
+     * Obtain this from a previous purchase's `purchaseToken` field.
+     */
+    oldPurchaseToken?: string;
+    /**
+     * Replacement mode for subscription upgrades/downgrades (Android only).
+     * Determines how the transition between old and new subscription is handled.
+     * Use values from the `SubscriptionReplacementMode` enum.
+     * Defaults to `WITH_TIME_PRORATION` if not specified.
+     * @see SubscriptionReplacementMode
+     */
+    subscriptionReplacementMode?: SubscriptionReplacementMode;
 }
 /**
  * Initialize the IAP plugin.
@@ -189,6 +220,13 @@ export declare function getProducts(productIds: string[], productType?: "subs" |
  *   obfuscatedAccountId: 'user_account_id',
  *   obfuscatedProfileId: 'user_profile_id'
  * });
+ *
+ * // Subscription upgrade/downgrade (Android)
+ * const purchase = await purchase('com.example.premium', 'subs', {
+ *   offerToken: 'new_plan_offer_token',
+ *   oldPurchaseToken: 'existing_subscription_purchase_token',
+ *   subscriptionReplacementMode: SubscriptionReplacementMode.WITH_TIME_PRORATION
+ * });
  * ```
  */
 export declare function purchase(productId: string, productType?: "subs" | "inapp", options?: PurchaseOptions): Promise<Purchase>;

package/dist-js/index.js

@@ -9,6 +9,24 @@ var PurchaseState;
     PurchaseState[PurchaseState["CANCELED"] = 1] = "CANCELED";
     PurchaseState[PurchaseState["PENDING"] = 2] = "PENDING";
 })(PurchaseState || (PurchaseState = {}));
+/**
+ * Google Play subscription replacement modes for upgrades/downgrades.
+ * Used with `subscriptionReplacementMode` in `PurchaseOptions`.
+ * @see https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.SubscriptionUpdateParams.ReplacementMode
+ */
+var SubscriptionReplacementMode;
+(function (SubscriptionReplacementMode) {
+    /** Replacement takes effect when the old plan expires, and the new price is charged at the same time. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["DEFERRED"] = 6] = "DEFERRED";
+    /** Replacement takes effect immediately. The billing cycle remains the same. The remaining value from the old price is prorated for the new plan. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["WITH_TIME_PRORATION"] = 1] = "WITH_TIME_PRORATION";
+    /** Replacement takes effect immediately. The new price is charged immediately and in full. Any remaining period from the old plan is used to extend the new billing date. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["CHARGE_FULL_PRICE"] = 5] = "CHARGE_FULL_PRICE";
+    /** Replacement takes effect immediately. The new plan price is reduced by the prorated cost of the old plan for the remaining period. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["CHARGE_PRORATED_PRICE"] = 2] = "CHARGE_PRORATED_PRICE";
+    /** Replacement takes effect immediately with no proration. The user is charged full price for the new plan. */
+    SubscriptionReplacementMode[SubscriptionReplacementMode["WITHOUT_PRORATION"] = 3] = "WITHOUT_PRORATION";
+})(SubscriptionReplacementMode || (SubscriptionReplacementMode = {}));
 /**
  * Initialize the IAP plugin.
  *
@@ -63,6 +81,13 @@ async function getProducts(productIds, productType = "subs") {
  *   obfuscatedAccountId: 'user_account_id',
  *   obfuscatedProfileId: 'user_profile_id'
  * });
+ *
+ * // Subscription upgrade/downgrade (Android)
+ * const purchase = await purchase('com.example.premium', 'subs', {
+ *   offerToken: 'new_plan_offer_token',
+ *   oldPurchaseToken: 'existing_subscription_purchase_token',
+ *   subscriptionReplacementMode: SubscriptionReplacementMode.WITH_TIME_PRORATION
+ * });
  * ```
  */
 async function purchase(productId, productType = "subs", options) {
@@ -181,4 +206,4 @@ async function onPurchaseUpdated(callback) {
     return await addPluginListener("iap", "purchaseUpdated", callback);
 }
 
-export { PurchaseState, acknowledgePurchase, getProductStatus, getProducts, getPurchaseHistory, initialize, onPurchaseUpdated, purchase, restorePurchases };
+export { PurchaseState, SubscriptionReplacementMode, acknowledgePurchase, getProductStatus, getProducts, getPurchaseHistory, initialize, onPurchaseUpdated, purchase, restorePurchases };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@choochmeque/tauri-plugin-iap-api",
-  "version": "0.7.1",
+  "version": "0.8.2",
   "license": "MIT",
   "author": "You",
   "description": "A Tauri v2 plugin that enables In-App Purchases (IAP)",
@@ -40,7 +40,7 @@
     "@vitest/coverage-v8": "^4.0.13",
     "@vitest/ui": "^4.0.13",
     "happy-dom": "^20.0.10",
-    "prettier": "3.8.0",
+    "prettier": "3.8.1",
     "rollup": "^4.9.6",
     "tslib": "^2.6.2",
     "typescript": "^5.3.3",