@brightchain/brightchain-lib 0.21.1 → 0.23.0

package/README.md

@@ -354,6 +354,72 @@ const capacity = cblService.calculateCBLAddressCapacity(
 console.log(`CBL can hold ${capacity} block references`);
 ```
 
+### TCBL Archives (Tarball CBL)
+
+TCBL is a tarball-like archive format built on top of CBL. It bundles multiple files into a single block with a manifest, supporting optional bzip2 compression and external ECIES encryption via the `EncryptedBlock` wrapper.
+
+#### Building a TCBL Archive
+
+```typescript
+import {
+  TcblBuilder,
+  TcblReader,
+  BlockSize,
+} from '@brightchain/brightchain-lib';
+
+// Create a builder
+const builder = new TcblBuilder(creator, BlockSize.Small, blockStore);
+
+// Add entries
+await builder.addEntry({
+  fileName: 'readme.txt',
+  mimeType: 'text/plain',
+  data: new TextEncoder().encode('Hello, TCBL!'),
+});
+await builder.addEntry({
+  fileName: 'config.json',
+  mimeType: 'application/json',
+  data: new TextEncoder().encode('{"key": "value"}'),
+});
+
+// Build the archive (with optional compression)
+const tcblBlock = await builder.build();
+```
+
+#### Reading a TCBL Archive
+
+```typescript
+// Open the archive for reading
+const reader = new TcblReader(tcblBlock, blockStore);
+await reader.open();
+
+// List entries without extracting data
+const entries = reader.listEntries();
+for (const entry of entries) {
+  console.log(`${entry.fileName} (${entry.mimeType}, ${entry.originalDataLength} bytes)`);
+}
+
+// Extract by name or index
+const data = await reader.getEntryByName('readme.txt');
+const firstEntry = await reader.getEntryByIndex(0);
+```
+
+#### Compression and Encryption
+
+```typescript
+// Enable bzip2 compression
+const builder = new TcblBuilder(creator, BlockSize.Small, blockStore, undefined, {
+  compress: true,
+});
+
+// For encryption, wrap the completed TCBL in an EncryptedBlock
+const tcbl = await builder.build();
+const encrypted = await EncryptedBlockCreator.from(
+  tcbl,
+  recipientPublicKeys,
+);
+```
+
 ### Service Provider Pattern
 
 BrightChain uses a service provider pattern for dependency injection:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightchain/brightchain-lib",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "description": "BrightChain core library - browser-compatible blockchain storage",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -41,7 +41,7 @@
   "author": "Digital Defiance",
   "license": "MIT",
   "dependencies": {
-    "@digitaldefiance/ecies-lib": "^4.19.6",
+    "@digitaldefiance/ecies-lib": "^4.19.13",
     "@digitaldefiance/i18n-lib": "^4.6.4",
     "@noble/hashes": "^1.4.0",
     "nat-pmp": "^1.0.0",

package/src/browser.d.ts

@@ -10,6 +10,8 @@ export { XorLengthMismatchError, constantTimeXor, constantTimeXorMultiple, } fro
 export { ServiceProvider } from './lib/services/service.provider';
 export { initializeBrightChain } from './lib/init';
 export { Checksum } from './lib/types/checksum';
+export { asBlockId } from './lib/interfaces/branded/primitives/blockId';
+export type { BlockId } from './lib/interfaces/branded/primitives/blockId';
 export { CBLService } from './lib/services/cblService';
 export { ChecksumService } from './lib/services/checksum.service';
 export { MessageCBLService } from './lib/services/messaging/messageCBLService';

package/src/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":"AAGA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAGrF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":"AAGA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAC;AACxE,YAAY,EAAE,OAAO,EAAE,MAAM,6CAA6C,CAAC;AAG3E,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAGrF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC"}

package/src/browser.js

@@ -2,7 +2,7 @@
 // Minimal browser-compatible exports
 // Only exports core functionality that works without Node.js modules
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessagePriority = exports.MessageEncryptionScheme = exports.DeliveryStatus = exports.MessageCBLService = exports.ChecksumService = exports.CBLService = exports.Checksum = exports.initializeBrightChain = exports.ServiceProvider = exports.constantTimeXorMultiple = exports.constantTimeXor = exports.XorLengthMismatchError = exports.RawDataBlock = exports.isBlockHandle = exports.createBlockHandle = exports.BaseBlock = void 0;
+exports.MessagePriority = exports.MessageEncryptionScheme = exports.DeliveryStatus = exports.MessageCBLService = exports.ChecksumService = exports.CBLService = exports.asBlockId = exports.Checksum = exports.initializeBrightChain = exports.ServiceProvider = exports.constantTimeXorMultiple = exports.constantTimeXor = exports.XorLengthMismatchError = exports.RawDataBlock = exports.isBlockHandle = exports.createBlockHandle = exports.BaseBlock = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/brightChain"), exports);
 tslib_1.__exportStar(require("./lib/enumerations/blockSize"), exports);
@@ -31,6 +31,9 @@ Object.defineProperty(exports, "initializeBrightChain", { enumerable: true, get:
 // Export Checksum type for working with block IDs
 var checksum_1 = require("./lib/types/checksum");
 Object.defineProperty(exports, "Checksum", { enumerable: true, get: function () { return checksum_1.Checksum; } });
+// Export BlockId branded type and helpers
+var blockId_1 = require("./lib/interfaces/branded/primitives/blockId");
+Object.defineProperty(exports, "asBlockId", { enumerable: true, get: function () { return blockId_1.asBlockId; } });
 // Export services
 var cblService_1 = require("./lib/services/cblService");
 Object.defineProperty(exports, "CBLService", { enumerable: true, get: function () { return cblService_1.CBLService; } });

package/src/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,qEAAqE;;;;AAErE,4DAAkC;AAClC,uEAA6C;AAC7C,4EAAkD;AAClD,8EAAoD;AACpD,wEAA8C;AAE9C,qCAAqC;AACrC,0CAA8C;AAArC,iGAAA,SAAS,OAAA;AAClB,8CAI6B;AAH3B,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AAGf,gDAAoD;AAA3C,uGAAA,YAAY,OAAA;AAErB,0DAA0D;AAC1D,+DAIqC;AAHnC,yHAAA,sBAAsB,OAAA;AACtB,kHAAA,eAAe,OAAA;AACf,0HAAA,uBAAuB,OAAA;AAGzB,4CAA4C;AAC5C,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AAExB,4CAA4C;AAC5C,mCAAmD;AAA1C,6GAAA,qBAAqB,OAAA;AAE9B,kDAAkD;AAClD,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AAEjB,kBAAkB;AAClB,wDAAuD;AAA9C,wGAAA,UAAU,OAAA;AACnB,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AACxB,gFAA+E;AAAtE,sHAAA,iBAAiB,OAAA;AAE1B,wCAAwC;AACxC,8EAA6E;AAApE,gHAAA,cAAc,OAAA;AACvB,gGAA+F;AAAtF,kIAAA,uBAAuB,OAAA;AAChC,gFAA+E;AAAtE,kHAAA,eAAe,OAAA"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../brightchain-lib/src/browser.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,qEAAqE;;;;AAErE,4DAAkC;AAClC,uEAA6C;AAC7C,4EAAkD;AAClD,8EAAoD;AACpD,wEAA8C;AAE9C,qCAAqC;AACrC,0CAA8C;AAArC,iGAAA,SAAS,OAAA;AAClB,8CAI6B;AAH3B,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AAGf,gDAAoD;AAA3C,uGAAA,YAAY,OAAA;AAErB,0DAA0D;AAC1D,+DAIqC;AAHnC,yHAAA,sBAAsB,OAAA;AACtB,kHAAA,eAAe,OAAA;AACf,0HAAA,uBAAuB,OAAA;AAGzB,4CAA4C;AAC5C,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AAExB,4CAA4C;AAC5C,mCAAmD;AAA1C,6GAAA,qBAAqB,OAAA;AAE9B,kDAAkD;AAClD,iDAAgD;AAAvC,oGAAA,QAAQ,OAAA;AAEjB,0CAA0C;AAC1C,uEAAwE;AAA/D,oGAAA,SAAS,OAAA;AAGlB,kBAAkB;AAClB,wDAAuD;AAA9C,wGAAA,UAAU,OAAA;AACnB,oEAAkE;AAAzD,mHAAA,eAAe,OAAA;AACxB,gFAA+E;AAAtE,sHAAA,iBAAiB,OAAA;AAE1B,wCAAwC;AACxC,8EAA6E;AAApE,gHAAA,cAAc,OAAA;AACvB,gGAA+F;AAAtF,kIAAA,uBAAuB,OAAA;AAChC,gFAA+E;AAAtE,kHAAA,eAAe,OAAA"}

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

@@ -14,6 +14,7 @@ export * from './memoryTuple';
 export * from './parity';
 export * from './random';
 export * from './rawData';
+export * from './tcbl';
 export * from './vcbl';
 export * from './whitened';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/src/lib/blocks/index.js

@@ -17,6 +17,7 @@ tslib_1.__exportStar(require("./memoryTuple"), exports);
 tslib_1.__exportStar(require("./parity"), exports);
 tslib_1.__exportStar(require("./random"), exports);
 tslib_1.__exportStar(require("./rawData"), exports);
+tslib_1.__exportStar(require("./tcbl"), exports);
 tslib_1.__exportStar(require("./vcbl"), exports);
 tslib_1.__exportStar(require("./whitened"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB;AACvB,qDAA2B;AAC3B,0DAAgC;AAChC,gDAAsB;AACtB,oDAA0B;AAC1B,sDAA4B;AAC5B,kEAAwC;AACxC,kEAAwC;AACxC,sDAA4B;AAC5B,wDAA8B;AAC9B,mDAAyB;AACzB,wDAA8B;AAC9B,wDAA8B;AAC9B,mDAAyB;AACzB,mDAAyB;AACzB,oDAA0B;AAC1B,iDAAuB;AACvB,qDAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/blocks/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB;AACvB,qDAA2B;AAC3B,0DAAgC;AAChC,gDAAsB;AACtB,oDAA0B;AAC1B,sDAA4B;AAC5B,kEAAwC;AACxC,kEAAwC;AACxC,sDAA4B;AAC5B,wDAA8B;AAC9B,mDAAyB;AACzB,wDAA8B;AAC9B,wDAA8B;AAC9B,mDAAyB;AACzB,mDAAyB;AACzB,oDAA0B;AAC1B,iDAAuB;AACvB,iDAAuB;AACvB,qDAA2B"}

package/src/lib/blocks/tcbl/index.d.ts

@@ -0,0 +1,7 @@
+export * from './manifestSerializer';
+export * from './tcbl';
+export * from './tcblAttachmentUtils';
+export * from './tcblBuilder';
+export * from './tcblReader';
+export * from './tcblValidator';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/blocks/tcbl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/blocks/tcbl/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/src/lib/blocks/tcbl/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./manifestSerializer"), exports);
+tslib_1.__exportStar(require("./tcbl"), exports);
+tslib_1.__exportStar(require("./tcblAttachmentUtils"), exports);
+tslib_1.__exportStar(require("./tcblBuilder"), exports);
+tslib_1.__exportStar(require("./tcblReader"), exports);
+tslib_1.__exportStar(require("./tcblValidator"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/blocks/tcbl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/blocks/tcbl/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,iDAAuB;AACvB,gEAAsC;AACtC,wDAA8B;AAC9B,uDAA6B;AAC7B,0DAAgC"}

package/src/lib/blocks/tcbl/manifestSerializer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview TCBL Manifest Serializer.
+ *
+ * Provides deterministic binary serialization and deserialization of TCBL manifests.
+ * The binary format is:
+ *   - version: uint16 (2 bytes, big-endian)
+ *   - entryCount: uint32 (4 bytes, big-endian)
+ *   - For each entry:
+ *     - fileNameLength: uint16 (2 bytes, big-endian)
+ *     - fileName: UTF-8 bytes (variable)
+ *     - mimeTypeLength: uint8 (1 byte)
+ *     - mimeType: UTF-8 bytes (variable)
+ *     - originalDataLength: uint48 (6 bytes, big-endian)
+ *     - cblAddress: fixed-size checksum bytes (64 bytes for SHA3-512)
+ *   - checksum: 64 bytes (SHA3-512 of all preceding data)
+ *
+ * @see Requirements 3.1, 3.2, 3.3, 3.4, 3.5
+ * @see Requirement 2.5
+ */
+import { ITcblManifest } from '../../interfaces/tcbl/tcblManifest';
+import { Checksum } from '../../types/checksum';
+/**
+ * Static utility class for deterministic binary serialization and
+ * deserialization of TCBL manifests.
+ *
+ * @see Requirement 3
+ */
+export declare class TcblManifestSerializer {
+    /**
+     * Serialize a TCBL manifest into a deterministic binary `Uint8Array`.
+     *
+     * The checksum field on the manifest is ignored during serialization;
+     * a fresh checksum is computed over the entry data and appended.
+     *
+     * @param manifest - The manifest to serialize
+     * @returns The serialized binary representation
+     *
+     * @see Requirements 3.1, 3.5
+     */
+    static serialize(manifest: ITcblManifest): Uint8Array;
+    /**
+     * Deserialize a binary `Uint8Array` back into a TCBL manifest object.
+     *
+     * @param data - The binary data to deserialize
+     * @returns The deserialized manifest
+     * @throws {TcblError} with `ManifestTruncated` if data is too short
+     * @throws {TcblError} with `ManifestCorrupted` if data is structurally invalid
+     *
+     * @see Requirements 3.2, 3.4
+     */
+    static deserialize(data: Uint8Array): ITcblManifest;
+    /**
+     * Compute the manifest checksum over the serialized entry data
+     * (version + entryCount + entries), excluding the checksum itself.
+     *
+     * @param manifest - The manifest to compute the checksum for
+     * @returns The computed checksum
+     *
+     * @see Requirement 2.5
+     */
+    static computeChecksum(manifest: ITcblManifest): Checksum;
+    /**
+     * Write a uint48 value (6 bytes, big-endian) into a DataView.
+     *
+     * @param view - The DataView to write to
+     * @param offset - The byte offset to write at
+     * @param value - The value to write (must be <= 2^48 - 1)
+     */
+    private static writeUint48;
+    /**
+     * Read a uint48 value (6 bytes, big-endian) from a DataView.
+     *
+     * @param view - The DataView to read from
+     * @param offset - The byte offset to read at
+     * @returns The uint48 value as a number
+     */
+    private static readUint48;
+}
+//# sourceMappingURL=manifestSerializer.d.ts.map

package/src/lib/blocks/tcbl/manifestSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestSerializer.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/blocks/tcbl/manifestSerializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAuBhD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,UAAU;IAmFrD;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa;IAmHnD;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ;IAWzD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAY1B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAK1B"}

package/src/lib/blocks/tcbl/manifestSerializer.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * @fileoverview TCBL Manifest Serializer.
+ *
+ * Provides deterministic binary serialization and deserialization of TCBL manifests.
+ * The binary format is:
+ *   - version: uint16 (2 bytes, big-endian)
+ *   - entryCount: uint32 (4 bytes, big-endian)
+ *   - For each entry:
+ *     - fileNameLength: uint16 (2 bytes, big-endian)
+ *     - fileName: UTF-8 bytes (variable)
+ *     - mimeTypeLength: uint8 (1 byte)
+ *     - mimeType: UTF-8 bytes (variable)
+ *     - originalDataLength: uint48 (6 bytes, big-endian)
+ *     - cblAddress: fixed-size checksum bytes (64 bytes for SHA3-512)
+ *   - checksum: 64 bytes (SHA3-512 of all preceding data)
+ *
+ * @see Requirements 3.1, 3.2, 3.3, 3.4, 3.5
+ * @see Requirement 2.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TcblManifestSerializer = void 0;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const sha3_1 = require("@noble/hashes/sha3");
+const tcblErrorType_1 = require("../../enumerations/tcblErrorType");
+const tcblError_1 = require("../../errors/tcblError");
+const checksum_1 = require("../../types/checksum");
+/** Fixed size of a checksum in bytes (SHA3-512). */
+const CHECKSUM_BYTE_LENGTH = ecies_lib_1.CHECKSUM.SHA3_BUFFER_LENGTH; // 64
+/** Size of the version field in bytes. */
+const VERSION_SIZE = 2;
+/** Size of the entryCount field in bytes. */
+const ENTRY_COUNT_SIZE = 4;
+/** Size of the fileNameLength field in bytes. */
+const FILE_NAME_LENGTH_SIZE = 2;
+/** Size of the mimeTypeLength field in bytes. */
+const MIME_TYPE_LENGTH_SIZE = 1;
+/** Size of the originalDataLength field in bytes (uint48). */
+const ORIGINAL_DATA_LENGTH_SIZE = 6;
+/** Minimum header size: version + entryCount. */
+const MIN_HEADER_SIZE = VERSION_SIZE + ENTRY_COUNT_SIZE;
+/**
+ * Static utility class for deterministic binary serialization and
+ * deserialization of TCBL manifests.
+ *
+ * @see Requirement 3
+ */
+class TcblManifestSerializer {
+    /**
+     * Serialize a TCBL manifest into a deterministic binary `Uint8Array`.
+     *
+     * The checksum field on the manifest is ignored during serialization;
+     * a fresh checksum is computed over the entry data and appended.
+     *
+     * @param manifest - The manifest to serialize
+     * @returns The serialized binary representation
+     *
+     * @see Requirements 3.1, 3.5
+     */
+    static serialize(manifest) {
+        const encoder = new TextEncoder();
+        // Pre-compute total size
+        let totalSize = VERSION_SIZE + ENTRY_COUNT_SIZE;
+        const encodedEntries = [];
+        for (const entry of manifest.entries) {
+            const fileNameBytes = encoder.encode(entry.fileName);
+            const mimeTypeBytes = encoder.encode(entry.mimeType);
+            encodedEntries.push({ fileNameBytes, mimeTypeBytes, entry });
+            totalSize +=
+                FILE_NAME_LENGTH_SIZE +
+                    fileNameBytes.length +
+                    MIME_TYPE_LENGTH_SIZE +
+                    mimeTypeBytes.length +
+                    ORIGINAL_DATA_LENGTH_SIZE +
+                    CHECKSUM_BYTE_LENGTH;
+        }
+        // Add checksum at the end
+        totalSize += CHECKSUM_BYTE_LENGTH;
+        const buffer = new Uint8Array(totalSize);
+        const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+        let offset = 0;
+        // Version (uint16 big-endian)
+        view.setUint16(offset, manifest.version, false);
+        offset += VERSION_SIZE;
+        // Entry count (uint32 big-endian)
+        view.setUint32(offset, manifest.entries.length, false);
+        offset += ENTRY_COUNT_SIZE;
+        // Entries
+        for (const { fileNameBytes, mimeTypeBytes, entry } of encodedEntries) {
+            // fileNameLength (uint16 big-endian)
+            view.setUint16(offset, fileNameBytes.length, false);
+            offset += FILE_NAME_LENGTH_SIZE;
+            // fileName (UTF-8 bytes)
+            buffer.set(fileNameBytes, offset);
+            offset += fileNameBytes.length;
+            // mimeTypeLength (uint8)
+            view.setUint8(offset, mimeTypeBytes.length);
+            offset += MIME_TYPE_LENGTH_SIZE;
+            // mimeType (UTF-8 bytes)
+            buffer.set(mimeTypeBytes, offset);
+            offset += mimeTypeBytes.length;
+            // originalDataLength (uint48 big-endian)
+            TcblManifestSerializer.writeUint48(view, offset, entry.originalDataLength);
+            offset += ORIGINAL_DATA_LENGTH_SIZE;
+            // cblAddress (fixed-size checksum bytes)
+            buffer.set(entry.cblAddress.toUint8Array(), offset);
+            offset += CHECKSUM_BYTE_LENGTH;
+        }
+        // Compute checksum over everything before the checksum slot
+        const entryData = buffer.subarray(0, offset);
+        const checksumBytes = (0, sha3_1.sha3_512)(entryData);
+        buffer.set(checksumBytes, offset);
+        return buffer;
+    }
+    /**
+     * Deserialize a binary `Uint8Array` back into a TCBL manifest object.
+     *
+     * @param data - The binary data to deserialize
+     * @returns The deserialized manifest
+     * @throws {TcblError} with `ManifestTruncated` if data is too short
+     * @throws {TcblError} with `ManifestCorrupted` if data is structurally invalid
+     *
+     * @see Requirements 3.2, 3.4
+     */
+    static deserialize(data) {
+        if (data.length < MIN_HEADER_SIZE + CHECKSUM_BYTE_LENGTH) {
+            throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+        }
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        let offset = 0;
+        // Version (uint16 big-endian)
+        const version = view.getUint16(offset, false);
+        offset += VERSION_SIZE;
+        // Entry count (uint32 big-endian)
+        const entryCount = view.getUint32(offset, false);
+        offset += ENTRY_COUNT_SIZE;
+        const decoder = new TextDecoder('utf-8', { fatal: true });
+        const entries = [];
+        for (let i = 0; i < entryCount; i++) {
+            // fileNameLength (uint16 big-endian)
+            if (offset + FILE_NAME_LENGTH_SIZE > data.length - CHECKSUM_BYTE_LENGTH) {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+            }
+            const fileNameLength = view.getUint16(offset, false);
+            offset += FILE_NAME_LENGTH_SIZE;
+            // fileName (UTF-8 bytes)
+            if (offset + fileNameLength > data.length - CHECKSUM_BYTE_LENGTH) {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+            }
+            let fileName;
+            try {
+                fileName = decoder.decode(data.subarray(offset, offset + fileNameLength));
+            }
+            catch {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestCorrupted);
+            }
+            offset += fileNameLength;
+            // mimeTypeLength (uint8)
+            if (offset + MIME_TYPE_LENGTH_SIZE > data.length - CHECKSUM_BYTE_LENGTH) {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+            }
+            const mimeTypeLength = view.getUint8(offset);
+            offset += MIME_TYPE_LENGTH_SIZE;
+            // mimeType (UTF-8 bytes)
+            if (offset + mimeTypeLength > data.length - CHECKSUM_BYTE_LENGTH) {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+            }
+            let mimeType;
+            try {
+                mimeType = decoder.decode(data.subarray(offset, offset + mimeTypeLength));
+            }
+            catch {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestCorrupted);
+            }
+            offset += mimeTypeLength;
+            // originalDataLength (uint48 big-endian)
+            if (offset + ORIGINAL_DATA_LENGTH_SIZE >
+                data.length - CHECKSUM_BYTE_LENGTH) {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+            }
+            const originalDataLength = TcblManifestSerializer.readUint48(view, offset);
+            offset += ORIGINAL_DATA_LENGTH_SIZE;
+            // cblAddress (fixed-size checksum bytes)
+            if (offset + CHECKSUM_BYTE_LENGTH > data.length - CHECKSUM_BYTE_LENGTH) {
+                throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestTruncated);
+            }
+            const cblAddressBytes = data.slice(offset, offset + CHECKSUM_BYTE_LENGTH);
+            const cblAddress = checksum_1.Checksum.fromUint8Array(cblAddressBytes);
+            offset += CHECKSUM_BYTE_LENGTH;
+            entries.push({ fileName, mimeType, originalDataLength, cblAddress });
+        }
+        // Verify we consumed exactly the right amount before the checksum
+        const expectedChecksumOffset = data.length - CHECKSUM_BYTE_LENGTH;
+        if (offset !== expectedChecksumOffset) {
+            throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestCorrupted);
+        }
+        // Extract and verify checksum
+        const storedChecksumBytes = data.slice(offset, offset + CHECKSUM_BYTE_LENGTH);
+        const checksum = checksum_1.Checksum.fromUint8Array(storedChecksumBytes);
+        // Verify checksum integrity
+        const entryData = data.subarray(0, offset);
+        const computedChecksumBytes = (0, sha3_1.sha3_512)(entryData);
+        const computedChecksum = checksum_1.Checksum.fromUint8Array(computedChecksumBytes);
+        if (!checksum.equals(computedChecksum)) {
+            throw new tcblError_1.TcblError(tcblErrorType_1.TcblErrorType.ManifestCorrupted);
+        }
+        return {
+            version,
+            entryCount,
+            entries,
+            checksum,
+        };
+    }
+    /**
+     * Compute the manifest checksum over the serialized entry data
+     * (version + entryCount + entries), excluding the checksum itself.
+     *
+     * @param manifest - The manifest to compute the checksum for
+     * @returns The computed checksum
+     *
+     * @see Requirement 2.5
+     */
+    static computeChecksum(manifest) {
+        const serialized = TcblManifestSerializer.serialize(manifest);
+        // The checksum is the last CHECKSUM_BYTE_LENGTH bytes;
+        // compute over everything before it
+        const entryData = serialized.subarray(0, serialized.length - CHECKSUM_BYTE_LENGTH);
+        return checksum_1.Checksum.fromUint8Array((0, sha3_1.sha3_512)(entryData));
+    }
+    /**
+     * Write a uint48 value (6 bytes, big-endian) into a DataView.
+     *
+     * @param view - The DataView to write to
+     * @param offset - The byte offset to write at
+     * @param value - The value to write (must be <= 2^48 - 1)
+     */
+    static writeUint48(view, offset, value) {
+        // Split into high 16 bits and low 32 bits
+        const high = Math.floor(value / 0x100000000) & 0xffff;
+        const low = value >>> 0;
+        view.setUint16(offset, high, false);
+        view.setUint32(offset + 2, low, false);
+    }
+    /**
+     * Read a uint48 value (6 bytes, big-endian) from a DataView.
+     *
+     * @param view - The DataView to read from
+     * @param offset - The byte offset to read at
+     * @returns The uint48 value as a number
+     */
+    static readUint48(view, offset) {
+        const high = view.getUint16(offset, false);
+        const low = view.getUint32(offset + 2, false);
+        return high * 0x100000000 + low;
+    }
+}
+exports.TcblManifestSerializer = TcblManifestSerializer;
+//# sourceMappingURL=manifestSerializer.js.map

package/src/lib/blocks/tcbl/manifestSerializer.js.map

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