@zudojs/errors 0.0.1

package/dist/utils/errorSerializer.core.js

@@ -0,0 +1,82 @@
+/**
+ * Converts errors into safe, predictable serialized structures.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { normalizeUnknownError } from "./errorSerializer.factory.js";
+export { createErrorSerializer, serializeError, serializePublicError, normalizeUnknownError, } from "./errorSerializer.factory.js";
+/** Converts errors into safe, predictable serialized structures. */
+export class ErrorSerializer {
+    includeStack;
+    includeCause;
+    includeMetadata;
+    safeMessage;
+    redactSensitiveData;
+    constructor(options = {}) {
+        this.includeStack = options.includeStack ?? false;
+        this.includeCause = options.includeCause ?? false;
+        this.includeMetadata = options.includeMetadata ?? true;
+        this.safeMessage = options.safeMessage ?? "An unexpected error occurred.";
+        this.redactSensitiveData = options.redactSensitiveData ?? true;
+    }
+    /** Serializes an error for internal logging or monitoring. */
+    serialize(error) {
+        const serialized = error.toJSON();
+        const result = {
+            ...serialized,
+            ...(this.includeStack ? {} : { stack: undefined }),
+            ...(this.includeCause ? {} : { cause: undefined }),
+            ...(this.includeMetadata ? {} : { metadata: {} }),
+        };
+        if (this.redactSensitiveData && result.metadata) {
+            return {
+                ...result,
+                metadata: this.redactMetadata(result.metadata),
+            };
+        }
+        return result;
+    }
+    /** Serializes an error for an untrusted API client. */
+    serializePublic(error) {
+        const metadata = this.includeMetadata
+            ? this.redactMetadata(error.metadata)
+            : undefined;
+        return {
+            code: error.code,
+            message: error.expose ? error.message : this.safeMessage,
+            category: error.category,
+            statusCode: error.statusCode,
+            ...(metadata && Object.keys(metadata).length > 0 ? { metadata } : {}),
+        };
+    }
+    /** Serializes an unknown thrown value. */
+    serializeUnknown(value) {
+        return this.serialize(normalizeUnknownError(value));
+    }
+    /** Creates a public response from an unknown thrown value. */
+    serializeUnknownPublic(value) {
+        return this.serializePublic(normalizeUnknownError(value));
+    }
+    /** Removes commonly sensitive metadata fields. */
+    redactMetadata(metadata) {
+        const sensitiveKeys = new Set([
+            "password",
+            "passcode",
+            "token",
+            "accessToken",
+            "refreshToken",
+            "authorization",
+            "cookie",
+            "secret",
+            "privateKey",
+            "apiKey",
+            "credential",
+            "clientSecret",
+        ]);
+        const result = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            result[key] = sensitiveKeys.has(key) ? "[REDACTED]" : value;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=errorSerializer.core.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Error serializer factory and utility functions.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorSerializer } from "./errorSerializer.core.js";
+import type { ErrorSerializerOptions, PublicErrorResponse, InternalErrorResponse } from "./errorSerializer.types.js";
+export type { ErrorSerializerOptions, PublicErrorResponse, InternalErrorResponse, } from "./errorSerializer.types.js";
+/** Creates an ErrorSerializer instance. */
+export declare function createErrorSerializer(options?: ErrorSerializerOptions): ErrorSerializer;
+/** Serializes a BaseError for internal use. */
+export declare function serializeError(error: BaseError, options?: ErrorSerializerOptions): InternalErrorResponse;
+/** Serializes a BaseError for public API responses. */
+export declare function serializePublicError(error: BaseError, options?: ErrorSerializerOptions): PublicErrorResponse;
+/** Converts an unknown thrown value into a BaseError. */
+export declare function normalizeUnknownError(value: unknown): BaseError;
+//# sourceMappingURL=errorSerializer.factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorSerializer.factory.d.ts","sourceRoot":"","sources":["../../src/utils/errorSerializer.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAEpC,2CAA2C;AAC3C,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAEjB;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAEvB;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,sBAA2B,GACnC,mBAAmB,CAErB;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAwB/D"}

package/dist/utils/errorSerializer.factory.js

@@ -0,0 +1,46 @@
+/**
+ * Error serializer factory and utility functions.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+import { ErrorSerializer } from "./errorSerializer.core.js";
+/** Creates an ErrorSerializer instance. */
+export function createErrorSerializer(options = {}) {
+    return new ErrorSerializer(options);
+}
+/** Serializes a BaseError for internal use. */
+export function serializeError(error, options = {}) {
+    return new ErrorSerializer(options).serialize(error);
+}
+/** Serializes a BaseError for public API responses. */
+export function serializePublicError(error, options = {}) {
+    return new ErrorSerializer(options).serializePublic(error);
+}
+/** Converts an unknown thrown value into a BaseError. */
+export function normalizeUnknownError(value) {
+    if (value instanceof BaseError) {
+        return value;
+    }
+    if (value instanceof Error) {
+        return new BaseError(value.message || "An unexpected error occurred.", {
+            code: "INTERNAL_ERROR",
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
+            cause: value,
+        });
+    }
+    return new BaseError("An unexpected error occurred.", {
+        code: "INTERNAL_ERROR",
+        category: ErrorCategory.SYSTEM,
+        severity: ErrorSeverity.ERROR,
+        statusCode: 500,
+        expose: false,
+        isOperational: false,
+        metadata: { originalType: typeof value },
+    });
+}
+//# sourceMappingURL=errorSerializer.factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorSerializer.factory.js","sourceRoot":"","sources":["../../src/utils/errorSerializer.factory.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;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAa5D,2CAA2C;AAC3C,MAAM,UAAU,qBAAqB,CACnC,OAAO,GAA2B,EAAE;IAEpC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,OAAO,GAA2B,EAAE;IAEpC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,oBAAoB,CAClC,KAAgB,EAChB,OAAO,GAA2B,EAAE;IAEpC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,+BAA+B,EAAE;YACrE,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,aAAa,CAAC,MAAM;YAC9B,QAAQ,EAAE,aAAa,CAAC,KAAK;YAC7B,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,KAAK;YACpB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,+BAA+B,EAAE;QACpD,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,aAAa,CAAC,MAAM;QAC9B,QAAQ,EAAE,aAAa,CAAC,KAAK;QAC7B,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,KAAK;QACpB,QAAQ,EAAE,EAAE,YAAY,EAAE,OAAO,KAAK,EAAE;KACzC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Error serializer types and interfaces.
+ */
+import type { SerializedBaseError } from "../base/types/baseError.type.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+/** Options controlling error serialization. */
+export interface ErrorSerializerOptions {
+    /** Include the stack trace in the serialized result. Defaults to false. */
+    readonly includeStack?: boolean;
+    /** Include the error cause. Defaults to false. */
+    readonly includeCause?: boolean;
+    /** Include internal metadata. Defaults to true for internal serialization. */
+    readonly includeMetadata?: boolean;
+    /** Replace non-exposable error messages with a safe message. */
+    readonly safeMessage?: string;
+    /** Remove sensitive metadata values. */
+    readonly redactSensitiveData?: boolean;
+}
+/** Public error representation suitable for an API response. */
+export interface PublicErrorResponse {
+    readonly code: string;
+    readonly message: string;
+    readonly category: ErrorCategory;
+    readonly statusCode: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Internal serialized error representation. */
+export interface InternalErrorResponse extends SerializedBaseError {
+}
+//# sourceMappingURL=errorSerializer.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorSerializer.types.d.ts","sourceRoot":"","sources":["../../src/utils/errorSerializer.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;CAAG"}

package/dist/utils/errorSerializer.types.js

@@ -0,0 +1,5 @@
+/**
+ * Error serializer types and interfaces.
+ */
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+//# sourceMappingURL=errorSerializer.types.js.map

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

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

package/dist/utils/errorUtils.extraction.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error extraction utilities — message, name, stack, root cause.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+/** Returns the message from an unknown thrown value. */
+export declare function getErrorMessage(value: unknown, fallback?: string): string;
+/** Returns the name from an unknown thrown value. */
+export declare function getErrorName(value: unknown, fallback?: string): string;
+/** Returns the stack trace from an unknown thrown value. */
+export declare function getErrorStack(value: unknown): string | undefined;
+/** Returns the root cause of an error chain. */
+export declare function getRootCause(value: unknown): unknown;
+/** Returns the deepest BaseError in an error chain. */
+export declare function getRootBaseError(value: unknown): BaseError | undefined;
+/** Extracts a plain object of useful error diagnostics. */
+export declare function getErrorDiagnostics(value: unknown): Record<string, unknown>;
+//# sourceMappingURL=errorUtils.extraction.d.ts.map

package/dist/utils/errorUtils.extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.extraction.d.ts","sourceRoot":"","sources":["../../src/utils/errorUtils.extraction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAG3D,wDAAwD;AACxD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,SAAkC,GACzC,MAAM,CAWR;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAU,GAAG,MAAM,CAQvE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQhE;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAepD;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAkBtE;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB3E"}

package/dist/utils/errorUtils.extraction.js

@@ -0,0 +1,90 @@
+/**
+ * Error extraction utilities — message, name, stack, root cause.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { isErrorLike } from "./errorUtils.typeCheck.js";
+/** Returns the message from an unknown thrown value. */
+export function getErrorMessage(value, fallback = "An unexpected error occurred.") {
+    if (value instanceof Error) {
+        return value.message || fallback;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (isErrorLike(value)) {
+        return value.message;
+    }
+    return fallback;
+}
+/** Returns the name from an unknown thrown value. */
+export function getErrorName(value, fallback = "Error") {
+    if (value instanceof Error) {
+        return value.name || fallback;
+    }
+    if (isErrorLike(value) && typeof value.name === "string") {
+        return value.name;
+    }
+    return fallback;
+}
+/** Returns the stack trace from an unknown thrown value. */
+export function getErrorStack(value) {
+    if (value instanceof Error) {
+        return value.stack;
+    }
+    if (isErrorLike(value)) {
+        return value.stack;
+    }
+    return undefined;
+}
+/** Returns the root cause of an error chain. */
+export function getRootCause(value) {
+    let current = value;
+    const visited = new Set();
+    while (current instanceof Error &&
+        "cause" in current &&
+        current.cause !== undefined &&
+        !visited.has(current)) {
+        visited.add(current);
+        current = current.cause;
+    }
+    return current;
+}
+/** Returns the deepest BaseError in an error chain. */
+export function getRootBaseError(value) {
+    let current = value;
+    let result;
+    const visited = new Set();
+    while (current !== undefined && current !== null && !visited.has(current)) {
+        visited.add(current);
+        if (current instanceof BaseError) {
+            result = current;
+        }
+        if (current instanceof Error && "cause" in current) {
+            current = current.cause;
+            continue;
+        }
+        break;
+    }
+    return result;
+}
+/** Extracts a plain object of useful error diagnostics. */
+export function getErrorDiagnostics(value) {
+    const diagnostics = {
+        name: getErrorName(value),
+        message: getErrorMessage(value),
+    };
+    const stack = getErrorStack(value);
+    if (stack !== undefined) {
+        diagnostics.stack = stack;
+    }
+    if (value instanceof BaseError) {
+        diagnostics.code = value.code;
+        diagnostics.category = value.category;
+        diagnostics.severity = value.severity;
+        diagnostics.statusCode = value.statusCode;
+        diagnostics.isOperational = value.isOperational;
+        diagnostics.expose = value.expose;
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=errorUtils.extraction.js.map

package/dist/utils/errorUtils.extraction.js.map

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

package/dist/utils/errorUtils.helper.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error utilities — re-exports from focused files.
+ */
+export { isErrorLike, isOperationalError, isExposableError, isServerError, isClientError, hasErrorCategory, hasErrorSeverity, } from "./errorUtils.typeCheck.js";
+export { getErrorMessage, getErrorName, getErrorStack, getRootCause, getRootBaseError, getErrorDiagnostics, } from "./errorUtils.extraction.js";
+export { toError, withErrorContext, tryCatch, tryCatchAsync, normalizeToBaseError, } from "./errorUtils.transform.js";
+//# sourceMappingURL=errorUtils.helper.d.ts.map

package/dist/utils/errorUtils.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.helper.d.ts","sourceRoot":"","sources":["../../src/utils/errorUtils.helper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/utils/errorUtils.helper.js

@@ -0,0 +1,7 @@
+/**
+ * Error utilities — re-exports from focused files.
+ */
+export { isErrorLike, isOperationalError, isExposableError, isServerError, isClientError, hasErrorCategory, hasErrorSeverity, } from "./errorUtils.typeCheck.js";
+export { getErrorMessage, getErrorName, getErrorStack, getRootCause, getRootBaseError, getErrorDiagnostics, } from "./errorUtils.extraction.js";
+export { toError, withErrorContext, tryCatch, tryCatchAsync, normalizeToBaseError, } from "./errorUtils.transform.js";
+//# sourceMappingURL=errorUtils.helper.js.map

package/dist/utils/errorUtils.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.helper.js","sourceRoot":"","sources":["../../src/utils/errorUtils.helper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/utils/errorUtils.transform.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Error transformation utilities — toError, withErrorContext, tryCatch, normalize.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+/** Safely converts an unknown thrown value into an Error instance. */
+export declare function toError(value: unknown, fallback?: string): Error;
+/** Adds context to an Error while preserving the original error as its cause. */
+export declare function withErrorContext(error: unknown, context: string): Error;
+/** Executes a function and converts thrown values into BaseError instances. */
+export declare function tryCatch<T>(operation: () => T): {
+    readonly success: true;
+    readonly value: T;
+} | {
+    readonly success: false;
+    readonly error: BaseError;
+};
+/** Async equivalent of tryCatch. */
+export declare function tryCatchAsync<T>(operation: () => T | Promise<T>): Promise<{
+    readonly success: true;
+    readonly value: T;
+} | {
+    readonly success: false;
+    readonly error: BaseError;
+}>;
+/** Converts an unknown thrown value into a BaseError. */
+export declare function normalizeToBaseError(value: unknown): BaseError;
+//# sourceMappingURL=errorUtils.transform.d.ts.map

package/dist/utils/errorUtils.transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.transform.d.ts","sourceRoot":"","sources":["../../src/utils/errorUtils.transform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAK3D,sEAAsE;AACtE,wBAAgB,OAAO,CACrB,KAAK,EAAE,OAAO,EACd,QAAQ,SAAkC,GACzC,KAAK,CAKP;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAGvE;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,CAAC,GAEhB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAMzD;AAED,oCAAoC;AACpC,wBAAsB,aAAa,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CACN;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CACzD,CAMA;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CA0B9D"}

package/dist/utils/errorUtils.transform.js

@@ -0,0 +1,64 @@
+/**
+ * Error transformation utilities — toError, withErrorContext, tryCatch, normalize.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+import { getErrorMessage } from "./errorUtils.extraction.js";
+/** Safely converts an unknown thrown value into an Error instance. */
+export function toError(value, fallback = "An unexpected error occurred.") {
+    if (value instanceof Error) {
+        return value;
+    }
+    return new Error(getErrorMessage(value, fallback));
+}
+/** Adds context to an Error while preserving the original error as its cause. */
+export function withErrorContext(error, context) {
+    const original = toError(error);
+    return new Error(`${context}: ${original.message}`, { cause: original });
+}
+/** Executes a function and converts thrown values into BaseError instances. */
+export function tryCatch(operation) {
+    try {
+        return { success: true, value: operation() };
+    }
+    catch (error) {
+        return { success: false, error: normalizeToBaseError(error) };
+    }
+}
+/** Async equivalent of tryCatch. */
+export async function tryCatchAsync(operation) {
+    try {
+        return { success: true, value: await operation() };
+    }
+    catch (error) {
+        return { success: false, error: normalizeToBaseError(error) };
+    }
+}
+/** Converts an unknown thrown value into a BaseError. */
+export function normalizeToBaseError(value) {
+    if (value instanceof BaseError) {
+        return value;
+    }
+    if (value instanceof Error) {
+        return new BaseError(value.message || "An unexpected error occurred.", {
+            code: "INTERNAL_ERROR",
+            category: ErrorCategory.SYSTEM,
+            severity: ErrorSeverity.ERROR,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
+            cause: value,
+        });
+    }
+    return new BaseError(getErrorMessage(value), {
+        code: "INTERNAL_ERROR",
+        category: ErrorCategory.SYSTEM,
+        severity: ErrorSeverity.ERROR,
+        statusCode: 500,
+        expose: false,
+        isOperational: false,
+        metadata: { originalType: typeof value },
+    });
+}
+//# sourceMappingURL=errorUtils.transform.js.map

package/dist/utils/errorUtils.transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.transform.js","sourceRoot":"","sources":["../../src/utils/errorUtils.transform.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;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,sEAAsE;AACtE,MAAM,UAAU,OAAO,CACrB,KAAc,EACd,QAAQ,GAAG,+BAA+B;IAE1C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,OAAe;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CACtB,SAAkB;IAIlB,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAA+B;IAK/B,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,+BAA+B,EAAE;YACrE,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,aAAa,CAAC,MAAM;YAC9B,QAAQ,EAAE,aAAa,CAAC,KAAK;YAC7B,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,KAAK;YACpB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE;QAC3C,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,aAAa,CAAC,MAAM;QAC9B,QAAQ,EAAE,aAAa,CAAC,KAAK;QAC7B,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,KAAK;QACpB,QAAQ,EAAE,EAAE,YAAY,EAAE,OAAO,KAAK,EAAE;KACzC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/errorUtils.typeCheck.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Error type-checking utilities.
+ */
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+/** Type guard for unknown error-like values. */
+export declare function isErrorLike(value: unknown): value is {
+    readonly name: string;
+    readonly message: string;
+    readonly stack?: string;
+};
+/** Returns whether an error is operational. */
+export declare function isOperationalError(value: unknown): boolean;
+/** Returns whether an error is safe to expose to clients. */
+export declare function isExposableError(value: unknown): boolean;
+/** Returns whether an error represents a server-side failure. */
+export declare function isServerError(value: unknown): boolean;
+/** Returns whether an error represents a client-side failure. */
+export declare function isClientError(value: unknown): boolean;
+/** Returns whether an error belongs to a category. */
+export declare function hasErrorCategory(value: unknown, category: ErrorCategory): boolean;
+/** Returns whether an error has a specific severity. */
+export declare function hasErrorSeverity(value: unknown, severity: ErrorSeverity): boolean;
+//# sourceMappingURL=errorUtils.typeCheck.d.ts.map

package/dist/utils/errorUtils.typeCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.typeCheck.d.ts","sourceRoot":"","sources":["../../src/utils/errorUtils.typeCheck.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAOA;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAExD;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKrD;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMrD;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAET;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAET"}

package/dist/utils/errorUtils.typeCheck.js

@@ -0,0 +1,43 @@
+/**
+ * Error type-checking utilities.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+/** Type guard for unknown error-like values. */
+export function isErrorLike(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "message" in value &&
+        typeof value.message === "string");
+}
+/** Returns whether an error is operational. */
+export function isOperationalError(value) {
+    return value instanceof BaseError && value.isOperational;
+}
+/** Returns whether an error is safe to expose to clients. */
+export function isExposableError(value) {
+    return value instanceof BaseError && value.expose;
+}
+/** Returns whether an error represents a server-side failure. */
+export function isServerError(value) {
+    if (value instanceof BaseError) {
+        return value.statusCode >= 500;
+    }
+    return true;
+}
+/** Returns whether an error represents a client-side failure. */
+export function isClientError(value) {
+    return (value instanceof BaseError &&
+        value.statusCode >= 400 &&
+        value.statusCode < 500);
+}
+/** Returns whether an error belongs to a category. */
+export function hasErrorCategory(value, category) {
+    return value instanceof BaseError && value.category === category;
+}
+/** Returns whether an error has a specific severity. */
+export function hasErrorSeverity(value, severity) {
+    return value instanceof BaseError && value.severity === severity;
+}
+//# sourceMappingURL=errorUtils.typeCheck.js.map

package/dist/utils/errorUtils.typeCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.typeCheck.js","sourceRoot":"","sources":["../../src/utils/errorUtils.typeCheck.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,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,KAAc;IAKxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ,CAC7D,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC;AAC3D,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;AACpD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,KAAK,YAAY,SAAS;QAC1B,KAAK,CAAC,UAAU,IAAI,GAAG;QACvB,KAAK,CAAC,UAAU,GAAG,GAAG,CACvB,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,QAAuB;IAEvB,OAAO,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACnE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,QAAuB;IAEvB,OAAO,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACnE,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/errors/utils
+ *
+ * Error handling utilities, mappers, and serializers.
+ */
+export * from "./errorHandler.core.js";
+export * from "./errorMapper.core.js";
+export * from "./errorSerializer.core.js";
+export * from "./errorUtils.helper.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/errors/utils
+ *
+ * Error handling utilities, mappers, and serializers.
+ */
+export * from "./errorHandler.core.js";
+export * from "./errorMapper.core.js";
+export * from "./errorSerializer.core.js";
+export * from "./errorUtils.helper.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@zudojs/errors",
+  "version": "0.0.1",
+  "description": "Shared error base class, error codes, and error handling utilities for the Zudojs framework.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "errors",
+    "error-handling"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}