authsession/io.github.maniramezan.kommon.authsession

Package-level declarations

Types

Authentication operations for anonymous sessions.

interface AuthRepository : AuthStateProvider, AnonymousAuth, EmailPasswordAuth, SocialAuth

Provider-agnostic authentication repository combining AuthStateProvider, AnonymousAuth, EmailPasswordAuth, and SocialAuth. Bridge this to Firebase Auth, Supabase Auth, or any other auth backend.

AuthSessionHint

data class AuthSessionHint(val hasAccount: Boolean)

A small persisted hint about the last known session, so a cold-start UI can render optimistically.

AuthSessionInitializer

class AuthSessionInitializer(authRepository: AuthStateProvider, authTokenProvider: AuthTokenProvider, sessionStore: AuthSessionStore, logger: KommonLogger = NoOpLogger, scope: CoroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.Default))

Warms the auth session at cold start: mints/refreshes a token before the first API request can race an unauthenticated call, then keeps sessionStore updated as AuthStateProvider.authStateFlow changes. Call start early in app startup and stop when its owning app scope is torn down.

AuthSessionStore

interface AuthSessionStore

Persists AuthSessionHint across app launches (typically backed by encrypted SharedPreferences).

AuthStateProvider

interface AuthStateProvider

Provides access to the current authentication state and account lifecycle operations.

AuthTokenProvider

interface AuthTokenProvider

Supplies the bearer token attached to every outgoing API request.

AuthUser

data class AuthUser(val uid: String, val isAnonymous: Boolean, val displayName: String? = null, val email: String? = null)

Provider-agnostic authenticated user shape.

EmailPasswordAuth

interface EmailPasswordAuth

Authentication operations using email and password, or email sign-in links.

SocialAuth

interface SocialAuth

Federated / third-party identity provider sign-in operations.

Functions

authSignInErrorMessage

fun Throwable.authSignInErrorMessage(providerName: String, genericFailureMessage: String = "Sign in failed. Please try again."): String

Maps a sign-in failure to a short, user-facing message.