expo-iap 5.6.2 → 5.7.0

package/build/ExpoIapModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoIapModule.js","sourceRoot":"","sources":["../src/ExpoIapModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAC,mBAAmB,EAAC,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGlD,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAE3D,IAAI,MAAM,GAAoD,IAAI,CAAC;AACnE,IAAI,uBAAuB,GAAG,KAAK,CAAC;AAEpC,SAAS,WAAW;IAClB,SAAS,qBAAqB;QAC5B,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,OAAO,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5D,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,qBAAqB,CAAC;IACvE,CAAC;IAED,SAAS,qBAAqB;QAC5B,IAAI,QAAQ,EAAE,EAAE,CAAC;YACf,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,qBAAqB,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,SAAS,mBAAmB;QAI1B,IAAI,QAAQ,EAAE,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;YACtC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,mBAAmB,CAC3B,UAAU,EACV,+KAA+K,CAChL,CAAC;YACJ,CAAC;YACD,OAAO,EAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAC,CAAC;QACnD,CAAC;QAED,IAAI,qBAAqB,EAAE,EAAE,CAAC;YAC5B,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,MAAM,IAAI,mBAAmB,CAC3B,UAAU,EACV,mJAAmJ,CACpJ,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,OAAO;oBACL,MAAM,EAAE,mBAAmB,CAAC,eAAe,CAAC;oBAC5C,IAAI,EAAE,eAAe;iBACtB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;oBAClD,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,uBAAuB,GAAG,IAAI,CAAC;gBAC/B,MAAM,IAAI,mBAAmB,CAC3B,UAAU,EACV,mJAAmJ,CACpJ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAC,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC;IACnE,CAAC;IAED,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAC7C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC5C,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,UAAkB;IAC9D,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,8BAA8B,UAAU,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAA4B,IAAI,KAAK,CAClE,EAA6B,EAC7B;IACE,GAAG,CAAC,MAAM,EAAE,IAAI;QACd,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAc,CAAC,CAAC;IAClE,CAAC;CACF,CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,EAAE,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED,eAAe,IAAI,KAAK,CAAC,EAAS,EAAE;IAClC,GAAG,CAAC,MAAM,EAAE,IAAI;QACd,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC,IAAI,KAAK,eAAe,CAAC;QAC3C,CAAC;QACD,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC9B,OAAO,QAAQ,CAAC,IAAI,KAAK,aAAa,CAAC;QACzC,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,GAAG,EAAE;YACV,MAAM,IAAI,mBAAmB,CAC3B,UAAU,EACV,2CAA2C,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAC3G,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["import {requireNativeModule, UnavailabilityError} from 'expo-modules-core';\nimport {installedFromOnside} from './onside';\nimport {getVegaIapModule, isVegaOS} from './vega';\n\ntype NativeIapModuleName = 'ExpoIapVega' | 'ExpoIapOnside' | 'ExpoIap';\nconst ONSIDE_MARKETPLACE_ID = 'com.onside.marketplace-app';\n\nlet cached: {module: any; name: NativeIapModuleName} | null = null;\nlet onsideModuleUnavailable = false;\n\nfunction getResolved(): {module: any; name: NativeIapModuleName} {\n  function shouldUseOnsideModule(): boolean {\n    if (installedFromOnside === true) {\n      return true;\n    }\n\n    if (typeof installedFromOnside !== 'string') {\n      return false;\n    }\n\n    const normalized = installedFromOnside.trim().toLowerCase();\n    return normalized === 'true' || normalized === ONSIDE_MARKETPLACE_ID;\n  }\n\n  function getExpectedModuleName(): NativeIapModuleName {\n    if (isVegaOS()) {\n      return 'ExpoIapVega';\n    }\n\n    return shouldUseOnsideModule() ? 'ExpoIapOnside' : 'ExpoIap';\n  }\n\n  function resolveNativeModule(): {\n    module: any;\n    name: NativeIapModuleName;\n  } {\n    if (isVegaOS()) {\n      const vegaModule = getVegaIapModule();\n      if (!vegaModule) {\n        throw new UnavailabilityError(\n          'expo-iap',\n          'Amazon Vega IAP module is unavailable. Install @amazon-devices/keplerscript-appstore-iap-lib in the Vega app target and build with the React Native for Vega kepler platform.',\n        );\n      }\n      return {module: vegaModule, name: 'ExpoIapVega'};\n    }\n\n    if (shouldUseOnsideModule()) {\n      if (onsideModuleUnavailable) {\n        throw new UnavailabilityError(\n          'expo-iap',\n          'The Onside marketplace build does not contain ExpoIapOnside. Rebuild with ios.onside.enabled instead of routing purchases through Apple StoreKit.',\n        );\n      }\n      try {\n        return {\n          module: requireNativeModule('ExpoIapOnside'),\n          name: 'ExpoIapOnside',\n        };\n      } catch (error) {\n        if (!isMissingModuleError(error, 'ExpoIapOnside')) {\n          throw error;\n        }\n        onsideModuleUnavailable = true;\n        throw new UnavailabilityError(\n          'expo-iap',\n          'The Onside marketplace build does not contain ExpoIapOnside. Rebuild with ios.onside.enabled instead of routing purchases through Apple StoreKit.',\n        );\n      }\n    }\n\n    return {module: requireNativeModule('ExpoIap'), name: 'ExpoIap'};\n  }\n\n  const expectedName = getExpectedModuleName();\n  if (!cached || cached.name !== expectedName) {\n    cached = resolveNativeModule();\n  }\n  return cached;\n}\n\nfunction isMissingModuleError(error: unknown, moduleName: string): boolean {\n  if (error instanceof UnavailabilityError) {\n    return true;\n  }\n\n  if (error instanceof Error) {\n    return error.message.includes(`Cannot find native module '${moduleName}'`);\n  }\n\n  return false;\n}\n\nexport const NATIVE_ERROR_CODES: Record<string, unknown> = new Proxy(\n  {} as Record<string, unknown>,\n  {\n    get(target, prop) {\n      if (typeof prop === 'symbol') return Reflect.get(target, prop);\n      return (getResolved().module.ERROR_CODES || {})[prop as string];\n    },\n  },\n);\n\n/**\n * Returns the raw native module (not wrapped in a Proxy).\n * Use this for EventEmitter / addListener calls — JSI HostObjects\n * require the real native module as `this`; a Proxy triggers\n * \"native state unsupported on Proxy\" on New Architecture / Hermes.\n */\nexport function getNativeModule() {\n  return getResolved().module;\n}\n\nexport default new Proxy({} as any, {\n  get(target, prop) {\n    if (typeof prop === 'symbol') return Reflect.get(target, prop);\n    const resolved = getResolved();\n    if (prop === 'USING_ONSIDE_SDK') {\n      return resolved.name === 'ExpoIapOnside';\n    }\n    if (prop === 'USING_VEGA_SDK') {\n      return resolved.name === 'ExpoIapVega';\n    }\n\n    const value = resolved.module[prop];\n    if (value !== undefined || resolved.name !== 'ExpoIapOnside') {\n      return value;\n    }\n\n    return () => {\n      throw new UnavailabilityError(\n        'expo-iap',\n        `The Onside marketplace does not support ${String(prop)}. The call was not routed through Apple StoreKit.`,\n      );\n    };\n  },\n});\n"]}
+{"version":3,"file":"ExpoIapModule.js","sourceRoot":"","sources":["../src/ExpoIapModule.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  requireNativeModule,\n  UnavailabilityError,\n  type EventSubscription,\n} from 'expo-modules-core';\nimport {installedFromOnside} from './onside';\nimport type {\n  BillingProgramAndroid,\n  BillingProgramReportingDetailsAndroid,\n  DeveloperBillingTypeAndroid,\n  Mutation,\n  MutationField,\n  ProductQueryType,\n  PurchaseInput,\n  PurchaseOptions,\n  PurchaseUpdatedListenerOptions,\n  Query,\n  QueryField,\n  SubscriptionStatusIOS,\n} from './types';\nimport {getVegaIapModule, isVegaOS} from './vega';\n\ntype NativeIapModuleName = 'ExpoIapVega' | 'ExpoIapOnside' | 'ExpoIap';\nconst ONSIDE_MARKETPLACE_ID = 'com.onside.marketplace-app';\n\n/** Members read from the raw module; every store module provides them. */\ntype NativeEventModule = {\n  ERROR_CODES?: Record<string, unknown>;\n  addListener<T>(\n    eventName: string,\n    listener: (payload: T) => void,\n  ): EventSubscription | undefined;\n  removeListener?<T>(eventName: string, listener: (payload: T) => void): void;\n  setPurchaseUpdatedListenerOptions?(\n    options?: PurchaseUpdatedListenerOptions | null,\n  ): Promise<void>;\n};\n\ntype QueryFields<K extends keyof Query> = {[P in K]: QueryField<P>};\ntype MutationFields<K extends keyof Mutation> = {[P in K]: MutationField<P>};\n\n/**\n * Native surface behind the default export. Results the wrappers decode stay\n * `unknown`; the rest match the generated operation signatures.\n */\nexport type ExpoIapNativeModule = NativeEventModule &\n  QueryFields<\n    | 'canPresentExternalPurchaseNoticeIOS'\n    | 'currentEntitlementIOS'\n    | 'getActiveSubscriptions'\n    | 'getAppTransactionIOS'\n    | 'getBillingChoiceInfoAndroid'\n    | 'getExternalPurchaseCustomLinkTokenIOS'\n    | 'getPromotedProductIOS'\n    | 'getReceiptDataIOS'\n    | 'getTransactionJwsIOS'\n    | 'hasActiveSubscriptions'\n    | 'isEligibleForExternalPurchaseCustomLinkIOS'\n    | 'isEligibleForIntroOfferIOS'\n    | 'isTransactionVerifiedIOS'\n    | 'latestTransactionIOS'\n  > &\n  MutationFields<\n    | 'beginRefundRequestIOS'\n    | 'clearTransactionIOS'\n    | 'endConnection'\n    | 'initConnection'\n    | 'isBillingProgramAvailableAndroid'\n    | 'launchExternalLinkAndroid'\n    | 'openRedeemOfferCodeAndroid'\n    | 'presentCodeRedemptionSheetIOS'\n    | 'presentExternalPurchaseLinkIOS'\n    | 'presentExternalPurchaseNoticeSheetIOS'\n    | 'showBillingProgramInformationDialogAndroid'\n    | 'showExternalPurchaseCustomLinkNoticeIOS'\n    | 'showInAppMessagesAndroid'\n    | 'syncIOS'\n    | 'verifyPurchase'\n    | 'verifyPurchaseWithProvider'\n  > & {\n    USING_ONSIDE_SDK: boolean;\n    USING_VEGA_SDK: boolean;\n    fetchProducts(request: {\n      skus: string[];\n      type: ProductQueryType;\n    }): Promise<unknown[]>;\n    fetchProducts(type: ProductQueryType, skus: string[]): Promise<unknown[]>;\n    getAvailableItems(\n      alsoPublishToEventListenerIOS: boolean,\n      onlyIncludeActiveItemsIOS: boolean,\n    ): Promise<unknown>;\n    getAvailableItems(options: PurchaseOptions): Promise<unknown>;\n    getAllTransactionsIOS(): Promise<unknown>;\n    getPendingTransactionsIOS(): Promise<unknown>;\n    showManageSubscriptionsIOS(): Promise<unknown>;\n    requestPurchase(request: object): Promise<unknown>;\n    finishTransaction(\n      purchase: PurchaseInput,\n      isConsumable: boolean | null,\n    ): Promise<boolean>;\n    acknowledgePurchaseAndroid(purchaseToken: string): Promise<unknown>;\n    consumePurchaseAndroid(purchaseToken: string): Promise<unknown>;\n    createBillingProgramReportingDetailsAndroid(\n      program: BillingProgramAndroid,\n      developerBillingType: DeveloperBillingTypeAndroid | null,\n    ): Promise<BillingProgramReportingDetailsAndroid>;\n    subscriptionStatusIOS(sku: string): Promise<SubscriptionStatusIOS[] | null>;\n    requestReceiptRefreshIOS(): Promise<string>;\n    deepLinkToSubscriptionsAndroid?(options: {\n      skuAndroid?: string;\n      packageNameAndroid?: string;\n    }): Promise<void> | void;\n    getStorefront?(): Promise<string> | string;\n    restorePurchases?(): Promise<boolean>;\n  };\n\ntype ResolvedNativeModule = {\n  module: NativeEventModule;\n  name: NativeIapModuleName;\n};\n\nlet cached: ResolvedNativeModule | null = null;\nlet onsideModuleUnavailable = false;\n\nfunction getResolved(): ResolvedNativeModule {\n  function shouldUseOnsideModule(): boolean {\n    if (installedFromOnside === true) {\n      return true;\n    }\n\n    if (typeof installedFromOnside !== 'string') {\n      return false;\n    }\n\n    const normalized = installedFromOnside.trim().toLowerCase();\n    return normalized === 'true' || normalized === ONSIDE_MARKETPLACE_ID;\n  }\n\n  function getExpectedModuleName(): NativeIapModuleName {\n    if (isVegaOS()) {\n      return 'ExpoIapVega';\n    }\n\n    return shouldUseOnsideModule() ? 'ExpoIapOnside' : 'ExpoIap';\n  }\n\n  function resolveNativeModule(): ResolvedNativeModule {\n    if (isVegaOS()) {\n      const vegaModule = getVegaIapModule();\n      if (!vegaModule) {\n        throw new UnavailabilityError(\n          'expo-iap',\n          'Amazon Vega IAP module is unavailable. Install @amazon-devices/keplerscript-appstore-iap-lib in the Vega app target and build with the React Native for Vega kepler platform.',\n        );\n      }\n      return {module: vegaModule, name: 'ExpoIapVega'};\n    }\n\n    if (shouldUseOnsideModule()) {\n      if (onsideModuleUnavailable) {\n        throw new UnavailabilityError(\n          'expo-iap',\n          'The Onside marketplace build does not contain ExpoIapOnside. Rebuild with ios.onside.enabled instead of routing purchases through Apple StoreKit.',\n        );\n      }\n      try {\n        return {\n          module: requireNativeModule<NativeEventModule>('ExpoIapOnside'),\n          name: 'ExpoIapOnside',\n        };\n      } catch (error) {\n        if (!isMissingModuleError(error, 'ExpoIapOnside')) {\n          throw error;\n        }\n        onsideModuleUnavailable = true;\n        throw new UnavailabilityError(\n          'expo-iap',\n          'The Onside marketplace build does not contain ExpoIapOnside. Rebuild with ios.onside.enabled instead of routing purchases through Apple StoreKit.',\n        );\n      }\n    }\n\n    return {\n      module: requireNativeModule<NativeEventModule>('ExpoIap'),\n      name: 'ExpoIap',\n    };\n  }\n\n  const expectedName = getExpectedModuleName();\n  if (!cached || cached.name !== expectedName) {\n    cached = resolveNativeModule();\n  }\n  return cached;\n}\n\nfunction isMissingModuleError(error: unknown, moduleName: string): boolean {\n  if (error instanceof UnavailabilityError) {\n    return true;\n  }\n\n  if (error instanceof Error) {\n    return error.message.includes(`Cannot find native module '${moduleName}'`);\n  }\n\n  return false;\n}\n\nexport const NATIVE_ERROR_CODES: Record<string, unknown> = new Proxy(\n  {} as Record<string, unknown>,\n  {\n    get(target, prop) {\n      if (typeof prop === 'symbol') return Reflect.get(target, prop);\n      const errorCodes: Record<string, unknown> =\n        getResolved().module.ERROR_CODES || {};\n      return errorCodes[prop];\n    },\n  },\n);\n\n/**\n * Returns the raw native module, not the Proxy. Use it for addListener: a JSI\n * HostObject needs the real module as `this`, and a Proxy throws \"native state\n * unsupported on Proxy\" on New Architecture / Hermes.\n */\nexport function getNativeModule(): NativeEventModule {\n  return getResolved().module;\n}\n\n// The Proxy forwards every member to the lazily resolved store module.\nexport default new Proxy({} as ExpoIapNativeModule, {\n  get(target, prop) {\n    if (typeof prop === 'symbol') return Reflect.get(target, prop);\n    const resolved = getResolved();\n    if (prop === 'USING_ONSIDE_SDK') {\n      return resolved.name === 'ExpoIapOnside';\n    }\n    if (prop === 'USING_VEGA_SDK') {\n      return resolved.name === 'ExpoIapVega';\n    }\n\n    const value: unknown = Reflect.get(resolved.module, prop);\n    if (value !== undefined || resolved.name !== 'ExpoIapOnside') {\n      return value;\n    }\n\n    return () => {\n      throw new UnavailabilityError(\n        'expo-iap',\n        `The Onside marketplace does not support ${String(\n          prop,\n        )}. The call was not routed through Apple StoreKit.`,\n      );\n    };\n  },\n});\n"]}

package/build/index.d.ts

@@ -15,11 +15,7 @@ export declare enum OpenIapEvent {
      * developer billing flows. Nullable fields depend on the selected flow.
      */
     DeveloperProvidedBillingAndroid = "developer-provided-billing-android",
-    /**
-     * Fired when a subscription enters a billing-issue state (cross-platform).
-     * Unifies StoreKit 2 `Message.Reason.billingIssue` (iOS / Mac Catalyst 16.4+, visionOS 1.0+) and Play Billing 8.1+
-     * `Purchase.isSuspended`. NOT fired on the Meta Horizon flavor.
-     */
+    /** Fired when a subscription enters a billing-issue state; see `subscriptionBillingIssueListener`. */
     SubscriptionBillingIssue = "subscription-billing-issue"
 }
 type ExpoIapEventPayloads = {
@@ -104,8 +100,6 @@ export declare const userChoiceBillingListenerAndroid: (listener: (details: User
  * This fires when a user selects the developer's option in an External Payments
  * or Billing Choice purchase flow.
  *
- * Requires Google Play Billing Library 8.3.0+; Billing Choice fields require 9.1.0+.
- *
  * @param listener - Callback that receives selected products and flow details
  * @returns EventSubscription that can be used to unsubscribe
  *
@@ -122,7 +116,7 @@ export declare const userChoiceBillingListenerAndroid: (listener: (details: User
  * subscription.remove();
  * ```
  *
- * @platform Android (8.3.0+; Billing Choice 9.1.0+)
+ * @platform Android (Play Billing Library 8.3.0+; Billing Choice 9.1.0+)
  */
 export declare const developerProvidedBillingListenerAndroid: (listener: (details: DeveloperProvidedBillingDetailsAndroid) => void) => {
     remove: () => void;
@@ -134,7 +128,7 @@ export declare const developerProvidedBillingListenerAndroid: (listener: (detail
  * for a payment problem. Unifies:
  * - iOS / Mac Catalyst 16.4+ and visionOS 1.0+: StoreKit 2 `Message.Reason.billingIssue`.
  * - Android (Play Billing 8.1+): when `Purchase.isSuspendedAndroid === true`.
- * - Meta Horizon / iOS 17 / older platforms: never fires.
+ * - Meta Horizon, Amazon, macOS, tvOS, watchOS, and iOS before 16.4: never fires.
  *
  * Recommended UX: call `deepLinkToSubscriptions()` when this fires so the user
  * can update their payment method in the platform subscription center.
@@ -193,7 +187,7 @@ export declare const endConnection: MutationField<'endConnection'>;
  * @returns Promise resolving to a `FetchProductsResult` union — `Product[]` for `'in-app'`,
  *   `ProductSubscription[]` for `'subs'`, or a mixed array for `'all'`.
  * @throws When the store rejects the request (empty `skus`, not connected,
- *   network/store error). Unknown SKUs are simply omitted from the result, not thrown.
+ *   network/store error). Unknown SKUs are omitted from the result, not thrown.
  *
  * @example
  * ```ts
@@ -203,15 +197,14 @@ export declare const endConnection: MutationField<'endConnection'>;
  * });
  * ```
  *
- * @remarks This is a regular promise-based call. Don't confuse with `request*` APIs
- *   (`requestPurchase`), which are event-based.
+ * @remarks Promise-based, unlike the event-based `request*` APIs such as `requestPurchase`.
  *
  * @see {@link https://openiap.dev/docs/apis/fetch-products}
  */
 export declare const fetchProducts: QueryField<'fetchProducts'>;
 /**
- * List the user's unfinished purchases — non-consumables, active subscriptions, and any
- * pending transactions not yet finished.
+ * List the user's unfinished purchases: non-consumables, active subscriptions,
+ * and pending transactions.
  *
  * @param options Optional `PurchaseOptions`. iOS-only flags:
  *   `alsoPublishToEventListenerIOS`, `onlyIncludeActiveItemsIOS`.
@@ -230,13 +223,9 @@ export declare const fetchProducts: QueryField<'fetchProducts'>;
  */
 export declare const getAvailablePurchases: QueryField<'getAvailablePurchases'>;
 /**
- * Get all active subscriptions with detailed information.
- * Uses native OpenIAP module for accurate subscription status and renewal info.
- *
- * On iOS: Returns subscriptions with renewalInfoIOS containing pendingUpgradeProductId,
- * willAutoRenew, autoRenewPreference, and other renewal details.
- *
- * On Android: Filters available purchases to find active subscriptions (fallback implementation).
+ * Get all active subscriptions. On iOS each entry carries `renewalInfoIOS`
+ * (e.g. pendingUpgradeProductId, willAutoRenew, autoRenewPreference); on
+ * Android they are filtered from the available purchases.
  *
  * @param subscriptionIds - Optional array of subscription product IDs to filter. If not provided, returns all active subscriptions.
  * @returns Promise resolving to array of active subscriptions with details
@@ -285,14 +274,15 @@ export declare const hasActiveSubscriptions: QueryField<'hasActiveSubscriptions'
  */
 export declare const getStorefront: QueryField<'getStorefront'>;
 /**
- * Initiate a purchase or subscription flow. The result is delivered through
- * `purchaseUpdatedListener` — NOT the return value.
+ * Initiate a purchase or subscription flow. The result arrives through
+ * `purchaseUpdatedListener` / `purchaseErrorListener` (or `useIAP`'s
+ * `onPurchaseSuccess` / `onPurchaseError`), not the return value.
  *
  * @param args `RequestPurchaseProps`, discriminated by `type`:
  *   - `type: 'in-app'` — pass `request.apple.sku` (iOS) and/or `request.google.skus` (Android).
  *   - `type: 'subs'`  — same shape, plus `request.google.subscriptionOffers: [{ sku, offerToken }]`.
- * @returns The dispatched purchase payload. **Do not rely on it** for the actual outcome.
- * @throws Synchronous rejection from the store (e.g. `E_NOT_PREPARED`, validation failure).
+ * @returns The dispatched purchase payload; do not rely on it for the outcome.
+ * @throws Synchronous rejection from the store (e.g. `ErrorCode.NotPrepared`, validation failure).
  *
  * @example
  * ```ts
@@ -305,9 +295,6 @@ export declare const getStorefront: QueryField<'getStorefront'>;
  * });
  * ```
  *
- * @remarks Event-based. Listen for the result via {@link purchaseUpdatedListener} /
- *   {@link purchaseErrorListener}, or use `useIAP({ onPurchaseSuccess, onPurchaseError })`.
- *
  * @see {@link https://openiap.dev/docs/apis/request-purchase}
  */
 export declare const requestPurchase: MutationField<'requestPurchase'>;
@@ -329,21 +316,18 @@ export declare const requestPurchase: MutationField<'requestPurchase'>;
  * }
  * ```
  *
- * @remarks **Critical:** Android purchases must be finalized within 3 days or Google
+ * @remarks Android purchases must be finalized within 3 days or Google
  *   auto-refunds. iOS unfinished transactions replay on every app launch.
  *
  * @see {@link https://openiap.dev/docs/apis/finish-transaction}
  */
 export declare const finishTransaction: MutationField<'finishTransaction'>;
 /**
- * Restore completed transactions (cross-platform behavior)
- *
- * - iOS: perform a lightweight sync, or Onside restore when OnsideKit is active,
- *   then fetch available purchases to surface restored items to the app.
- * - Android: simply fetch available purchases (restoration happens via query).
+ * Restore completed transactions. Returns nothing; read the restored items with
+ * `getAvailablePurchases` or from hook state.
  *
- * This helper triggers the refresh flows but does not return the purchases; consumers should
- * call `getAvailablePurchases` or rely on hook state to inspect the latest items.
+ * - iOS: sync (or Onside restore when OnsideKit is active), then fetch available purchases.
+ * - Android: fetch available purchases; the query itself restores them.
  *
  * @see {@link https://openiap.dev/docs/apis/restore-purchases}
  */
@@ -383,10 +367,7 @@ export declare const deepLinkToSubscriptions: MutationField<'deepLinkToSubscript
  */
 export declare const openRedeemOfferCode: MutationField<'openRedeemOfferCode'>;
 /**
- * Verify purchase with the configured providers
- *
- * This function uses the native OpenIAP verifyPurchase implementation
- * which validates purchases using platform-specific methods.
+ * Verify purchase with the configured providers.
  *
  * @param options - Receipt validation options containing the SKU
  * @returns Promise resolving to receipt validation result
@@ -395,10 +376,7 @@ export declare const openRedeemOfferCode: MutationField<'openRedeemOfferCode'>;
  */
 export declare const verifyPurchase: MutationField<'verifyPurchase'>;
 /**
- * Verify purchase with a specific provider (e.g., IAPKit)
- *
- * This function allows you to verify purchases using external verification
- * services like IAPKit, which provide additional validation and security.
+ * Verify purchase with a specific provider (e.g., IAPKit).
  *
  * @param options - Verification options including provider and credentials
  * @returns Promise resolving to provider-specific verification result

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -10,13 +10,11 @@ import { restorePurchasesIOSNative } from './utils/restorePurchases';
 import { decodeAndroidPurchases, decodeApplePurchases, } from './utils/availablePurchases';
 import { ErrorCode } from './types';
 import { createPurchaseError, createPurchaseErrorFromNativeException, OPENIAP_ERROR_ENVELOPE_PREFIX, } from './utils/errorMapping';
-// Export all types
 export * from './types';
 export * from './modules/android';
 export * from './modules/ios';
 export * from './onside';
 export * from './vega';
-// Get the native constant value
 export var OpenIapEvent;
 (function (OpenIapEvent) {
     OpenIapEvent["PurchaseUpdated"] = "purchase-updated";
@@ -28,20 +26,14 @@ export var OpenIapEvent;
      * developer billing flows. Nullable fields depend on the selected flow.
      */
     OpenIapEvent["DeveloperProvidedBillingAndroid"] = "developer-provided-billing-android";
-    /**
-     * Fired when a subscription enters a billing-issue state (cross-platform).
-     * Unifies StoreKit 2 `Message.Reason.billingIssue` (iOS / Mac Catalyst 16.4+, visionOS 1.0+) and Play Billing 8.1+
-     * `Purchase.isSuspended`. NOT fired on the Meta Horizon flavor.
-     */
+    /** Fired when a subscription enters a billing-issue state; see `subscriptionBillingIssueListener`. */
     OpenIapEvent["SubscriptionBillingIssue"] = "subscription-billing-issue";
 })(OpenIapEvent || (OpenIapEvent = {}));
 const isStorePlatform = () => Platform.OS === 'ios' || Platform.OS === 'android';
 const isStoreRuntime = () => Platform.OS === 'ios' || isAndroidStoreRuntime();
 const unsupportedPlatformError = () => new Error(`Unsupported platform: ${Platform.OS}`);
-// Use the raw native module for listener calls — JSI HostObjects require the
-// real native module as `this` when calling addListener. Using a Proxy as
-// `this` triggers "native state unsupported on Proxy" on New Architecture / Hermes.
-// Resolved lazily so importing this module doesn't throw on unsupported platforms.
+// Listener calls go to the raw native module (see getNativeModule), resolved
+// lazily so importing this module doesn't throw on unsupported platforms.
 export const emitter = {
     addListener(eventName, listener) {
         const nativeModule = getNativeModule();
@@ -110,8 +102,7 @@ const resetPurchaseUpdatedDedupeHistoryIOS = () => {
 const configurePurchaseUpdatedListenerOptionsIOS = (dedupeTransactionIOS) => {
     if (Platform.OS !== 'ios')
         return;
-    const nativeModule = getNativeModule();
-    const promise = nativeModule.setPurchaseUpdatedListenerOptions?.({
+    const promise = getNativeModule().setPurchaseUpdatedListenerOptions?.({
         dedupeTransactionIOS,
     });
     void promise?.catch((error) => {
@@ -299,8 +290,6 @@ export const userChoiceBillingListenerAndroid = (listener) => {
  * This fires when a user selects the developer's option in an External Payments
  * or Billing Choice purchase flow.
  *
- * Requires Google Play Billing Library 8.3.0+; Billing Choice fields require 9.1.0+.
- *
  * @param listener - Callback that receives selected products and flow details
  * @returns EventSubscription that can be used to unsubscribe
  *
@@ -317,7 +306,7 @@ export const userChoiceBillingListenerAndroid = (listener) => {
  * subscription.remove();
  * ```
  *
- * @platform Android (8.3.0+; Billing Choice 9.1.0+)
+ * @platform Android (Play Billing Library 8.3.0+; Billing Choice 9.1.0+)
  */
 export const developerProvidedBillingListenerAndroid = (listener) => {
     if (Platform.OS !== 'android') {
@@ -333,7 +322,7 @@ export const developerProvidedBillingListenerAndroid = (listener) => {
  * for a payment problem. Unifies:
  * - iOS / Mac Catalyst 16.4+ and visionOS 1.0+: StoreKit 2 `Message.Reason.billingIssue`.
  * - Android (Play Billing 8.1+): when `Purchase.isSuspendedAndroid === true`.
- * - Meta Horizon / iOS 17 / older platforms: never fires.
+ * - Meta Horizon, Amazon, macOS, tvOS, watchOS, and iOS before 16.4: never fires.
  *
  * Recommended UX: call `deepLinkToSubscriptions()` when this fires so the user
  * can update their payment method in the platform subscription center.
@@ -435,7 +424,7 @@ const invokeNativeWithPurchaseError = async (operation, platform, fallback) => {
  * @returns Promise resolving to a `FetchProductsResult` union — `Product[]` for `'in-app'`,
  *   `ProductSubscription[]` for `'subs'`, or a mixed array for `'all'`.
  * @throws When the store rejects the request (empty `skus`, not connected,
- *   network/store error). Unknown SKUs are simply omitted from the result, not thrown.
+ *   network/store error). Unknown SKUs are omitted from the result, not thrown.
  *
  * @example
  * ```ts
@@ -445,8 +434,7 @@ const invokeNativeWithPurchaseError = async (operation, platform, fallback) => {
  * });
  * ```
  *
- * @remarks This is a regular promise-based call. Don't confuse with `request*` APIs
- *   (`requestPurchase`), which are event-based.
+ * @remarks Promise-based, unlike the event-based `request*` APIs such as `requestPurchase`.
  *
  * @see {@link https://openiap.dev/docs/apis/fetch-products}
  */
@@ -482,8 +470,7 @@ export const fetchProducts = async (request) => {
         if (canonical === 'subs') {
             return items;
         }
-        // For 'all' type, items contain both Product and ProductSubscription
-        // Return as ProductOrSubscription[] to preserve discriminated union
+        // 'all' mixes products and subscriptions; returned as-is to keep the discriminated union.
         return items;
     };
     if (Platform.OS === 'ios') {
@@ -507,8 +494,8 @@ export const fetchProducts = async (request) => {
     throw unsupportedPlatformError();
 };
 /**
- * List the user's unfinished purchases — non-consumables, active subscriptions, and any
- * pending transactions not yet finished.
+ * List the user's unfinished purchases: non-consumables, active subscriptions,
+ * and pending transactions.
  *
  * @param options Optional `PurchaseOptions`. iOS-only flags:
  *   `alsoPublishToEventListenerIOS`, `onlyIncludeActiveItemsIOS`.
@@ -550,13 +537,9 @@ export const getAvailablePurchases = async (options) => {
         : decodeAndroidPurchases(purchases);
 };
 /**
- * Get all active subscriptions with detailed information.
- * Uses native OpenIAP module for accurate subscription status and renewal info.
- *
- * On iOS: Returns subscriptions with renewalInfoIOS containing pendingUpgradeProductId,
- * willAutoRenew, autoRenewPreference, and other renewal details.
- *
- * On Android: Filters available purchases to find active subscriptions (fallback implementation).
+ * Get all active subscriptions. On iOS each entry carries `renewalInfoIOS`
+ * (e.g. pendingUpgradeProductId, willAutoRenew, autoRenewPreference); on
+ * Android they are filtered from the available purchases.
  *
  * @param subscriptionIds - Optional array of subscription product IDs to filter. If not provided, returns all active subscriptions.
  * @returns Promise resolving to array of active subscriptions with details
@@ -675,14 +658,15 @@ function validateAndroidPurchaseBranchOptions(request, type) {
     }
 }
 /**
- * Initiate a purchase or subscription flow. The result is delivered through
- * `purchaseUpdatedListener` — NOT the return value.
+ * Initiate a purchase or subscription flow. The result arrives through
+ * `purchaseUpdatedListener` / `purchaseErrorListener` (or `useIAP`'s
+ * `onPurchaseSuccess` / `onPurchaseError`), not the return value.
  *
  * @param args `RequestPurchaseProps`, discriminated by `type`:
  *   - `type: 'in-app'` — pass `request.apple.sku` (iOS) and/or `request.google.skus` (Android).
  *   - `type: 'subs'`  — same shape, plus `request.google.subscriptionOffers: [{ sku, offerToken }]`.
- * @returns The dispatched purchase payload. **Do not rely on it** for the actual outcome.
- * @throws Synchronous rejection from the store (e.g. `E_NOT_PREPARED`, validation failure).
+ * @returns The dispatched purchase payload; do not rely on it for the outcome.
+ * @throws Synchronous rejection from the store (e.g. `ErrorCode.NotPrepared`, validation failure).
  *
  * @example
  * ```ts
@@ -695,9 +679,6 @@ function validateAndroidPurchaseBranchOptions(request, type) {
  * });
  * ```
  *
- * @remarks Event-based. Listen for the result via {@link purchaseUpdatedListener} /
- *   {@link purchaseErrorListener}, or use `useIAP({ onPurchaseSuccess, onPurchaseError })`.
- *
  * @see {@link https://openiap.dev/docs/apis/request-purchase}
  */
 export const requestPurchase = async (args) => {
@@ -849,7 +830,7 @@ export const requestPurchase = async (args) => {
  * }
  * ```
  *
- * @remarks **Critical:** Android purchases must be finalized within 3 days or Google
+ * @remarks Android purchases must be finalized within 3 days or Google
  *   auto-refunds. iOS unfinished transactions replay on every app launch.
  *
  * @see {@link https://openiap.dev/docs/apis/finish-transaction}
@@ -879,14 +860,11 @@ export const finishTransaction = async ({ purchase, isConsumable = false, }) =>
     throw unsupportedPlatformError();
 };
 /**
- * Restore completed transactions (cross-platform behavior)
- *
- * - iOS: perform a lightweight sync, or Onside restore when OnsideKit is active,
- *   then fetch available purchases to surface restored items to the app.
- * - Android: simply fetch available purchases (restoration happens via query).
+ * Restore completed transactions. Returns nothing; read the restored items with
+ * `getAvailablePurchases` or from hook state.
  *
- * This helper triggers the refresh flows but does not return the purchases; consumers should
- * call `getAvailablePurchases` or rely on hook state to inspect the latest items.
+ * - iOS: sync (or Onside restore when OnsideKit is active), then fetch available purchases.
+ * - Android: fetch available purchases; the query itself restores them.
  *
  * @see {@link https://openiap.dev/docs/apis/restore-purchases}
  */
@@ -954,10 +932,7 @@ export const openRedeemOfferCode = async () => {
     throw unsupportedPlatformError();
 };
 /**
- * Verify purchase with the configured providers
- *
- * This function uses the native OpenIAP verifyPurchase implementation
- * which validates purchases using platform-specific methods.
+ * Verify purchase with the configured providers.
  *
  * @param options - Receipt validation options containing the SKU
  * @returns Promise resolving to receipt validation result
@@ -971,10 +946,7 @@ export const verifyPurchase = async (options) => {
     return ExpoIapModule.verifyPurchase(options);
 };
 /**
- * Verify purchase with a specific provider (e.g., IAPKit)
- *
- * This function allows you to verify purchases using external verification
- * services like IAPKit, which provide additional validation and security.
+ * Verify purchase with a specific provider (e.g., IAPKit).
  *
  * @param options - Verification options including provider and credentials
  * @returns Promise resolving to provider-specific verification result