basalt / http/src / HttpErrorOptions

Interface: HttpErrorOptions

Fourth argument to HttpError — an options object rather than a positional details, so later additions do not keep widening the signature.

Extends

BasaltErrorOptions

Properties

details?

> optional details?: ErrorDetails

Defined in: http/src/errors.ts:30

Machine-readable data the client is meant to act on — which checks failed, how much quota is left, the current version behind a 409. Serialised as error.details, so it is PUBLIC: plain JSON data, no secrets, no internals, and bounded (see sanitizeErrorDetails).

Overrides

BasaltErrorOptions.details

internalDetails?

> optional internalDetails?: ErrorDetails

Defined in: http/src/errors.ts:38

Diagnostic data for the OPERATOR — the upstream reply, the row that conflicted, the id of the internal job. Handed to the error reporter (the adapters' onError, logged as internalDetails by the default one), and never serialised into an HTTP body or an MCP tool result. Put anything you would not show the caller here instead of in details.