Method Detail

• hasActiveSubscription

   final Boolean hasActiveSubscription()

  Check if user has active subscription.

• refreshEntitlementCache

   final Unit refreshEntitlementCache()

  SPEC-401 Fix 1D — silently refresh cached entitlement state.

  Calls into NativeBillingManager.refreshEntitlementCache which re-reads the user's current entitlements via Play Billing BillingClient.queryPurchasesAsync and primes the EntitlementCache in place. Designed for two callers:

  • AppDNA.identify — auto-refresh after host signs in a user so the next paywall_trigger entitlement gate (Fix 1A) reflects that user's subscriptions, not the previous anonymous user's empty entitlements.

  • Hosts that complete auth out-of-band (SSO callbacks, deep links, OAuth web flows) and need to flush stale cache without firing user-visible restore events.

  Side effects: ZERO. No analytics events, no delegate callbacks, no UI. Errors are swallowed and logged at warning level — the suspend returns normally so callers can chain without try/catch. Mirrors iOS BillingModule.refreshEntitlementCache().

• refreshEntitlementCacheFuture

   final CompletableFuture<Unit> refreshEntitlementCacheFuture()

  Java-friendly overload — returns a CompletableFuture.

• getProducts

   final List<ProductInfo> getProducts(List<String> productIds)

  SPEC-070-A A.30 — typed suspend product fetch.

  Returns ProductInfo data classes from NativeBillingManager.getProducts. Replaces the previous broken scope.launch; return result stub which always returned an empty list synchronously.

• getProductsFuture

   final CompletableFuture<List<ProductInfo>> getProductsFuture(List<String> productIds)

  Java-friendly overload — returns a CompletableFuture.

• purchase

  @JvmOverloads() final TransactionInfo purchase(Activity activity, String productId, PurchaseOptions options)

  SPEC-070-A A.29 / A.30 — initiate a purchase flow.

  Activity is now the FIRST parameter (required by Google Play Billing launchBillingFlow). Mirrors iOS BillingModule.purchase(productId:options:) (AppDNA+Modules.swift:72).

  Returns a TransactionInfo on success. Throws on failure (cancelled, pending, billing error).

  Parameters:

  activity - Activity used to launch the Play billing dialog.

  productId - The Google Play product ID to purchase.

  options - Optional purchase parameters (offer token, app account token).

• purchase

  @JvmOverloads() final TransactionInfo purchase(Activity activity, String productId)

  SPEC-070-A A.29 / A.30 — initiate a purchase flow.

  Activity is now the FIRST parameter (required by Google Play Billing launchBillingFlow). Mirrors iOS BillingModule.purchase(productId:options:) (AppDNA+Modules.swift:72).

  Returns a TransactionInfo on success. Throws on failure (cancelled, pending, billing error).

  Parameters:

  activity - Activity used to launch the Play billing dialog.

  productId - The Google Play product ID to purchase.

• purchaseFuture

  @JvmOverloads() final CompletableFuture<TransactionInfo> purchaseFuture(Activity activity, String productId, PurchaseOptions options)

  Java-friendly overload — returns a CompletableFuture.

• purchaseFuture

  @JvmOverloads() final CompletableFuture<TransactionInfo> purchaseFuture(Activity activity, String productId)

  Java-friendly overload — returns a CompletableFuture.

• restorePurchases

   final List<String> restorePurchases()

  SPEC-070-A A.30 — typed suspend restore. Mirrors iOS AppDNA+Modules.swift:88restorePurchases() async throws -> [String]. Returns the list of restored product IDs so hosts can show a confirmation UI; the underlying Entitlement objects are still surfaced via AppDNABillingDelegate.onRestoreCompleted for hosts that prefer the delegate flow.

• restorePurchasesAsync

   final CompletableFuture<List<String>> restorePurchasesAsync()

  Java-compatible CompletableFuture adapter for restorePurchases.

• getEntitlements

   final List<Entitlement> getEntitlements()

  SPEC-070-A A.30 — typed suspend entitlements fetch.

  Returns the current cached active entitlements as Entitlement data classes. Suspend so future implementations can refresh from the network without a breaking change.

• getEntitlementsFuture

   final CompletableFuture<List<Entitlement>> getEntitlementsFuture()

  Java-friendly overload — returns a CompletableFuture.

• onEntitlementsChanged

   final Unit onEntitlementsChanged(Function1<List<Entitlement>, Unit> callback)

  Register a callback for entitlement changes.

• setDelegate

   final Unit setDelegate(AppDNABillingDelegate delegate)

  Set a delegate to receive billing lifecycle callbacks (purchases, failures, restores).