expo-iap 3.1.7 → 3.1.8

package/CLAUDE.md

@@ -156,6 +156,98 @@ public struct LoadingStates {
 - Use `status.loadings.purchasing.contains(productId)` to check if a specific product is being purchased
 - Use `status.isLoading` computed property to check if any operation is in progress
 
+### Error Handling
+
+#### Error Code Format
+
+All error codes in expo-iap follow the OpenIAP specification and use **kebab-case** format:
+
+```typescript
+export enum ErrorCode {
+  UserCancelled = 'user-cancelled', // NOT 'E_USER_CANCELLED'
+  NetworkError = 'network-error',
+  ItemUnavailable = 'item-unavailable',
+  AlreadyOwned = 'already-owned',
+  // ...
+}
+```
+
+**Important**:
+
+- ✅ Use `ErrorCode.UserCancelled` enum in TypeScript code
+- ✅ Error codes are kebab-case strings: `'user-cancelled'`
+- ❌ Never use deprecated `E_` prefix: `'E_USER_CANCELLED'`
+- ❌ Never use UPPERCASE format: `'USER_CANCELLED'`
+
+#### Error Object Structure
+
+All errors returned from native modules have the following structure:
+
+```typescript
+interface PurchaseError {
+  code: ErrorCode; // Standardized error code enum
+  message: string; // Human-readable error message
+  responseCode?: number; // Platform-specific response code
+  debugMessage?: string; // Additional debug information
+  productId?: string; // Product ID if applicable
+}
+```
+
+Example error object:
+
+```json
+{
+  "code": "user-cancelled",
+  "message": "User cancelled the purchase",
+  "responseCode": 1,
+  "debugMessage": "User pressed cancel button",
+  "productId": "com.example.premium"
+}
+```
+
+#### Using Error Codes
+
+Always use the `ErrorCode` enum for type-safe error handling:
+
+```typescript
+import {useIAP, ErrorCode} from 'expo-iap';
+
+const {requestPurchase} = useIAP({
+  onPurchaseError: (error) => {
+    // ✅ Correct - use ErrorCode enum
+    if (error.code === ErrorCode.UserCancelled) {
+      console.log('User cancelled');
+      return;
+    }
+
+    // ❌ Wrong - don't use string literals
+    if (error.code === 'E_USER_CANCELLED') {
+      /* ... */
+    }
+    if (error.code === 'USER_CANCELLED') {
+      /* ... */
+    }
+
+    // ✅ Correct - use switch with enum
+    switch (error.code) {
+      case ErrorCode.NetworkError:
+        showRetryDialog();
+        break;
+      case ErrorCode.ItemUnavailable:
+        showUnavailableMessage();
+        break;
+      default:
+        console.error(error.message);
+    }
+  },
+});
+```
+
+For complete error handling documentation, see:
+
+- [Error Codes Reference](https://www.openiap.dev/docs/errors)
+- [Error Handling Guide](https://docs.expo-iap.dev/docs/guides/error-handling)
+
 ## Documentation Guidelines
 
 ### Blog Post Conventions

package/coverage/clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1759171574260" clover="3.2.0">
-  <project timestamp="1759171574260" name="All files">
+<coverage generated="1759407275851" clover="3.2.0">
+  <project timestamp="1759407275851" name="All files">
     <metrics statements="486" coveredstatements="470" conditionals="282" coveredconditionals="246" methods="91" coveredmethods="78" elements="859" coveredelements="794" complexity="0" loc="486" ncloc="486" packages="4" files="6" classes="6"/>
     <package name="src">
       <metrics statements="188" coveredstatements="186" conditionals="89" coveredconditionals="80" methods="39" coveredmethods="30"/>

package/coverage/lcov-report/index.html

@@ -146,7 +146,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/src/helpers/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/helpers/subscription.ts.html

@@ -484,7 +484,7 @@ export const hasActiveSubscriptions = async (
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/index.ts.html

@@ -1969,7 +1969,7 @@ export {<span class="fstat-no" title="function not covered" >ExpoIapConsole}</sp
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/modules/android.ts.html

@@ -565,7 +565,7 @@ export const openRedeemOfferCodeAndroid = async (): Promise<void> => {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/modules/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/modules/ios.ts.html

@@ -1141,7 +1141,7 @@ export const deepLinkToSubscriptionsIOS = (): Promise<void> =>
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/debug.ts.html

@@ -268,7 +268,7 @@ export const ExpoIapConsole = createConsole();
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/errorMapping.ts.html

@@ -1111,7 +1111,7 @@ export function getUserFriendlyErrorMessage(error: ErrorLike): string {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-29T18:46:14.242Z
+                at 2025-10-02T12:14:35.833Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/ios/ExpoIapModule.swift

@@ -13,7 +13,7 @@ public final class ExpoIapModule: Module {
     nonisolated public func definition() -> ModuleDefinition {
         Name("ExpoIap")
 
-        Constants {
+        Property("errorCodes") {
             OpenIapSerialization.errorCodes()
         }
 

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "apple": "1.2.4",
+  "apple": "1.2.6",
   "google": "1.2.10",
   "gql": "1.0.9"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/expoConfig.augmentation.d.ts","./src/withIAP.ts","./src/withLocalOpenIAP.ts"],"version":"5.9.2"}
+{"root":["./src/expoConfig.augmentation.d.ts","./src/withIAP.ts","./src/withLocalOpenIAP.ts"],"version":"5.9.3"}