authenticate

abstract suspend fun authenticate(hostToken: String): CgsResult<Unit>

Exchanges one of your own tokens for an SDK session, unlocking the content APIs.

Call it after the user has signed in on your side. On success state becomes AuthState.Identified.User; on failure it stays AuthState.Unidentified and the error says why — a rejected token is CgsError.Auth.Invalid, an unreachable server is a CgsError.Network, and only the latter is worth retrying.

The resulting session is persisted and refreshed automatically, so this belongs in your sign-in flow, not in Application.onCreate.

CgsResult.Success once the session is open, CgsResult.Failure otherwise.

hostToken

the token your backend issues for the signed-in user.