Android Onboarding

import ai.appdna.sdk.AppDNA

val presented = AppDNA.presentOnboarding(
    activity = this,
    flowId = "main_flow",
    listener = onboardingListener
)

if (!presented) {
    Log.w("Onboarding", "No onboarding flow available")
}

// Use the default active flow
val presented = AppDNA.presentOnboarding(
    activity = this,
    flowId = null,
    listener = onboardingListener
)

import ai.appdna.sdk.onboarding.OnboardingContext

val context = OnboardingContext(
    source = "deep_link",
    campaign = "summer_promo",
    referrer = "friend_invite",
    userProperties = mapOf("tier" to "free"),
    experimentOverrides = mapOf("welcome_variant" to "b")
)

AppDNA.onboarding.present(
    activity = this,
    flowId = "main_flow",
    context = context
)

import ai.appdna.sdk.onboarding.AppDNAOnboardingDelegate

class MyOnboardingDelegate : AppDNAOnboardingDelegate {

    override fun onOnboardingStarted(flowId: String) {
        Log.d("Onboarding", "Flow started: $flowId")
    }

    override fun onOnboardingStepChanged(
        flowId: String,
        stepId: String,
        stepIndex: Int,
        totalSteps: Int
    ) {
        Log.d("Onboarding", "Step $stepIndex/$totalSteps: $stepId")
    }

    override fun onOnboardingCompleted(flowId: String, responses: Map<String, Any>) {
        Log.d("Onboarding", "Flow completed: $flowId")
        Log.d("Onboarding", "Responses: $responses")
        // Navigate to main app
    }

    override fun onOnboardingDismissed(flowId: String, atStep: Int) {
        Log.d("Onboarding", "Flow dismissed at step $atStep")
    }

    // Async hooks (optional — default implementations provided)
    override suspend fun onBeforeStepAdvance(
        flowId: String, fromStepId: String, stepIndex: Int,
        stepType: String, responses: Map<String, Any>,
        stepData: Map<String, Any>?
    ): StepAdvanceResult = StepAdvanceResult.Proceed

    override suspend fun onBeforeStepRender(
        flowId: String, stepId: String, stepIndex: Int,
        stepType: String, responses: Map<String, Any>
    ): StepConfigOverride? = null
}

// Set the delegate
AppDNA.onboarding.setDelegate(MyOnboardingDelegate())

AppDNA.registerCustomView("my_view") {
    MyComposableView()
}

// Register before presenting the onboarding flow
AppDNA.registerCustomView("terms_acceptance") {
    TermsAcceptanceView(onAccept = { accepted ->
        // Handle acceptance
    })
}

override suspend fun onBeforeStepRender(
    flowId: String, stepId: String, stepIndex: Int,
    stepType: String, responses: Map<String, Any>
): StepConfigOverride? {
    return StepConfigOverride(
        bindings = mapOf(
            "hero_title" to "Welcome, $userName!",
            "plan_price" to fetchedPrice,
            "avatar_url" to userAvatarUrl
        )
    )
}

override fun onOnboardingCompleted(flowId: String, responses: Map<String, Any>) {
    val formData = responses["profile_step"] as? Map<String, Any>
    val name = formData?.get("full_name") as? String
    val age = formData?.get("age") as? Int
    val email = formData?.get("email") as? String
    // Use collected data to personalize the experience
}

override fun onOnboardingCompleted(flowId: String, responses: Map<String, Any>) {
    val locationStep = responses["location_step"] as? Map<String, Any>
    val location = locationStep?.get("user_location") as? Map<String, Any>
    if (location != null) {
        val city = location["city"] as? String         // "New York"
        val country = location["country_code"] as? String // "US"
        val timezone = location["timezone"] as? String  // "America/New_York"
        val lat = location["latitude"] as? Double       // 40.7128
        val lng = location["longitude"] as? Double      // -74.0060
    }
}

Welcome from {{onboarding.location_step.user_location.city}}!
Your timezone: {{onboarding.location_step.user_location.timezone}}

override suspend fun onBeforeStepAdvance(
    flowId: String,
    fromStepId: String,
    stepIndex: Int,
    stepType: String,
    responses: Map<String, Any>,
    stepData: Map<String, Any>?
): StepAdvanceResult {
    // Example: validate a referral code with your backend
    if (stepType == "form") {
        val formData = responses[fromStepId] as? Map<String, Any>
        val code = formData?.get("referral_code") as? String
        if (code != null) {
            val isValid = validateReferralCode(code) // your suspend function
            if (!isValid) {
                return StepAdvanceResult.Block("Invalid referral code. Please try again.")
            }
            return StepAdvanceResult.ProceedWithData(mapOf("referral_validated" to true))
        }
    }
    return StepAdvanceResult.Proceed
}

override suspend fun onBeforeStepRender(
    flowId: String,
    stepId: String,
    stepIndex: Int,
    stepType: String,
    responses: Map<String, Any>
): StepConfigOverride? {
    // Pre-fill form fields based on user data
    if (stepId == "profile_step") {
        return StepConfigOverride(
            fieldDefaults = mapOf(
                "email" to currentUser.email,
                "name" to currentUser.displayName
            ),
            title = "Welcome back, ${currentUser.firstName}!"
        )
    }
    return null
}

// Example: Two buttons side by side, equally spaced
Row (direction: HORIZONTAL, distribution: EQUAL)
  ├── Button "Skip"
  └── Button "Continue"