@brightchain/brightchain-api-lib 0.0.1

package/src/lib/stores/availabilityAwareBlockStore.js

@@ -0,0 +1,458 @@
+"use strict";
+/**
+ * @fileoverview Availability-Aware Block Store Wrapper
+ *
+ * Wraps an existing IBlockStore implementation to add availability tracking.
+ * Provides hooks for registry updates, gossip announcements, access metadata
+ * updates, and partition mode operation restrictions.
+ *
+ * @see Requirements 12.1, 12.2, 12.3, 12.4, 12.5, 12.6, 8.1, 8.2, 8.3, 8.4, 8.5, 8.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AvailabilityAwareBlockStore = exports.DEFAULT_AVAILABILITY_AWARE_BLOCK_STORE_CONFIG = exports.PartitionModeError = void 0;
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+/**
+ * Error thrown when an operation is attempted during partition mode
+ * that requires network access.
+ */
+class PartitionModeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PartitionModeError';
+    }
+}
+exports.PartitionModeError = PartitionModeError;
+/**
+ * Default configuration values.
+ */
+exports.DEFAULT_AVAILABILITY_AWARE_BLOCK_STORE_CONFIG = {
+    localNodeId: '',
+    autoAnnounce: true,
+    trackAccess: true,
+};
+/**
+ * AvailabilityAwareBlockStore
+ *
+ * Wraps an existing IBlockStore to add availability tracking.
+ * Implements the same IBlockStore interface for transparent usage.
+ *
+ * Features:
+ * - Automatic registry updates on store/delete operations
+ * - Gossip announcements for new blocks and removals
+ * - Access metadata tracking on reads
+ * - Partition mode operation restrictions
+ * - Pending sync queue for operations during partition mode
+ *
+ * @see Requirements 12.1, 12.2, 12.3, 12.4, 12.5, 12.6, 8.1, 8.2, 8.3, 8.4, 8.5, 8.6
+ */
+class AvailabilityAwareBlockStore {
+    /**
+     * Create a new AvailabilityAwareBlockStore.
+     *
+     * @param innerStore - The underlying block store to wrap
+     * @param registry - Block registry for local block tracking
+     * @param availabilityService - Service for availability state management
+     * @param gossipService - Service for block announcements
+     * @param reconciliationService - Service for pending sync queue
+     * @param config - Configuration options
+     */
+    constructor(innerStore, registry, availabilityService, gossipService, reconciliationService, config) {
+        this.innerStore = innerStore;
+        this.registry = registry;
+        this.availabilityService = availabilityService;
+        this.gossipService = gossipService;
+        this.reconciliationService = reconciliationService;
+        this.config = {
+            ...exports.DEFAULT_AVAILABILITY_AWARE_BLOCK_STORE_CONFIG,
+            ...config,
+        };
+    }
+    /**
+     * Get the block size for this store.
+     */
+    get blockSize() {
+        return this.innerStore.blockSize;
+    }
+    // === Core Block Operations ===
+    /**
+     * Check if a block exists.
+     *
+     * @param key - The block's checksum or ID
+     * @returns Promise resolving to true if the block exists
+     */
+    async has(key) {
+        return this.innerStore.has(key);
+    }
+    /**
+     * Get a block's data.
+     * Updates access metadata if tracking is enabled.
+     *
+     * @param key - The block's checksum
+     * @returns Promise resolving to the block data
+     * @throws StoreError if block not found
+     * @see Requirements 12.4
+     */
+    async getData(key) {
+        const blockId = this.keyToHex(key);
+        // Check availability state for remote blocks during partition mode
+        if (this.availabilityService.isInPartitionMode()) {
+            const state = await this.availabilityService.getAvailabilityState(blockId);
+            if (state === brightchain_lib_1.AvailabilityState.Remote) {
+                throw new PartitionModeError(`Cannot access remote block ${blockId} during partition mode`);
+            }
+        }
+        // Delegate to inner store
+        const block = await this.innerStore.getData(key);
+        // Update access metadata if tracking is enabled
+        if (this.config.trackAccess) {
+            await this.updateAccessMetadata(blockId);
+        }
+        return block;
+    }
+    /**
+     * Store a block's data with optional durability settings.
+     * Updates registry, availability state, and announces via gossip.
+     *
+     * @param block - The block to store
+     * @param options - Optional storage options
+     * @see Requirements 12.2, 8.1, 8.3, 8.5
+     */
+    async setData(block, options) {
+        const blockId = this.keyToHex(block.idChecksum);
+        // Store in inner store first
+        await this.innerStore.setData(block, options);
+        // Update registry
+        this.registry.addLocal(blockId);
+        // Update availability state to Local
+        await this.availabilityService.setAvailabilityState(blockId, brightchain_lib_1.AvailabilityState.Local);
+        // Update location metadata
+        const locationRecord = {
+            nodeId: this.config.localNodeId,
+            lastSeen: new Date(),
+            isAuthoritative: true,
+        };
+        await this.availabilityService.updateLocation(blockId, locationRecord);
+        // Handle partition mode - add to pending sync queue
+        if (this.availabilityService.isInPartitionMode()) {
+            const syncItem = {
+                type: 'store',
+                blockId,
+                timestamp: new Date(),
+                data: block.data,
+            };
+            this.reconciliationService.addToPendingSyncQueue(syncItem);
+        }
+        else if (this.config.autoAnnounce) {
+            // Announce to network via gossip
+            await this.gossipService.announceBlock(blockId);
+        }
+    }
+    /**
+     * Delete a block's data.
+     * Updates registry, availability state, and announces removal via gossip.
+     *
+     * @param key - The block's checksum
+     * @see Requirements 12.3, 8.3, 8.5
+     */
+    async deleteData(key) {
+        const blockId = this.keyToHex(key);
+        // Delete from inner store first
+        await this.innerStore.deleteData(key);
+        // Update registry
+        this.registry.removeLocal(blockId);
+        // Remove local location
+        await this.availabilityService.removeLocation(blockId, this.config.localNodeId);
+        // Handle partition mode - add to pending sync queue
+        if (this.availabilityService.isInPartitionMode()) {
+            const syncItem = {
+                type: 'delete',
+                blockId,
+                timestamp: new Date(),
+            };
+            this.reconciliationService.addToPendingSyncQueue(syncItem);
+        }
+        else if (this.config.autoAnnounce) {
+            // Announce removal to network via gossip
+            await this.gossipService.announceRemoval(blockId);
+        }
+    }
+    /**
+     * Get random block checksums from the store.
+     *
+     * @param count - Maximum number of blocks to return
+     * @returns Array of random block checksums
+     */
+    async getRandomBlocks(count) {
+        return this.innerStore.getRandomBlocks(count);
+    }
+    /**
+     * Get a handle to a block.
+     *
+     * @param checksum - The block's checksum or ID
+     * @returns Block handle
+     */
+    get(checksum) {
+        return this.innerStore.get(checksum);
+    }
+    /**
+     * Store raw data with a key.
+     *
+     * @param key - The key to store the data under
+     * @param data - The raw data to store
+     * @param options - Optional storage options
+     */
+    async put(key, data, options) {
+        const keyChecksum = typeof key === 'string' ? brightchain_lib_1.Checksum.fromHex(key) : key;
+        const blockId = this.keyToHex(keyChecksum);
+        // Delegate to inner store
+        await this.innerStore.put(key, data, options);
+        // Update registry
+        this.registry.addLocal(blockId);
+        // Update availability state to Local
+        await this.availabilityService.setAvailabilityState(blockId, brightchain_lib_1.AvailabilityState.Local);
+        // Update location metadata
+        const locationRecord = {
+            nodeId: this.config.localNodeId,
+            lastSeen: new Date(),
+            isAuthoritative: true,
+        };
+        await this.availabilityService.updateLocation(blockId, locationRecord);
+        // Handle partition mode
+        if (this.availabilityService.isInPartitionMode()) {
+            const syncItem = {
+                type: 'store',
+                blockId,
+                timestamp: new Date(),
+                data: new Uint8Array(data),
+            };
+            this.reconciliationService.addToPendingSyncQueue(syncItem);
+        }
+        else if (this.config.autoAnnounce) {
+            await this.gossipService.announceBlock(blockId);
+        }
+    }
+    /**
+     * Delete a block.
+     *
+     * @param key - The block's checksum or ID
+     */
+    async delete(key) {
+        const keyChecksum = typeof key === 'string' ? brightchain_lib_1.Checksum.fromHex(key) : key;
+        await this.deleteData(keyChecksum);
+    }
+    // === Metadata Operations ===
+    /**
+     * Get metadata for a block.
+     *
+     * @param key - The block's checksum or ID
+     * @returns The block's metadata, or null if not found
+     */
+    async getMetadata(key) {
+        return this.innerStore.getMetadata(key);
+    }
+    /**
+     * Update metadata for a block.
+     *
+     * @param key - The block's checksum or ID
+     * @param updates - Partial metadata updates to apply
+     */
+    async updateMetadata(key, updates) {
+        return this.innerStore.updateMetadata(key, updates);
+    }
+    // === FEC/Durability Operations ===
+    /**
+     * Generate parity blocks for a data block.
+     *
+     * @param key - The data block's checksum
+     * @param parityCount - Number of parity blocks to generate
+     * @returns Array of parity block checksums
+     */
+    async generateParityBlocks(key, parityCount) {
+        return this.innerStore.generateParityBlocks(key, parityCount);
+    }
+    /**
+     * Get parity block checksums for a data block.
+     *
+     * @param key - The data block's checksum or ID
+     * @returns Array of parity block checksums
+     */
+    async getParityBlocks(key) {
+        return this.innerStore.getParityBlocks(key);
+    }
+    /**
+     * Attempt to recover a corrupted or missing block.
+     *
+     * @param key - The block's checksum or ID
+     * @returns Recovery result
+     */
+    async recoverBlock(key) {
+        return this.innerStore.recoverBlock(key);
+    }
+    /**
+     * Verify block integrity against its parity data.
+     *
+     * @param key - The block's checksum or ID
+     * @returns True if the block data matches its parity data
+     */
+    async verifyBlockIntegrity(key) {
+        return this.innerStore.verifyBlockIntegrity(key);
+    }
+    // === Replication Operations ===
+    /**
+     * Get blocks that are pending replication.
+     *
+     * @returns Array of block checksums pending replication
+     */
+    async getBlocksPendingReplication() {
+        return this.innerStore.getBlocksPendingReplication();
+    }
+    /**
+     * Get blocks that are under-replicated.
+     *
+     * @returns Array of block checksums that need additional replicas
+     */
+    async getUnderReplicatedBlocks() {
+        return this.innerStore.getUnderReplicatedBlocks();
+    }
+    /**
+     * Record that a block has been replicated to a node.
+     *
+     * @param key - The block's checksum or ID
+     * @param nodeId - The ID of the node that now holds a replica
+     */
+    async recordReplication(key, nodeId) {
+        const blockId = this.keyToHex(key);
+        // Record in inner store
+        await this.innerStore.recordReplication(key, nodeId);
+        // Update location metadata
+        const locationRecord = {
+            nodeId,
+            lastSeen: new Date(),
+            isAuthoritative: false,
+        };
+        await this.availabilityService.updateLocation(blockId, locationRecord);
+    }
+    /**
+     * Record that a replica node is no longer available.
+     *
+     * @param key - The block's checksum or ID
+     * @param nodeId - The ID of the node that lost the replica
+     */
+    async recordReplicaLoss(key, nodeId) {
+        const blockId = this.keyToHex(key);
+        // Record in inner store
+        await this.innerStore.recordReplicaLoss(key, nodeId);
+        // Remove location
+        await this.availabilityService.removeLocation(blockId, nodeId);
+    }
+    // === XOR Brightening Operations ===
+    /**
+     * Brighten a block by XORing it with random blocks.
+     *
+     * @param key - The source block's checksum or ID
+     * @param randomBlockCount - Number of random blocks to XOR with
+     * @returns Result containing the brightened block ID and random block IDs
+     */
+    async brightenBlock(key, randomBlockCount) {
+        const result = await this.innerStore.brightenBlock(key, randomBlockCount);
+        // Update registry and availability for the brightened block
+        this.registry.addLocal(result.brightenedBlockId);
+        await this.availabilityService.setAvailabilityState(result.brightenedBlockId, brightchain_lib_1.AvailabilityState.Local);
+        const locationRecord = {
+            nodeId: this.config.localNodeId,
+            lastSeen: new Date(),
+            isAuthoritative: true,
+        };
+        await this.availabilityService.updateLocation(result.brightenedBlockId, locationRecord);
+        // Announce if not in partition mode
+        if (!this.availabilityService.isInPartitionMode() &&
+            this.config.autoAnnounce) {
+            await this.gossipService.announceBlock(result.brightenedBlockId);
+        }
+        return result;
+    }
+    // === Helper Methods ===
+    /**
+     * Convert a key to hex string format.
+     */
+    keyToHex(key) {
+        return typeof key === 'string' ? key : key.toHex();
+    }
+    /**
+     * Update access metadata for a block.
+     */
+    async updateAccessMetadata(blockId) {
+        try {
+            // Update location record with new lastSeen timestamp
+            const locationRecord = {
+                nodeId: this.config.localNodeId,
+                lastSeen: new Date(),
+                isAuthoritative: true,
+            };
+            await this.availabilityService.updateLocation(blockId, locationRecord);
+        }
+        catch {
+            // Ignore errors updating access metadata
+        }
+    }
+    // === Partition Mode Helpers ===
+    /**
+     * Check if the store is in partition mode.
+     *
+     * @returns True if in partition mode
+     */
+    isInPartitionMode() {
+        return this.availabilityService.isInPartitionMode();
+    }
+    /**
+     * Get the underlying block store.
+     * Use with caution - bypasses availability tracking.
+     *
+     * @returns The inner block store
+     */
+    getInnerStore() {
+        return this.innerStore;
+    }
+    /**
+     * Get the block registry.
+     *
+     * @returns The block registry
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Get the availability service.
+     *
+     * @returns The availability service
+     */
+    getAvailabilityService() {
+        return this.availabilityService;
+    }
+    /**
+     * Get the gossip service.
+     *
+     * @returns The gossip service
+     */
+    getGossipService() {
+        return this.gossipService;
+    }
+    /**
+     * Get the reconciliation service.
+     *
+     * @returns The reconciliation service
+     */
+    getReconciliationService() {
+        return this.reconciliationService;
+    }
+    /**
+     * Get the configuration.
+     *
+     * @returns The configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.AvailabilityAwareBlockStore = AvailabilityAwareBlockStore;
+//# sourceMappingURL=availabilityAwareBlockStore.js.map

package/src/lib/stores/availabilityAwareBlockStore.js.map

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

package/src/lib/stores/diskBlockAsyncStore.d.ts

@@ -0,0 +1,212 @@
+import { BaseBlock, BlockHandle, BlockSize, BlockStoreOptions, BrightenResult, Checksum, IBaseBlockMetadata, IBlockMetadata, IBlockStore, IFecService, RawDataBlock, RecoveryResult } from '@brightchain/brightchain-lib';
+import { DiskBlockMetadataStore } from './diskBlockMetadataStore';
+import { DiskBlockStore } from './diskBlockStore';
+/**
+ * DiskBlockAsyncStore provides asynchronous operations for storing and retrieving blocks from disk.
+ * It supports raw block storage and XOR operations with stream-based data handling.
+ * Blocks are stored as raw data without metadata - their meaning is derived from CBLs.
+ *
+ * This implementation supports:
+ * - Core block operations (store, retrieve, delete)
+ * - Metadata management for tracking block lifecycle and access patterns
+ * - FEC (Forward Error Correction) operations using Reed-Solomon encoding
+ * - Replication tracking for distributed storage
+ */
+export declare class DiskBlockAsyncStore extends DiskBlockStore implements IBlockStore {
+    /**
+     * Metadata store for tracking block lifecycle and access patterns.
+     */
+    private readonly metadataStore;
+    /**
+     * Optional FEC service for parity generation and recovery.
+     * If not provided, FEC operations will return errors or no-ops.
+     */
+    private fecService;
+    constructor(config: {
+        storePath: string;
+        blockSize: BlockSize;
+    });
+    /**
+     * Set the FEC service for parity generation and recovery.
+     * @param fecService - The FEC service to use
+     */
+    setFecService(fecService: IFecService | null): void;
+    /**
+     * Get the FEC service if available.
+     * @returns The FEC service or null if not available
+     */
+    getFecService(): IFecService | null;
+    /**
+     * Get the metadata store.
+     * @returns The metadata store
+     */
+    getMetadataStore(): DiskBlockMetadataStore;
+    /**
+     * Convert a key to hex string format.
+     * @param key - The key as Checksum or string
+     * @returns The key as hex string
+     */
+    private keyToHex;
+    /**
+     * Convert a hex string to Checksum.
+     * @param hex - The hex string
+     * @returns The Checksum
+     */
+    private hexToChecksum;
+    /**
+     * Get the file path for a parity block.
+     * Parity files are stored alongside block files with .p{index} extension.
+     * @param blockId - The data block's checksum
+     * @param parityIndex - The parity block index (0-based)
+     * @returns The parity file path
+     */
+    private parityPath;
+    /**
+     * Check if a block exists
+     */
+    has(key: Checksum | string): Promise<boolean>;
+    /**
+     * Get a handle to a block
+     */
+    get<T extends BaseBlock>(key: Checksum | string): BlockHandle<T>;
+    /**
+     * Get a block's data
+     */
+    getData(key: Checksum): Promise<RawDataBlock>;
+    /**
+     * Delete a block's data (and associated parity blocks and metadata)
+     * @param key - The block's checksum
+     */
+    deleteData(key: Checksum): Promise<void>;
+    /**
+     * Store a block's data with optional durability settings
+     */
+    setData(block: RawDataBlock, options?: BlockStoreOptions): Promise<void>;
+    /**
+     * XOR multiple blocks together
+     */
+    xor<T extends BaseBlock>(blocks: BlockHandle<T>[], destBlockMetadata: IBaseBlockMetadata): Promise<RawDataBlock>;
+    /**
+     * Handle read stream ends
+     */
+    private handleReadStreamEnds;
+    /**
+     * Clean up streams
+     */
+    private cleanupStreams;
+    /**
+     * Get random block checksums from the store
+     * @param count - Maximum number of blocks to return
+     * @returns Array of random block checksums
+     */
+    getRandomBlocks(count: number): Promise<Checksum[]>;
+    /**
+     * Store raw data with a key (convenience method)
+     * Creates a RawDataBlock and stores it
+     */
+    put(key: Checksum | string, data: Uint8Array, options?: BlockStoreOptions): Promise<void>;
+    /**
+     * Delete a block (convenience method, alias for deleteData)
+     */
+    delete(key: Checksum | string): Promise<void>;
+    /**
+     * Get metadata for a block
+     * @param key - The block's checksum or ID
+     * @returns The block's metadata, or null if not found
+     */
+    getMetadata(key: Checksum | string): Promise<IBlockMetadata | null>;
+    /**
+     * Update metadata for a block
+     * @param key - The block's checksum or ID
+     * @param updates - Partial metadata updates to apply
+     */
+    updateMetadata(key: Checksum | string, updates: Partial<IBlockMetadata>): Promise<void>;
+    /**
+     * Generate parity blocks for a data block using Reed-Solomon encoding.
+     * Parity blocks are stored as separate files: {blockId}.p0, {blockId}.p1, etc.
+     * @param key - The data block's checksum
+     * @param parityCount - Number of parity blocks to generate
+     * @returns Array of parity block checksums (as synthetic IDs)
+     * @throws FecError if FEC service is not available or encoding fails
+     */
+    generateParityBlocks(key: Checksum | string, parityCount: number): Promise<Checksum[]>;
+    /**
+     * Get parity block checksums for a data block.
+     * @param key - The data block's checksum or ID
+     * @returns Array of parity block checksums
+     */
+    getParityBlocks(key: Checksum | string): Promise<Checksum[]>;
+    /**
+     * Load parity data from disk for a block.
+     * @param key - The data block's checksum
+     * @returns Array of parity data objects
+     */
+    private loadParityData;
+    /**
+     * Attempt to recover a corrupted or missing block using parity data.
+     * @param key - The block's checksum or ID
+     * @returns Recovery result with the recovered block or error
+     */
+    recoverBlock(key: Checksum | string): Promise<RecoveryResult>;
+    /**
+     * Verify block integrity against its parity data.
+     * @param key - The block's checksum or ID
+     * @returns True if the block data matches its parity data
+     */
+    verifyBlockIntegrity(key: Checksum | string): Promise<boolean>;
+    /**
+     * Get blocks that are pending replication (status = Pending).
+     * @returns Array of block checksums pending replication
+     */
+    getBlocksPendingReplication(): Promise<Checksum[]>;
+    /**
+     * Get blocks that are under-replicated (status = UnderReplicated).
+     * @returns Array of block checksums that need additional replicas
+     */
+    getUnderReplicatedBlocks(): Promise<Checksum[]>;
+    /**
+     * Record that a block has been replicated to a node.
+     * @param key - The block's checksum or ID
+     * @param nodeId - The ID of the node that now holds a replica
+     */
+    recordReplication(key: Checksum | string, nodeId: string): Promise<void>;
+    /**
+     * Record that a replica node is no longer available.
+     * @param key - The block's checksum or ID
+     * @param nodeId - The ID of the node that lost the replica
+     */
+    recordReplicaLoss(key: Checksum | string, nodeId: string): Promise<void>;
+    /**
+     * Find all blocks that have expired (expiresAt is in the past).
+     * @returns Array of metadata for expired blocks
+     */
+    findExpired(): Promise<IBlockMetadata[]>;
+    /**
+     * Clean up expired blocks.
+     * This method identifies expired blocks and deletes them along with their
+     * parity blocks and metadata.
+     *
+     * @param cblChecker - Optional function to check if a block is referenced by a CBL.
+     *                     If provided, blocks referenced by active CBLs will not be deleted.
+     * @returns Object containing deleted block IDs and any errors encountered
+     */
+    cleanupExpiredBlocks(cblChecker?: (blockId: string) => Promise<boolean>): Promise<{
+        deletedBlockIds: string[];
+        errors: Array<{
+            blockId: string;
+            error: string;
+        }>;
+    }>;
+    /**
+     * Brighten a block by XORing it with random blocks from the store.
+     * This is used to implement Owner-Free storage patterns where the
+     * original data cannot be reconstructed without all the random blocks.
+     *
+     * @param key - The source block's checksum or ID
+     * @param randomBlockCount - Number of random blocks to XOR with
+     * @returns Result containing the brightened block ID and the random block IDs used
+     * @throws StoreError if the source block is not found or insufficient random blocks are available
+     */
+    brightenBlock(key: Checksum | string, randomBlockCount: number): Promise<BrightenResult>;
+}
+//# sourceMappingURL=diskBlockAsyncStore.d.ts.map

package/src/lib/stores/diskBlockAsyncStore.d.ts.map

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