Android API Reference

interface AppDNAPushDelegate {
    fun onPushTokenRegistered(token: String)
    fun onPushReceived(notification: PushPayload, inForeground: Boolean)
    fun onPushTapped(notification: PushPayload, actionId: String?)
}

interface AppDNABillingDelegate {
    fun onPurchaseCompleted(productId: String, transaction: TransactionInfo)
    fun onPurchaseFailed(productId: String, error: Exception)
    fun onEntitlementsChanged(entitlements: List<Entitlement>)
    fun onRestoreCompleted(restoredProducts: List<String>)
}

interface AppDNAOnboardingDelegate {
    fun onOnboardingStarted(flowId: String)
    fun onOnboardingStepChanged(flowId: String, stepId: String, stepIndex: Int, totalSteps: Int)
    fun onOnboardingCompleted(flowId: String, responses: Map<String, Any>)
    fun onOnboardingDismissed(flowId: String, atStep: Int)

    // Async hooks (optional)
    suspend fun onBeforeStepAdvance(flowId: String, fromStepId: String, stepIndex: Int, stepType: String, responses: Map<String, Any>, stepData: Map<String, Any>?): StepAdvanceResult
    suspend fun onBeforeStepRender(flowId: String, stepId: String, stepIndex: Int, stepType: String, responses: Map<String, Any>): StepConfigOverride?
}

interface AppDNAPaywallDelegate {
    fun onPaywallPresented(paywallId: String)
    fun onPaywallAction(paywallId: String, action: PaywallAction)
    fun onPaywallPurchaseStarted(paywallId: String, productId: String)
    fun onPaywallPurchaseCompleted(paywallId: String, productId: String, transaction: TransactionInfo)
    fun onPaywallPurchaseFailed(paywallId: String, error: Exception)
    fun onPaywallDismissed(paywallId: String)
}

data class AppDNAOptions(
    val flushInterval: Long = 30L,
    val batchSize: Int = 20,
    val configTTL: Long = 300L,
    val logLevel: LogLevel = LogLevel.WARNING
)

enum class Environment(val baseUrl: String) {
    PRODUCTION("https://api.appdna.ai"),
    SANDBOX("https://sandbox-api.appdna.ai")
}

enum class LogLevel(val value: Int) {
    NONE(0),
    ERROR(1),
    WARNING(2),
    INFO(3),
    DEBUG(4)
}

data class PaywallContext(
    val placement: String,
    val experiment: String? = null,
    val variant: String? = null
)

data class OnboardingContext(
    val source: String? = null,
    val campaign: String? = null,
    val referrer: String? = null,
    val userProperties: Map<String, Any>? = null,
    val experimentOverrides: Map<String, String>? = null
)

data class PushPayload(
    val pushId: String,
    val title: String,
    val body: String,
    val imageUrl: String? = null,
    val data: Map<String, Any>? = null,
    val action: PushAction? = null
)

data class PushAction(
    val type: String,
    val value: String
)

data class TransactionInfo(
    val transactionId: String,
    val productId: String,
    val purchaseDate: String,
    val environment: String
)

data class Entitlement(
    val productId: String,
    val store: String,
    val status: String,
    val expiresAt: String? = null,
    val isTrial: Boolean,
    val offerType: String? = null
)

data class ProductInfo(
    val id: String,
    val name: String,
    val description: String,
    val formattedPrice: String,
    val priceMicros: Long,
    val currencyCode: String,
    val offerToken: String? = null
)

sealed class PurchaseResult {
    data class Purchased(val entitlement: Entitlement) : PurchaseResult()
    object Cancelled : PurchaseResult()
    object Pending : PurchaseResult()
    object Unknown : PurchaseResult()
    data class Failed(val error: Exception) : PurchaseResult()
}

enum class PaywallAction {
    CTA_TAPPED,
    FEATURE_SELECTED,
    PLAN_CHANGED,
    LINK_TAPPED,
    CUSTOM
}

enum class DismissReason {
    PURCHASED,
    DISMISSED,
    TAPPED_OUTSIDE,
    PROGRAMMATIC
}

data class WebEntitlement(
    val productId: String,
    val status: String,
    val expiresAt: String?,
    val source: String
)

data class DeferredDeepLink(
    val url: String,
    val campaign: String?,
    val medium: String?,
    val source: String?
)

sealed class StepAdvanceResult {
    object Proceed : StepAdvanceResult()
    data class ProceedWithData(val data: Map<String, Any>) : StepAdvanceResult()
    data class Block(val message: String) : StepAdvanceResult()
    data class SkipTo(val stepId: String, val data: Map<String, Any>? = null) : StepAdvanceResult()
}

data class StepConfigOverride(
    val fieldDefaults: Map<String, Any>? = null,
    val title: String? = null,
    val subtitle: String? = null,
    val ctaText: String? = null,
    val layoutOverrides: Map<String, Any>? = null
)

enum class FormFieldType {
    TEXT, TEXTAREA, NUMBER, EMAIL, PHONE,
    DATE, TIME, DATETIME,
    SELECT, SLIDER, TOGGLE, STEPPER, SEGMENTED
}

interface AppDNAScreenDelegate {
    fun onScreenPresented(screenId: String)
    fun onScreenDismissed(screenId: String, result: ScreenResult)
    fun onFlowCompleted(flowId: String, result: FlowResult)
    fun onScreenAction(screenId: String, action: SectionAction): Boolean
}

data class ScreenResult(
    val dismissed: Boolean,
    val responses: Map<String, Any>
)

data class FlowResult(
    val completed: Boolean,
    val screensViewed: Int,
    val responses: Map<String, Any>
)

data class SectionAction(
    val sectionId: String,
    val actionType: String,
    val data: Map<String, Any>? = null
)