expo-iap 2.4.5-rc.1 → 2.5.0

package/README.md

@@ -1,8 +1,12 @@
-<img src="https://github.com/user-attachments/assets/f51a4b1b-b257-47bf-afe7-5ef8692f0594" />
+# Expo IAP
 
-[![Version](http://img.shields.io/npm/v/expo-iap.svg?style=flat-square)](https://npmjs.org/package/expo-iap) [![Download](http://img.shields.io/npm/dm/expo-iap.svg?style=flat-square)](https://npmjs.org/package/expo-iap) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fhyochan%2Fexpo-iap.svg?type=shield&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fhyochan%2Fexpo-iap?ref=badge_shield&issueType=license)
+| In app purchase module in [Expo](https://expo.dev)
+
+<div>
+  <img src="https://private-user-images.githubusercontent.com/27461460/460432423-3257a1e0-800b-441b-8522-94c35ce751d2.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NTEyNjQ4NjEsIm5iZiI6MTc1MTI2NDU2MSwicGF0aCI6Ii8yNzQ2MTQ2MC80NjA0MzI0MjMtMzI1N2ExZTAtODAwYi00NDFiLTg1MjItOTRjMzVjZTc1MWQyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTA2MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUwNjMwVDA2MjI0MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWVlMjFkNmViZmM5NzZmNzZlMmE2OWZjODU4NjczMTM2N2ZkYWVhY2MzMjc5YmIyMDlhNjRkNmEzNWNhMmI3MjUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.BdhwkYigGHbjYLJblwUnHYNkX1-jDAWry0MqeLpfKrA" width="400" />
+</div>
 
-In App Purchase module in Expo
+[![Version](http://img.shields.io/npm/v/expo-iap.svg?style=flat-square)](https://npmjs.org/package/expo-iap) [![Download](http://img.shields.io/npm/dm/expo-iap.svg?style=flat-square)](https://npmjs.org/package/expo-iap) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fhyochan%2Fexpo-iap.svg?type=shield&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fhyochan%2Fexpo-iap?ref=badge_shield&issueType=license)
 
 # Notice
 
@@ -13,54 +17,13 @@ The `expo-iap` module has been migrated from [react-native-iap](https://github.c
 - [Documentation](./docs/IAP.md)
 - [Error Code Management](./docs/ERROR_CODES.md)
 
-## Error Handling
-
-expo-iap now provides a centralized error code system that works consistently across iOS and Android platforms. This system maps platform-specific error codes to standardized TypeScript enums.
-
-### Error Codes
+## Installation
 
-```typescript
-import { ErrorCode } from 'expo-iap';
-
-// Standardized error codes
-ErrorCode.E_USER_CANCELLED      // User cancelled the purchase
-ErrorCode.E_NETWORK_ERROR       // Network connectivity issue
-ErrorCode.E_ITEM_UNAVAILABLE    // Product not available
-ErrorCode.E_SERVICE_ERROR       // Store service error
-// ... and more
-```
-
-### Error Utilities
-
-```typescript
-import { 
-  mapPlatformError, 
-  isUserCancelledError, 
-  getUserFriendlyErrorMessage 
-} from 'expo-iap';
-
-// Handle purchase errors
-try {
-  await requestPurchase({ sku: 'product_id' });
-} catch (error) {
-  if (isUserCancelledError(error)) {
-    // User cancelled - don't show error
-    return;
-  }
-  
-  // Show user-friendly message
-  const message = getUserFriendlyErrorMessage(error);
-  Alert.alert('Purchase Failed', message);
-}
+```bash
+npx expo install expo-iap
 ```
 
-### Platform-Specific Error Mapping
-
-The system automatically maps platform codes:
-- **iOS**: Integer codes (0, 1, 2, etc.) → ErrorCode enum
-- **Android**: String codes ("E_USER_CANCELLED", etc.) → ErrorCode enum
-
-This ensures consistent error handling regardless of platform.
+For detailed usage examples and error handling, see the [documentation](./docs/IAP.md).
 
 > Sharing your thoughts—any feedback would be greatly appreciated!
 

package/docs/ERROR_CODES.md

@@ -7,6 +7,7 @@ expo-iap now provides a centralized error code management system that ensures co
 ## Problem Solved
 
 Previously, users experienced inconsistent error codes:
+
 - iOS returned numeric error codes (e.g., "2" for user cancellation)
 - Android returned string error codes (e.g., "E_USER_CANCELLED" for user cancellation)
 - The TypeScript enum didn't align with platform-specific implementations
@@ -54,7 +55,7 @@ export const ErrorCodeMapping = {
 ### Basic Error Handling
 
 ```typescript
-import { ErrorCode, PurchaseError } from 'expo-iap';
+import {ErrorCode, PurchaseError} from 'expo-iap';
 
 // Handle purchase errors consistently
 const handleError = (error: PurchaseError) => {
@@ -74,7 +75,7 @@ const handleError = (error: PurchaseError) => {
 ### Creating Errors from Platform Data
 
 ```typescript
-import { PurchaseError } from 'expo-iap';
+import {PurchaseError} from 'expo-iap';
 
 // Create properly typed errors from platform-specific data
 const error = PurchaseError.fromPlatformError(rawErrorData, 'ios');
@@ -83,18 +84,24 @@ const error = PurchaseError.fromPlatformError(rawErrorData, 'ios');
 ### Error Code Utilities
 
 ```typescript
-import { ErrorCodeUtils, ErrorCode } from 'expo-iap';
+import {ErrorCodeUtils, ErrorCode} from 'expo-iap';
 
 // Convert platform-specific codes to standard enum
-const errorCode = ErrorCodeUtils.fromPlatformCode(2, 'ios'); 
+const errorCode = ErrorCodeUtils.fromPlatformCode(2, 'ios');
 // Returns ErrorCode.E_USER_CANCELLED
 
-// Convert standard enum to platform-specific code  
-const iosCode = ErrorCodeUtils.toPlatformCode(ErrorCode.E_USER_CANCELLED, 'ios');
+// Convert standard enum to platform-specific code
+const iosCode = ErrorCodeUtils.toPlatformCode(
+  ErrorCode.E_USER_CANCELLED,
+  'ios',
+);
 // Returns 2
 
 // Check platform support
-const isSupported = ErrorCodeUtils.isValidForPlatform(ErrorCode.E_USER_CANCELLED, 'ios');
+const isSupported = ErrorCodeUtils.isValidForPlatform(
+  ErrorCode.E_USER_CANCELLED,
+  'ios',
+);
 // Returns true
 ```
 
@@ -108,7 +115,7 @@ if (error.code === '2') {
   // Handle user cancellation
 }
 
-// Android would return string codes  
+// Android would return string codes
 if (error.code === 'E_USER_CANCELLED') {
   // Handle user cancellation
 }
@@ -117,7 +124,7 @@ if (error.code === 'E_USER_CANCELLED') {
 ### After (Consistent)
 
 ```typescript
-import { ErrorCode } from 'expo-iap';
+import {ErrorCode} from 'expo-iap';
 
 // Works consistently across platforms
 if (error.code === ErrorCode.E_USER_CANCELLED) {
@@ -157,6 +164,7 @@ if (error.code === ErrorCode.E_USER_CANCELLED) {
 ## Breaking Changes
 
 This is a **non-breaking change** for most users:
+
 - Existing error handling will continue to work
 - New error code system provides additional functionality
 - Users can migrate gradually to the new system

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "2.4.5-rc.1",
+  "version": "2.5.0",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -49,5 +49,8 @@
     "expo": "*",
     "react": "*",
     "react-native": "*"
+  },
+  "expo": {
+    "plugin": "./app.plugin.js"
   }
 }

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/withiap.ts"],"version":"5.8.3"}
+{"root":["./src/withIAP.ts"],"version":"5.8.3"}

package/docs/README.md

@@ -1,30 +0,0 @@
-# Documentation
-
-This directory contains detailed documentation for expo-iap.
-
-## Available Documents
-
-- **[API Documentation](./IAP.md)** - Complete API reference and usage examples
-- **[Error Code Management](./ERROR_CODES.md)** - Centralized error handling system documentation
-
-## Quick Links
-
-- [Main README](../README.md) - Project overview and quick start
-- [Example App](../example/) - Sample implementation
-- [GitHub Issues](https://github.com/hyochan/expo-iap/issues) - Bug reports and feature requests
-
-## Contributing
-
-If you find any documentation errors or have suggestions for improvements, please:
-
-1. Check existing [issues](https://github.com/hyochan/expo-iap/issues)
-2. Create a new issue with the `documentation` label
-3. Submit a pull request with your improvements
-
-## Support
-
-For questions and support:
-
-- 📚 Read the documentation in this folder
-- 🐛 Report bugs via [GitHub Issues](https://github.com/hyochan/expo-iap/issues)
-- 💬 Join discussions in [GitHub Discussions](https://github.com/hyochan/expo-iap/discussions)