expo-iap 2.7.10 → 2.7.12

package/CHANGELOG.md

@@ -1,138 +1,3 @@
-# Changelog
+# CHANGELOG
 
-## [2.7.9]
-
-### Fixed
-
-- Fixed `acknowledgePurchaseAndroid` argument mismatch error by removing unused `developerPayload` parameter
-
-## [2.7.8]
-
-### Added
-
-- Exported `validateReceipt` function from main API with security warnings
-- Documentation about iOS unfinished transactions behavior
-- Documentation about Android 3-day acknowledgment requirement
-
-### Fixed
-
-- Documentation incorrectly stating Android auto-validates receipts
-- Added explicit `isConsumable: false` default value in `finishTransaction`
-- Markdownlint warnings (MD032, MD033, MD024)
-
-### Changed
-
-- Moved `validateReceipt` from hook-only to main exports
-- Enhanced security warnings for client-side receipt validation
-- Updated troubleshooting guide with `onPurchaseSuccess` auto-trigger issue
-
-### Documentation
-
-- Added comprehensive guide for handling unfinished transactions
-- Clarified platform-specific transaction acknowledgment behavior
-- Emphasized server-side validation requirement for both iOS and Android
-
-## [2.7.7]
-
-### Fixed
-
-- iOS: Fixed hot reload issues with concurrent StoreKit operations
-- iOS: Resolved race conditions in `Promise.all` usage
-- iOS: Improved state cleanup on `initConnection()`
-- Fixed `useIAP` hook's internal methods to use `requestProducts` instead of deprecated `getSubscriptions`
-
-### Changed
-
-- iOS: Added `ensureConnection()` pattern matching Android
-- iOS: Simplified module architecture
-
-## [2.7.6] - 2025-08-01
-
-### Fixed
-
-- Fixed `initConnection()` return type
-
-### Documentation
-
-- Added available-purchases example
-- Improved build error FAQs
-- Enhanced setup documentation
-
-## [2.7.5] - 2025-07-24
-
-### Added
-
-- iOS promoted product support
-- `promotedProductListenerIOS()`, `getPromotedProductIOS()`, `buyPromotedProductIOS()` methods
-- Promoted product support in useIAP hook
-
-### Changed
-
-- Promoted product listener now returns full Product object
-- Updated documentation and examples
-
-### Fixed
-
-- iOS build error in promoted product handler
-- Type safety improvements
-
-## [2.7.4] - 2025-07-24
-
-### Fixed
-
-- iOS 18.4+ availability check for `appTransactionID`
-- TypeScript compatibility for older iOS versions
-
-## [2.7.3] - 2025-07-23
-
-### Fixed
-
-- Android Google Play Billing Library v8.0.0 upgrade
-- Kotlin version compatibility
-
-### Changed
-
-- Android requires Kotlin 2.0+
-- Added expo-build-properties requirement
-
-### Documentation
-
-- Android configuration guide
-- Kotlin version requirements
-
-## [2.7.2] - 2025-07-22
-
-### Added
-
-- iOS 16.0+ app transaction support
-
-## [2.7.1] - 2025-07-22
-
-### Fixed
-
-- Added missing `requestProducts()` API
-- Fixed `getStorefrontIOS()` platform handling
-- Documentation build fixes
-
-### Changed
-
-- Added deprecation warnings to `getProducts()` and `getSubscriptions()`
-
-## [2.7.0] - 2025-07-22
-
-### Added
-
-- Platform-specific API for `requestPurchase`
-- Google Play Billing Library v8.0.0 support
-- Android automatic reconnection
-- Detailed error codes
-
-### Changed
-
-- Deprecated `requestSubscription`
-- Removed Android `getPurchaseHistory()`
-
-### Breaking Changes
-
-- Android: `getPurchaseHistory()` removed
-- Android: Requires Google Play Billing v8.0.0
+Checkout [Release Notes](https://github.com/hyochan/expo-iap/releases)

package/CLAUDE.md

@@ -0,0 +1,55 @@
+# Implementation Guidelines
+
+## Expo-Specific Guidelines
+
+### Pre-Commit Checks
+
+Before committing any changes:
+
+1. Run `bun run lint` to ensure code quality
+2. Run `bun run typecheck` to verify TypeScript types
+3. Run `bun run test` to verify all tests pass (Note: Use `bun run test`, not `bun test`)
+4. **IMPORTANT**: Run tests in the example directory as well:
+   - `cd example && bun run test`
+   - Ensure all tests pass with 100% success rate
+   - Fix any failing tests before committing
+5. Only commit if all checks succeed
+
+### Platform-Specific Naming Conventions
+
+- **iOS-related code**: Use `Ios` in naming (e.g., `PurchaseIos`, `SubscriptionOfferIos`)
+- **Android-related code**: Use `Android` in naming (e.g., `PurchaseAndroid`, `SubscriptionOfferAndroid`)
+- **IAP-related code**: Use `Iap` in naming (e.g., `IapPurchase`, not `IAPPurchase`)
+- This applies to both functions, types, and file names
+
+### React/JSX Conventions
+
+- **Conditional Rendering**: Use ternary operator with null instead of logical AND
+  - ✅ Good: `{condition ? <Component /> : null}`
+  - ❌ Avoid: `{condition && <Component />}`
+
+### API Method Naming
+
+- Functions that depend on event results should use `request` prefix (e.g., `requestPurchase`, `requestSubscription`)
+- Follow OpenIAP terminology: <https://www.openiap.dev/docs/apis#terminology>
+- Do not use generic prefixes like `get`, `find` - refer to the official terminology
+
+## IAP-Specific Guidelines
+
+### OpenIAP Specification
+
+All implementations must follow the OpenIAP specification:
+
+- **APIs**: <https://www.openiap.dev/docs/apis>
+- **Types**: <https://www.openiap.dev/docs/types>
+- **Events**: <https://www.openiap.dev/docs/events>
+- **Errors**: <https://www.openiap.dev/docs/errors>
+
+### Feature Development Process
+
+For new feature proposals:
+
+1. Before implementing, discuss at: <https://github.com/hyochan/openiap.dev/discussions>
+2. Get community feedback and consensus
+3. Ensure alignment with OpenIAP standards
+4. Implement following the agreed specification

package/CONTRIBUTING.md

@@ -4,13 +4,16 @@ Thank you for your interest in contributing to expo-iap! This guide will help yo
 
 ## 📋 Table of Contents
 
-- [Development Setup](#development-setup)
-- [Package Manager](#package-manager)
-- [Running the Example App](#running-the-example-app)
-- [Development Guidelines](#development-guidelines)
-- [Testing](#testing)
-- [Code Style](#code-style)
-- [Submitting Changes](#submitting-changes)
+- [Development Setup](#-development-setup)
+- [Package Manager](#-package-manager)
+- [Running the Example App](#-running-the-example-app)
+- [Development Guidelines](#-development-guidelines)
+- [Testing](#-testing)
+- [Code Style](#-code-style)
+- [Submitting Changes](#-submitting-changes)
+- [Reporting Issues](#-reporting-issues)
+- [Feature Requests](#-feature-requests)
+- [Additional Resources](#-additional-resources)
 
 ## 🚀 Development Setup
 
@@ -31,7 +34,7 @@ git clone https://github.com/hyochan/expo-iap.git
 cd expo-iap
 ```
 
-2. Install dependencies using Bun:
+1. Install dependencies using Bun:
 
 ```bash
 bun install
@@ -43,14 +46,15 @@ This project includes VSCode configurations for easier development:
 
 1. **Install recommended extensions**: When you open the project in VSCode, you'll be prompted to install recommended extensions. Accept to install them.
 
-2. **Use Debug Configurations**: Press `F5` or go to Run → Start Debugging and select:
+1. **Use Debug Configurations**: Press `F5` or go to Run → Start Debugging and select:
 
    - `Debug iOS (Expo)` - Runs the example app on iOS simulator
    - `Debug Android (Expo)` - Runs the example app on Android emulator
    - `iOS + Metro` - Starts Metro bundler and iOS app together
    - `Android + Metro` - Starts Metro bundler and Android app together
 
-3. **Use Tasks**: Press `Cmd+Shift+P` → `Tasks: Run Task` to access:
+1. **Use Tasks**: Press `Cmd+Shift+P` → `Tasks: Run Task` to access:
+
    - `Start iOS Simulator` - Opens iOS Simulator
    - `Start Android Emulator` - Starts Android emulator
    - `Install Pods (iOS)` - Installs CocoaPods dependencies
@@ -73,9 +77,9 @@ This project includes VSCode configurations for easier development:
 
 ## 🧪 Running the Example App
 
-The example app is a great way to test your changes and see the library in action.
+The example app demonstrates all library features and is essential for testing your changes during development.
 
-### Setup
+### Initial Setup
 
 1. Navigate to the example directory:
 
@@ -83,60 +87,89 @@ The example app is a great way to test your changes and see the library in actio
 cd example
 ```
 
-2. Install example app dependencies:
+1. Install example app dependencies:
 
 ```bash
 bun install
 ```
 
-3. For iOS development, install pods:
+1. **iOS Setup** (macOS only):
 
 ```bash
+# Install CocoaPods dependencies
 cd ios
 pod install
 cd ..
 ```
 
-### Running the App
+1. **Android Setup**:
+
+```bash
+# Ensure Android SDK is configured
+# Set ANDROID_HOME environment variable if not already set
+export ANDROID_HOME=$HOME/Library/Android/sdk
+export PATH=$PATH:$ANDROID_HOME/emulator
+export PATH=$PATH:$ANDROID_HOME/platform-tools
+```
+
+### Running on iOS
 
-#### iOS
+#### Using Expo CLI (Recommended)
 
 ```bash
 bun run ios
+# Or specify a device
+bun run ios --device "iPhone 15 Pro"
 ```
 
-Or open the project in Xcode:
+#### Using Xcode
 
 ```bash
-open ios/cpk.xcworkspace
+# Open the workspace in Xcode
+open ios/expoiapexample.xcworkspace
 ```
 
-**Note**: If you encounter build errors, you may need to:
+Then select a simulator or device and press Run (⌘R).
+
+#### Troubleshooting iOS
 
-1. Clean the build: `cd ios && xcodebuild clean`
-2. Update pods: `cd ios && pod install`
-3. Open in Xcode and build from there for better error messages
+- **Build errors**: Clean build folder in Xcode (Shift+⌘K)
+- **Pod issues**: `cd ios && pod deintegrate && pod install`
+- **Metro issues**: `bun start --reset-cache`
 
-#### Android
+### Running on Android
+
+#### Using Expo CLI (Recommended)
 
 ```bash
 bun run android
+# Or specify a device
+bun run android --device "Pixel_7_API_34"
 ```
 
-Or open the project in Android Studio:
+#### Using Android Studio
 
 ```bash
+# Open the project in Android Studio
 open -a "Android Studio" android
 ```
 
-**Note**: First run may take longer as it downloads Gradle dependencies.
+Then select an emulator or device and press Run.
+
+#### Troubleshooting Android
+
+- **Gradle issues**: `cd android && ./gradlew clean`
+- **Emulator not starting**: Start it manually from Android Studio
+- **Connection issues**: `adb reverse tcp:8081 tcp:8081`
 
 ### Development Server
 
-Start the Metro bundler:
+The Metro bundler is automatically started when running the app. To start it manually:
 
 ```bash
 bun start
+# Or with cache reset
+bun start --reset-cache
 ```
 
 ### Available Scripts
@@ -171,44 +204,57 @@ bun run reset-project
 
 ## 📖 Development Guidelines
 
-### Platform-Specific Naming Conventions
+### Code Conventions and Standards
 
-Functions that only work on one platform MUST have platform suffixes:
+For detailed code conventions, naming standards, and implementation guidelines, please refer to [CLAUDE.md](./CLAUDE.md). This includes:
 
-- iOS-only functions: append `Ios` suffix
-- Android-only functions: append `Android` suffix
-- Cross-platform functions: no suffix needed
+- Platform-specific naming conventions
+- API method naming patterns
+- Pre-commit checks
+- OpenIAP specification compliance
 
-#### Examples:
+### Development Workflow
 
-```typescript
-// ✅ Good - Platform-specific functions with suffixes
-export const validateReceiptIos = async (sku: string) => { ... }
-export const validateReceiptAndroid = async (options: AndroidValidationOptions) => { ... }
-export const getStorefrontIos = async (): Promise<string> => { ... }
-export const getAppTransactionIos = async (): Promise<AppTransactionIOS | null> => { ... }
-
-// ✅ Good - Cross-platform function without suffix
-export const requestProducts = async (params: { skus: string[], type?: 'inapp' | 'subs' }) => {
-  return Platform.select({
-    ios: async () => { /* iOS implementation */ },
-    android: async () => { /* Android implementation */ },
-  })();
-}
-
-// ❌ Bad - Platform-specific function without suffix
-export const getStorefront = async () => { ... } // Only works on iOS, should be getStorefrontIos
-```
+1. **Before starting work**:
+
+   - Pull latest changes from main branch
+   - Create a feature branch: `git checkout -b feature/your-feature`
+   - Review [CLAUDE.md](./CLAUDE.md) for coding standards
 
-### Type Naming Conventions
+1. **During development**:
 
-- Platform-specific types: `ProductIos`, `ProductAndroid`, `PurchaseErrorIos`
-- Cross-platform types: `Product`, `Purchase`, `PurchaseError`
+   - Make changes to the library source code in `src/`
+   - Test changes in the example app
+   - Write/update tests as needed
+   - Keep commits atomic and well-described
+
+1. **Before committing**:
+
+   - Follow the pre-commit checks outlined in [CLAUDE.md](./CLAUDE.md)
+   - Ensure all checks pass
+
+1. **Testing your changes**:
+
+   - The example app automatically uses the local library code
+   - Changes to `src/` will be reflected after reloading the app
+   - Test on both iOS and Android platforms when possible
+
+### Code Conventions
+
+For all code conventions including:
+
+- Platform-specific naming conventions
+- Type naming conventions
+- API method naming patterns
+- OpenIAP specification compliance
+
+Please refer to [CLAUDE.md](./CLAUDE.md).
 
 ### AI Development Tools
 
 We provide configuration files for AI-powered development tools:
 
+- `CLAUDE.md` - Comprehensive guidelines for Claude and other AI assistants
 - `.cursorrules` - Rules for Cursor IDE
 - `.copilot-instructions.md` - Instructions for GitHub Copilot
 
@@ -241,12 +287,12 @@ bun run test:coverage
 Example test structure:
 
 ```typescript
-import { render, fireEvent } from '@testing-library/react-native';
+import {render, fireEvent} from '@testing-library/react-native';
 import MyComponent from '../MyComponent';
 
 describe('MyComponent', () => {
   it('should render correctly', () => {
-    const { getByText } = render(<MyComponent />);
+    const {getByText} = render(<MyComponent />);
     expect(getByText('Expected Text')).toBeTruthy();
   });
 });
@@ -296,7 +342,7 @@ bun run lint:prettier
 
 Follow conventional commit format:
 
-```
+```text
 type(scope): subject
 
 body
@@ -306,17 +352,17 @@ footer
 
 Types:
 
-- `feat`: New feature
-- `fix`: Bug fix
-- `docs`: Documentation changes
-- `style`: Code style changes (formatting, etc.)
-- `refactor`: Code refactoring
-- `test`: Test additions or modifications
-- `chore`: Maintenance tasks
+- `feat`: new feature
+- `fix`: bug fix
+- `docs`: documentation changes
+- `style`: code style changes (formatting, etc.)
+- `refactor`: code refactoring
+- `test`: test additions or modifications
+- `chore`: maintenance tasks
 
 Example:
 
-```
+```text
 feat(ios): add getStorefrontIos function
 
 Implements iOS-specific storefront retrieval using StoreKit.
@@ -328,13 +374,14 @@ Closes #123
 ### Pull Request Process
 
 1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/your-feature`
-3. Make your changes following the guidelines above
-4. Run tests and ensure they pass: `cd example && bun test`
-5. Run linting: `bun run lint:ci`
-6. Commit your changes with a descriptive message
-7. Push to your fork
-8. Create a Pull Request with:
+1. Create a feature branch: `git checkout -b feature/your-feature`
+1. Make your changes following the guidelines above
+1. Run tests and ensure they pass: `cd example && bun test`
+1. Run linting: `bun run lint:ci`
+1. Commit your changes with a descriptive message
+1. Push to your fork
+1. Create a Pull Request with:
+
    - Clear description of changes
    - Any breaking changes noted
    - Tests for new functionality
@@ -373,6 +420,5 @@ We welcome feature requests! Please:
 - [Documentation Site](https://expo-iap.hyo.dev)
 - [API Reference](https://expo-iap.hyo.dev/docs/api/use-iap)
 - [Example App](./example)
-- [Platform-Specific Guidelines](./docs/PLATFORM_NAMING.md)
 
 Thank you for contributing to expo-iap! 🎉

package/README.md

@@ -2,23 +2,18 @@
 
 <div align="center">
   <img src="https://expo-iap.hyo.dev/img/icon.png" alt="Expo IAP Logo" width="150" />
-  <h1>Expo IAP</h1>
-  <p>In app purchase module in <a href="https://docs.expo.dev/guides/in-app-purchases">Expo</a></p>
+  
+  [![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://docs.expo.dev/guides/in-app-purchases) that conforms to the [Open IAP specification](https://openiap.dev)
+  
+  <a href="https://openiap.dev"><img src="https://openiap.dev/logo.png" alt="Open IAP" height="40" /></a>
 </div>
 
-[![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)
-
 ## 📚 Documentation
 
 **[📖 Visit our comprehensive documentation site →](https://expo-iap.hyo.dev)**
 
-- [🚀 Quick Start Guide](https://expo-iap.hyo.dev/docs/intro)
-- [💽 Installation](https://expo-iap.hyo.dev/docs/installation)
-- [🍎 iOS Setup](https://expo-iap.hyo.dev/docs/getting-started/setup-ios)
-- [🤖 Android Setup](https://expo-iap.hyo.dev/docs/getting-started/setup-android)
-- [🎣 useIAP Hook API](https://expo-iap.hyo.dev/docs/api/use-iap)
-- [⚠️ Error Codes](https://expo-iap.hyo.dev/docs/api/error-codes)
-
 ## Notice
 
 The `expo-iap` module has been migrated from [react-native-iap](https://github.com/dooboolab/react-native-iap). Moving forward, the `react-native-iap` repository will gradually be deprecated, and `expo-iap` will become the actively maintained module. Please take note of this transition. For more details, refer to the [Future Roadmap and Discussion in react-native-iap](https://github.com/dooboolab-community/react-native-iap/discussions/2754). Additionally, you can check the [Current Project Status comment](https://github.com/dooboolab-community/react-native-iap/discussions/2754#discussioncomment-10510249) to stay updated on the project's progress.
@@ -66,12 +61,20 @@ For detailed usage examples and error handling, see the [documentation](https://
 
 ## Sponsors
 
-### <p style="color: gold;">Gold Tier</p>
+💼 **[View Our Sponsors](https://openiap.dev/sponsors)**
+
+### <p style="color: rgb(255, 182, 193);">Angel</p>
+
+<a href="https://meta.com">
+    <img width="600" alt="courier_dot_com" src="https://static.xx.fbcdn.net/rsrc.php/y3/r/y6QsbGgc866.svg" />
+</a>
+
+### <p style="color: rgb(205, 127, 50);">Bronze</p>
 
 <a href="https://www.courier.com/?utm_source=react-native-iap&utm_campaign=osssponsors">
-    <img width="420" alt="courier_dot_com" src="https://github.com/user-attachments/assets/319d8966-6839-498d-8ead-ce8cc72c3bca" />
+    <img width="160" alt="courier_dot_com" src="https://github.com/user-attachments/assets/319d8966-6839-498d-8ead-ce8cc72c3bca" />
 </a>
 
-## Past Sponsors
+## Past Supporters
 
-<a href="https://namiml.com"><img src="https://github.com/hyochan/react-native-iap/assets/27461460/89d71f61-bb73-400a-83bd-fe0f96eb726e" alt="Nami ML" width="280"/></a>
+<a href="https://namiml.com" style="opacity: 50%"><img src="https://github.com/hyochan/react-native-iap/assets/27461460/89d71f61-bb73-400a-83bd-fe0f96eb726e" alt="Nami ML" width="140"/></a>

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

@@ -86,9 +86,10 @@ class ExpoIapModule :
             purchases.forEach { purchase ->
                 val item =
                     mutableMapOf<String, Any?>(
-                        "id" to purchase.products.firstOrNull() as Any?,
+                        "id" to purchase.orderId,
+                        "productId" to purchase.products.firstOrNull() as Any?,
                         "ids" to purchase.products,
-                        "transactionId" to purchase.orderId,
+                        "transactionId" to purchase.orderId, // @deprecated - use id instead
                         "transactionDate" to purchase.purchaseTime.toDouble(),
                         "transactionReceipt" to purchase.originalJson,
                         "purchaseTokenAndroid" to purchase.purchaseToken,
@@ -260,10 +261,10 @@ class ExpoIapModule :
                         purchases?.forEach { purchase ->
                             val item =
                                 mutableMapOf<String, Any?>(
-                                    // kept for convenience/backward-compatibility. productIds has the complete list
-                                    "id" to purchase.products.firstOrNull() as Any?,
+                                    "id" to purchase.orderId,
+                                    "productId" to purchase.products.firstOrNull() as Any?,
                                     "ids" to purchase.products,
-                                    "transactionId" to purchase.orderId,
+                                    "transactionId" to purchase.orderId, // @deprecated - use id instead
                                     "transactionDate" to purchase.purchaseTime.toDouble(),
                                     "transactionReceipt" to purchase.originalJson,
                                     "orderId" to purchase.orderId,