@zudojs/errors 0.0.1

package/dist/infrastructure/storage/databaseError.base.js

@@ -0,0 +1,69 @@
+/**
+ * Base DatabaseError class, options, and factory functions.
+ */
+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";
+/** Database operation types used for diagnostics. */
+export var DatabaseOperation;
+(function (DatabaseOperation) {
+    DatabaseOperation["UNKNOWN"] = "unknown";
+    DatabaseOperation["CONNECT"] = "connect";
+    DatabaseOperation["DISCONNECT"] = "disconnect";
+    DatabaseOperation["QUERY"] = "query";
+    DatabaseOperation["INSERT"] = "insert";
+    DatabaseOperation["UPDATE"] = "update";
+    DatabaseOperation["DELETE"] = "delete";
+    DatabaseOperation["TRANSACTION"] = "transaction";
+    DatabaseOperation["MIGRATION"] = "migration";
+})(DatabaseOperation || (DatabaseOperation = {}));
+/** Error raised by a database or persistence operation. */
+export class DatabaseError extends BaseError {
+    operation;
+    driver;
+    databaseCode;
+    constructor(message = "A database operation failed.", options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.DATABASE,
+            category: options.category ?? ErrorCategory.DATABASE,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+            isOperational: options.isOperational ?? true,
+            metadata: {
+                ...options.metadata,
+                ...(options.operation !== undefined
+                    ? { operation: options.operation }
+                    : {}),
+                ...(options.driver !== undefined ? { driver: options.driver } : {}),
+                ...(options.databaseCode !== undefined
+                    ? { databaseCode: String(options.databaseCode) }
+                    : {}),
+            },
+        });
+        this.operation = options.operation ?? DatabaseOperation.UNKNOWN;
+        this.driver = options.driver;
+        this.databaseCode = options.databaseCode;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            ...(this.driver !== undefined ? { driver: this.driver } : {}),
+            ...(this.databaseCode !== undefined
+                ? { databaseCode: String(this.databaseCode) }
+                : {}),
+        };
+    }
+}
+/** Creates a database error. */
+export function createDatabaseError(message = "A database operation failed.", options = {}) {
+    return new DatabaseError(message, options);
+}
+/** Determines whether an unknown value is a DatabaseError. */
+export function isDatabaseError(value) {
+    return value instanceof DatabaseError;
+}
+//# sourceMappingURL=databaseError.base.js.map

package/dist/infrastructure/storage/databaseError.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseError.base.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/databaseError.base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,qDAAqD;AACrD,MAAM,CAAN,IAAY,iBAUX;AAVD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;IACnB,8CAAyB,CAAA;IACzB,oCAAe,CAAA;IACf,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;IACjB,gDAA2B,CAAA;IAC3B,4CAAuB,CAAA;AACzB,CAAC,EAVW,iBAAiB,KAAjB,iBAAiB,QAU5B;AAaD,2DAA2D;AAC3D,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,SAAS,CAAoB;IAC7B,MAAM,CAAU;IAChB,YAAY,CAAmB;IAE/C,YACE,OAAO,GAAG,8BAA8B,EACxC,OAAO,GAAyB,EAAE;QAElC,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ;YACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;YACpD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK;YACjD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;YAC5C,QAAQ,EAAE;gBACR,GAAG,OAAO,CAAC,QAAQ;gBACnB,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;oBACpC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;oBAChD,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;CACF;AAED,gCAAgC;AAChC,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAAG,8BAA8B,EACxC,OAAO,GAAyB,EAAE;IAElC,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC"}

package/dist/infrastructure/storage/databaseError.factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Database error factory functions.
+ */
+import { DatabaseError, type DatabaseErrorOptions } from "./databaseError.base.js";
+/** Creates a database connection error. */
+export declare function databaseConnectionError(message?: string, options?: Omit<DatabaseErrorOptions, "operation">): DatabaseError;
+/** Creates a database query error. */
+export declare function databaseQueryError(message?: string, options?: Omit<DatabaseErrorOptions, "operation">): DatabaseError;
+/** Creates a database transaction error. */
+export declare function databaseTransactionError(message?: string, options?: Omit<DatabaseErrorOptions, "operation">): DatabaseError;
+/** Creates a database migration error. */
+export declare function databaseMigrationError(message?: string, options?: Omit<DatabaseErrorOptions, "operation">): DatabaseError;
+//# sourceMappingURL=databaseError.factory.d.ts.map

package/dist/infrastructure/storage/databaseError.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseError.factory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/databaseError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,aAAa,EAEb,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,2CAA2C;AAC3C,wBAAgB,uBAAuB,CACrC,OAAO,SAAuC,EAC9C,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAM,GACpD,aAAa,CAMf;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,OAAO,SAA+B,EACtC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAM,GACpD,aAAa,CAMf;AAED,4CAA4C;AAC5C,wBAAgB,wBAAwB,CACtC,OAAO,SAAqC,EAC5C,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAM,GACpD,aAAa,CAMf;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,CACpC,OAAO,SAAmC,EAC1C,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAM,GACpD,aAAa,CAMf"}

package/dist/infrastructure/storage/databaseError.factory.js

@@ -0,0 +1,38 @@
+/**
+ * Database error factory functions.
+ */
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { DatabaseError, DatabaseOperation, } from "./databaseError.base.js";
+/** Creates a database connection error. */
+export function databaseConnectionError(message = "Unable to connect to the database.", options = {}) {
+    return new DatabaseError(message, {
+        ...options,
+        code: ErrorCode.DATABASE_CONNECTION,
+        operation: DatabaseOperation.CONNECT,
+    });
+}
+/** Creates a database query error. */
+export function databaseQueryError(message = "The database query failed.", options = {}) {
+    return new DatabaseError(message, {
+        ...options,
+        code: ErrorCode.DATABASE_QUERY,
+        operation: DatabaseOperation.QUERY,
+    });
+}
+/** Creates a database transaction error. */
+export function databaseTransactionError(message = "The database transaction failed.", options = {}) {
+    return new DatabaseError(message, {
+        ...options,
+        code: ErrorCode.DATABASE_TRANSACTION,
+        operation: DatabaseOperation.TRANSACTION,
+    });
+}
+/** Creates a database migration error. */
+export function databaseMigrationError(message = "The database migration failed.", options = {}) {
+    return new DatabaseError(message, {
+        ...options,
+        code: ErrorCode.DATABASE,
+        operation: DatabaseOperation.MIGRATION,
+    });
+}
+//# sourceMappingURL=databaseError.factory.js.map

package/dist/infrastructure/storage/databaseError.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseError.factory.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/databaseError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EACL,aAAa,EACb,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AAEjC,2CAA2C;AAC3C,MAAM,UAAU,uBAAuB,CACrC,OAAO,GAAG,oCAAoC,EAC9C,OAAO,GAA4C,EAAE;IAErD,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE;QAChC,GAAG,OAAO;QACV,IAAI,EAAE,SAAS,CAAC,mBAAmB;QACnC,SAAS,EAAE,iBAAiB,CAAC,OAAO;KACrC,CAAC,CAAC;AACL,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAChC,OAAO,GAAG,4BAA4B,EACtC,OAAO,GAA4C,EAAE;IAErD,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE;QAChC,GAAG,OAAO;QACV,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,SAAS,EAAE,iBAAiB,CAAC,KAAK;KACnC,CAAC,CAAC;AACL,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,wBAAwB,CACtC,OAAO,GAAG,kCAAkC,EAC5C,OAAO,GAA4C,EAAE;IAErD,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE;QAChC,GAAG,OAAO;QACV,IAAI,EAAE,SAAS,CAAC,oBAAoB;QACpC,SAAS,EAAE,iBAAiB,CAAC,WAAW;KACzC,CAAC,CAAC;AACL,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,sBAAsB,CACpC,OAAO,GAAG,gCAAgC,EAC1C,OAAO,GAA4C,EAAE;IAErD,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE;QAChC,GAAG,OAAO;QACV,IAAI,EAAE,SAAS,CAAC,QAAQ;QACxB,SAAS,EAAE,iBAAiB,CAAC,SAAS;KACvC,CAAC,CAAC;AACL,CAAC"}

package/dist/infrastructure/storage/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/errors/infrastructure/storage
+ *
+ * Database and storage error types.
+ */
+export * from "./database.error.js";
+export * from "./storage.error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/storage/index.d.ts.map

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

package/dist/infrastructure/storage/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/errors/infrastructure/storage
+ *
+ * Database and storage error types.
+ */
+export * from "./database.error.js";
+export * from "./storage.error.js";
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/storage/index.js.map

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

package/dist/infrastructure/storage/storage.error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Storage error classes — re-exports from focused files.
+ */
+export { StorageError, createStorageError, isStorageError, StorageOperation, } from "./storageError.base.js";
+export type { StorageErrorOptions } from "./storageError.base.js";
+export { storageReadError, storageWriteError, storageUploadError, storageDownloadError, storageDeleteError, storageNotFoundError, } from "./storageError.factory.js";
+//# sourceMappingURL=storage.error.d.ts.map

package/dist/infrastructure/storage/storage.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.error.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/storage.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/storage/storage.error.js

@@ -0,0 +1,6 @@
+/**
+ * Storage error classes — re-exports from focused files.
+ */
+export { StorageError, createStorageError, isStorageError, StorageOperation, } from "./storageError.base.js";
+export { storageReadError, storageWriteError, storageUploadError, storageDownloadError, storageDeleteError, storageNotFoundError, } from "./storageError.factory.js";
+//# sourceMappingURL=storage.error.js.map

package/dist/infrastructure/storage/storage.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.error.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/storage.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/storage/storageError.base.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Base StorageError class and options.
+ */
+import { BaseError } from "../../base/core/baseError.core.js";
+import type { BaseErrorOptions } from "../../base/types/baseError.type.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+/** Storage operation types used for diagnostics. */
+export declare enum StorageOperation {
+    UNKNOWN = "unknown",
+    READ = "read",
+    WRITE = "write",
+    DELETE = "delete",
+    UPLOAD = "upload",
+    DOWNLOAD = "download",
+    MOVE = "move",
+    COPY = "copy",
+    LIST = "list",
+    EXISTS = "exists"
+}
+/** Options for creating a storage error. */
+export interface StorageErrorOptions extends Omit<BaseErrorOptions, "category"> {
+    readonly category?: ErrorCategory;
+    readonly operation?: StorageOperation;
+    readonly provider?: string;
+    readonly resource?: string;
+}
+/** Error raised when a storage operation fails. */
+export declare class StorageError extends BaseError {
+    readonly operation: StorageOperation;
+    readonly provider?: string;
+    readonly resource?: string;
+    constructor(message?: string, options?: StorageErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        category: ErrorCategory;
+        severity: ErrorSeverity;
+        statusCode: number;
+        expose: boolean;
+        isOperational: boolean;
+        metadata: Readonly<import("../../index.js").ErrorMetadata>;
+        stack?: string;
+        cause?: import("../../base/types/baseError.type.js").SerializedBaseError | unknown;
+        operation: StorageOperation;
+        provider?: string | undefined;
+        resource?: string | undefined;
+    };
+}
+/** Creates a storage error. */
+export declare function createStorageError(message?: string, options?: StorageErrorOptions): StorageError;
+/** Determines whether an unknown value is a StorageError. */
+export declare function isStorageError(value: unknown): value is StorageError;
+//# sourceMappingURL=storageError.base.d.ts.map

package/dist/infrastructure/storage/storageError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageError.base.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/storageError.base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,oDAAoD;AACpD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,gBAAgB,EAChB,UAAU,CACX;IACC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mDAAmD;AACnD,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,SAAS,EAAE,gBAAgB,CAAC;IAC5C,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,YACE,OAAO,SAAgC,EACvC,OAAO,GAAE,mBAAwB,EA0BlC;IAEe,MAAM;;;;;;;;;;;;;;;MAOrB;CACF;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAChC,OAAO,SAAgC,EACvC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAEd;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/infrastructure/storage/storageError.base.js

@@ -0,0 +1,70 @@
+/**
+ * Base StorageError class and options.
+ */
+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";
+/** Storage operation types used for diagnostics. */
+export var StorageOperation;
+(function (StorageOperation) {
+    StorageOperation["UNKNOWN"] = "unknown";
+    StorageOperation["READ"] = "read";
+    StorageOperation["WRITE"] = "write";
+    StorageOperation["DELETE"] = "delete";
+    StorageOperation["UPLOAD"] = "upload";
+    StorageOperation["DOWNLOAD"] = "download";
+    StorageOperation["MOVE"] = "move";
+    StorageOperation["COPY"] = "copy";
+    StorageOperation["LIST"] = "list";
+    StorageOperation["EXISTS"] = "exists";
+})(StorageOperation || (StorageOperation = {}));
+/** Error raised when a storage operation fails. */
+export class StorageError extends BaseError {
+    operation;
+    provider;
+    resource;
+    constructor(message = "A storage operation failed.", options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.STORAGE,
+            category: options.category ?? ErrorCategory.STORAGE,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+            isOperational: options.isOperational ?? true,
+            metadata: {
+                ...options.metadata,
+                ...(options.operation !== undefined
+                    ? { operation: options.operation }
+                    : {}),
+                ...(options.provider !== undefined
+                    ? { provider: options.provider }
+                    : {}),
+                ...(options.resource !== undefined
+                    ? { resource: options.resource }
+                    : {}),
+            },
+        });
+        this.operation = options.operation ?? StorageOperation.UNKNOWN;
+        this.provider = options.provider;
+        this.resource = options.resource;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            ...(this.provider !== undefined ? { provider: this.provider } : {}),
+            ...(this.resource !== undefined ? { resource: this.resource } : {}),
+        };
+    }
+}
+/** Creates a storage error. */
+export function createStorageError(message = "A storage operation failed.", options = {}) {
+    return new StorageError(message, options);
+}
+/** Determines whether an unknown value is a StorageError. */
+export function isStorageError(value) {
+    return value instanceof StorageError;
+}
+//# sourceMappingURL=storageError.base.js.map

package/dist/infrastructure/storage/storageError.base.js.map

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

package/dist/infrastructure/storage/storageError.factory.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Storage error factory functions.
+ */
+import { StorageError } from "./storageError.base.js";
+/** Creates a storage read error. */
+export declare function storageReadError(resource: string, provider?: string, cause?: unknown): StorageError;
+/** Creates a storage write error. */
+export declare function storageWriteError(resource: string, provider?: string, cause?: unknown): StorageError;
+/** Creates a storage upload error. */
+export declare function storageUploadError(resource: string, provider?: string, cause?: unknown): StorageError;
+/** Creates a storage download error. */
+export declare function storageDownloadError(resource: string, provider?: string, cause?: unknown): StorageError;
+/** Creates a storage delete error. */
+export declare function storageDeleteError(resource: string, provider?: string, cause?: unknown): StorageError;
+/** Creates a storage not found error. */
+export declare function storageNotFoundError(resource: string, provider?: string): StorageError;
+//# sourceMappingURL=storageError.factory.d.ts.map

package/dist/infrastructure/storage/storageError.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageError.factory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/storageError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EAGb,MAAM,wBAAwB,CAAC;AAEhC,oCAAoC;AACpC,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,GACd,YAAY,CAQd;AAED,qCAAqC;AACrC,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,GACd,YAAY,CAQd;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,GACd,YAAY,CAQd;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,GACd,YAAY,CAQd;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,GACd,YAAY,CAQd;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,CASd"}

package/dist/infrastructure/storage/storageError.factory.js

@@ -0,0 +1,67 @@
+/**
+ * Storage error factory functions.
+ */
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { StorageError, StorageOperation, } from "./storageError.base.js";
+/** Creates a storage read error. */
+export function storageReadError(resource, provider, cause) {
+    return new StorageError(`Failed to read "${resource}".`, {
+        code: ErrorCode.STORAGE_READ,
+        operation: StorageOperation.READ,
+        provider,
+        resource,
+        cause,
+    });
+}
+/** Creates a storage write error. */
+export function storageWriteError(resource, provider, cause) {
+    return new StorageError(`Failed to write "${resource}".`, {
+        code: ErrorCode.STORAGE_WRITE,
+        operation: StorageOperation.WRITE,
+        provider,
+        resource,
+        cause,
+    });
+}
+/** Creates a storage upload error. */
+export function storageUploadError(resource, provider, cause) {
+    return new StorageError(`Failed to upload "${resource}".`, {
+        code: ErrorCode.STORAGE_UPLOAD,
+        operation: StorageOperation.UPLOAD,
+        provider,
+        resource,
+        cause,
+    });
+}
+/** Creates a storage download error. */
+export function storageDownloadError(resource, provider, cause) {
+    return new StorageError(`Failed to download "${resource}".`, {
+        code: ErrorCode.STORAGE_DOWNLOAD,
+        operation: StorageOperation.DOWNLOAD,
+        provider,
+        resource,
+        cause,
+    });
+}
+/** Creates a storage delete error. */
+export function storageDeleteError(resource, provider, cause) {
+    return new StorageError(`Failed to delete "${resource}".`, {
+        code: ErrorCode.STORAGE_DELETE,
+        operation: StorageOperation.DELETE,
+        provider,
+        resource,
+        cause,
+    });
+}
+/** Creates a storage not found error. */
+export function storageNotFoundError(resource, provider) {
+    return new StorageError(`Resource "${resource}" was not found.`, {
+        code: ErrorCode.NOT_FOUND,
+        operation: StorageOperation.READ,
+        provider,
+        resource,
+        statusCode: 404,
+        expose: true,
+    });
+}
+//# sourceMappingURL=storageError.factory.js.map

package/dist/infrastructure/storage/storageError.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageError.factory.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/storageError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAEhC,oCAAoC;AACpC,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,QAAiB,EACjB,KAAe;IAEf,OAAO,IAAI,YAAY,CAAC,mBAAmB,QAAQ,IAAI,EAAE;QACvD,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,SAAS,EAAE,gBAAgB,CAAC,IAAI;QAChC,QAAQ;QACR,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,QAAiB,EACjB,KAAe;IAEf,OAAO,IAAI,YAAY,CAAC,oBAAoB,QAAQ,IAAI,EAAE;QACxD,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,SAAS,EAAE,gBAAgB,CAAC,KAAK;QACjC,QAAQ;QACR,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,QAAiB,EACjB,KAAe;IAEf,OAAO,IAAI,YAAY,CAAC,qBAAqB,QAAQ,IAAI,EAAE;QACzD,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,SAAS,EAAE,gBAAgB,CAAC,MAAM;QAClC,QAAQ;QACR,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,QAAiB,EACjB,KAAe;IAEf,OAAO,IAAI,YAAY,CAAC,uBAAuB,QAAQ,IAAI,EAAE;QAC3D,IAAI,EAAE,SAAS,CAAC,gBAAgB;QAChC,SAAS,EAAE,gBAAgB,CAAC,QAAQ;QACpC,QAAQ;QACR,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,QAAiB,EACjB,KAAe;IAEf,OAAO,IAAI,YAAY,CAAC,qBAAqB,QAAQ,IAAI,EAAE;QACzD,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,SAAS,EAAE,gBAAgB,CAAC,MAAM;QAClC,QAAQ;QACR,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,QAAiB;IAEjB,OAAO,IAAI,YAAY,CAAC,aAAa,QAAQ,kBAAkB,EAAE;QAC/D,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,SAAS,EAAE,gBAAgB,CAAC,IAAI;QAChC,QAAQ;QACR,QAAQ;QACR,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/system/crypto.error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Crypto error classes — re-exports from focused files.
+ */
+export { CryptoError, createCryptoError, isCryptoError, CryptoOperation, } from "./cryptoError.base.js";
+export type { CryptoErrorOptions } from "./cryptoError.base.js";
+export { cryptoHashError, cryptoCipherError, cryptoSignatureError, cryptoKeyDerivationError, cryptoKeyError, } from "./cryptoError.factory.js";
+//# sourceMappingURL=crypto.error.d.ts.map

package/dist/system/crypto.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.error.d.ts","sourceRoot":"","sources":["../../src/system/crypto.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,GACf,MAAM,0BAA0B,CAAC"}

package/dist/system/crypto.error.js

@@ -0,0 +1,6 @@
+/**
+ * Crypto error classes — re-exports from focused files.
+ */
+export { CryptoError, createCryptoError, isCryptoError, CryptoOperation, } from "./cryptoError.base.js";
+export { cryptoHashError, cryptoCipherError, cryptoSignatureError, cryptoKeyDerivationError, cryptoKeyError, } from "./cryptoError.factory.js";
+//# sourceMappingURL=crypto.error.js.map

package/dist/system/crypto.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.error.js","sourceRoot":"","sources":["../../src/system/crypto.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,GACf,MAAM,0BAA0B,CAAC"}

package/dist/system/cryptoError.base.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Base CryptoError class, options, and factory functions.
+ */
+import { BaseError } from "../base/core/baseError.core.js";
+import type { BaseErrorOptions } from "../base/types/baseError.type.js";
+import { ErrorCategory } from "../base/types/errorCategory.type.js";
+import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
+/** Cryptographic operation types used for diagnostics. */
+export declare enum CryptoOperation {
+    UNKNOWN = "unknown",
+    HASH = "hash",
+    VERIFY_HASH = "verify_hash",
+    ENCRYPT = "encrypt",
+    DECRYPT = "decrypt",
+    SIGN = "sign",
+    VERIFY_SIGNATURE = "verify_signature",
+    KEY_GENERATION = "key_generation",
+    KEY_DERIVATION = "key_derivation",
+    KEY_IMPORT = "key_import",
+    KEY_EXPORT = "key_export",
+    RANDOM = "random",
+    ENCODE = "encode",
+    DECODE = "decode"
+}
+/** Options for creating a cryptographic error. */
+export interface CryptoErrorOptions extends Omit<BaseErrorOptions, "category"> {
+    readonly category?: ErrorCategory;
+    readonly operation?: CryptoOperation;
+    readonly algorithm?: string;
+}
+/** Error raised when a cryptographic operation fails. */
+export declare class CryptoError extends BaseError {
+    readonly operation: CryptoOperation;
+    readonly algorithm?: string;
+    constructor(message?: string, options?: CryptoErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        category: ErrorCategory;
+        severity: ErrorSeverity;
+        statusCode: number;
+        expose: boolean;
+        isOperational: boolean;
+        metadata: Readonly<import("../index.js").ErrorMetadata>;
+        stack?: string;
+        cause?: import("../base/types/baseError.type.js").SerializedBaseError | unknown;
+        operation: CryptoOperation;
+        algorithm?: string | undefined;
+    };
+}
+/** Creates a cryptographic error. */
+export declare function createCryptoError(message?: string, options?: CryptoErrorOptions): CryptoError;
+/** Determines whether an unknown value is a CryptoError. */
+export declare function isCryptoError(value: unknown): value is CryptoError;
+//# sourceMappingURL=cryptoError.base.d.ts.map

package/dist/system/cryptoError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoError.base.d.ts","sourceRoot":"","sources":["../../src/system/cryptoError.base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,0DAA0D;AAC1D,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,yDAAyD;AACzD,qBAAa,WAAY,SAAQ,SAAS;IACxC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnC,YACE,OAAO,SAAsC,EAC7C,OAAO,GAAE,kBAAuB,EAsBjC;IAEe,MAAM;;;;;;;;;;;;;;MAMrB;CACF;AAED,qCAAqC;AACrC,wBAAgB,iBAAiB,CAC/B,OAAO,SAAsC,EAC7C,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAEb;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}

package/dist/system/cryptoError.base.js

@@ -0,0 +1,68 @@
+/**
+ * Base CryptoError class, options, and factory functions.
+ */
+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";
+/** Cryptographic operation types used for diagnostics. */
+export var CryptoOperation;
+(function (CryptoOperation) {
+    CryptoOperation["UNKNOWN"] = "unknown";
+    CryptoOperation["HASH"] = "hash";
+    CryptoOperation["VERIFY_HASH"] = "verify_hash";
+    CryptoOperation["ENCRYPT"] = "encrypt";
+    CryptoOperation["DECRYPT"] = "decrypt";
+    CryptoOperation["SIGN"] = "sign";
+    CryptoOperation["VERIFY_SIGNATURE"] = "verify_signature";
+    CryptoOperation["KEY_GENERATION"] = "key_generation";
+    CryptoOperation["KEY_DERIVATION"] = "key_derivation";
+    CryptoOperation["KEY_IMPORT"] = "key_import";
+    CryptoOperation["KEY_EXPORT"] = "key_export";
+    CryptoOperation["RANDOM"] = "random";
+    CryptoOperation["ENCODE"] = "encode";
+    CryptoOperation["DECODE"] = "decode";
+})(CryptoOperation || (CryptoOperation = {}));
+/** Error raised when a cryptographic operation fails. */
+export class CryptoError extends BaseError {
+    operation;
+    algorithm;
+    constructor(message = "A cryptographic operation failed.", options = {}) {
+        super(message, {
+            ...options,
+            code: options.code ?? ErrorCode.CRYPTO,
+            category: options.category ?? ErrorCategory.CRYPTOGRAPHY,
+            severity: options.severity ?? ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? 500,
+            expose: options.expose ?? false,
+            isOperational: options.isOperational ?? true,
+            metadata: {
+                ...options.metadata,
+                ...(options.operation !== undefined
+                    ? { operation: options.operation }
+                    : {}),
+                ...(options.algorithm !== undefined
+                    ? { algorithm: options.algorithm }
+                    : {}),
+            },
+        });
+        this.operation = options.operation ?? CryptoOperation.UNKNOWN;
+        this.algorithm = options.algorithm;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            ...(this.algorithm !== undefined ? { algorithm: this.algorithm } : {}),
+        };
+    }
+}
+/** Creates a cryptographic error. */
+export function createCryptoError(message = "A cryptographic operation failed.", options = {}) {
+    return new CryptoError(message, options);
+}
+/** Determines whether an unknown value is a CryptoError. */
+export function isCryptoError(value) {
+    return value instanceof CryptoError;
+}
+//# sourceMappingURL=cryptoError.base.js.map

package/dist/system/cryptoError.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoError.base.js","sourceRoot":"","sources":["../../src/system/cryptoError.base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,0DAA0D;AAC1D,MAAM,CAAN,IAAY,eAeX;AAfD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,8CAA2B,CAAA;IAC3B,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,wDAAqC,CAAA;IACrC,oDAAiC,CAAA;IACjC,oDAAiC,CAAA;IACjC,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;AACnB,CAAC,EAfW,eAAe,KAAf,eAAe,QAe1B;AASD,yDAAyD;AACzD,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxB,SAAS,CAAkB;IAC3B,SAAS,CAAU;IAEnC,YACE,OAAO,GAAG,mCAAmC,EAC7C,OAAO,GAAuB,EAAE;QAEhC,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,MAAM;YACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,YAAY;YACxD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK;YACjD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;YAC5C,QAAQ,EAAE;gBACR,GAAG,OAAO,CAAC,QAAQ;gBACnB,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;oBAClC,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC;QAC9D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC;IACJ,CAAC;CACF;AAED,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAC/B,OAAO,GAAG,mCAAmC,EAC7C,OAAO,GAAuB,EAAE;IAEhC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC"}

package/dist/system/cryptoError.factory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Crypto error factory functions.
+ */
+import { CryptoError, CryptoOperation } from "./cryptoError.base.js";
+/** Creates a hashing error. */
+export declare function cryptoHashError(message?: string, algorithm?: string): CryptoError;
+/** Creates an encryption or cipher error. */
+export declare function cryptoCipherError(message?: string, operation?: CryptoOperation.ENCRYPT | CryptoOperation.DECRYPT, algorithm?: string): CryptoError;
+/** Creates a cryptographic signature error. */
+export declare function cryptoSignatureError(message?: string, operation?: CryptoOperation.SIGN | CryptoOperation.VERIFY_SIGNATURE, algorithm?: string): CryptoError;
+/** Creates a key derivation error. */
+export declare function cryptoKeyDerivationError(message?: string, algorithm?: string): CryptoError;
+/** Creates a cryptographic key error. */
+export declare function cryptoKeyError(message?: string, operation?: CryptoOperation.KEY_GENERATION | CryptoOperation.KEY_IMPORT | CryptoOperation.KEY_EXPORT, algorithm?: string): CryptoError;
+//# sourceMappingURL=cryptoError.factory.d.ts.map

package/dist/system/cryptoError.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoError.factory.d.ts","sourceRoot":"","sources":["../../src/system/cryptoError.factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAErE,+BAA+B;AAC/B,wBAAgB,eAAe,CAC7B,OAAO,SAAkC,EACzC,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAC/B,OAAO,SAAmD,EAC1D,SAAS,GACP,eAAe,CAAC,OAAO,GAAG,eAAe,CAAC,OAAiC,EAC7E,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAClC,OAAO,SAAiD,EACxD,SAAS,GACL,eAAe,CAAC,IAAI,GACpB,eAAe,CAAC,gBAAmD,EACvE,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,sCAAsC;AACtC,wBAAgB,wBAAwB,CACtC,OAAO,SAAyC,EAChD,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAMb;AAED,yCAAyC;AACzC,wBAAgB,cAAc,CAC5B,OAAO,SAAwC,EAC/C,SAAS,GACL,eAAe,CAAC,cAAc,GAC9B,eAAe,CAAC,UAAU,GAC1B,eAAe,CAAC,UAA2C,EAC/D,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAMb"}