package com.storytellersdkgam

import com.google.android.gms.ads.admanager.AdManagerAdRequest
import com.storyteller.domain.ads.entities.StorytellerAdRequestInfo
import com.storyteller.modules.ads.StorytellerAdRequestEnrichmentCompletion

/**
 * Android-native hook for enriching the prepared Google Ad Manager request used by Storyteller.
 *
 * Register this before calling the JavaScript `setupGAMModule` function. The callback may complete
 * synchronously or after host-owned APS, Nimbus, or equivalent bidder work finishes. Exactly one
 * terminal method on [completion] must be called unless the native ad context is cancelled.
 */
fun interface StorytellerGamAdRequestEnricher {
  fun enrich(
    requestInfo: StorytellerAdRequestInfo,
    builder: AdManagerAdRequest.Builder,
    completion: StorytellerAdRequestEnrichmentCompletion<AdManagerAdRequest.Builder>,
  )
}