@brightchain/brightchain-lib 0.1.0

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

@@ -0,0 +1,140 @@
+import { ChecksumString, ChecksumUint8Array } from '@digitaldefiance/ecies-lib';
+import { Readable } from 'stream';
+import { BlockMetadata } from '../blockMetadata';
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { IBaseBlock } from '../interfaces/blocks/base';
+/**
+ * BaseBlock provides core block functionality.
+ * All blocks in the Owner Free File System derive from this.
+ *
+ * Block Structure:
+ * [Base Header][Layer Headers][Layer Data][Padding]
+ *
+ * Base Header:
+ * - Block Type
+ * - Block Size
+ * - Data Type
+ * - Checksum
+ * - Date Created
+ */
+export declare abstract class BaseBlock implements IBaseBlock {
+    protected readonly _blockSize: BlockSize;
+    protected readonly _blockType: BlockType;
+    protected readonly _blockDataType: BlockDataType;
+    protected readonly _checksum: ChecksumUint8Array;
+    protected readonly _dateCreated: Date;
+    protected readonly _metadata: BlockMetadata;
+    protected readonly _canRead: boolean;
+    protected readonly _canPersist: boolean;
+    protected readonly _lengthBeforeEncryption: number;
+    /**
+     * Constructs a block.
+     * All derived constructors should trust the data being passed in as relevant to the type of block.
+     * Blocks types that can validate the data are welcome to do so.
+     * @param type Block type
+     * @param dataType Data type
+     * @param checksum Checksum
+     * @param metadata Metadata
+     * @param canRead Whether the block can be read
+     * @param canPersist Whether the block can be persisted
+     */
+    protected constructor(type: BlockType, dataType: BlockDataType, checksum: ChecksumUint8Array, metadata: BlockMetadata, canRead?: boolean, canPersist?: boolean);
+    /**
+     * The size category of the block
+     */
+    get blockSize(): BlockSize;
+    /**
+     * The type of block (raw, encrypted, CBL, etc)
+     */
+    get blockType(): BlockType;
+    /**
+     * The type of data contained in the block
+     */
+    get blockDataType(): BlockDataType;
+    /**
+     * The block's unique identifier/checksum
+     */
+    get idChecksum(): ChecksumUint8Array;
+    /**
+     * The block's checksum as a string
+     */
+    get checksumString(): ChecksumString;
+    /**
+     * When the block was created
+     */
+    get dateCreated(): Date;
+    /**
+     * Block metadata for storage
+     */
+    get metadata(): BlockMetadata;
+    /**
+     * Whether the block can be read
+     */
+    get canRead(): boolean;
+    /**
+     * Whether the block can be persisted
+     */
+    get canPersist(): boolean;
+    /**
+     * Asynchronously validate the block's checksum and data integrity
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    abstract validateAsync(): Promise<void>;
+    /**
+     * Synchronously validate the block's checksum and data integrity
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    abstract validateSync(): void;
+    /**
+     * Alias for validateSync() to maintain compatibility
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validate(): void;
+    /**
+     * Get the complete block data including headers and payload
+     */
+    abstract get data(): Uint8Array | Readable;
+    /**
+     * Get this layer's header data size
+     */
+    abstract get layerOverheadSize(): number;
+    /**
+     * Get this layer's header data
+     */
+    abstract get layerHeaderData(): Uint8Array;
+    /**
+     * Get this layer's data (including headers)
+     */
+    abstract get layerData(): Uint8Array;
+    /**
+     * Get the payload data (excluding headers)
+     */
+    abstract get layerPayload(): Uint8Array;
+    /**
+     * Get the length of the payload
+     */
+    abstract get layerPayloadSize(): number;
+    /**
+     * Get all layers in the inheritance chain
+     */
+    get layers(): IBaseBlock[];
+    /**
+     * Get the total header size of all layers below this one
+     */
+    get lowerLayerHeaderSize(): number;
+    /**
+     * Get the parent layer in the inheritance chain
+     */
+    get parent(): IBaseBlock | null;
+    /**
+     * Get the total header overhead from all layers
+     */
+    get totalOverhead(): number;
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData(): Uint8Array;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAqB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD;;;;;;;;;;;;;GAaG;AACH,8BAAsB,SAAU,YAAW,UAAU;IACnD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAEzC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IACxC,SAAS,CAAC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IAEnD;;;;;;;;;;OAUG;IACH,SAAS,aACP,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,aAAa,EACvB,OAAO,UAAO,EACd,UAAU,UAAO;IA+BnB;;OAEG;IACH,IAAW,SAAS,IAAI,SAAS,CAEhC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,SAAS,CAEhC;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,aAAa,CAExC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,kBAAkB,CAE1C;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,CAI1C;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,IAAI,CAE7B;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,aAAa,CAEnC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED;;;OAGG;aACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9C;;;OAGG;aACa,YAAY,IAAI,IAAI;IAEpC;;;OAGG;IACI,QAAQ,IAAI,IAAI;IAIvB;;OAEG;IACH,aAAoB,IAAI,IAAI,UAAU,GAAG,QAAQ,CAAC;IAElD;;OAEG;IACH,aAAoB,iBAAiB,IAAI,MAAM,CAAC;IAEhD;;OAEG;IACH,aAAoB,eAAe,IAAI,UAAU,CAAC;IAElD;;OAEG;IACH,aAAoB,SAAS,IAAI,UAAU,CAAC;IAE5C;;OAEG;IACH,aAAoB,YAAY,IAAI,UAAU,CAAC;IAE/C;;OAEG;IACH,aAAoB,gBAAgB,IAAI,MAAM,CAAC;IAE/C;;OAEG;IACH,IAAW,MAAM,IAAI,UAAU,EAAE,CAMhC;IAED;;OAEG;IACH,IAAW,oBAAoB,IAAI,MAAM,CAUxC;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,UAAU,GAAG,IAAI,CAGrC;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,CAUjC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,UAAU,CAatC;CACF"}

package/src/lib/blocks/base.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseBlock = void 0;
+const blockAccessErrorType_1 = require("../enumerations/blockAccessErrorType");
+const blockSize_1 = require("../enumerations/blockSize");
+const blockValidationErrorType_1 = require("../enumerations/blockValidationErrorType");
+const block_1 = require("../errors/block");
+const serviceLocator_1 = require("../services/serviceLocator");
+/**
+ * BaseBlock provides core block functionality.
+ * All blocks in the Owner Free File System derive from this.
+ *
+ * Block Structure:
+ * [Base Header][Layer Headers][Layer Data][Padding]
+ *
+ * Base Header:
+ * - Block Type
+ * - Block Size
+ * - Data Type
+ * - Checksum
+ * - Date Created
+ */
+class BaseBlock {
+    /**
+     * Constructs a block.
+     * All derived constructors should trust the data being passed in as relevant to the type of block.
+     * Blocks types that can validate the data are welcome to do so.
+     * @param type Block type
+     * @param dataType Data type
+     * @param checksum Checksum
+     * @param metadata Metadata
+     * @param canRead Whether the block can be read
+     * @param canPersist Whether the block can be persisted
+     */
+    constructor(type, dataType, checksum, metadata, canRead = true, canPersist = true) {
+        // Validate block size
+        if (!metadata.size || !(0, blockSize_1.validateBlockSize)(metadata.size)) {
+            throw new block_1.BlockValidationError(blockValidationErrorType_1.BlockValidationErrorType.BlockSizeNegative);
+        }
+        // Validate date first
+        const now = new Date();
+        this._dateCreated = metadata ? new Date(metadata?.dateCreated) : now;
+        if (this._dateCreated > now) {
+            throw new block_1.BlockValidationError(blockValidationErrorType_1.BlockValidationErrorType.FutureCreationDate);
+        }
+        // Store basic properties
+        this._blockSize = metadata.size;
+        this._blockType = type;
+        this._blockDataType = dataType;
+        this._canRead = canRead;
+        this._canPersist = canPersist;
+        this._checksum = checksum;
+        this._lengthBeforeEncryption = metadata.lengthWithoutPadding;
+        // Store or create metadata
+        this._metadata = metadata;
+    }
+    /**
+     * The size category of the block
+     */
+    get blockSize() {
+        return this._blockSize;
+    }
+    /**
+     * The type of block (raw, encrypted, CBL, etc)
+     */
+    get blockType() {
+        return this._blockType;
+    }
+    /**
+     * The type of data contained in the block
+     */
+    get blockDataType() {
+        return this._blockDataType;
+    }
+    /**
+     * The block's unique identifier/checksum
+     */
+    get idChecksum() {
+        return this._checksum;
+    }
+    /**
+     * The block's checksum as a string
+     */
+    get checksumString() {
+        return serviceLocator_1.ServiceLocator.getServiceProvider().checksumService.checksumToHexString(this.idChecksum);
+    }
+    /**
+     * When the block was created
+     */
+    get dateCreated() {
+        return this._dateCreated;
+    }
+    /**
+     * Block metadata for storage
+     */
+    get metadata() {
+        return this._metadata;
+    }
+    /**
+     * Whether the block can be read
+     */
+    get canRead() {
+        return this._canRead;
+    }
+    /**
+     * Whether the block can be persisted
+     */
+    get canPersist() {
+        return this._canPersist;
+    }
+    /**
+     * Alias for validateSync() to maintain compatibility
+     * @throws {ChecksumMismatchError} If validation fails due to checksum mismatch
+     */
+    validate() {
+        return this.validateSync();
+    }
+    /**
+     * Get all layers in the inheritance chain
+     */
+    get layers() {
+        const collectLayers = (block) => {
+            const parent = block.parent;
+            return parent ? [...collectLayers(parent), block] : [block];
+        };
+        return collectLayers(this);
+    }
+    /**
+     * Get the total header size of all layers below this one
+     */
+    get lowerLayerHeaderSize() {
+        const layers = this.layers;
+        const currentLayerIndex = layers.indexOf(this);
+        if (currentLayerIndex === -1) {
+            throw new Error('Current layer not found in layers');
+        }
+        return layers.slice(0, currentLayerIndex).reduce((sum, layer) => {
+            return sum + layer.layerOverheadSize;
+        }, 0);
+    }
+    /**
+     * Get the parent layer in the inheritance chain
+     */
+    get parent() {
+        const proto = Object.getPrototypeOf(this);
+        return proto === BaseBlock.prototype ? null : proto;
+    }
+    /**
+     * Get the total header overhead from all layers
+     */
+    get totalOverhead() {
+        // For base implementation, we don't need to check canRead since we're just calculating overhead
+        return this.layers.reduce((sum, layer) => {
+            try {
+                return sum + layer.layerHeaderData.length;
+            }
+            catch {
+                // If we can't read header data, assume no overhead for that layer
+                return sum;
+            }
+        }, 0);
+    }
+    /**
+     * Get the complete header data from all layers
+     */
+    get fullHeaderData() {
+        if (!this.canRead) {
+            throw new block_1.BlockAccessError(blockAccessErrorType_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        const headers = this.layers.map((layer) => layer.layerHeaderData);
+        const totalLength = headers.reduce((sum, arr) => sum + arr.length, 0);
+        const result = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const arr of headers) {
+            result.set(arr, offset);
+            offset += arr.length;
+        }
+        return result;
+    }
+}
+exports.BaseBlock = BaseBlock;
+//# sourceMappingURL=base.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { ChecksumString, HexString } from '@digitaldefiance/ecies-lib';
+import { IBasicDataObjectDTO } from '../interfaces/basicDataObjectDto';
+export interface BlockDto extends IBasicDataObjectDTO {
+    id: ChecksumString;
+    data: HexString;
+    dateCreated: Date;
+}
+//# sourceMappingURL=blockDto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockDto.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/blockDto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,WAAW,QAAS,SAAQ,mBAAmB;IACnD,EAAE,EAAE,cAAc,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;CACnB"}

package/src/lib/blocks/blockDto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=blockDto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockDto.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/blockDto.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,21 @@
+import { BlockDataType } from '../enumerations/blockDataType';
+import { BlockSize } from '../enumerations/blockSize';
+import { BlockType } from '../enumerations/blockType';
+import { IBaseBlockMetadata } from '../interfaces/blocks/metadata/blockMetadata';
+/**
+ * Concrete implementation of IBlockMetadata
+ */
+export declare class BlockMetadata implements IBaseBlockMetadata {
+    private readonly _size;
+    private readonly _type;
+    private readonly _dataType;
+    private readonly _lengthWithoutPadding;
+    private readonly _dateCreated;
+    constructor(_size: BlockSize, _type: BlockType, _dataType: BlockDataType, _lengthWithoutPadding: number, _dateCreated: Date);
+    get size(): BlockSize;
+    get type(): BlockType;
+    get dataType(): BlockDataType;
+    get lengthWithoutPadding(): number;
+    get dateCreated(): Date;
+}
+//# sourceMappingURL=blockMetadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockMetadata.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/blockMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEjF;;GAEG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IAEpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAJZ,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,qBAAqB,EAAE,MAAM,EAC7B,YAAY,EAAE,IAAI;IAGrC,IAAW,IAAI,IAAI,SAAS,CAE3B;IAED,IAAW,IAAI,IAAI,SAAS,CAE3B;IAED,IAAW,QAAQ,IAAI,aAAa,CAEnC;IAED,IAAW,oBAAoB,IAAI,MAAM,CAExC;IAED,IAAW,WAAW,IAAI,IAAI,CAE7B;CACF"}

package/src/lib/blocks/blockMetadata.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockMetadata = void 0;
+/**
+ * Concrete implementation of IBlockMetadata
+ */
+class BlockMetadata {
+    constructor(_size, _type, _dataType, _lengthWithoutPadding, _dateCreated) {
+        this._size = _size;
+        this._type = _type;
+        this._dataType = _dataType;
+        this._lengthWithoutPadding = _lengthWithoutPadding;
+        this._dateCreated = _dateCreated;
+    }
+    get size() {
+        return this._size;
+    }
+    get type() {
+        return this._type;
+    }
+    get dataType() {
+        return this._dataType;
+    }
+    get lengthWithoutPadding() {
+        return this._lengthWithoutPadding;
+    }
+    get dateCreated() {
+        return new Date(this._dateCreated.getTime());
+    }
+}
+exports.BlockMetadata = BlockMetadata;
+//# sourceMappingURL=blockMetadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockMetadata.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/blockMetadata.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH,MAAa,aAAa;IACxB,YACmB,KAAgB,EAChB,KAAgB,EAChB,SAAwB,EACxB,qBAA6B,EAC7B,YAAkB;QAJlB,UAAK,GAAL,KAAK,CAAW;QAChB,UAAK,GAAL,KAAK,CAAW;QAChB,cAAS,GAAT,SAAS,CAAe;QACxB,0BAAqB,GAArB,qBAAqB,CAAQ;QAC7B,iBAAY,GAAZ,YAAY,CAAM;IAClC,CAAC;IAEJ,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAW,oBAAoB;QAC7B,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF;AA5BD,sCA4BC"}

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

@@ -0,0 +1,29 @@
+import { type PlatformID } from '@digitaldefiance/ecies-lib';
+import { IConstituentBlockListBlock } from '../interfaces/blocks/cbl';
+import { CBLBase } from './cblBase';
+/**
+ * Constituent Block List
+ *
+ * Header Structure:
+ * [CreatorId][DateCreated][AddressCount][TupleSize][OriginalDataLength][OriginalDataChecksum][CreatorSignature]
+ * Followed by:
+ * [Address Data][Padding]
+ *
+ * The signature is placed at the end of the header and signs both the header fields
+ * and the address data that follows, ensuring integrity of the entire structure.
+ */
+export declare class ConstituentBlockListBlock<TID extends PlatformID = Uint8Array> extends CBLBase<TID> implements IConstituentBlockListBlock<TID> {
+    /**
+     * Get the maximum number of addresses that can be stored in a CBL block.
+     * Does not account for encryption overhead.
+     * @returns The maximum number of addresses
+     */
+    get addressCapacity(): number;
+    /**
+     * Get the maximum number of addresses that can be stored in an encrypted CBL block.
+     * Accounts for encryption overhead.
+     * @returns The maximum number of addresses
+     */
+    get encryptedAddressCapacity(): number;
+}
+//# sourceMappingURL=cbl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cbl.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/cbl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,qBAAa,yBAAyB,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,CACxE,SAAQ,OAAO,CAAC,GAAG,CACnB,YAAW,0BAA0B,CAAC,GAAG,CAAC;IAE1C;;;;OAIG;IACH,IAAW,eAAe,IAAI,MAAM,CAKnC;IAED;;;;OAIG;IACH,IAAW,wBAAwB,IAAI,MAAM,CAK5C;CACF"}

package/src/lib/blocks/cbl.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstituentBlockListBlock = void 0;
+const blockEncryptionType_1 = require("../enumerations/blockEncryptionType");
+const serviceLocator_1 = require("../services/serviceLocator");
+const cblBase_1 = require("./cblBase");
+/**
+ * Constituent Block List
+ *
+ * Header Structure:
+ * [CreatorId][DateCreated][AddressCount][TupleSize][OriginalDataLength][OriginalDataChecksum][CreatorSignature]
+ * Followed by:
+ * [Address Data][Padding]
+ *
+ * The signature is placed at the end of the header and signs both the header fields
+ * and the address data that follows, ensuring integrity of the entire structure.
+ */
+class ConstituentBlockListBlock extends cblBase_1.CBLBase {
+    /**
+     * Get the maximum number of addresses that can be stored in a CBL block.
+     * Does not account for encryption overhead.
+     * @returns The maximum number of addresses
+     */
+    get addressCapacity() {
+        return serviceLocator_1.ServiceLocator.getServiceProvider().cblService.calculateCBLAddressCapacity(this.blockSize, blockEncryptionType_1.BlockEncryptionType.None);
+    }
+    /**
+     * Get the maximum number of addresses that can be stored in an encrypted CBL block.
+     * Accounts for encryption overhead.
+     * @returns The maximum number of addresses
+     */
+    get encryptedAddressCapacity() {
+        return serviceLocator_1.ServiceLocator.getServiceProvider().cblService.calculateCBLAddressCapacity(this.blockSize, blockEncryptionType_1.BlockEncryptionType.SingleRecipient);
+    }
+}
+exports.ConstituentBlockListBlock = ConstituentBlockListBlock;
+//# sourceMappingURL=cbl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cbl.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/cbl.ts"],"names":[],"mappings":";;;AACA,6EAA0E;AAE1E,+DAA4D;AAC5D,uCAAoC;AAEpC;;;;;;;;;;GAUG;AACH,MAAa,yBACX,SAAQ,iBAAY;IAGpB;;;;OAIG;IACH,IAAW,eAAe;QACxB,OAAO,+BAAc,CAAC,kBAAkB,EAAE,CAAC,UAAU,CAAC,2BAA2B,CAC/E,IAAI,CAAC,SAAS,EACd,yCAAmB,CAAC,IAAI,CACzB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAW,wBAAwB;QACjC,OAAO,+BAAc,CAAC,kBAAkB,EAAE,CAAC,UAAU,CAAC,2BAA2B,CAC/E,IAAI,CAAC,SAAS,EACd,yCAAmB,CAAC,eAAe,CACpC,CAAC;IACJ,CAAC;CACF;AA3BD,8DA2BC"}

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

@@ -0,0 +1,89 @@
+import { ChecksumUint8Array, Member, SignatureUint8Array, type PlatformID } from '@digitaldefiance/ecies-lib';
+import { ICBLCore } from '../interfaces/blocks/cblBase';
+import { EphemeralBlock } from './ephemeral';
+import { BlockHandleTuple } from './handleTuple';
+import { RawDataBlock } from './rawData';
+/**
+ * Shared core functionality between CBL/ECBL
+ */
+export declare abstract class CBLBase<TID extends PlatformID = Uint8Array> extends EphemeralBlock<TID> implements ICBLCore<TID> {
+    /** Cache for validated headers */
+    private static validatedHeaderCache;
+    /** Cache for address count to avoid circular dependency */
+    private _cachedAddressCount;
+    /**
+     * Create a new CBL core
+     * @param data The data of the CBL
+     */
+    constructor(data: Uint8Array, creator: Member<TID>);
+    /**
+     * Ensure the header has been validated. If not and a creator is available,
+     * validate it and cache the result. Otherwise, throw an error.
+     */
+    protected ensureHeaderValidated(): void;
+    /**
+     * Validate the signature of the CBL header
+     */
+    get headerValidated(): boolean;
+    /**
+     * The number of addresses in the CBL
+     */
+    get cblAddressCount(): number;
+    /**
+     * The length of the original data represented by the CBL
+     */
+    get originalDataLength(): number;
+    /**
+     * The size of each address tuple in bytes
+     */
+    get tupleSize(): number;
+    /**
+     * Whether the CBL has an extended header
+     */
+    get isExtendedCbl(): boolean;
+    /**
+     * The signature of the creator of the CBL
+     */
+    get creatorSignature(): SignatureUint8Array;
+    /**
+     * The ID of the creator of the CBL
+     */
+    get creatorId(): TID;
+    /**
+     * The data that follows the header in the CBL
+     */
+    get addressData(): Uint8Array;
+    /**
+     * The addresses in the CBL
+     */
+    get addresses(): ChecksumUint8Array[];
+    /**
+     * The address data for the CBL.
+     */
+    get layerPayload(): Uint8Array;
+    get totalOverhead(): number;
+    /**
+     * Validate the CBL structure and metadata
+     */
+    validateSync(): void;
+    /**
+     * Validate the CBL structure and metadata, async
+     */
+    validateAsync(): Promise<void>;
+    /**
+     * Validate the signature of the creator of the CBL
+     * @param creator
+     */
+    validateSignature(): boolean;
+    /**
+     * Get the layer header data from the CBL
+     */
+    get layerHeaderData(): Uint8Array;
+    /**
+     * Get Block Handle Tuples for the CBL block
+     */
+    getHandleTuples(blockStore: {
+        getData(key: ChecksumUint8Array): Promise<RawDataBlock>;
+    }): Promise<Array<BlockHandleTuple>>;
+}
+//# sourceMappingURL=cblBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cblBase.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/cblBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,MAAM,EACN,mBAAmB,EACnB,KAAK,UAAU,EAChB,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,8BAAsB,OAAO,CAAC,GAAG,SAAS,UAAU,GAAG,UAAU,CAC/D,SAAQ,cAAc,CAAC,GAAG,CAC1B,YAAW,QAAQ,CAAC,GAAG,CAAC;IAExB,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAsC;IAEzE,2DAA2D;IAC3D,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;OAGG;gBACS,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;IA4ElD;;;OAGG;IACH,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAcvC;;OAEG;IACH,IAAW,eAAe,IAAI,OAAO,CAUpC;IAED;;OAEG;IACH,IAAW,eAAe,IAAI,MAAM,CAYnC;IAED;;OAEG;IACH,IAAW,kBAAkB,IAAI,MAAM,CAKtC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAK7B;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,OAAO,CAKlC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,mBAAmB,CAKjD;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,GAAG,CAK1B;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,UAAU,CAKnC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,kBAAkB,EAAE,CAK3C;IAED;;OAEG;IACH,IAAoB,YAAY,IAAI,UAAU,CAE7C;IAED,IAAoB,aAAa,IAAI,MAAM,CAO1C;IAED;;OAEG;IACa,YAAY,IAAI,IAAI;IAapC;;OAEG;IACmB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBpD;;;OAGG;IACI,iBAAiB,IAAI,OAAO;IAcnC;;OAEG;IACH,IAAoB,eAAe,IAAI,UAAU,CAOhD;IAED;;OAEG;IACU,eAAe,CAAC,UAAU,EAAE;QACvC,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KACzD,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;CA0BrC"}