expo-iap 4.2.2 → 4.2.4

package/build/modules/ios.js.map

@@ -1 +1 @@
-{"version":3,"file":"ios.js","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"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","sourcesContent":["// External dependencies\n\n// Internal modules\n// import removed: use purchaseUpdatedListener directly in app code\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  ExternalPurchaseCustomLinkNoticeResultIOS,\n  ExternalPurchaseCustomLinkTokenResultIOS,\n  ExternalPurchaseCustomLinkTokenTypeIOS,\n  ExternalPurchaseCustomLinkNoticeTypeIOS,\n  ExternalPurchaseLinkResultIOS,\n  ExternalPurchaseNoticeResultIOS,\n  MutationField,\n  ProductIOS,\n  Purchase,\n  PurchaseIOS,\n  QueryField,\n  VerifyPurchaseProps,\n  VerifyPurchaseResultIOS,\n  SubscriptionStatusIOS,\n} from '../types';\nimport type {PurchaseError} from '../utils/errorMapping';\nimport {Linking} from 'react-native';\n\nexport type TransactionEvent = {\n  transaction?: Purchase;\n  error?: PurchaseError;\n};\n\n// Listeners\n\n// Type guards\nexport function isProductIOS<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'ios'} {\n  return (\n    item != null &&\n    typeof item === 'object' &&\n    'platform' in item &&\n    typeof (item as any).platform === 'string' &&\n    (item as any).platform.toLowerCase() === 'ios'\n  );\n}\n\n// Functions\n/**\n * Sync state with Appstore (iOS only)\n * https://developer.apple.com/documentation/storekit/appstore/3791906-sync\n *\n * @returns Promise resolving to null on success\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const syncIOS: MutationField<'syncIOS'> = async () => {\n  return !!(await ExpoIapModule.syncIOS());\n};\n\n/**\n * Check if user is eligible for introductory offer\n *\n * @param groupId - The subscription group ID\n * @returns Promise resolving to true if eligible\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const isEligibleForIntroOfferIOS: QueryField<\n  'isEligibleForIntroOfferIOS'\n> = async (groupId) => {\n  if (!groupId) {\n    throw new Error('isEligibleForIntroOfferIOS requires a groupId');\n  }\n  return ExpoIapModule.isEligibleForIntroOfferIOS(groupId);\n};\n\n/**\n * Get subscription status for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to array of subscription status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const subscriptionStatusIOS: QueryField<\n  'subscriptionStatusIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('subscriptionStatusIOS requires a SKU');\n  }\n  const status = await ExpoIapModule.subscriptionStatusIOS(sku);\n  return (status ?? []) as SubscriptionStatusIOS[];\n};\n\n/**\n * Get current entitlement for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to current entitlement\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const currentEntitlementIOS: QueryField<\n  'currentEntitlementIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('currentEntitlementIOS requires a SKU');\n  }\n  const purchase = await ExpoIapModule.currentEntitlementIOS(sku);\n  return (purchase ?? null) as PurchaseIOS | null;\n};\n\n/**\n * Get latest transaction for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to latest transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const latestTransactionIOS: QueryField<'latestTransactionIOS'> = async (\n  sku,\n) => {\n  if (!sku) {\n    throw new Error('latestTransactionIOS requires a SKU');\n  }\n  const transaction = await ExpoIapModule.latestTransactionIOS(sku);\n  return (transaction ?? null) as PurchaseIOS | null;\n};\n\n/**\n * Begin refund request for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to refund request status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const beginRefundRequestIOS: MutationField<\n  'beginRefundRequestIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('beginRefundRequestIOS requires a SKU');\n  }\n  const status = await ExpoIapModule.beginRefundRequestIOS(sku);\n  return status ?? null;\n};\n\n/**\n * Shows the system UI for managing subscriptions.\n * Returns an array of subscriptions that had status changes after the UI is closed.\n *\n * @returns Promise<Purchase[]> - Array of subscriptions with status changes (e.g., auto-renewal toggled)\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const showManageSubscriptionsIOS: MutationField<\n  'showManageSubscriptionsIOS'\n> = async () => {\n  const purchases = await ExpoIapModule.showManageSubscriptionsIOS();\n  return (purchases ?? []) as PurchaseIOS[];\n};\n\n/**\n * Get the receipt data from the iOS device.\n * This returns the base64 encoded receipt data which can be sent to your server\n * for verification with Apple's server.\n *\n * NOTE: For proper security, always verify receipts on your server using\n * Apple's verifyReceipt endpoint, not directly from the app.\n *\n * @returns {Promise<string>} Base64 encoded receipt data\n */\nexport const getReceiptDataIOS: QueryField<'getReceiptDataIOS'> = async () => {\n  return ExpoIapModule.getReceiptDataIOS();\n};\n\nexport const getReceiptIOS = getReceiptDataIOS;\n\n/**\n * Refresh the receipt data from Apple's servers and return the updated receipt.\n * This calls AppStore.sync() before reading the receipt, ensuring the latest\n * receipt data is available. Use this after a first purchase when\n * getReceiptDataIOS() may return an empty string because the receipt file\n * has not yet been written to disk.\n *\n * @returns {Promise<string>} Base64 encoded receipt data\n *\n * @platform iOS\n */\nexport const requestReceiptRefreshIOS = async (): Promise<string> => {\n  return ExpoIapModule.requestReceiptRefreshIOS();\n};\n\n/**\n * Check if a transaction is verified through StoreKit 2.\n * StoreKit 2 performs local verification of transaction JWS signatures.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to true if the transaction is verified\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const isTransactionVerifiedIOS: QueryField<\n  'isTransactionVerifiedIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('isTransactionVerifiedIOS requires a SKU');\n  }\n  return ExpoIapModule.isTransactionVerifiedIOS(sku);\n};\n\n/**\n * Get the JWS representation of a purchase for server-side verification.\n * The JWS (JSON Web Signature) can be verified on your server using Apple's public keys.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to JWS representation of the transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (\n  sku,\n) => {\n  if (!sku) {\n    throw new Error('getTransactionJwsIOS requires a SKU');\n  }\n  const jws = await ExpoIapModule.getTransactionJwsIOS(sku);\n  return jws ?? '';\n};\n\n/**\n * Validate receipt for iOS using StoreKit 2's built-in verification.\n * Returns receipt data and verification information to help with server-side validation.\n *\n * NOTE: For proper security, Apple recommends verifying receipts on your server using\n * the verifyReceipt endpoint rather than relying solely on client-side verification.\n *\n * @deprecated Use verifyPurchase instead\n * @param props The product's SKU or verification props\n * @returns {Promise<{\n *   isValid: boolean;\n *   receiptData: string;\n *   jwsRepresentation: string;\n *   latestTransaction?: Purchase;\n * }>}\n */\nconst validateReceiptIOSImpl = async (props: VerifyPurchaseProps | string) => {\n  const sku =\n    typeof props === 'string'\n      ? props\n      : (props as VerifyPurchaseProps)?.apple?.sku;\n\n  if (!sku) {\n    throw new Error('validateReceiptIOS requires a SKU (via apple.sku)');\n  }\n\n  return (await ExpoIapModule.validateReceiptIOS(\n    sku,\n  )) as VerifyPurchaseResultIOS;\n};\n\nexport const validateReceiptIOS =\n  validateReceiptIOSImpl as QueryField<'validateReceiptIOS'>;\n\n/**\n * Present the code redemption sheet for offer codes (iOS only).\n * This allows users to redeem promotional codes for in-app purchases and subscriptions.\n *\n * Note: This only works on real devices, not simulators.\n *\n * @returns Promise resolving to true if the sheet was presented successfully\n * @throws Error if called on non-iOS platform or tvOS\n *\n * @platform iOS\n */\nexport const presentCodeRedemptionSheetIOS: MutationField<\n  'presentCodeRedemptionSheetIOS'\n> = async () => {\n  return !!(await ExpoIapModule.presentCodeRedemptionSheetIOS());\n};\n\n/**\n * Get app transaction information (iOS 16.0+).\n * AppTransaction represents the initial purchase that unlocked the app.\n *\n * NOTE: This function requires:\n * - iOS 16.0 or later at runtime\n * - Xcode 15.0+ with iOS 16.0 SDK for compilation\n *\n * @returns Promise resolving to the app transaction information or null if not available\n * @throws Error if called on non-iOS platform, iOS version < 16.0, or compiled with older SDK\n *\n * @platform iOS\n * @since iOS 16.0\n */\nexport const getAppTransactionIOS: QueryField<\n  'getAppTransactionIOS'\n> = async () => {\n  return (await ExpoIapModule.getAppTransactionIOS()) ?? null;\n};\n\n/**\n * Get information about a promoted product if one is available (iOS only).\n * Promoted products are products that the App Store promotes on your behalf.\n * This is called after a promoted product event is received from the App Store.\n *\n * @returns Promise resolving to the promoted product information or null if none available\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n */\nexport const getPromotedProductIOS: QueryField<\n  'getPromotedProductIOS'\n> = async () => {\n  const product = await ExpoIapModule.getPromotedProductIOS();\n  return (product ?? null) as ProductIOS | null;\n};\n\n/**\n * Complete the purchase of a promoted product (iOS only).\n * This should be called after showing your purchase UI for a promoted product.\n *\n * @deprecated Use promotedProductListenerIOS to receive the productId,\n * then call requestPurchase with that SKU instead.\n *\n * @returns Promise resolving when the purchase is initiated\n * @throws Error if called on non-iOS platform or no promoted product is available\n *\n * @platform iOS\n */\nexport const requestPurchaseOnPromotedProductIOS =\n  async (): Promise<boolean> => {\n    const result = await ExpoIapModule.requestPurchaseOnPromotedProductIOS();\n    return result ?? true;\n  };\n\n/**\n * Get pending transactions that haven't been finished yet (iOS only).\n *\n * @returns Promise resolving to array of pending transactions\n * @platform iOS\n */\nexport const getPendingTransactionsIOS: QueryField<\n  'getPendingTransactionsIOS'\n> = async () => {\n  const transactions = await ExpoIapModule.getPendingTransactionsIOS();\n  return (transactions ?? []) as PurchaseIOS[];\n};\n\nexport const getAllTransactionsIOS: QueryField<\n  'getAllTransactionsIOS'\n> = async () => {\n  const transactions = await ExpoIapModule.getAllTransactionsIOS();\n  return (transactions ?? []) as PurchaseIOS[];\n};\n\n/**\n * Clear a specific transaction (iOS only).\n *\n * @returns Promise resolving when transaction is cleared\n * @platform iOS\n */\nexport const clearTransactionIOS: MutationField<\n  'clearTransactionIOS'\n> = async () => {\n  return !!(await ExpoIapModule.clearTransactionIOS());\n};\n\n/**\n * Deep link to subscriptions screen on iOS.\n * @returns {Promise<void>}\n *\n * @platform iOS\n */\nexport const deepLinkToSubscriptionsIOS = (): Promise<void> =>\n  Linking.openURL('https://apps.apple.com/account/subscriptions');\n\n/**\n * Check if the device can present an external purchase notice sheet (iOS 18.2+).\n *\n * @returns Promise resolving to true if the notice sheet can be presented\n * @platform iOS\n */\nexport const canPresentExternalPurchaseNoticeIOS: QueryField<\n  'canPresentExternalPurchaseNoticeIOS'\n> = async () => {\n  return !!(await ExpoIapModule.canPresentExternalPurchaseNoticeIOS());\n};\n\n/**\n * Present an external purchase notice sheet to inform users about external purchases (iOS 15.4+).\n * This must be called before opening an external purchase link.\n * Returns the external purchase token when user continues.\n *\n * @returns Promise resolving to the result with action, token, and error if any\n * @platform iOS\n */\nexport const presentExternalPurchaseNoticeSheetIOS =\n  async (): Promise<ExternalPurchaseNoticeResultIOS> => {\n    const result = await ExpoIapModule.presentExternalPurchaseNoticeSheetIOS();\n    return result as ExternalPurchaseNoticeResultIOS;\n  };\n\n/**\n * Present an external purchase link to redirect users to your website (iOS 16.0+).\n *\n * @param url - The external purchase URL to open\n * @returns Promise resolving to the result with success status and error if any\n * @platform iOS\n */\nexport const presentExternalPurchaseLinkIOS: MutationField<\n  'presentExternalPurchaseLinkIOS'\n> = async (url: string) => {\n  const result = await ExpoIapModule.presentExternalPurchaseLinkIOS(url);\n  return result as ExternalPurchaseLinkResultIOS;\n};\n\n/**\n * Check if app is eligible for ExternalPurchaseCustomLink API (iOS 18.1+).\n * Returns true if the app can use custom external purchase links.\n *\n * @returns Promise resolving to true if eligible\n * @platform iOS\n * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible\n */\nexport const isEligibleForExternalPurchaseCustomLinkIOS =\n  async (): Promise<boolean> => {\n    return !!(await ExpoIapModule.isEligibleForExternalPurchaseCustomLinkIOS());\n  };\n\n/**\n * Get external purchase token for reporting to Apple (iOS 18.1+).\n * Use this token with Apple's External Purchase Server API to report transactions.\n *\n * @param tokenType - Token type: 'acquisition' (new customers) or 'services' (existing customers)\n * @returns Promise resolving to the token result with token string or error\n * @platform iOS\n * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)\n */\nexport const getExternalPurchaseCustomLinkTokenIOS = async (\n  tokenType: ExternalPurchaseCustomLinkTokenTypeIOS,\n): Promise<ExternalPurchaseCustomLinkTokenResultIOS> => {\n  if (!tokenType) {\n    throw new Error(\n      \"getExternalPurchaseCustomLinkTokenIOS requires a tokenType ('acquisition' or 'services')\",\n    );\n  }\n  const result = await ExpoIapModule.getExternalPurchaseCustomLinkTokenIOS(\n    tokenType,\n  );\n  return result as ExternalPurchaseCustomLinkTokenResultIOS;\n};\n\n/**\n * Show ExternalPurchaseCustomLink notice sheet (iOS 18.1+).\n * Displays the system disclosure notice sheet for custom external purchase links.\n * Call this after a deliberate customer interaction before linking out to external purchases.\n *\n * @param noticeType - Notice type: 'browser' (external purchases displayed in browser)\n * @returns Promise resolving to the result with continued status and error if any\n * @platform iOS\n * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)\n */\nexport const showExternalPurchaseCustomLinkNoticeIOS = async (\n  noticeType: ExternalPurchaseCustomLinkNoticeTypeIOS,\n): Promise<ExternalPurchaseCustomLinkNoticeResultIOS> => {\n  if (!noticeType) {\n    throw new Error(\n      \"showExternalPurchaseCustomLinkNoticeIOS requires a noticeType ('browser')\",\n    );\n  }\n  const result = await ExpoIapModule.showExternalPurchaseCustomLinkNoticeIOS(\n    noticeType,\n  );\n  return result as ExternalPurchaseCustomLinkNoticeResultIOS;\n};\n\n// iOS-specific APIs only; cross-platform wrappers live in src/index.ts\n"]}
+{"version":3,"file":"ios.js","sourceRoot":"","sources":["../../src/modules/ios.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,mBAAmB;AACnB,mEAAmE;AACnE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAoB7C,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAOrC,YAAY;AAEZ,cAAc;AACd,MAAM,UAAU,YAAY,CAC1B,IAAa;IAEb,OAAO,CACL,IAAI,IAAI,IAAI;QACZ,OAAO,IAAI,KAAK,QAAQ;QACxB,UAAU,IAAI,IAAI;QAClB,OAAQ,IAAY,CAAC,QAAQ,KAAK,QAAQ;QACzC,IAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK,CAC/C,CAAC;AACJ,CAAC;AAED,YAAY;AACZ;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAA6B,KAAK,IAAI,EAAE;IAC1D,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAEnC,KAAK,EAAE,OAAO,EAAE,EAAE;IACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,aAAa,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAE9B,KAAK,EAAE,GAAG,EAAE,EAAE;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;AACnD,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAE9B,KAAK,EAAE,GAAG,EAAE,EAAE;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAuB,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAuC,KAAK,EAC3E,GAAG,EACH,EAAE;IACF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAClE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAuB,CAAC;AACrD,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAE9B,KAAK,EAAE,GAAG,EAAE,EAAE;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC9D,OAAO,MAAM,IAAI,IAAI,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAEnC,KAAK,IAAI,EAAE;IACb,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,0BAA0B,EAAE,CAAC;IACnE,OAAO,CAAC,SAAS,IAAI,EAAE,CAAkB,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAoC,KAAK,IAAI,EAAE;IAC3E,OAAO,aAAa,CAAC,iBAAiB,EAAE,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmC,KAAK,IAAI,EAAE;IACzE,OAAO,aAAa,CAAC,aAAa,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,IAAqB,EAAE;IAClE,OAAO,aAAa,CAAC,wBAAwB,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAEjC,KAAK,EAAE,GAAG,EAAE,EAAE;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,aAAa,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAuC,KAAK,EAC3E,GAAG,EACH,EAAE;IACF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1D,OAAO,GAAG,IAAI,EAAE,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,sBAAsB,GAAG,KAAK,EAAE,KAAmC,EAAE,EAAE;IAC3E,MAAM,GAAG,GACP,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAE,KAA6B,EAAE,KAAK,EAAE,GAAG,CAAC;IAEjD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,CAAC,MAAM,aAAa,CAAC,kBAAkB,CAC5C,GAAG,CACJ,CAA4B,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,sBAA0D,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAEtC,KAAK,IAAI,EAAE;IACb,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,6BAA6B,EAAE,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAE7B,KAAK,IAAI,EAAE;IACb,OAAO,CAAC,MAAM,aAAa,CAAC,oBAAoB,EAAE,CAAC,IAAI,IAAI,CAAC;AAC9D,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAE9B,KAAK,IAAI,EAAE;IACb,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,qBAAqB,EAAE,CAAC;IAC5D,OAAO,CAAC,OAAO,IAAI,IAAI,CAAsB,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAC9C,KAAK,IAAsB,EAAE;IAC3B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,mCAAmC,EAAE,CAAC;IACzE,OAAO,MAAM,IAAI,IAAI,CAAC;AACxB,CAAC,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAElC,KAAK,IAAI,EAAE;IACb,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,yBAAyB,EAAE,CAAC;IACrE,OAAO,CAAC,YAAY,IAAI,EAAE,CAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAE9B,KAAK,IAAI,EAAE;IACb,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,qBAAqB,EAAE,CAAC;IACjE,OAAO,CAAC,YAAY,IAAI,EAAE,CAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAE5B,KAAK,IAAI,EAAE;IACb,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,mBAAmB,EAAE,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAkB,EAAE,CAC5D,OAAO,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAE5C,KAAK,IAAI,EAAE;IACb,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,mCAAmC,EAAE,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAChD,KAAK,IAA8C,EAAE;IACnD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,qCAAqC,EAAE,CAAC;IAC3E,OAAO,MAAyC,CAAC;AACnD,CAAC,CAAC;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAEvC,KAAK,EAAE,GAAW,EAAE,EAAE;IACxB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAC;IACvE,OAAO,MAAuC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0CAA0C,GACrD,KAAK,IAAsB,EAAE;IAC3B,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,0CAA0C,EAAE,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,KAAK,EACxD,SAAiD,EACE,EAAE;IACrD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,qCAAqC,CACtE,SAAS,CACV,CAAC;IACF,OAAO,MAAkD,CAAC;AAC5D,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,KAAK,EAC1D,UAAmD,EACC,EAAE;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,uCAAuC,CACxE,UAAU,CACX,CAAC;IACF,OAAO,MAAmD,CAAC;AAC7D,CAAC,CAAC;AAEF,uEAAuE","sourcesContent":["// External dependencies\n\n// Internal modules\n// import removed: use purchaseUpdatedListener directly in app code\nimport ExpoIapModule from '../ExpoIapModule';\n\n// Types\nimport type {\n  ExternalPurchaseCustomLinkNoticeResultIOS,\n  ExternalPurchaseCustomLinkTokenResultIOS,\n  ExternalPurchaseCustomLinkTokenTypeIOS,\n  ExternalPurchaseCustomLinkNoticeTypeIOS,\n  ExternalPurchaseLinkResultIOS,\n  ExternalPurchaseNoticeResultIOS,\n  MutationField,\n  ProductIOS,\n  Purchase,\n  PurchaseIOS,\n  QueryField,\n  VerifyPurchaseProps,\n  VerifyPurchaseResultIOS,\n  SubscriptionStatusIOS,\n} from '../types';\nimport type {PurchaseError} from '../utils/errorMapping';\nimport {Linking} from 'react-native';\n\nexport type TransactionEvent = {\n  transaction?: Purchase;\n  error?: PurchaseError;\n};\n\n// Listeners\n\n// Type guards\nexport function isProductIOS<T extends {platform?: string}>(\n  item: unknown,\n): item is T & {platform: 'ios'} {\n  return (\n    item != null &&\n    typeof item === 'object' &&\n    'platform' in item &&\n    typeof (item as any).platform === 'string' &&\n    (item as any).platform.toLowerCase() === 'ios'\n  );\n}\n\n// Functions\n/**\n * Sync state with Appstore (iOS only)\n * https://developer.apple.com/documentation/storekit/appstore/3791906-sync\n *\n * @returns Promise resolving to null on success\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/sync-ios}\n */\nexport const syncIOS: MutationField<'syncIOS'> = async () => {\n  return !!(await ExpoIapModule.syncIOS());\n};\n\n/**\n * Check if user is eligible for introductory offer\n *\n * @param groupId - The subscription group ID\n * @returns Promise resolving to true if eligible\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios}\n */\nexport const isEligibleForIntroOfferIOS: QueryField<\n  'isEligibleForIntroOfferIOS'\n> = async (groupId) => {\n  if (!groupId) {\n    throw new Error('isEligibleForIntroOfferIOS requires a groupId');\n  }\n  return ExpoIapModule.isEligibleForIntroOfferIOS(groupId);\n};\n\n/**\n * Get subscription status for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to array of subscription status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/subscription-status-ios}\n */\nexport const subscriptionStatusIOS: QueryField<\n  'subscriptionStatusIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('subscriptionStatusIOS requires a SKU');\n  }\n  const status = await ExpoIapModule.subscriptionStatusIOS(sku);\n  return (status ?? []) as SubscriptionStatusIOS[];\n};\n\n/**\n * Get current entitlement for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to current entitlement\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/current-entitlement-ios}\n */\nexport const currentEntitlementIOS: QueryField<\n  'currentEntitlementIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('currentEntitlementIOS requires a SKU');\n  }\n  const purchase = await ExpoIapModule.currentEntitlementIOS(sku);\n  return (purchase ?? null) as PurchaseIOS | null;\n};\n\n/**\n * Get latest transaction for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to latest transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/latest-transaction-ios}\n */\nexport const latestTransactionIOS: QueryField<'latestTransactionIOS'> = async (\n  sku,\n) => {\n  if (!sku) {\n    throw new Error('latestTransactionIOS requires a SKU');\n  }\n  const transaction = await ExpoIapModule.latestTransactionIOS(sku);\n  return (transaction ?? null) as PurchaseIOS | null;\n};\n\n/**\n * Begin refund request for a specific SKU\n *\n * @param sku The product SKU\n * @returns Promise resolving to refund request status\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/begin-refund-request-ios}\n */\nexport const beginRefundRequestIOS: MutationField<\n  'beginRefundRequestIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('beginRefundRequestIOS requires a SKU');\n  }\n  const status = await ExpoIapModule.beginRefundRequestIOS(sku);\n  return status ?? null;\n};\n\n/**\n * Shows the system UI for managing subscriptions.\n * Returns an array of subscriptions that had status changes after the UI is closed.\n *\n * @returns Promise<Purchase[]> - Array of subscriptions with status changes (e.g., auto-renewal toggled)\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/show-manage-subscriptions-ios}\n */\nexport const showManageSubscriptionsIOS: MutationField<\n  'showManageSubscriptionsIOS'\n> = async () => {\n  const purchases = await ExpoIapModule.showManageSubscriptionsIOS();\n  return (purchases ?? []) as PurchaseIOS[];\n};\n\n/**\n * Get the receipt data from the iOS device.\n * This returns the base64 encoded receipt data which can be sent to your server\n * for verification with Apple's server.\n *\n * NOTE: For proper security, always verify receipts on your server using\n * Apple's verifyReceipt endpoint, not directly from the app.\n *\n * @returns {Promise<string>} Base64 encoded receipt data\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-receipt-data-ios}\n */\nexport const getReceiptDataIOS: QueryField<'getReceiptDataIOS'> = async () => {\n  return ExpoIapModule.getReceiptDataIOS();\n};\n\nexport const getReceiptIOS = getReceiptDataIOS;\n\n/**\n * Get the current App Store storefront country code on iOS.\n *\n * @deprecated Use cross-platform `getStorefront` from the main index instead.\n *   The native module exposes a single `getStorefront` AsyncFunction that already\n *   resolves to the iOS storefront on iOS. This helper is kept as an iOS-only\n *   alias so consumers who previously imported `getStorefrontIOS` do not break.\n *\n * @returns {Promise<string>} ISO 3166-1 alpha-2 country code (e.g. \"US\")\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-storefront-ios}\n */\nexport const getStorefrontIOS: QueryField<'getStorefrontIOS'> = async () => {\n  return ExpoIapModule.getStorefront();\n};\n\n/**\n * Refresh the receipt data from Apple's servers and return the updated receipt.\n * This calls AppStore.sync() before reading the receipt, ensuring the latest\n * receipt data is available. Use this after a first purchase when\n * getReceiptDataIOS() may return an empty string because the receipt file\n * has not yet been written to disk.\n *\n * @returns {Promise<string>} Base64 encoded receipt data\n *\n * @platform iOS\n */\nexport const requestReceiptRefreshIOS = async (): Promise<string> => {\n  return ExpoIapModule.requestReceiptRefreshIOS();\n};\n\n/**\n * Check if a transaction is verified through StoreKit 2.\n * StoreKit 2 performs local verification of transaction JWS signatures.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to true if the transaction is verified\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/is-transaction-verified-ios}\n */\nexport const isTransactionVerifiedIOS: QueryField<\n  'isTransactionVerifiedIOS'\n> = async (sku) => {\n  if (!sku) {\n    throw new Error('isTransactionVerifiedIOS requires a SKU');\n  }\n  return ExpoIapModule.isTransactionVerifiedIOS(sku);\n};\n\n/**\n * Get the JWS representation of a purchase for server-side verification.\n * The JWS (JSON Web Signature) can be verified on your server using Apple's public keys.\n *\n * @param sku The product's SKU (on iOS)\n * @returns Promise resolving to JWS representation of the transaction\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-transaction-jws-ios}\n */\nexport const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (\n  sku,\n) => {\n  if (!sku) {\n    throw new Error('getTransactionJwsIOS requires a SKU');\n  }\n  const jws = await ExpoIapModule.getTransactionJwsIOS(sku);\n  return jws ?? '';\n};\n\n/**\n * Validate receipt for iOS using StoreKit 2's built-in verification.\n * Returns receipt data and verification information to help with server-side validation.\n *\n * NOTE: For proper security, Apple recommends verifying receipts on your server using\n * the verifyReceipt endpoint rather than relying solely on client-side verification.\n *\n * @deprecated Use verifyPurchase instead\n * @param props The product's SKU or verification props\n * @returns {Promise<{\n *   isValid: boolean;\n *   receiptData: string;\n *   jwsRepresentation: string;\n *   latestTransaction?: Purchase;\n * }>}\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/validate-receipt-ios}\n */\nconst validateReceiptIOSImpl = async (props: VerifyPurchaseProps | string) => {\n  const sku =\n    typeof props === 'string'\n      ? props\n      : (props as VerifyPurchaseProps)?.apple?.sku;\n\n  if (!sku) {\n    throw new Error('validateReceiptIOS requires a SKU (via apple.sku)');\n  }\n\n  return (await ExpoIapModule.validateReceiptIOS(\n    sku,\n  )) as VerifyPurchaseResultIOS;\n};\n\nexport const validateReceiptIOS =\n  validateReceiptIOSImpl as QueryField<'validateReceiptIOS'>;\n\n/**\n * Present the code redemption sheet for offer codes (iOS only).\n * This allows users to redeem promotional codes for in-app purchases and subscriptions.\n *\n * Note: This only works on real devices, not simulators.\n *\n * @returns Promise resolving to true if the sheet was presented successfully\n * @throws Error if called on non-iOS platform or tvOS\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios}\n */\nexport const presentCodeRedemptionSheetIOS: MutationField<\n  'presentCodeRedemptionSheetIOS'\n> = async () => {\n  return !!(await ExpoIapModule.presentCodeRedemptionSheetIOS());\n};\n\n/**\n * Get app transaction information (iOS 16.0+).\n * AppTransaction represents the initial purchase that unlocked the app.\n *\n * NOTE: This function requires:\n * - iOS 16.0 or later at runtime\n * - Xcode 15.0+ with iOS 16.0 SDK for compilation\n *\n * @returns Promise resolving to the app transaction information or null if not available\n * @throws Error if called on non-iOS platform, iOS version < 16.0, or compiled with older SDK\n *\n * @platform iOS\n * @since iOS 16.0\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-app-transaction-ios}\n */\nexport const getAppTransactionIOS: QueryField<\n  'getAppTransactionIOS'\n> = async () => {\n  return (await ExpoIapModule.getAppTransactionIOS()) ?? null;\n};\n\n/**\n * Get information about a promoted product if one is available (iOS only).\n * Promoted products are products that the App Store promotes on your behalf.\n * This is called after a promoted product event is received from the App Store.\n *\n * @returns Promise resolving to the promoted product information or null if none available\n * @throws Error if called on non-iOS platform\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-promoted-product-ios}\n */\nexport const getPromotedProductIOS: QueryField<\n  'getPromotedProductIOS'\n> = async () => {\n  const product = await ExpoIapModule.getPromotedProductIOS();\n  return (product ?? null) as ProductIOS | null;\n};\n\n/**\n * Complete the purchase of a promoted product (iOS only).\n * This should be called after showing your purchase UI for a promoted product.\n *\n * @deprecated Use promotedProductListenerIOS to receive the productId,\n * then call requestPurchase with that SKU instead.\n *\n * @returns Promise resolving when the purchase is initiated\n * @throws Error if called on non-iOS platform or no promoted product is available\n *\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}\n */\nexport const requestPurchaseOnPromotedProductIOS =\n  async (): Promise<boolean> => {\n    const result = await ExpoIapModule.requestPurchaseOnPromotedProductIOS();\n    return result ?? true;\n  };\n\n/**\n * Get pending transactions that haven't been finished yet (iOS only).\n *\n * @returns Promise resolving to array of pending transactions\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-pending-transactions-ios}\n */\nexport const getPendingTransactionsIOS: QueryField<\n  'getPendingTransactionsIOS'\n> = async () => {\n  const transactions = await ExpoIapModule.getPendingTransactionsIOS();\n  return (transactions ?? []) as PurchaseIOS[];\n};\n\n/**\n * List every StoreKit transaction (finished + unfinished) for the current user.\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-all-transactions-ios}\n */\nexport const getAllTransactionsIOS: QueryField<\n  'getAllTransactionsIOS'\n> = async () => {\n  const transactions = await ExpoIapModule.getAllTransactionsIOS();\n  return (transactions ?? []) as PurchaseIOS[];\n};\n\n/**\n * Clear a specific transaction (iOS only).\n *\n * @returns Promise resolving when transaction is cleared\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/clear-transaction-ios}\n */\nexport const clearTransactionIOS: MutationField<\n  'clearTransactionIOS'\n> = async () => {\n  return !!(await ExpoIapModule.clearTransactionIOS());\n};\n\n/**\n * Deep link to subscriptions screen on iOS.\n * @returns {Promise<void>}\n *\n * @platform iOS\n */\nexport const deepLinkToSubscriptionsIOS = (): Promise<void> =>\n  Linking.openURL('https://apps.apple.com/account/subscriptions');\n\n/**\n * Check if the device can present an external purchase notice sheet (iOS 17.4+).\n *\n * Wraps `ExternalPurchase.canPresent`, which Apple introduced in iOS 17.4.\n * Note: the notice sheet itself (`presentExternalPurchaseNoticeSheetIOS`)\n * still requires iOS 18.2+; only the eligibility check is available earlier.\n *\n * @returns Promise resolving to true if the notice sheet can be presented\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios}\n */\nexport const canPresentExternalPurchaseNoticeIOS: QueryField<\n  'canPresentExternalPurchaseNoticeIOS'\n> = async () => {\n  return !!(await ExpoIapModule.canPresentExternalPurchaseNoticeIOS());\n};\n\n/**\n * Present an external purchase notice sheet to inform users about external purchases (iOS 15.4+).\n * This must be called before opening an external purchase link.\n * Returns the external purchase token when user continues.\n *\n * @returns Promise resolving to the result with action, token, and error if any\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}\n */\nexport const presentExternalPurchaseNoticeSheetIOS =\n  async (): Promise<ExternalPurchaseNoticeResultIOS> => {\n    const result = await ExpoIapModule.presentExternalPurchaseNoticeSheetIOS();\n    return result as ExternalPurchaseNoticeResultIOS;\n  };\n\n/**\n * Present an external purchase link to redirect users to your website (iOS 16.0+).\n *\n * @param url - The external purchase URL to open\n * @returns Promise resolving to the result with success status and error if any\n * @platform iOS\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/present-external-purchase-link-ios}\n */\nexport const presentExternalPurchaseLinkIOS: MutationField<\n  'presentExternalPurchaseLinkIOS'\n> = async (url: string) => {\n  const result = await ExpoIapModule.presentExternalPurchaseLinkIOS(url);\n  return result as ExternalPurchaseLinkResultIOS;\n};\n\n/**\n * Check if app is eligible for ExternalPurchaseCustomLink API (iOS 18.1+).\n * Returns true if the app can use custom external purchase links.\n *\n * @returns Promise resolving to true if eligible\n * @platform iOS\n * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}\n */\nexport const isEligibleForExternalPurchaseCustomLinkIOS =\n  async (): Promise<boolean> => {\n    return !!(await ExpoIapModule.isEligibleForExternalPurchaseCustomLinkIOS());\n  };\n\n/**\n * Get external purchase token for reporting to Apple (iOS 18.1+).\n * Use this token with Apple's External Purchase Server API to report transactions.\n *\n * @param tokenType - Token type: 'acquisition' (new customers) or 'services' (existing customers)\n * @returns Promise resolving to the token result with token string or error\n * @platform iOS\n * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}\n */\nexport const getExternalPurchaseCustomLinkTokenIOS = async (\n  tokenType: ExternalPurchaseCustomLinkTokenTypeIOS,\n): Promise<ExternalPurchaseCustomLinkTokenResultIOS> => {\n  if (!tokenType) {\n    throw new Error(\n      \"getExternalPurchaseCustomLinkTokenIOS requires a tokenType ('acquisition' or 'services')\",\n    );\n  }\n  const result = await ExpoIapModule.getExternalPurchaseCustomLinkTokenIOS(\n    tokenType,\n  );\n  return result as ExternalPurchaseCustomLinkTokenResultIOS;\n};\n\n/**\n * Show ExternalPurchaseCustomLink notice sheet (iOS 18.1+).\n * Displays the system disclosure notice sheet for custom external purchase links.\n * Call this after a deliberate customer interaction before linking out to external purchases.\n *\n * @param noticeType - Notice type: 'browser' (external purchases displayed in browser)\n * @returns Promise resolving to the result with continued status and error if any\n * @platform iOS\n * @see https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)\n *\n * @see {@link https://www.openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}\n */\nexport const showExternalPurchaseCustomLinkNoticeIOS = async (\n  noticeType: ExternalPurchaseCustomLinkNoticeTypeIOS,\n): Promise<ExternalPurchaseCustomLinkNoticeResultIOS> => {\n  if (!noticeType) {\n    throw new Error(\n      \"showExternalPurchaseCustomLinkNoticeIOS requires a noticeType ('browser')\",\n    );\n  }\n  const result = await ExpoIapModule.showExternalPurchaseCustomLinkNoticeIOS(\n    noticeType,\n  );\n  return result as ExternalPurchaseCustomLinkNoticeResultIOS;\n};\n\n// iOS-specific APIs only; cross-platform wrappers live in src/index.ts\n"]}

package/build/types.d.ts

@@ -535,118 +535,176 @@ export interface LimitedQuantityInfoAndroid {
     remainingQuantity: number;
 }
 export interface Mutation {
-    /** Acknowledge a non-consumable purchase or subscription */
+    /**
+     * Acknowledge a non-consumable purchase. Required within 3 days or Google auto-refunds.
+     * See: https://www.openiap.dev/docs/apis/android/acknowledge-purchase-android
+     */
     acknowledgePurchaseAndroid: Promise<boolean>;
-    /** Initiate a refund request for a product (iOS 15+) */
+    /**
+     * Present the refund request sheet (iOS 15+). See also Features → Refund.
+     * See: https://www.openiap.dev/docs/apis/ios/begin-refund-request-ios
+     */
     beginRefundRequestIOS?: Promise<(string | null)>;
     /**
-     * Check if alternative billing is available for this user/device
-     * Step 1 of alternative billing flow
+     * Check whether alternative billing is available for the user. Step 1 of the alternative billing flow.
      *
-     * Returns true if available, false otherwise
-     * Throws OpenIapError.NotPrepared if billing client not ready
+     * Returns true if available, false otherwise.
+     * Throws OpenIapError.NotPrepared if billing client not ready.
+     * See: https://www.openiap.dev/docs/apis/android/check-alternative-billing-availability-android
      */
     checkAlternativeBillingAvailabilityAndroid: Promise<boolean>;
-    /** Clear pending transactions from the StoreKit payment queue */
+    /**
+     * Clear pending transactions in the queue (sandbox helper).
+     * See: https://www.openiap.dev/docs/apis/ios/clear-transaction-ios
+     */
     clearTransactionIOS: Promise<boolean>;
-    /** Consume a purchase token so it can be repurchased */
+    /**
+     * Consume a consumable purchase so it can be re-bought.
+     * See: https://www.openiap.dev/docs/apis/android/consume-purchase-android
+     */
     consumePurchaseAndroid: Promise<boolean>;
     /**
-     * Create external transaction token for Google Play reporting
-     * Step 3 of alternative billing flow
-     * Must be called AFTER successful payment in your payment system
-     * Token must be reported to Google Play backend within 24 hours
+     * Create a reporting token for an alternative billing flow. Step 3 of the alternative billing flow.
+     * Must be called AFTER successful payment in your payment system.
+     * Token must be reported to Google Play backend within 24 hours.
      *
-     * Returns token string, or null if creation failed
-     * Throws OpenIapError.NotPrepared if billing client not ready
+     * Returns token string, or null if creation failed.
+     * Throws OpenIapError.NotPrepared if billing client not ready.
+     * See: https://www.openiap.dev/docs/apis/android/create-alternative-billing-token-android
      */
     createAlternativeBillingTokenAndroid?: Promise<(string | null)>;
     /**
-     * Create reporting details for a billing program
-     * Replaces the deprecated createExternalOfferReportingDetailsAsync API
+     * Create the reporting payload Google requires after a Developer-Provided Billing transaction (Play Billing 8.3.0+).
+     * Replaces the deprecated createExternalOfferReportingDetailsAsync API.
      *
-     * Available in Google Play Billing Library 8.2.0+
-     * Returns external transaction token needed for reporting external transactions
-     * Throws OpenIapError.NotPrepared if billing client not ready
+     * Returns external transaction token needed for reporting external transactions.
+     * Throws OpenIapError.NotPrepared if billing client not ready.
+     * See: https://www.openiap.dev/docs/apis/android/create-billing-program-reporting-details-android
      */
     createBillingProgramReportingDetailsAndroid: Promise<BillingProgramReportingDetailsAndroid>;
-    /** Open the native subscription management surface */
+    /**
+     * Open the platform's subscription management UI.
+     * See: https://www.openiap.dev/docs/apis/deep-link-to-subscriptions
+     */
     deepLinkToSubscriptions: Promise<void>;
-    /** Close the platform billing connection */
+    /**
+     * Close the store connection and release resources.
+     * See: https://www.openiap.dev/docs/apis/end-connection
+     */
     endConnection: Promise<boolean>;
-    /** Finish a transaction after validating receipts */
+    /**
+     * Complete a transaction after server-side verification. Required on Android within 3 days.
+     * See: https://www.openiap.dev/docs/apis/finish-transaction
+     */
     finishTransaction: Promise<void>;
-    /** Establish the platform billing connection */
+    /**
+     * Initialize the store connection. Call before any IAP API.
+     * See: https://www.openiap.dev/docs/apis/init-connection
+     */
     initConnection: Promise<boolean>;
     /**
-     * Check if a billing program is available for the current user
-     * Replaces the deprecated isExternalOfferAvailableAsync API
+     * Check whether a billing program (e.g., External Payments) is available for the current user.
+     * Replaces the deprecated isExternalOfferAvailableAsync API.
      *
-     * Available in Google Play Billing Library 8.2.0+
-     * Returns availability result with isAvailable flag
-     * Throws OpenIapError.NotPrepared if billing client not ready
+     * Available in Google Play Billing Library 8.2.0+.
+     * Returns availability result with isAvailable flag.
+     * Throws OpenIapError.NotPrepared if billing client not ready.
+     * See: https://www.openiap.dev/docs/apis/android/is-billing-program-available-android
      */
     isBillingProgramAvailableAndroid: Promise<BillingProgramAvailabilityResultAndroid>;
     /**
-     * Launch external link flow for external billing programs
-     * Replaces the deprecated showExternalOfferInformationDialog API
+     * Launch an external content/offer link from inside the Billing Programs flow (Play Billing 8.2.0+).
+     * Replaces the deprecated showExternalOfferInformationDialog API.
      *
-     * Available in Google Play Billing Library 8.2.0+
-     * Shows Play Store dialog and optionally launches external URL
-     * Throws OpenIapError.NotPrepared if billing client not ready
+     * Shows Play Store dialog and optionally launches external URL.
+     * Throws OpenIapError.NotPrepared if billing client not ready.
+     * See: https://www.openiap.dev/docs/apis/android/launch-external-link-android
      */
     launchExternalLinkAndroid: Promise<boolean>;
-    /** Present the App Store code redemption sheet */
+    /**
+     * Show the App Store offer code redemption sheet.
+     * See: https://www.openiap.dev/docs/apis/ios/present-code-redemption-sheet-ios
+     */
     presentCodeRedemptionSheetIOS: Promise<boolean>;
-    /** Present external purchase custom link with StoreKit UI */
+    /**
+     * Present an external purchase link, StoreKit External (iOS 16+).
+     * See: https://www.openiap.dev/docs/apis/ios/present-external-purchase-link-ios
+     */
     presentExternalPurchaseLinkIOS: Promise<ExternalPurchaseLinkResultIOS>;
     /**
-     * Present external purchase notice sheet (iOS 17.4+).
-     * Uses ExternalPurchase.presentNoticeSheet() which returns a token when user continues.
+     * Present the external purchase notice sheet (iOS 17.4+).
+     * Uses ExternalPurchase.presentNoticeSheet() which returns a token when the user continues.
      * Reference: https://developer.apple.com/documentation/storekit/externalpurchase/presentnoticesheet()
+     * See: https://www.openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios
      */
     presentExternalPurchaseNoticeSheetIOS: Promise<ExternalPurchaseNoticeResultIOS>;
-    /** Initiate a purchase flow; rely on events for final state */
+    /**
+     * Initiate a purchase or subscription flow; rely on events for final state.
+     * See: https://www.openiap.dev/docs/apis/request-purchase
+     */
     requestPurchase?: Promise<(Purchase | Purchase[] | null)>;
     /**
-     * Purchase the promoted product surfaced by the App Store.
+     * Buy the currently promoted product.
      *
      * @deprecated Use promotedProductListenerIOS to receive the productId,
      * then call requestPurchase with that SKU instead. In StoreKit 2,
      * promoted products can be purchased directly via the standard purchase flow.
+     * See: https://www.openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios
      * @deprecated Use promotedProductListenerIOS + requestPurchase instead
      */
     requestPurchaseOnPromotedProductIOS: Promise<boolean>;
-    /** Restore completed purchases across platforms */
+    /**
+     * Restore non-consumable and active subscription purchases.
+     * See: https://www.openiap.dev/docs/apis/restore-purchases
+     */
     restorePurchases: Promise<void>;
     /**
-     * Show alternative billing information dialog to user
-     * Step 2 of alternative billing flow
-     * Must be called BEFORE processing payment in your payment system
+     * Display Google's alternative billing information dialog. Step 2 of the alternative billing flow.
+     * Must be called BEFORE processing payment in your payment system.
      *
-     * Returns true if user accepted, false if user canceled
-     * Throws OpenIapError.NotPrepared if billing client not ready
+     * Returns true if user accepted, false if user canceled.
+     * Throws OpenIapError.NotPrepared if billing client not ready.
+     * See: https://www.openiap.dev/docs/apis/android/show-alternative-billing-dialog-android
      */
     showAlternativeBillingDialogAndroid: Promise<boolean>;
     /**
-     * Show ExternalPurchaseCustomLink notice sheet (iOS 18.1+).
-     * Displays the system disclosure notice sheet for custom external purchase links.
+     * Present the disclosure sheet required before linking out via ExternalPurchaseCustomLink (iOS 18.1+).
      * Call this after a deliberate customer interaction before linking out to external purchases.
      * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/shownotice(type:)
+     * See: https://www.openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios
      */
     showExternalPurchaseCustomLinkNoticeIOS: Promise<ExternalPurchaseCustomLinkNoticeResultIOS>;
-    /** Open subscription management UI and return changed purchases (iOS 15+) */
+    /**
+     * Present the manage-subscriptions sheet and return changed purchases (iOS 15+).
+     * See: https://www.openiap.dev/docs/apis/ios/show-manage-subscriptions-ios
+     */
     showManageSubscriptionsIOS: Promise<PurchaseIOS[]>;
-    /** Force a StoreKit sync for transactions (iOS 15+) */
+    /**
+     * Force sync transactions with the App Store (iOS 15+).
+     * See: https://www.openiap.dev/docs/apis/ios/sync-ios
+     */
     syncIOS: Promise<boolean>;
     /**
-     * Validate purchase receipts with the configured providers
+     * Deprecated. Validate purchase receipts with the configured providers — use verifyPurchase instead.
+     * See: https://www.openiap.dev/docs/features/validation#verify-purchase
      * @deprecated Use verifyPurchase
      */
     validateReceipt: Promise<VerifyPurchaseResult>;
-    /** Verify purchases with the configured providers */
+    /**
+     * Verify a purchase against your own backend. Returns a platform-specific
+     * variant of VerifyPurchaseResult — VerifyPurchaseResultIOS exposes isValid
+     * + receipt/JWS metadata, VerifyPurchaseResultAndroid carries Play Store
+     * receipt fields (no isValid), and VerifyPurchaseResultHorizon uses success.
+     * Inspect the concrete variant before reading fields.
+     * See: https://www.openiap.dev/docs/features/validation#verify-purchase
+     */
     verifyPurchase: Promise<VerifyPurchaseResult>;
-    /** Verify purchases with a specific provider (e.g., IAPKit) */
+    /**
+     * Verify via a managed provider without standing up your own server. The
+     * PurchaseVerificationProvider enum currently exposes only IAPKit; platform
+     * availability may differ by implementation.
+     * See: https://www.openiap.dev/docs/features/validation#verify-purchase-with-provider
+     */
     verifyPurchaseWithProvider: Promise<VerifyPurchaseWithProviderResult>;
 }
 export type MutationAcknowledgePurchaseAndroidArgs = string;
@@ -1130,66 +1188,117 @@ export type PurchaseState = 'pending' | 'purchased' | 'unknown';
 export type PurchaseVerificationProvider = 'iapkit';
 export interface Query {
     /**
-     * Check if external purchase notice sheet can be presented (iOS 17.4+)
-     * Uses ExternalPurchase.canPresent
+     * Check eligibility for the external purchase notice sheet (iOS 17.4+).
+     * Uses ExternalPurchase.canPresent.
+     * See: https://www.openiap.dev/docs/apis/ios/can-present-external-purchase-notice-ios
      */
     canPresentExternalPurchaseNoticeIOS: Promise<boolean>;
-    /** Get current StoreKit 2 entitlements (iOS 15+) */
+    /**
+     * Get the user's current entitlement for a product, using StoreKit 2 (iOS 15+).
+     * See: https://www.openiap.dev/docs/apis/ios/current-entitlement-ios
+     */
     currentEntitlementIOS?: Promise<(PurchaseIOS | null)>;
-    /** Retrieve products or subscriptions from the store */
+    /**
+     * Fetch products or subscriptions from the store.
+     * See: https://www.openiap.dev/docs/apis/fetch-products
+     */
     fetchProducts: Promise<(ProductOrSubscription[] | Product[] | ProductSubscription[] | null)>;
-    /** Get active subscriptions (filters by subscriptionIds when provided) */
+    /**
+     * Get details of all currently active subscriptions (filters by subscriptionIds when provided).
+     * See: https://www.openiap.dev/docs/apis/get-active-subscriptions
+     */
     getActiveSubscriptions: Promise<ActiveSubscription[]>;
     /**
-     * Get the full StoreKit 2 transaction history as PurchaseIOS values.
+     * List every StoreKit transaction (finished + unfinished) for the current user.
      * Requires the SK2ConsumableTransactionHistory Info.plist key in the host app
      * for finished consumables to be included (iOS 18+).
      * Unlike getAvailablePurchases, always returns the iOS-specific PurchaseIOS shape.
+     * See: https://www.openiap.dev/docs/apis/ios/get-all-transactions-ios
      */
     getAllTransactionsIOS: Promise<PurchaseIOS[]>;
-    /** Fetch the current app transaction (iOS 16+) */
+    /**
+     * Fetch the app transaction (iOS 16+).
+     * See: https://www.openiap.dev/docs/apis/ios/get-app-transaction-ios
+     */
     getAppTransactionIOS?: Promise<(AppTransaction | null)>;
-    /** Get all available purchases for the current user */
+    /**
+     * List active purchases for the current user.
+     * See: https://www.openiap.dev/docs/apis/get-available-purchases
+     */
     getAvailablePurchases: Promise<Purchase[]>;
     /**
-     * Get external purchase token for reporting to Apple (iOS 18.1+).
-     * Use this token with Apple's External Purchase Server API to report transactions.
+     * Fetch a token for Apple's External Purchase Server reporting API (iOS 18.1+).
+     * Use this token to report transactions made through ExternalPurchaseCustomLink.
      * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/token(for:)
+     * See: https://www.openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios
      */
     getExternalPurchaseCustomLinkTokenIOS: Promise<ExternalPurchaseCustomLinkTokenResultIOS>;
-    /** Retrieve all pending transactions in the StoreKit queue */
+    /**
+     * List unfinished StoreKit transactions in the queue.
+     * See: https://www.openiap.dev/docs/apis/ios/get-pending-transactions-ios
+     */
     getPendingTransactionsIOS: Promise<PurchaseIOS[]>;
-    /** Get the currently promoted product (iOS 11+) */
+    /**
+     * Read the App Store-promoted product, if any (iOS 11+).
+     * See: https://www.openiap.dev/docs/apis/ios/get-promoted-product-ios
+     */
     getPromotedProductIOS?: Promise<(ProductIOS | null)>;
-    /** Get base64-encoded receipt data for validation */
+    /**
+     * Get base64-encoded receipt data (legacy validation).
+     * See: https://www.openiap.dev/docs/apis/ios/get-receipt-data-ios
+     */
     getReceiptDataIOS?: Promise<(string | null)>;
-    /** Get the current storefront country code */
+    /**
+     * Return the user's storefront country code.
+     * See: https://www.openiap.dev/docs/apis/get-storefront
+     */
     getStorefront: Promise<string>;
     /**
-     * Get the current App Store storefront country code
+     * Deprecated. Get the current App Store storefront country code — use cross-platform getStorefront instead.
+     * See: https://www.openiap.dev/docs/apis/ios/get-storefront-ios
      * @deprecated Use getStorefront
      */
     getStorefrontIOS: Promise<string>;
-    /** Get the transaction JWS (StoreKit 2) */
+    /**
+     * Return the JWS string for a transaction (StoreKit 2).
+     * See: https://www.openiap.dev/docs/apis/ios/get-transaction-jws-ios
+     */
     getTransactionJwsIOS?: Promise<(string | null)>;
-    /** Check whether the user has active subscriptions */
+    /**
+     * Check whether the user has any active subscription.
+     * See: https://www.openiap.dev/docs/apis/has-active-subscriptions
+     */
     hasActiveSubscriptions: Promise<boolean>;
     /**
-     * Check if app is eligible for ExternalPurchaseCustomLink API (iOS 18.1+).
+     * Check eligibility for the custom-link variant of external purchase (iOS 18.1+).
      * Returns true if the app can use custom external purchase links.
      * Reference: https://developer.apple.com/documentation/storekit/externalpurchasecustomlink/iseligible
+     * See: https://www.openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios
      */
     isEligibleForExternalPurchaseCustomLinkIOS: Promise<boolean>;
-    /** Check introductory offer eligibility for a subscription group */
+    /**
+     * Check intro-offer eligibility for a subscription group.
+     * See: https://www.openiap.dev/docs/apis/ios/is-eligible-for-intro-offer-ios
+     */
     isEligibleForIntroOfferIOS: Promise<boolean>;
-    /** Verify a StoreKit 2 transaction signature */
+    /**
+     * Check whether a transaction's JWS verification passed (StoreKit 2).
+     * See: https://www.openiap.dev/docs/apis/ios/is-transaction-verified-ios
+     */
     isTransactionVerifiedIOS: Promise<boolean>;
-    /** Get the latest transaction for a product using StoreKit 2 */
+    /**
+     * Get the latest verified transaction for a product, using StoreKit 2.
+     * See: https://www.openiap.dev/docs/apis/ios/latest-transaction-ios
+     */
     latestTransactionIOS?: Promise<(PurchaseIOS | null)>;
-    /** Get StoreKit 2 subscription status details (iOS 15+) */
+    /**
+     * Get subscription status objects from StoreKit 2 (iOS 15+).
+     * See: https://www.openiap.dev/docs/apis/ios/subscription-status-ios
+     */
     subscriptionStatusIOS: Promise<SubscriptionStatusIOS[]>;
     /**
-     * Validate a receipt for a specific product
+     * Deprecated. Legacy App Store receipt validation — use verifyPurchase instead.
+     * See: https://www.openiap.dev/docs/apis/ios/validate-receipt-ios
      * @deprecated Use verifyPurchase
      */
     validateReceiptIOS: Promise<VerifyPurchaseResultIOS>;
@@ -1638,6 +1747,7 @@ export interface SubscriptionProductReplacementParamsAndroid {
  * Available in Google Play Billing Library 8.1.0+
  */
 export type SubscriptionReplacementModeAndroid = 'unknown-replacement-mode' | 'with-time-proration' | 'charge-prorated-price' | 'charge-full-price' | 'without-proration' | 'deferred' | 'keep-existing';
+export type SubscriptionState = 'active' | 'expired' | 'in-billing-retry' | 'in-grace-period' | 'paused' | 'refunded' | 'revoked' | 'unknown';
 export interface SubscriptionStatusIOS {
     renewalInfo?: (RenewalInfoIOS | null);
     state: string;
@@ -1784,6 +1894,62 @@ export interface VerifyPurchaseWithProviderResult {
     provider: PurchaseVerificationProvider;
 }
 export type VoidResult = void;
+export type WebhookCancellationReason = 'billing-error' | 'other' | 'price-increase-declined' | 'product-unavailable' | 'refunded' | 'user-canceled';
+export interface WebhookEvent {
+    /** Reason for cancellation, when applicable. */
+    cancellationReason?: (WebhookCancellationReason | null);
+    /** Localized currency code (ISO 4217) at event time, when available. */
+    currency?: (string | null);
+    environment: WebhookEventEnvironment;
+    /** When the current subscription period ends. Epoch milliseconds. */
+    expiresAt?: (number | null);
+    /**
+     * Stable identifier suitable for idempotency. Derived from the source notification
+     * UUID where the store provides one (ASN v2 `notificationUUID`, RTDN message id);
+     * otherwise hashed from the canonicalized payload.
+     */
+    id: string;
+    /** Time the underlying event occurred at the store. Epoch milliseconds. */
+    occurredAt: number;
+    platform: IapPlatform;
+    /**
+     * Price in micros (1/1,000,000 of the currency unit) at event time, when available.
+     * Matches Google Play's `priceAmountMicros` convention; iOS values are converted.
+     */
+    priceAmountMicros?: (number | null);
+    /** Product the event pertains to. May be null for account-level events. */
+    productId?: (string | null);
+    /** kit project that owns the subscription / purchase this event refers to. */
+    projectId: string;
+    /**
+     * Cross-platform purchase identity used to correlate this event with an existing
+     * purchase record. iOS: `originalTransactionId`. Android: `purchaseToken`.
+     * Null for `TestNotification` events (Apple ASN v2 / Google RTDN test
+     * payloads carry no transaction); always present for every other event type.
+     */
+    purchaseToken?: (string | null);
+    /**
+     * Original signed payload from the store. ASN v2 events expose the JWS string;
+     * RTDN events expose the base64-decoded Pub/Sub message JSON. Provided so that
+     * consumers can independently verify or extract platform-specific fields. kit
+     * always validates this payload before emitting the event.
+     */
+    rawSignedPayload?: (string | null);
+    /** Time kit ingested and normalized this event. Epoch milliseconds. */
+    receivedAt: number;
+    /** When auto-renewal will charge again. Epoch milliseconds. */
+    renewsAt?: (number | null);
+    source: WebhookEventSource;
+    /**
+     * Normalized subscription state at the time of event, when the event refers to
+     * a subscription. Null for one-time purchase events.
+     */
+    subscriptionState?: (SubscriptionState | null);
+    type: WebhookEventType;
+}
+export type WebhookEventEnvironment = 'production' | 'sandbox' | 'xcode';
+export type WebhookEventSource = 'apple-app-store-server-notifications-v2' | 'google-play-real-time-developer-notifications' | 'meta-horizon-reconciler';
+export type WebhookEventType = 'purchase-consumption-request' | 'purchase-refunded' | 'subscription-canceled' | 'subscription-expired' | 'subscription-in-billing-retry' | 'subscription-in-grace-period' | 'subscription-paused' | 'subscription-price-change' | 'subscription-product-changed' | 'subscription-recovered' | 'subscription-renewed' | 'subscription-resumed' | 'subscription-revoked' | 'subscription-started' | 'subscription-uncanceled' | 'test-notification';
 /**
  * Win-back offer input for iOS 18+ (StoreKit 2)
  * Win-back offers are used to re-engage churned subscribers.