Android SDK

dependencyResolutionManagement {
  repositories {
      google()
      mavenCentral()
      maven { url = uri("https://center.abrova.ir/api/packages/abrova/maven") }
  }
}

dependencies {
    implementation("ir.abrova:abrova-auth:0.1.1")
}

import ir.abrova.auth.AbrovaAuth

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        AbrovaAuth.shared.configure(this, "ab_live_your_api_key")
    }
}

val auth = AbrovaAuth.shared

val methods = auth.getMethods()
if (auth.currentUserId == null && methods.isEnabled("anonymous")) {
    auth.signInAnonymously()
}
Log.d("Auth", auth.currentUserId!!) // ru_...

// Abrova Sync: its provider is called off the main thread
AbrovaSyncConfig.builder(apiKey).userTokenProvider(auth.blockingTokenProvider).build()

// Abrova Push
AbrovaPushConfig(apiKey = apiKey, tokenProvider = auth.tokenProvider)

// Abrova Chat: create the client after sign-in
AbrovaChatConfig(apiKey = apiKey, userId = auth.currentUserId!!, tokenProvider = auth.strictTokenProvider)

val rawNonce = AbrovaNonce.generate()
val option = GetGoogleIdOption.Builder()
    .setServerClientId(WEB_CLIENT_ID)
    .setFilterByAuthorizedAccounts(false)
    .setNonce(AbrovaNonce.sha256(rawNonce))
    .build()
val response = CredentialManager.create(context)
    .getCredential(context, GetCredentialRequest.Builder().addCredentialOption(option).build())
val idToken = GoogleIdTokenCredential.createFrom(response.credential.data).idToken

auth.signInWithGoogle(idToken, rawNonce)

auth.signInWithApple(idToken, rawNonce, authorizationCode = code)

val result = auth.signUp(email, password, redirectUrl = "https://example.com/auth/verify")
// result.signedIn is false when the project requires a verified e-mail first.

auth.signIn(email, password)

auth.sendPasswordReset(email, redirectUrl = "https://example.com/auth/reset")
auth.resetPassword(token, newPassword) // ends every session; does not sign in
auth.verifyEmail(token)
auth.sendEmailVerification(redirectUrl = "https://example.com/auth/verify")

auth.sendMagicLink(email, redirectUrl = "myapp://auth/magic")
// In the activity the link opens:
AbrovaAuth.tokenFromLink(intent.dataString ?: "")?.let { auth.signInWithMagicLink(it) }

val code = auth.requestTelegramCode("+989121234567")
if (!code.sent) startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(code.botUrl)))
auth.verifyTelegramCode("+989121234567", "123456")

try {
    auth.linkGoogle(idToken, rawNonce)   // or linkApple(...), linkPassword(email, password)
} catch (e: AbrovaAuthException) {
    if (e.code == AbrovaAuthErrorCode.PROVIDER_ALREADY_LINKED) {
        // This Google account already belongs to another user.
    }
}

auth.currentUserId                 // null when signed out
auth.isSignedIn
val user = auth.me()               // AbrovaUser: id, isAnonymous, emailVerified, createdAt, providers
auth.currentUser                   // the profile last loaded by me()

// StateFlow of the user id
lifecycleScope.launch { auth.authState.collect { userId -> /* sign-in, sign-out, session end */ } }

// Or a listener
val registration = auth.addAuthStateListener { userId -> }
registration.remove()

val token = auth.getAccessToken()  // if you call your own API with it

auth.signOut()            // this device; never fails
auth.signOutEverywhere()  // every device
auth.deleteAccount()      // deletes the user, then signs out

try {
    auth.signIn(email, password)
} catch (e: AbrovaAuthException) {
    when (e.code) {
        AbrovaAuthErrorCode.INVALID_CREDENTIALS -> showError("Wrong e-mail or password")
        AbrovaAuthErrorCode.RATE_LIMITED -> showError("Try again in ${e.retryAfterSec ?: 60} s")
        AbrovaAuthErrorCode.NETWORK_ERROR -> showError("No connection")
        else -> showError("Sign-in failed")
    }
}