expo-iap 2.4.4 → 2.4.5

package/ios/ExpoIapModule.swift

@@ -186,7 +186,32 @@ public class ExpoIapModule: Module {
         Name("ExpoIap")
 
         Constants([
-            "PI": Double.pi
+            "ERROR_CODES": [
+                "E_UNKNOWN": IapErrorCode.unknown,
+                "E_SERVICE_ERROR": IapErrorCode.serviceError,
+                "E_USER_CANCELLED": IapErrorCode.userCancelled,
+                "E_USER_ERROR": IapErrorCode.userError,
+                "E_ITEM_UNAVAILABLE": IapErrorCode.itemUnavailable,
+                "E_REMOTE_ERROR": IapErrorCode.remoteError,
+                "E_NETWORK_ERROR": IapErrorCode.networkError,
+                "E_RECEIPT_FAILED": IapErrorCode.receiptFailed,
+                "E_RECEIPT_FINISHED_FAILED": IapErrorCode.receiptFinishedFailed,
+                "E_NOT_PREPARED": IapErrorCode.notPrepared,
+                "E_NOT_ENDED": IapErrorCode.notEnded,
+                "E_ALREADY_OWNED": IapErrorCode.alreadyOwned,
+                "E_DEVELOPER_ERROR": IapErrorCode.developerError,
+                "E_PURCHASE_ERROR": IapErrorCode.purchaseError,
+                "E_SYNC_ERROR": IapErrorCode.syncError,
+                "E_DEFERRED_PAYMENT": IapErrorCode.deferredPayment,
+                "E_TRANSACTION_VALIDATION_FAILED": IapErrorCode.transactionValidationFailed,
+                "E_BILLING_RESPONSE_JSON_PARSE_ERROR": IapErrorCode.billingResponseJsonParseError,
+                "E_INTERRUPTED": IapErrorCode.interrupted,
+                "E_IAP_NOT_AVAILABLE": IapErrorCode.iapNotAvailable,
+                "E_ACTIVITY_UNAVAILABLE": IapErrorCode.activityUnavailable,
+                "E_ALREADY_PREPARED": IapErrorCode.alreadyPrepared,
+                "E_PENDING": IapErrorCode.pending,
+                "E_CONNECTION_CLOSED": IapErrorCode.connectionClosed,
+            ]
         ])
 
         Events(IapEvent.PurchaseUpdated, IapEvent.PurchaseError)
@@ -208,7 +233,7 @@ public class ExpoIapModule: Module {
 
         AsyncFunction("getItems") { (skus: [String]) -> [[String: Any?]?] in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.notPrepared)
             }
 
             do {
@@ -294,9 +319,9 @@ public class ExpoIapModule: Module {
                     }
                 } catch StoreError.failedVerification {
                     let err = [
-                        "responseCode": IapErrors.E_TRANSACTION_VALIDATION_FAILED.rawValue,
+                        "responseCode": IapErrorCode.transactionValidationFailed,
                         "debugMessage": StoreError.failedVerification.localizedDescription,
-                        "code": IapErrors.E_TRANSACTION_VALIDATION_FAILED.rawValue,
+                        "code": IapErrorCode.transactionValidationFailed,
                         "message": StoreError.failedVerification.localizedDescription,
                         "productId": "unknown",
                     ]
@@ -305,9 +330,9 @@ public class ExpoIapModule: Module {
                     }
                 } catch {
                     let err = [
-                        "responseCode": IapErrors.E_UNKNOWN.rawValue,
+                        "responseCode": IapErrorCode.unknown,
                         "debugMessage": error.localizedDescription,
-                        "code": IapErrors.E_UNKNOWN.rawValue,
+                        "code": IapErrorCode.unknown,
                         "message": error.localizedDescription,
                         "productId": "unknown",
                     ]
@@ -325,7 +350,7 @@ public class ExpoIapModule: Module {
                 appAccountToken: String?, quantity: Int, discountOffer: [String: String]?
             ) -> [String: Any?]? in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
 
             let product: Product? = await productStore.getProduct(productID: sku)
@@ -355,7 +380,7 @@ public class ExpoIapModule: Module {
                         options.insert(.appAccountToken(appAccountUUID))
                     }
                     guard let windowScene = await self.currentWindowScene() else {
-                        throw Exception(name: "ExpoIapModule", description: "Could not find window scene", code: "2")
+                        throw Exception(name: "ExpoIapModule", description: "Could not find window scene", code: IapErrorCode.serviceError)
                     }
                     let result: Product.PurchaseResult
                     #if swift(>=5.9)
@@ -398,20 +423,20 @@ public class ExpoIapModule: Module {
                             return serialized
                         }
                     case .userCancelled:
-                        throw Exception(name: "ExpoIapModule", description: "User cancelled the purchase", code: "3")
+                        throw Exception(name: "ExpoIapModule", description: "User cancelled the purchase", code: IapErrorCode.userCancelled)
                     case .pending:
-                        throw Exception(name: "ExpoIapModule", description: "The payment was deferred", code: "4")
+                        throw Exception(name: "ExpoIapModule", description: "The payment was deferred", code: IapErrorCode.deferredPayment)
                     @unknown default:
-                        throw Exception(name: "ExpoIapModule", description: "Unknown purchase result", code: "5")
+                        throw Exception(name: "ExpoIapModule", description: "Unknown purchase result", code: IapErrorCode.unknown)
                     }
                 } catch {
                     if error is Exception {
                         throw error
                     }
-                    throw Exception(name: "ExpoIapModule", description: "Purchase failed: \(error.localizedDescription)", code: "6")
+                    throw Exception(name: "ExpoIapModule", description: "Purchase failed: \(error.localizedDescription)", code: IapErrorCode.purchaseError)
                 }
             } else {
-                throw Exception(name: "ExpoIapModule", description: "Invalid product ID", code: "7")
+                throw Exception(name: "ExpoIapModule", description: "Invalid product ID", code: IapErrorCode.itemUnavailable)
             }
         }
 
@@ -421,7 +446,7 @@ public class ExpoIapModule: Module {
 
         AsyncFunction("subscriptionStatus") { (sku: String) -> [[String: Any?]?]? in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
 
             do {
@@ -436,13 +461,13 @@ public class ExpoIapModule: Module {
                 if error is Exception {
                     throw error
                 }
-                throw Exception(name: "ExpoIapModule", description: "Error getting subscription status: \(error.localizedDescription)", code: "2")
+                throw Exception(name: "ExpoIapModule", description: "Error getting subscription status: \(error.localizedDescription)", code: IapErrorCode.serviceError)
             }
         }
 
         AsyncFunction("currentEntitlement") { (sku: String) -> [String: Any?]? in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
 
             if let product = await productStore.getProduct(productID: sku) {
@@ -451,24 +476,24 @@ public class ExpoIapModule: Module {
                         let transaction = try self.checkVerified(result)
                         return serializeTransaction(transaction)
                     } catch StoreError.failedVerification {
-                        throw Exception(name: "ExpoIapModule", description: "Failed to verify transaction for sku \(sku)", code: "2")
+                        throw Exception(name: "ExpoIapModule", description: "Failed to verify transaction for sku \(sku)", code: IapErrorCode.transactionValidationFailed)
                     } catch {
                         if error is Exception {
                             throw error
                         }
-                        throw Exception(name: "ExpoIapModule", description: "Error fetching entitlement for sku \(sku): \(error.localizedDescription)", code: "3")
+                        throw Exception(name: "ExpoIapModule", description: "Error fetching entitlement for sku \(sku): \(error.localizedDescription)", code: IapErrorCode.serviceError)
                     }
                 } else {
-                    throw Exception(name: "ExpoIapModule", description: "Can't find entitlement for sku \(sku)", code: "4")
+                    throw Exception(name: "ExpoIapModule", description: "Can't find entitlement for sku \(sku)", code: IapErrorCode.itemUnavailable)
                 }
             } else {
-                throw Exception(name: "ExpoIapModule", description: "Can't find product for sku \(sku)", code: "5")
+                throw Exception(name: "ExpoIapModule", description: "Can't find product for sku \(sku)", code: IapErrorCode.itemUnavailable)
             }
         }
 
         AsyncFunction("latestTransaction") { (sku: String) -> [String: Any?]? in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
 
             if let product = await productStore.getProduct(productID: sku) {
@@ -477,18 +502,18 @@ public class ExpoIapModule: Module {
                         let transaction = try self.checkVerified(result)
                         return serializeTransaction(transaction)
                     } catch StoreError.failedVerification {
-                        throw Exception(name: "ExpoIapModule", description: "Failed to verify transaction for sku \(sku)", code: "2")
+                        throw Exception(name: "ExpoIapModule", description: "Failed to verify transaction for sku \(sku)", code: IapErrorCode.transactionValidationFailed)
                     } catch {
                         if error is Exception {
                             throw error
                         }
-                        throw Exception(name: "ExpoIapModule", description: "Error fetching latest transaction for sku \(sku): \(error.localizedDescription)", code: "3")
+                        throw Exception(name: "ExpoIapModule", description: "Error fetching latest transaction for sku \(sku): \(error.localizedDescription)", code: IapErrorCode.serviceError)
                     }
                 } else {
-                    throw Exception(name: "ExpoIapModule", description: "Can't find latest transaction for sku \(sku)", code: "4")
+                    throw Exception(name: "ExpoIapModule", description: "Can't find latest transaction for sku \(sku)", code: IapErrorCode.itemUnavailable)
                 }
             } else {
-                throw Exception(name: "ExpoIapModule", description: "Can't find product for sku \(sku)", code: "5")
+                throw Exception(name: "ExpoIapModule", description: "Can't find product for sku \(sku)", code: IapErrorCode.itemUnavailable)
             }
         }
 
@@ -498,7 +523,7 @@ public class ExpoIapModule: Module {
                 self.transactions.removeValue(forKey: transactionIdentifier)
                 return true
             } else {
-                throw Exception(name: "ExpoIapModule", description: "Invalid transaction ID", code: "8")
+                throw Exception(name: "ExpoIapModule", description: "Invalid transaction ID", code: IapErrorCode.developerError)
             }
         }
 
@@ -514,7 +539,7 @@ public class ExpoIapModule: Module {
                 if error is Exception {
                     throw error
                 }
-                throw Exception(name: "ExpoIapModule", description: "Error synchronizing with the AppStore: \(error.localizedDescription)", code: "9")
+                throw Exception(name: "ExpoIapModule", description: "Error synchronizing with the AppStore: \(error.localizedDescription)", code: IapErrorCode.syncError)
             }
         }
 
@@ -523,14 +548,14 @@ public class ExpoIapModule: Module {
                 SKPaymentQueue.default().presentCodeRedemptionSheet()
                 return true
             #else
-                throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: "10")
+                throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: IapErrorCode.serviceError)
             #endif
         }
 
         AsyncFunction("showManageSubscriptions") { () -> Bool in
             #if !os(tvOS)
                 guard let windowScene = await self.currentWindowScene() else {
-                    throw Exception(name: "ExpoIapModule", description: "Cannot find window scene or not available on macOS", code: "11")
+                    throw Exception(name: "ExpoIapModule", description: "Cannot find window scene or not available on macOS", code: IapErrorCode.serviceError)
                 }
                 // Get all subscription products before showing the management UI
                 let subscriptionSkus = await self.getAllSubscriptionProductIds()
@@ -541,7 +566,7 @@ public class ExpoIapModule: Module {
                 self.pollForSubscriptionStatusChanges()
                 return true
             #else
-                throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: "12")
+                throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: IapErrorCode.serviceError)
             #endif
         }
 
@@ -567,26 +592,26 @@ public class ExpoIapModule: Module {
                 guard let product = await self.productStore?.getProduct(productID: sku),
                     let result = await product.latestTransaction
                 else {
-                    throw Exception(name: "ExpoIapModule", description: "Can't find product or transaction for sku \(sku)", code: "5")
+                    throw Exception(name: "ExpoIapModule", description: "Can't find product or transaction for sku \(sku)", code: IapErrorCode.itemUnavailable)
                 }
 
                 do {
                     let transaction = try self.checkVerified(result)
                     guard let windowScene = await self.currentWindowScene() else {
-                        throw Exception(name: "ExpoIapModule", description: "Cannot find window scene or not available on macOS", code: "11")
+                        throw Exception(name: "ExpoIapModule", description: "Cannot find window scene or not available on macOS", code: IapErrorCode.serviceError)
                     }
                     let refundStatus = try await transaction.beginRefundRequest(in: windowScene)
                     return serialize(refundStatus)
                 } catch StoreError.failedVerification {
-                    throw Exception(name: "ExpoIapModule", description: "Failed to verify transaction for sku \(sku)", code: "2")
+                    throw Exception(name: "ExpoIapModule", description: "Failed to verify transaction for sku \(sku)", code: IapErrorCode.transactionValidationFailed)
                 } catch {
                     if error is Exception {
                         throw error
                     }
-                    throw Exception(name: "ExpoIapModule", description: "Failed to refund purchase: \(error.localizedDescription)", code: "3")
+                    throw Exception(name: "ExpoIapModule", description: "Failed to refund purchase: \(error.localizedDescription)", code: IapErrorCode.serviceError)
                 }
             #else
-                throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: "12")
+                throw Exception(name: "ExpoIapModule", description: "This method is not available on tvOS", code: IapErrorCode.serviceError)
             #endif
         }
 
@@ -601,7 +626,7 @@ public class ExpoIapModule: Module {
 
         AsyncFunction("isTransactionVerified") { (sku: String) -> Bool in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
             
             if let product = await productStore.getProduct(productID: sku),
@@ -619,20 +644,20 @@ public class ExpoIapModule: Module {
 
         AsyncFunction("getTransactionJws") { (sku: String) -> String? in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
             
             if let product = await productStore.getProduct(productID: sku),
                let result = await product.latestTransaction {
                 return result.jwsRepresentation
             } else {
-                throw Exception(name: "ExpoIapModule", description: "Can't find transaction for sku \(sku)", code: "5")
+                throw Exception(name: "ExpoIapModule", description: "Can't find transaction for sku \(sku)", code: IapErrorCode.itemUnavailable)
             }
         }
 
         AsyncFunction("validateReceiptIos") { (sku: String) -> [String: Any] in
             guard let productStore = self.productStore else {
-                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: "1")
+                throw Exception(name: "ExpoIapModule", description: "Connection not initialized", code: IapErrorCode.serviceError)
             }
             
             // Get receipt data
@@ -697,9 +722,9 @@ public class ExpoIapModule: Module {
                 } catch {
                     if self.hasListeners {
                         let err = [
-                            "responseCode": IapErrors.E_TRANSACTION_VALIDATION_FAILED.rawValue,
+                            "responseCode": IapErrorCode.transactionValidationFailed,
                             "debugMessage": error.localizedDescription,
-                            "code": IapErrors.E_TRANSACTION_VALIDATION_FAILED.rawValue,
+                            "code": IapErrorCode.transactionValidationFailed,
                             "message": error.localizedDescription,
                         ]
                         self.sendEvent(IapEvent.PurchaseError, err)
@@ -817,10 +842,10 @@ public class ExpoIapModule: Module {
                 let receiptData = try Data(contentsOf: appStoreReceiptURL, options: .alwaysMapped)
                 return receiptData.base64EncodedString(options: [])
             } catch {
-                throw Exception(name: "ExpoIapModule", description: "Error reading receipt data: \(error.localizedDescription)", code: "13")
+                throw Exception(name: "ExpoIapModule", description: "Error reading receipt data: \(error.localizedDescription)", code: IapErrorCode.receiptFailed)
             }
         } else {
-            throw Exception(name: "ExpoIapModule", description: "App Store receipt not found", code: "14")
+            throw Exception(name: "ExpoIapModule", description: "App Store receipt not found", code: IapErrorCode.receiptFailed)
         }
     }
 }

package/ios/Types.swift

@@ -12,24 +12,32 @@ public enum StoreError: Error {
     case failedVerification
 }
 
-enum IapErrors: String, CaseIterable {
-    case E_UNKNOWN = "E_UNKNOWN"
-    case E_SERVICE_ERROR = "E_SERVICE_ERROR"
-    case E_USER_CANCELLED = "E_USER_CANCELLED"
-    case E_USER_ERROR = "E_USER_ERROR"
-    case E_ITEM_UNAVAILABLE = "E_ITEM_UNAVAILABLE"
-    case E_REMOTE_ERROR = "E_REMOTE_ERROR"
-    case E_NETWORK_ERROR = "E_NETWORK_ERROR"
-    case E_RECEIPT_FAILED = "E_RECEIPT_FAILED"
-    case E_RECEIPT_FINISHED_FAILED = "E_RECEIPT_FINISHED_FAILED"
-    case E_DEVELOPER_ERROR = "E_DEVELOPER_ERROR"
-    case E_PURCHASE_ERROR = "E_PURCHASE_ERROR"
-    case E_SYNC_ERROR = "E_SYNC_ERROR"
-    case E_DEFERRED_PAYMENT = "E_DEFERRED_PAYMENT"
-    case E_TRANSACTION_VALIDATION_FAILED = "E_TRANSACTION_VALIDATION_FAILED"
-    func asInt() -> Int {
-        return IapErrors.allCases.firstIndex(of: self)!
-    }
+// Error codes for IAP operations - centralized error code management
+struct IapErrorCode {
+    static let unknown = "E_UNKNOWN"
+    static let serviceError = "E_SERVICE_ERROR"
+    static let userCancelled = "E_USER_CANCELLED"
+    static let userError = "E_USER_ERROR"
+    static let itemUnavailable = "E_ITEM_UNAVAILABLE"
+    static let remoteError = "E_REMOTE_ERROR"
+    static let networkError = "E_NETWORK_ERROR"
+    static let receiptFailed = "E_RECEIPT_FAILED"
+    static let receiptFinishedFailed = "E_RECEIPT_FINISHED_FAILED"
+    static let notPrepared = "E_NOT_PREPARED"
+    static let notEnded = "E_NOT_ENDED"
+    static let alreadyOwned = "E_ALREADY_OWNED"
+    static let developerError = "E_DEVELOPER_ERROR"
+    static let purchaseError = "E_PURCHASE_ERROR"
+    static let syncError = "E_SYNC_ERROR"
+    static let deferredPayment = "E_DEFERRED_PAYMENT"
+    static let transactionValidationFailed = "E_TRANSACTION_VALIDATION_FAILED"
+    static let billingResponseJsonParseError = "E_BILLING_RESPONSE_JSON_PARSE_ERROR"
+    static let interrupted = "E_INTERRUPTED"
+    static let iapNotAvailable = "E_IAP_NOT_AVAILABLE"
+    static let activityUnavailable = "E_ACTIVITY_UNAVAILABLE"
+    static let alreadyPrepared = "E_ALREADY_PREPARED"
+    static let pending = "E_PENDING"
+    static let connectionClosed = "E_CONNECTION_CLOSED"
 }
 
 // Based on https://stackoverflow.com/a/40135192/570612

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "2.4.4",
+  "version": "2.4.5",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -43,11 +43,14 @@
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-prettier": "^5.4.1",
     "expo-module-scripts": "^4.1.7",
-    "expo-modules-core": "~2.4.0"
+    "expo-modules-core": "^2.4.0"
   },
   "peerDependencies": {
     "expo": "*",
     "react": "*",
     "react-native": "*"
+  },
+  "expo": {
+    "plugin": "./app.plugin.js"
   }
 }

package/src/ExpoIap.types.ts

@@ -12,6 +12,7 @@ import {
   RequestSubscriptionIosProps,
   SubscriptionProductIos,
 } from './types/ExpoIapIos.types';
+import {NATIVE_ERROR_CODES} from './ExpoIapModule';
 
 export type ChangeEventPayload = {
   value: string;
@@ -81,6 +82,10 @@ export type PurchaseResult = {
   purchaseTokenAndroid?: string;
 };
 
+/**
+ * Centralized error codes for expo-iap
+ * These are mapped to platform-specific error codes and provide consistent error handling
+ */
 export enum ErrorCode {
   E_UNKNOWN = 'E_UNKNOWN',
   E_USER_CANCELLED = 'E_USER_CANCELLED',
@@ -99,8 +104,76 @@ export enum ErrorCode {
   E_DEFERRED_PAYMENT = 'E_DEFERRED_PAYMENT',
   E_INTERRUPTED = 'E_INTERRUPTED',
   E_IAP_NOT_AVAILABLE = 'E_IAP_NOT_AVAILABLE',
+  E_PURCHASE_ERROR = 'E_PURCHASE_ERROR',
+  E_SYNC_ERROR = 'E_SYNC_ERROR',
+  E_TRANSACTION_VALIDATION_FAILED = 'E_TRANSACTION_VALIDATION_FAILED',
+  E_ACTIVITY_UNAVAILABLE = 'E_ACTIVITY_UNAVAILABLE',
+  E_ALREADY_PREPARED = 'E_ALREADY_PREPARED',
+  E_PENDING = 'E_PENDING',
+  E_CONNECTION_CLOSED = 'E_CONNECTION_CLOSED',
 }
 
+/**
+ * Platform-specific error code mappings
+ * Maps ErrorCode enum values to platform-specific integer codes
+ */
+export const ErrorCodeMapping = {
+  ios: {
+    [ErrorCode.E_UNKNOWN]: 0,
+    [ErrorCode.E_SERVICE_ERROR]: 1,
+    [ErrorCode.E_USER_CANCELLED]: 2,
+    [ErrorCode.E_USER_ERROR]: 3,
+    [ErrorCode.E_ITEM_UNAVAILABLE]: 4,
+    [ErrorCode.E_REMOTE_ERROR]: 5,
+    [ErrorCode.E_NETWORK_ERROR]: 6,
+    [ErrorCode.E_RECEIPT_FAILED]: 7,
+    [ErrorCode.E_RECEIPT_FINISHED_FAILED]: 8,
+    [ErrorCode.E_DEVELOPER_ERROR]: 9,
+    [ErrorCode.E_PURCHASE_ERROR]: 10,
+    [ErrorCode.E_SYNC_ERROR]: 11,
+    [ErrorCode.E_DEFERRED_PAYMENT]: 12,
+    [ErrorCode.E_TRANSACTION_VALIDATION_FAILED]: 13,
+    [ErrorCode.E_NOT_PREPARED]: 14,
+    [ErrorCode.E_NOT_ENDED]: 15,
+    [ErrorCode.E_ALREADY_OWNED]: 16,
+    [ErrorCode.E_BILLING_RESPONSE_JSON_PARSE_ERROR]: 17,
+    [ErrorCode.E_INTERRUPTED]: 18,
+    [ErrorCode.E_IAP_NOT_AVAILABLE]: 19,
+    [ErrorCode.E_ACTIVITY_UNAVAILABLE]: 20,
+    [ErrorCode.E_ALREADY_PREPARED]: 21,
+    [ErrorCode.E_PENDING]: 22,
+    [ErrorCode.E_CONNECTION_CLOSED]: 23,
+  },
+  android: {
+    [ErrorCode.E_UNKNOWN]: 'E_UNKNOWN',
+    [ErrorCode.E_USER_CANCELLED]: 'E_USER_CANCELLED',
+    [ErrorCode.E_USER_ERROR]: 'E_USER_ERROR',
+    [ErrorCode.E_ITEM_UNAVAILABLE]: 'E_ITEM_UNAVAILABLE',
+    [ErrorCode.E_REMOTE_ERROR]: 'E_REMOTE_ERROR',
+    [ErrorCode.E_NETWORK_ERROR]: 'E_NETWORK_ERROR',
+    [ErrorCode.E_SERVICE_ERROR]: 'E_SERVICE_ERROR',
+    [ErrorCode.E_RECEIPT_FAILED]: 'E_RECEIPT_FAILED',
+    [ErrorCode.E_RECEIPT_FINISHED_FAILED]: 'E_RECEIPT_FINISHED_FAILED',
+    [ErrorCode.E_NOT_PREPARED]: 'E_NOT_PREPARED',
+    [ErrorCode.E_NOT_ENDED]: 'E_NOT_ENDED',
+    [ErrorCode.E_ALREADY_OWNED]: 'E_ALREADY_OWNED',
+    [ErrorCode.E_DEVELOPER_ERROR]: 'E_DEVELOPER_ERROR',
+    [ErrorCode.E_BILLING_RESPONSE_JSON_PARSE_ERROR]:
+      'E_BILLING_RESPONSE_JSON_PARSE_ERROR',
+    [ErrorCode.E_DEFERRED_PAYMENT]: 'E_DEFERRED_PAYMENT',
+    [ErrorCode.E_INTERRUPTED]: 'E_INTERRUPTED',
+    [ErrorCode.E_IAP_NOT_AVAILABLE]: 'E_IAP_NOT_AVAILABLE',
+    [ErrorCode.E_PURCHASE_ERROR]: 'E_PURCHASE_ERROR',
+    [ErrorCode.E_SYNC_ERROR]: 'E_SYNC_ERROR',
+    [ErrorCode.E_TRANSACTION_VALIDATION_FAILED]:
+      'E_TRANSACTION_VALIDATION_FAILED',
+    [ErrorCode.E_ACTIVITY_UNAVAILABLE]: 'E_ACTIVITY_UNAVAILABLE',
+    [ErrorCode.E_ALREADY_PREPARED]: 'E_ALREADY_PREPARED',
+    [ErrorCode.E_PENDING]: 'E_PENDING',
+    [ErrorCode.E_CONNECTION_CLOSED]: 'E_CONNECTION_CLOSED',
+  },
+} as const;
+
 export class PurchaseError implements Error {
   constructor(
     public name: string,
@@ -109,6 +182,7 @@ export class PurchaseError implements Error {
     public debugMessage?: string,
     public code?: ErrorCode,
     public productId?: string,
+    public platform?: 'ios' | 'android',
   ) {
     this.name = '[expo-iap]: PurchaseError';
     this.message = message;
@@ -116,5 +190,104 @@ export class PurchaseError implements Error {
     this.debugMessage = debugMessage;
     this.code = code;
     this.productId = productId;
+    this.platform = platform;
+  }
+
+  /**
+   * Creates a PurchaseError from platform-specific error data
+   * @param errorData Raw error data from native modules
+   * @param platform Platform where the error occurred
+   * @returns Properly typed PurchaseError instance
+   */
+  static fromPlatformError(
+    errorData: any,
+    platform: 'ios' | 'android',
+  ): PurchaseError {
+    const errorCode = errorData.code
+      ? ErrorCodeUtils.fromPlatformCode(errorData.code, platform)
+      : ErrorCode.E_UNKNOWN;
+
+    return new PurchaseError(
+      '[expo-iap]: PurchaseError',
+      errorData.message || 'Unknown error occurred',
+      errorData.responseCode,
+      errorData.debugMessage,
+      errorCode,
+      errorData.productId,
+      platform,
+    );
+  }
+
+  /**
+   * Gets the platform-specific error code for this error
+   * @returns Platform-specific error code
+   */
+  getPlatformCode(): string | number | undefined {
+    if (!this.code || !this.platform) return undefined;
+    return ErrorCodeUtils.toPlatformCode(this.code, this.platform);
   }
 }
+
+/**
+ * Utility functions for error code mapping and validation
+ */
+export const ErrorCodeUtils = {
+  /**
+   * Gets the native error code for the current platform
+   * @param errorCode ErrorCode enum value
+   * @returns Platform-specific error code from native constants
+   */
+  getNativeErrorCode: (errorCode: ErrorCode): string => {
+    return NATIVE_ERROR_CODES[errorCode] || errorCode;
+  },
+
+  /**
+   * Maps a platform-specific error code back to the standardized ErrorCode enum
+   * @param platformCode Platform-specific error code (string for Android, number for iOS)
+   * @param platform Target platform
+   * @returns Corresponding ErrorCode enum value or E_UNKNOWN if not found
+   */
+  fromPlatformCode: (
+    platformCode: string | number,
+    platform: 'ios' | 'android',
+  ): ErrorCode => {
+    const mapping = ErrorCodeMapping[platform];
+
+    for (const [errorCode, mappedCode] of Object.entries(mapping)) {
+      if (mappedCode === platformCode) {
+        return errorCode as ErrorCode;
+      }
+    }
+
+    return ErrorCode.E_UNKNOWN;
+  },
+
+  /**
+   * Maps an ErrorCode enum to platform-specific code
+   * @param errorCode ErrorCode enum value
+   * @param platform Target platform
+   * @returns Platform-specific error code
+   */
+  toPlatformCode: (
+    errorCode: ErrorCode,
+    platform: 'ios' | 'android',
+  ): string | number => {
+    return (
+      ErrorCodeMapping[platform][errorCode] ??
+      (platform === 'ios' ? 0 : 'E_UNKNOWN')
+    );
+  },
+
+  /**
+   * Checks if an error code is valid for the specified platform
+   * @param errorCode ErrorCode enum value
+   * @param platform Target platform
+   * @returns True if the error code is supported on the platform
+   */
+  isValidForPlatform: (
+    errorCode: ErrorCode,
+    platform: 'ios' | 'android',
+  ): boolean => {
+    return errorCode in ErrorCodeMapping[platform];
+  },
+};

package/src/ExpoIapModule.ts

@@ -2,4 +2,9 @@ import {requireNativeModule} from 'expo-modules-core';
 
 // It loads the native module object from the JSI or falls back to
 // the bridge module (from NativeModulesProxy) if the remote debugger is on.
-export default requireNativeModule('ExpoIap');
+const ExpoIapModule = requireNativeModule('ExpoIap');
+
+// Platform-specific error codes from native modules
+export const NATIVE_ERROR_CODES = ExpoIapModule.ERROR_CODES || {};
+
+export default ExpoIapModule;

package/src/index.ts

@@ -380,3 +380,4 @@ export const finishTransaction = ({
 };
 
 export * from './useIap';
+export * from './utils/errorMapping';

package/src/useIap.ts

@@ -23,8 +23,8 @@ import {
   SubscriptionProduct,
   SubscriptionPurchase,
 } from './ExpoIap.types';
-import {EventSubscription} from 'expo-modules-core';
 import {Platform} from 'react-native';
+import {EventSubscription} from 'expo-modules-core';
 
 type UseIap = {
   connected: boolean;