Rework DeferredPurchasesListener to use native events

Replace JS-layer filtering with native DeferredPurchasesListener from
Sandwich SDK. The listener now receives a DeferredTransaction object
with full transaction details instead of entitlements.

- Add DeferredTransaction model
- Wire native onDeferredPurchaseCompleted event (iOS + Android)
- Remove JS-side pendingPurchaseProductIds tracking
- Update DeferredPurchasesListener to use DeferredTransaction
- 10 tests passing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: NickSxti

android/src/main/java/com/qonversion/reactnativesdk/QonversionModule.kt

@@ -299,6 +299,11 @@ class QonversionModule(reactContext: ReactApplicationContext) : NativeQonversion
         emitOnEntitlementsUpdated(mappedEntitlements)
     }
 
+    override fun onDeferredPurchaseCompleted(transaction: BridgeData) {
+        val mappedTransaction = EntitiesConverter.convertMapToWritableMap(transaction)
+        emitOnDeferredPurchaseCompleted(mappedTransaction)
+    }
+
     companion object {
         const val NAME = "RNQonversion"
     }

ios/RNQonversion.mm

@@ -317,6 +317,14 @@ - (void)qonversionDidReceiveUpdatedEntitlements:(NSDictionary<NSString *,id> * _
     }
 }
 
+- (void)qonversionDidCompleteDeferredPurchase:(NSDictionary<NSString *,id> * _Nonnull)transaction {
+    @try {
+        [self emitOnDeferredPurchaseCompleted:transaction];
+    } @catch (NSException *exception) {
+        QNR_LOG_EXCEPTION("qonversionDidCompleteDeferredPurchase", exception);
+    }
+}
+
 - (void)shouldPurchasePromoProductWith:(NSString * _Nonnull)productId {
     @try {
         [self emitOnPromoPurchaseReceived:productId];

ios/RNQonversionImpl.swift

@@ -13,6 +13,7 @@ import React
 public protocol QonversionEventDelegate {
     func shouldPurchasePromoProduct(with productId: String)
     func qonversionDidReceiveUpdatedEntitlements(_ entitlements: [String: Any])
+    func qonversionDidCompleteDeferredPurchase(_ transaction: [String: Any])
 }
 
 class QonversionEventHandler: QonversionEventListener {
@@ -25,6 +26,10 @@ class QonversionEventHandler: QonversionEventListener {
     func qonversionDidReceiveUpdatedEntitlements(_ entitlements: [String: Any]) {
         delegate?.qonversionDidReceiveUpdatedEntitlements(entitlements)
     }
+
+    func qonversionDidCompleteDeferredPurchase(_ transaction: [String: Any]) {
+        delegate?.qonversionDidCompleteDeferredPurchase(transaction)
+    }
 }
 
 @objc

src/dto/DeferredPurchasesListener.ts

@@ -1,11 +1,12 @@
-import Entitlement from './Entitlement';
+import DeferredTransaction from './DeferredTransaction';
 
 export interface DeferredPurchasesListener {
 
   /**
    * Called when a deferred purchase completes.
    * For example, when pending purchases like SCA, Ask to buy, etc., are approved and finalized.
-   * @param entitlements the user's entitlements after the deferred purchase completion.
+   * Provides full transaction details, including for consumable products without entitlements.
+   * @param transaction the completed deferred transaction with full details.
    */
-  onDeferredPurchaseCompleted(entitlements: Map<string, Entitlement>): void;
+  onDeferredPurchaseCompleted(transaction: DeferredTransaction): void;
 }

src/dto/DeferredTransaction.ts

@@ -0,0 +1,51 @@
+/**
+ * Represents a completed deferred purchase transaction with full details.
+ */
+export default class DeferredTransaction {
+  /**
+   * Store product identifier.
+   */
+  productId: string;
+
+  /**
+   * Store transaction identifier.
+   */
+  transactionId: string | null;
+
+  /**
+   * Original store transaction identifier.
+   * For subscriptions, this is the ID of the first transaction.
+   */
+  originalTransactionId: string | null;
+
+  /**
+   * Type of the transaction: Subscription, Consumable, NonConsumable, or Unknown.
+   */
+  type: string;
+
+  /**
+   * Transaction value. May be 0 if unavailable.
+   */
+  value: number;
+
+  /**
+   * Currency code (e.g. "USD"). May be null if unavailable.
+   */
+  currency: string | null;
+
+  constructor(
+    productId: string,
+    transactionId: string | null,
+    originalTransactionId: string | null,
+    type: string,
+    value: number,
+    currency: string | null
+  ) {
+    this.productId = productId;
+    this.transactionId = transactionId;
+    this.originalTransactionId = originalTransactionId;
+    this.type = type;
+    this.value = value;
+    this.currency = currency;
+  }
+}

src/index.ts

@@ -5,6 +5,7 @@ export { default as QonversionConfigBuilder } from './QonversionConfigBuilder';
 
 export type { EntitlementsUpdateListener } from './dto/EntitlementsUpdateListener';
 export type { DeferredPurchasesListener } from './dto/DeferredPurchasesListener';
+export { default as DeferredTransaction } from './dto/DeferredTransaction';
 export * from './dto/enums';
 export { default as IntroEligibility } from './dto/IntroEligibility';
 export { default as Offering } from './dto/Offering';

src/internal/Mapper.ts

@@ -56,6 +56,7 @@ import QonversionError from '../dto/QonversionError';
 import NoCodesError from '../dto/NoCodesError';
 import PurchaseResult from '../dto/PurchaseResult';
 import StoreTransaction from '../dto/StoreTransaction';
+import DeferredTransaction from '../dto/DeferredTransaction';
 
 export type QProduct = {
   id: string;
@@ -1250,6 +1251,27 @@ class Mapper {
   }
 
   // endregion
+
+  // region DeferredTransaction
+
+  static convertDeferredTransaction(
+    transaction: Record<string, any> | null | undefined
+  ): DeferredTransaction | null {
+    if (!transaction) {
+      return null;
+    }
+
+    return new DeferredTransaction(
+      transaction.productId ?? '',
+      transaction.transactionId ?? null,
+      transaction.originalTransactionId ?? null,
+      transaction.type ?? 'Unknown',
+      transaction.value ?? 0,
+      transaction.currency ?? null
+    );
+  }
+
+  // endregion
 }
 
 export default Mapper;

src/internal/QonversionInternal.ts

@@ -33,8 +33,8 @@ export default class QonversionInternal implements QonversionApi {
   private entitlementsUpdateListener: EntitlementsUpdateListener | null = null;
   private deferredPurchasesListener: DeferredPurchasesListener | null = null;
   private promoPurchasesDelegate: PromoPurchasesListener | null = null;
-  private pendingPurchaseProductIds: Set<string> = new Set();
   private entitlementsEventSubscribed = false;
+  private deferredPurchaseEventSubscribed = false;
 
   constructor(qonversionConfig: QonversionConfig) {
     RNQonversion.storeSDKInfo(sdkSource, sdkVersion);
@@ -126,10 +126,6 @@ export default class QonversionInternal implements QonversionApi {
       throw new Error("Failed to parse PurchaseResult");
     }
 
-    if (mappedResult.isPending) {
-      this.pendingPurchaseProductIds.add(product.qonversionId);
-    }
-
     return mappedResult;
   }
 
@@ -401,24 +397,25 @@ export default class QonversionInternal implements QonversionApi {
     }
   }
 
+  private subscribeToDeferredPurchaseEvent() {
+    if (!this.deferredPurchaseEventSubscribed) {
+      RNQonversion.onDeferredPurchaseCompleted(this.deferredPurchaseCompletedEventHandler);
+      this.deferredPurchaseEventSubscribed = true;
+    }
+  }
+
   private entitlementsUpdatedEventHandler = (payload: Object) => {
     const entitlements = Mapper.convertEntitlements(payload as Record<string, QEntitlement>);
 
     this.entitlementsUpdateListener?.onEntitlementsUpdated(entitlements);
-
-    if (this.deferredPurchasesListener && this.hasPendingPurchaseCompleted(entitlements)) {
-      this.deferredPurchasesListener.onDeferredPurchaseCompleted(entitlements);
-    }
   }
 
-  private hasPendingPurchaseCompleted(entitlements: Map<string, Entitlement>): boolean {
-    for (const [, entitlement] of entitlements) {
-      if (entitlement.isActive && this.pendingPurchaseProductIds.has(entitlement.productId)) {
-        this.pendingPurchaseProductIds.delete(entitlement.productId);
-        return true;
-      }
+  private deferredPurchaseCompletedEventHandler = (payload: Object) => {
+    const transaction = Mapper.convertDeferredTransaction(payload as Record<string, any>);
+
+    if (transaction) {
+      this.deferredPurchasesListener?.onDeferredPurchaseCompleted(transaction);
     }
-    return false;
   }
 
   private promoPurchaseReceivedEventHandler = (productId: string) => {
@@ -436,7 +433,7 @@ export default class QonversionInternal implements QonversionApi {
   }
 
   setDeferredPurchasesListener(listener: DeferredPurchasesListener) {
-    this.subscribeToEntitlementsEvent();
+    this.subscribeToDeferredPurchaseEvent();
     this.deferredPurchasesListener = listener;
   }