feat!: drop deprecated APIs for v3 (#199)

### Summary
Remove all deprecated public APIs and aliases for the 3.0.0 major
release. Unify tokens to `purchaseToken`, drop legacy fields, and delete
iOS alias wrappers.

### Changes
- Remove deprecated functions: getProducts, getSubscriptions,
requestProducts, requestSubscription, getPurchaseHistory
- Remove iOS wrapper aliases (non-*IOS) and `transactionUpdatedIOS`
- Unify Android/iOS token fields to `purchaseToken`; drop
`purchaseTokenAndroid` and `jwsRepresentationIOS`
- Update helpers/tests to stop using removed fields (use `id` instead of
`transactionId`)

Focus on minimal breaking surface per v3 plan.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Breaking Changes**
* Many deprecated/legacy APIs and iOS alias/wrapper helpers removed;
OpenIapEvent.TransactionIapUpdated removed.
* Public types simplified: transactionId, purchaseTokenAndroid, and
jwsRepresentationIOS removed.
* Android unified to use purchaseToken; iOS manage-subscriptions
endpoint now returns detailed purchase data (not boolean).

* **Migration**
* Use fetchProducts and purchaseUpdatedListener; migrate to id and
purchaseToken as canonical identifiers.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: hyochan

android/src/main/java/expo/modules/iap/ExpoIapModule.kt

@@ -259,7 +259,7 @@ class ExpoIapModule : Module() {
                 scope.launch {
                     try {
                         openIap.consumePurchaseAndroid(token)
-                        promise.resolve(mapOf("responseCode" to 0, "purchaseTokenAndroid" to token))
+                        promise.resolve(mapOf("responseCode" to 0, "purchaseToken" to token))
                     } catch (e: Exception) {
                         promise.reject(OpenIapError.E_SERVICE_ERROR, e.message, null)
                     }

docs/blog/2025-09-12-v3.0.0.md

@@ -0,0 +1,104 @@
+---
+slug: v3-0-0
+title: v3.0.0 — unified tokens, simplified API, iOS parity
+tags: [release, breaking-change, android, ios]
+---
+
+v3.0.0 is a major cleanup release that removes long‑deprecated APIs, unifies token handling across platforms, and aligns iOS/Android behavior behind a smaller, clearer surface area.
+
+Highlights
+
+- Unified tokens: `Purchase.purchaseToken` is the single source for both iOS and Android. iOS no longer exposes `jwsRepresentationIOS`; use `purchaseToken` instead.
+- Simpler API: Legacy helpers are gone — use `fetchProducts`, `requestPurchase`, `getAvailablePurchases`, and listeners.
+- iOS parity: Only `*IOS` methods remain for iOS‑specific behavior. Also, `showManageSubscriptionsIOS()` now returns purchases (array) rather than just a boolean.
+- Stronger types: Consolidated product/purchase types; removed legacy aliases and fields.
+
+Breaking changes
+
+- Removed functions
+  - `getProducts`, `getSubscriptions`, `requestProducts`, `requestSubscription`
+  - `getPurchaseHistory` / `getPurchaseHistories`
+  - Non‑suffixed iOS aliases (use `*IOS` variants)
+
+- Changed behavior
+  - `showManageSubscriptionsIOS(): Promise<Purchase[]>` — now returns purchases instead of `boolean`.
+  - `getAvailablePurchases` options: only accepts `alsoPublishToEventListenerIOS` and `onlyIncludeActiveItemsIOS`.
+
+Quick migration
+
+- Fetch products (in‑app or subs):
+
+```ts
+import { fetchProducts, type SubscriptionProduct } from 'expo-iap';
+
+const inapps = await fetchProducts({ skus: ['prod1', 'prod2'], type: 'inapp' });
+
+const subs = (await fetchProducts({
+  skus: ['sub_monthly'],
+  type: 'subs',
+})) as SubscriptionProduct[];
+```
+
+- Request purchase (products or subs):
+
+```ts
+import { requestPurchase } from 'expo-iap';
+
+// In‑app
+await requestPurchase({
+  request: { ios: { sku: 'prod1' }, android: { skus: ['prod1'] } },
+  type: 'inapp',
+});
+
+// Subscriptions (Android supply offer tokens)
+await requestPurchase({
+  request: {
+    ios: { sku: 'sub_monthly' },
+    android: {
+      skus: ['sub_monthly'],
+      subscriptionOffers: [{ sku: 'sub_monthly', offerToken: 'your-offer-token' }],
+    },
+  },
+  type: 'subs',
+});
+```
+
+- Restore/available purchases:
+
+```ts
+import { getAvailablePurchases, restorePurchases } from 'expo-iap';
+
+// iOS‑specific flags only
+const purchases = await getAvailablePurchases({
+  alsoPublishToEventListenerIOS: false,
+  onlyIncludeActiveItemsIOS: true,
+});
+
+// Cross‑platform helper that syncs on iOS then lists
+const restored = await restorePurchases({
+  alsoPublishToEventListenerIOS: false,
+  onlyIncludeActiveItemsIOS: true,
+});
+```
+
+- Tokens and finishing transactions:
+
+```ts
+import { finishTransaction, type Purchase } from 'expo-iap';
+
+function getToken(p: Purchase) {
+  return p.purchaseToken; // iOS JWS or Android token
+}
+
+await finishTransaction({ purchase: somePurchase, isConsumable: true });
+```
+
+Notes
+
+- iOS promoted products listener remains `promotedProductListenerIOS`.
+- `getStorefront()` stays as the cross‑platform helper; call `getStorefrontIOS()` for iOS‑explicit.
+
+Changelog
+
+See `CHANGELOG.md` for the full list of changes in 3.0.0.
+

example/__tests__/core-functions.test.tsx

@@ -17,20 +17,7 @@ describe('Core Functions Tests', () => {
       expect(typeof ExpoIap.fetchProducts).toBe('function');
     });
 
-    it('should export deprecated requestProducts function', () => {
-      expect(ExpoIap.requestProducts).toBeDefined();
-      expect(typeof ExpoIap.requestProducts).toBe('function');
-    });
-
-    it('should export deprecated getProducts function', () => {
-      expect(ExpoIap.getProducts).toBeDefined();
-      expect(typeof ExpoIap.getProducts).toBe('function');
-    });
-
-    it('should export deprecated getSubscriptions function', () => {
-      expect(ExpoIap.getSubscriptions).toBeDefined();
-      expect(typeof ExpoIap.getSubscriptions).toBe('function');
-    });
+    // v3: legacy helpers removed (requestProducts/getProducts/getSubscriptions)
 
     it('should export requestPurchase function', () => {
       expect(ExpoIap.requestPurchase).toBeDefined();
@@ -52,7 +39,7 @@ describe('Core Functions Tests', () => {
       expect(typeof ExpoIap.getStorefrontIOS).toBe('function');
     });
 
-    it('should export deprecated getStorefront function', () => {
+    it('should export getStorefront function', () => {
       expect(ExpoIap.getStorefront).toBeDefined();
       expect(typeof ExpoIap.getStorefront).toBe('function');
     });

example/__tests__/ios-functions.test.tsx

@@ -12,11 +12,6 @@ describe('iOS Functions Tests', () => {
       expect(typeof ExpoIap.validateReceiptIOS).toBe('function');
     });
 
-    it('should export deprecated getAppTransaction function', () => {
-      expect(ExpoIap.getAppTransaction).toBeDefined();
-      expect(typeof ExpoIap.getAppTransaction).toBe('function');
-    });
-
     // Note: validateReceiptIOS is not deprecated, but there might be deprecated
     // aliases for backward compatibility
   });
@@ -102,33 +97,6 @@ describe('iOS Functions Tests', () => {
         'getAppTransaction requires Xcode 15.0+ with iOS 16.0 SDK for compilation',
       );
     });
-
-    it('should handle deprecated getAppTransaction function', async () => {
-      const mockTransaction: ExpoIap.AppTransactionIOS = {
-        appTransactionId: 'deprecated-test',
-        bundleId: 'com.example.app',
-        appVersion: '1.0.0',
-        originalAppVersion: '1.0.0',
-        originalPurchaseDate: Date.now(),
-        deviceVerification: 'verification',
-        deviceVerificationNonce: 'nonce',
-        environment: 'Sandbox',
-        signedDate: Date.now(),
-        appId: 123456,
-        appVersionId: 789012,
-        originalPlatform: 'iOS',
-      };
-
-      (ExpoIap.getAppTransaction as jest.Mock).mockResolvedValue(
-        mockTransaction,
-      );
-
-      const result = await ExpoIap.getAppTransaction();
-
-      expect(ExpoIap.getAppTransaction).toHaveBeenCalledTimes(1);
-      expect(result).toEqual(mockTransaction);
-      expect(result?.environment).toBe('Sandbox');
-    });
   });
 
   describe('Type Exports', () => {
@@ -169,20 +137,5 @@ describe('iOS Functions Tests', () => {
       expect(ExpoIap.getTransactionJwsIOS).toBeDefined();
       expect(ExpoIap.presentCodeRedemptionSheetIOS).toBeDefined();
     });
-
-    it('should export deprecated iOS functions', () => {
-      // Deprecated functions without IOS suffix
-      expect(ExpoIap.sync).toBeDefined();
-      expect(ExpoIap.isEligibleForIntroOffer).toBeDefined();
-      expect(ExpoIap.subscriptionStatus).toBeDefined();
-      expect(ExpoIap.currentEntitlement).toBeDefined();
-      expect(ExpoIap.latestTransaction).toBeDefined();
-      expect(ExpoIap.beginRefundRequest).toBeDefined();
-      expect(ExpoIap.showManageSubscriptions).toBeDefined();
-      expect(ExpoIap.getReceiptIOS).toBeDefined();
-      expect(ExpoIap.isTransactionVerified).toBeDefined();
-      expect(ExpoIap.getTransactionJws).toBeDefined();
-      expect(ExpoIap.presentCodeRedemptionSheet).toBeDefined();
-    });
   });
 });

example/__tests__/subscription-flow.test.tsx

@@ -58,7 +58,6 @@ const createMockAndroidSubscription = () => ({
 const mockUseIAP = jest.fn();
 jest.mock('../../src', () => ({
   initConnection: mockInitConnection,
-  requestProducts: jest.fn(),
   requestPurchase: mockRequestPurchase,
   useIAP: () => mockUseIAP(),
 }));

example/jest.setup.js

@@ -32,19 +32,16 @@ jest.mock('expo-iap', () => {
   const mockGetProducts = jest.fn();
   const mockGetSubscriptions = jest.fn();
   const mockRequestPurchase = jest.fn();
-  // Removed in v2.9.0
 
   return {
     // Core functions
     initConnection: jest.fn(),
     endConnection: jest.fn(),
-    getProducts: mockGetProducts,
-    getSubscriptions: mockGetSubscriptions,
     fetchProducts: mockFetchProducts,
-    requestProducts: jest.fn(),
+
     requestPurchase: mockRequestPurchase,
     finishTransaction: mockFinishTransaction,
-    // getPurchaseHistories removed in v2.9.0
+
     getAvailablePurchases: mockGetAvailablePurchases,
 
     // iOS functions with IOS suffix
@@ -63,21 +60,8 @@ jest.mock('expo-iap', () => {
     getAppTransactionIOS: jest.fn(),
     validateReceiptIOS: jest.fn(),
 
-    // Deprecated iOS functions
+    // Cross-platform storefront helper
     getStorefront: jest.fn(),
-    sync: jest.fn(),
-    isEligibleForIntroOffer: jest.fn(),
-    subscriptionStatus: jest.fn(),
-    currentEntitlement: jest.fn(),
-    latestTransaction: jest.fn(),
-    beginRefundRequest: jest.fn(),
-    showManageSubscriptions: jest.fn(),
-    getReceiptIOS: jest.fn(),
-    isTransactionVerified: jest.fn(),
-    getTransactionJws: jest.fn(),
-    presentCodeRedemptionSheet: jest.fn(),
-    getAppTransaction: jest.fn(),
-    validateReceiptIOS: jest.fn(),
 
     // Android functions
     deepLinkToSubscriptionsAndroid: jest.fn(),
@@ -98,8 +82,7 @@ jest.mock('expo-iap', () => {
       currentPurchase: null,
       currentPurchaseError: null,
       fetchProducts: mockFetchProducts,
-      getProducts: mockGetProducts,
-      getSubscriptions: mockGetSubscriptions,
+
       requestPurchase: mockRequestPurchase,
       getAvailablePurchases: mockGetAvailablePurchases,
       finishTransaction: mockFinishTransaction,

ios/ExpoIapModule.swift

@@ -271,6 +271,13 @@ public class ExpoIapModule: Module {
             return try await OpenIapModule.shared.getReceiptDataIOS() ?? ""
         }
 
+        // Backward-compatible alias expected by JS layer/tests
+        AsyncFunction("getReceiptDataIOS") { () async throws -> String in
+            try await ensureConnection()
+            logDebug("getReceiptDataIOS called (alias of getReceiptIOS)")
+            return try await OpenIapModule.shared.getReceiptDataIOS() ?? ""
+        }
+        
         AsyncFunction("requestReceiptRefreshIOS") { () async throws -> String in
             try await ensureConnection()
             logDebug("requestReceiptRefreshIOS called")
@@ -307,11 +314,11 @@ public class ExpoIapModule: Module {
             return true
         }
 
-        AsyncFunction("showManageSubscriptionsIOS") { () async throws -> Bool in
+        AsyncFunction("showManageSubscriptionsIOS") { () async throws -> [[String: Any?]] in
             try await ensureConnection()
             logDebug("showManageSubscriptionsIOS called")
-            let _ = try await OpenIapModule.shared.showManageSubscriptionsIOS()
-            return true
+            let purchases = try await OpenIapModule.shared.showManageSubscriptionsIOS()
+            return OpenIapSerialization.purchases(purchases)
         }
 
         AsyncFunction("deepLinkToSubscriptionsIOS") { () async throws in

src/ExpoIap.types.ts

@@ -37,7 +37,6 @@ export type PurchaseCommon = {
   id: string; // Transaction identifier - used by finishTransaction
   productId: string; // Product identifier - which product was purchased
   ids?: string[]; // Product identifiers for purchases that include multiple products
-  transactionId?: string; // @deprecated - use id instead
   transactionDate: number;
   transactionReceipt: string;
   purchaseToken?: string; // Unified purchase token (jwsRepresentation for iOS, purchaseToken for Android)
@@ -70,17 +69,11 @@ export type Purchase =
   | (PurchaseAndroid & AndroidPlatform)
   | (PurchaseIOS & IosPlatform);
 
-// Removed legacy type aliases `ProductPurchase` and `SubscriptionPurchase` in v2.9.0
-
 export type PurchaseResult = {
   responseCode?: number;
   debugMessage?: string;
   code?: string;
   message?: string;
-  /**
-   * @deprecated Use `purchaseToken` instead. This field will be removed in a future version.
-   */
-  purchaseTokenAndroid?: string;
   purchaseToken?: string;
 };
 /**
@@ -399,7 +392,6 @@ export interface RequestPurchaseAndroidProps {
  */
 export interface RequestSubscriptionAndroidProps
   extends RequestPurchaseAndroidProps {
-  readonly purchaseTokenAndroid?: string;
   readonly replacementModeAndroid?: number;
   readonly subscriptionOffers: {
     sku: string;