NexusInitException | CreateAsync() | The initial sync failed for any reason. InnerException carries the underlying cause (often NexusUnauthorizedException or a transport-level HttpRequestException). |
NexusUnauthorizedException | CreateAsync(), SyncAsync(), EvaluateABAsync(), the write methods | Server returned HTTP 401 - invalid API key, slug/key mismatch, or revoked key. |
NexusBillingException | CreateAsync(), SyncAsync(), EvaluateABAsync(), the write methods | Server returned HTTP 402 - tenant has invoices overdue by more than 14 days. The SDK throttles the background refresh to one attempt every five minutes and serves the last cached snapshot; any success clears it, a 304 Not Modified included, so settling the invoice restores service without a restart. Check client.BillingOverdue on the client. |
NexusConfigException | CreateAsync() | A configuration value cannot be meant - a non-positive Ttl, StreamIdleTimeout, StreamConnectTimeout or PooledConnectionLifetime, an empty SseReconnectCooldown, or a schedule entry below one minute. Option carries the offending property name; the message names the index for a schedule entry. Pass null to select a default. |
NexusNotFoundException | CreateAsync(), SyncAsync(), EvaluateABAsync(), the write methods | Server returned HTTP 404 - unknown subdomain or missing endpoint. |
NexusRateLimitedException | CreateAsync(), SyncAsync(), the write methods | Server returned HTTP 429 without a quarantine body. On a sync, RetryAfter carries the server’s Retry-After and the background refresh waits it out. |
NexusPublicKeyException | GetSecret(), SetSecretAsync(), DeleteSecretAsync(), DeleteSecretVersionAsync() | The client was created with a public key, or the backend reports the key as public. |
NexusServiceKindMismatchException | GetSecret() | The service kind reported by the server is "frontend". Frontend services must not hold secrets, regardless of key type. |
NexusSecretNotFoundException | GetSecret() | The requested key is not in the cache. The exception’s SecretKey property carries the key that was requested. |
NexusWifNotConfiguredException | CreateAsync() | Wif.Enabled = true but no usable workload-identity provider matched the running environment. Wrapped in NexusInitException on the initial connect. |
NexusWifTokenExchangeFailedException | CreateAsync(), SyncAsync() | POST /v1/auth/token-exchange returned a non-2xx response. Wrapped in NexusInitException on the initial connect. |
NexusSessionExpiredException | SyncAsync(), EvaluateABAsync(), the write methods | The WIF session has expired and the SDK could not refresh it, on a client with no API key to fall back to. |
NexusAbAddonNotAvailableException | EvaluateABAsync() | Server returned HTTP 403 - the AB Testing add-on is not active for this tenant. |
NexusQuarantinedException | CreateAsync(), SyncAsync() | Server returned HTTP 429 with a {"error":"quarantined"} body. Reason carries the server’s reason string and ExpiresAt the timestamp sync resumes at; the SDK also suppresses sync and fires IStreamObserver.OnQuarantined until then. |
NexusApiException | CreateAsync(), SyncAsync(), EvaluateABAsync(), the write methods | A status with no dedicated exception, or a response body that could not be decoded. StatusCode carries the HTTP status and ErrorCode the server’s error code (for example tenant_deleted), each null when absent. On the stream it is logged, not thrown. |
NexusEnvironmentDisabledException | CreateAsync(), SyncAsync(), EvaluateABAsync(), the write methods | The project has switched the service’s environment off: HTTP 403 with {"error":"environment_disabled"}. A NexusApiException with StatusCode 403 and ErrorCode environment_disabled. The cache keeps serving; the background refresh and the stream retry every five minutes and on the reconnect schedule rather than at their usual pace, and the first sync that succeeds after the environment is switched on restores both. On the WIF token exchange it is raised in place of NexusWifTokenExchangeFailedException. Wrapped in NexusInitException on the initial connect. |