Android SDK (Kotlin)

// build.gradle.kts (Module)
dependencies {
    implementation("com.authme:authme-android:1.0.0")
}

// settings.gradle.kts — add repository if needed
dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

import com.authme.sdk.AuthmeClient

val authme = AuthmeClient.Builder()
    .serverUrl("https://auth.example.com")
    .realm("my-realm")
    .clientId("my-android-app")
    .redirectUri("myapp://callback")
    .build()

// Launch login (opens Chrome Custom Tab)
authme.login(activity) { result ->
    when (result) {
        is AuthResult.Success -> {
            val token = result.accessToken
            val user = result.userInfo
            println("Logged in as ${user.name}")
        }
        is AuthResult.Error -> {
            println("Login failed: ${result.message}")
        }
        is AuthResult.Cancelled -> {
            println("User cancelled login")
        }
    }
}

// Enable biometric login (stores tokens in EncryptedSharedPreferences)
authme.enableBiometrics(activity)

// Login with biometrics
authme.loginWithBiometrics(activity) { result ->
    if (result is AuthResult.Success) {
        println("Biometric login successful")
    }
}

// Check availability
val available = authme.isBiometricsAvailable(context)

val user = authme.getUserInfo()
println(user.name)       // "John Doe"
println(user.email)      // "john@example.com"
println(user.roles)      // ["admin", "user"]

// Or use Kotlin coroutines
lifecycleScope.launch {
    val user = authme.getUserInfoAsync()
}

// Automatic refresh before expiry
val token = authme.accessToken

// Manual refresh
authme.refreshToken { result ->
    if (result is AuthResult.Success) {
        val newToken = result.accessToken
    }
}

// Check authentication state
if (authme.isAuthenticated) { /* ... */ }

authme.logout { result ->
    // Tokens cleared from EncryptedSharedPreferences
    // Session revoked on server
    println("Logged out successfully")
}

@Composable
fun AuthScreen(authme: AuthmeClient) {
    val isAuthenticated by authme.isAuthenticatedState.collectAsState()

    if (isAuthenticated) {
        val user by authme.userState.collectAsState()
        Column {
            Text("Welcome, ${user?.name}")
            Button(onClick = { authme.logout {} }) {
                Text("Logout")
            }
        }
    } else {
        val context = LocalContext.current
        Button(onClick = { authme.login(context as Activity) {} }) {
            Text("Sign In")
        }
    }
}