Function WrapDoAPIError

internal/client/api_errors.go:29–51

WrapDoAPIError converts SDK-boundary failures into typed errs.* errors: already-typed errors pass through (idempotent), JSON-decode failures become InternalError{SubtypeInvalidResponse}, everything else becomes NetworkError with a chain-derived subtype (timeout / tls / dns / server_error / transport

(err error)

// NetworkError with a chain-derived subtype (timeout / tls / dns /
// server_error / transport-fallback).
func WrapDoAPIError(err error) error {
	if err == nil {
		return nil
	}

	// (1) Pass-through any typed errs.* error.
	if _, ok := errs.ProblemOf(err); ok {
		return err
	}

	// (2) JSON-decode failure at the SDK boundary → InternalError.
	if isJSONDecodeError(err) {
		return errs.NewInternalError(errs.SubtypeInvalidResponse,
			"SDK returned an invalid JSON response: %v", err).
			WithHint("%s", rawAPIJSONHint).
			WithCause(err)
	}

	// (3) Otherwise classify as a network failure with a chain-derived subtype.
	return errs.NewNetworkError(classifyNetworkSubtype(err),
		"API call failed: %v", err).
		WithCause(err)
}

// WrapJSONResponseParseError lifts a response-layer JSON parse failure into
// *errs.InternalError{Subtype: SubtypeInvalidResponse}. Empty body, malformed