@naman_deep_singh/errors-utils 1.0.1 → 1.3.1

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

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

package/dist/esm/error/ValidationError.js

@@ -1,6 +1,8 @@
-import { HTTPError } from "./HTTPError";
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
 export class ValidationError extends HTTPError {
-    constructor(message = "Validation Error", details) {
-        super(message, 422, details);
+    constructor(details, cause) {
+        super(ERROR_CODES.VALIDATION_FAILED, HTTP_STATUS.CLIENT_ERROR.UNPROCESSABLE_ENTITY, details, cause);
     }
 }

package/dist/esm/index.d.ts

@@ -1,10 +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";
+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

@@ -1,10 +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";
+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

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

@@ -1,8 +1,36 @@
-import { AppError } from "../../error/AppError";
-export function errorConverter(err, req, res, next) {
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from '../../constants';
+import { AppError } from '../../error/AppError';
+export function errorConverter(err, _req, _res, next) {
+    // 1. Already a known AppError → pass through
     if (err instanceof AppError) {
         return next(err);
     }
-    const convertedError = new AppError(err.message || "Internal Error", err.statusCode || 500, err.details || undefined);
+    let code = ERROR_CODES.INTERNAL_SERVER_ERROR;
+    let statusCode = HTTP_STATUS.SERVER_ERROR.INTERNAL_SERVER_ERROR;
+    let details = undefined;
+    let cause = undefined;
+    // 2. Handle unknown objects safely
+    if (typeof err === 'object' && err !== null) {
+        const e = err;
+        if (typeof e.code === 'string' && e.code in ERROR_CODES) {
+            code = e.code;
+        }
+        if (typeof e.statusCode === 'number') {
+            statusCode = e.statusCode;
+        }
+        if ('details' in e) {
+            details = e.details;
+        }
+        if (err instanceof Error) {
+            cause = err;
+        }
+    }
+    // 3. Handle string errors
+    if (typeof err === 'string') {
+        details = err;
+    }
+    // 4. Convert to AppError
+    const convertedError = new AppError(code, statusCode, details, cause);
     next(convertedError);
 }

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

@@ -1,2 +1,2 @@
-import type { Request, Response, NextFunction } from "express";
-export declare function expressErrorHandler(err: unknown, req: Request, res: Response, next: NextFunction): any;
+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

@@ -1,15 +1,16 @@
-import { AppError } from "../../error/AppError";
-import { ExpressResponder } from "@naman_deep_singh/response-utils";
-import { mapAppErrorToResponder } from "../../utils/mapAppErrorToResponder";
-export function expressErrorHandler(err, req, res, next) {
+import { ExpressResponder } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from '../../constants';
+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
+    // 1. 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,
-    });
+    // 2. Log unexpected errors (never expose internals in prod)
+    console.error('UNEXPECTED ERROR:', err);
+    // 3. Normalize unknown error → AppError
+    const internalError = new AppError(ERROR_CODES.INTERNAL_SERVER_ERROR, 500, process.env.NODE_ENV === 'production' ? undefined : err, err instanceof Error ? err : undefined);
+    return mapAppErrorToResponder(responder, internalError);
 }

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

@@ -1,3 +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;
+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/esm/utils/mapAppErrorToResponder.js

@@ -1,4 +1,4 @@
-import { HTTP_STATUS } from "@naman_deep_singh/response-utils";
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
 export function mapAppErrorToResponder(responder, err) {
     switch (err.statusCode) {
         case HTTP_STATUS.CLIENT_ERROR.BAD_REQUEST:
@@ -12,7 +12,9 @@ export function mapAppErrorToResponder(responder, err) {
         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:

package/dist/types/constants/errorCodes.d.ts

@@ -0,0 +1,32 @@
+export declare const ERROR_CODES: {
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly CONFLICT: "CONFLICT";
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly CRYPTO_INTEGRITY_ERROR: "CRYPTO_INTEGRITY_ERROR";
+    readonly TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS";
+    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
+    readonly TOKEN_INVALID: "TOKEN_INVALID";
+    readonly TOKEN_NOT_PROVIDED: "TOKEN_NOT_PROVIDED";
+    readonly TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND";
+    readonly TOKEN_NOT_CREATED: "TOKEN_NOT_CREATED";
+    readonly TOKEN_NOT_UPDATED: "TOKEN_NOT_UPDATED";
+    readonly TOKEN_NOT_DELETED: "TOKEN_NOT_DELETED";
+    readonly TOKEN_NOT_VALIDATED: "TOKEN_NOT_VALIDATED";
+    readonly TOKEN_NOT_REFRESHED: "TOKEN_NOT_REFRESHED";
+    readonly TOKEN_NOT_REVOKED: "TOKEN_NOT_REVOKED";
+    readonly TOKEN_NOT_BLACKLISTED: "TOKEN_NOT_BLACKLISTED";
+    readonly TOKEN_NOT_WHITELISTED: "TOKEN_NOT_WHITELISTED";
+    readonly TOKEN_NOT_DECODED: "TOKEN_NOT_DECODED";
+    readonly TOKEN_NOT_ENCODED: "TOKEN_NOT_ENCODED";
+    readonly TOKEN_NOT_SIGNED: "TOKEN_NOT_SIGNED";
+    readonly TOKEN_NOT_VERIFIED: "TOKEN_NOT_VERIFIED";
+    readonly TOKEN_NOT_DECRYPTED: "TOKEN_NOT_DECRYPTED";
+    readonly TOKEN_NOT_ENCRYPTED: "TOKEN_NOT_ENCRYPTED";
+    readonly TOKEN_NOT_GENERATED: "TOKEN_NOT_GENERATED";
+};
+export type ErrorCode = keyof typeof ERROR_CODES;

package/dist/types/constants/errorMessages.d.ts

@@ -0,0 +1,2 @@
+import type { ErrorCode } from './errorCodes';
+export declare const ERROR_MESSAGES: Record<ErrorCode, string>;

package/dist/types/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errorCodes';
+export * from './errorMessages';

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

@@ -1,6 +1,15 @@
+import { type ErrorCode } from '../constants';
 export declare class AppError extends Error {
     statusCode: number;
     isOperational: boolean;
-    details?: any;
-    constructor(message: string, statusCode?: number, details?: any);
+    code: ErrorCode;
+    details?: unknown;
+    cause?: Error;
+    constructor(code: ErrorCode, statusCode?: number, details?: unknown, cause?: Error);
+    toJSON(): {
+        success: boolean;
+        code: "BAD_REQUEST" | "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "CONFLICT" | "VALIDATION_FAILED" | "RATE_LIMIT_EXCEEDED" | "INTERNAL_SERVER_ERROR" | "CRYPTO_INTEGRITY_ERROR" | "TOO_MANY_REQUESTS" | "TOKEN_EXPIRED" | "TOKEN_INVALID" | "TOKEN_NOT_PROVIDED" | "TOKEN_NOT_FOUND" | "TOKEN_NOT_CREATED" | "TOKEN_NOT_UPDATED" | "TOKEN_NOT_DELETED" | "TOKEN_NOT_VALIDATED" | "TOKEN_NOT_REFRESHED" | "TOKEN_NOT_REVOKED" | "TOKEN_NOT_BLACKLISTED" | "TOKEN_NOT_WHITELISTED" | "TOKEN_NOT_DECODED" | "TOKEN_NOT_ENCODED" | "TOKEN_NOT_SIGNED" | "TOKEN_NOT_VERIFIED" | "TOKEN_NOT_DECRYPTED" | "TOKEN_NOT_ENCRYPTED" | "TOKEN_NOT_GENERATED";
+        message: string;
+        details: {} | null;
+    };
 }

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

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

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

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

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

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

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

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

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

@@ -1,5 +1,6 @@
-import { AppError } from "./AppError";
+import type { ErrorCode } from '../constants';
+import { AppError } from './AppError';
 export declare class HTTPError extends AppError {
-    status: string;
-    constructor(message: string, statusCode: number, details?: any);
+    status: 'fail' | 'error';
+    constructor(errorCode: ErrorCode, statusCode: number, details?: unknown, cause?: Error);
 }

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

@@ -1,4 +1,5 @@
-import { HTTPError } from "./HTTPError";
+import { type ErrorCode } from 'src/constants';
+import { HTTPError } from './HTTPError';
 export declare class InternalServerError extends HTTPError {
-    constructor(message?: string, details?: any);
+    constructor(errorCode?: ErrorCode, details?: unknown, cause?: Error);
 }

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

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

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

@@ -0,0 +1,4 @@
+import { TooManyRequestsError } from './TooManyRequestsError';
+export declare class RateLimitError extends TooManyRequestsError {
+    constructor(details?: unknown, cause?: Error);
+}

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

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

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

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

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

@@ -0,0 +1,5 @@
+import { type ErrorCode } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export declare class TooManyRequestsError extends HTTPError {
+    constructor(errorCode?: ErrorCode, details?: unknown, cause?: Error);
+}

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

@@ -1,4 +1,5 @@
-import { HTTPError } from "./HTTPError";
+import { type ErrorCode } from 'src/constants';
+import { HTTPError } from './HTTPError';
 export declare class UnauthorizedError extends HTTPError {
-    constructor(message?: string, details?: any);
+    constructor(errorCodes?: ErrorCode, status?: number, details?: unknown, cause?: Error);
 }

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

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

package/dist/types/index.d.ts

@@ -1,10 +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";
+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

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

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

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

@@ -1,3 +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;
+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,6 +1,6 @@
 {
   "name": "@naman_deep_singh/errors-utils",
-  "version": "1.0.1",
+  "version": "1.3.1",
   "description": "Standardized error classes and Express middleware for consistent error handling with TypeScript",
   "type": "module",
   "main": "./dist/cjs/index.js",