Errors and recovery
SDK errors have fixed codes and may include an HTTP status or bounded retryAfterMs. They intentionally exclude tokens, upstream bodies, callback queries and product subjects. Your application must also avoid logging those inputs itself.
Recognize dependency failures
import { isIdentityAvailabilityError } from '@tracecove/identity';
try {
await consumer.syncOnce();
} catch (error) {
if (isIdentityAvailabilityError(error)) {
// Deny effects requiring fresh Identity authority.
// Return a temporary dependency error under product policy.
} else {
throw error;
}
}This classification is not proof of invalid user credentials. Do not automatically erase the user's application session just because a service credential, broker, transport or resource API failed.
Common codes
invalid_sdk_configuration: correct the trusted registered profile. Do not relax validation or accept browser-selected endpoints.identity_transport_unavailable: a bounded transport operation failed or timed out. A logical timeout does not establish that underlying work retired.identity_transport_capacity: the finite local queue is full. Reduce admitted work; do not create unbounded replacement clients.identity_transport_unsettled: earlier physical work still owns its lease. Do not assume it is safe to rearm the operation.identity_backpressure_active: cooldown is active. Respect the bounded retry metadata and product reconciliation policy.unsafe_identity_response: the response did not satisfy the required no-store authority policy.invalid_identity_statusorinvalid_identity_response: treat malformed, incomplete or mismatched authority as unavailable.stale_identity_snapshot: current complete authority must be re-established before the effect.
Reconcile mutations
A timeout or post-response refusal may follow a committed remote effect. Preserve the durable intent, original idempotency key, and exact request body. Read/reconcile the owned operation when your policy permits. The SDK does not automatically retry product connections, acknowledgements, or owner mutations.
For owner operations, a pending result means the command was accepted; it does not mean provider-wide logout or deletion completed. An operation read may need fresh login after the command retires the current grant.
Report an issue
Contact hello@tracecove.com with the preview version, runtime, fixed error code, and a synthetic reproduction. Do not send passwords, tokens, client secrets, callback queries, real customer data or private account identifiers.
Public preview 0.7.0-preview.1 · Not production ready · Status and releases