@naman_deep_singh/errors-utils 1.3.3 → 1.4.0

package/dist/esm/index.js

@@ -1,5 +1,4 @@
-// =========================
-// Base Errors
+export * from './errorRegistry';
 // =========================
 export * from './error/AppError';
 export * from './error/HTTPError';
@@ -12,7 +11,6 @@ export * from './error/ForbiddenError';
 export * from './error/NotFoundError';
 export * from './error/ConflictError';
 export * from './error/ValidationError';
-export * from './error/RateLimitError';
 export * from './error/TooManyRequestsError';
 // =========================
 // Auth / Token Errors

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

@@ -1,16 +1,16 @@
-import { ExpressResponder } from '@naman_deep_singh/response-utils';
+import { ExpressResponder, HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { errorMessageRegistry } from 'src/errorRegistry';
 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);
     // 1. Known operational error
     if (err instanceof AppError) {
-        return mapAppErrorToResponder(responder, err);
+        return errorMessageRegistry.mapAppErrorToResponder(responder, 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);
+    const internalError = new AppError(ERROR_CODES.INTERNAL_SERVER_ERROR, HTTP_STATUS.SERVER_ERROR.INTERNAL_SERVER_ERROR, process.env.NODE_ENV === 'production' ? undefined : err, err instanceof Error ? err : undefined);
+    return errorMessageRegistry.mapAppErrorToResponder(responder, internalError);
 }

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

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

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

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

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

@@ -1,32 +1,37 @@
 export declare const ERROR_CODES: {
     readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
     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 INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    readonly DEPENDENCY_FAILURE: "DEPENDENCY_FAILURE";
+    readonly HTTP_ERROR: "HTTP_ERROR";
+    readonly HTTP_TIMEOUT: "HTTP_TIMEOUT";
+    readonly UPSTREAM_SERVICE_ERROR: "UPSTREAM_SERVICE_ERROR";
+    readonly AUTH_FAILED: "AUTH_FAILED";
+    readonly TOKEN_MISSING: "TOKEN_MISSING";
     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";
+    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
+    readonly CRYPTO_ERROR: "CRYPTO_ERROR";
+    readonly CRYPTO_INTEGRITY_ERROR: "CRYPTO_INTEGRITY_ERROR";
+    readonly CACHE_ERROR: "CACHE_ERROR";
+    readonly CACHE_CONNECTION_FAILED: "CACHE_CONNECTION_FAILED";
+    readonly DATABASE_ERROR: "DATABASE_ERROR";
+    readonly DATABASE_CONNECTION_FAILED: "DATABASE_CONNECTION_FAILED";
+    readonly DATABASE_CONSTRAINT_VIOLATION: "DATABASE_CONSTRAINT_VIOLATION";
+    readonly MESSAGE_BROKER_ERROR: "MESSAGE_BROKER_ERROR";
+    readonly MESSAGE_PUBLISH_FAILED: "MESSAGE_PUBLISH_FAILED";
+    readonly FILE_ERROR: "FILE_ERROR";
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly FILE_UPLOAD_FAILED: "FILE_UPLOAD_FAILED";
+    readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
+    readonly CONFIG_ERROR: "CONFIG_ERROR";
+    readonly CONFIG_MISSING: "CONFIG_MISSING";
+    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
+    readonly RESOURCE_EXHAUSTED: "RESOURCE_EXHAUSTED";
 };
-export type ErrorCode = keyof typeof ERROR_CODES;
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];

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

@@ -1,2 +1,9 @@
-import type { ErrorCode } from './errorCodes';
+import { type ErrorCode } from './errorCodes';
+/**
+ * Canonical error messages mapped to ERROR_CODES
+ * - Human-readable
+ * - Safe for API responses
+ * - Useful for logs
+ * - Can be overridden by services if needed
+ */
 export declare const ERROR_MESSAGES: Record<ErrorCode, string>;

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

@@ -1,4 +1,4 @@
-import { type ErrorCode } from '../constants';
+import type { ErrorCode } from '../constants';
 export declare class AppError extends Error {
     statusCode: number;
     isOperational: boolean;
@@ -8,7 +8,7 @@ export declare class AppError extends 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";
+        code: ErrorCode;
         message: string;
         details: {} | null;
     };

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

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

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

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

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

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

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

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

package/dist/types/errorRegistry/errorRegistry.d.ts

@@ -0,0 +1,19 @@
+import type { ExpressResponder } from '@naman_deep_singh/response-utils';
+import { type ErrorCode } from 'src/constants';
+import type { AppError } from 'src/error/AppError';
+export declare class ErrorMessageRegistry {
+    private static instance;
+    private readonly registry;
+    private constructor();
+    /** Singleton accessor */
+    static getInstance(): ErrorMessageRegistry;
+    /** Register or override messages */
+    register(messages: Record<string, string>): void;
+    /** Resolve a message for a given error code */
+    resolve(code: ErrorCode | string, defaultMessage?: string): string;
+    /**
+     * Map an AppError to an ExpressResponder
+     * Centralizes error-to-HTTP mapping
+     */
+    mapAppErrorToResponder(responder: ExpressResponder<unknown>, err: AppError): any;
+}

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

@@ -0,0 +1,3 @@
+import { ErrorMessageRegistry } from './errorRegistry';
+/** Singleton export for easy access */
+export declare const errorMessageRegistry: ErrorMessageRegistry;

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './errorRegistry';
 export * from './error/AppError';
 export * from './error/HTTPError';
 export * from './error/BadRequestError';
@@ -6,7 +7,6 @@ export * from './error/ForbiddenError';
 export * from './error/NotFoundError';
 export * from './error/ConflictError';
 export * from './error/ValidationError';
-export * from './error/RateLimitError';
 export * from './error/TooManyRequestsError';
 export * from './error/TokenExpiredError';
 export * from './error/TokenMalformedError';

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naman_deep_singh/errors-utils",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "Standardized error classes and Express middleware for consistent error handling with TypeScript",
   "type": "module",
   "main": "./dist/cjs/index.js",

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

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

package/dist/cjs/error/RateLimitError.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateLimitError = void 0;
-const constants_1 = require("src/constants");
-const TooManyRequestsError_1 = require("./TooManyRequestsError");
-class RateLimitError extends TooManyRequestsError_1.TooManyRequestsError {
-    constructor(details, cause) {
-        super(constants_1.ERROR_CODES.RATE_LIMIT_EXCEEDED, details, cause);
-    }
-}
-exports.RateLimitError = RateLimitError;

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

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

@@ -1,27 +0,0 @@
-"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/dist/esm/error/RateLimitError.d.ts

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

package/dist/esm/error/RateLimitError.js

@@ -1,7 +0,0 @@
-import { ERROR_CODES } from 'src/constants';
-import { TooManyRequestsError } from './TooManyRequestsError';
-export class RateLimitError extends TooManyRequestsError {
-    constructor(details, cause) {
-        super(ERROR_CODES.RATE_LIMIT_EXCEEDED, details, cause);
-    }
-}

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

@@ -1,3 +0,0 @@
-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,24 +0,0 @@
-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/RateLimitError.d.ts

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

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

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