@choochmeque/tauri-plugin-iap-api 0.3.2 → 0.4.0

package/README.md

@@ -7,7 +7,7 @@
 
 # Tauri Plugin IAP
 
-A Tauri plugin for In-App Purchases (IAP) with support for subscriptions on both iOS (StoreKit 2) and Android (Google Play Billing).
+A Tauri plugin for In-App Purchases (IAP) with support for subscriptions on iOS (StoreKit 2), Android (Google Play Billing) and Windows (Microsoft Store).
 
 ## Features
 
@@ -20,11 +20,15 @@ A Tauri plugin for In-App Purchases (IAP) with support for subscriptions on both
 - Real-time purchase state updates via events
 - Automatic transaction verification (iOS)
 - Support for introductory offers and free trials
+- Fraud prevention with obfuscated account/profile IDs (Android)
+- App account token support for tracking (iOS)
+- Automatic offer token selection (Android)
 
 ## Platform Support
 
 - **iOS**: StoreKit 2 (requires iOS 15.0+)
 - **Android**: Google Play Billing Library v8.0.0
+- **Windows**: Microsoft Store API (Windows 10/11)
 
 ## Installation
 
@@ -42,7 +46,7 @@ Add the plugin to your Tauri project's `Cargo.toml`:
 
 ```toml
 [dependencies]
-tauri-plugin-iap = "0.1"
+tauri-plugin-iap = "0.4"
 ```
 
 Configure the plugin permissions in your `capabilities/default.json`:
@@ -98,9 +102,24 @@ if (status.isOwned && status.purchaseState === PurchaseState.PURCHASED) {
 }
 
 // Purchase a subscription or in-app product
-// On Android: use the offer token from subscriptionOfferDetails
-// On iOS: offer token is not used
-const purchaseResult = await purchase('subscription_id_1', 'subs', offerToken);
+// Simple purchase (will use first available offer on Android if not specified)
+const purchaseResult = await purchase('subscription_id_1', 'subs');
+
+// With specific offer token (Android)
+const purchaseResult = await purchase('subscription_id_1', 'subs', {
+  offerToken: product.subscriptionOfferDetails[0].offerToken
+});
+
+// With fraud prevention (Android)
+const purchaseResult = await purchase('subscription_id_1', 'subs', {
+  obfuscatedAccountId: 'hashed_account_id',
+  obfuscatedProfileId: 'hashed_profile_id'
+});
+
+// With app account token (iOS - must be valid UUID)
+const purchaseResult = await purchase('subscription_id_1', 'subs', {
+  appAccountToken: '550e8400-e29b-41d4-a716-446655440000'
+});
 
 // Restore purchases (specify product type)
 const restored = await restorePurchases('subs');
@@ -137,6 +156,13 @@ unlisten();
 3. Configure your app's billing permissions (already included in the plugin)
 4. Test with test accounts or sandbox environment
 
+### Windows Setup
+
+1. Register your app in Microsoft Partner Center
+2. Create add-on products (consumables, durables, or subscriptions)
+3. Associate your app with the Microsoft Store
+4. Test with Windows sandbox environment
+
 ## API Reference
 
 ### `initialize()`
@@ -154,13 +180,17 @@ Fetches product details from the store.
   - `formattedPrice`: Localized price string
   - `subscriptionOfferDetails`: (subscriptions only) Array of offers
 
-### `purchase(productId: string, productType: 'subs' | 'inapp' = 'subs', offerToken?: string)`
-Initiates a purchase flow.
+### `purchase(productId: string, productType: 'subs' | 'inapp' = 'subs', options?: PurchaseOptions)`
+Initiates a purchase flow with enhanced options for fraud prevention and account management.
 
 **Parameters:**
 - `productId`: The product to purchase
 - `productType`: Type of product ('subs' for subscriptions, 'inapp' for one-time purchases), defaults to 'subs'
-- `offerToken`: (Android only) The offer token for subscriptions
+- `options`: Optional purchase parameters:
+  - `offerToken`: (Android) Specific offer to purchase. If not provided, uses first available offer
+  - `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
 
 **Returns:** Purchase object with transaction details
 
@@ -211,6 +241,11 @@ Listens for purchase state changes.
 - Offer tokens required for subscription purchases
 - More detailed pricing phase information
 
+### Windows (Microsoft Store)
+- Automatic acknowledgment handled by the Store
+- Supports consumables, durables, and subscriptions
+- Uses SKUs for subscription offer variations
+
 ## Testing
 
 ### iOS
@@ -223,6 +258,12 @@ Listens for purchase state changes.
 2. Add test accounts in Google Play Console
 3. Test with test payment methods
 
+### Windows
+1. Use Microsoft Store sandbox environment
+2. Configure test accounts in Partner Center
+3. Test with Windows Dev Center test payment methods
+4. Ensure app is associated with Store listing
+
 ## License
 
 [MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@choochmeque/tauri-plugin-iap-api",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "license": "MIT",
   "author": "You",
   "description": "A Tauri v2 plugin that enables In-App Purchases (IAP)",