@naman_deep_singh/errors-utils 1.0.0

package/dist/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/error/AppError.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppError = void 0;
+class AppError extends Error {
+    constructor(message, statusCode = 500, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.isOperational = true;
+        this.details = details;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.AppError = AppError;

package/dist/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/error/BadRequestError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 400, details);
+    }
+}
+exports.BadRequestError = BadRequestError;

package/dist/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/error/ConflictError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 409, details);
+    }
+}
+exports.ConflictError = ConflictError;

package/dist/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/error/ForbiddenError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 403, details);
+    }
+}
+exports.ForbiddenError = ForbiddenError;

package/dist/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/error/HTTPError.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPError = void 0;
+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";
+    }
+}
+exports.HTTPError = HTTPError;

package/dist/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/error/InternalServerError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 500, details);
+    }
+}
+exports.InternalServerError = InternalServerError;

package/dist/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/error/NotFoundError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 404, details);
+    }
+}
+exports.NotFoundError = NotFoundError;

package/dist/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/error/UnauthorizedError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 401, details);
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;

package/dist/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/error/ValidationError.js

@@ -0,0 +1,10 @@
+"use strict";
+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) {
+        super(message, 422, details);
+    }
+}
+exports.ValidationError = ValidationError;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+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/index.js

@@ -0,0 +1,27 @@
+"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("./error/AppError"), exports);
+__exportStar(require("./error/HTTPError"), exports);
+__exportStar(require("./error/BadRequestError"), exports);
+__exportStar(require("./error/UnauthorizedError"), exports);
+__exportStar(require("./error/ForbiddenError"), exports);
+__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);

package/dist/middleware/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/middleware/errorConverter.js

@@ -0,0 +1,11 @@
+"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

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

package/dist/middleware/errorHandler.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandler = errorHandler;
+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 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,
+    });
+}

package/dist/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/dist/utils/mapAppErrorToResponder.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapAppErrorToResponder = mapAppErrorToResponder;
+const response_utils_1 = require("@naman_deep_singh/response-utils");
+function mapAppErrorToResponder(responder, err) {
+    switch (err.statusCode) {
+        case response_utils_1.HTTP_STATUS.CLIENT_ERROR.BAD_REQUEST:
+            return responder.badRequest(err.message, { details: err.details });
+        case response_utils_1.HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED:
+            return responder.unauthorized(err.message);
+        case response_utils_1.HTTP_STATUS.CLIENT_ERROR.FORBIDDEN:
+            return responder.forbidden(err.message);
+        case response_utils_1.HTTP_STATUS.CLIENT_ERROR.NOT_FOUND:
+            return responder.notFound(err.message);
+        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 });
+        case response_utils_1.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/package.json

@@ -0,0 +1,24 @@
+{
+  "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",
+  "keywords": [
+    "errors"
+  ],
+  "author": "Naman Deep Singh",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/express": "^5.0.5",
+    "@types/node": "^25.0.1",
+    "express": "^5.1.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@naman_deep_singh/response-utils": "^2.0.3"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/src/error/AppError.ts

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

package/src/error/BadRequestError.ts

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

package/src/error/ConflictError.ts

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

package/src/error/ForbiddenError.ts

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

package/src/error/HTTPError.ts

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,7 @@
+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

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

package/src/error/UnauthorizedError.ts

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

package/src/error/ValidationError.ts

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

package/src/index.ts

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,25 @@
+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/src/utils/mapAppErrorToResponder.ts

@@ -0,0 +1,31 @@
+import { ExpressResponder, HTTP_STATUS } from "@naman_deep_singh/response-utils";
+import { AppError } from "src/error/AppError";
+
+export function mapAppErrorToResponder(responder: ExpressResponder<any>, err: AppError) {
+    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/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "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"]
+}