NexusInitException | create() (the auto-configuration calls it at startup) | The initial sync failed for any reason. getCause() is the exception below that describes why. |
NexusConfigException | create() | A zero or negative ttl or streamIdleTimeout, an empty sseReconnectCooldown, an entry below one minute. option() names the option; null always means the default and is never rejected. |
NexusUnauthorizedException | any request | HTTP 401 - invalid API key, slug/key mismatch, or a revoked key. |
NexusBillingException | any request | HTTP 402 - the tenant has invoices overdue by more than 14 days. The background refresh slows to one attempt every five minutes and any successful sync - a 304 included - clears it; the cache serves throughout. isBillingOverdue() reports the state. |
NexusNotFoundException | any request | HTTP 404 - an unknown subdomain, or a secret that does not exist on a delete. |
NexusRateLimitedException | any request | HTTP 429 without a quarantine body. |
NexusQuarantinedException | sync() and the other requests | HTTP 429 with {"error":"quarantined",...} - the service is quarantined until expiresAt(), clamped to at most 24 hours ahead. The background refresh pauses until then; NexusStreamObserver.onQuarantined is also called. |
NexusAbAddonNotAvailableException | evaluateAB() | HTTP 403 - the AB Testing add-on is not active for the project. |
NexusEnvironmentDisabledException | any request, and as the cause of a token-exchange failure | 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. |
NexusServiceLockedException | any request, and as the cause of a token-exchange failure | HTTP 423 service_locked - the service is in emergency lockdown. The stream exits immediately (onFallback("service-locked")) and background sync retries halt until an explicit sync() succeeds after the lockdown is lifted. |
NexusApiException | any request | A status no exception above describes. statusCode() is the HTTP status, errorCode() the server’s error code (or null), operation() the call (sync, setSecret, evaluateAB, token-exchange, …). The message never contains the response body. |
NexusPublicKeyException | getSecret(), the write API | The client uses a public key. Thrown without a network call. |
NexusServiceKindMismatchException | getSecret() | The service kind reported by the server is frontend; frontend services do not hold secrets. |
NexusSecretNotFoundException | getSecret() | The key is not in the cache - including a secret the server did not deliver. getSecretKey() returns the requested name. |
NexusWIFNotConfiguredException | create(), any request | WIF is enabled but no provider found credential material, a provider’s credential is missing (an empty OIDC token, no AWS credentials, no developer credential for this endpoint), or the developer credential file is readable beyond its owner. Thrown at once even while a session is still valid - the credential is gone. |
NexusWIFTokenExchangeFailedException | create(), a session refresh | POST /v1/auth/token-exchange failed or answered something unusable. For a refused exchange getCause() is the API exception, e.g. NexusEnvironmentDisabledException. |
NexusSessionExpiredException | any request | The WIF session has expired, the refresh failed, and no apiKey is configured to fall back to; getCause() is the refresh error. For the developer provider: the credential westyx dev setup wrote has expired. |