Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Typed error hierarchy and HTTP error response serialization.
npm install @latimer-woods-tech/errors
FactoryErrorError with a machine-readable code and optional context bag.
class FactoryError extends Error {
readonly code: string;
readonly context: Record<string, unknown>;
readonly statusCode: number;
}
| Class | statusCode | Default code |
|---|---|---|
ValidationError | 400 | VALIDATION_ERROR |
AuthError | 401 | AUTH_ERROR |
ForbiddenError | 403 | FORBIDDEN |
NotFoundError | 404 | NOT_FOUND |
ConflictError | 409 | CONFLICT |
RateLimitError | 429 | RATE_LIMIT |
InternalError | 500 | INTERNAL_ERROR |
toErrorResponse(error)FactoryError into a JSON-safe response envelope:
function toErrorResponse(error: FactoryError): ErrorResponse;
type ErrorResponse = {
error: {
code: string;
message: string;
context?: Record<string, unknown>;
};
};
ErrorCodesimport { ErrorCodes } from '@latimer-woods-tech/errors';
// ErrorCodes.AUTH_TOKEN_INVALID, ErrorCodes.AUTH_TOKEN_EXPIRED, etc.
import { ValidationError, toErrorResponse } from '@latimer-woods-tech/errors';
throw new ValidationError('Email is required', {
code: 'VALIDATION_EMAIL_REQUIRED',
context: { field: 'email' },
});