@zudojs/errors 0.0.1

package/dist/base/core/baseError.core.js

@@ -0,0 +1,115 @@
+import { ErrorCategory } from "../types/errorCategory.type.js";
+import { ErrorCode } from "../types/errorCode.type.js";
+import { ErrorSeverity } from "../types/errorSeverity.type.js";
+import { createErrorMetadata, serializeErrorMetadata, } from "./errorMetadata.core.js";
+/**
+ * Base error class shared by all Zudojs application errors.
+ *
+ * Provides a consistent structure for error handling, logging,
+ * HTTP responses, monitoring, and serialization.
+ */
+export class BaseError extends Error {
+    code;
+    category;
+    severity;
+    statusCode;
+    expose;
+    isOperational;
+    metadata;
+    cause;
+    constructor(message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = new.target.name;
+        this.code = options.code ?? ErrorCode.UNKNOWN;
+        this.category = options.category ?? ErrorCategory.UNKNOWN;
+        this.severity = options.severity ?? ErrorSeverity.ERROR;
+        this.statusCode = normalizeStatusCode(options.statusCode);
+        this.expose = options.expose ?? this.statusCode < 500;
+        this.isOperational = options.isOperational ?? true;
+        this.metadata = createErrorMetadata(options.metadata);
+        this.cause = options.cause;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    /** Returns whether this error is safe to expose to clients. */
+    isPublic() {
+        return this.expose;
+    }
+    /** Returns whether this error represents an operational failure. */
+    isOperationalError() {
+        return this.isOperational;
+    }
+    /** Returns a metadata value by key. */
+    getMetadata(key) {
+        return this.metadata[key];
+    }
+    /** Creates a new error with additional metadata. */
+    withMetadata(metadata) {
+        const ErrorConstructor = this.constructor;
+        return new ErrorConstructor(this.message, {
+            code: this.code,
+            category: this.category,
+            severity: this.severity,
+            statusCode: this.statusCode,
+            expose: this.expose,
+            isOperational: this.isOperational,
+            metadata: { ...this.metadata, ...metadata },
+            cause: this.cause,
+        });
+    }
+    /**
+     * Converts the error into a serializable representation.
+     * Stack traces included for trusted internal logging.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            category: this.category,
+            severity: this.severity,
+            statusCode: this.statusCode,
+            expose: this.expose,
+            isOperational: this.isOperational,
+            metadata: serializeErrorMetadata(this.metadata),
+            ...(this.stack ? { stack: this.stack } : {}),
+            ...(this.cause !== undefined
+                ? { cause: serializeErrorCause(this.cause) }
+                : {}),
+        };
+    }
+    /** Returns the error as a plain object for internal logging. */
+    toLogObject() {
+        return this.toJSON();
+    }
+    /** Returns a concise error description. */
+    toString() {
+        return `${this.name} [${this.code}]: ${this.message}`;
+    }
+}
+/**
+ * Normalizes HTTP status codes to valid range.
+ */
+function normalizeStatusCode(statusCode) {
+    if (statusCode === undefined)
+        return 500;
+    if (!Number.isInteger(statusCode) || statusCode < 100 || statusCode > 599) {
+        throw new RangeError("Error statusCode must be an integer between 100 and 599.");
+    }
+    return statusCode;
+}
+/**
+ * Serializes nested Error causes while avoiding recursive failures.
+ */
+function serializeErrorCause(cause) {
+    if (cause instanceof BaseError)
+        return cause.toJSON();
+    if (cause instanceof Error) {
+        return {
+            name: cause.name,
+            message: cause.message,
+            ...(cause.stack ? { stack: cause.stack } : {}),
+        };
+    }
+    return cause;
+}
+//# sourceMappingURL=baseError.core.js.map

package/dist/base/core/baseError.core.js.map

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

package/dist/base/core/errorMetadata.core.d.ts

@@ -0,0 +1,24 @@
+import type { ErrorMetadata, ErrorMetadataValue } from "./errorMetadata.type.js";
+/** Creates an immutable metadata object. */
+export declare function createErrorMetadata(metadata: ErrorMetadata | undefined | null): Readonly<ErrorMetadata>;
+/** Merges multiple metadata objects. Later metadata objects override earlier values. */
+export declare function mergeErrorMetadata(...metadata: readonly (ErrorMetadata | undefined | null)[]): Readonly<ErrorMetadata>;
+/** Reads a metadata property. */
+export declare function getErrorMetadataValue(metadata: ErrorMetadata | undefined | null, key: string): ErrorMetadataValue | undefined;
+/** Determines whether metadata contains a property. */
+export declare function hasErrorMetadata(metadata: ErrorMetadata | undefined | null, key: string): boolean;
+/** Removes a metadata property. */
+export declare function omitErrorMetadata(metadata: ErrorMetadata | undefined | null, ...keys: readonly string[]): Readonly<ErrorMetadata>;
+/** Selects only the requested metadata properties. */
+export declare function pickErrorMetadata(metadata: ErrorMetadata | undefined | null, keys: readonly string[]): Readonly<ErrorMetadata>;
+/** Converts metadata into a plain JSON-safe object. */
+export declare function serializeErrorMetadata(metadata: ErrorMetadata | undefined | null): Record<string, ErrorMetadataValue>;
+/** Determines whether an arbitrary value is valid error metadata. */
+export declare function isErrorMetadataValue(value: unknown): value is ErrorMetadataValue;
+/**
+ * Sanitizes arbitrary metadata by removing unsupported values.
+ *
+ * This is useful before serializing unknown data into logs or API responses.
+ */
+export declare function sanitizeErrorMetadata(metadata: Record<string, unknown> | undefined | null): Readonly<ErrorMetadata>;
+//# sourceMappingURL=errorMetadata.core.d.ts.map

package/dist/base/core/errorMetadata.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMetadata.core.d.ts","sourceRoot":"","sources":["../../../src/base/core/errorMetadata.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,4CAA4C;AAC5C,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GACzC,QAAQ,CAAC,aAAa,CAAC,CAGzB;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAChC,GAAG,QAAQ,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GACzD,QAAQ,CAAC,aAAa,CAAC,CAWzB;AAED,iCAAiC;AACjC,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,EAC1C,GAAG,EAAE,MAAM,GACV,kBAAkB,GAAG,SAAS,CAGhC;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,EAC1C,GAAG,EAAE,MAAM,GACV,OAAO,CAMT;AAED,mCAAmC;AACnC,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,EAC1C,GAAG,IAAI,EAAE,SAAS,MAAM,EAAE,GACzB,QAAQ,CAAC,aAAa,CAAC,CAMzB;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,EAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,QAAQ,CAAC,aAAa,CAAC,CAUzB;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GACzC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAGpC;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kBAAkB,CAa7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACnD,QAAQ,CAAC,aAAa,CAAC,CAUzB"}

package/dist/base/core/errorMetadata.core.js

@@ -0,0 +1,87 @@
+/** Creates an immutable metadata object. */
+export function createErrorMetadata(metadata) {
+    if (metadata === undefined || metadata === null)
+        return Object.freeze({});
+    return Object.freeze({ ...metadata });
+}
+/** Merges multiple metadata objects. Later metadata objects override earlier values. */
+export function mergeErrorMetadata(...metadata) {
+    const merged = {};
+    for (const current of metadata) {
+        if (current === undefined || current === null)
+            continue;
+        for (const [key, value] of Object.entries(current)) {
+            if (value !== undefined)
+                merged[key] = value;
+        }
+    }
+    return Object.freeze(merged);
+}
+/** Reads a metadata property. */
+export function getErrorMetadataValue(metadata, key) {
+    if (metadata === undefined || metadata === null)
+        return undefined;
+    return metadata[key];
+}
+/** Determines whether metadata contains a property. */
+export function hasErrorMetadata(metadata, key) {
+    return (metadata !== undefined &&
+        metadata !== null &&
+        Object.prototype.hasOwnProperty.call(metadata, key));
+}
+/** Removes a metadata property. */
+export function omitErrorMetadata(metadata, ...keys) {
+    if (metadata === undefined || metadata === null)
+        return Object.freeze({});
+    const omitted = { ...metadata };
+    for (const key of keys)
+        delete omitted[key];
+    return Object.freeze(omitted);
+}
+/** Selects only the requested metadata properties. */
+export function pickErrorMetadata(metadata, keys) {
+    if (metadata === undefined || metadata === null)
+        return Object.freeze({});
+    const selected = {};
+    for (const key of keys) {
+        const value = metadata[key];
+        if (value !== undefined)
+            selected[key] = value;
+    }
+    return Object.freeze(selected);
+}
+/** Converts metadata into a plain JSON-safe object. */
+export function serializeErrorMetadata(metadata) {
+    if (metadata === undefined || metadata === null)
+        return {};
+    return { ...metadata };
+}
+/** Determines whether an arbitrary value is valid error metadata. */
+export function isErrorMetadataValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isErrorMetadataValue);
+    if (typeof value === "object") {
+        return Object.values(value).every((entry) => entry === undefined || isErrorMetadataValue(entry));
+    }
+    return false;
+}
+/**
+ * Sanitizes arbitrary metadata by removing unsupported values.
+ *
+ * This is useful before serializing unknown data into logs or API responses.
+ */
+export function sanitizeErrorMetadata(metadata) {
+    if (metadata === undefined || metadata === null)
+        return Object.freeze({});
+    const sanitized = {};
+    for (const [key, value] of Object.entries(metadata)) {
+        if (value !== undefined && isErrorMetadataValue(value))
+            sanitized[key] = value;
+    }
+    return Object.freeze(sanitized);
+}
+//# sourceMappingURL=errorMetadata.core.js.map

package/dist/base/core/errorMetadata.core.js.map

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

package/dist/base/core/errorMetadata.type.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON-compatible primitive values.
+ */
+export type ErrorMetadataPrimitive = string | number | boolean | null;
+/**
+ * Values that can safely be attached to an error as metadata.
+ *
+ * Metadata should remain serializable so it can be transported through
+ * logs, APIs, queues, and monitoring systems.
+ */
+export type ErrorMetadataValue = ErrorMetadataPrimitive | readonly ErrorMetadataValue[] | {
+    readonly [key: string]: ErrorMetadataValue;
+};
+/**
+ * Metadata associated with an application error.
+ */
+export interface ErrorMetadata {
+    readonly [key: string]: ErrorMetadataValue | undefined;
+}
+//# sourceMappingURL=errorMetadata.type.d.ts.map

package/dist/base/core/errorMetadata.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMetadata.type.d.ts","sourceRoot":"","sources":["../../../src/base/core/errorMetadata.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,SAAS,kBAAkB,EAAE,GAC7B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;CACxD"}

package/dist/base/core/errorMetadata.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errorMetadata.type.js.map

package/dist/base/core/errorMetadata.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMetadata.type.js","sourceRoot":"","sources":["../../../src/base/core/errorMetadata.type.ts"],"names":[],"mappings":""}

package/dist/base/core/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/errors/base/core
+ *
+ * Base error class and metadata handling.
+ */
+export * from "./baseError.core.js";
+export * from "./errorMetadata.type.js";
+export * from "./errorMetadata.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/base/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/base/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/errors/base/core
+ *
+ * Base error class and metadata handling.
+ */
+export * from "./baseError.core.js";
+export * from "./errorMetadata.type.js";
+export * from "./errorMetadata.core.js";
+//# sourceMappingURL=index.js.map

package/dist/base/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/base/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/errors/base
+ *
+ * Base error class, error codes, categories, and severity levels.
+ */
+export * from "./types/index.js";
+export * from "./core/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/errors/base
+ *
+ * Base error class, error codes, categories, and severity levels.
+ */
+export * from "./types/index.js";
+export * from "./core/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/base/types/baseError.type.d.ts

@@ -0,0 +1,35 @@
+import type { ErrorCategory } from "./errorCategory.type.js";
+import type { ErrorCode } from "./errorCode.type.js";
+import type { ErrorSeverity } from "./errorSeverity.type.js";
+import type { ErrorMetadata } from "../core/errorMetadata.type.js";
+/**
+ * Options used to construct a Zudojs application error.
+ */
+export interface BaseErrorOptions {
+    readonly code?: ErrorCode | string;
+    readonly category?: ErrorCategory;
+    readonly severity?: ErrorSeverity;
+    readonly message?: string;
+    readonly metadata?: ErrorMetadata;
+    readonly cause?: unknown;
+    readonly statusCode?: number;
+    readonly expose?: boolean;
+    readonly isOperational?: boolean;
+}
+/**
+ * Serializable representation of a BaseError.
+ */
+export interface SerializedBaseError {
+    readonly name: string;
+    readonly message: string;
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly statusCode: number;
+    readonly expose: boolean;
+    readonly isOperational: boolean;
+    readonly metadata: Readonly<ErrorMetadata>;
+    readonly stack?: string;
+    readonly cause?: SerializedBaseError | unknown;
+}
+//# sourceMappingURL=baseError.type.d.ts.map

package/dist/base/types/baseError.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseError.type.d.ts","sourceRoot":"","sources":["../../../src/base/types/baseError.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,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,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;CAChD"}

package/dist/base/types/baseError.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=baseError.type.js.map

package/dist/base/types/baseError.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseError.type.js","sourceRoot":"","sources":["../../../src/base/types/baseError.type.ts"],"names":[],"mappings":""}

package/dist/base/types/errorCategory.enum.d.ts

@@ -0,0 +1,49 @@
+/**
+ * High-level categories used to classify errors across Zudojs.
+ *
+ * Categories describe where an error originated or what subsystem
+ * is primarily responsible for handling it.
+ */
+export declare enum ErrorCategory {
+    UNKNOWN = "unknown",
+    VALIDATION = "validation",
+    INPUT = "input",
+    AUTHENTICATION = "authentication",
+    AUTHORIZATION = "authorization",
+    PERMISSION = "permission",
+    RESOURCE = "resource",
+    CONFLICT = "conflict",
+    DATABASE = "database",
+    CACHE = "cache",
+    STORAGE = "storage",
+    NETWORK = "network",
+    EXTERNAL_SERVICE = "external_service",
+    CONFIGURATION = "configuration",
+    CRYPTOGRAPHY = "cryptography",
+    FILE_SYSTEM = "file_system",
+    RATE_LIMIT = "rate_limit",
+    TIMEOUT = "timeout",
+    BUSINESS = "business",
+    OPERATION = "operation",
+    SYSTEM = "system",
+    INTERNAL = "internal",
+    SERVICE = "service",
+    CONTAINER = "container",
+    MODULE = "module",
+    RUNTIME = "runtime",
+    EVENT = "event",
+    LOGGING = "logging",
+    MIDDLEWARE = "middleware",
+    CQRS = "cqrs",
+    MESSAGE = "message",
+    QUEUE = "queue",
+    JOB = "job",
+    WORKER = "worker",
+    API = "api",
+    RPC = "rpc",
+    SCHEDULER = "scheduler",
+    OPENAPI = "openapi",
+    PLUGIN = "plugin",
+    DOCUMENTATION = "documentation"
+}
+//# sourceMappingURL=errorCategory.enum.d.ts.map

package/dist/base/types/errorCategory.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCategory.enum.d.ts","sourceRoot":"","sources":["../../../src/base/types/errorCategory.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,OAAO,YAAY;IAEnB,UAAU,eAAe;IACzB,KAAK,UAAU;IAEf,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IAEzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IAErB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IAEnB,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IAErC,aAAa,kBAAkB;IAE/B,YAAY,iBAAiB;IAE7B,WAAW,gBAAgB;IAE3B,UAAU,eAAe;IAEzB,OAAO,YAAY;IAEnB,QAAQ,aAAa;IACrB,SAAS,cAAc;IAEvB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,aAAa,kBAAkB;CAChC"}

package/dist/base/types/errorCategory.enum.js

@@ -0,0 +1,50 @@
+/**
+ * High-level categories used to classify errors across Zudojs.
+ *
+ * Categories describe where an error originated or what subsystem
+ * is primarily responsible for handling it.
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["UNKNOWN"] = "unknown";
+    ErrorCategory["VALIDATION"] = "validation";
+    ErrorCategory["INPUT"] = "input";
+    ErrorCategory["AUTHENTICATION"] = "authentication";
+    ErrorCategory["AUTHORIZATION"] = "authorization";
+    ErrorCategory["PERMISSION"] = "permission";
+    ErrorCategory["RESOURCE"] = "resource";
+    ErrorCategory["CONFLICT"] = "conflict";
+    ErrorCategory["DATABASE"] = "database";
+    ErrorCategory["CACHE"] = "cache";
+    ErrorCategory["STORAGE"] = "storage";
+    ErrorCategory["NETWORK"] = "network";
+    ErrorCategory["EXTERNAL_SERVICE"] = "external_service";
+    ErrorCategory["CONFIGURATION"] = "configuration";
+    ErrorCategory["CRYPTOGRAPHY"] = "cryptography";
+    ErrorCategory["FILE_SYSTEM"] = "file_system";
+    ErrorCategory["RATE_LIMIT"] = "rate_limit";
+    ErrorCategory["TIMEOUT"] = "timeout";
+    ErrorCategory["BUSINESS"] = "business";
+    ErrorCategory["OPERATION"] = "operation";
+    ErrorCategory["SYSTEM"] = "system";
+    ErrorCategory["INTERNAL"] = "internal";
+    ErrorCategory["SERVICE"] = "service";
+    ErrorCategory["CONTAINER"] = "container";
+    ErrorCategory["MODULE"] = "module";
+    ErrorCategory["RUNTIME"] = "runtime";
+    ErrorCategory["EVENT"] = "event";
+    ErrorCategory["LOGGING"] = "logging";
+    ErrorCategory["MIDDLEWARE"] = "middleware";
+    ErrorCategory["CQRS"] = "cqrs";
+    ErrorCategory["MESSAGE"] = "message";
+    ErrorCategory["QUEUE"] = "queue";
+    ErrorCategory["JOB"] = "job";
+    ErrorCategory["WORKER"] = "worker";
+    ErrorCategory["API"] = "api";
+    ErrorCategory["RPC"] = "rpc";
+    ErrorCategory["SCHEDULER"] = "scheduler";
+    ErrorCategory["OPENAPI"] = "openapi";
+    ErrorCategory["PLUGIN"] = "plugin";
+    ErrorCategory["DOCUMENTATION"] = "documentation";
+})(ErrorCategory || (ErrorCategory = {}));
+//# sourceMappingURL=errorCategory.enum.js.map

package/dist/base/types/errorCategory.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCategory.enum.js","sourceRoot":"","sources":["../../../src/base/types/errorCategory.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aAqDX;AArDD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IAEnB,0CAAyB,CAAA;IACzB,gCAAe,CAAA;IAEf,kDAAiC,CAAA;IACjC,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;IAEzB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IAErB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IAEnB,oCAAmB,CAAA;IACnB,sDAAqC,CAAA;IAErC,gDAA+B,CAAA;IAE/B,8CAA6B,CAAA;IAE7B,4CAA2B,CAAA;IAE3B,0CAAyB,CAAA;IAEzB,oCAAmB,CAAA;IAEnB,sCAAqB,CAAA;IACrB,wCAAuB,CAAA;IAEvB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,0CAAyB,CAAA;IACzB,8BAAa,CAAA;IACb,oCAAmB,CAAA;IACnB,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;IACjB,gDAA+B,CAAA;AACjC,CAAC,EArDW,aAAa,KAAb,aAAa,QAqDxB"}

package/dist/base/types/errorCategory.helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error category helper functions.
+ */
+import { ErrorCategory } from "./errorCategory.enum.js";
+/** Determines whether a value is a valid error category. */
+export declare function isErrorCategory(value: unknown): value is ErrorCategory;
+/** Converts an unknown value into a valid error category. */
+export declare function normalizeErrorCategory(value: unknown, fallback?: ErrorCategory): ErrorCategory;
+/** Returns whether the category represents a client-side problem. */
+export declare function isClientErrorCategory(category: ErrorCategory): boolean;
+/** Returns whether the category represents an infrastructure problem. */
+export declare function isInfrastructureErrorCategory(category: ErrorCategory): boolean;
+/** Returns whether the category is related to security. */
+export declare function isSecurityErrorCategory(category: ErrorCategory): boolean;
+/** Returns whether the category is normally safe to expose directly to an API consumer. */
+export declare function isPublicErrorCategory(category: ErrorCategory): boolean;
+//# sourceMappingURL=errorCategory.helpers.d.ts.map

package/dist/base/types/errorCategory.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCategory.helpers.d.ts","sourceRoot":"","sources":["../../../src/base/types/errorCategory.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAKtE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,aAAqC,GAC9C,aAAa,CAGf;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAetE;AAED,yEAAyE;AACzE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAeT;AAED,2DAA2D;AAC3D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAUxE;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAgBtE"}

package/dist/base/types/errorCategory.helpers.js

@@ -0,0 +1,80 @@
+/**
+ * Error category helper functions.
+ */
+import { ErrorCategory } from "./errorCategory.enum.js";
+/** Determines whether a value is a valid error category. */
+export function isErrorCategory(value) {
+    return (typeof value === "string" &&
+        Object.values(ErrorCategory).includes(value));
+}
+/** Converts an unknown value into a valid error category. */
+export function normalizeErrorCategory(value, fallback = ErrorCategory.UNKNOWN) {
+    if (isErrorCategory(value))
+        return value;
+    return fallback;
+}
+/** Returns whether the category represents a client-side problem. */
+export function isClientErrorCategory(category) {
+    switch (category) {
+        case ErrorCategory.VALIDATION:
+        case ErrorCategory.INPUT:
+        case ErrorCategory.AUTHENTICATION:
+        case ErrorCategory.AUTHORIZATION:
+        case ErrorCategory.PERMISSION:
+        case ErrorCategory.RESOURCE:
+        case ErrorCategory.CONFLICT:
+        case ErrorCategory.RATE_LIMIT:
+        case ErrorCategory.TIMEOUT:
+            return true;
+        default:
+            return false;
+    }
+}
+/** Returns whether the category represents an infrastructure problem. */
+export function isInfrastructureErrorCategory(category) {
+    switch (category) {
+        case ErrorCategory.DATABASE:
+        case ErrorCategory.CACHE:
+        case ErrorCategory.STORAGE:
+        case ErrorCategory.NETWORK:
+        case ErrorCategory.EXTERNAL_SERVICE:
+        case ErrorCategory.FILE_SYSTEM:
+        case ErrorCategory.CONFIGURATION:
+        case ErrorCategory.SYSTEM:
+        case ErrorCategory.INTERNAL:
+            return true;
+        default:
+            return false;
+    }
+}
+/** Returns whether the category is related to security. */
+export function isSecurityErrorCategory(category) {
+    switch (category) {
+        case ErrorCategory.AUTHENTICATION:
+        case ErrorCategory.AUTHORIZATION:
+        case ErrorCategory.PERMISSION:
+        case ErrorCategory.CRYPTOGRAPHY:
+            return true;
+        default:
+            return false;
+    }
+}
+/** Returns whether the category is normally safe to expose directly to an API consumer. */
+export function isPublicErrorCategory(category) {
+    switch (category) {
+        case ErrorCategory.VALIDATION:
+        case ErrorCategory.INPUT:
+        case ErrorCategory.AUTHENTICATION:
+        case ErrorCategory.AUTHORIZATION:
+        case ErrorCategory.PERMISSION:
+        case ErrorCategory.RESOURCE:
+        case ErrorCategory.CONFLICT:
+        case ErrorCategory.RATE_LIMIT:
+        case ErrorCategory.TIMEOUT:
+        case ErrorCategory.BUSINESS:
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=errorCategory.helpers.js.map

package/dist/base/types/errorCategory.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCategory.helpers.js","sourceRoot":"","sources":["../../../src/base/types/errorCategory.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,QAAQ,GAAkB,aAAa,CAAC,OAAO;IAE/C,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,QAAuB;IAC3D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,KAAK,CAAC;QACzB,KAAK,aAAa,CAAC,cAAc,CAAC;QAClC,KAAK,aAAa,CAAC,aAAa,CAAC;QACjC,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,QAAQ,CAAC;QAC5B,KAAK,aAAa,CAAC,QAAQ,CAAC;QAC5B,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,OAAO;YACxB,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,6BAA6B,CAC3C,QAAuB;IAEvB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC,QAAQ,CAAC;QAC5B,KAAK,aAAa,CAAC,KAAK,CAAC;QACzB,KAAK,aAAa,CAAC,OAAO,CAAC;QAC3B,KAAK,aAAa,CAAC,OAAO,CAAC;QAC3B,KAAK,aAAa,CAAC,gBAAgB,CAAC;QACpC,KAAK,aAAa,CAAC,WAAW,CAAC;QAC/B,KAAK,aAAa,CAAC,aAAa,CAAC;QACjC,KAAK,aAAa,CAAC,MAAM,CAAC;QAC1B,KAAK,aAAa,CAAC,QAAQ;YACzB,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,uBAAuB,CAAC,QAAuB;IAC7D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC,cAAc,CAAC;QAClC,KAAK,aAAa,CAAC,aAAa,CAAC;QACjC,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,YAAY;YAC7B,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,QAAuB;IAC3D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,KAAK,CAAC;QACzB,KAAK,aAAa,CAAC,cAAc,CAAC;QAClC,KAAK,aAAa,CAAC,aAAa,CAAC;QACjC,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,QAAQ,CAAC;QAC5B,KAAK,aAAa,CAAC,QAAQ,CAAC;QAC5B,KAAK,aAAa,CAAC,UAAU,CAAC;QAC9B,KAAK,aAAa,CAAC,OAAO,CAAC;QAC3B,KAAK,aAAa,CAAC,QAAQ;YACzB,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/base/types/errorCategory.type.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Error category types — re-exported from split modules.
+ */
+export * from "./errorCategory.enum.js";
+export * from "./errorCategory.helpers.js";
+//# sourceMappingURL=errorCategory.type.d.ts.map

package/dist/base/types/errorCategory.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCategory.type.d.ts","sourceRoot":"","sources":["../../../src/base/types/errorCategory.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/dist/base/types/errorCategory.type.js

@@ -0,0 +1,6 @@
+/**
+ * Error category types — re-exported from split modules.
+ */
+export * from "./errorCategory.enum.js";
+export * from "./errorCategory.helpers.js";
+//# sourceMappingURL=errorCategory.type.js.map

package/dist/base/types/errorCategory.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCategory.type.js","sourceRoot":"","sources":["../../../src/base/types/errorCategory.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}