Function: throwOcapiError()

throwOcapiError(error, response, prefix, requiredScopes?): never

Throws a well-formed Error for a failed OCAPI call.

Centralizes OCAPI-terminal error handling so every call site behaves consistently:

OCAPI deprecation faults become an OcapiDeprecatedError with actionable SCAPI-setup guidance, naming requiredScopes when the operation has a SCAPI equivalent.
Everything else throws Error(${prefix}: ${message}) where message is the fault text from getApiErrorMessage.

The original error is always attached as cause for debug logging.

Parameters

unknown

The error object from an openapi-fetch result.

The HTTP response (for status fallback).

Response | { status: number; statusText: string; }

string

Operation-specific prefix, e.g. 'Failed to list code versions'.

string[]

SCAPI scope(s) the equivalent operation needs, named in the deprecation message. Omit for OCAPI-only operations.

never

Always throws — return type is never.