@brightchain/brightchain-lib 0.13.0 → 0.15.0

package/src/lib/interfaces/storage/documentTypes.d.ts

@@ -0,0 +1,413 @@
+/**
+ * Shared document store types promoted from brightchain-db.
+ * These types define the MongoDB-compatible query/update/result contracts
+ * used by both brightchain-db and mongoose-based implementations.
+ */
+import { IClientSession } from './clientSession';
+/** A document ID – opaque string */
+export type DocumentId = string;
+/** The shape of a stored document – any record with an optional _id */
+export type BsonDocument = Record<string, unknown> & {
+    _id?: DocumentId;
+};
+/**
+ * MongoDB-style filter with query operators.
+ *
+ * Supports:
+ *   - Exact match: `{ field: value }`
+ *   - Comparison: `{ field: { $eq, $ne, $gt, $gte, $lt, $lte } }`
+ *   - Set: `{ field: { $in: [...], $nin: [...] } }`
+ *   - Pattern: `{ field: { $regex: /.../ } }`
+ *   - Existence: `{ field: { $exists: true } }`
+ *   - Logical: `{ $and: [...], $or: [...], $not: {...}, $nor: [...] }`
+ *   - Array: `{ field: { $elemMatch: {...} } }`
+ */
+export type FilterQuery<T> = {
+    [P in keyof T]?: T[P] | FilterOperator<T[P]>;
+} & LogicalOperators<T>;
+export interface FilterOperator<V> {
+    $eq?: V;
+    $ne?: V;
+    $gt?: V;
+    $gte?: V;
+    $lt?: V;
+    $lte?: V;
+    $in?: V[];
+    $nin?: V[];
+    $regex?: RegExp | string;
+    $exists?: boolean;
+    $not?: FilterOperator<V>;
+    $elemMatch?: Record<string, unknown>;
+    $size?: number;
+    $type?: string;
+    $all?: V[];
+}
+export interface LogicalOperators<T> {
+    $and?: FilterQuery<T>[];
+    $or?: FilterQuery<T>[];
+    $nor?: FilterQuery<T>[];
+    $not?: FilterQuery<T>;
+}
+/**
+ * MongoDB-style update operators
+ */
+export interface UpdateOperators<T> {
+    $set?: Partial<T>;
+    $unset?: {
+        [P in keyof T]?: 1 | '' | true;
+    };
+    $inc?: {
+        [P in keyof T]?: number;
+    };
+    $push?: {
+        [P in keyof T]?: unknown;
+    };
+    $pull?: {
+        [P in keyof T]?: unknown;
+    };
+    $addToSet?: {
+        [P in keyof T]?: unknown;
+    };
+    $min?: Partial<T>;
+    $max?: Partial<T>;
+    $rename?: {
+        [key: string]: string;
+    };
+    $currentDate?: {
+        [P in keyof T]?: true | {
+            $type: 'date' | 'timestamp';
+        };
+    };
+    $mul?: {
+        [P in keyof T]?: number;
+    };
+    $pop?: {
+        [P in keyof T]?: 1 | -1;
+    };
+}
+/** The update document can be either operators or a full replacement */
+export type UpdateQuery<T> = UpdateOperators<T> | Partial<T>;
+/**
+ * Sort specification: 1 = ascending, -1 = descending
+ */
+export type SortSpec<T = BsonDocument> = {
+    [P in keyof T]?: 1 | -1;
+} & Record<string, 1 | -1>;
+/**
+ * Projection specification: 1 = include, 0 = exclude
+ */
+export type ProjectionSpec<T = BsonDocument> = {
+    [P in keyof T]?: 1 | 0;
+} & Record<string, 1 | 0>;
+/**
+ * Index specification: 1 = ascending, -1 = descending
+ */
+export type IndexSpec = Record<string, 1 | -1>;
+/**
+ * Options for index creation
+ */
+export interface IndexOptions {
+    unique?: boolean;
+    name?: string;
+    sparse?: boolean;
+    background?: boolean;
+    /** TTL: automatically expire documents after this many seconds */
+    expireAfterSeconds?: number;
+}
+/**
+ * Client session type alias for backward compatibility.
+ * The canonical interface is IClientSession in ./clientSession.ts.
+ */
+export type ClientSession = IClientSession;
+/**
+ * Options for find operations
+ */
+export interface FindOptions<T = BsonDocument> {
+    projection?: ProjectionSpec<T>;
+    sort?: SortSpec<T>;
+    limit?: number;
+    skip?: number;
+    session?: IClientSession;
+}
+/**
+ * Options for write operations
+ */
+export interface WriteOptions {
+    session?: IClientSession;
+    /** Write concern for this operation */
+    writeConcern?: WriteConcern;
+}
+/**
+ * Options for update operations
+ */
+export interface UpdateOptions extends WriteOptions {
+    upsert?: boolean;
+}
+/**
+ * Result of an insert operation
+ */
+export interface InsertOneResult {
+    acknowledged: boolean;
+    insertedId: DocumentId;
+}
+export interface InsertManyResult {
+    acknowledged: boolean;
+    insertedCount: number;
+    insertedIds: Record<number, DocumentId>;
+}
+/**
+ * Result of an update operation
+ */
+export interface UpdateResult {
+    acknowledged: boolean;
+    matchedCount: number;
+    modifiedCount: number;
+    upsertedCount: number;
+    upsertedId?: DocumentId;
+}
+/**
+ * Result of a delete operation
+ */
+export interface DeleteResult {
+    acknowledged: boolean;
+    deletedCount: number;
+}
+/**
+ * Result of a replace operation
+ */
+export interface ReplaceResult {
+    acknowledged: boolean;
+    matchedCount: number;
+    modifiedCount: number;
+    upsertedCount: number;
+    upsertedId?: DocumentId;
+}
+/** Change stream event types */
+export type ChangeEventType = 'insert' | 'update' | 'replace' | 'delete';
+export interface ChangeEvent<T = BsonDocument> {
+    operationType: ChangeEventType;
+    documentKey: {
+        _id: DocumentId;
+    };
+    fullDocument?: T;
+    updateDescription?: {
+        updatedFields?: Partial<T>;
+        removedFields?: string[];
+    };
+    ns: {
+        db: string;
+        coll: string;
+    };
+    timestamp: Date;
+}
+/** Listener for change events */
+export type ChangeListener<T = BsonDocument> = (event: ChangeEvent<T>) => void;
+/**
+ * Aggregation pipeline stage types
+ */
+export type AggregationStage = {
+    $match: Record<string, unknown>;
+} | {
+    $group: Record<string, unknown>;
+} | {
+    $sort: Record<string, 1 | -1>;
+} | {
+    $limit: number;
+} | {
+    $skip: number;
+} | {
+    $project: Record<string, unknown>;
+} | {
+    $unwind: string | {
+        path: string;
+        preserveNullAndEmptyArrays?: boolean;
+    };
+} | {
+    $count: string;
+} | {
+    $addFields: Record<string, unknown>;
+} | {
+    $lookup: {
+        from: string;
+        localField: string;
+        foreignField: string;
+        as: string;
+    };
+} | {
+    $replaceRoot: {
+        newRoot: string | Record<string, unknown>;
+    };
+} | {
+    $out: string;
+} | {
+    $sample: {
+        size: number;
+    };
+} | {
+    $facet: Record<string, AggregationStage[]>;
+};
+/**
+ * Write concern – controls acknowledgment of write operations.
+ */
+export interface WriteConcern {
+    /** Number of acknowledgments: 0 = fire-and-forget, 1 = primary (default), 'majority' */
+    w?: number | 'majority';
+    /** Timeout in ms for write concern acknowledgment */
+    wtimeoutMS?: number;
+    /** Whether to wait for journal commit before acknowledging */
+    journal?: boolean;
+}
+/**
+ * Read preference – controls which store replicas are read from.
+ */
+export type ReadPreference = 'primary' | 'secondary' | 'nearest';
+/**
+ * Options for creating a collection with validation and other settings.
+ */
+export interface CollectionOptions {
+    /** Write concern for all operations on this collection */
+    writeConcern?: WriteConcern;
+    /** Read preference for all read operations on this collection */
+    readPreference?: ReadPreference;
+}
+export type BulkWriteOperation<T extends BsonDocument = BsonDocument> = {
+    insertOne: {
+        document: T;
+    };
+} | {
+    updateOne: {
+        filter: FilterQuery<T>;
+        update: UpdateQuery<T>;
+        upsert?: boolean;
+    };
+} | {
+    updateMany: {
+        filter: FilterQuery<T>;
+        update: UpdateQuery<T>;
+    };
+} | {
+    deleteOne: {
+        filter: FilterQuery<T>;
+    };
+} | {
+    deleteMany: {
+        filter: FilterQuery<T>;
+    };
+} | {
+    replaceOne: {
+        filter: FilterQuery<T>;
+        replacement: T;
+        upsert?: boolean;
+    };
+};
+export interface BulkWriteOptions extends WriteOptions {
+    /** If true, stop on the first error. If false, continue and report all errors. (default: true) */
+    ordered?: boolean;
+}
+export interface BulkWriteResult {
+    acknowledged: boolean;
+    insertedCount: number;
+    matchedCount: number;
+    modifiedCount: number;
+    deletedCount: number;
+    upsertedCount: number;
+    insertedIds: Record<number, DocumentId>;
+    upsertedIds: Record<number, DocumentId>;
+}
+/**
+ * Text index options
+ */
+export interface TextIndexOptions {
+    /** Fields to index for text search, with optional weights */
+    fields: Record<string, number>;
+    /** Default language for stemming (currently unused – basic tokenisation only) */
+    defaultLanguage?: string;
+    /** Name of the text index */
+    name?: string;
+}
+/**
+ * A server-side cursor session for paginated REST access.
+ */
+export interface CursorSession {
+    /** Unique cursor ID */
+    id: string;
+    /** Collection name */
+    collection: string;
+    /** Pre-fetched document IDs (for position tracking) */
+    documentIds: DocumentId[];
+    /** Current offset position */
+    position: number;
+    /** Batch size */
+    batchSize: number;
+    /** Timestamp of last access */
+    lastAccessed: number;
+    /** Filter used to create this cursor */
+    filter: Record<string, unknown>;
+    /** Sort used */
+    sort?: Record<string, 1 | -1>;
+    /** Projection used */
+    projection?: Record<string, 0 | 1>;
+}
+/**
+ * Supported schema field types for collection validation.
+ */
+export type CollectionSchemaFieldType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'date' | 'any';
+/**
+ * Per-field schema definition for collection validation.
+ */
+export interface FieldSchema {
+    /** Expected type */
+    type?: CollectionSchemaFieldType | CollectionSchemaFieldType[];
+    /** Whether this field is required (also settable at parent level via `required` array) */
+    required?: boolean;
+    /** Minimum value (number) or minimum length (string/array) */
+    minimum?: number;
+    /** Maximum value (number) or maximum length (string/array) */
+    maximum?: number;
+    /** Minimum string/array length */
+    minLength?: number;
+    /** Maximum string/array length */
+    maxLength?: number;
+    /** Regex pattern for string values */
+    pattern?: string;
+    /** Allowed values */
+    enum?: unknown[];
+    /** Schema for nested object properties */
+    properties?: Record<string, FieldSchema>;
+    /** Required fields in nested object */
+    requiredFields?: string[];
+    /** Schema for array items */
+    items?: FieldSchema;
+    /** Default value if field is missing */
+    default?: unknown;
+    /** Whether to allow extra properties (for objects) */
+    additionalProperties?: boolean;
+    /** Custom validation function */
+    validate?: (value: unknown) => boolean | string;
+}
+/**
+ * Collection-level schema for document validation.
+ */
+export interface CollectionSchema {
+    /** Name of the schema (for error messages) */
+    name?: string;
+    /** Per-field definitions */
+    properties: Record<string, FieldSchema>;
+    /** Which fields are required */
+    required?: string[];
+    /** Allow fields not defined in properties (default: true) */
+    additionalProperties?: boolean;
+    /** When to validate: 'strict' = inserts and updates, 'moderate' = inserts only */
+    validationLevel?: 'strict' | 'moderate' | 'off';
+    /** What to do on failure: 'error' = throw, 'warn' = log and continue */
+    validationAction?: 'error' | 'warn';
+}
+/**
+ * A field-level validation error returned by schema validation.
+ */
+export interface ValidationFieldError {
+    field: string;
+    message: string;
+    value?: unknown;
+}
+//# sourceMappingURL=documentTypes.d.ts.map

package/src/lib/interfaces/storage/documentTypes.d.ts.map

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

package/src/lib/interfaces/storage/documentTypes.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Shared document store types promoted from brightchain-db.
+ * These types define the MongoDB-compatible query/update/result contracts
+ * used by both brightchain-db and mongoose-based implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=documentTypes.js.map

package/src/lib/interfaces/storage/documentTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentTypes.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/documentTypes.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/src/lib/interfaces/storage/encryptedPool.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Encrypted pool storage types and configuration.
+ *
+ * Defines encryption modes for pools, configuration for encrypted storage,
+ * and key version tracking for key rotation support.
+ *
+ * Uses Uint8Array (not Buffer) for browser compatibility.
+ * Generic type parameters support DTO flexibility (string for frontend,
+ * Uint8Array for backend node IDs).
+ */
+import { PoolId } from './pooledBlockStore';
+/**
+ * Encryption modes for pool storage.
+ * - None: no encryption applied
+ * - NodeSpecific: encrypted with the storing node's key; only that node can decrypt
+ * - PoolShared: encrypted with a shared pool key; any pool member can decrypt
+ */
+export declare enum EncryptionMode {
+    None = "none",
+    NodeSpecific = "node-specific",
+    PoolShared = "pool-shared"
+}
+/**
+ * Options for configuring encryption on a pool at creation time.
+ */
+export interface IEncryptedPoolOptions {
+    encryptionMode: EncryptionMode;
+    /** Fields that remain unencrypted for search (e.g., ['blockSize', 'createdAt']) */
+    searchableMetadataFields?: string[];
+}
+/**
+ * A single key version entry, tracking the key material and its lifecycle.
+ * For pool-shared mode, the symmetric key is encrypted per-member via ECIES.
+ *
+ * Generic TNodeId allows string for frontend, Uint8Array for backend.
+ */
+export interface IKeyVersion<TNodeId = string> {
+    version: number;
+    createdAt: Date;
+    /** For pool-shared: the symmetric key encrypted per-member */
+    encryptedKeys?: Array<{
+        nodeId: TNodeId;
+        encryptedKey: Uint8Array;
+    }>;
+    /** Whether this key version is still valid for decryption */
+    active: boolean;
+}
+/**
+ * Pool encryption configuration stored alongside the pool.
+ * Tracks the encryption mode, searchable fields, and full key version history
+ * so older blocks can still be decrypted after key rotation.
+ *
+ * Generic TNodeId allows string for frontend, Uint8Array for backend.
+ */
+export interface IPoolEncryptionConfig<TNodeId = string> {
+    poolId: PoolId;
+    mode: EncryptionMode;
+    searchableMetadataFields: string[];
+    /** Key version history for decrypting older blocks */
+    keyVersions: IKeyVersion<TNodeId>[];
+    /** Current active key version */
+    currentKeyVersion: number;
+}
+//# sourceMappingURL=encryptedPool.d.ts.map

package/src/lib/interfaces/storage/encryptedPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryptedPool.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/encryptedPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,IAAI,SAAS;IACb,YAAY,kBAAkB;IAC9B,UAAU,gBAAgB;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,cAAc,CAAC;IAC/B,mFAAmF;IACnF,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,MAAM;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;QAChB,YAAY,EAAE,UAAU,CAAC;KAC1B,CAAC,CAAC;IACH,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,MAAM;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,sDAAsD;IACtD,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/src/lib/interfaces/storage/encryptedPool.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Encrypted pool storage types and configuration.
+ *
+ * Defines encryption modes for pools, configuration for encrypted storage,
+ * and key version tracking for key rotation support.
+ *
+ * Uses Uint8Array (not Buffer) for browser compatibility.
+ * Generic type parameters support DTO flexibility (string for frontend,
+ * Uint8Array for backend node IDs).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EncryptionMode = void 0;
+/**
+ * Encryption modes for pool storage.
+ * - None: no encryption applied
+ * - NodeSpecific: encrypted with the storing node's key; only that node can decrypt
+ * - PoolShared: encrypted with a shared pool key; any pool member can decrypt
+ */
+var EncryptionMode;
+(function (EncryptionMode) {
+    EncryptionMode["None"] = "none";
+    EncryptionMode["NodeSpecific"] = "node-specific";
+    EncryptionMode["PoolShared"] = "pool-shared";
+})(EncryptionMode || (exports.EncryptionMode = EncryptionMode = {}));
+//# sourceMappingURL=encryptedPool.js.map

package/src/lib/interfaces/storage/encryptedPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryptedPool.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/encryptedPool.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAIH;;;;;GAKG;AACH,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,gDAA8B,CAAA;IAC9B,4CAA0B,CAAA;AAC5B,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}

package/src/lib/interfaces/storage/headRegistry.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Represents a deferred head update for a block not yet available locally.
+ * When the block is fetched, the deferred update can be applied.
+ *
+ * @see Requirements 2.4
+ */
+export interface DeferredHeadUpdate {
+    /** The database name */
+    dbName: string;
+    /** The collection name */
+    collectionName: string;
+    /** The block ID of the announced head */
+    blockId: string;
+    /** The timestamp of the announced head (for last-writer-wins) */
+    timestamp: Date;
+}
+/**
+ * Interface for the HeadRegistry, which maps (dbName, collectionName) pairs
+ * to the block ID of the latest metadata block for that collection.
+ *
+ * Implementations may be in-memory (for testing/backward compatibility)
+ * or persistent (writing through to disk for durability across restarts).
+ *
+ * Mutating methods return Promise<void> to support async disk I/O
+ * in persistent implementations.
+ *
+ * Includes cross-node synchronization support via merge and deferred update
+ * methods that implement last-writer-wins conflict resolution.
+ *
+ * @see Requirements 2.2, 2.3, 2.4
+ */
+export interface IHeadRegistry {
+    /**
+     * Get the head block ID for a given database and collection.
+     * @param dbName - The database name
+     * @param collectionName - The collection name
+     * @returns The block ID of the latest metadata block, or undefined if not set
+     */
+    getHead(dbName: string, collectionName: string): string | undefined;
+    /**
+     * Set the head block ID for a given database and collection.
+     * Persistent implementations will write through to disk before returning.
+     * Also records the current time as the timestamp for last-writer-wins.
+     * @param dbName - The database name
+     * @param collectionName - The collection name
+     * @param blockId - The block ID of the latest metadata block
+     */
+    setHead(dbName: string, collectionName: string, blockId: string): Promise<void>;
+    /**
+     * Remove the head pointer for a given database and collection.
+     * Persistent implementations will remove from disk before returning.
+     * @param dbName - The database name
+     * @param collectionName - The collection name
+     */
+    removeHead(dbName: string, collectionName: string): Promise<void>;
+    /**
+     * Remove all head pointers.
+     * Persistent implementations will clear the persisted state before returning.
+     */
+    clear(): Promise<void>;
+    /**
+     * Load head pointers from the persistence layer into memory.
+     * For in-memory implementations, this is a no-op.
+     * For persistent implementations, this reads from disk.
+     */
+    load(): Promise<void>;
+    /**
+     * Get all head pointers as a Map.
+     * Keys are composite strings in the format "dbName:collectionName".
+     * Values are block IDs.
+     * @returns A Map of all current head pointers
+     */
+    getAllHeads(): Map<string, string>;
+    /**
+     * Get the timestamp associated with a head pointer.
+     * Used for last-writer-wins conflict resolution during cross-node sync.
+     * @param dbName - The database name
+     * @param collectionName - The collection name
+     * @returns The timestamp of the head pointer, or undefined if not set
+     *
+     * @see Requirements 2.2, 2.3
+     */
+    getHeadTimestamp(dbName: string, collectionName: string): Date | undefined;
+    /**
+     * Merge a remote head update using last-writer-wins conflict resolution.
+     * If the announced timestamp is newer than the local timestamp, the head
+     * pointer is updated. Otherwise the update is rejected (local wins).
+     *
+     * @param dbName - The database name
+     * @param collectionName - The collection name
+     * @param blockId - The announced block ID
+     * @param timestamp - The timestamp from the remote node's block metadata
+     * @returns true if the update was applied, false if rejected (local is newer)
+     *
+     * @see Requirements 2.2, 2.3
+     */
+    mergeHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<boolean>;
+    /**
+     * Queue a deferred head update for a block not yet available locally.
+     * The update will be applied when `applyDeferredUpdates(blockId)` is called
+     * after the block has been fetched.
+     *
+     * @param dbName - The database name
+     * @param collectionName - The collection name
+     * @param blockId - The block ID that is not yet locally available
+     * @param timestamp - The timestamp from the remote node's block metadata
+     *
+     * @see Requirements 2.4
+     */
+    deferHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<void>;
+    /**
+     * Apply any deferred updates for a block that has just become available locally.
+     * Each deferred update is applied via `mergeHeadUpdate` (last-writer-wins).
+     *
+     * @param blockId - The block ID that is now available locally
+     * @returns The number of deferred updates that were applied
+     *
+     * @see Requirements 2.4
+     */
+    applyDeferredUpdates(blockId: string): Promise<number>;
+    /**
+     * Get all currently deferred updates.
+     * Useful for diagnostics and testing.
+     * @returns Array of deferred head updates
+     */
+    getDeferredUpdates(): DeferredHeadUpdate[];
+}
+//# sourceMappingURL=headRegistry.d.ts.map

package/src/lib/interfaces/storage/headRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headRegistry.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/storage/headRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEpE;;;;;;;OAOG;IACH,OAAO,CACL,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE3E;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD;;;;OAIG;IACH,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;CAC5C"}

package/src/lib/interfaces/storage/headRegistry.js

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

package/src/lib/interfaces/storage/headRegistry.js.map

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