@brightchain/brightchain-lib 0.1.4 → 0.1.6

package/src/lib/errors/checksumError.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Checksum-related error class for the BrightChain library.
+ *
+ * This error is thrown when checksum operations fail, such as:
+ * - Invalid checksum length
+ * - Invalid hex string format
+ * - Conversion failures between formats
+ * - Comparison failures
+ *
+ * @example
+ * ```typescript
+ * import { ChecksumError, ChecksumErrorType } from './checksumError';
+ *
+ * // Throwing a checksum error
+ * throw new ChecksumError(
+ *   ChecksumErrorType.InvalidLength,
+ *   'Checksum must be 64 bytes',
+ *   { actualLength: 32, expectedLength: 64 }
+ * );
+ *
+ * // Catching and handling checksum errors
+ * try {
+ *   const checksum = Checksum.fromHex(invalidHex);
+ * } catch (error) {
+ *   if (isChecksumError(error)) {
+ *     console.error(`Checksum error (${error.checksumErrorType}): ${error.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirements 1.7, 4.1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChecksumError = exports.ChecksumErrorType = void 0;
+exports.isChecksumError = isChecksumError;
+const brightChainError_1 = require("./brightChainError");
+/**
+ * Enumeration of checksum error types.
+ *
+ * @remarks
+ * This enum categorizes the different types of checksum-related errors
+ * that can occur during checksum operations.
+ */
+var ChecksumErrorType;
+(function (ChecksumErrorType) {
+    /** The checksum data has an invalid length */
+    ChecksumErrorType["InvalidLength"] = "InvalidLength";
+    /** The hex string contains invalid characters */
+    ChecksumErrorType["InvalidHex"] = "InvalidHex";
+    /** Conversion between formats (Buffer, Uint8Array, hex) failed */
+    ChecksumErrorType["ConversionFailed"] = "ConversionFailed";
+    /** Comparison between checksums failed unexpectedly */
+    ChecksumErrorType["ComparisonFailed"] = "ComparisonFailed";
+})(ChecksumErrorType || (exports.ChecksumErrorType = ChecksumErrorType = {}));
+/**
+ * Error class for checksum-related errors.
+ *
+ * Extends BrightChainError to provide consistent error handling
+ * with additional checksum-specific error type information.
+ *
+ * @remarks
+ * - The `checksumErrorType` property identifies the specific type of checksum error
+ * - The `context` property can include additional details like actual/expected values
+ * - Use the `isChecksumError` type guard for type-safe error handling
+ *
+ * @see Requirements 1.7, 4.1
+ */
+class ChecksumError extends brightChainError_1.BrightChainError {
+    /**
+     * Creates a new ChecksumError instance.
+     *
+     * @param checksumErrorType - The specific type of checksum error
+     * @param message - Human-readable error message
+     * @param context - Optional additional context for debugging
+     *
+     * @example
+     * ```typescript
+     * // Invalid length error
+     * throw new ChecksumError(
+     *   ChecksumErrorType.InvalidLength,
+     *   `Checksum must be 64 bytes, got 32 bytes`,
+     *   { actualLength: 32, expectedLength: 64 }
+     * );
+     *
+     * // Invalid hex error
+     * throw new ChecksumError(
+     *   ChecksumErrorType.InvalidHex,
+     *   'Invalid hex string: contains non-hexadecimal characters',
+     *   { input: 'xyz123' }
+     * );
+     * ```
+     */
+    constructor(checksumErrorType, message, context) {
+        super('Checksum', message, { checksumErrorType, ...context });
+        this.checksumErrorType = checksumErrorType;
+    }
+}
+exports.ChecksumError = ChecksumError;
+/**
+ * Type guard to check if a value is a ChecksumError instance.
+ *
+ * @param error - The value to check
+ * @returns true if the value is a ChecksumError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const checksum = Checksum.fromHex(hexString);
+ * } catch (error) {
+ *   if (isChecksumError(error)) {
+ *     // error is narrowed to ChecksumError type
+ *     switch (error.checksumErrorType) {
+ *       case ChecksumErrorType.InvalidLength:
+ *         console.error('Invalid checksum length');
+ *         break;
+ *       case ChecksumErrorType.InvalidHex:
+ *         console.error('Invalid hex format');
+ *         break;
+ *       default:
+ *         console.error('Checksum error:', error.message);
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirement 14.4
+ */
+function isChecksumError(error) {
+    return error instanceof ChecksumError;
+}
+//# sourceMappingURL=checksumError.js.map

package/src/lib/errors/checksumError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksumError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/checksumError.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAqGH,0CAEC;AArGD,yDAAsD;AAEtD;;;;;;GAMG;AACH,IAAY,iBAYX;AAZD,WAAY,iBAAiB;IAC3B,8CAA8C;IAC9C,oDAA+B,CAAA;IAE/B,iDAAiD;IACjD,8CAAyB,CAAA;IAEzB,kEAAkE;IAClE,0DAAqC,CAAA;IAErC,uDAAuD;IACvD,0DAAqC,CAAA;AACvC,CAAC,EAZW,iBAAiB,iCAAjB,iBAAiB,QAY5B;AAED;;;;;;;;;;;;GAYG;AACH,MAAa,aAAc,SAAQ,mCAAgB;IACjD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YACkB,iBAAoC,EACpD,OAAe,EACf,OAAiC;QAEjC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAJ9C,sBAAiB,GAAjB,iBAAiB,CAAmB;IAKtD,CAAC;CACF;AAhCD,sCAgCC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC"}

package/src/lib/errors/checksumMismatch.d.ts

@@ -1,8 +1,7 @@
-import { ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
-import { StringLanguages } from '../enumerations/stringLanguages';
+import { Checksum } from '../types/checksum';
 export declare class ChecksumMismatchError extends Error {
-    readonly checksum: ChecksumUint8Array;
-    readonly expected: ChecksumUint8Array;
-    constructor(checksum: ChecksumUint8Array, expected: ChecksumUint8Array, _language?: StringLanguages);
+    readonly checksum: Checksum;
+    readonly expected: Checksum;
+    constructor(checksum: Checksum, expected: Checksum, _language?: string);
 }
 //# sourceMappingURL=checksumMismatch.d.ts.map

package/src/lib/errors/checksumMismatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checksumMismatch.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/checksumMismatch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAEnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIlE,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,QAAQ,EAAE,kBAAkB,CAAC;IAC7C,SAAgB,QAAQ,EAAE,kBAAkB,CAAC;gBAE3C,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,CAAC,EAAE,eAAe;CAa9B"}
+{"version":3,"file":"checksumMismatch.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/checksumMismatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;gBACvB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM;CAYvE"}

package/src/lib/errors/checksumMismatch.js

@@ -1,14 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChecksumMismatchError = void 0;
-const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
 const stringNames_1 = require("../enumerations/stringNames");
 const i18n_1 = require("../i18n");
 class ChecksumMismatchError extends Error {
     constructor(checksum, expected, _language) {
         super((0, i18n_1.translate)(stringNames_1.StringNames.Error_ChecksumMismatchTemplate, {
-            EXPECTED: (0, ecies_lib_1.uint8ArrayToHex)(expected),
-            CHECKSUM: (0, ecies_lib_1.uint8ArrayToHex)(checksum),
+            EXPECTED: expected.toHex(),
+            CHECKSUM: checksum.toHex(),
         }));
         this.name = 'ChecksumMismatchError';
         Object.setPrototypeOf(this, ChecksumMismatchError.prototype);

package/src/lib/errors/checksumMismatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"checksumMismatch.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/checksumMismatch.ts"],"names":[],"mappings":";;;AAAA,0DAGoC;AAEpC,6DAA0D;AAC1D,kCAAoC;AAEpC,MAAa,qBAAsB,SAAQ,KAAK;IAG9C,YACE,QAA4B,EAC5B,QAA4B,EAC5B,SAA2B;QAE3B,KAAK,CACH,IAAA,gBAAS,EAAC,yBAAW,CAAC,8BAA8B,EAAE;YACpD,QAAQ,EAAE,IAAA,2BAAe,EAAC,QAAQ,CAAC;YACnC,QAAQ,EAAE,IAAA,2BAAe,EAAC,QAAQ,CAAC;SACpC,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAnBD,sDAmBC"}
+{"version":3,"file":"checksumMismatch.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/checksumMismatch.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAC1D,kCAAoC;AAGpC,MAAa,qBAAsB,SAAQ,KAAK;IAG9C,YAAY,QAAkB,EAAE,QAAkB,EAAE,SAAkB;QACpE,KAAK,CACH,IAAA,gBAAS,EAAC,yBAAW,CAAC,8BAA8B,EAAE;YACpD,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE;YAC1B,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE;SAC3B,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAfD,sDAeC"}

package/src/lib/errors/document.d.ts

@@ -1,9 +1,8 @@
 import { DocumentErrorType } from '../enumerations/documentErrorType';
-import { StringLanguages } from '../enumerations/stringLanguages';
 import StringNames from '../enumerations/stringNames';
 import { TypedError } from './typedError';
 export declare class DocumentError extends TypedError<DocumentErrorType> {
     get reasonMap(): Record<DocumentErrorType, StringNames>;
-    constructor(type: DocumentErrorType, otherVars?: Record<string, string | number>, _language?: StringLanguages);
+    constructor(type: DocumentErrorType, otherVars?: Record<string, string | number>, _language?: string);
 }
 //# sourceMappingURL=document.d.ts.map

package/src/lib/errors/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,aAAc,SAAQ,UAAU,CAAC,iBAAiB,CAAC;IAC9D,IAAW,SAAS,IAAI,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAW7D;gBAEC,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,SAAS,CAAC,EAAE,eAAe;CAK9B"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,aAAc,SAAQ,UAAU,CAAC,iBAAiB,CAAC;IAC9D,IAAW,SAAS,IAAI,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAW7D;gBAEC,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3C,SAAS,CAAC,EAAE,MAAM;CAKrB"}

package/src/lib/errors/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/document.ts"],"names":[],"mappings":";;;AAAA,yEAAsE;AAEtE,6DAAsD;AACtD,6CAA0C;AAE1C,MAAa,aAAc,SAAQ,uBAA6B;IAC9D,IAAW,SAAS;QAClB,OAAO;YACL,CAAC,qCAAiB,CAAC,aAAa,CAAC,EAC/B,qBAAW,CAAC,wCAAwC;YACtD,CAAC,qCAAiB,CAAC,YAAY,CAAC,EAC9B,qBAAW,CAAC,uCAAuC;YACrD,CAAC,qCAAiB,CAAC,kBAAkB,CAAC,EACpC,qBAAW,CAAC,qCAAqC;YACnD,CAAC,qCAAiB,CAAC,aAAa,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;SAC/C,CAAC;IACJ,CAAC;IACD,YACE,IAAuB,EACvB,SAA2C,EAC3C,SAA2B;QAE3B,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AArBD,sCAqBC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/document.ts"],"names":[],"mappings":";;;AAAA,yEAAsE;AACtE,6DAAsD;AACtD,6CAA0C;AAE1C,MAAa,aAAc,SAAQ,uBAA6B;IAC9D,IAAW,SAAS;QAClB,OAAO;YACL,CAAC,qCAAiB,CAAC,aAAa,CAAC,EAC/B,qBAAW,CAAC,wCAAwC;YACtD,CAAC,qCAAiB,CAAC,YAAY,CAAC,EAC9B,qBAAW,CAAC,uCAAuC;YACrD,CAAC,qCAAiB,CAAC,kBAAkB,CAAC,EACpC,qBAAW,CAAC,qCAAqC;YACnD,CAAC,qCAAiB,CAAC,aAAa,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;SAC/C,CAAC;IACJ,CAAC;IACD,YACE,IAAuB,EACvB,SAA2C,EAC3C,SAAkB;QAElB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AArBD,sCAqBC"}

package/src/lib/errors/eciesError.d.ts

@@ -1,9 +1,8 @@
 import { EciesErrorType } from '../enumerations/eciesErrorType';
-import { StringLanguages } from '../enumerations/stringLanguages';
 import StringNames from '../enumerations/stringNames';
 import { TypedError } from './typedError';
 export declare class EciesError extends TypedError<EciesErrorType> {
     get reasonMap(): Record<EciesErrorType, StringNames>;
-    constructor(type: EciesErrorType, language?: StringLanguages, templateParams?: Record<string, string>);
+    constructor(type: EciesErrorType, language?: string, templateParams?: Record<string, string>);
 }
 //# sourceMappingURL=eciesError.d.ts.map

package/src/lib/errors/eciesError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eciesError.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/eciesError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,UAAW,SAAQ,UAAU,CAAC,cAAc,CAAC;IACxD,IAAW,SAAS,IAAI,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAyC1D;gBAGC,IAAI,EAAE,cAAc,EACpB,QAAQ,CAAC,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAQ1C"}
+{"version":3,"file":"eciesError.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/eciesError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,UAAW,SAAQ,UAAU,CAAC,cAAc,CAAC;IACxD,IAAW,SAAS,IAAI,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAyC1D;gBAGC,IAAI,EAAE,cAAc,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAQ1C"}

package/src/lib/errors/eciesError.js.map

@@ -1 +1 @@
-{"version":3,"file":"eciesError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/eciesError.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAEhE,6DAAsD;AACtD,6CAA0C;AAE1C,MAAa,UAAW,SAAQ,uBAA0B;IACxD,IAAW,SAAS;QAClB,OAAO;YACL,CAAC,+BAAc,CAAC,mBAAmB,CAAC,EAClC,qBAAW,CAAC,mCAAmC;YACjD,CAAC,+BAAc,CAAC,0BAA0B,CAAC,EACzC,qBAAW,CAAC,0CAA0C;YACxD,CAAC,+BAAc,CAAC,eAAe,CAAC,EAC9B,qBAAW,CAAC,+BAA+B;YAC7C,CAAC,+BAAc,CAAC,qBAAqB,CAAC,EACpC,qBAAW,CAAC,qCAAqC;YACnD,CAAC,+BAAc,CAAC,yBAAyB,CAAC,EACxC,qBAAW,CAAC,yCAAyC;YACvD,CAAC,+BAAc,CAAC,yBAAyB,CAAC,EACxC,qBAAW,CAAC,yCAAyC;YACvD,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,+BAAc,CAAC,gBAAgB,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,+BAAc,CAAC,sBAAsB,CAAC,EACrC,qBAAW,CAAC,sCAAsC;YACpD,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,+BAAc,CAAC,mBAAmB,CAAC,EAClC,qBAAW,CAAC,mCAAmC;YACjD,CAAC,+BAAc,CAAC,yBAAyB,CAAC,EACxC,qBAAW,CAAC,yCAAyC;YACvD,CAAC,+BAAc,CAAC,eAAe,CAAC,EAC9B,qBAAW,CAAC,+BAA+B;YAC7C,CAAC,+BAAc,CAAC,oBAAoB,CAAC,EACnC,qBAAW,CAAC,oCAAoC;YAClD,CAAC,+BAAc,CAAC,gBAAgB,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,+BAAc,CAAC,qBAAqB,CAAC,EACpC,qBAAW,CAAC,qCAAqC;YACnD,CAAC,+BAAc,CAAC,gBAAgB,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;SAChD,CAAC;IACJ,CAAC;IAED,YACE,IAAoB,EACpB,QAA0B,EAC1B,cAAuC;QAEvC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAvDD,gCAuDC"}
+{"version":3,"file":"eciesError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/eciesError.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAChE,6DAAsD;AACtD,6CAA0C;AAE1C,MAAa,UAAW,SAAQ,uBAA0B;IACxD,IAAW,SAAS;QAClB,OAAO;YACL,CAAC,+BAAc,CAAC,mBAAmB,CAAC,EAClC,qBAAW,CAAC,mCAAmC;YACjD,CAAC,+BAAc,CAAC,0BAA0B,CAAC,EACzC,qBAAW,CAAC,0CAA0C;YACxD,CAAC,+BAAc,CAAC,eAAe,CAAC,EAC9B,qBAAW,CAAC,+BAA+B;YAC7C,CAAC,+BAAc,CAAC,qBAAqB,CAAC,EACpC,qBAAW,CAAC,qCAAqC;YACnD,CAAC,+BAAc,CAAC,yBAAyB,CAAC,EACxC,qBAAW,CAAC,yCAAyC;YACvD,CAAC,+BAAc,CAAC,yBAAyB,CAAC,EACxC,qBAAW,CAAC,yCAAyC;YACvD,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,+BAAc,CAAC,gBAAgB,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,+BAAc,CAAC,sBAAsB,CAAC,EACrC,qBAAW,CAAC,sCAAsC;YACpD,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,+BAAc,CAAC,mBAAmB,CAAC,EAClC,qBAAW,CAAC,mCAAmC;YACjD,CAAC,+BAAc,CAAC,yBAAyB,CAAC,EACxC,qBAAW,CAAC,yCAAyC;YACvD,CAAC,+BAAc,CAAC,eAAe,CAAC,EAC9B,qBAAW,CAAC,+BAA+B;YAC7C,CAAC,+BAAc,CAAC,oBAAoB,CAAC,EACnC,qBAAW,CAAC,oCAAoC;YAClD,CAAC,+BAAc,CAAC,gBAAgB,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,+BAAc,CAAC,qBAAqB,CAAC,EACpC,qBAAW,CAAC,qCAAqC;YACnD,CAAC,+BAAc,CAAC,gBAAgB,CAAC,EAC/B,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,+BAAc,CAAC,iBAAiB,CAAC,EAChC,qBAAW,CAAC,iCAAiC;SAChD,CAAC;IACJ,CAAC;IAED,YACE,IAAoB,EACpB,QAAiB,EACjB,cAAuC;QAEvC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAvDD,gCAuDC"}

package/src/lib/errors/enhancedValidationError.d.ts

@@ -0,0 +1,73 @@
+import { BrightChainError } from './brightChainError';
+/**
+ * Enhanced validation error extending BrightChainError.
+ *
+ * This class provides a consistent validation error structure that includes
+ * the field name that failed validation, a descriptive message, and optional
+ * context for debugging.
+ *
+ * @remarks
+ * - Use this class for validation errors in the new BrightChainError hierarchy
+ * - The `field` property identifies which field/parameter failed validation
+ * - The `context` property can include additional details like expected values
+ * - The existing `ValidationError` class is maintained for backward compatibility
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * throw new EnhancedValidationError('blockSize', 'Invalid block size: 999');
+ *
+ * // With context
+ * throw new EnhancedValidationError(
+ *   'recipientCount',
+ *   'Recipient count must be at least 1 for multi-recipient encryption',
+ *   { recipientCount: 0, encryptionType: 'MultiRecipient' }
+ * );
+ * ```
+ *
+ * @see Requirements 4.1, 5.4
+ */
+export declare class EnhancedValidationError extends BrightChainError {
+    readonly field: string;
+    /**
+     * Creates a new EnhancedValidationError instance.
+     *
+     * @param field - The name of the field/parameter that failed validation
+     * @param message - Human-readable description of the validation failure
+     * @param context - Optional additional context for debugging (merged with field)
+     *
+     * @example
+     * ```typescript
+     * // Validate block size
+     * if (!isValidBlockSize(blockSize)) {
+     *   throw new EnhancedValidationError(
+     *     'blockSize',
+     *     `Invalid block size: ${blockSize}`,
+     *     { validSizes: [256, 512, 1024, 2048, 4096] }
+     *   );
+     * }
+     * ```
+     */
+    constructor(field: string, message: string, context?: Record<string, unknown>);
+}
+/**
+ * Type guard to check if a value is an EnhancedValidationError instance.
+ *
+ * @param error - The value to check
+ * @returns true if the value is an EnhancedValidationError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateInput(data);
+ * } catch (error) {
+ *   if (isEnhancedValidationError(error)) {
+ *     console.error(`Validation failed for field '${error.field}': ${error.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirement 4.5
+ */
+export declare function isEnhancedValidationError(error: unknown): error is EnhancedValidationError;
+//# sourceMappingURL=enhancedValidationError.d.ts.map

package/src/lib/errors/enhancedValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedValidationError.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/enhancedValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,uBAAwB,SAAQ,gBAAgB;aAqBzC,KAAK,EAAE,MAAM;IApB/B;;;;;;;;;;;;;;;;;;OAkBG;gBAEe,KAAK,EAAE,MAAM,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAElC"}

package/src/lib/errors/enhancedValidationError.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedValidationError = void 0;
+exports.isEnhancedValidationError = isEnhancedValidationError;
+const brightChainError_1 = require("./brightChainError");
+/**
+ * Enhanced validation error extending BrightChainError.
+ *
+ * This class provides a consistent validation error structure that includes
+ * the field name that failed validation, a descriptive message, and optional
+ * context for debugging.
+ *
+ * @remarks
+ * - Use this class for validation errors in the new BrightChainError hierarchy
+ * - The `field` property identifies which field/parameter failed validation
+ * - The `context` property can include additional details like expected values
+ * - The existing `ValidationError` class is maintained for backward compatibility
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * throw new EnhancedValidationError('blockSize', 'Invalid block size: 999');
+ *
+ * // With context
+ * throw new EnhancedValidationError(
+ *   'recipientCount',
+ *   'Recipient count must be at least 1 for multi-recipient encryption',
+ *   { recipientCount: 0, encryptionType: 'MultiRecipient' }
+ * );
+ * ```
+ *
+ * @see Requirements 4.1, 5.4
+ */
+class EnhancedValidationError extends brightChainError_1.BrightChainError {
+    /**
+     * Creates a new EnhancedValidationError instance.
+     *
+     * @param field - The name of the field/parameter that failed validation
+     * @param message - Human-readable description of the validation failure
+     * @param context - Optional additional context for debugging (merged with field)
+     *
+     * @example
+     * ```typescript
+     * // Validate block size
+     * if (!isValidBlockSize(blockSize)) {
+     *   throw new EnhancedValidationError(
+     *     'blockSize',
+     *     `Invalid block size: ${blockSize}`,
+     *     { validSizes: [256, 512, 1024, 2048, 4096] }
+     *   );
+     * }
+     * ```
+     */
+    constructor(field, message, context) {
+        super('Validation', message, { field, ...context });
+        this.field = field;
+    }
+}
+exports.EnhancedValidationError = EnhancedValidationError;
+/**
+ * Type guard to check if a value is an EnhancedValidationError instance.
+ *
+ * @param error - The value to check
+ * @returns true if the value is an EnhancedValidationError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateInput(data);
+ * } catch (error) {
+ *   if (isEnhancedValidationError(error)) {
+ *     console.error(`Validation failed for field '${error.field}': ${error.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirement 4.5
+ */
+function isEnhancedValidationError(error) {
+    return error instanceof EnhancedValidationError;
+}
+//# sourceMappingURL=enhancedValidationError.js.map

package/src/lib/errors/enhancedValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedValidationError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/enhancedValidationError.ts"],"names":[],"mappings":";;;AA8EA,8DAIC;AAlFD,yDAAsD;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,uBAAwB,SAAQ,mCAAgB;IAC3D;;;;;;;;;;;;;;;;;;OAkBG;IACH,YACkB,KAAa,EAC7B,OAAe,EACf,OAAiC;QAEjC,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAJpC,UAAK,GAAL,KAAK,CAAQ;IAK/B,CAAC;CACF;AA3BD,0DA2BC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,yBAAyB,CACvC,KAAc;IAEd,OAAO,KAAK,YAAY,uBAAuB,CAAC;AAClD,CAAC"}

package/src/lib/errors/extendedCblError.d.ts

@@ -1,6 +1,5 @@
 import { BlockSize } from '../enumerations/blockSize';
 import { ExtendedCblErrorType } from '../enumerations/extendedCblErrorType';
-import { StringLanguages } from '../enumerations/stringLanguages';
 import StringNames from '../enumerations/stringNames';
 import { TypedError } from './typedError';
 export declare class ExtendedCblError extends TypedError<ExtendedCblErrorType> {
@@ -8,6 +7,6 @@ export declare class ExtendedCblError extends TypedError<ExtendedCblErrorType> {
     readonly dataSize?: number;
     readonly error?: string;
     get reasonMap(): Record<ExtendedCblErrorType, StringNames>;
-    constructor(type: ExtendedCblErrorType, blockSize?: BlockSize, dataSize?: number, error?: string, _language?: StringLanguages);
+    constructor(type: ExtendedCblErrorType, blockSize?: BlockSize, dataSize?: number, error?: string, _language?: string);
 }
 //# sourceMappingURL=extendedCblError.d.ts.map

package/src/lib/errors/extendedCblError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extendedCblError.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/extendedCblError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,gBAAiB,SAAQ,UAAU,CAAC,oBAAoB,CAAC;IACpE,SAAgB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,IAAW,SAAS,IAAI,MAAM,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAmDhE;gBAEC,IAAI,EAAE,oBAAoB,EAC1B,SAAS,CAAC,EAAE,SAAS,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,eAAe;CAW9B"}
+{"version":3,"file":"extendedCblError.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/extendedCblError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,WAAW,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,gBAAiB,SAAQ,UAAU,CAAC,oBAAoB,CAAC;IACpE,SAAgB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,IAAW,SAAS,IAAI,MAAM,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAmDhE;gBAEC,IAAI,EAAE,oBAAoB,EAC1B,SAAS,CAAC,EAAE,SAAS,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM;CAWrB"}

package/src/lib/errors/extendedCblError.js.map

@@ -1 +1 @@
-{"version":3,"file":"extendedCblError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/extendedCblError.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extendedCblError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/extendedCblError.ts"],"names":[],"mappings":";;;AACA,+EAA4E;AAC5E,6DAAsD;AACtD,6CAA0C;AAE1C,MAAa,gBAAiB,SAAQ,uBAAgC;IAIpE,IAAW,SAAS;QAClB,OAAO;YACL,CAAC,2CAAoB,CAAC,gBAAgB,CAAC,EACrC,qBAAW,CAAC,8BAA8B;YAC5C,CAAC,2CAAoB,CAAC,gBAAgB,CAAC,EACrC,qBAAW,CAAC,8BAA8B;YAC5C,CAAC,2CAAoB,CAAC,2BAA2B,CAAC,EAChD,qBAAW,CAAC,yCAAyC;YACvD,CAAC,2CAAoB,CAAC,gBAAgB,CAAC,EACrC,qBAAW,CAAC,8BAA8B;YAC5C,CAAC,2CAAoB,CAAC,aAAa,CAAC,EAClC,qBAAW,CAAC,2BAA2B;YACzC,CAAC,2CAAoB,CAAC,kBAAkB,CAAC,EACvC,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,2CAAoB,CAAC,mBAAmB,CAAC,EACxC,qBAAW,CAAC,iCAAiC;YAC/C,CAAC,2CAAoB,CAAC,oBAAoB,CAAC,EACzC,qBAAW,CAAC,kCAAkC;YAChD,CAAC,2CAAoB,CAAC,qBAAqB,CAAC,EAC1C,qBAAW,CAAC,mCAAmC;YACjD,CAAC,2CAAoB,CAAC,gBAAgB,CAAC,EACrC,qBAAW,CAAC,8BAA8B;YAC5C,CAAC,2CAAoB,CAAC,aAAa,CAAC,EAClC,qBAAW,CAAC,2BAA2B;YACzC,CAAC,2CAAoB,CAAC,kBAAkB,CAAC,EACvC,qBAAW,CAAC,gCAAgC;YAC9C,CAAC,2CAAoB,CAAC,iBAAiB,CAAC,EACtC,qBAAW,CAAC,+BAA+B;YAC7C,CAAC,2CAAoB,CAAC,qBAAqB,CAAC,EAC1C,qBAAW,CAAC,mCAAmC;YACjD,CAAC,2CAAoB,CAAC,gBAAgB,CAAC,EACrC,qBAAW,CAAC,8BAA8B;YAC5C,CAAC,2CAAoB,CAAC,oBAAoB,CAAC,EACzC,qBAAW,CAAC,kCAAkC;YAChD,CAAC,2CAAoB,CAAC,oBAAoB,CAAC,EACzC,qBAAW,CAAC,kCAAkC;YAChD,CAAC,2CAAoB,CAAC,qBAAqB,CAAC,EAC1C,qBAAW,CAAC,mCAAmC;YACjD,CAAC,2CAAoB,CAAC,gBAAgB,CAAC,EACrC,qBAAW,CAAC,8BAA8B;YAC5C,CAAC,2CAAoB,CAAC,cAAc,CAAC,EACnC,qBAAW,CAAC,oCAAoC;YAClD,CAAC,2CAAoB,CAAC,oBAAoB,CAAC,EACzC,qBAAW,CAAC,0CAA0C;YACxD,CAAC,2CAAoB,CAAC,cAAc,CAAC,EACnC,qBAAW,CAAC,4BAA4B;YAC1C,CAAC,2CAAoB,CAAC,eAAe,CAAC,EACpC,qBAAW,CAAC,6BAA6B;YAC3C,CAAC,2CAAoB,CAAC,eAAe,CAAC,EACpC,qBAAW,CAAC,6BAA6B;SAC5C,CAAC;IACJ,CAAC;IACD,YACE,IAA0B,EAC1B,SAAqB,EACrB,QAAiB,EACjB,KAAc,EACd,SAAkB;QAElB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE;YACrB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAxED,4CAwEC"}

package/src/lib/errors/factoryPatternViolationError.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Factory pattern violation error class for the BrightChain library.
+ *
+ * This error is thrown when code attempts to instantiate a class directly
+ * instead of using its designated factory method. Factory patterns are used
+ * to ensure proper validation and initialization of objects.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   FactoryPatternViolationError,
+ *   isFactoryPatternViolationError
+ * } from './factoryPatternViolationError';
+ *
+ * // This error is thrown internally when bypassing factory methods
+ * // For example, if MemberDocument is instantiated directly:
+ * try {
+ *   // Attempting to bypass factory method would throw:
+ *   // throw new FactoryPatternViolationError('MemberDocument');
+ * } catch (error) {
+ *   if (isFactoryPatternViolationError(error)) {
+ *     console.error(`Cannot instantiate ${error.className} directly`);
+ *     console.error('Use the factory method instead');
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirements 2.2, 4.1
+ */
+import { BrightChainError } from './brightChainError';
+/**
+ * Error class for factory pattern violations.
+ *
+ * Extends BrightChainError to provide consistent error handling
+ * when code attempts to bypass factory methods.
+ *
+ * @remarks
+ * - The `className` property identifies which class was incorrectly instantiated
+ * - Factory patterns ensure proper validation and initialization
+ * - Use the `isFactoryPatternViolationError` type guard for type-safe error handling
+ *
+ * @see Requirements 2.2, 4.1
+ */
+export declare class FactoryPatternViolationError extends BrightChainError {
+    readonly className: string;
+    /**
+     * Creates a new FactoryPatternViolationError instance.
+     *
+     * @param className - The name of the class that was incorrectly instantiated
+     * @param context - Optional additional context for debugging
+     *
+     * @example
+     * ```typescript
+     * // Inside a class constructor that requires factory method usage:
+     * class MyClass {
+     *   private constructor(factoryToken: symbol) {
+     *     if (factoryToken !== FACTORY_TOKEN) {
+     *       throw new FactoryPatternViolationError('MyClass');
+     *     }
+     *   }
+     *
+     *   static create(): MyClass {
+     *     return new MyClass(FACTORY_TOKEN);
+     *   }
+     * }
+     * ```
+     */
+    constructor(className: string, context?: Record<string, unknown>);
+}
+/**
+ * Type guard to check if a value is a FactoryPatternViolationError instance.
+ *
+ * @param error - The value to check
+ * @returns true if the value is a FactoryPatternViolationError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   // Some operation that might violate factory pattern
+ * } catch (error) {
+ *   if (isFactoryPatternViolationError(error)) {
+ *     // error is narrowed to FactoryPatternViolationError type
+ *     console.error(`Use ${error.className}.create() instead of new ${error.className}()`);
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirement 14.4
+ */
+export declare function isFactoryPatternViolationError(error: unknown): error is FactoryPatternViolationError;
+//# sourceMappingURL=factoryPatternViolationError.d.ts.map

package/src/lib/errors/factoryPatternViolationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factoryPatternViolationError.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/factoryPatternViolationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;aAwB9C,SAAS,EAAE,MAAM;IAvBnC;;;;;;;;;;;;;;;;;;;;;OAqBG;gBAEe,SAAS,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQpC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAEvC"}

package/src/lib/errors/factoryPatternViolationError.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Factory pattern violation error class for the BrightChain library.
+ *
+ * This error is thrown when code attempts to instantiate a class directly
+ * instead of using its designated factory method. Factory patterns are used
+ * to ensure proper validation and initialization of objects.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   FactoryPatternViolationError,
+ *   isFactoryPatternViolationError
+ * } from './factoryPatternViolationError';
+ *
+ * // This error is thrown internally when bypassing factory methods
+ * // For example, if MemberDocument is instantiated directly:
+ * try {
+ *   // Attempting to bypass factory method would throw:
+ *   // throw new FactoryPatternViolationError('MemberDocument');
+ * } catch (error) {
+ *   if (isFactoryPatternViolationError(error)) {
+ *     console.error(`Cannot instantiate ${error.className} directly`);
+ *     console.error('Use the factory method instead');
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirements 2.2, 4.1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryPatternViolationError = void 0;
+exports.isFactoryPatternViolationError = isFactoryPatternViolationError;
+const brightChainError_1 = require("./brightChainError");
+/**
+ * Error class for factory pattern violations.
+ *
+ * Extends BrightChainError to provide consistent error handling
+ * when code attempts to bypass factory methods.
+ *
+ * @remarks
+ * - The `className` property identifies which class was incorrectly instantiated
+ * - Factory patterns ensure proper validation and initialization
+ * - Use the `isFactoryPatternViolationError` type guard for type-safe error handling
+ *
+ * @see Requirements 2.2, 4.1
+ */
+class FactoryPatternViolationError extends brightChainError_1.BrightChainError {
+    /**
+     * Creates a new FactoryPatternViolationError instance.
+     *
+     * @param className - The name of the class that was incorrectly instantiated
+     * @param context - Optional additional context for debugging
+     *
+     * @example
+     * ```typescript
+     * // Inside a class constructor that requires factory method usage:
+     * class MyClass {
+     *   private constructor(factoryToken: symbol) {
+     *     if (factoryToken !== FACTORY_TOKEN) {
+     *       throw new FactoryPatternViolationError('MyClass');
+     *     }
+     *   }
+     *
+     *   static create(): MyClass {
+     *     return new MyClass(FACTORY_TOKEN);
+     *   }
+     * }
+     * ```
+     */
+    constructor(className, context) {
+        super('FactoryPatternViolation', `Cannot instantiate ${className} directly. Use the factory method instead.`, { className, ...context });
+        this.className = className;
+    }
+}
+exports.FactoryPatternViolationError = FactoryPatternViolationError;
+/**
+ * Type guard to check if a value is a FactoryPatternViolationError instance.
+ *
+ * @param error - The value to check
+ * @returns true if the value is a FactoryPatternViolationError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   // Some operation that might violate factory pattern
+ * } catch (error) {
+ *   if (isFactoryPatternViolationError(error)) {
+ *     // error is narrowed to FactoryPatternViolationError type
+ *     console.error(`Use ${error.className}.create() instead of new ${error.className}()`);
+ *   }
+ * }
+ * ```
+ *
+ * @see Requirement 14.4
+ */
+function isFactoryPatternViolationError(error) {
+    return error instanceof FactoryPatternViolationError;
+}
+//# sourceMappingURL=factoryPatternViolationError.js.map

package/src/lib/errors/factoryPatternViolationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factoryPatternViolationError.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/factoryPatternViolationError.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAwEH,wEAIC;AA1ED,yDAAsD;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAa,4BAA6B,SAAQ,mCAAgB;IAChE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YACkB,SAAiB,EACjC,OAAiC;QAEjC,KAAK,CACH,yBAAyB,EACzB,sBAAsB,SAAS,4CAA4C,EAC3E,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAC1B,CAAC;QAPc,cAAS,GAAT,SAAS,CAAQ;IAQnC,CAAC;CACF;AAjCD,oEAiCC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,8BAA8B,CAC5C,KAAc;IAEd,OAAO,KAAK,YAAY,4BAA4B,CAAC;AACvD,CAAC"}

package/src/lib/errors/failedToHydrate.d.ts

@@ -1,6 +1,5 @@
 import { HandleableError } from '@digitaldefiance/i18n-lib';
-import { StringLanguages } from '../enumerations/stringLanguages';
 export declare class FailedToHydrateError extends HandleableError {
-    constructor(message: string, _language?: StringLanguages);
+    constructor(message: string, _language?: string);
 }
 //# sourceMappingURL=failedToHydrate.d.ts.map

package/src/lib/errors/failedToHydrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failedToHydrate.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/failedToHydrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIlE,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe;CASzD"}
+{"version":3,"file":"failedToHydrate.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/errors/failedToHydrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI5D,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAShD"}