Add QDeferredPurchasesListener with QDeferredTransaction model

[NickSxti]

Summary

• New QDeferredPurchasesListener interface with deferredPurchaseCompleted(transaction) callback
• New QDeferredTransaction data class with productId, transactionId, originalTransactionId, type, value, currency
• Deprecated QEntitlementsUpdateListener interface, config builder method, and Qonversion setter
• Both listeners fire in deferred purchase paths (API success + local fallback)
• Public API on Qonversion interface + QonversionConfig.Builder

Architecture

Deferred purchase completes (pending -> purchased)
  -> API validation success: entitlementsUpdateListener fires (backward compat) + deferredPurchasesListener fires
  -> API validation failure (fallback): same dual notification

Files changed

• QDeferredPurchasesListener.kt - new interface
• QDeferredTransaction.kt - new data class
• QEntitlementsUpdateListener.kt - deprecated
• Qonversion.kt - new setter + deprecated old
• QonversionConfig.kt - new builder method + deprecated old
• InternalConfig.kt - new property
• QProductCenterManager.kt - new setter + callback invocation at both deferred paths
• QonversionInternal.kt - delegates to product center manager
• DeferredPurchasesListenerTest.kt - 6 unit tests

Test plan

• 6 unit tests written (setter, null, coexistence, isolation, data class validation)
• Tests could not run locally (Java 8 only, needs 11+) - CI should validate

Note

value and currency are 0.0/null for Android because Google Play Purchase object doesn't expose price. These fields will be populated at the Sandwich/cross-platform layer using product catalog data.

DEV-643

Generated with Claude Code

[NickSxti]

LEVER Self-Review

Logic

• Callback invocation at two deferred purchase paths:
  1. API success (line ~1067): when purchaseCallback == null (deferred), notifies both listeners
  2. Local fallback (line ~572): when callback is null after failed API + local permission grant, notifies both
• QDeferredTransaction constructed from Google Play Purchase object: productId from purchase, purchaseToken as transactionId, orderId as originalTransactionId
• value/currency are 0.0/null because Google Play Purchase doesn't expose price data. These will be enriched at the Sandwich/cross-platform layer using product catalog.

Edge Cases

• If deferredPurchasesListener is null, the call is silently skipped (Kotlin null-safe ?.)
• Both listeners are independent - setting one doesn't affect the other
• The deprecated @Suppress("DEPRECATION") annotation prevents build warnings when we call the old listener internally
• QDeferredTransaction is a data class - provides equals/hashCode/copy for free

Verify

• New interface follows the pattern of QEntitlementsUpdateListener
• Config builder follows existing setEntitlementsUpdateListener pattern
• QonversionInternal delegates to QProductCenterManager
• Deprecation annotations on interface, builder, and Qonversion setter
• 6 unit tests written

Risks

• Tests could not run locally (only Java 8 available, needs 11+). CI should validate.
• Purchase.productId returns the first product ID for multi-product purchases (edge case for bundles)

Linear: DEV-665

[SpertsyanKM]

No need to mention review feedback in comments

[SpertsyanKM]

What is the necessity of the DeferredTransaction here, if there is the PurchaseResult? I think all the information about the purchase can be taken from there

[SpertsyanKM]

here either