expo-iap 3.0.3 → 3.0.4

package/src/ExpoIap.types.ts

@@ -1,444 +0,0 @@
-import type {
-  ProductAndroid,
-  PurchaseAndroid,
-  ProductSubscriptionAndroid,
-} from './types/ExpoIapAndroid.types';
-import type {
-  ProductIOS,
-  PurchaseIOS,
-  ProductSubscriptionIOS,
-} from './types/ExpoIapIOS.types';
-import {NATIVE_ERROR_CODES} from './ExpoIapModule';
-
-export type ChangeEventPayload = {
-  value: string;
-};
-
-export type ProductType = 'inapp' | 'subs';
-
-export enum PurchaseState {
-  Pending = 'pending',
-  Purchased = 'purchased',
-  Failed = 'failed',
-  Restored = 'restored',
-  Deferred = 'deferred',
-  Unknown = 'unknown',
-}
-
-// =============================================================================
-// COMMON TYPES (Base types shared across all platforms)
-// =============================================================================
-
-export type ProductCommon = {
-  id: string;
-  title: string;
-  description: string;
-  type: ProductType;
-  displayName?: string;
-  displayPrice: string;
-  currency: string;
-  price?: number;
-  debugDescription?: string;
-  platform?: string;
-};
-
-export type PurchaseCommon = {
-  id: string; // Transaction identifier - used by finishTransaction
-  productId: string; // Product identifier - which product was purchased
-  ids?: string[]; // Product identifiers for purchases that include multiple products
-  transactionId?: string; // Legacy identifier
-  transactionDate: number;
-  purchaseToken?: string; // Unified token (iOS: JWS, Android: purchaseToken)
-  platform?: string;
-  quantity?: number;
-  purchaseState?: PurchaseState;
-  isAutoRenewing?: boolean;
-};
-
-export type ProductSubscriptionCommon = ProductCommon & {
-  type: 'subs';
-};
-
-// Define literal platform types for better type discrimination
-export type IosPlatform = {platform: 'ios'};
-export type AndroidPlatform = {platform: 'android'};
-
-// Platform-agnostic unified product types (public API)
-export type Product =
-  | (ProductAndroid & AndroidPlatform)
-  | (ProductIOS & IosPlatform);
-
-export type ProductSubscription =
-  | (ProductSubscriptionAndroid & AndroidPlatform)
-  | (ProductSubscriptionIOS & IosPlatform);
-
-// Legacy naming retained for backward compatibility
-export type SubscriptionProduct = ProductSubscription;
-
-// Re-export all platform-specific types to avoid deep imports
-export * from './types/ExpoIapAndroid.types';
-export * from './types/ExpoIapIOS.types';
-
-// Unified purchase type for both products and subscriptions
-export type Purchase =
-  | (PurchaseAndroid & AndroidPlatform)
-  | (PurchaseIOS & IosPlatform);
-
-export type PurchaseResult = {
-  responseCode?: number;
-  debugMessage?: string;
-  code?: string;
-  message?: string;
-  purchaseToken?: string;
-};
-/**
- * Centralized error codes for expo-iap
- * These are mapped to platform-specific error codes and provide consistent error handling
- */
-export enum ErrorCode {
-  Unknown = 'E_UNKNOWN',
-  UserCancelled = 'E_USER_CANCELLED',
-  UserError = 'E_USER_ERROR',
-  ItemUnavailable = 'E_ITEM_UNAVAILABLE',
-  RemoteError = 'E_REMOTE_ERROR',
-  NetworkError = 'E_NETWORK_ERROR',
-  ServiceError = 'E_SERVICE_ERROR',
-  ReceiptFailed = 'E_RECEIPT_FAILED',
-  ReceiptFinished = 'E_RECEIPT_FINISHED',
-  ReceiptFinishedFailed = 'E_RECEIPT_FINISHED_FAILED',
-  NotPrepared = 'E_NOT_PREPARED',
-  NotEnded = 'E_NOT_ENDED',
-  AlreadyOwned = 'E_ALREADY_OWNED',
-  DeveloperError = 'E_DEVELOPER_ERROR',
-  BillingResponseJsonParseError = 'E_BILLING_RESPONSE_JSON_PARSE_ERROR',
-  DeferredPayment = 'E_DEFERRED_PAYMENT',
-  Interrupted = 'E_INTERRUPTED',
-  IapNotAvailable = 'E_IAP_NOT_AVAILABLE',
-  PurchaseError = 'E_PURCHASE_ERROR',
-  SyncError = 'E_SYNC_ERROR',
-  TransactionValidationFailed = 'E_TRANSACTION_VALIDATION_FAILED',
-  ActivityUnavailable = 'E_ACTIVITY_UNAVAILABLE',
-  AlreadyPrepared = 'E_ALREADY_PREPARED',
-  Pending = 'E_PENDING',
-  ConnectionClosed = 'E_CONNECTION_CLOSED',
-  // Additional detailed errors (Android-focused, kept cross-platform)
-  InitConnection = 'E_INIT_CONNECTION',
-  ServiceDisconnected = 'E_SERVICE_DISCONNECTED',
-  QueryProduct = 'E_QUERY_PRODUCT',
-  SkuNotFound = 'E_SKU_NOT_FOUND',
-  SkuOfferMismatch = 'E_SKU_OFFER_MISMATCH',
-  ItemNotOwned = 'E_ITEM_NOT_OWNED',
-  BillingUnavailable = 'E_BILLING_UNAVAILABLE',
-  FeatureNotSupported = 'E_FEATURE_NOT_SUPPORTED',
-  EmptySkuList = 'E_EMPTY_SKU_LIST',
-}
-
-// Fast lookup set for validating standardized error code strings
-const OPENIAP_ERROR_CODE_SET: Set<string> = new Set(
-  Object.values(ErrorCode) as string[],
-);
-
-/**
- * Platform-specific error code mappings
- * Maps ErrorCode enum values to platform-specific integer codes
- */
-// Shared OpenIAP string code mapping for both platforms
-const COMMON_ERROR_CODE_MAP = {
-  [ErrorCode.Unknown]: 'E_UNKNOWN',
-  [ErrorCode.UserCancelled]: 'E_USER_CANCELLED',
-  [ErrorCode.UserError]: 'E_USER_ERROR',
-  [ErrorCode.ItemUnavailable]: 'E_ITEM_UNAVAILABLE',
-  [ErrorCode.RemoteError]: 'E_REMOTE_ERROR',
-  [ErrorCode.NetworkError]: 'E_NETWORK_ERROR',
-  [ErrorCode.ServiceError]: 'E_SERVICE_ERROR',
-  [ErrorCode.ReceiptFailed]: 'E_RECEIPT_FAILED',
-  [ErrorCode.ReceiptFinished]: 'E_RECEIPT_FINISHED',
-  [ErrorCode.ReceiptFinishedFailed]: 'E_RECEIPT_FINISHED_FAILED',
-  [ErrorCode.NotPrepared]: 'E_NOT_PREPARED',
-  [ErrorCode.NotEnded]: 'E_NOT_ENDED',
-  [ErrorCode.AlreadyOwned]: 'E_ALREADY_OWNED',
-  [ErrorCode.DeveloperError]: 'E_DEVELOPER_ERROR',
-  [ErrorCode.BillingResponseJsonParseError]:
-    'E_BILLING_RESPONSE_JSON_PARSE_ERROR',
-  [ErrorCode.DeferredPayment]: 'E_DEFERRED_PAYMENT',
-  [ErrorCode.Interrupted]: 'E_INTERRUPTED',
-  [ErrorCode.IapNotAvailable]: 'E_IAP_NOT_AVAILABLE',
-  [ErrorCode.PurchaseError]: 'E_PURCHASE_ERROR',
-  [ErrorCode.SyncError]: 'E_SYNC_ERROR',
-  [ErrorCode.TransactionValidationFailed]: 'E_TRANSACTION_VALIDATION_FAILED',
-  [ErrorCode.ActivityUnavailable]: 'E_ACTIVITY_UNAVAILABLE',
-  [ErrorCode.AlreadyPrepared]: 'E_ALREADY_PREPARED',
-  [ErrorCode.Pending]: 'E_PENDING',
-  [ErrorCode.ConnectionClosed]: 'E_CONNECTION_CLOSED',
-  [ErrorCode.InitConnection]: 'E_INIT_CONNECTION',
-  [ErrorCode.ServiceDisconnected]: 'E_SERVICE_DISCONNECTED',
-  [ErrorCode.QueryProduct]: 'E_QUERY_PRODUCT',
-  [ErrorCode.SkuNotFound]: 'E_SKU_NOT_FOUND',
-  [ErrorCode.SkuOfferMismatch]: 'E_SKU_OFFER_MISMATCH',
-  [ErrorCode.ItemNotOwned]: 'E_ITEM_NOT_OWNED',
-  [ErrorCode.BillingUnavailable]: 'E_BILLING_UNAVAILABLE',
-  [ErrorCode.FeatureNotSupported]: 'E_FEATURE_NOT_SUPPORTED',
-  [ErrorCode.EmptySkuList]: 'E_EMPTY_SKU_LIST',
-} as const;
-
-export const ErrorCodeMapping = {
-  // iOS: standardized OpenIAP string codes
-  ios: COMMON_ERROR_CODE_MAP,
-  // Android: standardized OpenIAP string codes
-  android: COMMON_ERROR_CODE_MAP,
-} as const;
-
-export type PurchaseErrorProps = {
-  message: string;
-  responseCode?: number;
-  debugMessage?: string;
-  code?: ErrorCode;
-  productId?: string;
-  platform?: 'ios' | 'android';
-};
-
-export class PurchaseError implements Error {
-  public name: string;
-  public message: string;
-  public responseCode?: number;
-  public debugMessage?: string;
-  public code?: ErrorCode;
-  public productId?: string;
-  public platform?: 'ios' | 'android';
-
-  // Backwards-compatible constructor: accepts either props object or legacy positional args
-  constructor(messageOrProps: string | PurchaseErrorProps, ...rest: any[]) {
-    this.name = '[expo-iap]: PurchaseError';
-
-    if (typeof messageOrProps === 'string') {
-      // Legacy signature: (name, message, responseCode?, debugMessage?, code?, productId?, platform?)
-      // The first legacy argument was a name which we always override, so treat it as message here
-      const message = messageOrProps;
-      this.message = message;
-      this.responseCode = rest[0];
-      this.debugMessage = rest[1];
-      this.code = rest[2];
-      this.productId = rest[3];
-      this.platform = rest[4];
-    } else {
-      const props = messageOrProps;
-      this.message = props.message;
-      this.responseCode = props.responseCode;
-      this.debugMessage = props.debugMessage;
-      this.code = props.code;
-      this.productId = props.productId;
-      this.platform = props.platform;
-    }
-  }
-
-  /**
-   * Creates a PurchaseError from platform-specific error data
-   * @param errorData Raw error data from native modules
-   * @param platform Platform where the error occurred
-   * @returns Properly typed PurchaseError instance
-   */
-  static fromPlatformError(
-    errorData: any,
-    platform: 'ios' | 'android',
-  ): PurchaseError {
-    const errorCode = errorData.code
-      ? ErrorCodeUtils.fromPlatformCode(errorData.code, platform)
-      : ErrorCode.Unknown;
-
-    return new PurchaseError({
-      message: errorData.message || 'Unknown error occurred',
-      responseCode: errorData.responseCode,
-      debugMessage: errorData.debugMessage,
-      code: errorCode,
-      productId: errorData.productId,
-      platform,
-    });
-  }
-
-  /**
-   * Gets the platform-specific error code for this error
-   * @returns Platform-specific error code
-   */
-  getPlatformCode(): string | number | undefined {
-    if (!this.code || !this.platform) return undefined;
-    return ErrorCodeUtils.toPlatformCode(this.code, this.platform);
-  }
-}
-
-/**
- * Utility functions for error code mapping and validation
- */
-export const ErrorCodeUtils = {
-  /**
-   * Gets the native error code for the current platform
-   * @param errorCode ErrorCode enum value
-   * @returns Platform-specific error code from native constants
-   */
-  getNativeErrorCode: (errorCode: ErrorCode): string => {
-    return NATIVE_ERROR_CODES[errorCode] || errorCode;
-  },
-
-  /**
-   * Maps a platform-specific error code back to the standardized ErrorCode enum
-   * @param platformCode Platform-specific error code (string for Android, number for iOS)
-   * @param platform Target platform
-   * @returns Corresponding ErrorCode enum value or E_UNKNOWN if not found
-   */
-  fromPlatformCode: (
-    platformCode: string | number,
-    platform: 'ios' | 'android',
-  ): ErrorCode => {
-    // If native sent standardized string code, accept it directly
-    if (typeof platformCode === 'string' && platformCode.startsWith('E_')) {
-      if (OPENIAP_ERROR_CODE_SET.has(platformCode)) {
-        return platformCode as ErrorCode;
-      }
-    }
-    // Prefer dynamic native mapping for iOS to avoid drift
-    if (platform === 'ios') {
-      for (const [, value] of Object.entries(NATIVE_ERROR_CODES || {})) {
-        if (value === platformCode) {
-          // Native maps friendly keys to standardized 'E_*' codes
-          if (typeof value === 'string' && OPENIAP_ERROR_CODE_SET.has(value)) {
-            return value as ErrorCode;
-          }
-        }
-      }
-    }
-
-    const mapping = ErrorCodeMapping[platform];
-    for (const [errorCode, mappedCode] of Object.entries(mapping)) {
-      if (mappedCode === platformCode) {
-        return errorCode as ErrorCode;
-      }
-    }
-
-    return ErrorCode.Unknown;
-  },
-
-  /**
-   * Maps an ErrorCode enum to platform-specific code
-   * @param errorCode ErrorCode enum value
-   * @param platform Target platform
-   * @returns Platform-specific error code
-   */
-  toPlatformCode: (
-    errorCode: ErrorCode,
-    platform: 'ios' | 'android',
-  ): string | number => {
-    if (platform === 'ios') {
-      const native = (NATIVE_ERROR_CODES as any)?.[errorCode];
-      if (native !== undefined) return native;
-    }
-    const mapping = ErrorCodeMapping[platform] as Record<
-      ErrorCode,
-      string | number
-    >;
-    return mapping[errorCode] ?? 'E_UNKNOWN';
-  },
-
-  /**
-   * Checks if an error code is valid for the specified platform
-   * @param errorCode ErrorCode enum value
-   * @param platform Target platform
-   * @returns True if the error code is supported on the platform
-   */
-  isValidForPlatform: (
-    errorCode: ErrorCode,
-    platform: 'ios' | 'android',
-  ): boolean => {
-    return errorCode in ErrorCodeMapping[platform];
-  },
-};
-
-// ============================================================================
-// Enhanced Unified Request Types
-// ============================================================================
-
-/**
- * Unified request props that work on both iOS and Android platforms
- * iOS will use 'sku', Android will use 'skus' (or convert sku to skus array)
- */
-export interface UnifiedRequestPurchaseProps {
-  // Universal properties - works on both platforms
-  readonly sku?: string; // Single SKU (iOS native, Android fallback)
-  readonly skus?: string[]; // Multiple SKUs (Android native, iOS uses first item)
-
-  // iOS-specific properties (ignored on Android)
-  readonly andDangerouslyFinishTransactionAutomatically?: boolean;
-  readonly appAccountToken?: string;
-  readonly quantity?: number;
-  readonly withOffer?: import('./types/ExpoIapIOS.types').PaymentDiscount;
-
-  // Android-specific properties (ignored on iOS)
-  readonly obfuscatedAccountIdAndroid?: string;
-  readonly obfuscatedProfileIdAndroid?: string;
-  readonly isOfferPersonalized?: boolean;
-}
-
-// ============================================================================
-// New Platform-Specific Request Types (v2.7.0+)
-// ============================================================================
-
-/**
- * iOS-specific purchase request parameters
- */
-export interface RequestPurchaseIosProps {
-  readonly sku: string;
-  readonly andDangerouslyFinishTransactionAutomatically?: boolean;
-  readonly appAccountToken?: string;
-  readonly quantity?: number;
-  readonly withOffer?: import('./types/ExpoIapIOS.types').PaymentDiscount;
-}
-
-/**
- * Android-specific purchase request parameters
- */
-export interface RequestPurchaseAndroidProps {
-  readonly skus: string[];
-  readonly obfuscatedAccountIdAndroid?: string;
-  readonly obfuscatedProfileIdAndroid?: string;
-  readonly isOfferPersonalized?: boolean;
-}
-
-/**
- * Android-specific subscription request parameters
- */
-export interface RequestSubscriptionAndroidProps
-  extends RequestPurchaseAndroidProps {
-  readonly purchaseTokenAndroid?: string;
-  readonly replacementModeAndroid?: number;
-  readonly subscriptionOffers: {
-    sku: string;
-    offerToken: string;
-  }[];
-}
-
-/**
- * Modern platform-specific request structure (v2.7.0+)
- * Allows clear separation of iOS and Android parameters
- */
-export interface RequestPurchasePropsByPlatforms {
-  readonly ios?: RequestPurchaseIosProps;
-  readonly android?: RequestPurchaseAndroidProps;
-}
-
-/**
- * Modern platform-specific subscription request structure (v2.7.0+)
- */
-export interface RequestSubscriptionPropsByPlatforms {
-  readonly ios?: RequestPurchaseIosProps;
-  readonly android?: RequestSubscriptionAndroidProps;
-}
-
-/**
- * Modern request purchase parameters (v2.7.0+)
- * This is the recommended API moving forward
- */
-export type RequestPurchaseProps = RequestPurchasePropsByPlatforms;
-
-/**
- * Modern request subscription parameters (v2.7.0+)
- * This is the recommended API moving forward
- */
-export type RequestSubscriptionProps = RequestSubscriptionPropsByPlatforms;

package/src/types/ExpoIapAndroid.types.ts

@@ -1,133 +0,0 @@
-import {PurchaseCommon, ProductCommon} from '../ExpoIap.types';
-
-type ProductAndroidOneTimePurchaseOfferDetail = {
-  priceCurrencyCode: string;
-  formattedPrice: string;
-  priceAmountMicros: string;
-};
-
-type PricingPhaseAndroid = {
-  formattedPrice: string;
-  priceCurrencyCode: string;
-  // P1W, P1M, P1Y
-  billingPeriod: string;
-  billingCycleCount: number;
-  priceAmountMicros: string;
-  recurrenceMode: number;
-};
-
-type PricingPhasesAndroid = {
-  pricingPhaseList: PricingPhaseAndroid[];
-};
-
-type ProductSubscriptionAndroidOfferDetail = {
-  basePlanId: string;
-  offerId?: string | null;
-  offerToken: string;
-  offerTags: string[];
-  pricingPhases: PricingPhasesAndroid;
-};
-
-export type ProductAndroid = ProductCommon & {
-  nameAndroid: string;
-  oneTimePurchaseOfferDetailsAndroid?: ProductAndroidOneTimePurchaseOfferDetail;
-  platform: 'android';
-  subscriptionOfferDetailsAndroid?: ProductSubscriptionAndroidOfferDetail[];
-};
-
-type ProductSubscriptionAndroidOfferDetails = {
-  basePlanId: string;
-  offerId?: string | null;
-  offerToken: string;
-  pricingPhases: PricingPhasesAndroid;
-  offerTags: string[];
-};
-
-export type ProductSubscriptionAndroid = ProductAndroid & {
-  subscriptionOfferDetailsAndroid: ProductSubscriptionAndroidOfferDetails[];
-};
-
-export type RequestPurchaseAndroidProps = {
-  skus: string[];
-  obfuscatedAccountIdAndroid?: string;
-  obfuscatedProfileIdAndroid?: string;
-  isOfferPersonalized?: boolean; // For AndroidBilling V5 https://developer.android.com/google/play/billing/integrate#personalized-price
-};
-
-enum ReplacementModesAndroid {
-  UNKNOWN_REPLACEMENT_MODE = 0,
-  WITH_TIME_PRORATION = 1,
-  CHARGE_PRORATED_PRICE = 2,
-  WITHOUT_PRORATION = 3,
-  CHARGE_FULL_PRICE = 5,
-  DEFERRED = 6,
-}
-
-type SubscriptionOffer = {
-  sku: string;
-  offerToken: string;
-};
-
-export type RequestSubscriptionAndroidProps = RequestPurchaseAndroidProps & {
-  replacementModeAndroid?: ReplacementModesAndroid;
-  subscriptionOffers: SubscriptionOffer[];
-};
-
-export type ReceiptAndroid = {
-  autoRenewing: boolean;
-  betaProduct: boolean;
-  cancelDate: number | null;
-  cancelReason: string;
-  deferredDate: number | null;
-  deferredSku: number | null;
-  freeTrialEndDate: number;
-  gracePeriodEndDate: number;
-  parentProductId: string;
-  productId: string;
-  productType: string;
-  purchaseDate: number;
-  quantity: number;
-  receiptId: string;
-  renewalDate: number;
-  term: string;
-  termSku: string;
-  testTransaction: boolean;
-};
-
-export enum FeatureTypeAndroid {
-  /** Show in-app messages. Included in documentation by the annotations: */
-  IN_APP_MESSAGING = 'IN_APP_MESSAGING',
-  /** Launch a price change confirmation flow. */
-  PRICE_CHANGE_CONFIRMATION = 'PRICE_CHANGE_CONFIRMATION',
-  /** Play billing library support for querying and purchasing with ProductDetails. */
-  PRODUCT_DETAILS = 'PRODUCT_DETAILS',
-  /** Purchase/query for subscriptions. */
-  SUBSCRIPTIONS = 'SUBSCRIPTIONS',
-  /** Subscriptions update/replace. */
-  SUBSCRIPTIONS_UPDATE = 'SUBSCRIPTIONS_UPDATE',
-}
-
-export enum PurchaseAndroidState {
-  UNSPECIFIED_STATE = 0,
-  PURCHASED = 1,
-  PENDING = 2,
-}
-
-// Legacy naming for backward compatibility
-
-// Legacy naming for backward compatibility
-export type ProductPurchaseAndroid = PurchaseCommon & {
-  platform: 'android';
-  dataAndroid?: string;
-  signatureAndroid?: string;
-  autoRenewingAndroid?: boolean;
-  purchaseStateAndroid?: PurchaseAndroidState;
-  isAcknowledgedAndroid?: boolean;
-  packageNameAndroid?: string;
-  developerPayloadAndroid?: string;
-  obfuscatedAccountIdAndroid?: string;
-  obfuscatedProfileIdAndroid?: string;
-};
-
-// Preferred naming
-export type PurchaseAndroid = ProductPurchaseAndroid;