expo-iap 4.4.0-rc.7 → 4.4.1

package/CHANGELOG.md

@@ -1,3 +1,6 @@
 # CHANGELOG
 
-[Check release notes](https://github.com/hyochan/expo-iap/releases)
+OpenIAP keeps detailed release history centralized to avoid package-local drift.
+
+- Consolidated release notes: [openiap.dev/docs/updates/releases](https://openiap.dev/docs/updates/releases)
+- Expo package releases: [hyodotdev/openiap/releases?q=expo-iap](https://github.com/hyodotdev/openiap/releases?q=expo-iap&expanded=true)

package/CLAUDE.md

@@ -39,7 +39,7 @@
 Before committing any changes:
 
 1. Run `bun run lint` to ensure code quality
-2. Run `bun run typecheck` to verify TypeScript types
+2. Run `bun run lint:tsc` 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`

package/README.md

@@ -85,7 +85,7 @@ Expo IAP conforms to the **[OpenIAP specification](https://openiap.dev)** — an
 
 - **Shared specification** — Common types, error codes, and purchase flows across all platforms
 - **Generated type-safe bindings** — Swift, Kotlin, Dart, and GDScript from a single GraphQL schema
-- **Platform implementations** — [openiap-apple](https://github.com/hyodotdev/openiap/tree/main/packages/apple) (StoreKit 2) and [openiap-google](https://github.com/hyodotdev/openiap/tree/main/packages/google) (Play Billing 8.x)
+- **Platform implementations** — [openiap-apple](https://github.com/hyodotdev/openiap/tree/main/packages/apple) (StoreKit 2) and [openiap-google](https://github.com/hyodotdev/openiap/tree/main/packages/google) (Play Billing 9.1.0)
 - **Verification profiles** — Standardized receipt validation and purchase verification patterns
 
 Other libraries built on OpenIAP: [react-native-iap](https://github.com/hyodotdev/openiap/tree/main/libraries/react-native-iap) · [flutter_inapp_purchase](https://github.com/hyodotdev/openiap/tree/main/libraries/flutter_inapp_purchase) · [kmp-iap](https://github.com/hyodotdev/openiap/tree/main/libraries/kmp-iap) · [godot-iap](https://github.com/hyodotdev/openiap/tree/main/libraries/godot-iap)

package/android/build.gradle

@@ -103,6 +103,8 @@ kotlin {
 
 dependencies {
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7"
+    testImplementation "junit:junit:4.13.2"
+    testImplementation "org.json:json:20180813"
 
     // Use OpenIAP Google module only; avoid direct BillingClient dependency
     if (findProject(":openiap-google") != null) {

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

@@ -1,20 +1,46 @@
 package expo.modules.iap
 
 import dev.hyo.openiap.AndroidSubscriptionOfferInput
+import dev.hyo.openiap.DeveloperBillingOptionParamsAndroid
 import dev.hyo.openiap.OpenIapError
 import dev.hyo.openiap.OpenIapModule
 import dev.hyo.openiap.ProductQueryType
 import dev.hyo.openiap.SubscriptionProductReplacementParamsAndroid
 import dev.hyo.openiap.SubscriptionReplacementModeAndroid
+import dev.hyo.openiap.listener.OpenIapDeveloperProvidedBillingListener
+import dev.hyo.openiap.listener.OpenIapPurchaseErrorListener
+import dev.hyo.openiap.listener.OpenIapPurchaseUpdateListener
+import dev.hyo.openiap.listener.OpenIapSubscriptionBillingIssueListener
+import dev.hyo.openiap.listener.OpenIapUserChoiceBillingListener
 import expo.modules.kotlin.Promise
 import expo.modules.kotlin.modules.Module
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.launch
+import org.json.JSONObject
 import java.util.Locale
 import java.util.concurrent.ConcurrentLinkedQueue
 
 object ExpoIapHelper {
     private const val MAX_BUFFERED_EVENTS = 200
+    internal const val ERROR_ENVELOPE_PREFIX = "OPENIAP_ERROR_JSON:"
+
+    data class ListenerHandles(
+        val purchaseUpdate: OpenIapPurchaseUpdateListener,
+        val purchaseError: OpenIapPurchaseErrorListener,
+        val userChoiceBilling: OpenIapUserChoiceBillingListener,
+        val developerProvidedBilling: OpenIapDeveloperProvidedBillingListener,
+        val subscriptionBillingIssue: OpenIapSubscriptionBillingIssueListener,
+    )
+
+    internal fun serializeOpenIapError(error: OpenIapError): Map<String, Any?> =
+        error.toJSON() +
+            when (error) {
+                is OpenIapError.ProductNotFound -> mapOf("productId" to error.productId)
+                is OpenIapError.SkuNotFound -> mapOf("productId" to error.sku)
+                else -> emptyMap()
+            }
+
+    internal fun serializeErrorEnvelope(payload: Map<String, Any?>): String = ERROR_ENVELOPE_PREFIX + JSONObject(payload).toString()
 
     fun emitOrQueue(
         module: Module,
@@ -56,29 +82,31 @@ object ExpoIapHelper {
         // Support nested request.google / request.android structure
         // If the params contain a "request" key with nested platform-specific data,
         // extract and flatten it before parsing.
-        val effective: Map<String, Any?> = run {
-            val request = params["request"] as? Map<*, *>
-            if (request != null) {
-                val nested = (request["google"] as? Map<*, *>)
-                    ?: (request["android"] as? Map<*, *>)
-                if (nested != null) {
-                    val flat = mutableMapOf<String, Any?>()
-                    // Carry over top-level fields like type, useAlternativeBilling
-                    for ((k, v) in params) {
-                        if (k != "request") flat[k] = v
-                    }
-                    // Overlay platform-specific fields
-                    for ((k, v) in nested) {
-                        if (k is String) flat[k] = v
+        val effective: Map<String, Any?> =
+            run {
+                val request = params["request"] as? Map<*, *>
+                if (request != null) {
+                    val nested =
+                        (request["google"] as? Map<*, *>)
+                            ?: (request["android"] as? Map<*, *>)
+                    if (nested != null) {
+                        val flat = mutableMapOf<String, Any?>()
+                        // Carry over top-level fields like type, useAlternativeBilling
+                        for ((k, v) in params) {
+                            if (k != "request") flat[k] = v
+                        }
+                        // Overlay platform-specific fields
+                        for ((k, v) in nested) {
+                            if (k is String) flat[k] = v
+                        }
+                        flat
+                    } else {
+                        params
                     }
-                    flat
                 } else {
                     params
                 }
-            } else {
-                params
             }
-        }
 
         val type = effective["type"] as? String
         val skus: List<String> =
@@ -102,7 +130,17 @@ object ExpoIapHelper {
                 }
             } ?: emptyList()
         val purchaseToken = effective["purchaseToken"] as? String
+        val originalExternalTransactionId = effective["originalExternalTransactionId"] as? String
         val replacementMode = effective["replacementMode"] as? Number
+        val developerBillingOption =
+            (effective["developerBillingOption"] as? Map<*, *>)?.let { optionMap ->
+                val json =
+                    optionMap.entries
+                        .mapNotNull { (key, value) ->
+                            (key as? String)?.let { it to value }
+                        }.toMap()
+                DeveloperBillingOptionParamsAndroid.fromJson(json)
+            }
         val subscriptionProductReplacementParams =
             (effective["subscriptionProductReplacementParams"] as? Map<*, *>)?.let { paramsMap ->
                 val oldProductId = paramsMap["oldProductId"] as? String
@@ -116,7 +154,7 @@ object ExpoIapHelper {
                     )
                 }
             }
-        // offerToken for one-time purchase discounts (Android 7.0+)
+        // offerToken for one-time purchase discounts (Android 8.0+)
         val offerToken = effective["offerToken"] as? String
 
         return RequestPurchaseParams(
@@ -128,6 +166,8 @@ object ExpoIapHelper {
             offerToken = offerToken,
             offerTokenArr = offerTokenArr,
             explicitSubscriptionOffers = explicitSubscriptionOffers,
+            developerBillingOption = developerBillingOption,
+            originalExternalTransactionId = originalExternalTransactionId,
             purchaseToken = purchaseToken,
             replacementMode = replacementMode,
             subscriptionProductReplacementParams = subscriptionProductReplacementParams,
@@ -151,10 +191,12 @@ object ExpoIapHelper {
         val obfuscatedAccountId: String?,
         val obfuscatedProfileId: String?,
         val isOfferPersonalized: Boolean,
-        /** Offer token for one-time purchase discounts (Android 7.0+) */
+        /** Offer token for one-time purchase discounts (Android 8.0+) */
         val offerToken: String?,
         val offerTokenArr: List<String>,
         val explicitSubscriptionOffers: List<AndroidSubscriptionOfferInput>,
+        val developerBillingOption: DeveloperBillingOptionParamsAndroid?,
+        val originalExternalTransactionId: String?,
         val purchaseToken: String?,
         val replacementMode: Number?,
         val subscriptionProductReplacementParams: SubscriptionProductReplacementParamsAndroid?,
@@ -226,56 +268,43 @@ object ExpoIapHelper {
         eventUserChoiceBilling: String,
         eventDeveloperProvidedBilling: String,
         eventSubscriptionBillingIssue: String,
-    ) {
-        openIap.addPurchaseUpdateListener { p ->
-            runCatching {
-                emitOrQueue(
-                    module,
-                    scope,
-                    connectionReady,
-                    pendingEvents,
-                    eventPurchaseUpdated,
-                    p.toJson(),
-                )
-            }.onFailure { error ->
-                ExpoIapLog.failure("buffer/send PURCHASE_UPDATED", error)
-                // Emit as purchase error so user knows something went wrong
-                val errorPayload =
-                    mapOf(
-                        "code" to OpenIapError.PurchaseFailed.CODE,
-                        "message" to "Failed to process purchase update: ${error.message}",
-                    )
+    ): ListenerHandles {
+        val purchaseUpdateListener =
+            OpenIapPurchaseUpdateListener { p ->
                 runCatching {
                     emitOrQueue(
                         module,
                         scope,
                         connectionReady,
                         pendingEvents,
-                        eventPurchaseError,
-                        errorPayload,
+                        eventPurchaseUpdated,
+                        p.toJson(),
                     )
-                }.onFailure { ExpoIapLog.failure("send error event", it) }
+                }.onFailure { error ->
+                    ExpoIapLog.failure("buffer/send PURCHASE_UPDATED", error)
+                    // Emit as purchase error so user knows something went wrong
+                    val errorPayload =
+                        mapOf(
+                            "code" to OpenIapError.PurchaseFailed.CODE,
+                            "message" to "Failed to process purchase update: ${error.message}",
+                        )
+                    runCatching {
+                        emitOrQueue(
+                            module,
+                            scope,
+                            connectionReady,
+                            pendingEvents,
+                            eventPurchaseError,
+                            errorPayload,
+                        )
+                    }.onFailure { ExpoIapLog.failure("send error event", it) }
+                }
             }
-        }
-        openIap.addPurchaseErrorListener { e ->
-            val errorJson = e.toJSON()
-            runCatching {
-                emitOrQueue(
-                    module,
-                    scope,
-                    connectionReady,
-                    pendingEvents,
-                    eventPurchaseError,
-                    errorJson,
-                )
-            }.onFailure { error ->
-                ExpoIapLog.failure("buffer/send PURCHASE_ERROR", error)
-                // Critical: if we can't emit the original error, at least try to emit a generic one
-                val fallbackPayload =
-                    mapOf(
-                        "code" to OpenIapError.UnknownError.CODE,
-                        "message" to "Failed to emit purchase error: ${error.message}",
-                    )
+        openIap.addPurchaseUpdateListener(purchaseUpdateListener)
+
+        val purchaseErrorListener =
+            OpenIapPurchaseErrorListener { e ->
+                val errorJson = serializeOpenIapError(e)
                 runCatching {
                     emitOrQueue(
                         module,
@@ -283,63 +312,108 @@ object ExpoIapHelper {
                         connectionReady,
                         pendingEvents,
                         eventPurchaseError,
-                        fallbackPayload,
+                        errorJson,
                     )
-                }.onFailure { ExpoIapLog.failure("send fallback error event", it) }
+                }.onFailure { error ->
+                    ExpoIapLog.failure("buffer/send PURCHASE_ERROR", error)
+                    // Critical: if we can't emit the original error, at least try to emit a generic one
+                    val fallbackPayload =
+                        mapOf(
+                            "code" to OpenIapError.UnknownError.CODE,
+                            "message" to "Failed to emit purchase error: ${error.message}",
+                        )
+                    runCatching {
+                        emitOrQueue(
+                            module,
+                            scope,
+                            connectionReady,
+                            pendingEvents,
+                            eventPurchaseError,
+                            fallbackPayload,
+                        )
+                    }.onFailure { ExpoIapLog.failure("send fallback error event", it) }
+                }
+                // Also reject any pending purchase promises to match iOS behavior
+                val errorCode = errorJson["code"] as? String ?: OpenIapError.PurchaseFailed.CODE
+                rejectPurchasePromises(
+                    errorCode,
+                    serializeErrorEnvelope(errorJson),
+                    null,
+                )
             }
-            // Also reject any pending purchase promises to match iOS behavior
-            val errorCode = errorJson["code"] as? String ?: OpenIapError.PurchaseFailed.CODE
-            val errorMessage = errorJson["message"] as? String ?: "Purchase failed"
-            rejectPurchasePromises(errorCode, errorMessage, null)
-        }
-        openIap.addUserChoiceBillingListener { details ->
-            safeEmitEvent(
-                module,
-                scope,
-                connectionReady,
-                pendingEvents,
-                eventUserChoiceBilling,
-                details.toJson(),
-                eventPurchaseError,
-                "alternative-billing-not-available",
-                "Failed to process user choice billing",
-                "USER_CHOICE_BILLING",
-            )
-        }
-        // Developer Provided Billing listener for External Payments (8.3.0+)
-        openIap.addDeveloperProvidedBillingListener { details ->
-            safeEmitEvent(
-                module,
-                scope,
-                connectionReady,
-                pendingEvents,
-                eventDeveloperProvidedBilling,
-                details.toJson(),
-                eventPurchaseError,
-                "developer-billing-error",
-                "Failed to process developer provided billing",
-                "DEVELOPER_PROVIDED_BILLING",
-            )
-        }
+        openIap.addPurchaseErrorListener(purchaseErrorListener)
+
+        val userChoiceBillingListener =
+            OpenIapUserChoiceBillingListener { details ->
+                safeEmitEvent(
+                    module,
+                    scope,
+                    connectionReady,
+                    pendingEvents,
+                    eventUserChoiceBilling,
+                    details.toJson(),
+                    eventPurchaseError,
+                    "alternative-billing-not-available",
+                    "Failed to process user choice billing",
+                    "USER_CHOICE_BILLING",
+                )
+            }
+        openIap.addUserChoiceBillingListener(userChoiceBillingListener)
+
+        // Developer Provided Billing listener for External Payments (8.3.0+) and Billing Choice (9.1.0+)
+        val developerProvidedBillingListener =
+            OpenIapDeveloperProvidedBillingListener { details ->
+                safeEmitEvent(
+                    module,
+                    scope,
+                    connectionReady,
+                    pendingEvents,
+                    eventDeveloperProvidedBilling,
+                    details.toJson(),
+                    eventPurchaseError,
+                    "developer-billing-error",
+                    "Failed to process developer provided billing",
+                    "DEVELOPER_PROVIDED_BILLING",
+                )
+            }
+        openIap.addDeveloperProvidedBillingListener(developerProvidedBillingListener)
+
         // Subscription billing-issue listener (Play Billing 8.1+ isSuspended; no-op on Horizon)
-        openIap.addSubscriptionBillingIssueListener { purchase ->
-            safeEmitEvent(
-                module,
-                scope,
-                connectionReady,
-                pendingEvents,
-                eventSubscriptionBillingIssue,
-                purchase.toJson(),
-                eventPurchaseError,
-                "subscription-billing-issue-error",
-                "Failed to process subscription billing issue",
-                "SUBSCRIPTION_BILLING_ISSUE",
-            )
-        }
+        val subscriptionBillingIssueListener =
+            OpenIapSubscriptionBillingIssueListener { purchase ->
+                safeEmitEvent(
+                    module,
+                    scope,
+                    connectionReady,
+                    pendingEvents,
+                    eventSubscriptionBillingIssue,
+                    purchase.toJson(),
+                    eventPurchaseError,
+                    "subscription-billing-issue-error",
+                    "Failed to process subscription billing issue",
+                    "SUBSCRIPTION_BILLING_ISSUE",
+                )
+            }
+        openIap.addSubscriptionBillingIssueListener(subscriptionBillingIssueListener)
+
+        return ListenerHandles(
+            purchaseUpdate = purchaseUpdateListener,
+            purchaseError = purchaseErrorListener,
+            userChoiceBilling = userChoiceBillingListener,
+            developerProvidedBilling = developerProvidedBillingListener,
+            subscriptionBillingIssue = subscriptionBillingIssueListener,
+        )
     }
 
-    fun cleanupListeners(openIap: OpenIapModule) {
-        // Android doesn't have explicit listeners to clean up
-        // This function is kept for API compatibility with iOS
+    fun cleanupListeners(
+        openIap: OpenIapModule,
+        handles: ListenerHandles?,
+    ) {
+        if (handles == null) return
+        openIap.removePurchaseUpdateListener(handles.purchaseUpdate)
+        openIap.removePurchaseErrorListener(handles.purchaseError)
+        openIap.removeUserChoiceBillingListener(handles.userChoiceBilling)
+        openIap.removeDeveloperProvidedBillingListener(handles.developerProvidedBilling)
+        openIap.removeSubscriptionBillingIssueListener(handles.subscriptionBillingIssue)
     }
 }

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

@@ -12,7 +12,9 @@ internal object ExpoIapLog {
         "apikey",
         "secret",
         "jws",
-        "receiptid",
+        "receipt",
+        "dataandroid",
+        "signatureandroid",
         "userid",
         "password",
         "bearer"
@@ -54,7 +56,7 @@ internal object ExpoIapLog {
         }
     }
 
-    private fun stringify(value: Any?): String {
+    internal fun stringify(value: Any?): String {
         val sanitized = sanitize(value) ?: return "null"
         return when (sanitized) {
             is String -> sanitized
@@ -66,9 +68,14 @@ internal object ExpoIapLog {
     }
 
     private fun sanitize(value: Any?): Any? {
-        if (value == null) return null
+        if (value == null || value === JSONObject.NULL) return null
 
         return when (value) {
+            is String -> sanitizeJsonString(value)
+            is JSONObject -> sanitizeMap(
+                value.keys().asSequence().associateWith(value::opt),
+            )
+            is JSONArray -> (0 until value.length()).mapNotNull { sanitize(value.opt(it)) }
             is Map<*, *> -> sanitizeMap(value)
             is List<*> -> value.mapNotNull { sanitize(it) }
             is Array<*> -> value.mapNotNull { sanitize(it) }
@@ -76,6 +83,18 @@ internal object ExpoIapLog {
         }
     }
 
+    private fun sanitizeJsonString(value: String): Any {
+        val trimmed = value.trim()
+        val json = runCatching {
+            when (trimmed.firstOrNull()) {
+                '{' -> JSONObject(trimmed)
+                '[' -> JSONArray(trimmed)
+                else -> null
+            }
+        }.getOrNull() ?: return value
+        return sanitize(json) ?: value
+    }
+
     private fun sanitizeMap(source: Map<*, *>): Map<String, Any?> {
         fun isSensitiveKey(key: String): Boolean {
             val normalized = key.lowercase(Locale.ROOT).filter { it.isLetterOrDigit() }