expo-iap 5.6.2 → 5.7.0

package/AGENTS.md

@@ -84,7 +84,7 @@ For complete type definitions and documentation, see: <https://openiap.dev/docs/
 
 The library follows the OpenIAP type specifications with platform-specific extensions using iOS/Android suffixes.
 
-> **Important:** `src/types.ts` is generated from the OpenIAP schema. Never edit this file manually or commit hand-written changes. In this monorepo, run `cd specs/client && bun run generate` from the repository root so every platform copy stays synchronized. The Expo-local `bun run generate:types` command is only for a standalone checkout: it atomically refreshes the platform-ready file from the raw `docs-${spec}` tag pinned by `openiap-versions.json` (or the version passed with `--tag`).
+> **Important:** `src/types.ts` is generated from the OpenIAP schema. Never edit this file manually or commit hand-written changes. In this monorepo, run `cd specs/client && bun run generate` from the repository root so every platform copy stays synchronized. The Expo-local `bun run generate:types` command is only for a standalone checkout: it atomically refreshes the platform-ready file from the raw `openiap-client-protocol-${clientProtocol}` tag pinned by `openiap-versions.json` (or the version passed with `--tag`).
 
 - Whenever you need Request/Params/Result types in the JS API surface (`src/index.ts`, hooks, modules, examples), import them directly from the generated `src/types.ts` (e.g., `MutationRequestPurchaseArgs`, `QueryFetchProductsArgs`). Bind exported functions with the generated `QueryField` / `MutationField` helpers so their signatures stay in lockstep with `types.ts` instead of redefining ad-hoc unions like `ProductTypeInput`.
 

package/CONTRIBUTING.md

@@ -214,28 +214,28 @@ For detailed code conventions, naming standards, and implementation guidelines,
 
 ### Updating OpenIAP Types
 
-The generated TypeScript definitions in `src/types.ts` come from the platform-ready file committed in the [OpenIAP](https://github.com/hyodotdev/openiap) raw `docs-${spec}` tag. Never edit this file by hand. When the schema changes or you need to pull newer published types:
+The generated TypeScript definitions in `src/types.ts` come from the platform-ready file committed in the [OpenIAP](https://github.com/hyodotdev/openiap) raw `openiap-client-protocol-${clientProtocol}` tag. Never edit this file by hand. When the schema changes or you need to pull newer published types:
 
 - Run `bun run generate:types` to download the version pinned by `openiap-versions.json`, validate it, and atomically replace `src/types.ts`.
-- To target a specific published spec, pass its version: `bun run generate:types --tag <version>` (the script resolves it to `docs-<version>`).
+- To target a specific published Client Protocol version, pass it: `bun run generate:types --tag <version>` (the script resolves it to `openiap-client-protocol-<version>`).
 - Commit the updated file alongside any related schema or documentation changes.
 
 Always ensure the repository builds and tests succeed after regenerating the types.
 
 ## 🔢 OpenIAP Version Management
 
-The native dependency and OpenIAP specification versions are sourced from `openiap-versions.json` at the repository root:
+The native dependency and Client Protocol versions are sourced from `openiap-versions.json` at the repository root:
 
 - `apple` → iOS Pod dependency (`ios/ExpoIap.podspec`).
 - `google` → Android artifact (`android/build.gradle`, Expo config plugin).
-- `spec` → published OpenIAP specification/types release (`scripts/update-types.mjs`).
+- `clientProtocol` → published Client Protocol types release (`scripts/update-types.mjs`).
 
 When bumping dependencies:
 
 1. Update the relevant fields in `openiap-versions.json`.
 2. For iOS changes, run `cd ios && pod install` (and commit the Pod.lock if required by the workflow).
 3. For Android, re-run Gradle (`bun run android`) so the new artifact is pulled down.
-4. When the `spec` value changes, run `bun run generate:types` to refresh `src/types.ts` from the matching raw `docs-${spec}` tag.
+4. When the `clientProtocol` value changes, run `bun run generate:types` to refresh `src/types.ts` from the matching raw `openiap-client-protocol-${clientProtocol}` tag.
 5. Commit the updated JSON, regenerated files, and any resulting lockfile changes together.
 
 If the JSON file is missing or malformed, build scripts (Gradle, Podspec, the type generator) will fail fast — fix the JSON rather than hard-coding version strings in multiple locations.

package/README.md

@@ -5,7 +5,7 @@
   
   [![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) [![OpenIAP](https://img.shields.io/badge/OpenIAP-Compliant-green?style=flat-square)](https://openiap.dev) [![CI](https://github.com/hyodotdev/openiap/actions/workflows/ci-expo-iap.yml/badge.svg?branch=main)](https://github.com/hyodotdev/openiap/actions/workflows/ci-expo-iap.yml?query=branch%3Amain) [![codecov](https://codecov.io/gh/hyodotdev/openiap/branch/main/graph/badge.svg?component=expo-iap)](https://app.codecov.io/gh/hyodotdev/openiap/tree/main/libraries/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)
   
-Expo IAP is a powerful in-app purchase solution for Expo and React Native applications that conforms to the OpenIAP specification. It provides a unified API for handling in-app purchases across iOS and Android platforms with comprehensive error handling and modern TypeScript support.
+Expo IAP is a powerful in-app purchase solution for Expo and React Native applications that conforms to the OpenIAP Client Protocol. It provides a unified API for handling in-app purchases across iOS and Android platforms with comprehensive error handling and modern TypeScript support.
 
 If you're shipping an app with expo-iap, we’d love to hear about it—please share your product and feedback in [expo-iap Q&A Discussions](https://github.com/hyodotdev/openiap/discussions/categories/expo-iap). Community stories help us keep improving the ecosystem.
 
@@ -66,7 +66,7 @@ For detailed usage examples and error handling, see the [documentation](https://
 
 <a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="OpenIAP" height="50" /></a>
 
-Expo IAP conforms to the **[OpenIAP specification](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
+Expo IAP conforms to the **[OpenIAP Client Protocol](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
 
 - **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

package/android/build.gradle

@@ -53,12 +53,9 @@ if (!(googleVersion instanceof String) || !googleVersion.trim()) {
 def googleVersionString = googleVersion.trim()
 apply from: project.file('openiap-android-sdk.gradle')
 
-def horizonEnabled = project.findProperty('horizonEnabled')?.toBoolean() ?: false
-def fireOsEnabled = project.findProperty('fireOsEnabled')?.toBoolean() ?: false
-if (horizonEnabled && fireOsEnabled) {
-  throw new GradleException("expo-iap: horizonEnabled and fireOsEnabled cannot both be true")
-}
-def openiapFlavor = fireOsEnabled ? 'amazon' : (horizonEnabled ? 'horizon' : 'play')
+// Store selection: explicit property > task flavor > connected debug device > play.
+apply from: project.file('openiap-store.gradle')
+def openiapFlavor = openIapResolveStore('expo-iap').store
 
 // If you want to use the managed Android SDK versions from expo-modules-core, set this to true.
 // The Android SDK versions will be bumped from time to time in SDK releases and may introduce breaking changes in your module code.
@@ -111,17 +108,15 @@ dependencies {
     testImplementation "junit:junit:4.13.2"
     testImplementation "org.json:json:20260719"
 
-    // Use OpenIAP Google module only; avoid direct BillingClient dependency
+    // `api`, so an app's own native code can use dev.hyo.openiap through this module.
     if (findProject(":openiap-google") != null) {
-      implementation project(":openiap-google")
-    } else if (fireOsEnabled) {
-      // Use openiap-google-amazon for Fire OS when fireOsEnabled is true
-      implementation "io.github.hyochan.openiap:openiap-google-amazon:${googleVersionString}"
-    } else if (horizonEnabled) {
-      // Use openiap-google-horizon for Meta Quest when horizonEnabled is true
-      implementation "io.github.hyochan.openiap:openiap-google-horizon:${googleVersionString}"
+      api project(":openiap-google")
+    } else if (openiapFlavor == 'amazon') {
+      api "io.github.hyochan.openiap:openiap-google-amazon:${googleVersionString}"
+    } else if (openiapFlavor == 'horizon') {
+      api "io.github.hyochan.openiap:openiap-google-horizon:${googleVersionString}"
     } else {
       // Fallback to published artifact when local project isn't linked
-      implementation "io.github.hyochan.openiap:openiap-google:${googleVersionString}"
+      api "io.github.hyochan.openiap:openiap-google:${googleVersionString}"
     }
 }

package/android/openiap-store.gradle

@@ -0,0 +1,365 @@
+// OpenIAP store resolver. Framework wrappers symlink this file into android/
+// and publish it as a real file.
+// Apply it, then call openIapResolveStore('<label>'), or ('<label>', [allowNone: true])
+// where the library can build without a store SDK.
+//
+// First match wins:
+//   1. explicit  openiapStore=<store> (-P, ORG_GRADLE_PROJECT_openiapStore, gradle.properties).
+//                The legacy horizonEnabled, fireOsEnabled and openiapPlatform=none still work.
+//   2. variant   a requested task names a store flavor (assembleHorizonRelease).
+//   3. device    debug builds only: the Quest or Fire device that ANDROID_SERIAL
+//                names, or the only one connected.
+//   4. play
+// Two signals naming different stores fail the build. Only spelled-out task names
+// are read; a task that builds another store (an abbreviation such as aHR) fails
+// once the task graph is ready.
+
+ext.openIapStoreAliases = [
+  play: 'play', google: 'play', gplay: 'play', googleplay: 'play', 'google-play': 'play', gms: 'play',
+  horizon: 'horizon', meta: 'horizon', quest: 'horizon',
+  amazon: 'amazon', fire: 'amazon', fireos: 'amazon', 'fire-os': 'amazon',
+  none: 'none', auto: 'auto',
+]
+
+ext.openIapNormalizeStore = { Object value, String label ->
+  def key = value?.toString()?.trim()?.toLowerCase(Locale.ROOT)
+  if (!key) {
+    return null
+  }
+  def store = openIapStoreAliases[key]
+  if (store == null) {
+    throw new GradleException("${label}: unknown openiapStore '${value}'; use play, horizon, amazon, auto, or none where the library allows it")
+  }
+  return store
+}
+
+// assembleHorizonRelease -> [assemble, horizon, release]
+ext.openIapTaskTokens = { String taskPath ->
+  def name = taskPath.substring(taskPath.lastIndexOf(':') + 1)
+  return name.split(/(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])|[^A-Za-z0-9]+/).collect { it.toLowerCase(Locale.ROOT) }.findAll { it }
+}
+
+// The key that set the opt-out, for error messages.
+ext.openIapOptOutKey = {
+  def explicit = project.findProperty('openiapStore')?.toString()?.trim()?.toLowerCase(Locale.ROOT)
+  return explicit == 'none' ? 'openiapStore=none' : 'openiapPlatform=none'
+}
+
+ext.openIapExplicitStore = { String label, boolean allowNone ->
+  def explicit = openIapNormalizeStore(project.findProperty('openiapStore'), label)
+  def horizon = project.findProperty('horizonEnabled')?.toString()?.toBoolean() ?: false
+  def fireOs = project.findProperty('fireOsEnabled')?.toString()?.toBoolean() ?: false
+  def platform = project.findProperty('openiapPlatform')?.toString()?.trim()?.toLowerCase(Locale.ROOT)
+  if (platform != null && platform != 'none') {
+    throw new GradleException("${label}: openiapPlatform only supports the opt-out value 'none'; use openiapStore to pick a store")
+  }
+  if (horizon && fireOs) {
+    throw new GradleException("${label}: horizonEnabled and fireOsEnabled cannot both be true")
+  }
+  if (platform == 'none' && (horizon || fireOs)) {
+    throw new GradleException("${label}: openiapPlatform=none conflicts with legacy store flags")
+  }
+  def (legacyKey, legacy) = platform == 'none' ? ['openiapPlatform=none', 'none']
+      : fireOs ? ['fireOsEnabled=true', 'amazon']
+      : horizon ? ['horizonEnabled=true', 'horizon'] : [null, null]
+  if (legacy != null) {
+    logger.warn("${label}: horizonEnabled, fireOsEnabled, and openiapPlatform are deprecated; use openiapStore=${legacy}")
+  }
+  def pin = explicit == 'auto' ? null : explicit
+  if (pin != null && legacy != null && legacy != pin) {
+    throw new GradleException("${label}: openiapStore=${pin} conflicts with ${legacyKey}")
+  }
+  def store = pin ?: legacy
+  if (store == 'none' && !allowNone) {
+    throw new GradleException("${label}: ${openIapOptOutKey()} is not supported by this library")
+  }
+  return store
+}
+
+// Task options that take a separate value, from Gradle's `help --task` output.
+// An unlisted option's value may be read as a task; the graph check then fails
+// unless the value also names a task the build runs.
+ext.openIapValueOptions = [
+  '-b', '-c', '-g', '-I', '-p',
+  '--args', '--component', '--configuration', '--console', '--dependency',
+  '--distribution-type', '--dsl', '--format',
+  '--gradle-distribution-sha256-sum', '--gradle-distribution-url',
+  '--gradle-version', '--group', '--groups', '--include-build',
+  '--insecure-protocol', '--java-version', '--jvm-vendor', '--jvm-version',
+  '--max-workers', '--network-timeout', '--package', '--project-cache-dir',
+  '--project-dir', '--project-name', '--property', '--task', '--test-framework',
+  '--tests', '--type', '--variant',
+] as Set
+
+// Gradle flattens an invocation into one list, options included, so drop each
+// option and its value: `--tests *AmazonTest*` is not an Amazon build.
+ext.openIapRequestedTasks = {
+  def names = []
+  def previous = null
+  def requested = gradle.startParameter.taskNames
+  if (requested.isEmpty()) {
+    requested = rootProject.defaultTasks ?: []
+  }
+  requested.each { String token ->
+    if (!token) {
+      return
+    }
+    if (token.startsWith('-')) {
+      previous = token
+      return
+    }
+    if (previous != null && openIapValueOptions.contains(previous)) {
+      previous = token
+      return
+    }
+    names << token
+    previous = token
+  }
+  return names
+}
+
+// Variant detection reads every requested task: keep whole-token
+// play/horizon/amazon out of custom task names.
+ext.openIapTaskStore = { String label ->
+  def named = openIapRequestedTasks().collectMany { openIapTaskTokens(it) }
+      .findAll { it in ['play', 'horizon', 'amazon'] } as LinkedHashSet
+  // Two stores in one build: refuse rather than guess.
+  if (named.size() > 1) {
+    throw new GradleException("${label}: cannot tell which store the requested tasks '${openIapRequestedTasks().join(' ')}' select (${named.join(', ')}); build one store per invocation, spell the tasks out, or set openiapStore")
+  }
+  return named ? named.first() : null
+}
+
+// `clean assembleDebug` is a debug build; any release task makes it a release
+// build, which never depends on the attached device.
+ext.openIapBuildTypes = { String taskPath ->
+  def types = [] as LinkedHashSet
+  openIapTaskTokens(taskPath).each { token ->
+    if (token in ['debug', 'release']) {
+      types << token
+    }
+  }
+  if (types) {
+    return types
+  }
+  // `aD` is assembleDebug, so the device rule has to see it as one.
+  def name = taskPath.substring(taskPath.lastIndexOf(':') + 1)
+  def segments = name.split(/(?=[A-Z])/).collect { it.toLowerCase(Locale.ROOT) }.findAll { it }
+  segments.drop(1).each { segment ->
+    ['debug', 'release'].findAll { it.startsWith(segment) }.each { types << it }
+  }
+  return types
+}
+
+ext.openIapDebugBuild = {
+  def names = openIapRequestedTasks()
+  if (!names) {
+    return false
+  }
+  def types = names.collectMany { openIapBuildTypes(it) } as LinkedHashSet
+  return types.contains('debug') && !types.contains('release')
+}
+
+// Gradle resolves a typed name to real tasks: an exact, case-insensitive match
+// when one exists, otherwise a unique prefix or a camelCase abbreviation.
+ext.openIapSelectedTasks = { graph, String request ->
+  def wanted = request.substring(request.lastIndexOf(':') + 1)
+  if (!wanted) {
+    return []
+  }
+  def lower = wanted.toLowerCase(Locale.ROOT)
+  def names = graph.allTasks.collect { it.name } as LinkedHashSet
+  def exact = names.findAll { it.toLowerCase(Locale.ROOT) == lower }
+  if (exact) {
+    return exact
+  }
+  def segments = wanted.split(/(?=[A-Z])/).findAll { it }
+  return names.findAll { String name ->
+    if (name.toLowerCase(Locale.ROOT).startsWith(lower)) {
+      return true
+    }
+    def taskSegments = name.split(/(?=[A-Z])/).findAll { it }
+    if (segments.size() < 2 || segments.size() > taskSegments.size()) {
+      return false
+    }
+    return (0..<segments.size()).every {
+      taskSegments[it].toLowerCase(Locale.ROOT).startsWith(segments[it].toLowerCase(Locale.ROOT))
+    }
+  }
+}
+
+// Checks the store picked at configuration against the tasks that will run.
+// Only tasks the request selected count: an anchor such as assembleDebug also
+// builds every flavor of a library it reaches.
+ext.openIapVerifyTaskGraph = { String label, Map resolution ->
+  def resolved = resolution.store
+  if (resolved == 'none') {
+    return
+  }
+  gradle.taskGraph.whenReady { graph ->
+    def named = [] as LinkedHashSet
+    openIapRequestedTasks().each { String request ->
+      openIapSelectedTasks(graph, request).each { String taskName ->
+        openIapTaskTokens(taskName).each { token ->
+          if (token in ['play', 'horizon', 'amazon']) {
+            named << token
+          }
+        }
+      }
+    }
+    if (!named) {
+      // The store came from something that is not a task, such as an option's value.
+      if (resolution.source == 'variant') {
+        throw new GradleException("${label}: read ${resolved} from '${openIapRequestedTasks().join(' ')}', but no task it runs names a store; set openiapStore")
+      }
+      return
+    }
+    if (named.size() > 1) {
+      throw new GradleException("${label}: the requested tasks build more than one store (${named.join(', ')}) but a build links one; build one store per invocation or set openiapStore")
+    }
+    def actual = named.first()
+    if (actual != resolved) {
+      throw new GradleException("${label}: linked ${resolved} but the requested tasks build ${actual}; spell the task out or set openiapStore=${actual}")
+    }
+  }
+}
+
+ext.openIapEnv = { String name ->
+  // providers.environmentVariable is a tracked configuration-cache input;
+  // System.getenv is not.
+  return providers.environmentVariable(name).orNull
+}
+
+ext.openIapAdb = {
+  def roots = [openIapEnv('ANDROID_HOME'), openIapEnv('ANDROID_SDK_ROOT')]
+  // local.properties is plain I/O, not a tracked input: sdk.dir ~never
+  // changes, and staleness only loses adb discovery, never a store pick.
+  def localProperties = rootProject.file('local.properties')
+  if (localProperties.isFile()) {
+    def properties = new Properties()
+    localProperties.withInputStream { properties.load(it) }
+    roots << properties.getProperty('sdk.dir')
+  }
+  def names = ['adb', 'adb.exe']
+  def adb = roots.findResult { root ->
+    if (!root) {
+      return null
+    }
+    return names.findResult { name ->
+      def candidate = new File(root, "platform-tools/${name}")
+      return candidate.isFile() ? candidate.absolutePath : null
+    }
+  }
+  if (adb != null) {
+    return adb
+  }
+  // A developer with adb only on PATH still gets device selection.
+  return (openIapEnv('PATH') ?: '').split(File.pathSeparator).findResult { entry ->
+    if (!entry) {
+      return null
+    }
+    return names.findResult { name ->
+      def candidate = new File(entry, name)
+      return candidate.isFile() ? candidate.absolutePath : null
+    }
+  }
+}
+
+// providers.exec keeps the probe legal under the configuration cache, and Gradle
+// re-runs it before reusing a cached configuration, so a new device reconfigures.
+ext.openIapAdbText = { List<String> command ->
+  try {
+    return providers.exec {
+      commandLine(command)
+      ignoreExitValue = true
+    }.standardOutput.asText.get()
+  } catch (Throwable ignored) {
+    return null
+  }
+}
+
+// Like every Android tool, target the device ANDROID_SERIAL names.
+ext.openIapDeviceStore = {
+  def adb = openIapAdb()
+  if (adb == null) {
+    return null
+  }
+  def listing = openIapAdbText([adb, 'devices'])
+  if (listing == null) {
+    return null
+  }
+  // Windows adb terminates lines with CR, which the serial would otherwise keep.
+  def serials = listing.readLines()
+      .collect { it.replace('\r', '').trim() }
+      .findAll { it ==~ /^\S+\s+device$/ }
+      .collect { it.split(/\s+/)[0] }
+  def requested = openIapEnv('ANDROID_SERIAL')?.trim()
+  def serial
+  if (requested) {
+    if (!serials.contains(requested)) {
+      logger.warn("openiap: ANDROID_SERIAL=${requested} is not attached; not selecting a store from a device")
+      return null
+    }
+    serial = requested
+  } else if (serials.size() == 1) {
+    serial = serials[0]
+  } else {
+    return null
+  }
+  def features = openIapAdbText([adb, '-s', serial, 'shell', 'pm', 'list', 'features'])
+  def manufacturerText = openIapAdbText([adb, '-s', serial, 'shell', 'getprop', 'ro.product.manufacturer'])
+  // A device that dropped after the listing answers with nothing; that is not Play.
+  if (!features?.trim() && !manufacturerText?.trim()) {
+    logger.warn("openiap: ${serial} stopped responding; not selecting a store from a device")
+    return null
+  }
+  features = features ?: ''
+  def manufacturer = (manufacturerText ?: '').trim()
+  def store = 'play'
+  if (features.contains('feature:horizonos.software.horizon_os') || features.contains('feature:oculus.hardware.standalone_vr')) {
+    store = 'horizon'
+  } else if (features.contains('feature:amazon.hardware.fire_tv') || manufacturer.equalsIgnoreCase('Amazon')) {
+    store = 'amazon'
+  }
+  return [store: store, reason: "device ${serial}, manufacturer ${manufacturer ?: 'unknown'}"]
+}
+
+ext.openIapResolveStore = { String label, Map options = [:] ->
+  def allowNone = options.allowNone == true
+  if (rootProject.ext.has('openIapStoreResolution')) {
+    def cached = rootProject.ext.openIapStoreResolution
+    // The opt-out is per caller: a library that needs a store SDK still refuses it.
+    if (cached.store == 'none' && !allowNone) {
+      throw new GradleException("${label}: ${openIapOptOutKey()} is not supported by this library")
+    }
+    return cached
+  }
+  def explicit = openIapExplicitStore(label, allowNone)
+  // Opting out links nothing, so the tasks may build several store flavors.
+  def variant = explicit == 'none' ? null : openIapTaskStore(label)
+  // A pin against the task's flavor would ship the wrong SDK. The opt-out links
+  // nothing, so it may sit beside any flavor.
+  if (explicit != null && explicit != 'none' && variant != null && explicit != variant) {
+    throw new GradleException(
+      "${label}: openiapStore=${explicit} conflicts with the ${variant} flavor in '${openIapRequestedTasks().join(' ')}'"
+    )
+  }
+  def resolution = null
+  if (explicit != null) {
+    resolution = [store: explicit, source: 'explicit', reason: 'openiapStore or a legacy flag']
+  } else if (variant != null) {
+    resolution = [store: variant, source: 'variant', reason: "task ${openIapRequestedTasks().join(' ')}"]
+  } else if (openIapDebugBuild()) {
+    def device = openIapDeviceStore()
+    if (device != null) {
+      resolution = [store: device.store, source: 'device', reason: device.reason]
+    }
+  }
+  if (resolution == null) {
+    resolution = [store: 'play', source: 'default', reason: 'no store signal']
+  }
+  rootProject.ext.openIapStoreResolution = resolution
+  logger.lifecycle("openiap: store=${resolution.store} (source=${resolution.source}; ${resolution.reason})")
+  openIapVerifyTaskGraph(label, resolution)
+  return resolution
+}

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

@@ -272,10 +272,7 @@ object ExpoIapHelper {
         )
     }
 
-    /**
-     * Helper to safely emit an event with error fallback.
-     * Reduces code duplication across listener handlers.
-     */
+    /** Emits an event, falling back to a purchase error if emitting fails. */
     private fun safeEmitEvent(
         module: Module,
         scope: CoroutineScope,
@@ -362,7 +359,7 @@ object ExpoIapHelper {
                     )
                 }.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
+                    // If the original error cannot be emitted, try a generic one.
                     val fallbackPayload =
                         mapOf(
                             "code" to OpenIapError.UnknownError.CODE,

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

@@ -148,8 +148,8 @@ class ExpoIapModule : Module() {
                 scope.launch {
                     connectionMutex.withLock {
                         try {
-                            // CRITICAL: Set Activity BEFORE calling initConnection
-                            // Horizon SDK needs Activity to initialize OVRPlatform with proper returnComponent
+                            // Set the Activity before initConnection: the Horizon SDK needs it to
+                            // initialize OVRPlatform with the proper returnComponent.
                             // https://github.com/meta-quest/Meta-Spatial-SDK-Samples/issues/82#issuecomment-3452577530
                             runCatching { currentActivity }
                                 .onSuccess {
@@ -501,7 +501,6 @@ class ExpoIapModule : Module() {
                 }
             }
 
-            // New name: consumePurchaseAndroid
             AsyncFunction("consumePurchaseAndroid") { token: String, promise: Promise ->
                 ExpoIapLog.payload("consumePurchaseAndroid", mapOf("token" to token))
                 scope.launch {
@@ -610,9 +609,6 @@ class ExpoIapModule : Module() {
                 scope.launch {
                     try {
                         val openIapProgram = mapBillingProgram(program)
-                        // Note: enableBillingProgram should be called before initConnection
-                        // for proper BillingClient configuration. Here it's called as a fallback
-                        // but may have no effect if BillingClient is already initialized.
                         val result = openIapStore.isBillingProgramAvailable(openIapProgram)
                         val response =
                             mapOf(

package/build/ExpoIapModule.d.ts

@@ -1,11 +1,56 @@
+import { type EventSubscription } from 'expo-modules-core';
+import type { BillingProgramAndroid, BillingProgramReportingDetailsAndroid, DeveloperBillingTypeAndroid, Mutation, MutationField, ProductQueryType, PurchaseInput, PurchaseOptions, PurchaseUpdatedListenerOptions, Query, QueryField, SubscriptionStatusIOS } from './types';
+/** Members read from the raw module; every store module provides them. */
+type NativeEventModule = {
+    ERROR_CODES?: Record<string, unknown>;
+    addListener<T>(eventName: string, listener: (payload: T) => void): EventSubscription | undefined;
+    removeListener?<T>(eventName: string, listener: (payload: T) => void): void;
+    setPurchaseUpdatedListenerOptions?(options?: PurchaseUpdatedListenerOptions | null): Promise<void>;
+};
+type QueryFields<K extends keyof Query> = {
+    [P in K]: QueryField<P>;
+};
+type MutationFields<K extends keyof Mutation> = {
+    [P in K]: MutationField<P>;
+};
+/**
+ * Native surface behind the default export. Results the wrappers decode stay
+ * `unknown`; the rest match the generated operation signatures.
+ */
+export type ExpoIapNativeModule = NativeEventModule & QueryFields<'canPresentExternalPurchaseNoticeIOS' | 'currentEntitlementIOS' | 'getActiveSubscriptions' | 'getAppTransactionIOS' | 'getBillingChoiceInfoAndroid' | 'getExternalPurchaseCustomLinkTokenIOS' | 'getPromotedProductIOS' | 'getReceiptDataIOS' | 'getTransactionJwsIOS' | 'hasActiveSubscriptions' | 'isEligibleForExternalPurchaseCustomLinkIOS' | 'isEligibleForIntroOfferIOS' | 'isTransactionVerifiedIOS' | 'latestTransactionIOS'> & MutationFields<'beginRefundRequestIOS' | 'clearTransactionIOS' | 'endConnection' | 'initConnection' | 'isBillingProgramAvailableAndroid' | 'launchExternalLinkAndroid' | 'openRedeemOfferCodeAndroid' | 'presentCodeRedemptionSheetIOS' | 'presentExternalPurchaseLinkIOS' | 'presentExternalPurchaseNoticeSheetIOS' | 'showBillingProgramInformationDialogAndroid' | 'showExternalPurchaseCustomLinkNoticeIOS' | 'showInAppMessagesAndroid' | 'syncIOS' | 'verifyPurchase' | 'verifyPurchaseWithProvider'> & {
+    USING_ONSIDE_SDK: boolean;
+    USING_VEGA_SDK: boolean;
+    fetchProducts(request: {
+        skus: string[];
+        type: ProductQueryType;
+    }): Promise<unknown[]>;
+    fetchProducts(type: ProductQueryType, skus: string[]): Promise<unknown[]>;
+    getAvailableItems(alsoPublishToEventListenerIOS: boolean, onlyIncludeActiveItemsIOS: boolean): Promise<unknown>;
+    getAvailableItems(options: PurchaseOptions): Promise<unknown>;
+    getAllTransactionsIOS(): Promise<unknown>;
+    getPendingTransactionsIOS(): Promise<unknown>;
+    showManageSubscriptionsIOS(): Promise<unknown>;
+    requestPurchase(request: object): Promise<unknown>;
+    finishTransaction(purchase: PurchaseInput, isConsumable: boolean | null): Promise<boolean>;
+    acknowledgePurchaseAndroid(purchaseToken: string): Promise<unknown>;
+    consumePurchaseAndroid(purchaseToken: string): Promise<unknown>;
+    createBillingProgramReportingDetailsAndroid(program: BillingProgramAndroid, developerBillingType: DeveloperBillingTypeAndroid | null): Promise<BillingProgramReportingDetailsAndroid>;
+    subscriptionStatusIOS(sku: string): Promise<SubscriptionStatusIOS[] | null>;
+    requestReceiptRefreshIOS(): Promise<string>;
+    deepLinkToSubscriptionsAndroid?(options: {
+        skuAndroid?: string;
+        packageNameAndroid?: string;
+    }): Promise<void> | void;
+    getStorefront?(): Promise<string> | string;
+    restorePurchases?(): Promise<boolean>;
+};
 export declare const NATIVE_ERROR_CODES: Record<string, unknown>;
 /**
- * Returns the raw native module (not wrapped in a Proxy).
- * Use this for EventEmitter / addListener calls — JSI HostObjects
- * require the real native module as `this`; a Proxy triggers
- * "native state unsupported on Proxy" on New Architecture / Hermes.
+ * Returns the raw native module, not the Proxy. Use it for addListener: a JSI
+ * HostObject needs the real module as `this`, and a Proxy throws "native state
+ * unsupported on Proxy" on New Architecture / Hermes.
  */
-export declare function getNativeModule(): any;
-declare const _default: any;
+export declare function getNativeModule(): NativeEventModule;
+declare const _default: ExpoIapNativeModule;
 export default _default;
 //# sourceMappingURL=ExpoIapModule.d.ts.map

package/build/ExpoIapModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoIapModule.d.ts","sourceRoot":"","sources":["../src/ExpoIapModule.ts"],"names":[],"mappings":"AA6FA,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAQtD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,QAE9B;;AAED,wBAuBG"}
+{"version":3,"file":"ExpoIapModule.d.ts","sourceRoot":"","sources":["../src/ExpoIapModule.ts"],"names":[],"mappings":"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"}

package/build/ExpoIapModule.js

@@ -1,4 +1,4 @@
-import { requireNativeModule, UnavailabilityError } from 'expo-modules-core';
+import { requireNativeModule, UnavailabilityError, } from 'expo-modules-core';
 import { installedFromOnside } from './onside';
 import { getVegaIapModule, isVegaOS } from './vega';
 const ONSIDE_MARKETPLACE_ID = 'com.onside.marketplace-app';
@@ -47,7 +47,10 @@ function getResolved() {
                 throw new UnavailabilityError('expo-iap', 'The Onside marketplace build does not contain ExpoIapOnside. Rebuild with ios.onside.enabled instead of routing purchases through Apple StoreKit.');
             }
         }
-        return { module: requireNativeModule('ExpoIap'), name: 'ExpoIap' };
+        return {
+            module: requireNativeModule('ExpoIap'),
+            name: 'ExpoIap',
+        };
     }
     const expectedName = getExpectedModuleName();
     if (!cached || cached.name !== expectedName) {
@@ -68,18 +71,19 @@ export const NATIVE_ERROR_CODES = new Proxy({}, {
     get(target, prop) {
         if (typeof prop === 'symbol')
             return Reflect.get(target, prop);
-        return (getResolved().module.ERROR_CODES || {})[prop];
+        const errorCodes = getResolved().module.ERROR_CODES || {};
+        return errorCodes[prop];
     },
 });
 /**
- * Returns the raw native module (not wrapped in a Proxy).
- * Use this for EventEmitter / addListener calls — JSI HostObjects
- * require the real native module as `this`; a Proxy triggers
- * "native state unsupported on Proxy" on New Architecture / Hermes.
+ * Returns the raw native module, not the Proxy. Use it for addListener: a JSI
+ * HostObject needs the real module as `this`, and a Proxy throws "native state
+ * unsupported on Proxy" on New Architecture / Hermes.
  */
 export function getNativeModule() {
     return getResolved().module;
 }
+// The Proxy forwards every member to the lazily resolved store module.
 export default new Proxy({}, {
     get(target, prop) {
         if (typeof prop === 'symbol')
@@ -91,7 +95,7 @@ export default new Proxy({}, {
         if (prop === 'USING_VEGA_SDK') {
             return resolved.name === 'ExpoIapVega';
         }
-        const value = resolved.module[prop];
+        const value = Reflect.get(resolved.module, prop);
         if (value !== undefined || resolved.name !== 'ExpoIapOnside') {
             return value;
         }