@origins-digital/error-utils NPM

@origins-digital/error

A comprehensive error handling package for NestJS applications that provides standardized error responses, HTTP exception handling, and Swagger documentation.

Installation

npm install @origins-digital/error

Features

Standardized error responses
HTTP exception handling
Automatic Swagger documentation for errors
Axios error handling and transformation
Development-friendly error details
Custom error filters

Usage

Basic Setup

import { Module } from '@nestjs/common';
import { APP_FILTER } from '@nestjs/core';
import { ErrorFilter } from '@origins-digital/error';

@Module({
  providers: [
    {
      provide: APP_FILTER,
      useClass: ErrorFilter,
    },
  ],
})
export class AppModule {}

Using HTTP Exceptions

import { Controller } from '@nestjs/common';
import { ApiErrors } from '@origins-digital/error';

@Controller('users')
@ApiErrors([400, 401, 403, 404, 500]) // Document common errors
export class UsersController {
  @Get(':id')
  @ApiErrors([404]) // Document specific endpoint errors
  async getUser(@Param('id') id: string) {
    // Your code here
  }
}

Handling Axios Errors

import { Injectable } from '@nestjs/common';
import { HttpService } from '@nestjs/axios';
import { raiseError } from '@origins-digital/error';

@Injectable()
export class ExternalService {
  constructor(private readonly httpService: HttpService) {}

  async fetchData() {
    try {
      const response = await this.httpService
        .get('https://api.example.com/data')
        .toPromise();
      return response.data;
    } catch (error) {
      // raiseError will format the Axios error properly for logging and error handling
      raiseError(error, { service: 'example-api' });
    }
  }

  async createResource(data: any) {
    try {
      const response = await this.httpService
        .post('https://api.example.com/resources', data)
        .toPromise();
      return response.data;
    } catch (error) {
      // The error will be properly formatted with status code and message
      raiseError(error, { service: 'example-api' });
    }
  }

  async updateResource(id: string, data: any) {
    try {
      const response = await this.httpService
        .patch(`https://api.example.com/resources/${id}`, data)
        .toPromise();
      return response.data;
    } catch (error) {
      // Error will be properly formatted for logging
      raiseError(error, { service: 'example-api' });
    }
  }
}

Error Response Format

All errors follow a standardized format:

{
  "statusCode": 404,
  "type": "NotFoundException",
  "message": "Resource not found",
  "errors": {
    // Optional: Detailed error information
  },
  "stack": "Error stack trace" // Only in development environment
}