react-native-iap 14.3.2 → 14.3.3

package/src/utils/type-bridge.ts

@@ -1,10 +1,8 @@
 /**
  * Type Bridge Utilities
  *
- * This file provides conversion utilities between Nitro types (simple primitives)
- * and TypeScript union types (complex types.ts definitions).
- *
- * Purpose: Prevent type fragmentation between native (Nitro) and TypeScript sides
+ * Converts the loose Nitro shapes coming from native into the strongly typed
+ * structures that our generated TypeScript types expect.
  */
 
 import type {
@@ -12,258 +10,367 @@ import type {
   NitroPurchase,
   NitroSubscriptionStatus,
 } from '../specs/RnIap.nitro';
+import {
+  Platform as IapPlatform,
+  PaymentModeIOS,
+  ProductType,
+  ProductTypeIOS,
+  PurchaseState,
+  SubscriptionPeriodIOS,
+} from '../types';
 import type {
   Product,
+  ProductSubscription,
   Purchase,
-  SubscriptionProduct,
   SubscriptionStatusIOS,
 } from '../types';
-import {PurchaseState, ProductTypeIOS} from '../types';
-import {Platform} from 'react-native';
 
-// ============================================================================
-// PRODUCT CONVERSION
-// ============================================================================
+const PLATFORM_IOS = 'ios';
+const PRODUCT_TYPE_SUBS = 'subs';
+const PURCHASE_STATE_DEFERRED = 'deferred';
+const PURCHASE_STATE_FAILED = 'failed';
+const PURCHASE_STATE_PENDING = 'pending';
+const PURCHASE_STATE_PURCHASED = 'purchased';
+const PURCHASE_STATE_RESTORED = 'restored';
+const DEFAULT_JSON_REPR = '{}';
+
+type Nullable<T> = T | null | undefined;
+
+function normalizePlatform(value?: Nullable<string>): IapPlatform {
+  return value?.toLowerCase() === PLATFORM_IOS
+    ? IapPlatform.Ios
+    : IapPlatform.Android;
+}
+
+function normalizeProductType(value?: Nullable<string>): ProductType {
+  return value?.toLowerCase() === PRODUCT_TYPE_SUBS
+    ? ProductType.Subs
+    : ProductType.InApp;
+}
+
+function normalizeProductTypeIOS(value?: Nullable<string>): ProductTypeIOS {
+  switch ((value ?? '').toLowerCase()) {
+    case 'consumable':
+      return ProductTypeIOS.Consumable;
+    case 'nonconsumable':
+    case 'non_consumable':
+    case 'non-consumable':
+      return ProductTypeIOS.NonConsumable;
+    case 'autorenewablesubscription':
+    case 'auto_renewable_subscription':
+    case 'autorenewable':
+      return ProductTypeIOS.AutoRenewableSubscription;
+    case 'nonrenewingsubscription':
+    case 'non_renewing_subscription':
+      return ProductTypeIOS.NonRenewingSubscription;
+    default:
+      if (value) {
+        console.warn(
+          `[react-native-iap] Unknown iOS product type "${value}", defaulting to NonConsumable.`,
+        );
+      }
+      return ProductTypeIOS.NonConsumable;
+  }
+}
+
+function normalizePaymentMode(value?: Nullable<string>): PaymentModeIOS | null {
+  switch ((value ?? '').toUpperCase()) {
+    case 'FREE_TRIAL':
+    case 'FREETRIAL':
+      return PaymentModeIOS.FreeTrial;
+    case 'PAY_AS_YOU_GO':
+    case 'PAYASYOUGO':
+      return PaymentModeIOS.PayAsYouGo;
+    case 'PAY_UP_FRONT':
+    case 'PAYUPFRONT':
+      return PaymentModeIOS.PayUpFront;
+    default:
+      return PaymentModeIOS.Empty;
+  }
+}
+
+function normalizeSubscriptionPeriod(
+  value?: Nullable<string>,
+): SubscriptionPeriodIOS | null {
+  switch ((value ?? '').toUpperCase()) {
+    case 'DAY':
+      return SubscriptionPeriodIOS.Day;
+    case 'WEEK':
+      return SubscriptionPeriodIOS.Week;
+    case 'MONTH':
+      return SubscriptionPeriodIOS.Month;
+    case 'YEAR':
+      return SubscriptionPeriodIOS.Year;
+    default:
+      return SubscriptionPeriodIOS.Empty;
+  }
+}
+
+function normalizePurchaseState(state: unknown): PurchaseState {
+  if (typeof state === 'string') {
+    switch (state.toLowerCase()) {
+      case PURCHASE_STATE_PURCHASED:
+        return PurchaseState.Purchased;
+      case PURCHASE_STATE_PENDING:
+        return PurchaseState.Pending;
+      case PURCHASE_STATE_FAILED:
+        return PurchaseState.Failed;
+      case PURCHASE_STATE_RESTORED:
+        return PurchaseState.Restored;
+      case PURCHASE_STATE_DEFERRED:
+        return PurchaseState.Deferred;
+      default:
+        return PurchaseState.Unknown;
+    }
+  }
+
+  if (typeof state === 'number') {
+    switch (state) {
+      case 1:
+        return PurchaseState.Purchased;
+      case 2:
+        return PurchaseState.Pending;
+      default:
+        return PurchaseState.Unknown;
+    }
+  }
+
+  return PurchaseState.Unknown;
+}
+
+function toNullableString(value: unknown): string | null {
+  if (value == null) return null;
+  return String(value);
+}
+
+function toNullableNumber(value: unknown): number | null {
+  if (value == null) return null;
+  const num = Number(value);
+  return Number.isFinite(num) ? num : null;
+}
+
+function toNullableBoolean(value: unknown): boolean | null {
+  if (value == null) return null;
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'number') return value !== 0;
+  if (typeof value === 'string') return value.toLowerCase() === 'true';
+  return null;
+}
+
+function parseSubscriptionOffers(value?: Nullable<string>) {
+  if (!value) return undefined;
+  try {
+    const parsed = JSON.parse(value);
+    if (Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch (error) {
+    console.warn('Failed to parse subscriptionOfferDetailsAndroid:', error);
+  }
+  return undefined;
+}
 
 /**
- * Convert NitroProduct (from native) to TypeScript Product (for library consumers)
- * This ensures all fields are properly mapped and accessible
+ * Convert NitroProduct (from native) to generated Product type
  */
 export function convertNitroProductToProduct(
   nitroProduct: NitroProduct,
 ): Product {
-  // Create base product with common fields, handling platform casting
-  const product: any = {
+  const platform = normalizePlatform(nitroProduct.platform);
+  const type = normalizeProductType(nitroProduct.type);
+
+  const base: any = {
     id: nitroProduct.id,
     title: nitroProduct.title,
     description: nitroProduct.description,
-    type: nitroProduct.type as 'inapp' | 'subs',
-    displayName: nitroProduct.displayName,
-    displayPrice: nitroProduct.displayPrice || '',
-    currency: nitroProduct.currency || '',
-    price: nitroProduct.price,
-    platform: nitroProduct.platform as 'ios' | 'android',
+    type,
+    displayName: nitroProduct.displayName ?? null,
+    displayPrice: nitroProduct.displayPrice ?? '',
+    currency: nitroProduct.currency ?? '',
+    price: toNullableNumber(nitroProduct.price),
+    debugDescription: null,
+    platform,
   };
 
-  // Add platform-specific fields based on current platform
-  if (Platform.OS === 'ios') {
-    // Map iOS fields from Nitro to TypeScript types
-    const iosProduct = product as any; // Temporarily cast to access iOS fields
-    iosProduct.isFamilyShareable = (nitroProduct as any).isFamilyShareableIOS;
-    iosProduct.jsonRepresentation = (nitroProduct as any).jsonRepresentationIOS;
-    // Detailed iOS product type - directly from the native field
-    const typeIOSValue: string | undefined = (nitroProduct as any).typeIOS;
-
-    switch (typeIOSValue) {
-      case 'consumable':
-        iosProduct.typeIOS = ProductTypeIOS.consumable;
-        break;
-      case 'nonConsumable':
-        iosProduct.typeIOS = ProductTypeIOS.nonConsumable;
-        break;
-      case 'autoRenewableSubscription':
-        iosProduct.typeIOS = ProductTypeIOS.autoRenewableSubscription;
-        break;
-      case 'nonRenewingSubscription':
-        iosProduct.typeIOS = ProductTypeIOS.nonRenewingSubscription;
-        break;
-      default:
-        iosProduct.typeIOS = undefined;
-    }
-    iosProduct.subscriptionPeriodUnitIOS =
-      nitroProduct.subscriptionPeriodUnitIOS;
-    iosProduct.subscriptionPeriodNumberIOS =
-      nitroProduct.subscriptionPeriodNumberIOS;
-    iosProduct.introductoryPriceIOS = nitroProduct.introductoryPriceIOS;
-    iosProduct.introductoryPriceAsAmountIOS =
-      nitroProduct.introductoryPriceAsAmountIOS;
-    iosProduct.introductoryPricePaymentModeIOS =
-      nitroProduct.introductoryPricePaymentModeIOS;
-    iosProduct.introductoryPriceNumberOfPeriodsIOS =
-      nitroProduct.introductoryPriceNumberOfPeriodsIOS;
+  if (platform === IapPlatform.Ios) {
+    const iosProduct: any = {
+      ...base,
+      displayNameIOS: nitroProduct.displayName ?? nitroProduct.title,
+      isFamilyShareableIOS: Boolean(
+        (nitroProduct as any).isFamilyShareableIOS ?? false,
+      ),
+      jsonRepresentationIOS:
+        (nitroProduct as any).jsonRepresentationIOS ?? DEFAULT_JSON_REPR,
+      typeIOS: normalizeProductTypeIOS((nitroProduct as any).typeIOS),
+      subscriptionInfoIOS: undefined,
+    };
+
+    iosProduct.introductoryPriceAsAmountIOS = toNullableString(
+      (nitroProduct as any).introductoryPriceAsAmountIOS,
+    );
+    iosProduct.introductoryPriceIOS = toNullableString(
+      (nitroProduct as any).introductoryPriceIOS,
+    );
+    iosProduct.introductoryPriceNumberOfPeriodsIOS = toNullableString(
+      (nitroProduct as any).introductoryPriceNumberOfPeriodsIOS,
+    );
+    iosProduct.introductoryPricePaymentModeIOS = normalizePaymentMode(
+      (nitroProduct as any).introductoryPricePaymentModeIOS,
+    );
     iosProduct.introductoryPriceSubscriptionPeriodIOS =
-      nitroProduct.introductoryPriceSubscriptionPeriodIOS;
-  } else if (Platform.OS === 'android') {
-    // Map Android fields from Nitro to TypeScript types
-    const androidProduct = product as any; // Temporarily cast to access Android fields
-    androidProduct.originalPrice = (nitroProduct as any).originalPriceAndroid;
-    androidProduct.originalPriceAmountMicros = (
-      nitroProduct as any
-    ).originalPriceAmountMicrosAndroid;
-    androidProduct.introductoryPriceValue = (
-      nitroProduct as any
-    ).introductoryPriceValueAndroid;
-    androidProduct.introductoryPriceCycles = (
-      nitroProduct as any
-    ).introductoryPriceCyclesAndroid;
-    androidProduct.introductoryPricePeriod = (
-      nitroProduct as any
-    ).introductoryPricePeriodAndroid;
-    androidProduct.subscriptionPeriod = (
-      nitroProduct as any
-    ).subscriptionPeriodAndroid;
-    androidProduct.freeTrialPeriod = (
-      nitroProduct as any
-    ).freeTrialPeriodAndroid;
-
-    // Map subscription offer details (parse from JSON string)
-    if (nitroProduct.subscriptionOfferDetailsAndroid) {
-      try {
-        androidProduct.subscriptionOfferDetailsAndroid = JSON.parse(
-          nitroProduct.subscriptionOfferDetailsAndroid,
-        );
-      } catch (e) {
-        console.warn('Failed to parse subscription offer details:', e);
-        androidProduct.subscriptionOfferDetailsAndroid = null;
-      }
-    }
+      normalizeSubscriptionPeriod(
+        (nitroProduct as any).introductoryPriceSubscriptionPeriodIOS,
+      );
+    iosProduct.subscriptionPeriodNumberIOS = toNullableString(
+      (nitroProduct as any).subscriptionPeriodNumberIOS,
+    );
+    iosProduct.subscriptionPeriodUnitIOS = normalizeSubscriptionPeriod(
+      (nitroProduct as any).subscriptionPeriodUnitIOS,
+    );
 
-    // Create flattened offer fields for easier access in example code
-    androidProduct.oneTimePurchaseOfferFormattedPrice =
-      nitroProduct.displayPrice;
-    androidProduct.oneTimePurchaseOfferPriceAmountMicros = (
-      nitroProduct as any
-    ).originalPriceAmountMicrosAndroid;
-    androidProduct.oneTimePurchaseOfferPriceCurrencyCode =
-      nitroProduct.currency;
+    return iosProduct as Product;
   }
 
-  return product as Product;
-}
+  const androidProduct: any = {
+    ...base,
+    nameAndroid: (nitroProduct as any).nameAndroid ?? nitroProduct.title,
+    oneTimePurchaseOfferDetailsAndroid: (nitroProduct as any)
+      .oneTimePurchaseOfferDetailsAndroid,
+    subscriptionOfferDetailsAndroid: parseSubscriptionOffers(
+      (nitroProduct as any).subscriptionOfferDetailsAndroid,
+    ),
+  };
+
+  if (type === ProductType.Subs) {
+    if (!Array.isArray(androidProduct.subscriptionOfferDetailsAndroid)) {
+      androidProduct.subscriptionOfferDetailsAndroid = [];
+    }
+  }
 
-// Note: Use nitroProducts.map(convertNitroProductToProduct) instead of a separate function
+  return androidProduct as Product;
+}
 
 /**
- * Convert Product to SubscriptionProduct (type-safe casting)
+ * Convert Product to ProductSubscription (type-safe casting helper)
  */
-export function convertProductToSubscriptionProduct(
+export function convertProductToProductSubscription(
   product: Product,
-): SubscriptionProduct {
-  if (product.type !== 'subs') {
+): ProductSubscription {
+  if (product.type !== ProductType.Subs) {
     console.warn(
-      'Converting non-subscription product to SubscriptionProduct:',
+      'Converting non-subscription product to ProductSubscription:',
       product.id,
     );
   }
-  // Since SubscriptionProduct is now an intersection type, we need to cast properly
-  return {
-    ...product,
-    type: 'subs' as const,
-  } as SubscriptionProduct;
-}
 
-// ============================================================================
-// PURCHASE CONVERSION
-// ============================================================================
+  const output: any = {...(product as any)};
+
+  if (output.platform === IapPlatform.Android) {
+    if (!Array.isArray(output.subscriptionOfferDetailsAndroid)) {
+      output.subscriptionOfferDetailsAndroid = [];
+    }
+  }
+
+  return output;
+}
 
 /**
- * Convert NitroPurchase (from native) to TypeScript Purchase (for library consumers)
+ * Convert NitroPurchase (from native) to generated Purchase type
  */
 export function convertNitroPurchaseToPurchase(
   nitroPurchase: NitroPurchase,
 ): Purchase {
-  // Create base purchase with common fields
+  const platform = normalizePlatform(nitroPurchase.platform);
   const purchase: any = {
     id: nitroPurchase.id,
     productId: nitroPurchase.productId,
-    transactionDate: nitroPurchase.transactionDate,
-    // Unified token (iOS JWS, Android purchaseToken)
-    purchaseToken: nitroPurchase.purchaseToken,
-    platform: nitroPurchase.platform as 'ios' | 'android',
-    // Common fields from NitroPurchase
-    quantity: nitroPurchase.quantity || 1,
-    purchaseState:
-      (nitroPurchase.purchaseState as PurchaseState) || PurchaseState.unknown,
-    isAutoRenewing: nitroPurchase.isAutoRenewing || false,
+    transactionDate: nitroPurchase.transactionDate ?? Date.now(),
+    purchaseToken:
+      nitroPurchase.purchaseToken ?? nitroPurchase.purchaseTokenAndroid ?? null,
+    platform,
+    quantity: nitroPurchase.quantity ?? 1,
+    purchaseState: normalizePurchaseState(
+      nitroPurchase.purchaseState ?? nitroPurchase.purchaseStateAndroid,
+    ),
+    isAutoRenewing: Boolean(nitroPurchase.isAutoRenewing),
   };
 
-  // Add platform-specific fields
-  if (Platform.OS === 'ios') {
-    const iosPurchase = purchase as any;
-    iosPurchase.quantityIOS = nitroPurchase.quantityIOS;
-    iosPurchase.originalTransactionDateIOS =
-      nitroPurchase.originalTransactionDateIOS;
-    iosPurchase.originalTransactionIdentifierIOS =
-      nitroPurchase.originalTransactionIdentifierIOS;
-    iosPurchase.appAccountToken = nitroPurchase.appAccountToken;
-    // Fill common quantity from iOS-specific quantity when available
-    if (typeof nitroPurchase.quantityIOS === 'number') {
-      purchase.quantity = nitroPurchase.quantityIOS;
-    }
-  } else if (Platform.OS === 'android') {
-    const androidPurchase = purchase as any;
-    androidPurchase.purchaseTokenAndroid = nitroPurchase.purchaseTokenAndroid;
-    androidPurchase.dataAndroid = nitroPurchase.dataAndroid;
-    androidPurchase.signatureAndroid = nitroPurchase.signatureAndroid;
-    // Support both old and new field names for backward compatibility
-    androidPurchase.autoRenewingAndroid =
-      nitroPurchase.autoRenewingAndroid ?? nitroPurchase.isAutoRenewing;
-    // no longer surface purchaseStateAndroid on TS side
-    androidPurchase.isAcknowledgedAndroid = nitroPurchase.isAcknowledgedAndroid;
-    androidPurchase.packageNameAndroid = nitroPurchase.packageNameAndroid;
-    androidPurchase.obfuscatedAccountIdAndroid =
-      nitroPurchase.obfuscatedAccountIdAndroid;
-    androidPurchase.obfuscatedProfileIdAndroid =
-      nitroPurchase.obfuscatedProfileIdAndroid;
-
-    // Use the common isAutoRenewing field from NitroPurchase
-    purchase.isAutoRenewing = nitroPurchase.isAutoRenewing;
-
-    // Map numeric Android purchase state to common PurchaseState
-    switch (nitroPurchase.purchaseStateAndroid) {
-      case 1:
-        purchase.purchaseState = PurchaseState.purchased;
-        break;
-      case 2:
-        purchase.purchaseState = PurchaseState.pending;
-        break;
-      case 0:
-      default:
-        purchase.purchaseState = PurchaseState.unknown;
-        break;
-    }
+  if (
+    purchase.purchaseState === PurchaseState.Unknown &&
+    nitroPurchase.purchaseStateAndroid != null
+  ) {
+    purchase.purchaseState = normalizePurchaseState(
+      nitroPurchase.purchaseStateAndroid,
+    );
   }
 
-  return purchase as Purchase;
-}
+  if (platform === IapPlatform.Ios) {
+    const iosPurchase: any = purchase;
+    iosPurchase.quantityIOS = toNullableNumber(nitroPurchase.quantityIOS);
+    iosPurchase.originalTransactionDateIOS = toNullableNumber(
+      nitroPurchase.originalTransactionDateIOS,
+    );
+    iosPurchase.originalTransactionIdentifierIOS = toNullableString(
+      nitroPurchase.originalTransactionIdentifierIOS,
+    );
+    iosPurchase.appAccountToken = toNullableString(
+      nitroPurchase.appAccountToken,
+    );
+    return iosPurchase as Purchase;
+  }
 
-// Note: Use nitroPurchases.map(convertNitroPurchaseToPurchase) instead of a separate function
+  const androidPurchase: any = purchase;
+  androidPurchase.autoRenewingAndroid = toNullableBoolean(
+    nitroPurchase.autoRenewingAndroid ?? nitroPurchase.isAutoRenewing,
+  );
+  androidPurchase.dataAndroid = toNullableString(nitroPurchase.dataAndroid);
+  androidPurchase.signatureAndroid = toNullableString(
+    nitroPurchase.signatureAndroid,
+  );
+  androidPurchase.isAcknowledgedAndroid = toNullableBoolean(
+    nitroPurchase.isAcknowledgedAndroid,
+  );
+  androidPurchase.packageNameAndroid = toNullableString(
+    nitroPurchase.packageNameAndroid,
+  );
+  androidPurchase.obfuscatedAccountIdAndroid = toNullableString(
+    nitroPurchase.obfuscatedAccountIdAndroid,
+  );
+  androidPurchase.obfuscatedProfileIdAndroid = toNullableString(
+    nitroPurchase.obfuscatedProfileIdAndroid,
+  );
 
-// ============================================================================
-// SUBSCRIPTION STATUS CONVERSION (iOS)
-// ============================================================================
+  return androidPurchase as Purchase;
+}
 
+/**
+ * Convert Nitro subscription status (iOS) to generated type
+ */
 export function convertNitroSubscriptionStatusToSubscriptionStatusIOS(
   nitro: NitroSubscriptionStatus,
 ): SubscriptionStatusIOS {
   return {
-    state: nitro.state,
-    platform: 'ios',
+    state: String(nitro.state ?? ''),
     renewalInfo: nitro.renewalInfo
       ? {
-          autoRenewStatus: nitro.renewalInfo.autoRenewStatus,
-          autoRenewPreference: nitro.renewalInfo.autoRenewPreference,
-          expirationReason: nitro.renewalInfo.expirationReason,
-          gracePeriodExpirationDate:
-            nitro.renewalInfo.gracePeriodExpirationDate,
-          currentProductID: nitro.renewalInfo.currentProductID,
-          platform: 'ios',
+          autoRenewPreference: toNullableString(
+            nitro.renewalInfo.autoRenewPreference,
+          ),
+          jsonRepresentation: JSON.stringify(nitro.renewalInfo),
+          willAutoRenew: Boolean(nitro.renewalInfo.autoRenewStatus),
         }
       : undefined,
   };
 }
 
-// ============================================================================
-// TYPE VALIDATION
-// ============================================================================
-
 /**
- * Validate that a NitroProduct has all required fields for conversion
+ * Validate that a NitroProduct has the expected shape
  */
 export function validateNitroProduct(nitroProduct: NitroProduct): boolean {
   if (!nitroProduct || typeof nitroProduct !== 'object') {
     return false;
   }
+
   const required = ['id', 'title', 'description', 'type', 'platform'];
   for (const field of required) {
     if (
@@ -277,16 +384,18 @@ export function validateNitroProduct(nitroProduct: NitroProduct): boolean {
       return false;
     }
   }
+
   return true;
 }
 
 /**
- * Validate that a NitroPurchase has all required fields for conversion
+ * Validate that a NitroPurchase has the expected shape
  */
 export function validateNitroPurchase(nitroPurchase: NitroPurchase): boolean {
   if (!nitroPurchase || typeof nitroPurchase !== 'object') {
     return false;
   }
+
   const required = ['id', 'productId', 'transactionDate', 'platform'];
   for (const field of required) {
     if (
@@ -300,16 +409,12 @@ export function validateNitroPurchase(nitroPurchase: NitroPurchase): boolean {
       return false;
     }
   }
+
   return true;
 }
 
-// ============================================================================
-// TYPE SYNCHRONIZATION HELPERS
-// ============================================================================
-
 /**
- * Check if Nitro types and TypeScript types are synchronized
- * This function can be run in development to detect type mismatches
+ * Development helper to check that type conversions stay valid
  */
 export function checkTypeSynchronization(): {
   isSync: boolean;
@@ -318,24 +423,23 @@ export function checkTypeSynchronization(): {
   const issues: string[] = [];
 
   try {
-    // Simple test: can we convert between types?
     const testNitroProduct: NitroProduct = {
       id: 'test',
       title: 'Test',
-      description: 'Test',
+      description: 'Test product',
       type: 'inapp',
-      platform: 'ios',
+      platform: PLATFORM_IOS,
       displayPrice: '$1.00',
       currency: 'USD',
+      price: 1,
     };
 
     const converted = convertNitroProductToProduct(testNitroProduct);
-
     if (!converted.id || !converted.title) {
       issues.push('Type conversion failed');
     }
   } catch (error) {
-    issues.push(`Type conversion error: ${error}`);
+    issues.push(`Type conversion error: ${String(error)}`);
   }
 
   return {