Tacenta/uniffi.tacenta_ffi/ClientException

ClientException

sealed class ClientException : Exception

Anything that can go wrong, as one case per kind an app can branch on: the same kinds as every other head (decision 0090). Swift sees an enum with a reason on each case; Kotlin a sealed exception class with one subclass per kind. A case may be added, so switch with a default.

Inheritors

Types

Discovery

class Discovery(val reason: String) : ClientException

The service document could not be fetched or read.

ErrorHandler

object ErrorHandler : UniffiRustCallStatusErrorHandler<ClientException>

IdentityMismatch

class IdentityMismatch(val reason: String) : ClientException

The address is bound to a different device identity (trust on first use): resume from the saved state, or use another device number.

Internal

class Internal(val reason: String) : ClientException

A protocol or cryptographic failure, or a bug: worth reporting.

InvalidArgument

class InvalidArgument(val reason: String) : ClientException

The caller's own input was wrong: a malformed address or config, a message over the size limit.

InvalidUsername

class InvalidUsername(val reason: String) : ClientException

The username is not one the server accepts.

Network

class Network(val reason: String) : ClientException

The network or the transport failed; retry later.

NotFound

class NotFound(val reason: String) : ClientException

The address is not registered.

RateLimited

class RateLimited(val reason: String) : ClientException

The server asked for a slower pace: too many failed sign-ins, or the recipient's queue is full. Back off and retry.

ServerFailure

class ServerFailure(val reason: String) : ClientException

The server could not process the request; nothing was applied.

SignInRefused

class SignInRefused(val reason: String) : ClientException

The credentials were refused, or the session expired. Coarse by design.

SignUpRefused

class SignUpRefused(val reason: String) : ClientException

A sign-up was refused for another reason: registration is closed or the handle is reserved.

State

class State(val reason: String) : ClientException

The persisted state was refused: altered, older than the last send, or its secure-storage key is wrong. Whatever else a SecureStore implementation raises surfaces as this case, with its reason. Do not delete the blob.

StoreUnavailable

class StoreUnavailable(val reason: String) : ClientException

The platform's secure store could not be reached: a Keychain before first unlock, a Keystore that needs the user. Nothing was refused; retry after unlock and keep the blob. A SecureStore implementation throws this case for exactly that, and the client passes it through.

UnknownTenant

class UnknownTenant(val reason: String) : ClientException

The API key selects no tenant.

UsernameTaken

class UsernameTaken(val reason: String) : ClientException

The username is already taken in this tenant.

WeakPassword

class WeakPassword(val reason: String) : ClientException

The password is too weak.