ts-packages 1.0.0 → 3.0.0

package/packages/errors-utils/dist/esm/error/BadRequestError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from '../constants';
+import { HTTPError } from './HTTPError';
+export class BadRequestError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.BAD_REQUEST, HTTP_STATUS.CLIENT_ERROR.BAD_REQUEST, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/ConflictError.d.ts

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

package/packages/errors-utils/dist/esm/error/ConflictError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class ConflictError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.CONFLICT, HTTP_STATUS.CLIENT_ERROR.CONFLICT, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/CryptoIntegrityError.d.ts

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

package/packages/errors-utils/dist/esm/error/CryptoIntegrityError.js

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

package/packages/errors-utils/dist/esm/error/ForbiddenError.d.ts

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

package/packages/errors-utils/dist/esm/error/ForbiddenError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class ForbiddenError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.FORBIDDEN, HTTP_STATUS.CLIENT_ERROR.FORBIDDEN, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/HTTPError.d.ts

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

package/packages/errors-utils/dist/esm/error/HTTPError.js

@@ -0,0 +1,7 @@
+import { AppError } from './AppError';
+export class HTTPError extends AppError {
+    constructor(errorCode, statusCode, details, cause) {
+        super(errorCode, statusCode, details, cause);
+        this.status = statusCode >= 400 && statusCode < 500 ? 'fail' : 'error';
+    }
+}

package/packages/errors-utils/dist/esm/error/InternalServerError.d.ts

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

package/packages/errors-utils/dist/esm/error/InternalServerError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class InternalServerError extends HTTPError {
+    constructor(errorCode = ERROR_CODES.INTERNAL_SERVER_ERROR, details, cause) {
+        super(errorCode, HTTP_STATUS.SERVER_ERROR.INTERNAL_SERVER_ERROR, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/NotFoundError.d.ts

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

package/packages/errors-utils/dist/esm/error/NotFoundError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class NotFoundError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.NOT_FOUND, HTTP_STATUS.CLIENT_ERROR.NOT_FOUND, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/ServiceUnavailableError.d.ts

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

package/packages/errors-utils/dist/esm/error/ServiceUnavailableError.js

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

package/packages/errors-utils/dist/esm/error/TokenExpiredError.d.ts

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

package/packages/errors-utils/dist/esm/error/TokenExpiredError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class TokenExpiredError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.TOKEN_EXPIRED, HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/TokenMalformedError.d.ts

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

package/packages/errors-utils/dist/esm/error/TokenMalformedError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class TokenMalformedError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.TOKEN_INVALID, HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/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/packages/errors-utils/dist/esm/error/TooManyRequestsError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class TooManyRequestsError extends HTTPError {
+    constructor(errorCode = ERROR_CODES.TOO_MANY_REQUESTS, details, cause) {
+        super(errorCode, HTTP_STATUS.CLIENT_ERROR.TOO_MANY_REQUESTS, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/UnauthorizedError.d.ts

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

package/packages/errors-utils/dist/esm/error/UnauthorizedError.js

@@ -0,0 +1,8 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_CODES } from 'src/constants';
+import { HTTPError } from './HTTPError';
+export class UnauthorizedError extends HTTPError {
+    constructor(details, cause) {
+        super(ERROR_CODES.UNAUTHORIZED, HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/ValidationError.d.ts

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

package/packages/errors-utils/dist/esm/error/ValidationError.js

@@ -0,0 +1,8 @@
+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(details, cause) {
+        super(ERROR_CODES.VALIDATION_FAILED, HTTP_STATUS.CLIENT_ERROR.UNPROCESSABLE_ENTITY, details, cause);
+    }
+}

package/packages/errors-utils/dist/esm/error/index.d.ts

@@ -0,0 +1,14 @@
+export * from './AppError';
+export * from './HTTPError';
+export * from './BadRequestError';
+export * from './UnauthorizedError';
+export * from './ForbiddenError';
+export * from './NotFoundError';
+export * from './ConflictError';
+export * from './ValidationError';
+export * from './TooManyRequestsError';
+export * from './TokenExpiredError';
+export * from './TokenMalformedError';
+export * from './InternalServerError';
+export * from './CryptoIntegrityError';
+export * from './ServiceUnavailableError';

package/packages/errors-utils/dist/esm/error/index.js

@@ -0,0 +1,23 @@
+export * from './AppError';
+export * from './HTTPError';
+// =========================
+// 4xx Client Errors
+// =========================
+export * from './BadRequestError';
+export * from './UnauthorizedError';
+export * from './ForbiddenError';
+export * from './NotFoundError';
+export * from './ConflictError';
+export * from './ValidationError';
+export * from './TooManyRequestsError';
+// =========================
+// Auth / Token Errors
+// =========================
+export * from './TokenExpiredError';
+export * from './TokenMalformedError';
+// =========================
+// 5xx Server Errors
+// =========================
+export * from './InternalServerError';
+export * from './CryptoIntegrityError';
+export * from './ServiceUnavailableError';

package/packages/errors-utils/dist/esm/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/packages/errors-utils/dist/esm/errorRegistry/errorRegistry.js

@@ -0,0 +1,59 @@
+import { HTTP_STATUS } from '@naman_deep_singh/response-utils';
+import { ERROR_MESSAGES } from 'src/constants';
+export class ErrorMessageRegistry {
+    constructor() {
+        this.registry = new Map();
+        // Initialize with default messages
+        Object.entries(ERROR_MESSAGES).forEach(([code, message]) => {
+            this.registry.set(code, message);
+        });
+    }
+    /** Singleton accessor */
+    static getInstance() {
+        if (!ErrorMessageRegistry.instance) {
+            ErrorMessageRegistry.instance = new ErrorMessageRegistry();
+        }
+        return ErrorMessageRegistry.instance;
+    }
+    /** Register or override messages */
+    register(messages) {
+        for (const [code, message] of Object.entries(messages)) {
+            this.registry.set(code, message);
+        }
+    }
+    /** Resolve a message for a given error code */
+    resolve(code, defaultMessage = 'Unexpected error') {
+        return this.registry.get(code) ?? defaultMessage;
+    }
+    /**
+     * Map an AppError to an ExpressResponder
+     * Centralizes error-to-HTTP mapping
+     */
+    mapAppErrorToResponder(responder, err) {
+        switch (err.statusCode) {
+            case HTTP_STATUS.CLIENT_ERROR.BAD_REQUEST:
+                return responder.badRequest(this.resolve(err.code), {
+                    details: err.details,
+                });
+            case HTTP_STATUS.CLIENT_ERROR.UNAUTHORIZED:
+                return responder.unauthorized(this.resolve(err.code));
+            case HTTP_STATUS.CLIENT_ERROR.FORBIDDEN:
+                return responder.forbidden(this.resolve(err.code));
+            case HTTP_STATUS.CLIENT_ERROR.NOT_FOUND:
+                return responder.notFound(this.resolve(err.code));
+            case HTTP_STATUS.CLIENT_ERROR.CONFLICT:
+                return responder.conflict(this.resolve(err.code));
+            case HTTP_STATUS.CLIENT_ERROR.UNPROCESSABLE_ENTITY:
+                return responder.unprocessableEntity(this.resolve(err.code), {
+                    details: err.details,
+                });
+            case HTTP_STATUS.CLIENT_ERROR.TOO_MANY_REQUESTS:
+                return responder.tooManyRequests(this.resolve(err.code));
+            default:
+                // Any other status maps to generic server error
+                return responder.serverError(this.resolve(err.code), {
+                    details: err.details,
+                });
+        }
+    }
+}

package/packages/errors-utils/dist/esm/errorRegistry/index.d.ts

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

package/packages/errors-utils/dist/esm/errorRegistry/index.js

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

package/packages/errors-utils/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export * from './errorRegistry';
+export * from './error';
+export * from './constants';
+export * from './middleware/express';

package/packages/errors-utils/dist/esm/index.js

@@ -0,0 +1,13 @@
+export * from './errorRegistry';
+// =========================
+// default errors
+// =========================
+export * from './error';
+// =========================
+// Constants
+// =========================
+export * from './constants';
+// =========================
+// Express Middleware
+// =========================
+export * from './middleware/express';

package/packages/errors-utils/dist/esm/middleware/express/errorConverter.middleware.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/packages/errors-utils/dist/esm/middleware/express/errorConverter.middleware.js

@@ -0,0 +1,36 @@
+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);
+    }
+    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/packages/errors-utils/dist/esm/middleware/express/errorHandler.middleware.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/packages/errors-utils/dist/esm/middleware/express/errorHandler.middleware.js

@@ -0,0 +1,16 @@
+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';
+export function expressErrorHandler(err, _req, res, _next) {
+    const responder = new ExpressResponder({}, res);
+    // 1. Known operational error
+    if (err instanceof AppError) {
+        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, 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/packages/errors-utils/dist/esm/middleware/express/index.d.ts

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

package/packages/errors-utils/dist/esm/middleware/express/index.js

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

package/packages/errors-utils/dist/types/constants/errorCodes.d.ts

@@ -0,0 +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 TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS";
+    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_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 = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];

package/packages/errors-utils/dist/types/constants/errorMessages.d.ts

@@ -0,0 +1,9 @@
+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/packages/errors-utils/dist/types/constants/index.d.ts

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

package/packages/errors-utils/dist/types/error/AppError.d.ts

@@ -0,0 +1,15 @@
+import type { ErrorCode } from '../constants';
+export declare class AppError extends Error {
+    statusCode: number;
+    isOperational: boolean;
+    code: ErrorCode;
+    details?: unknown;
+    cause?: Error;
+    constructor(code: ErrorCode, statusCode?: number, details?: unknown, cause?: Error);
+    toJSON(): {
+        success: boolean;
+        code: ErrorCode;
+        message: string;
+        details: {} | null;
+    };
+}

package/packages/errors-utils/dist/types/error/BadRequestError.d.ts

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

package/packages/errors-utils/dist/types/error/ConflictError.d.ts

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

package/packages/errors-utils/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/packages/errors-utils/dist/types/error/ForbiddenError.d.ts

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

package/packages/errors-utils/dist/types/error/HTTPError.d.ts

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

package/packages/errors-utils/dist/types/error/InternalServerError.d.ts

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

package/packages/errors-utils/dist/types/error/NotFoundError.d.ts

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

package/packages/errors-utils/dist/types/error/ServiceUnavailableError.d.ts

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

package/packages/errors-utils/dist/types/error/TokenExpiredError.d.ts

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

package/packages/errors-utils/dist/types/error/TokenMalformedError.d.ts

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

package/packages/errors-utils/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/packages/errors-utils/dist/types/error/UnauthorizedError.d.ts

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

package/packages/errors-utils/dist/types/error/ValidationError.d.ts

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

package/packages/errors-utils/dist/types/error/index.d.ts

@@ -0,0 +1,14 @@
+export * from './AppError';
+export * from './HTTPError';
+export * from './BadRequestError';
+export * from './UnauthorizedError';
+export * from './ForbiddenError';
+export * from './NotFoundError';
+export * from './ConflictError';
+export * from './ValidationError';
+export * from './TooManyRequestsError';
+export * from './TokenExpiredError';
+export * from './TokenMalformedError';
+export * from './InternalServerError';
+export * from './CryptoIntegrityError';
+export * from './ServiceUnavailableError';

package/packages/errors-utils/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/packages/errors-utils/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/packages/errors-utils/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './errorRegistry';
+export * from './error';
+export * from './constants';
+export * from './middleware/express';