@naman_deep_singh/errors-utils 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,125 @@
+# @naman_deep_singh/errors-utils
+
+**Version:** 1.0.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/{index.d.ts → cjs/index.d.ts}

@@ -7,5 +7,4 @@ export * from "./error/NotFoundError";
 export * from "./error/ConflictError";
 export * from "./error/ValidationError";
 export * from "./error/InternalServerError";
-export * from "./middleware/errorConverter";
-export * from "./middleware/errorHandler";
+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/{middleware → cjs/middleware/express}/errorConverter.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.errorConverter = errorConverter;
-const AppError_1 = require("../error/AppError");
+const AppError_1 = require("../../error/AppError");
 function errorConverter(err, req, res, next) {
     if (err instanceof AppError_1.AppError) {
         return next(err);

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

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

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

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorHandler = errorHandler;
-const AppError_1 = require("../error/AppError");
+exports.expressErrorHandler = expressErrorHandler;
+const AppError_1 = require("../../error/AppError");
 const response_utils_1 = require("@naman_deep_singh/response-utils");
-const mapAppErrorToResponder_1 = require("src/utils/mapAppErrorToResponder");
-function errorHandler(err, req, res, next) {
+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) {

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/esm/error/AppError.d.ts

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

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?: any);
+}

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

@@ -1,7 +1,6 @@
 import { HTTPError } from "./HTTPError";
-
 export class BadRequestError extends HTTPError {
-    constructor(message = "Bad Request", details?: any) {
+    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?: any);
+}

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

@@ -1,7 +1,6 @@
 import { HTTPError } from "./HTTPError";
-
 export class ConflictError extends HTTPError {
-    constructor(message = "Conflict", details?: any) {
+    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?: any);
+}

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

@@ -1,7 +1,6 @@
 import { HTTPError } from "./HTTPError";
-
 export class ForbiddenError extends HTTPError {
-    constructor(message = "Forbidden", details?: any) {
+    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?: any);
+}

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

@@ -1,11 +1,7 @@
 import { AppError } from "./AppError";
-
 export class HTTPError extends AppError {
-    public status: string;
-
-    constructor(message: string, statusCode: number, details?: any) {
+    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?: any);
+}

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

@@ -1,7 +1,6 @@
 import { HTTPError } from "./HTTPError";
-
 export class InternalServerError extends HTTPError {
-    constructor(message = "Internal Server Error", details?: any) {
+    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?: any);
+}

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

@@ -1,7 +1,6 @@
 import { HTTPError } from "./HTTPError";
-
 export class NotFoundError extends HTTPError {
-    constructor(message = "Not Found", details?: any) {
+    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?: any);
+}

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

@@ -1,7 +1,6 @@
 import { HTTPError } from "./HTTPError";
-
 export class UnauthorizedError extends HTTPError {
-    constructor(message = "Unauthorized", details?: any) {
+    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?: any);
+}

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

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

package/{src/index.ts → dist/esm/index.d.ts}

@@ -7,6 +7,4 @@ export * from "./error/NotFoundError";
 export * from "./error/ConflictError";
 export * from "./error/ValidationError";
 export * from "./error/InternalServerError";
-
-export * from "./middleware/errorConverter";
-export * from "./middleware/errorHandler";
+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 { Request, Response, NextFunction } from "express";
+export declare function errorConverter(err: any, req: Request, res: Response, next: NextFunction): void;

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

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

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

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

package/{src/middleware/errorHandler.ts → dist/esm/middleware/express/errorHandler.js}

@@ -1,24 +1,14 @@
-import type { Request, Response, NextFunction } from "express";
-import { AppError } from "../error/AppError";
+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
-) {
+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 { 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/utils/mapAppErrorToResponder.ts → dist/esm/utils/mapAppErrorToResponder.js}

@@ -1,29 +1,20 @@
-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 });
-
         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?: any;
+    constructor(message: string, statusCode?: number, details?: any);
+}

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?: any);
+}

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?: any);
+}

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?: any);
+}

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?: any);
+}

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?: any);
+}

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?: any);
+}

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?: any);
+}

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?: any);
+}

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 { Request, Response, NextFunction } from "express";
+export declare function errorConverter(err: any, req: Request, res: Response, next: NextFunction): void;

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

@@ -0,0 +1,2 @@
+import type { Request, Response, NextFunction } 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 { ExpressResponder } from "@naman_deep_singh/response-utils";
+import { AppError } from "src/error/AppError";
+export declare function mapAppErrorToResponder(responder: ExpressResponder<any>, 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.0.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/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/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/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"]
-}