Auth

Login

import com.bunbase.sdk.LoginResult

when (val result = client.auth.login(email, password)) {
    is LoginResult.Authenticated -> {
        println("Logged in as ${result.result.user.email}")
    }
    is LoginResult.TotpRequired -> {
        // Prompt user for TOTP code, then:
        client.auth.verifyTotp(result.challenge.totpToken, totpCode)
    }
}

Register

val result = client.auth.register(email, password)
println("Registered: ${result.user.id}")

Logout

// Revoke current session
client.auth.logout()

// Revoke all sessions (all devices)
client.auth.logoutAll()

Current user

// Snapshot
val user = client.auth.user

// Reactive (Compose)
val user by client.auth.currentUser.collectAsState()

// Fetch from server (refreshes the StateFlow)
val user = client.auth.me()

Auth state in ViewModel

class AppViewModel : ViewModel() {
    val user = BunBase.client.auth.currentUser // StateFlow<AuthUser?>

    fun login(email: String, password: String) {
        viewModelScope.launch {
            try {
                client.auth.login(email, password)
            } catch (e: BunBaseError.ServerError) {
                // handle error
            }
        }
    }
}

Password reset

// Step 1 — send reset email
client.auth.forgotPassword(email)

// Step 2 — apply new password with the token from the email
client.auth.resetPassword(token, newPassword)

Email verification

client.auth.verifyEmail(token)           // token from the verification email
client.auth.resendVerification()          // resend while authenticated

Magic link

// Request
client.auth.requestMagicLink(email)

// Verify (token from the email URL)
val result = client.auth.verifyMagicLink(token)

TOTP / 2FA

// Get current status
val enabled = client.auth.getTotpStatus()

// Begin setup — returns QR URI
val setup = client.auth.setupTotp()
// Show setup.otpauthUrl as QR code

// Confirm with first code
client.auth.enableTotp(code)

// Disable
client.auth.disableTotp(code)

API keys

// List
val keys = client.auth.listApiKeys()

// Create — key is shown once
val created = client.auth.createApiKey("My key")
println(created.key) // store this

// Revoke
client.auth.revokeApiKey(created.id)

User metadata

client.auth.updateMe(mapOf("theme" to "dark", "plan" to "pro"))

Delete account

client.auth.deleteAccount(password)