auth-foundation/com.okta.authfoundation.credential.kmp/TokenCredentialManager

TokenCredentialManager

class TokenCredentialManager(val client: OAuth2Client, storage: TokenStorage, val defaultIdStore: DefaultCredentialIdStore, val onStorageError: (Exception) -> Boolean? = null)

Cross-platform credential manager providing CRUD operations for credentials.

Holds the shared dependencies (client, storage, defaultIdStore) so callers don't need to pass them on every operation.

Credential lifecycle events are emitted on events. All active collectors receive every event independently. There is no replay; events emitted before a collector subscribes are not delivered.

Parameters

client

The OAuth2Client used for token operations.

storage

The TokenStorage for persisting tokens.

defaultIdStore

Store for the default credential ID.

onStorageError

Optional callback invoked when a storage operation throws. Return true to retry the failed operation once; return false (or omit) to rethrow. The decision is based on the thrown Exception, for example:

onStorageError = { e -> e is android.database.sqlite.SQLiteException }

Constructors

TokenCredentialManager

constructor(client: OAuth2Client, storage: TokenStorage, defaultIdStore: DefaultCredentialIdStore, onStorageError: (Exception) -> Boolean? = null)

Properties

client

val client: OAuth2Client

defaultIdStore

val defaultIdStore: DefaultCredentialIdStore

events

val events: ERROR CLASS: Symbol not found for SharedFlow<com/okta/authfoundation/events/Event>

A read-only flow of credential lifecycle events emitted by this manager.

onStorageError

val onStorageError: (Exception) -> Boolean?

Functions

allIds

suspend fun allIds(): ERROR CLASS: Symbol not found for Result<kotlin/collections/List<kotlin/String>>

Returns IDs of all stored credentials.

find

suspend fun find(where: (TokenMetadata) -> Boolean): ERROR CLASS: Symbol not found for Result<kotlin/collections/List<com/okta/authfoundation/credential/kmp/Credential>>

Returns all credentials matching the given where predicate.

suspend fun find(predicate: (Credential) -> Boolean): ERROR CLASS: Symbol not found for Result<kotlin/collections/List<com/okta/authfoundation/credential/kmp/Credential>>

Returns all credentials matching the given predicate.

get

suspend fun get(id: String): ERROR CLASS: Symbol not found for Result<com/okta/authfoundation/credential/kmp/Credential?>

Retrieves a credential by its id.

getDefault

suspend fun getDefault(): ERROR CLASS: Symbol not found for Result<com/okta/authfoundation/credential/kmp/Credential?>

Returns the default credential, or null if no default has been set.

metadata

suspend fun metadata(id: String): ERROR CLASS: Symbol not found for Result<com/okta/authfoundation/credential/TokenMetadata?>

Returns metadata for the credential with id.

setDefault

suspend fun setDefault(credential: Credential?): ERROR CLASS: Symbol not found for Result<kotlin/Unit>

Sets or clears the default credential.

setMetadata

suspend fun setMetadata(metadata: TokenMetadata): ERROR CLASS: Symbol not found for Result<kotlin/Unit>

Updates metadata for an existing credential.

store

suspend fun store(token: TokenData, tags: Map<String, String> = emptyMap()): ERROR CLASS: Symbol not found for Result<com/okta/authfoundation/credential/kmp/Credential>

Stores a new credential with the given token and optional tags.