@choochmeque/tauri-plugin-iap-api 0.1.0

package/README.md

@@ -0,0 +1,168 @@
+# 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).
+
+## Features
+
+- Initialize billing/store connection
+- Query products and subscriptions with detailed pricing
+- Purchase subscriptions with platform-specific features
+- Restore previous purchases
+- Get purchase history
+- Real-time purchase state updates via events
+- Automatic transaction verification (iOS)
+- Support for introductory offers and free trials
+
+## Platform Support
+
+- **iOS**: StoreKit 2 (requires iOS 15.0+)
+- **Android**: Google Play Billing Library v8.0.0
+
+## Installation
+
+Add the plugin to your Tauri project:
+
+```toml
+[dependencies]
+tauri-plugin-iap = { path = "../path-to-plugin" }
+```
+
+Register the plugin in your Tauri app:
+
+```rust
+fn main() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_iap::init())
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}
+```
+
+## Usage
+
+### JavaScript/TypeScript
+
+```typescript
+import {
+  initialize,
+  getProducts,
+  purchase,
+  restorePurchases,
+  acknowledgePurchase,
+  onPurchaseUpdated
+} from 'tauri-plugin-iap-api';
+
+// Initialize the billing client
+await initialize();
+
+// Get available products
+const products = await getProducts(['subscription_id_1', 'subscription_id_2'], 'subs');
+
+// Purchase a subscription
+// On Android: use the offer token from subscriptionOfferDetails
+// On iOS: offer token is not used
+const purchaseResult = await purchase('subscription_id_1', offerToken);
+
+// Restore purchases
+const restored = await restorePurchases();
+
+// Acknowledge a purchase (Android only, iOS auto-acknowledges)
+await acknowledgePurchase(purchaseResult.purchaseToken);
+
+// Listen for purchase updates
+const unlisten = onPurchaseUpdated((purchase) => {
+  console.log('Purchase updated:', purchase);
+});
+
+// Stop listening
+unlisten();
+```
+
+## Platform Setup
+
+### iOS Setup
+
+1. Configure your app in App Store Connect
+2. Create subscription products with appropriate pricing
+3. Add In-App Purchase capability to your app in Xcode:
+   - Open your project in Xcode
+   - Select your target
+   - Go to "Signing & Capabilities"
+   - Click "+" and add "In-App Purchase"
+4. Test with sandbox accounts
+
+### Android Setup
+
+1. Add your app to Google Play Console
+2. Create subscription products in Google Play Console
+3. Configure your app's billing permissions (already included in the plugin)
+4. Test with test accounts or sandbox environment
+
+## API Reference
+
+### `initialize()`
+Initializes the billing client connection (required on Android, no-op on iOS).
+
+### `getProducts(productIds: string[], productType: 'subs' | 'inapp')`
+Fetches product details from the store.
+
+**Returns:**
+- `products`: Array of product objects with:
+  - `productId`: Product identifier
+  - `title`: Display name
+  - `description`: Product description
+  - `productType`: Type of product
+  - `formattedPrice`: Localized price string
+  - `subscriptionOfferDetails`: (subscriptions only) Array of offers
+
+### `purchase(productId: string, offerToken?: string)`
+Initiates a purchase flow.
+
+**Parameters:**
+- `productId`: The product to purchase
+- `offerToken`: (Android only) The offer token for subscriptions
+
+**Returns:** Purchase object with transaction details
+
+### `restorePurchases()`
+Queries and returns all active purchases.
+
+### `getPurchaseHistory()`
+Returns the complete purchase history.
+
+### `acknowledgePurchase(purchaseToken: string)`
+Acknowledges a purchase (required on Android within 3 days, no-op on iOS).
+
+### `onPurchaseUpdated(callback: (purchase: Purchase) => void)`
+Listens for purchase state changes.
+
+## Differences Between Platforms
+
+### iOS (StoreKit 2)
+- Automatic transaction verification
+- No manual acknowledgment needed
+- Supports introductory offers and promotional offers
+- Transaction updates are automatically observed
+- Requires iOS 15.0+
+
+### Android (Google Play Billing)
+- Manual acknowledgment required within 3 days
+- Supports multiple subscription offers per product
+- Offer tokens required for subscription purchases
+- More detailed pricing phase information
+
+## Testing
+
+### iOS
+1. Use sandbox test accounts
+2. Test on physical devices (subscriptions don't work well on simulators)
+3. Clear purchase history in Settings > App Store > Sandbox Account
+
+### Android
+1. Upload your app to internal testing track
+2. Add test accounts in Google Play Console
+3. Test with test payment methods
+
+## License
+
+MIT or Apache-2.0

package/dist-js/index.cjs

@@ -0,0 +1,54 @@
+'use strict';
+
+var core = require('@tauri-apps/api/core');
+var event = require('@tauri-apps/api/event');
+
+async function initialize() {
+    return await core.invoke('plugin:iap|initialize');
+}
+async function getProducts(productIds, productType = 'subs') {
+    return await core.invoke('plugin:iap|get_products', {
+        payload: {
+            productIds,
+            productType,
+        },
+    });
+}
+async function purchase(productId, offerToken) {
+    return await core.invoke('plugin:iap|purchase', {
+        payload: {
+            productId,
+            offerToken,
+        },
+    });
+}
+async function restorePurchases() {
+    return await core.invoke('plugin:iap|restore_purchases');
+}
+async function getPurchaseHistory() {
+    return await core.invoke('plugin:iap|get_purchase_history');
+}
+async function acknowledgePurchase(purchaseToken) {
+    return await core.invoke('plugin:iap|acknowledge_purchase', {
+        payload: {
+            purchaseToken,
+        },
+    });
+}
+// Event listener for purchase updates
+function onPurchaseUpdated(callback) {
+    const unlisten = event.listen('purchaseUpdated', (event) => {
+        callback(event.payload);
+    });
+    return () => {
+        unlisten.then((fn) => fn());
+    };
+}
+
+exports.acknowledgePurchase = acknowledgePurchase;
+exports.getProducts = getProducts;
+exports.getPurchaseHistory = getPurchaseHistory;
+exports.initialize = initialize;
+exports.onPurchaseUpdated = onPurchaseUpdated;
+exports.purchase = purchase;
+exports.restorePurchases = restorePurchases;

package/dist-js/index.d.ts

@@ -0,0 +1,66 @@
+export interface InitializeResponse {
+    success: boolean;
+}
+export interface PricingPhase {
+    formattedPrice: string;
+    priceCurrencyCode: string;
+    priceAmountMicros: number;
+    billingPeriod: string;
+    billingCycleCount: number;
+    recurrenceMode: number;
+}
+export interface SubscriptionOffer {
+    offerToken: string;
+    basePlanId: string;
+    offerId?: string;
+    pricingPhases: PricingPhase[];
+}
+export interface Product {
+    productId: string;
+    title: string;
+    description: string;
+    productType: string;
+    formattedPrice?: string;
+    priceCurrencyCode?: string;
+    priceAmountMicros?: number;
+    subscriptionOfferDetails?: SubscriptionOffer[];
+}
+export interface GetProductsResponse {
+    products: Product[];
+}
+export interface Purchase {
+    orderId?: string;
+    packageName: string;
+    productId: string;
+    purchaseTime: number;
+    purchaseToken: string;
+    purchaseState: number;
+    isAutoRenewing: boolean;
+    isAcknowledged: boolean;
+    originalJson: string;
+    signature: string;
+}
+export interface RestorePurchasesResponse {
+    purchases: Purchase[];
+}
+export interface PurchaseHistoryRecord {
+    productId: string;
+    purchaseTime: number;
+    purchaseToken: string;
+    quantity: number;
+    originalJson: string;
+    signature: string;
+}
+export interface GetPurchaseHistoryResponse {
+    history: PurchaseHistoryRecord[];
+}
+export interface AcknowledgePurchaseResponse {
+    success: boolean;
+}
+export declare function initialize(): Promise<InitializeResponse>;
+export declare function getProducts(productIds: string[], productType?: 'subs' | 'inapp'): Promise<GetProductsResponse>;
+export declare function purchase(productId: string, offerToken?: string): Promise<Purchase>;
+export declare function restorePurchases(): Promise<RestorePurchasesResponse>;
+export declare function getPurchaseHistory(): Promise<GetPurchaseHistoryResponse>;
+export declare function acknowledgePurchase(purchaseToken: string): Promise<AcknowledgePurchaseResponse>;
+export declare function onPurchaseUpdated(callback: (purchase: Purchase) => void): () => void;

package/dist-js/index.js

@@ -0,0 +1,46 @@
+import { invoke } from '@tauri-apps/api/core';
+import { listen } from '@tauri-apps/api/event';
+
+async function initialize() {
+    return await invoke('plugin:iap|initialize');
+}
+async function getProducts(productIds, productType = 'subs') {
+    return await invoke('plugin:iap|get_products', {
+        payload: {
+            productIds,
+            productType,
+        },
+    });
+}
+async function purchase(productId, offerToken) {
+    return await invoke('plugin:iap|purchase', {
+        payload: {
+            productId,
+            offerToken,
+        },
+    });
+}
+async function restorePurchases() {
+    return await invoke('plugin:iap|restore_purchases');
+}
+async function getPurchaseHistory() {
+    return await invoke('plugin:iap|get_purchase_history');
+}
+async function acknowledgePurchase(purchaseToken) {
+    return await invoke('plugin:iap|acknowledge_purchase', {
+        payload: {
+            purchaseToken,
+        },
+    });
+}
+// Event listener for purchase updates
+function onPurchaseUpdated(callback) {
+    const unlisten = listen('purchaseUpdated', (event) => {
+        callback(event.payload);
+    });
+    return () => {
+        unlisten.then((fn) => fn());
+    };
+}
+
+export { acknowledgePurchase, getProducts, getPurchaseHistory, initialize, onPurchaseUpdated, purchase, restorePurchases };

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@choochmeque/tauri-plugin-iap-api",
+  "version": "0.1.0",
+  "author": "You",
+  "description": "Tauri plugin for in-app purchases",
+  "type": "module",
+  "types": "./dist-js/index.d.ts",
+  "main": "./dist-js/index.cjs",
+  "module": "./dist-js/index.js",
+  "exports": {
+    "types": "./dist-js/index.d.ts",
+    "import": "./dist-js/index.js",
+    "require": "./dist-js/index.cjs"
+  },
+  "files": [
+    "dist-js",
+    "README.md"
+  ],
+  "directories": {
+    "example": "examples"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Choochmeque/tauri-plugin-iap.git"
+  },
+  "keywords": [
+    "tauri",
+    "iap"
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Choochmeque/tauri-plugin-iap/issues"
+  },
+  "homepage": "https://github.com/Choochmeque/tauri-plugin-iap#readme",
+  "scripts": {
+    "build": "rollup -c",
+    "prepublishOnly": "pnpm build",
+    "pretest": "pnpm build"
+  },
+  "dependencies": {
+    "@tauri-apps/api": ">=2.0.0-beta.6"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.1.4",
+    "rollup": "^4.9.6",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  },
+  "packageManager": "pnpm@10.9.0+sha512.0486e394640d3c1fb3c9d43d49cf92879ff74f8516959c235308f5a8f62e2e19528a65cdc2a3058f587cde71eba3d5b56327c8c33a97e4c4051ca48a10ca2d5f"
+}