@web-ts-toolkit/http-errors

Typed HTTP error classes and structured error payload helpers for backend APIs.

Installation

pnpm add @web-ts-toolkit/http-errors

Highlights

• typed 4xx and 5xx error classes
• HttpError, ClientError, and ServerError base classes
• machine-readable error metadata
• helpers for AIP-193 and RFC 9457 payloads

Quick Start

import { HttpError, UnauthorizedError, ServiceUnavailableError } from '@web-ts-toolkit/http-errors';

throw new UnauthorizedError();
throw new UnauthorizedError('missing bearer token');

throw new HttpError(503);
throw new HttpError(503, 'please try again later');

throw new ServiceUnavailableError();

Main Exports

• HttpError
• specific error classes such as BadRequestError, ForbiddenError, NotFoundError
• toAip193ErrorPayload(...)
• toRfc9457ErrorPayload(...)
• toRfc9457ValidationErrorPayload(...)

Documentation

Full package documentation lives in website/docs/packages/http-errors.md.

• live docs: https://web-ts-toolkit.pages.dev/docs/packages/http-errors