nestjs-exception-handler 1.0.0

package/README.md

@@ -0,0 +1,240 @@
+# NestJS Exception Handler
+
+[![npm version](https://badge.fury.io/js/nestjs-exception-handler.svg)](https://badge.fury.io/js/nestjs-exception-handler)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A production-grade global exception handling system for NestJS applications that provides standardized error responses, supports Prisma errors, DTO validation, HTTP exceptions, and more.
+
+## Features
+
+- **Standardized Error Responses**: Consistent error format across your application
+- **Prisma Integration**: Built-in support for Prisma error codes (P2002, P2003, etc.)
+- **DTO Validation**: Automatic extraction of validation errors from class-validator
+- **HTTP Exception Support**: Handles all NestJS HTTP exceptions
+- **Extensible**: Plugin system for custom formatters
+- **Type Safe**: Full TypeScript support
+- **Production Ready**: Includes logging and stack trace control
+
+## Installation
+
+```bash
+npm install nestjs-exception-handler
+```
+
+## Quick Start
+
+### 1. Import the module
+
+```typescript
+import { Module } from '@nestjs/common';
+import { ExceptionHandlerModule } from 'nestjs-exception-handler';
+
+@Module({
+  imports: [ExceptionHandlerModule.forRoot()],
+})
+export class AppModule {}
+```
+
+### 2. Apply the global filter
+
+```typescript
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import { GlobalExceptionFilter } from 'nestjs-exception-handler';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  const filter = app.get(GlobalExceptionFilter);
+  app.useGlobalFilters(filter);
+
+  await app.listen(3000);
+}
+bootstrap();
+```
+
+## Configuration
+
+```typescript
+ExceptionHandlerModule.forRoot({
+  enableLogging: true, // Enable structured logging
+  hideStackTrace: true, // Hide stack traces in production
+});
+```
+
+## Standard Error Response Format
+
+All responses follow this structure:
+
+```json
+{
+  "success": false,
+  "message": "Database error",
+  "errorMessages": [
+    {
+      "path": "email",
+      "message": "User with this email already exists"
+    }
+  ]
+}
+```
+
+## Supported Error Types
+
+### Prisma Errors
+
+Handles all Prisma error types with automatic path extraction:
+
+- `P2002` - Unique constraint violation
+- `P2003` - Foreign key constraint violation
+- `P2005` - Invalid value
+- `P2006` - Invalid format
+- `P2025` - Record not found
+
+**Example:**
+
+```json
+{
+  "path": "email",
+  "message": "A record with this email already exists."
+}
+```
+
+### DTO Validation Errors
+
+Automatically extracts validation errors from class-validator:
+
+```typescript
+// Example validation error
+{
+  "path": "email",
+  "message": "email must be a valid email"
+}
+```
+
+### HTTP Exceptions
+
+Handles all NestJS HTTP exceptions:
+
+```typescript
+throw new BadRequestException('Invalid input');
+```
+
+### Unknown Errors
+
+Fallback handler returns generic error message.
+
+## Creating Custom Formatters
+
+Extend the `ExceptionFormatter` interface to create custom formatters:
+
+```typescript
+import { ExceptionFormatter, ErrorMessage } from 'nestjs-exception-handler';
+
+export class CustomExceptionFormatter implements ExceptionFormatter {
+  supports(exception: unknown): boolean {
+    return exception instanceof CustomError;
+  }
+
+  format(exception: unknown): ErrorMessage[] {
+    const error = exception as CustomError;
+    return [{ path: error.field, message: error.message }];
+  }
+
+  message(exception: unknown): string {
+    return 'Custom error occurred';
+  }
+}
+```
+
+## API Reference
+
+### ExceptionHandlerModule
+
+- `forRoot(config?)` - Register globally with optional configuration
+- `forFeature(config?)` - Register for specific modules
+
+### ExceptionHandlerService
+
+- `registerFormatter(formatter)` - Add custom formatter
+- `formatException(exception)` - Format exception to standardized response
+- `formatErrors(exception)` - Get error messages array
+- `getErrorMessage(exception)` - Get error message string
+- `getAllFormatters()` - Get registered formatters
+
+### GlobalExceptionFilter
+
+- Catches all unhandled exceptions
+- Logs structured errors
+- Returns standardized responses
+
+## Error Response Examples
+
+### Prisma Unique Constraint
+
+```json
+{
+  "success": false,
+  "message": "A record with this email already exists.",
+  "errorMessages": [
+    {
+      "path": "email",
+      "message": "A record with this email already exists."
+    }
+  ]
+}
+```
+
+### Validation Error
+
+```json
+{
+  "success": false,
+  "message": "Validation failed",
+  "errorMessages": [
+    {
+      "path": "email",
+      "message": "email must be a valid email"
+    },
+    {
+      "path": "password",
+      "message": "password must be longer than 8 characters"
+    }
+  ]
+}
+```
+
+### HTTP Exception
+
+```json
+{
+  "success": false,
+  "message": "Resource not found",
+  "errorMessages": [
+    {
+      "path": "unknown",
+      "message": "Resource not found"
+    }
+  ]
+}
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+MIT
+
+## Author
+
+**Nurul Islam Rimon**
+
+- GitHub: [nurulislamrimon](https://github.com/nurulislamrimon)

package/dist/index.d.mts

@@ -0,0 +1,96 @@
+import { ExceptionFilter, ArgumentsHost, DynamicModule } from '@nestjs/common';
+
+interface ErrorMessage {
+    path: string;
+    message: string;
+}
+interface StandardErrorResponse {
+    success: boolean;
+    message: string;
+    errorMessages: ErrorMessage[];
+}
+
+interface ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+}
+
+interface ExceptionHandlerConfig {
+    enableLogging?: boolean;
+    hideStackTrace?: boolean;
+}
+
+declare const DEFAULT_ERROR_MESSAGES: {
+    UNKNOWN_ERROR: string;
+    VALIDATION_ERROR: string;
+    DATABASE_ERROR: string;
+    NOT_FOUND: string;
+    UNAUTHORIZED: string;
+    FORBIDDEN: string;
+    CONFLICT: string;
+    BAD_REQUEST: string;
+};
+declare const PRISMA_ERROR_MESSAGES: Record<string, string>;
+declare const DEFAULT_PATH = "unknown";
+
+declare function isPrismaError(exception: unknown): boolean;
+
+declare class PrismaExceptionFormatter implements ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+}
+
+declare class DtoExceptionFormatter implements ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+    private formatValidationErrors;
+    private formatChildrenErrors;
+}
+
+declare class HttpExceptionFormatter implements ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+}
+
+declare class UnknownExceptionFormatter implements ExceptionFormatter {
+    supports(_exception: unknown): boolean;
+    format(_exception: unknown): ErrorMessage[];
+    message(_exception: unknown): string;
+}
+
+declare class ExceptionHandlerService {
+    private formatters;
+    private defaultFormatter;
+    constructor();
+    registerFormatter(formatter: ExceptionFormatter): void;
+    getFormatter(exception: unknown): ExceptionFormatter;
+    formatException(exception: unknown): {
+        errors: ErrorMessage[];
+        message: string;
+    };
+    formatErrors(exception: unknown): ErrorMessage[];
+    getErrorMessage(exception: unknown): string;
+    getAllFormatters(): ExceptionFormatter[];
+}
+
+declare class GlobalExceptionFilter implements ExceptionFilter {
+    private exceptionHandlerService;
+    private readonly logger;
+    private config;
+    constructor(exceptionHandlerService: ExceptionHandlerService, config?: ExceptionHandlerConfig);
+    catch(exception: unknown, host: ArgumentsHost): void;
+    private getStatusCode;
+    private logError;
+}
+
+declare class ExceptionHandlerModule {
+    static forRoot(config?: ExceptionHandlerConfig): DynamicModule;
+    static forFeature(config?: ExceptionHandlerConfig): DynamicModule;
+}
+declare function initializeFormatters(service: ExceptionHandlerService): void;
+
+export { DEFAULT_ERROR_MESSAGES, DEFAULT_PATH, DtoExceptionFormatter, ErrorMessage, ExceptionFormatter, ExceptionHandlerConfig, ExceptionHandlerModule, ExceptionHandlerService, GlobalExceptionFilter, HttpExceptionFormatter, PRISMA_ERROR_MESSAGES, PrismaExceptionFormatter, StandardErrorResponse, UnknownExceptionFormatter, initializeFormatters, isPrismaError };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { ExceptionFilter, ArgumentsHost, DynamicModule } from '@nestjs/common';
+
+interface ErrorMessage {
+    path: string;
+    message: string;
+}
+interface StandardErrorResponse {
+    success: boolean;
+    message: string;
+    errorMessages: ErrorMessage[];
+}
+
+interface ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+}
+
+interface ExceptionHandlerConfig {
+    enableLogging?: boolean;
+    hideStackTrace?: boolean;
+}
+
+declare const DEFAULT_ERROR_MESSAGES: {
+    UNKNOWN_ERROR: string;
+    VALIDATION_ERROR: string;
+    DATABASE_ERROR: string;
+    NOT_FOUND: string;
+    UNAUTHORIZED: string;
+    FORBIDDEN: string;
+    CONFLICT: string;
+    BAD_REQUEST: string;
+};
+declare const PRISMA_ERROR_MESSAGES: Record<string, string>;
+declare const DEFAULT_PATH = "unknown";
+
+declare function isPrismaError(exception: unknown): boolean;
+
+declare class PrismaExceptionFormatter implements ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+}
+
+declare class DtoExceptionFormatter implements ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+    private formatValidationErrors;
+    private formatChildrenErrors;
+}
+
+declare class HttpExceptionFormatter implements ExceptionFormatter {
+    supports(exception: unknown): boolean;
+    format(exception: unknown): ErrorMessage[];
+    message(exception: unknown): string;
+}
+
+declare class UnknownExceptionFormatter implements ExceptionFormatter {
+    supports(_exception: unknown): boolean;
+    format(_exception: unknown): ErrorMessage[];
+    message(_exception: unknown): string;
+}
+
+declare class ExceptionHandlerService {
+    private formatters;
+    private defaultFormatter;
+    constructor();
+    registerFormatter(formatter: ExceptionFormatter): void;
+    getFormatter(exception: unknown): ExceptionFormatter;
+    formatException(exception: unknown): {
+        errors: ErrorMessage[];
+        message: string;
+    };
+    formatErrors(exception: unknown): ErrorMessage[];
+    getErrorMessage(exception: unknown): string;
+    getAllFormatters(): ExceptionFormatter[];
+}
+
+declare class GlobalExceptionFilter implements ExceptionFilter {
+    private exceptionHandlerService;
+    private readonly logger;
+    private config;
+    constructor(exceptionHandlerService: ExceptionHandlerService, config?: ExceptionHandlerConfig);
+    catch(exception: unknown, host: ArgumentsHost): void;
+    private getStatusCode;
+    private logError;
+}
+
+declare class ExceptionHandlerModule {
+    static forRoot(config?: ExceptionHandlerConfig): DynamicModule;
+    static forFeature(config?: ExceptionHandlerConfig): DynamicModule;
+}
+declare function initializeFormatters(service: ExceptionHandlerService): void;
+
+export { DEFAULT_ERROR_MESSAGES, DEFAULT_PATH, DtoExceptionFormatter, ErrorMessage, ExceptionFormatter, ExceptionHandlerConfig, ExceptionHandlerModule, ExceptionHandlerService, GlobalExceptionFilter, HttpExceptionFormatter, PRISMA_ERROR_MESSAGES, PrismaExceptionFormatter, StandardErrorResponse, UnknownExceptionFormatter, initializeFormatters, isPrismaError };

package/dist/index.js

@@ -0,0 +1,384 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  DEFAULT_ERROR_MESSAGES: () => DEFAULT_ERROR_MESSAGES,
+  DEFAULT_PATH: () => DEFAULT_PATH,
+  DtoExceptionFormatter: () => DtoExceptionFormatter,
+  ExceptionHandlerModule: () => ExceptionHandlerModule,
+  ExceptionHandlerService: () => ExceptionHandlerService,
+  GlobalExceptionFilter: () => GlobalExceptionFilter,
+  HttpExceptionFormatter: () => HttpExceptionFormatter,
+  PRISMA_ERROR_MESSAGES: () => PRISMA_ERROR_MESSAGES,
+  PrismaExceptionFormatter: () => PrismaExceptionFormatter,
+  UnknownExceptionFormatter: () => UnknownExceptionFormatter,
+  initializeFormatters: () => initializeFormatters,
+  isPrismaError: () => isPrismaError
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/constants/default-messages.ts
+var DEFAULT_ERROR_MESSAGES = {
+  UNKNOWN_ERROR: "An unexpected error occurred",
+  VALIDATION_ERROR: "Validation failed",
+  DATABASE_ERROR: "Database error",
+  NOT_FOUND: "Resource not found",
+  UNAUTHORIZED: "Unauthorized access",
+  FORBIDDEN: "Access forbidden",
+  CONFLICT: "Conflict occurred",
+  BAD_REQUEST: "Bad request"
+};
+var PRISMA_ERROR_MESSAGES = {
+  P2002: "A record with this {field} already exists.",
+  P2003: "This {field} does not exist.",
+  P2005: "Invalid value for {field}.",
+  P2006: "Invalid format for {field}.",
+  P2025: "Record not found."
+};
+var DEFAULT_PATH = "unknown";
+
+// src/utils/is-prisma-error.ts
+function isPrismaError(exception) {
+  if (!exception || typeof exception !== "object") {
+    return false;
+  }
+  const error = exception;
+  const hasErrorCode = typeof error.code === "string";
+  const hasClientVersion = typeof error.clientVersion === "string";
+  const hasMeta = typeof error.meta === "object";
+  return hasErrorCode && (hasClientVersion || hasMeta);
+}
+
+// src/formatters/prisma-exception.formatter.ts
+var PrismaExceptionFormatter = class {
+  supports(exception) {
+    return isPrismaError(exception);
+  }
+  format(exception) {
+    const error = exception;
+    const code = error.code;
+    const meta = error.meta;
+    const target = error.target;
+    const messageTemplate = PRISMA_ERROR_MESSAGES[code] || "Database operation failed";
+    let path = "unknown";
+    let message = messageTemplate;
+    if (code === "P2002" && target && target.length > 0) {
+      path = target[0];
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2003" && meta?.field_name) {
+      path = meta.field_name;
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2005" && meta?.field_name) {
+      path = meta.field_name;
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2006" && meta?.field_name) {
+      path = meta.field_name;
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2025") {
+      path = "record";
+      message = messageTemplate;
+    }
+    return [{ path, message }];
+  }
+  message(exception) {
+    const error = exception;
+    const code = error.code;
+    return PRISMA_ERROR_MESSAGES[code] || "Database error";
+  }
+};
+
+// src/formatters/dto-exception.formatter.ts
+var DtoExceptionFormatter = class {
+  supports(exception) {
+    if (!exception || typeof exception !== "object") {
+      return false;
+    }
+    const error = exception;
+    return Array.isArray(error.validationErrors) || Array.isArray(error.children) && error.constraints !== void 0;
+  }
+  format(exception) {
+    const error = exception;
+    const validationErrors = error.validationErrors;
+    const children = error.children;
+    if (validationErrors) {
+      return this.formatValidationErrors(validationErrors);
+    }
+    if (children) {
+      return this.formatChildrenErrors(children);
+    }
+    return [{ path: "unknown", message: "Validation failed" }];
+  }
+  message(exception) {
+    const error = exception;
+    const validationErrors = error.validationErrors;
+    const children = error.children;
+    if (validationErrors && validationErrors.length > 0) {
+      const firstError = validationErrors[0];
+      const constraints = firstError.constraints;
+      if (constraints) {
+        return Object.values(constraints)[0];
+      }
+    }
+    if (children && children.length > 0) {
+      return "Validation failed for nested fields";
+    }
+    return "Validation failed";
+  }
+  formatValidationErrors(errors) {
+    return errors.flatMap((error) => {
+      const constraints = error.constraints;
+      if (constraints) {
+        return Object.entries(constraints).map(([, value]) => ({
+          path: error.property,
+          message: value
+        }));
+      }
+      return [];
+    });
+  }
+  formatChildrenErrors(children) {
+    return children.flatMap((child) => {
+      const constraints = child.constraints;
+      if (constraints) {
+        return Object.entries(constraints).map(([, value]) => ({
+          path: child.property,
+          message: value
+        }));
+      }
+      return [];
+    });
+  }
+};
+
+// src/formatters/http-exception.formatter.ts
+var import_common = require("@nestjs/common");
+var HttpExceptionFormatter = class {
+  supports(exception) {
+    return exception instanceof import_common.HttpException;
+  }
+  format(exception) {
+    const httpException = exception;
+    const response = httpException.getResponse();
+    if (typeof response === "string") {
+      return [{ path: "unknown", message: response }];
+    }
+    if (typeof response === "object" && response !== null) {
+      const responseObj = response;
+      if (responseObj.message && Array.isArray(responseObj.message)) {
+        return responseObj.message.map((msg) => ({
+          path: "unknown",
+          message: msg
+        }));
+      }
+      if (responseObj.message && typeof responseObj.message === "string") {
+        return [{ path: "unknown", message: responseObj.message }];
+      }
+      if (responseObj.error && typeof responseObj.error === "string") {
+        return [{ path: "unknown", message: responseObj.error }];
+      }
+    }
+    return [{ path: "unknown", message: "An error occurred" }];
+  }
+  message(exception) {
+    const httpException = exception;
+    const response = httpException.getResponse();
+    if (typeof response === "string") {
+      return response;
+    }
+    if (typeof response === "object" && response !== null) {
+      const responseObj = response;
+      if (responseObj.message && typeof responseObj.message === "string") {
+        return responseObj.message;
+      }
+      if (responseObj.error && typeof responseObj.error === "string") {
+        return responseObj.error;
+      }
+    }
+    return "An error occurred";
+  }
+};
+
+// src/formatters/unknown-exception.formatter.ts
+var UnknownExceptionFormatter = class {
+  supports(_exception) {
+    return true;
+  }
+  format(_exception) {
+    return [
+      {
+        path: DEFAULT_PATH,
+        message: "Internal server error"
+      }
+    ];
+  }
+  message(_exception) {
+    return "Internal server error";
+  }
+};
+
+// src/services/exception-handler.service.ts
+var import_common2 = require("@nestjs/common");
+var ExceptionHandlerService = class {
+  constructor() {
+    this.formatters = [];
+    this.defaultFormatter = new UnknownExceptionFormatter();
+  }
+  registerFormatter(formatter) {
+    this.formatters.push(formatter);
+  }
+  getFormatter(exception) {
+    for (const formatter of this.formatters) {
+      if (formatter.supports(exception)) {
+        return formatter;
+      }
+    }
+    return this.defaultFormatter;
+  }
+  formatException(exception) {
+    const formatter = this.getFormatter(exception);
+    const errors = formatter.format(exception);
+    const message = formatter.message(exception);
+    return { errors, message };
+  }
+  formatErrors(exception) {
+    const formatter = this.getFormatter(exception);
+    return formatter.format(exception);
+  }
+  getErrorMessage(exception) {
+    const formatter = this.getFormatter(exception);
+    return formatter.message(exception);
+  }
+  getAllFormatters() {
+    return [...this.formatters];
+  }
+};
+ExceptionHandlerService = __decorateClass([
+  (0, import_common2.Injectable)()
+], ExceptionHandlerService);
+
+// src/filter/global-exception.filter.ts
+var import_common3 = require("@nestjs/common");
+var GlobalExceptionFilter = class {
+  constructor(exceptionHandlerService, config) {
+    this.exceptionHandlerService = exceptionHandlerService;
+    this.logger = new import_common3.Logger(GlobalExceptionFilter.name);
+    this.config = config || { enableLogging: true, hideStackTrace: false };
+  }
+  catch(exception, host) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse();
+    const request = ctx.getRequest();
+    const { errors, message } = this.exceptionHandlerService.formatException(exception);
+    const status = this.getStatusCode(exception);
+    const errorResponse = {
+      success: false,
+      message,
+      errorMessages: errors
+    };
+    if (this.config.enableLogging) {
+      this.logError(request, status, errors, exception);
+    }
+    response.status(status).json(errorResponse);
+  }
+  getStatusCode(exception) {
+    if (exception instanceof import_common3.HttpException) {
+      return exception.getStatus();
+    }
+    return import_common3.HttpStatus.INTERNAL_SERVER_ERROR;
+  }
+  logError(request, status, errorMessages, exception) {
+    const method = request.method;
+    const url = request.url;
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const logData = {
+      timestamp,
+      method,
+      url,
+      status,
+      errorMessages,
+      stack: this.config.hideStackTrace ? void 0 : exception?.stack
+    };
+    this.logger.error(`${method} ${url} - ${status}`, JSON.stringify(logData));
+  }
+};
+GlobalExceptionFilter = __decorateClass([
+  (0, import_common3.Catch)()
+], GlobalExceptionFilter);
+
+// src/module/exception-handler.module.ts
+var import_common4 = require("@nestjs/common");
+var ExceptionHandlerModule = class {
+  static forRoot(config) {
+    const providers = [
+      ExceptionHandlerService,
+      {
+        provide: GlobalExceptionFilter,
+        useFactory: (service) => {
+          return new GlobalExceptionFilter(service, config);
+        },
+        inject: [ExceptionHandlerService]
+      }
+    ];
+    return {
+      module: ExceptionHandlerModule,
+      providers,
+      exports: [ExceptionHandlerService, GlobalExceptionFilter],
+      global: true
+    };
+  }
+  static forFeature(config) {
+    return this.forRoot(config);
+  }
+};
+ExceptionHandlerModule = __decorateClass([
+  (0, import_common4.Module)({})
+], ExceptionHandlerModule);
+function initializeFormatters(service) {
+  service.registerFormatter(new PrismaExceptionFormatter());
+  service.registerFormatter(new DtoExceptionFormatter());
+  service.registerFormatter(new HttpExceptionFormatter());
+  service.registerFormatter(new UnknownExceptionFormatter());
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_ERROR_MESSAGES,
+  DEFAULT_PATH,
+  DtoExceptionFormatter,
+  ExceptionHandlerModule,
+  ExceptionHandlerService,
+  GlobalExceptionFilter,
+  HttpExceptionFormatter,
+  PRISMA_ERROR_MESSAGES,
+  PrismaExceptionFormatter,
+  UnknownExceptionFormatter,
+  initializeFormatters,
+  isPrismaError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants/default-messages.ts","../src/utils/is-prisma-error.ts","../src/formatters/prisma-exception.formatter.ts","../src/formatters/dto-exception.formatter.ts","../src/formatters/http-exception.formatter.ts","../src/formatters/unknown-exception.formatter.ts","../src/services/exception-handler.service.ts","../src/filter/global-exception.filter.ts","../src/module/exception-handler.module.ts"],"sourcesContent":["// Interfaces\nexport * from './interfaces';\n\n// Constants\nexport * from './constants';\n\n// Utilities\nexport * from './utils/is-prisma-error';\n\n// Formatters\nexport * from './formatters';\n\n// Services\nexport * from './services/exception-handler.service';\n\n// Filters\nexport * from './filter/global-exception.filter';\n\n// Module\nexport * from './module/exception-handler.module';\n","export const DEFAULT_ERROR_MESSAGES = {\n  UNKNOWN_ERROR: 'An unexpected error occurred',\n  VALIDATION_ERROR: 'Validation failed',\n  DATABASE_ERROR: 'Database error',\n  NOT_FOUND: 'Resource not found',\n  UNAUTHORIZED: 'Unauthorized access',\n  FORBIDDEN: 'Access forbidden',\n  CONFLICT: 'Conflict occurred',\n  BAD_REQUEST: 'Bad request',\n};\n\nexport const PRISMA_ERROR_MESSAGES: Record<string, string> = {\n  P2002: 'A record with this {field} already exists.',\n  P2003: 'This {field} does not exist.',\n  P2005: 'Invalid value for {field}.',\n  P2006: 'Invalid format for {field}.',\n  P2025: 'Record not found.',\n};\n\nexport const DEFAULT_PATH = 'unknown';\n","export function isPrismaError(exception: unknown): boolean {\n  if (!exception || typeof exception !== 'object') {\n    return false;\n  }\n\n  const error = exception as Record<string, unknown>;\n\n  // Check for Prisma error characteristics\n  const hasErrorCode = typeof error.code === 'string';\n  const hasClientVersion = typeof error.clientVersion === 'string';\n  const hasMeta = typeof error.meta === 'object';\n\n  // Prisma errors typically have these properties\n  return hasErrorCode && (hasClientVersion || hasMeta);\n}\n","import { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\nimport { isPrismaError } from '../utils/is-prisma-error';\nimport { PRISMA_ERROR_MESSAGES } from '../constants/default-messages';\n\nexport class PrismaExceptionFormatter implements ExceptionFormatter {\n  supports(exception: unknown): boolean {\n    return isPrismaError(exception);\n  }\n\n  format(exception: unknown): ErrorMessage[] {\n    const error = exception as Record<string, unknown>;\n    const code = error.code as string;\n    const meta = error.meta as Record<string, string> | undefined;\n    const target = error.target as string[] | undefined;\n\n    const messageTemplate = PRISMA_ERROR_MESSAGES[code] || 'Database operation failed';\n    let path = 'unknown';\n    let message = messageTemplate;\n\n    if (code === 'P2002' && target && target.length > 0) {\n      path = target[0];\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2003' && meta?.field_name) {\n      path = meta.field_name;\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2005' && meta?.field_name) {\n      path = meta.field_name;\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2006' && meta?.field_name) {\n      path = meta.field_name;\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2025') {\n      path = 'record';\n      message = messageTemplate;\n    }\n\n    return [{ path, message }];\n  }\n\n  message(exception: unknown): string {\n    const error = exception as Record<string, unknown>;\n    const code = error.code as string;\n    return PRISMA_ERROR_MESSAGES[code] || 'Database error';\n  }\n}\n","import { ValidationError } from '@nestjs/common';\nimport { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\n\nexport class DtoExceptionFormatter implements ExceptionFormatter {\n  supports(exception: unknown): boolean {\n    if (!exception || typeof exception !== 'object') {\n      return false;\n    }\n\n    const error = exception as Record<string, unknown>;\n    return (\n      Array.isArray(error.validationErrors) ||\n      (Array.isArray(error.children) && error.constraints !== undefined)\n    );\n  }\n\n  format(exception: unknown): ErrorMessage[] {\n    const error = exception as Record<string, unknown>;\n    const validationErrors = error.validationErrors as ValidationError[] | undefined;\n    const children = error.children as ValidationError[] | undefined;\n\n    if (validationErrors) {\n      return this.formatValidationErrors(validationErrors);\n    }\n\n    if (children) {\n      return this.formatChildrenErrors(children);\n    }\n\n    return [{ path: 'unknown', message: 'Validation failed' }];\n  }\n\n  message(exception: unknown): string {\n    const error = exception as Record<string, unknown>;\n    const validationErrors = error.validationErrors as ValidationError[] | undefined;\n    const children = error.children as ValidationError[] | undefined;\n\n    if (validationErrors && validationErrors.length > 0) {\n      const firstError = validationErrors[0];\n      const constraints = firstError.constraints;\n      if (constraints) {\n        return Object.values(constraints)[0];\n      }\n    }\n\n    if (children && children.length > 0) {\n      return 'Validation failed for nested fields';\n    }\n\n    return 'Validation failed';\n  }\n\n  private formatValidationErrors(errors: ValidationError[]): ErrorMessage[] {\n    return errors.flatMap((error) => {\n      const constraints = error.constraints;\n      if (constraints) {\n        return Object.entries(constraints).map(([, value]) => ({\n          path: error.property,\n          message: value,\n        }));\n      }\n      return [];\n    });\n  }\n\n  private formatChildrenErrors(children: ValidationError[]): ErrorMessage[] {\n    return children.flatMap((child) => {\n      const constraints = child.constraints;\n      if (constraints) {\n        return Object.entries(constraints).map(([, value]) => ({\n          path: child.property,\n          message: value,\n        }));\n      }\n      return [];\n    });\n  }\n}\n","import { HttpException } from '@nestjs/common';\nimport { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\n\nexport class HttpExceptionFormatter implements ExceptionFormatter {\n  supports(exception: unknown): boolean {\n    return exception instanceof HttpException;\n  }\n\n  format(exception: unknown): ErrorMessage[] {\n    const httpException = exception as HttpException;\n    const response = httpException.getResponse();\n\n    if (typeof response === 'string') {\n      return [{ path: 'unknown', message: response }];\n    }\n\n    if (typeof response === 'object' && response !== null) {\n      const responseObj = response as Record<string, unknown>;\n\n      if (responseObj.message && Array.isArray(responseObj.message)) {\n        // Handle validation errors from class-validator in HTTP exceptions\n        return (responseObj.message as string[]).map((msg) => ({\n          path: 'unknown',\n          message: msg,\n        }));\n      }\n\n      if (responseObj.message && typeof responseObj.message === 'string') {\n        return [{ path: 'unknown', message: responseObj.message }];\n      }\n\n      if (responseObj.error && typeof responseObj.error === 'string') {\n        return [{ path: 'unknown', message: responseObj.error }];\n      }\n    }\n\n    return [{ path: 'unknown', message: 'An error occurred' }];\n  }\n\n  message(exception: unknown): string {\n    const httpException = exception as HttpException;\n    const response = httpException.getResponse();\n\n    if (typeof response === 'string') {\n      return response;\n    }\n\n    if (typeof response === 'object' && response !== null) {\n      const responseObj = response as Record<string, unknown>;\n\n      if (responseObj.message && typeof responseObj.message === 'string') {\n        return responseObj.message;\n      }\n\n      if (responseObj.error && typeof responseObj.error === 'string') {\n        return responseObj.error;\n      }\n    }\n\n    return 'An error occurred';\n  }\n}\n","import { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\nimport { DEFAULT_PATH } from '../constants/default-messages';\n\nexport class UnknownExceptionFormatter implements ExceptionFormatter {\n  supports(_exception: unknown): boolean {\n    return true;\n  }\n\n  format(_exception: unknown): ErrorMessage[] {\n    return [\n      {\n        path: DEFAULT_PATH,\n        message: 'Internal server error',\n      },\n    ];\n  }\n\n  message(_exception: unknown): string {\n    return 'Internal server error';\n  }\n}\n","import { Injectable } from '@nestjs/common';\nimport { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\nimport { UnknownExceptionFormatter } from '../formatters/unknown-exception.formatter';\n\n@Injectable()\nexport class ExceptionHandlerService {\n  private formatters: ExceptionFormatter[] = [];\n  private defaultFormatter: ExceptionFormatter;\n\n  constructor() {\n    this.defaultFormatter = new UnknownExceptionFormatter();\n  }\n\n  registerFormatter(formatter: ExceptionFormatter): void {\n    this.formatters.push(formatter);\n  }\n\n  getFormatter(exception: unknown): ExceptionFormatter {\n    for (const formatter of this.formatters) {\n      if (formatter.supports(exception)) {\n        return formatter;\n      }\n    }\n    return this.defaultFormatter;\n  }\n\n  formatException(exception: unknown): { errors: ErrorMessage[]; message: string } {\n    const formatter = this.getFormatter(exception);\n    const errors = formatter.format(exception);\n    const message = formatter.message(exception);\n\n    return { errors, message };\n  }\n\n  formatErrors(exception: unknown): ErrorMessage[] {\n    const formatter = this.getFormatter(exception);\n    return formatter.format(exception);\n  }\n\n  getErrorMessage(exception: unknown): string {\n    const formatter = this.getFormatter(exception);\n    return formatter.message(exception);\n  }\n\n  getAllFormatters(): ExceptionFormatter[] {\n    return [...this.formatters];\n  }\n}\n","import {\n  ExceptionFilter,\n  Catch,\n  ArgumentsHost,\n  HttpException,\n  HttpStatus,\n  Logger,\n} from '@nestjs/common';\nimport { Request, Response } from 'express';\nimport { ExceptionHandlerService } from '../services/exception-handler.service';\nimport { StandardErrorResponse } from '../interfaces/error-message.interface';\nimport { ExceptionHandlerConfig } from '../interfaces/exception-handler-config.interface';\n\n@Catch()\nexport class GlobalExceptionFilter implements ExceptionFilter {\n  private readonly logger = new Logger(GlobalExceptionFilter.name);\n  private config: ExceptionHandlerConfig;\n\n  constructor(\n    private exceptionHandlerService: ExceptionHandlerService,\n    config?: ExceptionHandlerConfig,\n  ) {\n    this.config = config || { enableLogging: true, hideStackTrace: false };\n  }\n\n  catch(exception: unknown, host: ArgumentsHost): void {\n    const ctx = host.switchToHttp();\n    const response = ctx.getResponse<Response>();\n    const request = ctx.getRequest<Request>();\n\n    const { errors, message } = this.exceptionHandlerService.formatException(exception);\n    const status = this.getStatusCode(exception);\n\n    const errorResponse: StandardErrorResponse = {\n      success: false,\n      message,\n      errorMessages: errors,\n    };\n\n    if (this.config.enableLogging) {\n      this.logError(request, status, errors, exception);\n    }\n\n    response.status(status).json(errorResponse);\n  }\n\n  private getStatusCode(exception: unknown): number {\n    if (exception instanceof HttpException) {\n      return exception.getStatus();\n    }\n    return HttpStatus.INTERNAL_SERVER_ERROR;\n  }\n\n  private logError(\n    request: Request,\n    status: number,\n    errorMessages: { path: string; message: string }[],\n    exception: unknown,\n  ): void {\n    const method = request.method;\n    const url = request.url;\n    const timestamp = new Date().toISOString();\n\n    const logData = {\n      timestamp,\n      method,\n      url,\n      status,\n      errorMessages,\n      stack: this.config.hideStackTrace ? undefined : (exception as Error)?.stack,\n    };\n\n    this.logger.error(`${method} ${url} - ${status}`, JSON.stringify(logData));\n  }\n}\n","import { DynamicModule, Module } from '@nestjs/common';\nimport { ExceptionHandlerService } from '../services/exception-handler.service';\nimport { GlobalExceptionFilter } from '../filter/global-exception.filter';\nimport { ExceptionHandlerConfig } from '../interfaces/exception-handler-config.interface';\nimport { PrismaExceptionFormatter } from '../formatters/prisma-exception.formatter';\nimport { DtoExceptionFormatter } from '../formatters/dto-exception.formatter';\nimport { HttpExceptionFormatter } from '../formatters/http-exception.formatter';\nimport { UnknownExceptionFormatter } from '../formatters/unknown-exception.formatter';\n\n@Module({})\nexport class ExceptionHandlerModule {\n  static forRoot(config?: ExceptionHandlerConfig): DynamicModule {\n    const providers = [\n      ExceptionHandlerService,\n      {\n        provide: GlobalExceptionFilter,\n        useFactory: (service: ExceptionHandlerService) => {\n          return new GlobalExceptionFilter(service, config);\n        },\n        inject: [ExceptionHandlerService],\n      },\n    ];\n\n    return {\n      module: ExceptionHandlerModule,\n      providers,\n      exports: [ExceptionHandlerService, GlobalExceptionFilter],\n      global: true,\n    };\n  }\n\n  static forFeature(config?: ExceptionHandlerConfig): DynamicModule {\n    return this.forRoot(config);\n  }\n}\n\n// Initialize formatters\nexport function initializeFormatters(service: ExceptionHandlerService): void {\n  service.registerFormatter(new PrismaExceptionFormatter());\n  service.registerFormatter(new DtoExceptionFormatter());\n  service.registerFormatter(new HttpExceptionFormatter());\n  service.registerFormatter(new UnknownExceptionFormatter());\n}\n"],"mappings":"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","names":["import_common","import_common","import_common"]}

package/dist/index.mjs

@@ -0,0 +1,354 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+
+// src/constants/default-messages.ts
+var DEFAULT_ERROR_MESSAGES = {
+  UNKNOWN_ERROR: "An unexpected error occurred",
+  VALIDATION_ERROR: "Validation failed",
+  DATABASE_ERROR: "Database error",
+  NOT_FOUND: "Resource not found",
+  UNAUTHORIZED: "Unauthorized access",
+  FORBIDDEN: "Access forbidden",
+  CONFLICT: "Conflict occurred",
+  BAD_REQUEST: "Bad request"
+};
+var PRISMA_ERROR_MESSAGES = {
+  P2002: "A record with this {field} already exists.",
+  P2003: "This {field} does not exist.",
+  P2005: "Invalid value for {field}.",
+  P2006: "Invalid format for {field}.",
+  P2025: "Record not found."
+};
+var DEFAULT_PATH = "unknown";
+
+// src/utils/is-prisma-error.ts
+function isPrismaError(exception) {
+  if (!exception || typeof exception !== "object") {
+    return false;
+  }
+  const error = exception;
+  const hasErrorCode = typeof error.code === "string";
+  const hasClientVersion = typeof error.clientVersion === "string";
+  const hasMeta = typeof error.meta === "object";
+  return hasErrorCode && (hasClientVersion || hasMeta);
+}
+
+// src/formatters/prisma-exception.formatter.ts
+var PrismaExceptionFormatter = class {
+  supports(exception) {
+    return isPrismaError(exception);
+  }
+  format(exception) {
+    const error = exception;
+    const code = error.code;
+    const meta = error.meta;
+    const target = error.target;
+    const messageTemplate = PRISMA_ERROR_MESSAGES[code] || "Database operation failed";
+    let path = "unknown";
+    let message = messageTemplate;
+    if (code === "P2002" && target && target.length > 0) {
+      path = target[0];
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2003" && meta?.field_name) {
+      path = meta.field_name;
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2005" && meta?.field_name) {
+      path = meta.field_name;
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2006" && meta?.field_name) {
+      path = meta.field_name;
+      message = messageTemplate.replace("{field}", path);
+    } else if (code === "P2025") {
+      path = "record";
+      message = messageTemplate;
+    }
+    return [{ path, message }];
+  }
+  message(exception) {
+    const error = exception;
+    const code = error.code;
+    return PRISMA_ERROR_MESSAGES[code] || "Database error";
+  }
+};
+
+// src/formatters/dto-exception.formatter.ts
+var DtoExceptionFormatter = class {
+  supports(exception) {
+    if (!exception || typeof exception !== "object") {
+      return false;
+    }
+    const error = exception;
+    return Array.isArray(error.validationErrors) || Array.isArray(error.children) && error.constraints !== void 0;
+  }
+  format(exception) {
+    const error = exception;
+    const validationErrors = error.validationErrors;
+    const children = error.children;
+    if (validationErrors) {
+      return this.formatValidationErrors(validationErrors);
+    }
+    if (children) {
+      return this.formatChildrenErrors(children);
+    }
+    return [{ path: "unknown", message: "Validation failed" }];
+  }
+  message(exception) {
+    const error = exception;
+    const validationErrors = error.validationErrors;
+    const children = error.children;
+    if (validationErrors && validationErrors.length > 0) {
+      const firstError = validationErrors[0];
+      const constraints = firstError.constraints;
+      if (constraints) {
+        return Object.values(constraints)[0];
+      }
+    }
+    if (children && children.length > 0) {
+      return "Validation failed for nested fields";
+    }
+    return "Validation failed";
+  }
+  formatValidationErrors(errors) {
+    return errors.flatMap((error) => {
+      const constraints = error.constraints;
+      if (constraints) {
+        return Object.entries(constraints).map(([, value]) => ({
+          path: error.property,
+          message: value
+        }));
+      }
+      return [];
+    });
+  }
+  formatChildrenErrors(children) {
+    return children.flatMap((child) => {
+      const constraints = child.constraints;
+      if (constraints) {
+        return Object.entries(constraints).map(([, value]) => ({
+          path: child.property,
+          message: value
+        }));
+      }
+      return [];
+    });
+  }
+};
+
+// src/formatters/http-exception.formatter.ts
+import { HttpException } from "@nestjs/common";
+var HttpExceptionFormatter = class {
+  supports(exception) {
+    return exception instanceof HttpException;
+  }
+  format(exception) {
+    const httpException = exception;
+    const response = httpException.getResponse();
+    if (typeof response === "string") {
+      return [{ path: "unknown", message: response }];
+    }
+    if (typeof response === "object" && response !== null) {
+      const responseObj = response;
+      if (responseObj.message && Array.isArray(responseObj.message)) {
+        return responseObj.message.map((msg) => ({
+          path: "unknown",
+          message: msg
+        }));
+      }
+      if (responseObj.message && typeof responseObj.message === "string") {
+        return [{ path: "unknown", message: responseObj.message }];
+      }
+      if (responseObj.error && typeof responseObj.error === "string") {
+        return [{ path: "unknown", message: responseObj.error }];
+      }
+    }
+    return [{ path: "unknown", message: "An error occurred" }];
+  }
+  message(exception) {
+    const httpException = exception;
+    const response = httpException.getResponse();
+    if (typeof response === "string") {
+      return response;
+    }
+    if (typeof response === "object" && response !== null) {
+      const responseObj = response;
+      if (responseObj.message && typeof responseObj.message === "string") {
+        return responseObj.message;
+      }
+      if (responseObj.error && typeof responseObj.error === "string") {
+        return responseObj.error;
+      }
+    }
+    return "An error occurred";
+  }
+};
+
+// src/formatters/unknown-exception.formatter.ts
+var UnknownExceptionFormatter = class {
+  supports(_exception) {
+    return true;
+  }
+  format(_exception) {
+    return [
+      {
+        path: DEFAULT_PATH,
+        message: "Internal server error"
+      }
+    ];
+  }
+  message(_exception) {
+    return "Internal server error";
+  }
+};
+
+// src/services/exception-handler.service.ts
+import { Injectable } from "@nestjs/common";
+var ExceptionHandlerService = class {
+  constructor() {
+    this.formatters = [];
+    this.defaultFormatter = new UnknownExceptionFormatter();
+  }
+  registerFormatter(formatter) {
+    this.formatters.push(formatter);
+  }
+  getFormatter(exception) {
+    for (const formatter of this.formatters) {
+      if (formatter.supports(exception)) {
+        return formatter;
+      }
+    }
+    return this.defaultFormatter;
+  }
+  formatException(exception) {
+    const formatter = this.getFormatter(exception);
+    const errors = formatter.format(exception);
+    const message = formatter.message(exception);
+    return { errors, message };
+  }
+  formatErrors(exception) {
+    const formatter = this.getFormatter(exception);
+    return formatter.format(exception);
+  }
+  getErrorMessage(exception) {
+    const formatter = this.getFormatter(exception);
+    return formatter.message(exception);
+  }
+  getAllFormatters() {
+    return [...this.formatters];
+  }
+};
+ExceptionHandlerService = __decorateClass([
+  Injectable()
+], ExceptionHandlerService);
+
+// src/filter/global-exception.filter.ts
+import {
+  Catch,
+  HttpException as HttpException2,
+  HttpStatus,
+  Logger
+} from "@nestjs/common";
+var GlobalExceptionFilter = class {
+  constructor(exceptionHandlerService, config) {
+    this.exceptionHandlerService = exceptionHandlerService;
+    this.logger = new Logger(GlobalExceptionFilter.name);
+    this.config = config || { enableLogging: true, hideStackTrace: false };
+  }
+  catch(exception, host) {
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse();
+    const request = ctx.getRequest();
+    const { errors, message } = this.exceptionHandlerService.formatException(exception);
+    const status = this.getStatusCode(exception);
+    const errorResponse = {
+      success: false,
+      message,
+      errorMessages: errors
+    };
+    if (this.config.enableLogging) {
+      this.logError(request, status, errors, exception);
+    }
+    response.status(status).json(errorResponse);
+  }
+  getStatusCode(exception) {
+    if (exception instanceof HttpException2) {
+      return exception.getStatus();
+    }
+    return HttpStatus.INTERNAL_SERVER_ERROR;
+  }
+  logError(request, status, errorMessages, exception) {
+    const method = request.method;
+    const url = request.url;
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const logData = {
+      timestamp,
+      method,
+      url,
+      status,
+      errorMessages,
+      stack: this.config.hideStackTrace ? void 0 : exception?.stack
+    };
+    this.logger.error(`${method} ${url} - ${status}`, JSON.stringify(logData));
+  }
+};
+GlobalExceptionFilter = __decorateClass([
+  Catch()
+], GlobalExceptionFilter);
+
+// src/module/exception-handler.module.ts
+import { Module } from "@nestjs/common";
+var ExceptionHandlerModule = class {
+  static forRoot(config) {
+    const providers = [
+      ExceptionHandlerService,
+      {
+        provide: GlobalExceptionFilter,
+        useFactory: (service) => {
+          return new GlobalExceptionFilter(service, config);
+        },
+        inject: [ExceptionHandlerService]
+      }
+    ];
+    return {
+      module: ExceptionHandlerModule,
+      providers,
+      exports: [ExceptionHandlerService, GlobalExceptionFilter],
+      global: true
+    };
+  }
+  static forFeature(config) {
+    return this.forRoot(config);
+  }
+};
+ExceptionHandlerModule = __decorateClass([
+  Module({})
+], ExceptionHandlerModule);
+function initializeFormatters(service) {
+  service.registerFormatter(new PrismaExceptionFormatter());
+  service.registerFormatter(new DtoExceptionFormatter());
+  service.registerFormatter(new HttpExceptionFormatter());
+  service.registerFormatter(new UnknownExceptionFormatter());
+}
+export {
+  DEFAULT_ERROR_MESSAGES,
+  DEFAULT_PATH,
+  DtoExceptionFormatter,
+  ExceptionHandlerModule,
+  ExceptionHandlerService,
+  GlobalExceptionFilter,
+  HttpExceptionFormatter,
+  PRISMA_ERROR_MESSAGES,
+  PrismaExceptionFormatter,
+  UnknownExceptionFormatter,
+  initializeFormatters,
+  isPrismaError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/default-messages.ts","../src/utils/is-prisma-error.ts","../src/formatters/prisma-exception.formatter.ts","../src/formatters/dto-exception.formatter.ts","../src/formatters/http-exception.formatter.ts","../src/formatters/unknown-exception.formatter.ts","../src/services/exception-handler.service.ts","../src/filter/global-exception.filter.ts","../src/module/exception-handler.module.ts"],"sourcesContent":["export const DEFAULT_ERROR_MESSAGES = {\n  UNKNOWN_ERROR: 'An unexpected error occurred',\n  VALIDATION_ERROR: 'Validation failed',\n  DATABASE_ERROR: 'Database error',\n  NOT_FOUND: 'Resource not found',\n  UNAUTHORIZED: 'Unauthorized access',\n  FORBIDDEN: 'Access forbidden',\n  CONFLICT: 'Conflict occurred',\n  BAD_REQUEST: 'Bad request',\n};\n\nexport const PRISMA_ERROR_MESSAGES: Record<string, string> = {\n  P2002: 'A record with this {field} already exists.',\n  P2003: 'This {field} does not exist.',\n  P2005: 'Invalid value for {field}.',\n  P2006: 'Invalid format for {field}.',\n  P2025: 'Record not found.',\n};\n\nexport const DEFAULT_PATH = 'unknown';\n","export function isPrismaError(exception: unknown): boolean {\n  if (!exception || typeof exception !== 'object') {\n    return false;\n  }\n\n  const error = exception as Record<string, unknown>;\n\n  // Check for Prisma error characteristics\n  const hasErrorCode = typeof error.code === 'string';\n  const hasClientVersion = typeof error.clientVersion === 'string';\n  const hasMeta = typeof error.meta === 'object';\n\n  // Prisma errors typically have these properties\n  return hasErrorCode && (hasClientVersion || hasMeta);\n}\n","import { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\nimport { isPrismaError } from '../utils/is-prisma-error';\nimport { PRISMA_ERROR_MESSAGES } from '../constants/default-messages';\n\nexport class PrismaExceptionFormatter implements ExceptionFormatter {\n  supports(exception: unknown): boolean {\n    return isPrismaError(exception);\n  }\n\n  format(exception: unknown): ErrorMessage[] {\n    const error = exception as Record<string, unknown>;\n    const code = error.code as string;\n    const meta = error.meta as Record<string, string> | undefined;\n    const target = error.target as string[] | undefined;\n\n    const messageTemplate = PRISMA_ERROR_MESSAGES[code] || 'Database operation failed';\n    let path = 'unknown';\n    let message = messageTemplate;\n\n    if (code === 'P2002' && target && target.length > 0) {\n      path = target[0];\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2003' && meta?.field_name) {\n      path = meta.field_name;\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2005' && meta?.field_name) {\n      path = meta.field_name;\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2006' && meta?.field_name) {\n      path = meta.field_name;\n      message = messageTemplate.replace('{field}', path);\n    } else if (code === 'P2025') {\n      path = 'record';\n      message = messageTemplate;\n    }\n\n    return [{ path, message }];\n  }\n\n  message(exception: unknown): string {\n    const error = exception as Record<string, unknown>;\n    const code = error.code as string;\n    return PRISMA_ERROR_MESSAGES[code] || 'Database error';\n  }\n}\n","import { ValidationError } from '@nestjs/common';\nimport { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\n\nexport class DtoExceptionFormatter implements ExceptionFormatter {\n  supports(exception: unknown): boolean {\n    if (!exception || typeof exception !== 'object') {\n      return false;\n    }\n\n    const error = exception as Record<string, unknown>;\n    return (\n      Array.isArray(error.validationErrors) ||\n      (Array.isArray(error.children) && error.constraints !== undefined)\n    );\n  }\n\n  format(exception: unknown): ErrorMessage[] {\n    const error = exception as Record<string, unknown>;\n    const validationErrors = error.validationErrors as ValidationError[] | undefined;\n    const children = error.children as ValidationError[] | undefined;\n\n    if (validationErrors) {\n      return this.formatValidationErrors(validationErrors);\n    }\n\n    if (children) {\n      return this.formatChildrenErrors(children);\n    }\n\n    return [{ path: 'unknown', message: 'Validation failed' }];\n  }\n\n  message(exception: unknown): string {\n    const error = exception as Record<string, unknown>;\n    const validationErrors = error.validationErrors as ValidationError[] | undefined;\n    const children = error.children as ValidationError[] | undefined;\n\n    if (validationErrors && validationErrors.length > 0) {\n      const firstError = validationErrors[0];\n      const constraints = firstError.constraints;\n      if (constraints) {\n        return Object.values(constraints)[0];\n      }\n    }\n\n    if (children && children.length > 0) {\n      return 'Validation failed for nested fields';\n    }\n\n    return 'Validation failed';\n  }\n\n  private formatValidationErrors(errors: ValidationError[]): ErrorMessage[] {\n    return errors.flatMap((error) => {\n      const constraints = error.constraints;\n      if (constraints) {\n        return Object.entries(constraints).map(([, value]) => ({\n          path: error.property,\n          message: value,\n        }));\n      }\n      return [];\n    });\n  }\n\n  private formatChildrenErrors(children: ValidationError[]): ErrorMessage[] {\n    return children.flatMap((child) => {\n      const constraints = child.constraints;\n      if (constraints) {\n        return Object.entries(constraints).map(([, value]) => ({\n          path: child.property,\n          message: value,\n        }));\n      }\n      return [];\n    });\n  }\n}\n","import { HttpException } from '@nestjs/common';\nimport { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\n\nexport class HttpExceptionFormatter implements ExceptionFormatter {\n  supports(exception: unknown): boolean {\n    return exception instanceof HttpException;\n  }\n\n  format(exception: unknown): ErrorMessage[] {\n    const httpException = exception as HttpException;\n    const response = httpException.getResponse();\n\n    if (typeof response === 'string') {\n      return [{ path: 'unknown', message: response }];\n    }\n\n    if (typeof response === 'object' && response !== null) {\n      const responseObj = response as Record<string, unknown>;\n\n      if (responseObj.message && Array.isArray(responseObj.message)) {\n        // Handle validation errors from class-validator in HTTP exceptions\n        return (responseObj.message as string[]).map((msg) => ({\n          path: 'unknown',\n          message: msg,\n        }));\n      }\n\n      if (responseObj.message && typeof responseObj.message === 'string') {\n        return [{ path: 'unknown', message: responseObj.message }];\n      }\n\n      if (responseObj.error && typeof responseObj.error === 'string') {\n        return [{ path: 'unknown', message: responseObj.error }];\n      }\n    }\n\n    return [{ path: 'unknown', message: 'An error occurred' }];\n  }\n\n  message(exception: unknown): string {\n    const httpException = exception as HttpException;\n    const response = httpException.getResponse();\n\n    if (typeof response === 'string') {\n      return response;\n    }\n\n    if (typeof response === 'object' && response !== null) {\n      const responseObj = response as Record<string, unknown>;\n\n      if (responseObj.message && typeof responseObj.message === 'string') {\n        return responseObj.message;\n      }\n\n      if (responseObj.error && typeof responseObj.error === 'string') {\n        return responseObj.error;\n      }\n    }\n\n    return 'An error occurred';\n  }\n}\n","import { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\nimport { DEFAULT_PATH } from '../constants/default-messages';\n\nexport class UnknownExceptionFormatter implements ExceptionFormatter {\n  supports(_exception: unknown): boolean {\n    return true;\n  }\n\n  format(_exception: unknown): ErrorMessage[] {\n    return [\n      {\n        path: DEFAULT_PATH,\n        message: 'Internal server error',\n      },\n    ];\n  }\n\n  message(_exception: unknown): string {\n    return 'Internal server error';\n  }\n}\n","import { Injectable } from '@nestjs/common';\nimport { ExceptionFormatter } from '../interfaces/exception-formatter.interface';\nimport { ErrorMessage } from '../interfaces/error-message.interface';\nimport { UnknownExceptionFormatter } from '../formatters/unknown-exception.formatter';\n\n@Injectable()\nexport class ExceptionHandlerService {\n  private formatters: ExceptionFormatter[] = [];\n  private defaultFormatter: ExceptionFormatter;\n\n  constructor() {\n    this.defaultFormatter = new UnknownExceptionFormatter();\n  }\n\n  registerFormatter(formatter: ExceptionFormatter): void {\n    this.formatters.push(formatter);\n  }\n\n  getFormatter(exception: unknown): ExceptionFormatter {\n    for (const formatter of this.formatters) {\n      if (formatter.supports(exception)) {\n        return formatter;\n      }\n    }\n    return this.defaultFormatter;\n  }\n\n  formatException(exception: unknown): { errors: ErrorMessage[]; message: string } {\n    const formatter = this.getFormatter(exception);\n    const errors = formatter.format(exception);\n    const message = formatter.message(exception);\n\n    return { errors, message };\n  }\n\n  formatErrors(exception: unknown): ErrorMessage[] {\n    const formatter = this.getFormatter(exception);\n    return formatter.format(exception);\n  }\n\n  getErrorMessage(exception: unknown): string {\n    const formatter = this.getFormatter(exception);\n    return formatter.message(exception);\n  }\n\n  getAllFormatters(): ExceptionFormatter[] {\n    return [...this.formatters];\n  }\n}\n","import {\n  ExceptionFilter,\n  Catch,\n  ArgumentsHost,\n  HttpException,\n  HttpStatus,\n  Logger,\n} from '@nestjs/common';\nimport { Request, Response } from 'express';\nimport { ExceptionHandlerService } from '../services/exception-handler.service';\nimport { StandardErrorResponse } from '../interfaces/error-message.interface';\nimport { ExceptionHandlerConfig } from '../interfaces/exception-handler-config.interface';\n\n@Catch()\nexport class GlobalExceptionFilter implements ExceptionFilter {\n  private readonly logger = new Logger(GlobalExceptionFilter.name);\n  private config: ExceptionHandlerConfig;\n\n  constructor(\n    private exceptionHandlerService: ExceptionHandlerService,\n    config?: ExceptionHandlerConfig,\n  ) {\n    this.config = config || { enableLogging: true, hideStackTrace: false };\n  }\n\n  catch(exception: unknown, host: ArgumentsHost): void {\n    const ctx = host.switchToHttp();\n    const response = ctx.getResponse<Response>();\n    const request = ctx.getRequest<Request>();\n\n    const { errors, message } = this.exceptionHandlerService.formatException(exception);\n    const status = this.getStatusCode(exception);\n\n    const errorResponse: StandardErrorResponse = {\n      success: false,\n      message,\n      errorMessages: errors,\n    };\n\n    if (this.config.enableLogging) {\n      this.logError(request, status, errors, exception);\n    }\n\n    response.status(status).json(errorResponse);\n  }\n\n  private getStatusCode(exception: unknown): number {\n    if (exception instanceof HttpException) {\n      return exception.getStatus();\n    }\n    return HttpStatus.INTERNAL_SERVER_ERROR;\n  }\n\n  private logError(\n    request: Request,\n    status: number,\n    errorMessages: { path: string; message: string }[],\n    exception: unknown,\n  ): void {\n    const method = request.method;\n    const url = request.url;\n    const timestamp = new Date().toISOString();\n\n    const logData = {\n      timestamp,\n      method,\n      url,\n      status,\n      errorMessages,\n      stack: this.config.hideStackTrace ? undefined : (exception as Error)?.stack,\n    };\n\n    this.logger.error(`${method} ${url} - ${status}`, JSON.stringify(logData));\n  }\n}\n","import { DynamicModule, Module } from '@nestjs/common';\nimport { ExceptionHandlerService } from '../services/exception-handler.service';\nimport { GlobalExceptionFilter } from '../filter/global-exception.filter';\nimport { ExceptionHandlerConfig } from '../interfaces/exception-handler-config.interface';\nimport { PrismaExceptionFormatter } from '../formatters/prisma-exception.formatter';\nimport { DtoExceptionFormatter } from '../formatters/dto-exception.formatter';\nimport { HttpExceptionFormatter } from '../formatters/http-exception.formatter';\nimport { UnknownExceptionFormatter } from '../formatters/unknown-exception.formatter';\n\n@Module({})\nexport class ExceptionHandlerModule {\n  static forRoot(config?: ExceptionHandlerConfig): DynamicModule {\n    const providers = [\n      ExceptionHandlerService,\n      {\n        provide: GlobalExceptionFilter,\n        useFactory: (service: ExceptionHandlerService) => {\n          return new GlobalExceptionFilter(service, config);\n        },\n        inject: [ExceptionHandlerService],\n      },\n    ];\n\n    return {\n      module: ExceptionHandlerModule,\n      providers,\n      exports: [ExceptionHandlerService, GlobalExceptionFilter],\n      global: true,\n    };\n  }\n\n  static forFeature(config?: ExceptionHandlerConfig): DynamicModule {\n    return this.forRoot(config);\n  }\n}\n\n// Initialize formatters\nexport function initializeFormatters(service: ExceptionHandlerService): void {\n  service.registerFormatter(new PrismaExceptionFormatter());\n  service.registerFormatter(new DtoExceptionFormatter());\n  service.registerFormatter(new HttpExceptionFormatter());\n  service.registerFormatter(new UnknownExceptionFormatter());\n}\n"],"mappings":"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","names":["HttpException","HttpException"]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "nestjs-exception-handler",
+  "version": "1.0.0",
+  "description": "A production-grade global exception handling system for NestJS applications",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nestjs",
+    "exception",
+    "handler",
+    "filter",
+    "error",
+    "prisma",
+    "validation"
+  ],
+  "author": "Nurul Islam Rimon",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nurulislamrimon/nestjs-exception-handler.git"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@prisma/client": "^5.0.0",
+    "reflect-metadata": "^0.1.13",
+    "rxjs": "^7.8.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/testing": "^10.4.22",
+    "@prisma/client": "^5.0.0",
+    "@types/express": "^4.17.17",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^29.5.0",
+    "prettier": "^3.0.0",
+    "reflect-metadata": "^0.1.13",
+    "rxjs": "^7.8.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^7.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {}
+}