@brightchain/brightchain-lib 0.2.1 → 0.5.0

package/src/lib/utils/xorUtils.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xorArrays = xorArrays;
+exports.xorMultipleArrays = xorMultipleArrays;
+exports.padToBlockSize = padToBlockSize;
+exports.unpadCblData = unpadCblData;
+const xor_1 = require("../services/xor");
+/**
+ * XOR utility functions for CBL whitening operations.
+ * These utilities wrap XorService and add padding/unpadding for block-aligned storage.
+ */
+/**
+ * XOR two Uint8Arrays of equal length.
+ * Delegates to XorService.xor for the actual XOR operation.
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns XOR result (a ⊕ b)
+ * @throws Error if arrays have different lengths
+ */
+function xorArrays(a, b) {
+    return xor_1.XorService.xor(a, b);
+}
+/**
+ * XOR multiple Uint8Arrays of equal length together.
+ * Delegates to XorService.xorMultiple for the actual XOR operation.
+ *
+ * @param arrays - Array of Uint8Arrays to XOR together (must all be same length)
+ * @returns XOR result
+ * @throws Error if arrays have different lengths or if no arrays provided
+ */
+function xorMultipleArrays(arrays) {
+    return xor_1.XorService.xorMultiple(arrays);
+}
+/**
+ * Length prefix size in bytes (4 bytes = 32-bit unsigned integer).
+ * This allows for data up to ~4GB in size.
+ */
+const LENGTH_PREFIX_SIZE = 4;
+/**
+ * Pad data to a multiple of block size with length prefix and random bytes.
+ * The padding ensures that the data aligns with block boundaries.
+ *
+ * Format: [4-byte length prefix][original data][random padding]
+ *
+ * @param data - The data to pad
+ * @param blockSize - The target block size
+ * @returns Padded data with length prefix
+ */
+function padToBlockSize(data, blockSize) {
+    if (blockSize <= 0) {
+        throw new Error(`Block size must be positive: ${blockSize}`);
+    }
+    // Total size needed: length prefix + data
+    const totalDataSize = LENGTH_PREFIX_SIZE + data.length;
+    // Calculate padded size (round up to next block boundary)
+    const paddedSize = Math.ceil(totalDataSize / blockSize) * blockSize;
+    // Create padded array
+    const padded = new Uint8Array(paddedSize);
+    // Write length prefix (big-endian 32-bit unsigned integer)
+    const view = new DataView(padded.buffer);
+    view.setUint32(0, data.length, false); // false = big-endian
+    // Copy original data after length prefix
+    padded.set(data, LENGTH_PREFIX_SIZE);
+    // Fill remaining bytes with random data for security
+    if (paddedSize > totalDataSize) {
+        const paddingBytes = padded.subarray(totalDataSize);
+        xor_1.XorService.generateKey(paddingBytes.length).forEach((byte, i) => {
+            paddingBytes[i] = byte;
+        });
+    }
+    return padded;
+}
+/**
+ * Remove padding from CBL data by reading the length prefix.
+ * The length prefix tells us exactly how many bytes of original data follow.
+ *
+ * Format: [4-byte length prefix][original data][random padding]
+ *
+ * @param data - The padded CBL data with length prefix
+ * @returns Unpadded CBL data (original data without length prefix or padding)
+ * @throws Error if data is too short or length prefix is invalid
+ */
+function unpadCblData(data) {
+    if (data.length < LENGTH_PREFIX_SIZE) {
+        throw new Error(`Invalid padded data: too short (${data.length} bytes, need at least ${LENGTH_PREFIX_SIZE})`);
+    }
+    // Read length prefix (big-endian 32-bit unsigned integer)
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const originalLength = view.getUint32(0, false); // false = big-endian
+    // Validate length
+    if (originalLength > data.length - LENGTH_PREFIX_SIZE) {
+        throw new Error(`Invalid length prefix: claims ${originalLength} bytes but only ${data.length - LENGTH_PREFIX_SIZE} available`);
+    }
+    // Return original data (after length prefix, up to original length)
+    return data.subarray(LENGTH_PREFIX_SIZE, LENGTH_PREFIX_SIZE + originalLength);
+}
+//# sourceMappingURL=xorUtils.js.map

package/src/lib/utils/xorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xorUtils.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/utils/xorUtils.ts"],"names":[],"mappings":";;AAgBA,8BAEC;AAUD,8CAEC;AAkBD,wCAiCC;AAYD,oCAoBC;AAjHD,yCAA6C;AAE7C;;;GAGG;AAEH;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,CAAa,EAAE,CAAa;IACpD,OAAO,gBAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,MAAoB;IACpD,OAAO,gBAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAC5B,IAAgB,EAChB,SAAiB;IAEjB,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,0CAA0C;IAC1C,MAAM,aAAa,GAAG,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IAEvD,0DAA0D;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAEpE,sBAAsB;IACtB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAE1C,2DAA2D;IAC3D,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB;IAE5D,yCAAyC;IACzC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAErC,qDAAqD;IACrD,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACpD,gBAAU,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YAC9D,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAAC,IAAgB;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,MAAM,yBAAyB,kBAAkB,GAAG,CAC7F,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB;IAEtE,kBAAkB;IAClB,IAAI,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,iCAAiC,cAAc,mBAAmB,IAAI,CAAC,MAAM,GAAG,kBAAkB,YAAY,CAC/G,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,cAAc,CAAC,CAAC;AAChF,CAAC"}

package/src/lib/enumerations/memberType.d.ts

@@ -1,16 +0,0 @@
-/**
- * Types of members in the system.
- * In the Owner Free Filesystem (OFF), members can be:
- * 1. Admin - System administrators
- * 2. System - System services and automated processes
- * 3. User - Regular users
- * 4. Anonymous - Used for blocks that don't need a real owner
- */
-export declare enum MemberType {
-    Admin = "Admin",
-    System = "System",
-    User = "User",
-    Anonymous = "Anonymous"
-}
-export default MemberType;
-//# sourceMappingURL=memberType.d.ts.map

package/src/lib/enumerations/memberType.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memberType.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/enumerations/memberType.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,eAAe,UAAU,CAAC"}

package/src/lib/enumerations/memberType.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemberType = void 0;
-/**
- * Types of members in the system.
- * In the Owner Free Filesystem (OFF), members can be:
- * 1. Admin - System administrators
- * 2. System - System services and automated processes
- * 3. User - Regular users
- * 4. Anonymous - Used for blocks that don't need a real owner
- */
-var MemberType;
-(function (MemberType) {
-    MemberType["Admin"] = "Admin";
-    MemberType["System"] = "System";
-    MemberType["User"] = "User";
-    MemberType["Anonymous"] = "Anonymous";
-})(MemberType || (exports.MemberType = MemberType = {}));
-exports.default = MemberType;
-//# sourceMappingURL=memberType.js.map

package/src/lib/enumerations/memberType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memberType.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/enumerations/memberType.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,6BAAe,CAAA;IACf,+BAAiB,CAAA;IACjB,2BAAa,CAAA;IACb,qCAAuB,CAAA;AACzB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB;AAED,kBAAe,UAAU,CAAC"}