@rtorcato/api-errors

Framework-agnostic HTTP error classes for Node.js APIs.

Install

pnpm add @rtorcato/api-errors

Usage

import {
  BadRequestError,
  ConflictError,
  ForbiddenError,
  HttpError,
  InternalServerError,
  NotFoundError,
  UnauthorizedError,
} from '@rtorcato/api-errors'

throw new NotFoundError('User not found', 'user_not_found')
// err.status  -> 404
// err.code    -> 'user_not_found'
// err.message -> 'User not found'

Every class extends HttpError, which extends Error. Each carries:

• status — HTTP status code (number)
• code — machine-readable error code (string)
• message — human-readable message (inherited from Error)

Available classes

HttpError itself is also exported for custom statuses:

throw new HttpError(429, 'Too many requests', 'rate_limited')

Related

• @rtorcato/api-errors-express — Express middleware adapter
• @rtorcato/api-errors-hono — Hono middleware adapter

Source + changelog: https://github.com/rtorcato/api-common/tree/main/packages/api-errors