NexusConfigException | A NexusConfig value was rejected. The message names the option, the value and - for a list option - the index: a non-https baseUrl, a non-positive ttl, a blank or missing apiKey, an sseReconnectCooldown entry below one minute. | NexusClient.create |
NexusNoHttpEngineException | No Ktor client engine is available. The message names the dependency line to add. | NexusClient.create |
NexusWifNotConfiguredException | WIF is enabled but no credential could be resolved, a provider’s credential is missing (an empty OIDC token, no AWS credentials, no developer credential for this endpoint), or the developer credentials file is readable beyond its owner. At create the client is not created - it never falls back to API-key authentication. On a refresh it is thrown at once, whatever the session’s state: the credential is gone. | NexusClient.create, any request |
NexusInitException | The initial session exchange or sync failed. cause is the exception below that describes why. | NexusClient.create |
NexusClosedException | The client has been closed. Cached reads still work; anything touching the network does not. | sync, connectStream, evaluateAB, the write methods |
NexusUnauthorizedException | HTTP 401 - invalid API key or endpoint mismatch. | any request |
NexusBillingException | HTTP 402 - the tenant has overdue invoices. The background refresh slows to one attempt every five minutes, observer.onBillingOverdue() is called, and any successful sync clears it. | any request |
NexusNotFoundException | HTTP 404 - the service or secret was not found; usually a wrong baseUrl. | any request |
NexusRateLimitedException | HTTP 429 without a quarantine body. | any request |
NexusQuarantinedException | HTTP 429 with a quarantine body. Carries reason and expiresAt, clamped to at most 24 hours from now; the background refresh pauses until then. | any request |
NexusAbAddonNotAvailableException | HTTP 403 from evaluateAB - the A/B add-on is not active for this project. | evaluateAB |
NexusApiException | Any status no exception above describes. status is the HTTP status, code the server’s error code (or null), operation the call (sync, setSecret, evaluateAB, token-exchange, …). The message never contains the response body. | any request |
NexusEnvironmentDisabledException | A NexusApiException: HTTP 403 environment_disabled - the environment is switched off in the console. Not a key problem: the key stays valid. The background refresh and the stream wait five minutes between attempts, one warning is logged, and the first successful sync clears it. | any request; the cause of a refused token exchange |
NexusServiceLockedException | A NexusApiException: HTTP 423 service_locked - the service is in emergency lockdown. The stream exits immediately (FALLBACK_REASON_SERVICE_LOCKED) and background sync retries halt until an explicit sync() succeeds after the lockdown is lifted. | any request; the cause of a refused token exchange |
NexusForbiddenException | A NexusApiException: any other HTTP 403 - this key may not perform the operation. code names why. | any request but evaluateAB |
NexusResponseTooLargeException | A response body exceeded the SDK’s size cap. The cap is enforced while reading, so an over-large body never reaches the parser as a truncated document. | sync, evaluateAB, the token exchange |
NexusPublicKeyException | A public key (wxp_…) was used to read or write a secret. | getSecret, getSecretFilePath, the write methods |
NexusServiceKindMismatchException | A secret was read on a frontend service, which never syncs secrets. A path is the secret’s contents, so this applies to getSecretFilePath too. | getSecret, getSecretFilePath |
NexusSecretNotFoundException | The secret is not in the current snapshot - including one the server did not deliver. | getSecret, getSecretFilePath |
NexusWifTokenExchangeFailedException | POST /v1/auth/token-exchange failed or answered something unusable. For a refused exchange cause is the API exception, e.g. NexusEnvironmentDisabledException. | NexusClient.create, a session refresh |
NexusSessionExpiredException | The WIF session has expired, the refresh failed, and no apiKey is configured to fall back to; cause is the refresh error. For the developer credential: the session westyx dev setup issued has expired. | any request |