PresentationResult

sealed class PresentationResult {
    data class NotPresented(val reason: NotPresentedReason) : PresentationResult()
    data class Presented(val outcome: Outcome) : PresentationResult()

    data class Outcome(
        val advertiser: AdvertiserOutcome = AdvertiserOutcome.NotAttempted,
        val publisher: PublisherOutcome = PublisherOutcome.NotAttempted,
        val dismissal: DismissReason,
    )
}

data class ClaimedOffer(
    val campaignId: String,
    val advertiserName: String,
    val transactionId: String? = null,
    val userConfirmedCompletion: Boolean = false,  // 2.3.0+: the user said they finished, and the server granted the prize
)

sealed class AdvertiserOutcome {
    data object NotAttempted : AdvertiserOutcome()
    data class Claimed(val offer: ClaimedOffer) : AdvertiserOutcome()   // on-device claim
    data class Verified(val offer: ClaimedOffer) : AdvertiserOutcome()  // confirmed in-session (Strict only)
    data object Cooldown : AdvertiserOutcome()                          // claim refused (HTTP 409)
    data class Failed(val error: EncoreError) : AdvertiserOutcome()
}

enum class PublisherOutcome {
    NotAttempted,
    Purchased,
    Cancelled,
    Pending,   // deferred (parental approval / SCA); may complete later via Google Play
    Failed,
}

sealed class NotPresentedReason {
    data object NotConfigured : NotPresentedReason()
    data object AlreadyPresenting : NotPresentedReason()
    data object NoOffers : NotPresentedReason()
    data object ExperimentControl : NotPresentedReason()
    data object NoForegroundActivity : NotPresentedReason()
    data object UseCaseUnavailable : NotPresentedReason()
    data object IapFirstDeclined : NotPresentedReason()
    data class Error(val error: EncoreError) : NotPresentedReason()
}

lifecycleScope.launch {
    val result = Encore.placement("cancel_flow").show()
    val converted = result.claim != null || result.publisher == PublisherOutcome.Purchased
    if (converted) grantAccess() else proceedWithCancellation()
}

when (result) {
    is PresentationResult.NotPresented -> log(result.reason)
    is PresentationResult.Presented -> {
        result.claim?.let { syncEntitlement(it.campaignId, it.transactionId) }
        if (result.outcome.publisher == PublisherOutcome.Purchased) refreshSubscriptions()
        log("closed via ${result.outcome.dismissal.value}")
    }
}