Refactor Android IAP integration and examples (#197)

### Summary

- Move Android mapping to openiap-google toJSON and remove local
records/mappers
- Replace PlayUtils with PromiseUtils; centralize promise helpers
- Unify Android APIs: getAvailableItems, consumePurchaseAndroid
- Add deepLinkToSubscriptionsAndroid + getStorefrontAndroid bridge
- Update example screen: active subscription modal, storefront/deeplink
tools
- Deduplicate active subscriptions by stable key (token/id)

### Notes

Aligns platform behavior and simplifies JS bridge. Keeps deprecation
shims where helpful; removes legacy aliases where safe.

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

- New Features
- Android storefront retrieval and native deep-link to manage
subscriptions; unified available-purchases API; new
purchase-updated/purchase-error events and exported ERROR_CODES;
cross-platform getStorefront behavior.

- Bug Fixes
  - Deduplicated active subscriptions to prevent duplicate entries.

- Refactor
  - Android API rename: consumeProductAndroid → consumePurchaseAndroid.

- Plugin
- Optional local OpenIAP linking with dependency fallback, addDeps
toggle, and localPath now supports ios/android.

- Documentation
  - Updated examples and migration notes for the Android rename.

- Chores
  - Added pre-commit test hook and spell-check dictionary entry.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: hyochan

.eslintrc.js

@@ -12,7 +12,8 @@ module.exports = {
         paths: [
           {
             name: '.',
-            message: "Avoid `import from '.'`; use './index' or an explicit path.",
+            message:
+              "Avoid `import from '.'`; use './index' or an explicit path.",
           },
         ],
       },
@@ -23,8 +24,7 @@ module.exports = {
         paths: [
           {
             name: '.',
-            message:
-              "Avoid `require('.')`; use './index' or an explicit path.",
+            message: "Avoid `require('.')`; use './index' or an explicit path.",
           },
         ],
       },

.github/ISSUE_TEMPLATE/bug_report.md

@@ -32,7 +32,7 @@ assignees: ''
 **Latest Version Check**
 
 - [ ] I confirmed this issue reproduces on the latest version of expo-iap.
-  <!-- The library continuously fixes past issues; please try the latest release before filing. -->
+<!-- The library continuously fixes past issues; please try the latest release before filing. -->
 
 **To Reproduce** Steps to reproduce the behavior:
 

.husky/pre-commit

@@ -0,0 +1,16 @@
+#!/usr/bin/env sh
+. "$(dirname "$0")/_/husky.sh"
+
+# Lint TypeScript/JS (and Kotlin if available)
+echo "Linting (tsc/eslint/prettier/kt)…"
+bun run lint:ci || {
+  echo "Lint failed. Aborting commit." >&2
+  exit 1
+}
+
+# Run tests with coverage before committing to reduce CI failures
+echo "Running test coverage (pre-commit)…"
+bun run test:coverage || {
+  echo "Tests failed. Aborting commit." >&2
+  exit 1
+}

.vscode/settings.json

@@ -88,6 +88,7 @@
     "expo",
     "gradle",
     "hyochan",
+    "hyodotdev",
     "iap",
     "inapp",
     "ktlint",

android/build.gradle

@@ -53,6 +53,11 @@ android {
 
 dependencies {
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7"
-    implementation "com.android.billingclient:billing-ktx:8.0.0"
-    implementation "com.google.android.gms:play-services-base:18.1.0"
+    // Use OpenIAP Google module only; avoid direct BillingClient dependency
+    if (findProject(":openiap-google") != null) {
+      implementation project(":openiap-google")
+    } else {
+      // Fallback to published artifact when local project isn't linked
+      implementation "io.github.hyochan.openiap:openiap-google:1.0.1"
+    }
 }

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

@@ -0,0 +1,85 @@
+package expo.modules.iap
+
+import android.util.Log
+import dev.hyo.openiap.OpenIapError
+import expo.modules.kotlin.Promise
+
+object PromiseUtils {
+    private val promises = java.util.concurrent.ConcurrentHashMap<String, java.util.concurrent.CopyOnWriteArrayList<Promise>>()
+
+    const val TAG = "PromiseUtils"
+
+    // React Native specific promise key used by JS bridge
+    const val PROMISE_BUY_ITEM = "PROMISE_BUY_ITEM"
+
+    fun addPromiseForKey(
+        key: String,
+        promise: Promise,
+    ) {
+        promises.computeIfAbsent(key) { java.util.concurrent.CopyOnWriteArrayList() }.add(promise)
+    }
+
+    fun resolvePromisesForKey(
+        key: String,
+        value: Any?,
+    ) {
+        promises[key]?.forEach { promise ->
+            promise.safeResolve(value)
+        }
+        promises.remove(key)
+    }
+
+    fun rejectAllPendingPromises() {
+        // Snapshot to avoid concurrent modification
+        promises.values.flatMap { it.toList() }.forEach { promise ->
+            promise.safeReject(OpenIapError.E_CONNECTION_CLOSED, "Connection has been closed", null)
+        }
+        promises.clear()
+    }
+
+    fun rejectPromisesForKey(
+        key: String,
+        code: String,
+        message: String?,
+        err: Exception?,
+    ) {
+        promises[key]?.forEach { promise ->
+            promise.safeReject(code, message, err)
+        }
+        promises.remove(key)
+    }
+}
+
+const val TAG = "IapPromises"
+
+fun Promise.safeResolve(value: Any?) {
+    try {
+        this.resolve(value)
+    } catch (e: RuntimeException) {
+        Log.d(TAG, "Already consumed ${e.message}")
+    }
+}
+
+fun Promise.safeReject(message: String) = this.safeReject("E_UNKNOWN", message, null)
+
+fun Promise.safeReject(
+    code: String,
+    message: String?,
+) = this.safeReject(code, message, null)
+
+fun Promise.safeReject(
+    code: String,
+    throwable: Throwable?,
+) = this.safeReject(code, null, throwable)
+
+fun Promise.safeReject(
+    code: String,
+    message: String?,
+    throwable: Throwable?,
+) {
+    try {
+        this.reject(code, message, throwable)
+    } catch (e: RuntimeException) {
+        Log.d(TAG, "Already consumed ${e.message}")
+    }
+}