@naman_deep_singh/errors-utils 1.0.0 → 1.1.1

package/README.md

@@ -0,0 +1,125 @@
+# @naman_deep_singh/errors-utils
+
+**Version:** 1.1.1
+
+Standardized error classes and Express middleware for consistent error handling with TypeScript.
+
+## 🚀 Features
+
+- ✅ **Structured Error Classes** - AppError, HTTPError, ValidationError, etc.
+- ✅ **Express Middleware** - Error converter and handler
+- ✅ **Response Integration** - Works with @naman_deep_singh/response-utils
+- ✅ **TypeScript Support** - Full type safety
+- ✅ **Consistent Responses** - Standardized error format across your API
+
+## 📦 Installation
+
+```bash
+npm install @naman_deep_singh/errors-utils
+```
+
+## 🔧 Usage
+
+### Error Classes
+
+```typescript
+import { 
+  AppError, 
+  BadRequestError, 
+  UnauthorizedError, 
+  NotFoundError,
+  ValidationError,
+  InternalServerError 
+} from '@naman_deep_singh/errors-utils';
+
+// Basic usage
+throw new BadRequestError('Invalid input data');
+throw new UnauthorizedError('Authentication required');
+throw new NotFoundError('User not found');
+throw new ValidationError('Email is required');
+
+// With details
+throw new BadRequestError('Validation failed', {
+  fields: ['email', 'password']
+});
+```
+
+### Express Middleware
+
+```typescript
+import express from 'express';
+import { expressErrorHandler, errorConverter } from '@naman_deep_singh/errors-utils';
+
+const app = express();
+
+// Convert unknown errors to AppError
+app.use(errorConverter);
+
+// Handle all errors consistently
+app.use(expressErrorHandler);
+
+// In your routes
+app.post('/users', (req, res) => {
+  if (!req.body.email) {
+    throw new BadRequestError('Email is required');
+  }
+  // Error will be caught and formatted automatically
+});
+```
+
+## 🔗 Integration
+
+### With @naman_deep_singh/server-utils
+
+```typescript
+import { createServer } from '@naman_deep_singh/server-utils';
+import { expressErrorHandler } from '@naman_deep_singh/errors-utils';
+
+const server = createServer('My API', '1.0.0');
+
+// Replace basic error handler with advanced one
+server.app.use(expressErrorHandler);
+```
+
+### With @naman_deep_singh/response-utils
+
+```typescript
+import { responderMiddleware } from '@naman_deep_singh/response-utils';
+
+server.app.use(responderMiddleware());
+server.app.use(expressErrorHandler); // Uses response-utils for consistent format
+```
+
+## 📚 Error Classes
+
+| Class | Status Code | Use Case |
+|-------|-------------|----------|
+| `AppError` | Custom | Base error class |
+| `BadRequestError` | 400 | Invalid input data |
+| `UnauthorizedError` | 401 | Authentication failures |
+| `ForbiddenError` | 403 | Authorization failures |
+| `NotFoundError` | 404 | Resource not found |
+| `ConflictError` | 409 | Resource conflicts |
+| `ValidationError` | 422 | Input validation errors |
+| `InternalServerError` | 500 | Server errors |
+
+## 🎯 Response Format
+
+All errors produce consistent responses:
+
+```json
+{
+  "success": false,
+  "message": "Error message",
+  "data": undefined,
+  "error": {
+    "message": "Detailed error message",
+    "details": {...}
+  },
+  "meta": null
+}
+```
+
+## 📄 License
+
+ISC © Naman Deep Singh

package/dist/{error → cjs/error}/AppError.d.ts

@@ -1,6 +1,6 @@
 export declare class AppError extends Error {
     statusCode: number;
     isOperational: boolean;
-    details?: any;
-    constructor(message: string, statusCode?: number, details?: any);
+    details?: unknown;
+    constructor(message: string, statusCode?: number, details?: unknown);
 }

package/dist/cjs/error/BadRequestError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class BadRequestError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/BadRequestError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BadRequestError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class BadRequestError extends HTTPError_1.HTTPError {
-    constructor(message = "Bad Request", details) {
+    constructor(message = 'Bad Request', details) {
         super(message, 400, details);
     }
 }

package/dist/cjs/error/ConflictError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ConflictError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/ConflictError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConflictError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class ConflictError extends HTTPError_1.HTTPError {
-    constructor(message = "Conflict", details) {
+    constructor(message = 'Conflict', details) {
         super(message, 409, details);
     }
 }

package/dist/cjs/error/ForbiddenError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ForbiddenError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/ForbiddenError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ForbiddenError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class ForbiddenError extends HTTPError_1.HTTPError {
-    constructor(message = "Forbidden", details) {
+    constructor(message = 'Forbidden', details) {
         super(message, 403, details);
     }
 }

package/dist/cjs/error/HTTPError.d.ts

@@ -0,0 +1,5 @@
+import { AppError } from './AppError';
+export declare class HTTPError extends AppError {
+    status: string;
+    constructor(message: string, statusCode: number, details?: unknown);
+}

package/dist/{error → cjs/error}/HTTPError.js

@@ -5,7 +5,7 @@ const AppError_1 = require("./AppError");
 class HTTPError extends AppError_1.AppError {
     constructor(message, statusCode, details) {
         super(message, statusCode, details);
-        this.status = `${statusCode}`.startsWith("4") ? "fail" : "error";
+        this.status = `${statusCode}`.startsWith('4') ? 'fail' : 'error';
     }
 }
 exports.HTTPError = HTTPError;

package/dist/cjs/error/InternalServerError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class InternalServerError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/InternalServerError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalServerError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class InternalServerError extends HTTPError_1.HTTPError {
-    constructor(message = "Internal Server Error", details) {
+    constructor(message = 'Internal Server Error', details) {
         super(message, 500, details);
     }
 }

package/dist/cjs/error/NotFoundError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class NotFoundError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/NotFoundError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotFoundError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class NotFoundError extends HTTPError_1.HTTPError {
-    constructor(message = "Not Found", details) {
+    constructor(message = 'Not Found', details) {
         super(message, 404, details);
     }
 }

package/dist/cjs/error/UnauthorizedError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class UnauthorizedError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/UnauthorizedError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnauthorizedError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class UnauthorizedError extends HTTPError_1.HTTPError {
-    constructor(message = "Unauthorized", details) {
+    constructor(message = 'Unauthorized', details) {
         super(message, 401, details);
     }
 }

package/dist/cjs/error/ValidationError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ValidationError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/{error → cjs/error}/ValidationError.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidationError = void 0;
 const HTTPError_1 = require("./HTTPError");
 class ValidationError extends HTTPError_1.HTTPError {
-    constructor(message = "Validation Error", details) {
+    constructor(message = 'Validation Error', details) {
         super(message, 422, details);
     }
 }

package/dist/cjs/index.d.ts

@@ -0,0 +1,10 @@
+export * from './error/AppError';
+export * from './error/HTTPError';
+export * from './error/BadRequestError';
+export * from './error/UnauthorizedError';
+export * from './error/ForbiddenError';
+export * from './error/NotFoundError';
+export * from './error/ConflictError';
+export * from './error/ValidationError';
+export * from './error/InternalServerError';
+export * from './middleware/express';

package/dist/{index.js → cjs/index.js}

@@ -23,5 +23,4 @@ __exportStar(require("./error/NotFoundError"), exports);
 __exportStar(require("./error/ConflictError"), exports);
 __exportStar(require("./error/ValidationError"), exports);
 __exportStar(require("./error/InternalServerError"), exports);
-__exportStar(require("./middleware/errorConverter"), exports);
-__exportStar(require("./middleware/errorHandler"), exports);
+__exportStar(require("./middleware/express"), exports);

package/dist/cjs/middleware/express/errorConverter.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from 'express';
+export declare function errorConverter(err: unknown, req: Request, res: Response, next: NextFunction): void;

package/dist/cjs/middleware/express/errorConverter.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorConverter = errorConverter;
+const AppError_1 = require("../../error/AppError");
+function errorConverter(err, req, res, next) {
+    if (err instanceof AppError_1.AppError) {
+        return next(err);
+    }
+    // Safely extract properties from unknown error
+    let message = 'Internal Error';
+    let statusCode = 500;
+    let details = undefined;
+    if (typeof err === 'object' && err !== null) {
+        const e = err;
+        if (typeof e.message === 'string')
+            message = e.message;
+        if (typeof e.statusCode === 'number')
+            statusCode = e.statusCode;
+        if ('details' in e)
+            details = e.details;
+    }
+    else if (typeof err === 'string') {
+        message = err;
+    }
+    const convertedError = new AppError_1.AppError(message, statusCode, details);
+    next(convertedError);
+}

package/dist/cjs/middleware/express/errorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from 'express';
+export declare function expressErrorHandler(err: unknown, req: Request, res: Response, next: NextFunction): any;

package/dist/{middleware → cjs/middleware/express}/errorHandler.js

@@ -1,18 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorHandler = errorHandler;
-const AppError_1 = require("../error/AppError");
+exports.expressErrorHandler = expressErrorHandler;
 const response_utils_1 = require("@naman_deep_singh/response-utils");
-const mapAppErrorToResponder_1 = require("src/utils/mapAppErrorToResponder");
-function errorHandler(err, req, res, next) {
+const AppError_1 = require("../../error/AppError");
+const mapAppErrorToResponder_1 = require("../../utils/mapAppErrorToResponder");
+function expressErrorHandler(err, req, res, next) {
     const responder = new response_utils_1.ExpressResponder({}, res);
     // AppError → known operational error
     if (err instanceof AppError_1.AppError) {
         return (0, mapAppErrorToResponder_1.mapAppErrorToResponder)(responder, err);
     }
     // Unexpected / programming / unknown error
-    console.error("UNEXPECTED ERROR:", err);
-    return responder.serverError("Internal server error", {
-        details: process.env.NODE_ENV === "production" ? undefined : err,
+    console.error('UNEXPECTED ERROR:', err);
+    return responder.serverError('Internal server error', {
+        details: process.env.NODE_ENV === 'production' ? undefined : err,
     });
 }

package/dist/cjs/middleware/express/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errorHandler';
+export * from './errorConverter';

package/dist/cjs/middleware/express/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errorHandler"), exports);
+__exportStar(require("./errorConverter"), exports);

package/dist/cjs/utils/mapAppErrorToResponder.d.ts

@@ -0,0 +1,3 @@
+import type { ExpressResponder } from '@naman_deep_singh/response-utils';
+import type { AppError } from 'src/error/AppError';
+export declare function mapAppErrorToResponder(responder: ExpressResponder<unknown>, err: AppError): any;

package/dist/{utils → cjs/utils}/mapAppErrorToResponder.js

@@ -15,7 +15,9 @@ function mapAppErrorToResponder(responder, err) {
         case response_utils_1.HTTP_STATUS.CLIENT_ERROR.CONFLICT:
             return responder.conflict(err.message);
         case response_utils_1.HTTP_STATUS.CLIENT_ERROR.UNPROCESSABLE_ENTITY:
-            return responder.unprocessableEntity(err.message, { details: err.details });
+            return responder.unprocessableEntity(err.message, {
+                details: err.details,
+            });
         case response_utils_1.HTTP_STATUS.CLIENT_ERROR.TOO_MANY_REQUESTS:
             return responder.tooManyRequests(err.message);
         default:

package/dist/esm/error/AppError.d.ts

@@ -0,0 +1,6 @@
+export declare class AppError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    details?: unknown;
+    constructor(message: string, statusCode?: number, details?: unknown);
+}

package/{src/error/AppError.ts → dist/esm/error/AppError.js}

@@ -1,16 +1,9 @@
 export class AppError extends Error {
-    public statusCode: number;
-    public isOperational: boolean;
-    public details?: any;
-
-    constructor(message: string, statusCode = 500, details?: any) {
+    constructor(message, statusCode = 500, details) {
         super(message);
-
         this.statusCode = statusCode;
         this.isOperational = true;
         this.details = details;
-
         Error.captureStackTrace(this, this.constructor);
     }
 }
-

package/dist/esm/error/BadRequestError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class BadRequestError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/BadRequestError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class BadRequestError extends HTTPError {
+    constructor(message = 'Bad Request', details) {
+        super(message, 400, details);
+    }
+}

package/dist/esm/error/ConflictError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ConflictError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/ConflictError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class ConflictError extends HTTPError {
+    constructor(message = 'Conflict', details) {
+        super(message, 409, details);
+    }
+}

package/dist/esm/error/ForbiddenError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ForbiddenError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/ForbiddenError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class ForbiddenError extends HTTPError {
+    constructor(message = 'Forbidden', details) {
+        super(message, 403, details);
+    }
+}

package/dist/esm/error/HTTPError.d.ts

@@ -0,0 +1,5 @@
+import { AppError } from './AppError';
+export declare class HTTPError extends AppError {
+    status: string;
+    constructor(message: string, statusCode: number, details?: unknown);
+}

package/dist/esm/error/HTTPError.js

@@ -0,0 +1,7 @@
+import { AppError } from './AppError';
+export class HTTPError extends AppError {
+    constructor(message, statusCode, details) {
+        super(message, statusCode, details);
+        this.status = `${statusCode}`.startsWith('4') ? 'fail' : 'error';
+    }
+}

package/dist/esm/error/InternalServerError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class InternalServerError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/InternalServerError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class InternalServerError extends HTTPError {
+    constructor(message = 'Internal Server Error', details) {
+        super(message, 500, details);
+    }
+}

package/dist/esm/error/NotFoundError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class NotFoundError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/NotFoundError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class NotFoundError extends HTTPError {
+    constructor(message = 'Not Found', details) {
+        super(message, 404, details);
+    }
+}

package/dist/esm/error/UnauthorizedError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class UnauthorizedError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/UnauthorizedError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class UnauthorizedError extends HTTPError {
+    constructor(message = 'Unauthorized', details) {
+        super(message, 401, details);
+    }
+}

package/dist/esm/error/ValidationError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ValidationError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/esm/error/ValidationError.js

@@ -0,0 +1,6 @@
+import { HTTPError } from './HTTPError';
+export class ValidationError extends HTTPError {
+    constructor(message = 'Validation Error', details) {
+        super(message, 422, details);
+    }
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,10 @@
+export * from './error/AppError';
+export * from './error/HTTPError';
+export * from './error/BadRequestError';
+export * from './error/UnauthorizedError';
+export * from './error/ForbiddenError';
+export * from './error/NotFoundError';
+export * from './error/ConflictError';
+export * from './error/ValidationError';
+export * from './error/InternalServerError';
+export * from './middleware/express';

package/dist/esm/index.js

@@ -0,0 +1,10 @@
+export * from './error/AppError';
+export * from './error/HTTPError';
+export * from './error/BadRequestError';
+export * from './error/UnauthorizedError';
+export * from './error/ForbiddenError';
+export * from './error/NotFoundError';
+export * from './error/ConflictError';
+export * from './error/ValidationError';
+export * from './error/InternalServerError';
+export * from './middleware/express';

package/dist/esm/middleware/express/errorConverter.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from 'express';
+export declare function errorConverter(err: unknown, req: Request, res: Response, next: NextFunction): void;

package/dist/esm/middleware/express/errorConverter.js

@@ -0,0 +1,24 @@
+import { AppError } from '../../error/AppError';
+export function errorConverter(err, req, res, next) {
+    if (err instanceof AppError) {
+        return next(err);
+    }
+    // Safely extract properties from unknown error
+    let message = 'Internal Error';
+    let statusCode = 500;
+    let details = undefined;
+    if (typeof err === 'object' && err !== null) {
+        const e = err;
+        if (typeof e.message === 'string')
+            message = e.message;
+        if (typeof e.statusCode === 'number')
+            statusCode = e.statusCode;
+        if ('details' in e)
+            details = e.details;
+    }
+    else if (typeof err === 'string') {
+        message = err;
+    }
+    const convertedError = new AppError(message, statusCode, details);
+    next(convertedError);
+}

package/dist/esm/middleware/express/errorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from 'express';
+export declare function expressErrorHandler(err: unknown, req: Request, res: Response, next: NextFunction): any;

package/dist/esm/middleware/express/errorHandler.js

@@ -0,0 +1,15 @@
+import { ExpressResponder } from '@naman_deep_singh/response-utils';
+import { AppError } from '../../error/AppError';
+import { mapAppErrorToResponder } from '../../utils/mapAppErrorToResponder';
+export function expressErrorHandler(err, req, res, next) {
+    const responder = new ExpressResponder({}, res);
+    // AppError → known operational error
+    if (err instanceof AppError) {
+        return mapAppErrorToResponder(responder, err);
+    }
+    // Unexpected / programming / unknown error
+    console.error('UNEXPECTED ERROR:', err);
+    return responder.serverError('Internal server error', {
+        details: process.env.NODE_ENV === 'production' ? undefined : err,
+    });
+}

package/dist/esm/middleware/express/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errorHandler';
+export * from './errorConverter';

package/dist/esm/middleware/express/index.js

@@ -0,0 +1,2 @@
+export * from './errorHandler';
+export * from './errorConverter';

package/dist/esm/utils/mapAppErrorToResponder.d.ts

@@ -0,0 +1,3 @@
+import type { ExpressResponder } from '@naman_deep_singh/response-utils';
+import type { AppError } from 'src/error/AppError';
+export declare function mapAppErrorToResponder(responder: ExpressResponder<unknown>, err: AppError): any;

package/{src/utils/mapAppErrorToResponder.ts → dist/esm/utils/mapAppErrorToResponder.js}

@@ -1,29 +1,22 @@
-import { ExpressResponder, HTTP_STATUS } from "@naman_deep_singh/response-utils";
-import { AppError } from "src/error/AppError";
-
-export function mapAppErrorToResponder(responder: ExpressResponder<any>, err: AppError) {
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+export function mapAppErrorToResponder(responder, err) {
     switch (err.statusCode) {
         case HTTP_STATUS.CLIENT_ERROR.BAD_REQUEST:
             return responder.badRequest(err.message, { details: err.details });
-
         case HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED:
             return responder.unauthorized(err.message);
-
         case HTTP_STATUS.CLIENT_ERROR.FORBIDDEN:
             return responder.forbidden(err.message);
-
         case HTTP_STATUS.CLIENT_ERROR.NOT_FOUND:
             return responder.notFound(err.message);
-
         case HTTP_STATUS.CLIENT_ERROR.CONFLICT:
             return responder.conflict(err.message);
-
         case HTTP_STATUS.CLIENT_ERROR.UNPROCESSABLE_ENTITY:
-            return responder.unprocessableEntity(err.message, { details: err.details });
-
+            return responder.unprocessableEntity(err.message, {
+                details: err.details,
+            });
         case HTTP_STATUS.CLIENT_ERROR.TOO_MANY_REQUESTS:
             return responder.tooManyRequests(err.message);
-
         default:
             // Any other custom status maps to a generic server error
             return responder.serverError(err.message, { details: err.details });

package/dist/types/error/AppError.d.ts

@@ -0,0 +1,6 @@
+export declare class AppError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    details?: unknown;
+    constructor(message: string, statusCode?: number, details?: unknown);
+}

package/dist/types/error/BadRequestError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class BadRequestError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/error/ConflictError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ConflictError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/error/ForbiddenError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ForbiddenError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/error/HTTPError.d.ts

@@ -0,0 +1,5 @@
+import { AppError } from './AppError';
+export declare class HTTPError extends AppError {
+    status: string;
+    constructor(message: string, statusCode: number, details?: unknown);
+}

package/dist/types/error/InternalServerError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class InternalServerError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/error/NotFoundError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class NotFoundError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/error/UnauthorizedError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class UnauthorizedError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/error/ValidationError.d.ts

@@ -0,0 +1,4 @@
+import { HTTPError } from './HTTPError';
+export declare class ValidationError extends HTTPError {
+    constructor(message?: string, details?: unknown);
+}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export * from './error/AppError';
+export * from './error/HTTPError';
+export * from './error/BadRequestError';
+export * from './error/UnauthorizedError';
+export * from './error/ForbiddenError';
+export * from './error/NotFoundError';
+export * from './error/ConflictError';
+export * from './error/ValidationError';
+export * from './error/InternalServerError';
+export * from './middleware/express';

package/dist/types/middleware/express/errorConverter.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from 'express';
+export declare function errorConverter(err: unknown, req: Request, res: Response, next: NextFunction): void;

package/dist/types/middleware/express/errorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { NextFunction, Request, Response } from 'express';
+export declare function expressErrorHandler(err: unknown, req: Request, res: Response, next: NextFunction): any;

package/dist/types/middleware/express/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errorHandler';
+export * from './errorConverter';

package/dist/types/utils/mapAppErrorToResponder.d.ts

@@ -0,0 +1,3 @@
+import type { ExpressResponder } from '@naman_deep_singh/response-utils';
+import type { AppError } from 'src/error/AppError';
+export declare function mapAppErrorToResponder(responder: ExpressResponder<unknown>, err: AppError): any;

package/package.json

@@ -1,9 +1,22 @@
 {
   "name": "@naman_deep_singh/errors-utils",
-  "version": "1.0.0",
-  "description": "Security utilities for password hashing and JWT token management with TypeScript",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "1.1.1",
+  "description": "Standardized error classes and Express middleware for consistent error handling with TypeScript",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "keywords": [
     "errors"
   ],
@@ -13,12 +26,15 @@
     "@types/express": "^5.0.5",
     "@types/node": "^25.0.1",
     "express": "^5.1.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "rimraf": "^5.0.5"
   },
   "dependencies": {
-    "@naman_deep_singh/response-utils": "^2.0.3"
+    "@naman_deep_singh/response-utils": "^2.0.4"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "pnpm run build:types && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.base.json --emitDeclarationOnly --outDir dist/types",
+    "clean": "rimraf dist"
   }
 }

package/dist/error/BadRequestError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class BadRequestError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/error/ConflictError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class ConflictError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/error/ForbiddenError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class ForbiddenError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/error/HTTPError.d.ts

@@ -1,5 +0,0 @@
-import { AppError } from "./AppError";
-export declare class HTTPError extends AppError {
-    status: string;
-    constructor(message: string, statusCode: number, details?: any);
-}

package/dist/error/InternalServerError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class InternalServerError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/error/NotFoundError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class NotFoundError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/error/UnauthorizedError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class UnauthorizedError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/error/ValidationError.d.ts

@@ -1,4 +0,0 @@
-import { HTTPError } from "./HTTPError";
-export declare class ValidationError extends HTTPError {
-    constructor(message?: string, details?: any);
-}

package/dist/index.d.ts

@@ -1,11 +0,0 @@
-export * from "./error/AppError";
-export * from "./error/HTTPError";
-export * from "./error/BadRequestError";
-export * from "./error/UnauthorizedError";
-export * from "./error/ForbiddenError";
-export * from "./error/NotFoundError";
-export * from "./error/ConflictError";
-export * from "./error/ValidationError";
-export * from "./error/InternalServerError";
-export * from "./middleware/errorConverter";
-export * from "./middleware/errorHandler";

package/dist/middleware/errorConverter.d.ts

@@ -1,2 +0,0 @@
-import { Request, Response, NextFunction } from "express";
-export declare function errorConverter(err: any, req: Request, res: Response, next: NextFunction): void;

package/dist/middleware/errorConverter.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorConverter = errorConverter;
-const AppError_1 = require("../error/AppError");
-function errorConverter(err, req, res, next) {
-    if (err instanceof AppError_1.AppError) {
-        return next(err);
-    }
-    const convertedError = new AppError_1.AppError(err.message || "Internal Error", err.statusCode || 500, err.details || undefined);
-    next(convertedError);
-}

package/dist/middleware/errorHandler.d.ts

@@ -1,2 +0,0 @@
-import type { Request, Response, NextFunction } from "express";
-export declare function errorHandler(err: unknown, req: Request, res: Response, next: NextFunction): any;

package/dist/utils/mapAppErrorToResponder.d.ts

@@ -1,3 +0,0 @@
-import { ExpressResponder } from "@naman_deep_singh/response-utils";
-import { AppError } from "src/error/AppError";
-export declare function mapAppErrorToResponder(responder: ExpressResponder<any>, err: AppError): any;

package/src/error/BadRequestError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class BadRequestError extends HTTPError {
-    constructor(message = "Bad Request", details?: any) {
-        super(message, 400, details);
-    }
-}

package/src/error/ConflictError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class ConflictError extends HTTPError {
-    constructor(message = "Conflict", details?: any) {
-        super(message, 409, details);
-    }
-}

package/src/error/ForbiddenError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class ForbiddenError extends HTTPError {
-    constructor(message = "Forbidden", details?: any) {
-        super(message, 403, details);
-    }
-}

package/src/error/HTTPError.ts

@@ -1,11 +0,0 @@
-import { AppError } from "./AppError";
-
-export class HTTPError extends AppError {
-    public status: string;
-
-    constructor(message: string, statusCode: number, details?: any) {
-        super(message, statusCode, details);
-
-        this.status = `${statusCode}`.startsWith("4") ? "fail" : "error";
-    }
-}

package/src/error/InternalServerError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class InternalServerError extends HTTPError {
-    constructor(message = "Internal Server Error", details?: any) {
-        super(message, 500, details);
-    }
-}

package/src/error/NotFoundError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class NotFoundError extends HTTPError {
-    constructor(message = "Not Found", details?: any) {
-        super(message, 404, details);
-    }
-}

package/src/error/UnauthorizedError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class UnauthorizedError extends HTTPError {
-    constructor(message = "Unauthorized", details?: any) {
-        super(message, 401, details);
-    }
-}

package/src/error/ValidationError.ts

@@ -1,7 +0,0 @@
-import { HTTPError } from "./HTTPError";
-
-export class ValidationError extends HTTPError {
-    constructor(message = "Validation Error", details?: any) {
-        super(message, 422, details);
-    }
-}

package/src/index.ts

@@ -1,12 +0,0 @@
-export * from "./error/AppError";
-export * from "./error/HTTPError";
-export * from "./error/BadRequestError";
-export * from "./error/UnauthorizedError";
-export * from "./error/ForbiddenError";
-export * from "./error/NotFoundError";
-export * from "./error/ConflictError";
-export * from "./error/ValidationError";
-export * from "./error/InternalServerError";
-
-export * from "./middleware/errorConverter";
-export * from "./middleware/errorHandler";

package/src/middleware/errorConverter.ts

@@ -1,16 +0,0 @@
-import { Request, Response, NextFunction } from "express";
-import { AppError } from "../error/AppError";
-
-export function errorConverter(err: any, req: Request, res: Response, next: NextFunction) {
-    if (err instanceof AppError) {
-        return next(err);
-    }
-
-    const convertedError = new AppError(
-        err.message || "Internal Error",
-        err.statusCode || 500,
-        err.details || undefined
-    );
-
-    next(convertedError);
-}

package/src/middleware/errorHandler.ts

@@ -1,25 +0,0 @@
-import type { Request, Response, NextFunction } from "express";
-import { AppError } from "../error/AppError";
-import { ExpressResponder } from "@naman_deep_singh/response-utils";
-import { mapAppErrorToResponder } from "src/utils/mapAppErrorToResponder";
-
-export function errorHandler(
-    err: unknown,
-    req: Request,
-    res: Response,
-    next: NextFunction
-) {
-    const responder = new ExpressResponder({}, res);
-
-    // AppError → known operational error
-    if (err instanceof AppError) {
-        return mapAppErrorToResponder(responder, err);
-    }
-
-    // Unexpected / programming / unknown error
-    console.error("UNEXPECTED ERROR:", err);
-
-    return responder.serverError("Internal server error", {
-        details: process.env.NODE_ENV === "production" ? undefined : err,
-    });
-}

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "CommonJS",
-    "moduleResolution": "node",
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "strict": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "baseUrl": ".",
-    "paths": {
-      "*": ["*", "*.ts", "*.js"]
-    }
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}