@zudojs/errors 0.0.1

package/dist/utils/errorHandler.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.core.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAI3D,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EAEnB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,6EAA6E;AAC7E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IAEvC,YAAY,OAAO,GAAE,mBAAwB,EAM5C;IAED,yDAAyD;IAClD,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA2BhD;IAED,+CAA+C;IAClC,MAAM,CACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAM7B;IAED,wDAAwD;IACjD,QAAQ,CACb,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,kBAAkB,CAqBpB;IAED,qDAAqD;IACxC,MAAM,CACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,CAMpB;IAED,wEAAwE;IACjE,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE7C;IAED,sDAAsD;IAC/C,SAAS,CACd,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;IAED,6EAA6E;IAC7E,OAAO,CAAC,gBAAgB;CAsBzB"}

package/dist/utils/errorHandler.core.js

@@ -0,0 +1,124 @@
+/**
+ * Centralized error normalization, serialization, and reporting service.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorCode } from "../base/types/errorCode.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+export { createErrorHandler, normalizeError, isHandledError, } from "./errorHandler.factory.js";
+/** Centralized error normalization, serialization, and reporting service. */
+export class ErrorHandler {
+    reporter;
+    defaultStatusCode;
+    defaultMessage;
+    includeStack;
+    constructor(options = {}) {
+        this.reporter = options.reporter;
+        this.defaultStatusCode = options.defaultStatusCode ?? 500;
+        this.defaultMessage =
+            options.defaultMessage ?? "An unexpected error occurred.";
+        this.includeStack = options.includeStack ?? false;
+    }
+    /** Converts an unknown thrown value into a BaseError. */
+    normalize(value) {
+        if (value instanceof BaseError) {
+            return { error: value, original: value };
+        }
+        if (value instanceof Error) {
+            const error = new BaseError(value.message || this.defaultMessage, {
+                code: ErrorCode.INTERNAL_ERROR,
+                category: ErrorCategory.SYSTEM,
+                severity: ErrorSeverity.ERROR,
+                statusCode: this.defaultStatusCode,
+                expose: false,
+                isOperational: false,
+                cause: value,
+            });
+            return { error, original: value };
+        }
+        const message = typeof value === "string" ? value : this.defaultMessage;
+        const error = new BaseError(message, {
+            code: ErrorCode.INTERNAL_ERROR,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: this.defaultStatusCode,
+            expose: false,
+            isOperational: false,
+            metadata: { originalType: typeof value },
+        });
+        return { error, original: value };
+    }
+    /** Handles and normalizes an unknown error. */
+    async handle(value, context) {
+        const { error } = this.normalize(value);
+        if (this.reporter) {
+            await this.reporter(error, context);
+        }
+        return this.toResult(error, context);
+    }
+    /** Converts a BaseError into a safe response object. */
+    toResult(error, context) {
+        const metadata = {
+            ...(error.toJSON().metadata ?? {}),
+            ...(context?.metadata ?? {}),
+        };
+        return {
+            code: error.code,
+            message: error.expose ? error.message : this.defaultMessage,
+            category: error.category,
+            severity: error.severity,
+            statusCode: error.statusCode,
+            isOperational: error.isOperational,
+            expose: error.expose,
+            ...(context?.requestId ? { requestId: context.requestId } : {}),
+            ...(context?.correlationId
+                ? { correlationId: context.correlationId }
+                : {}),
+            ...(Object.keys(metadata).length > 0
+                ? { metadata: this.sanitizeMetadata(metadata) }
+                : {}),
+        };
+    }
+    /** Reports an error without producing a response. */
+    async report(value, context) {
+        const { error } = this.normalize(value);
+        if (this.reporter) {
+            await this.reporter(error, context);
+        }
+        return error;
+    }
+    /** Determines whether an error should expose its message to clients. */
+    shouldExpose(error) {
+        return error.expose;
+    }
+    /** Returns a safe serialized error representation. */
+    serialize(error, context) {
+        const result = this.toResult(error, context);
+        if (this.includeStack && error.expose === false) {
+            return { ...result, stack: error.stack };
+        }
+        return result;
+    }
+    /** Removes obviously sensitive fields from metadata before serialization. */
+    sanitizeMetadata(metadata) {
+        const sensitiveKeys = new Set([
+            "password",
+            "passcode",
+            "token",
+            "accessToken",
+            "refreshToken",
+            "authorization",
+            "cookie",
+            "secret",
+            "privateKey",
+            "apiKey",
+            "credential",
+        ]);
+        const sanitized = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            sanitized[key] = sensitiveKeys.has(key) ? "[REDACTED]" : value;
+        }
+        return sanitized;
+    }
+}
+//# sourceMappingURL=errorHandler.core.js.map

package/dist/utils/errorHandler.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.core.js","sourceRoot":"","sources":["../../src/utils/errorHandler.core.ts"],"names":[],"mappings":"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"}

package/dist/utils/errorHandler.factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Error handler factory functions.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorHandler } from "./errorHandler.core.js";
+import type { ErrorHandlerOptions } from "./errorHandler.types.js";
+/** Creates a default error handler. */
+export declare function createErrorHandler(options?: ErrorHandlerOptions): ErrorHandler;
+/** Normalizes an unknown error using a default handler. */
+export declare function normalizeError(value: unknown): BaseError;
+/** Determines whether an unknown value is a supported BaseError. */
+export declare function isHandledError(value: unknown): value is BaseError;
+//# sourceMappingURL=errorHandler.factory.d.ts.map

package/dist/utils/errorHandler.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.factory.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,uCAAuC;AACvC,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAEd;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAExD;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAEjE"}

package/dist/utils/errorHandler.factory.js

@@ -0,0 +1,18 @@
+/**
+ * Error handler factory functions.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorHandler } from "./errorHandler.core.js";
+/** Creates a default error handler. */
+export function createErrorHandler(options = {}) {
+    return new ErrorHandler(options);
+}
+/** Normalizes an unknown error using a default handler. */
+export function normalizeError(value) {
+    return new ErrorHandler().normalize(value).error;
+}
+/** Determines whether an unknown value is a supported BaseError. */
+export function isHandledError(value) {
+    return value instanceof BaseError;
+}
+//# sourceMappingURL=errorHandler.factory.js.map

package/dist/utils/errorHandler.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.factory.js","sourceRoot":"","sources":["../../src/utils/errorHandler.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,uCAAuC;AACvC,MAAM,UAAU,kBAAkB,CAChC,OAAO,GAAwB,EAAE;IAEjC,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,IAAI,YAAY,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,SAAS,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Error handler types and interfaces.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+/** Context supplied when handling an error. */
+export interface ErrorHandlerContext {
+    readonly requestId?: string;
+    readonly correlationId?: string;
+    readonly userId?: string;
+    readonly service?: string;
+    readonly operation?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Normalized representation of an unknown error. */
+export interface NormalizedError {
+    readonly error: BaseError;
+    readonly original: unknown;
+}
+/** Structured result returned by the error handler. */
+export interface ErrorHandlerResult {
+    readonly code: string;
+    readonly message: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly statusCode: number;
+    readonly isOperational: boolean;
+    readonly expose: boolean;
+    readonly requestId?: string;
+    readonly correlationId?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Callback used to report errors to an external logger or monitoring system. */
+export type ErrorReporter = (error: BaseError, context?: ErrorHandlerContext) => void | Promise<void>;
+/** Options for constructing an ErrorHandler. */
+export interface ErrorHandlerOptions {
+    readonly reporter?: ErrorReporter;
+    readonly defaultStatusCode?: number;
+    readonly defaultMessage?: string;
+    readonly includeStack?: boolean;
+}
+//# sourceMappingURL=errorHandler.types.d.ts.map

package/dist/utils/errorHandler.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.types.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC"}

package/dist/utils/errorHandler.types.js

@@ -0,0 +1,7 @@
+/**
+ * Error handler types and interfaces.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+//# sourceMappingURL=errorHandler.types.js.map

package/dist/utils/errorHandler.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.types.js","sourceRoot":"","sources":["../../src/utils/errorHandler.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/utils/errorMapper.core.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error mapper — re-exports from focused files.
+ */
+export type { ErrorMapperContext, ErrorMapping, ErrorMapperPredicate, ErrorMapper, ErrorMappingRule, } from "./errorMapper.types.js";
+export { ErrorMapperRegistry, createErrorMapperRegistry, } from "./errorMapper.registry.js";
+export { mapNativeError, mapError, mapErrorType, createErrorMappingRule, } from "./errorMapper.mappers.js";
+//# sourceMappingURL=errorMapper.core.d.ts.map

package/dist/utils/errorMapper.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.core.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapper.core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

package/dist/utils/errorMapper.core.js

@@ -0,0 +1,6 @@
+/**
+ * Error mapper — re-exports from focused files.
+ */
+export { ErrorMapperRegistry, createErrorMapperRegistry, } from "./errorMapper.registry.js";
+export { mapNativeError, mapError, mapErrorType, createErrorMappingRule, } from "./errorMapper.mappers.js";
+//# sourceMappingURL=errorMapper.core.js.map

package/dist/utils/errorMapper.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.core.js","sourceRoot":"","sources":["../../src/utils/errorMapper.core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

package/dist/utils/errorMapper.mappers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error mapping functions — native error mapping, registry-based mapping, rule creation.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import type { ErrorMapperContext, ErrorMapper, ErrorMapperPredicate, ErrorMappingRule } from "./errorMapper.types.js";
+import type { ErrorMapperRegistry } from "./errorMapper.registry.js";
+/** Maps common native JavaScript errors. */
+export declare function mapNativeError(error: unknown): BaseError | undefined;
+/** Maps an error using a registry and falls back to native error mapping. */
+export declare function mapError(error: unknown, registry?: ErrorMapperRegistry, context?: ErrorMapperContext): BaseError;
+/** Creates a mapping rule for a specific error constructor. */
+export declare function mapErrorType<T extends Error>(name: string, errorType: new (...args: unknown[]) => T, mapper: (error: T, context?: ErrorMapperContext) => BaseError, priority?: number): ErrorMappingRule;
+/** Creates a mapping rule based on a predicate. */
+export declare function createErrorMappingRule(name: string, predicate: ErrorMapperPredicate, mapper: ErrorMapper, priority?: number): ErrorMappingRule;
+//# sourceMappingURL=errorMapper.mappers.d.ts.map

package/dist/utils/errorMapper.mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.mappers.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapper.mappers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAI3D,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAsCpE;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,mBAAmB,EAC9B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,SAAS,CAqBX;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,CAAC,SAAS,KAAK,EAC1C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EACxC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,SAAS,EAC7D,QAAQ,SAAI,GACX,gBAAgB,CAOlB;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,oBAAoB,EAC/B,MAAM,EAAE,WAAW,EACnB,QAAQ,SAAI,GACX,gBAAgB,CAElB"}

package/dist/utils/errorMapper.mappers.js

@@ -0,0 +1,84 @@
+/**
+ * Error mapping functions — native error mapping, registry-based mapping, rule creation.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorCode } from "../base/types/errorCode.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+/** Maps common native JavaScript errors. */
+export function mapNativeError(error) {
+    if (error instanceof BaseError) {
+        return error;
+    }
+    if (error instanceof TypeError) {
+        return new BaseError(error.message, {
+            code: ErrorCode.INVALID_INPUT,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.WARNING,
+            statusCode: 400,
+            expose: true,
+            isOperational: true,
+            cause: error,
+        });
+    }
+    if (error instanceof RangeError) {
+        return new BaseError(error.message, {
+            code: ErrorCode.INVALID_INPUT,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.WARNING,
+            statusCode: 400,
+            expose: true,
+            isOperational: true,
+            cause: error,
+        });
+    }
+    if (error instanceof Error) {
+        return new BaseError(error.message || "An unexpected error occurred.", {
+            code: ErrorCode.INTERNAL_ERROR,
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
+            cause: error,
+        });
+    }
+    return undefined;
+}
+/** Maps an error using a registry and falls back to native error mapping. */
+export function mapError(error, registry, context) {
+    if (error instanceof BaseError) {
+        return error;
+    }
+    const mapped = registry?.map(error, context);
+    if (mapped) {
+        return mapped;
+    }
+    const native = mapNativeError(error);
+    if (native) {
+        return native;
+    }
+    return new BaseError("An unexpected error occurred.", {
+        code: ErrorCode.INTERNAL_ERROR,
+        category: ErrorCategory.SYSTEM,
+        severity: ErrorSeverity.ERROR,
+        statusCode: 500,
+        expose: false,
+        isOperational: false,
+        metadata: { originalType: typeof error },
+    });
+}
+/** Creates a mapping rule for a specific error constructor. */
+export function mapErrorType(name, errorType, mapper, priority = 0) {
+    return {
+        name,
+        priority,
+        predicate: (error) => error instanceof errorType,
+        mapper: (error, context) => mapper(error, context),
+    };
+}
+/** Creates a mapping rule based on a predicate. */
+export function createErrorMappingRule(name, predicate, mapper, priority = 0) {
+    return { name, predicate, mapper, priority };
+}
+//# sourceMappingURL=errorMapper.mappers.js.map

package/dist/utils/errorMapper.mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.mappers.js","sourceRoot":"","sources":["../../src/utils/errorMapper.mappers.ts"],"names":[],"mappings":"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"}

package/dist/utils/errorMapper.registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Central registry for converting third-party and native errors into application errors.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import type { ErrorMapperContext, ErrorMappingRule } from "./errorMapper.types.js";
+/** Central registry for converting third-party and native errors into application errors. */
+export declare class ErrorMapperRegistry {
+    private readonly rules;
+    /** Registers a mapping rule. */
+    register(rule: ErrorMappingRule): this;
+    /** Removes a mapping rule by name. */
+    unregister(name: string): boolean;
+    /** Returns whether a rule with the specified name exists. */
+    has(name: string): boolean;
+    /** Finds the first rule that matches an error. */
+    find(error: unknown, context?: ErrorMapperContext): ErrorMappingRule | undefined;
+    /** Maps an unknown error using the first matching rule. */
+    map(error: unknown, context?: ErrorMapperContext): BaseError | undefined;
+    /** Returns all registered rules. */
+    getRules(): readonly ErrorMappingRule[];
+    /** Clears all registered rules. */
+    clear(): void;
+}
+/** Creates an error mapper registry. */
+export declare function createErrorMapperRegistry(): ErrorMapperRegistry;
+//# sourceMappingURL=errorMapper.registry.d.ts.map

package/dist/utils/errorMapper.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.registry.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapper.registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,6FAA6F;AAC7F,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD,gCAAgC;IACzB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAc5C;IAED,sCAAsC;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOvC;IAED,6DAA6D;IACtD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED,kDAAkD;IAC3C,IAAI,CACT,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,gBAAgB,GAAG,SAAS,CAE9B;IAED,2DAA2D;IACpD,GAAG,CACR,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,SAAS,GAAG,SAAS,CAMvB;IAED,oCAAoC;IAC7B,QAAQ,IAAI,SAAS,gBAAgB,EAAE,CAE7C;IAED,mCAAmC;IAC5B,KAAK,IAAI,IAAI,CAEnB;CACF;AAED,wCAAwC;AACxC,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}

package/dist/utils/errorMapper.registry.js

@@ -0,0 +1,58 @@
+/**
+ * Central registry for converting third-party and native errors into application errors.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+/** Central registry for converting third-party and native errors into application errors. */
+export class ErrorMapperRegistry {
+    rules = [];
+    /** Registers a mapping rule. */
+    register(rule) {
+        if (!rule.name.trim()) {
+            throw new TypeError("Error mapping rule name cannot be empty.");
+        }
+        if (this.rules.some((existing) => existing.name === rule.name)) {
+            throw new Error(`An error mapping rule named "${rule.name}" is already registered.`);
+        }
+        this.rules.push(rule);
+        this.rules.sort((first, second) => (second.priority ?? 0) - (first.priority ?? 0));
+        return this;
+    }
+    /** Removes a mapping rule by name. */
+    unregister(name) {
+        const index = this.rules.findIndex((rule) => rule.name === name);
+        if (index === -1) {
+            return false;
+        }
+        this.rules.splice(index, 1);
+        return true;
+    }
+    /** Returns whether a rule with the specified name exists. */
+    has(name) {
+        return this.rules.some((rule) => rule.name === name);
+    }
+    /** Finds the first rule that matches an error. */
+    find(error, context) {
+        return this.rules.find((rule) => rule.predicate(error, context));
+    }
+    /** Maps an unknown error using the first matching rule. */
+    map(error, context) {
+        const rule = this.find(error, context);
+        if (!rule) {
+            return undefined;
+        }
+        return rule.mapper(error, context);
+    }
+    /** Returns all registered rules. */
+    getRules() {
+        return [...this.rules];
+    }
+    /** Clears all registered rules. */
+    clear() {
+        this.rules.length = 0;
+    }
+}
+/** Creates an error mapper registry. */
+export function createErrorMapperRegistry() {
+    return new ErrorMapperRegistry();
+}
+//# sourceMappingURL=errorMapper.registry.js.map

package/dist/utils/errorMapper.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.registry.js","sourceRoot":"","sources":["../../src/utils/errorMapper.registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAM3D,6FAA6F;AAC7F,MAAM,OAAO,mBAAmB;IACb,KAAK,GAAuB,EAAE,CAAC;IAEhD,gCAAgC;IACzB,QAAQ,CAAC,IAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,IAAI,0BAA0B,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CACb,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAClE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IAC/B,UAAU,CAAC,IAAY;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACjE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IACtD,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,kDAAkD;IAC3C,IAAI,CACT,KAAc,EACd,OAA4B;QAE5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,2DAA2D;IACpD,GAAG,CACR,KAAc,EACd,OAA4B;QAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,oCAAoC;IAC7B,QAAQ;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,mCAAmC;IAC5B,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AAED,wCAAwC;AACxC,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Error mapper types and interfaces.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+/** Context supplied to an error mapper. */
+export interface ErrorMapperContext {
+    readonly service?: string;
+    readonly operation?: string;
+    readonly requestId?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Result produced by an error mapper. */
+export interface ErrorMapping {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly statusCode: number;
+    readonly expose: boolean;
+    readonly isOperational: boolean;
+    readonly message?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Predicate used to determine whether a mapper applies to an error. */
+export type ErrorMapperPredicate = (error: unknown, context?: ErrorMapperContext) => boolean;
+/** Function that maps an unknown error into the application's standardized error representation. */
+export type ErrorMapper = (error: unknown, context?: ErrorMapperContext) => BaseError;
+/** A registered error mapping rule. */
+export interface ErrorMappingRule {
+    readonly name: string;
+    readonly predicate: ErrorMapperPredicate;
+    readonly mapper: ErrorMapper;
+    readonly priority?: number;
+}
+//# sourceMappingURL=errorMapper.types.d.ts.map

package/dist/utils/errorMapper.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.types.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapper.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,KACzB,OAAO,CAAC;AAEb,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,KACzB,SAAS,CAAC;AAEf,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/utils/errorMapper.types.js

@@ -0,0 +1,7 @@
+/**
+ * Error mapper types and interfaces.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+//# sourceMappingURL=errorMapper.types.js.map

package/dist/utils/errorMapper.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapper.types.js","sourceRoot":"","sources":["../../src/utils/errorMapper.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/utils/errorSerializer.core.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Converts errors into safe, predictable serialized structures.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import type { ErrorSerializerOptions, PublicErrorResponse, InternalErrorResponse } from "./errorSerializer.types.js";
+export type { ErrorSerializerOptions, PublicErrorResponse, InternalErrorResponse, } from "./errorSerializer.types.js";
+export { createErrorSerializer, serializeError, serializePublicError, normalizeUnknownError, } from "./errorSerializer.factory.js";
+/** Converts errors into safe, predictable serialized structures. */
+export declare class ErrorSerializer {
+    private readonly includeStack;
+    private readonly includeCause;
+    private readonly includeMetadata;
+    private readonly safeMessage;
+    private readonly redactSensitiveData;
+    constructor(options?: ErrorSerializerOptions);
+    /** Serializes an error for internal logging or monitoring. */
+    serialize(error: BaseError): InternalErrorResponse;
+    /** Serializes an error for an untrusted API client. */
+    serializePublic(error: BaseError): PublicErrorResponse;
+    /** Serializes an unknown thrown value. */
+    serializeUnknown(value: unknown): InternalErrorResponse;
+    /** Creates a public response from an unknown thrown value. */
+    serializeUnknownPublic(value: unknown): PublicErrorResponse;
+    /** Removes commonly sensitive metadata fields. */
+    private redactMetadata;
+}
+//# sourceMappingURL=errorSerializer.core.d.ts.map

package/dist/utils/errorSerializer.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorSerializer.core.d.ts","sourceRoot":"","sources":["../../src/utils/errorSerializer.core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,oEAAoE;AACpE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAE9C,YAAY,OAAO,GAAE,sBAA2B,EAM/C;IAED,8DAA8D;IACvD,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,qBAAqB,CAiBxD;IAED,uDAAuD;IAChD,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,mBAAmB,CAW5D;IAED,0CAA0C;IACnC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAE7D;IAED,8DAA8D;IACvD,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAEjE;IAED,kDAAkD;IAClD,OAAO,CAAC,cAAc;CAuBvB"}