[Jan 2026] Migration guide. Capacitor 1.

try {
  // Old method returned only Map<string, Entitlement>
  const entitlements = await Qonversion.getSharedInstance().purchaseProduct(product, purchaseOptions);
  
  // Check for entitlement
  const premiumEntitlement = entitlements.get('premium');
  if (premiumEntitlement?.isActive) {
    console.log('Purchase successful! Premium access granted.');
  }
} catch (error) {
  // All errors, including user cancellation, were handled via catch
  if (error.code === QonversionErrorCode.CanceledPurchase) {
    console.log('User canceled the purchase');
  } else {
    console.error('Purchase failed:', error.message);
  }
}

const result = await Qonversion.getSharedInstance().purchase(product, purchaseOptions);

if (result.isSuccess) {
  // Purchase succeeded
  const premiumEntitlement = result.entitlements?.get('premium');
  if (premiumEntitlement?.isActive) {
    console.log('Purchase successful! Premium access granted.');
  }

  // Access transaction details
  console.log('Transaction ID:', result.storeTransaction?.transactionId);
  console.log('Product ID:', result.storeTransaction?.productId);

} else if (result.isCanceled) {
  // User canceled — not an error, just a status
  console.log('User canceled the purchase');

} else if (result.isPending) {
  // Purchase awaiting confirmation (e.g., parental controls, deferred payments)
  console.log('Purchase is pending approval');

} else if (result.isError) {
  // An actual error occurred
  console.error('Purchase failed:', result.error?.description);
  console.error('Error code:', result.error?.code);
}