@brightchain/brightchain-lib 0.1.0

package/src/lib/blocks/memoryTuple.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryBlockTuple = void 0;
+const constants_1 = require("../constants");
+const blockDataType_1 = require("../enumerations/blockDataType");
+const blockType_1 = require("../enumerations/blockType");
+const memoryTupleErrorType_1 = require("../enumerations/memoryTupleErrorType");
+const memoryTupleError_1 = require("../errors/memoryTupleError");
+const rawData_1 = require("./rawData");
+/**
+ * InMemoryBlockTuple represents a tuple of blocks that can be XORed together.
+ * In the Owner Free Filesystem (OFF), tuples are used for:
+ * 1. Data blocks XORed with random blocks for privacy
+ * 2. Parity blocks XORed for error correction
+ *
+ * This class supports both:
+ * 1. In-memory blocks (BaseBlock derivatives) for immediate operations
+ * 2. Disk-based blocks (BlockHandle) for persistent storage
+ */
+class InMemoryBlockTuple {
+    constructor(blocks) {
+        if (blocks.length !== constants_1.TUPLE.SIZE) {
+            throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.InvalidTupleSize, constants_1.TUPLE.SIZE);
+        }
+        // Verify all blocks have the same size
+        this._blockSize = blocks[0].blockSize;
+        if (!blocks.every((b) => b.blockSize === this._blockSize)) {
+            throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.BlockSizeMismatch);
+        }
+        this._blocks = blocks;
+    }
+    /**
+     * Get the block IDs in this tuple
+     */
+    get blockIds() {
+        return this._blocks.map((block) => block.idChecksum);
+    }
+    /**
+     * Get the block IDs as a concatenated buffer
+     */
+    get blockIdsBuffer() {
+        return Buffer.concat(this.blockIds);
+    }
+    /**
+     * Get the blocks in this tuple
+     */
+    get blocks() {
+        return this._blocks;
+    }
+    /**
+     * Get the block size for this tuple
+     */
+    get blockSize() {
+        return this._blockSize;
+    }
+    /**
+     * Convert a Readable stream to a Buffer
+     * @param readable - The readable stream to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    static async streamToBuffer(readable) {
+        const chunks = [];
+        for await (const chunk of readable) {
+            chunks.push(Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks);
+    }
+    /**
+     * Convert data to Buffer regardless of whether it's a Readable or Buffer
+     * @param data - The data to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    static async toBuffer(data) {
+        if (Buffer.isBuffer(data)) {
+            return data;
+        }
+        return InMemoryBlockTuple.streamToBuffer(data);
+    }
+    /**
+     * XOR all blocks together
+     * @returns A new RawDataBlock containing the XOR result
+     */
+    async xor() {
+        if (!this._blocks.length) {
+            throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.NoBlocksToXor);
+        }
+        try {
+            // Load and copy first block's data
+            const result = Buffer.alloc((await InMemoryBlockTuple.toBuffer(this._blocks[0].data)).length);
+            (await InMemoryBlockTuple.toBuffer(this._blocks[0].data)).copy(result);
+            // XOR with remaining blocks
+            for (let i = 1; i < this._blocks.length; i++) {
+                const currentData = await InMemoryBlockTuple.toBuffer(this._blocks[i].data);
+                if (currentData.length !== result.length) {
+                    throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.BlockSizeMismatch);
+                }
+                // XOR in place
+                for (let j = 0; j < result.length; j++) {
+                    result[j] ^= currentData[j];
+                }
+            }
+            // Create new block with XOR result
+            return new rawData_1.RawDataBlock(this._blockSize, result, new Date(), undefined, // Let constructor calculate checksum
+            blockType_1.BlockType.RawData, blockDataType_1.BlockDataType.RawData, true, // canRead
+            true);
+        }
+        catch (error) {
+            if (error instanceof memoryTupleError_1.MemoryTupleError) {
+                throw error;
+            }
+            throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.InvalidBlockCount);
+        }
+    }
+    /**
+     * Create a tuple from block IDs
+     * This creates disk-based blocks using BlockHandle
+     */
+    static async fromIds(blockIDs, blockSize, getBlockPath) {
+        if (blockIDs.length !== constants_1.TUPLE.SIZE) {
+            throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.ExpectedBlockIds, constants_1.TUPLE.SIZE);
+        }
+        const handles = await Promise.all(blockIDs.map((id) => {
+            // @ts-expect-error - BlockHandle constructor workaround
+            return new handle_1.BlockHandle(getBlockPath(id), blockSize, id, true, // canRead
+            true);
+        }));
+        return new InMemoryBlockTuple(handles);
+    }
+    /**
+     * Create a tuple from blocks
+     * This creates in-memory blocks
+     */
+    static fromBlocks(blocks) {
+        if (blocks.length !== constants_1.TUPLE.SIZE) {
+            throw new memoryTupleError_1.MemoryTupleError(memoryTupleErrorType_1.MemoryTupleErrorType.ExpectedBlocks, constants_1.TUPLE.SIZE);
+        }
+        return new InMemoryBlockTuple(blocks);
+    }
+}
+exports.InMemoryBlockTuple = InMemoryBlockTuple;
+InMemoryBlockTuple.TupleSize = constants_1.TUPLE.SIZE;
+//# sourceMappingURL=memoryTuple.js.map

package/src/lib/blocks/memoryTuple.js.map

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

package/src/lib/blocks/parity.d.ts

@@ -0,0 +1,12 @@
+import { ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
+import { BlockSize } from '../enumerations/blockSize';
+import { RawDataBlock } from './rawData';
+/**
+ * ParityBlock represents a block containing forward error correction (FEC) data.
+ * It is used to recover data when some blocks in a tuple are lost or corrupted.
+ * The parity data is generated using FecService through ServiceProvider
+ */
+export declare class ParityBlock extends RawDataBlock {
+    constructor(blockSize: BlockSize, data: Uint8Array, dateCreated?: Date, checksum?: ChecksumUint8Array, canRead?: boolean, canPersist?: boolean);
+}
+//# sourceMappingURL=parity.d.ts.map

package/src/lib/blocks/parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/parity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAEzC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,IAAI,EAClB,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,OAAO,UAAO,EACd,UAAU,UAAO;CAiBpB"}

package/src/lib/blocks/parity.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParityBlock = void 0;
+const blockDataType_1 = require("../enumerations/blockDataType");
+const blockType_1 = require("../enumerations/blockType");
+const rawData_1 = require("./rawData");
+/**
+ * ParityBlock represents a block containing forward error correction (FEC) data.
+ * It is used to recover data when some blocks in a tuple are lost or corrupted.
+ * The parity data is generated using FecService through ServiceProvider
+ */
+class ParityBlock extends rawData_1.RawDataBlock {
+    constructor(blockSize, data, dateCreated, checksum, canRead = true, canPersist = true) {
+        if (data.length !== blockSize) {
+            throw new Error('Data length must match block size');
+        }
+        super(blockSize, data, dateCreated, checksum, blockType_1.BlockType.FECData, blockDataType_1.BlockDataType.RawData, canRead, canPersist);
+    }
+}
+exports.ParityBlock = ParityBlock;
+//# sourceMappingURL=parity.js.map

package/src/lib/blocks/parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/parity.ts"],"names":[],"mappings":";;;AACA,iEAA8D;AAE9D,yDAAsD;AACtD,uCAAyC;AAEzC;;;;GAIG;AACH,MAAa,WAAY,SAAQ,sBAAY;IAC3C,YACE,SAAoB,EACpB,IAAgB,EAChB,WAAkB,EAClB,QAA6B,EAC7B,OAAO,GAAG,IAAI,EACd,UAAU,GAAG,IAAI;QAEjB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,CACH,SAAS,EACT,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,qBAAS,CAAC,OAAO,EACjB,6BAAa,CAAC,OAAO,EACrB,OAAO,EACP,UAAU,CACX,CAAC;IACJ,CAAC;CACF;AAxBD,kCAwBC"}

package/src/lib/blocks/random.d.ts

@@ -0,0 +1,63 @@
+import { ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { BaseBlock } from './base';
+import { RawDataBlock } from './rawData';
+/**
+ * RandomBlock represents a block containing cryptographically secure random data.
+ * Used in conjunction with WhitenedBlock for the Owner Free Filesystem concept,
+ * where data blocks are XORed with random blocks to make them meaningless on their own.
+ */
+export declare class RandomBlock extends RawDataBlock {
+    constructor(blockSize: BlockSize, data: Buffer, dateCreated?: Date, checksum?: ChecksumUint8Array);
+    /**
+     * Create a new random block
+     */
+    static new(blockSize: BlockSize, dateCreated?: Date): RandomBlock;
+    /**
+     * Reconstitute a random block from existing data
+     */
+    static reconstitute(blockSize: BlockSize, data: Buffer, dateCreated?: Date, checksum?: ChecksumUint8Array): RandomBlock;
+    /**
+     * The type of the block
+     */
+    get blockType(): BlockType;
+    /**
+     * The type of data in the block
+     */
+    get blockDataType(): BlockDataType;
+    /**
+     * Whether the block can be encrypted
+     */
+    get canEncrypt(): boolean;
+    /**
+     * Whether the block can be decrypted
+     */
+    get canDecrypt(): boolean;
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData(): Buffer;
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData(): Buffer;
+    /**
+     * Convert a Readable stream to a Buffer
+     * @param readable - The readable stream to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    private static streamToBuffer;
+    /**
+     * Convert data to Buffer regardless of whether it's a Readable or Buffer
+     * @param data - The data to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    private static toBuffer;
+    /**
+     * XOR this block with another block
+     */
+    xor<T extends BaseBlock>(other: T): Promise<T>;
+}
+//# sourceMappingURL=random.d.ts.map

package/src/lib/blocks/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAEzC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,IAAI,EAClB,QAAQ,CAAC,EAAE,kBAAkB;IAkB/B;;OAEG;WACW,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,WAAW;IAKxE;;OAEG;WACW,YAAY,CACxB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,IAAI,EAClB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,WAAW;IAId;;OAEG;IACH,IAAoB,SAAS,IAAI,SAAS,CAEzC;IAED;;OAEG;IACH,IAAoB,aAAa,IAAI,aAAa,CAEjD;IAED;;OAEG;IACH,IAAoB,UAAU,IAAI,OAAO,CAExC;IAED;;OAEG;IACH,IAAoB,UAAU,IAAI,OAAO,CAExC;IAED;;OAEG;IACH,IAAoB,eAAe,IAAI,MAAM,CAG5C;IAED;;OAEG;IACH,IAAoB,cAAc,IAAI,MAAM,CAE3C;IAED;;;;OAIG;mBACkB,cAAc;IAQnC;;;;OAIG;mBACkB,QAAQ;IAO7B;;OAEG;IACU,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAgC5D"}

package/src/lib/blocks/random.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RandomBlock = void 0;
+const crypto_1 = require("crypto");
+const blockDataType_1 = require("../enumerations/blockDataType");
+const blockType_1 = require("../enumerations/blockType");
+const service_provider_1 = require("../services/service.provider");
+const rawData_1 = require("./rawData");
+/**
+ * RandomBlock represents a block containing cryptographically secure random data.
+ * Used in conjunction with WhitenedBlock for the Owner Free Filesystem concept,
+ * where data blocks are XORed with random blocks to make them meaningless on their own.
+ */
+class RandomBlock extends rawData_1.RawDataBlock {
+    constructor(blockSize, data, dateCreated, checksum) {
+        if (data.length !== blockSize) {
+            throw new Error('Data length must match block size');
+        }
+        super(blockSize, data, dateCreated, checksum, blockType_1.BlockType.Random, blockDataType_1.BlockDataType.RawData, true, // canRead
+        true);
+    }
+    /**
+     * Create a new random block
+     */
+    static new(blockSize, dateCreated) {
+        const data = (0, crypto_1.randomBytes)(blockSize);
+        return new RandomBlock(blockSize, data, dateCreated);
+    }
+    /**
+     * Reconstitute a random block from existing data
+     */
+    static reconstitute(blockSize, data, dateCreated, checksum) {
+        return new RandomBlock(blockSize, data, dateCreated, checksum);
+    }
+    /**
+     * The type of the block
+     */
+    get blockType() {
+        return blockType_1.BlockType.Random;
+    }
+    /**
+     * The type of data in the block
+     */
+    get blockDataType() {
+        return blockDataType_1.BlockDataType.RawData;
+    }
+    /**
+     * Whether the block can be encrypted
+     */
+    get canEncrypt() {
+        return false; // Random blocks cannot be encrypted
+    }
+    /**
+     * Whether the block can be decrypted
+     */
+    get canDecrypt() {
+        return false; // Random blocks cannot be decrypted
+    }
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData() {
+        // Random blocks don't have any layer-specific header data
+        return Buffer.alloc(0);
+    }
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData() {
+        return Buffer.concat([super.fullHeaderData, this.layerHeaderData]);
+    }
+    /**
+     * Convert a Readable stream to a Buffer
+     * @param readable - The readable stream to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    static async streamToBuffer(readable) {
+        const chunks = [];
+        for await (const chunk of readable) {
+            chunks.push(Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks);
+    }
+    /**
+     * Convert data to Buffer regardless of whether it's a Readable or Buffer
+     * @param data - The data to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    static async toBuffer(data) {
+        if (Buffer.isBuffer(data) || data instanceof Uint8Array) {
+            return Buffer.from(data);
+        }
+        return RandomBlock.streamToBuffer(data);
+    }
+    /**
+     * XOR this block with another block
+     */
+    async xor(other) {
+        if (this.blockSize !== other.blockSize) {
+            throw new Error('Block sizes must match');
+        }
+        const thisData = await RandomBlock.toBuffer(this.data);
+        const otherData = await RandomBlock.toBuffer(other.data);
+        const result = Buffer.alloc(thisData.length);
+        for (let i = 0; i < thisData.length; i++) {
+            result[i] = thisData[i] ^ otherData[i];
+        }
+        // Create a new instance of the same type as the input block
+        const Constructor = other.constructor;
+        return new Constructor(this.blockSize, result, new Date(), service_provider_1.ServiceProvider.getInstance().checksumService.calculateChecksum(result), this.canRead && other.canRead, this.canPersist && other.canPersist);
+    }
+}
+exports.RandomBlock = RandomBlock;
+//# sourceMappingURL=random.js.map

package/src/lib/blocks/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/random.ts"],"names":[],"mappings":";;;AACA,mCAAqC;AAErC,iEAA8D;AAE9D,yDAAsD;AACtD,mEAA+D;AAE/D,uCAAyC;AAEzC;;;;GAIG;AACH,MAAa,WAAY,SAAQ,sBAAY;IAC3C,YACE,SAAoB,EACpB,IAAY,EACZ,WAAkB,EAClB,QAA6B;QAE7B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,CACH,SAAS,EACT,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,qBAAS,CAAC,MAAM,EAChB,6BAAa,CAAC,OAAO,EACrB,IAAI,EAAE,UAAU;QAChB,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,GAAG,CAAC,SAAoB,EAAE,WAAkB;QACxD,MAAM,IAAI,GAAG,IAAA,oBAAW,EAAC,SAAmB,CAAC,CAAC;QAC9C,OAAO,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,YAAY,CACxB,SAAoB,EACpB,IAAY,EACZ,WAAkB,EAClB,QAA6B;QAE7B,OAAO,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,IAAoB,SAAS;QAC3B,OAAO,qBAAS,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAoB,aAAa;QAC/B,OAAO,6BAAa,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAoB,UAAU;QAC5B,OAAO,KAAK,CAAC,CAAC,oCAAoC;IACpD,CAAC;IAED;;OAEG;IACH,IAAoB,UAAU;QAC5B,OAAO,KAAK,CAAC,CAAC,oCAAoC;IACpD,CAAC;IAED;;OAEG;IACH,IAAoB,eAAe;QACjC,0DAA0D;QAC1D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAoB,cAAc;QAChC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,QAAkB;QACpD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAA2B;QACvD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;YACxD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,GAAG,CAAsB,KAAQ;QAC5C,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,4DAA4D;QAC5D,MAAM,WAAW,GAAG,KAAK,CAAC,WAOpB,CAAC;QAEP,OAAO,IAAI,WAAW,CACpB,IAAI,CAAC,SAAS,EACd,MAAM,EACN,IAAI,IAAI,EAAE,EACV,kCAAe,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,MAAM,CAAC,EACvE,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAC7B,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CACpC,CAAC;IACJ,CAAC;CACF;AAlJD,kCAkJC"}

package/src/lib/blocks/rawData.d.ts

@@ -0,0 +1,69 @@
+import { ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { BaseBlock } from './base';
+/**
+ * RawDataBlock represents a block containing raw, unencrypted data.
+ * It provides basic data storage and validation capabilities.
+ */
+export declare class RawDataBlock extends BaseBlock {
+    private readonly _data;
+    constructor(blockSize: BlockSize, data: Uint8Array, dateCreated?: Date, checksum?: ChecksumUint8Array, blockType?: BlockType, blockDataType?: BlockDataType, canRead?: boolean, canPersist?: boolean);
+    /**
+     * The raw data in the block
+     */
+    get data(): Uint8Array;
+    /**
+     * The data in the block, excluding any metadata or other overhead
+     */
+    get layerPayload(): Uint8Array;
+    get layerOverheadSize(): number;
+    get layerPayloadSize(): number;
+    get layerData(): Uint8Array;
+    /**
+     * The actual length of the data
+     */
+    get lengthBeforeEncryption(): number;
+    /**
+     * Whether the block is encrypted
+     */
+    get encrypted(): boolean;
+    /**
+     * Whether the block can be encrypted
+     */
+    get canEncrypt(): boolean;
+    /**
+     * Whether the block can be decrypted
+     */
+    get canDecrypt(): boolean;
+    /**
+     * Internal validation logic
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    protected validateInternal(): void;
+    /**
+     * Synchronously validate the block's data
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validateSync(): void;
+    /**
+     * Asynchronously validate the block's data
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validateAsync(): Promise<void>;
+    /**
+     * Alias for validateSync() to maintain compatibility
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validate(): void;
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData(): Buffer;
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData(): Buffer;
+}
+//# sourceMappingURL=rawData.d.ts.map

package/src/lib/blocks/rawData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawData.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/rawData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;GAGG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAGjC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,IAAI,EAClB,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,SAAS,GAAE,SAA6B,EACxC,aAAa,GAAE,aAAqC,EACpD,OAAO,UAAO,EACd,UAAU,UAAO;IAoCnB;;OAEG;IACH,IAAoB,IAAI,IAAI,UAAU,CAKrC;IAED;;OAEG;IACH,IAAoB,YAAY,IAAI,UAAU,CAM7C;IAED,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,SAAS,IAAI,UAAU,CAKjC;IAED;;OAEG;IACH,IAAW,sBAAsB,IAAI,MAAM,CAE1C;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAWlC;;;OAGG;IACa,YAAY,IAAI,IAAI;IAIpC;;;OAGG;IACmB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpD;;;OAGG;IACa,QAAQ,IAAI,IAAI;IAIhC;;OAEG;IACH,IAAoB,eAAe,IAAI,MAAM,CAG5C;IAED;;OAEG;IACH,IAAoB,cAAc,IAAI,MAAM,CAE3C;CACF"}

package/src/lib/blocks/rawData.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RawDataBlock = void 0;
+const blockMetadata_1 = require("../blockMetadata");
+const blockAccessErrorType_1 = require("../enumerations/blockAccessErrorType");
+const blockDataType_1 = require("../enumerations/blockDataType");
+const blockType_1 = require("../enumerations/blockType");
+const block_1 = require("../errors/block");
+const checksumMismatch_1 = require("../errors/checksumMismatch");
+const serviceLocator_1 = require("../services/serviceLocator");
+const base_1 = require("./base");
+/**
+ * RawDataBlock represents a block containing raw, unencrypted data.
+ * It provides basic data storage and validation capabilities.
+ */
+class RawDataBlock extends base_1.BaseBlock {
+    constructor(blockSize, data, dateCreated, checksum, blockType = blockType_1.BlockType.RawData, blockDataType = blockDataType_1.BlockDataType.RawData, canRead = true, canPersist = true) {
+        if (!data) {
+            throw new Error('Data cannot be null or undefined');
+        }
+        const now = new Date();
+        if (data.length > blockSize) {
+            throw new Error(`Data length (${data.length}) exceeds block size (${blockSize})`);
+        }
+        const calculatedChecksum = serviceLocator_1.ServiceLocator.getServiceProvider().checksumService.calculateChecksum(data);
+        const metadata = new blockMetadata_1.BlockMetadata(blockSize, blockType, blockDataType, data.length, dateCreated ?? now);
+        super(blockType, blockDataType, checksum ?? calculatedChecksum, metadata, canRead, canPersist);
+        this._data = data;
+    }
+    /**
+     * The raw data in the block
+     */
+    get data() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        return this._data;
+    }
+    /**
+     * The data in the block, excluding any metadata or other overhead
+     */
+    get layerPayload() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        // For raw data blocks, the payload is the entire data
+        return this._data;
+    }
+    get layerOverheadSize() {
+        return 0;
+    }
+    get layerPayloadSize() {
+        return this._data.length;
+    }
+    get layerData() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        return this._data;
+    }
+    /**
+     * The actual length of the data
+     */
+    get lengthBeforeEncryption() {
+        return this._data.length;
+    }
+    /**
+     * Whether the block is encrypted
+     */
+    get encrypted() {
+        return false;
+    }
+    /**
+     * Whether the block can be encrypted
+     */
+    get canEncrypt() {
+        return false;
+    }
+    /**
+     * Whether the block can be decrypted
+     */
+    get canDecrypt() {
+        return false;
+    }
+    /**
+     * Internal validation logic
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validateInternal() {
+        const calculatedChecksum = serviceLocator_1.ServiceLocator.getServiceProvider().checksumService.calculateChecksum(this._data);
+        if (!Buffer.from(calculatedChecksum).equals(Buffer.from(this.idChecksum))) {
+            throw new checksumMismatch_1.ChecksumMismatchError(this.idChecksum, calculatedChecksum);
+        }
+    }
+    /**
+     * Synchronously validate the block's data
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validateSync() {
+        this.validateInternal();
+    }
+    /**
+     * Asynchronously validate the block's data
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    async validateAsync() {
+        this.validateInternal();
+    }
+    /**
+     * Alias for validateSync() to maintain compatibility
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validate() {
+        this.validateSync();
+    }
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData() {
+        // Raw data blocks don't have any layer-specific header data
+        return Buffer.alloc(0);
+    }
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData() {
+        return Buffer.concat([super.fullHeaderData, this.layerHeaderData]);
+    }
+}
+exports.RawDataBlock = RawDataBlock;
+//# sourceMappingURL=rawData.js.map

package/src/lib/blocks/rawData.js.map

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

package/src/lib/blocks/whitened.d.ts

@@ -0,0 +1,69 @@
+import { ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { BaseBlock } from './base';
+import { RawDataBlock } from './rawData';
+/**
+ * WhitenedBlock represents a block that has been XORed with random data.
+ * In the Owner Free Filesystem (OFF), whitened blocks are used to:
+ * 1. Obscure data by XORing with random blocks
+ * 2. Enable data recovery through XOR operations
+ * 3. Provide privacy without encryption overhead
+ */
+export declare class WhitenedBlock extends RawDataBlock {
+    constructor(blockSize: BlockSize, data: Buffer, checksum?: ChecksumUint8Array, dateCreated?: Date, canRead?: boolean, canPersist?: boolean);
+    /**
+     * The type of the block
+     */
+    get blockType(): BlockType;
+    /**
+     * The type of data in the block
+     */
+    get blockDataType(): BlockDataType;
+    /**
+     * The data in the block, excluding any metadata or other overhead
+     */
+    get layerPayload(): Buffer;
+    /**
+     * Whether the block can be encrypted
+     */
+    get canEncrypt(): boolean;
+    /**
+     * Whether the block can be decrypted
+     */
+    get canDecrypt(): boolean;
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData(): Buffer;
+    /**
+     * Convert a Readable stream to a Buffer
+     * @param readable - The readable stream to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    private static streamToBuffer;
+    /**
+     * Convert data to Buffer regardless of whether it's a Readable or Buffer
+     * @param data - The data to convert
+     * @returns Promise that resolves to a Buffer
+     */
+    private static toBuffer;
+    /**
+     * XOR this block with another block
+     */
+    xor<T extends BaseBlock>(other: T): Promise<T>;
+    /**
+     * Get this layer's header data
+     */
+    get layerHeaderData(): Buffer;
+    /**
+     * Create a new whitened block by XORing data with random data
+     */
+    static fromData(blockSize: BlockSize, data: Buffer, randomData: Buffer): WhitenedBlock;
+    /**
+     * Create a new whitened block with specified length metadata
+     */
+    static from(blockSize: BlockSize, data: Buffer, checksum?: ChecksumUint8Array, dateCreated?: Date, lengthWithoutPadding?: number, canRead?: boolean, canPersist?: boolean): Promise<WhitenedBlock>;
+}
+//# sourceMappingURL=whitened.d.ts.map