@brightchain/brightchain-api-lib 0.25.0 → 0.27.0

package/src/lib/databaseInit.js

@@ -2,131 +2,65 @@
 /**
  * @fileoverview BrightChain database initialization function.
  *
- * Replaces the no-op DatabaseInitFunction with a real implementation that
- * creates persistent (or ephemeral) stores based on environment configuration.
+ * Wraps the generic brightchainDatabaseInit from @brightchain/node-express-suite,
+ * passing domain-specific model registrations (energy account hydration schema)
+ * as a callback. Returns the full IBrightChainInitData including MemberStore
+ * and EnergyAccountStore.
  *
  * @module databaseInit
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.brightchainDatabaseInit = brightchainDatabaseInit;
 const brightchain_lib_1 = require("@brightchain/brightchain-lib");
-const db_1 = require("@brightchain/db");
-const fs_1 = require("fs");
-const promises_1 = require("fs/promises");
-const blockStoreFactory_1 = require("./factories/blockStoreFactory");
+const node_express_suite_1 = require("@brightchain/node-express-suite");
 const energyAccountHydration_1 = require("./hydration/energyAccountHydration");
-/**
- * Validate that the given directory path exists and is accessible.
- * If the directory does not exist, attempt to create it recursively.
- * Throws if the path is inaccessible after creation attempt.
- */
-async function validateDataDir(dirPath) {
-    try {
-        await (0, promises_1.access)(dirPath, fs_1.constants.R_OK | fs_1.constants.W_OK);
-    }
-    catch {
-        // Directory doesn't exist or isn't accessible — try to create it
-        try {
-            await (0, promises_1.mkdir)(dirPath, { recursive: true });
-        }
-        catch (mkdirError) {
-            const message = mkdirError instanceof Error ? mkdirError.message : String(mkdirError);
-            throw new Error(`Cannot create or access data directory "${dirPath}": ${message}`);
-        }
-    }
-}
 /**
  * Initialize the BrightChain database stack.
  *
- * Reads `blockStorePath` and `blockStoreBlockSizes` from the Environment:
- * - If `blockStorePath` is set: validates the path, creates a DiskBlockStore,
- *   and creates a BrightDb with a PersistentHeadRegistry via `dataDir`.
- * - If `blockStorePath` is not set: creates a MemoryBlockStore, logs a warning,
- *   and creates a BrightDb with an InMemoryHeadRegistry.
- *
- * Registers an `energy_accounts` Model on BrightDB with the energy account
- * hydration schema, then passes the Model (as ITypedCollection) directly to
- * EnergyAccountStore — no adapter needed.
+ * Delegates to the Suite's generic brightchainDatabaseInit for block store
+ * and BrightDb creation, then adds domain-specific stores (MemberStore,
+ * EnergyAccountStore) on top via the modelRegistrations callback.
  *
  * @returns An IInitResult containing the initialized stores on success,
  *          or a failure result with a descriptive error message.
  */
 async function brightchainDatabaseInit(environment) {
-    try {
-        const blockStorePath = environment.blockStorePath;
-        const supportedBlockSizes = environment.blockStoreBlockSizes;
-        const devPoolName = environment.devDatabasePoolName;
-        let blockStore;
-        let dataDir;
-        if (devPoolName) {
-            // DEV_DATABASE is set — use ephemeral in-memory store for development
-            console.info(`[BrightChain] DEV_DATABASE="${devPoolName}" — using ephemeral MemoryBlockStore. Data will not persist across restarts.`);
-            blockStore = blockStoreFactory_1.BlockStoreFactory.createMemoryStore({ supportedBlockSizes });
-        }
-        else if (environment.blockStoreType === brightchain_lib_1.BlockStoreType.AzureBlob) {
-            // Factory must have been registered by the consuming app importing
-            // '@brightchain/azure-store' at its entry point.
-            blockStore = blockStoreFactory_1.BlockStoreFactory.createAzureStore(environment.azureConfig);
-        }
-        else if (environment.blockStoreType === brightchain_lib_1.BlockStoreType.S3) {
-            // Factory must have been registered by the consuming app importing
-            // '@brightchain/s3-store' at its entry point.
-            blockStore = blockStoreFactory_1.BlockStoreFactory.createS3Store(environment.s3Config);
-        }
-        else if (blockStorePath) {
-            // Validate path accessibility, create if needed
-            await validateDataDir(blockStorePath);
-            blockStore = blockStoreFactory_1.BlockStoreFactory.createDiskStore({
-                storePath: blockStorePath,
-                supportedBlockSizes,
-            });
-            dataDir = blockStorePath;
-        }
-        else {
-            throw new Error('Neither DEV_DATABASE nor BRIGHTCHAIN_BLOCKSTORE_PATH is set. ' +
-                'Set DEV_DATABASE to a pool name for in-memory development mode, ' +
-                'or set BRIGHTCHAIN_BLOCKSTORE_PATH for persistent disk storage.');
-        }
-        // Create BrightDb — uses PersistentHeadRegistry when dataDir is set,
-        // InMemoryHeadRegistry otherwise.
-        // IMPORTANT: name must match what BrightChainMemberInitService uses
-        // (config.memberPoolName) so the head registry keys are consistent across
-        // the plugin's db and the seeding service's db.
-        const db = new db_1.BrightDb(blockStore, dataDir ? { name: environment.memberPoolName, dataDir } : undefined);
-        // Mark the db as connected (no-op for block-store-backed DB, but sets
-        // the isConnected() flag that consumers check).
-        await db.connect();
-        // Register the energy_accounts Model with hydration schema.
-        // The Model satisfies ITypedCollection<IEnergyAccountDto, EnergyAccount>
-        // so EnergyAccountStore can use it directly — no adapter needed.
-        const energyAccountModel = db.model('energy_accounts', { hydration: (0, energyAccountHydration_1.createEnergyAccountHydrationSchema)() });
-        // Initialize stores
-        const memberStore = new brightchain_lib_1.MemberStore(blockStore);
-        const energyStore = new brightchain_lib_1.EnergyAccountStore(energyAccountModel);
-        // Load persisted energy accounts (no-op if no typed collection)
-        try {
-            await energyStore.loadFromStore();
-        }
-        catch (loadError) {
-            const message = loadError instanceof Error ? loadError.message : String(loadError);
-            console.warn(`[BrightChain] Failed to load energy accounts from store, continuing with empty store: ${message}`);
-        }
-        return {
-            success: true,
-            backend: {
-                blockStore,
-                db,
-                memberStore,
-                energyStore,
-            },
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
+    // Domain-specific references captured in the callback
+    let memberStore;
+    let energyStore;
+    const genericResult = await (0, node_express_suite_1.brightchainDatabaseInit)(environment, {
+        modelRegistrations: async (db, blockStore) => {
+            // Register the energy_accounts Model with hydration schema.
+            // The Model satisfies ITypedCollection<IEnergyAccountDto, EnergyAccount>
+            // so EnergyAccountStore can use it directly — no adapter needed.
+            const energyAccountModel = db.model('energy_accounts', { hydration: (0, energyAccountHydration_1.createEnergyAccountHydrationSchema)() });
+            // Initialize stores
+            memberStore = new brightchain_lib_1.MemberStore(blockStore);
+            energyStore = new brightchain_lib_1.EnergyAccountStore(energyAccountModel);
+            // Load persisted energy accounts (no-op if no typed collection)
+            try {
+                await energyStore.loadFromStore();
+            }
+            catch (loadError) {
+                const message = loadError instanceof Error ? loadError.message : String(loadError);
+                console.warn(`[BrightChain] Failed to load energy accounts from store, continuing with empty store: ${message}`);
+            }
+        },
+    });
+    if (!genericResult.success || !genericResult.backend) {
         return {
             success: false,
-            error: `Database initialization failed: ${message}`,
+            error: genericResult.error,
         };
     }
+    return {
+        success: true,
+        backend: {
+            blockStore: genericResult.backend.blockStore,
+            db: genericResult.backend.db,
+            memberStore: memberStore,
+            energyStore: energyStore,
+        },
+    };
 }
 //# sourceMappingURL=databaseInit.js.map

package/src/lib/databaseInit.js.map

@@ -1 +1 @@
-{"version":3,"file":"databaseInit.js","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/databaseInit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"databaseInit.js","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/databaseInit.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA6BH,0DAkDC;AAvED,kEAIsC;AAEtC,wEAAiG;AAGjG,+EAAwF;AAExF;;;;;;;;;GASG;AACI,KAAK,UAAU,uBAAuB,CAC3C,WAA6B;IAE7B,sDAAsD;IACtD,IAAI,WAAoC,CAAC;IACzC,IAAI,WAA2C,CAAC;IAEhD,MAAM,aAAa,GAAG,MAAM,IAAA,4CAAmB,EAAC,WAAW,EAAE;QAC3D,kBAAkB,EAAE,KAAK,EAAE,EAAY,EAAE,UAAuB,EAAE,EAAE;YAClE,4DAA4D;YAC5D,yEAAyE;YACzE,iEAAiE;YACjE,MAAM,kBAAkB,GAAG,EAAE,CAAC,KAAK,CACjC,iBAAiB,EACjB,EAAE,SAAS,EAAE,IAAA,2DAAkC,GAAE,EAAE,CACpD,CAAC;YAEF,oBAAoB;YACpB,WAAW,GAAG,IAAI,6BAAW,CAAC,UAAU,CAAC,CAAC;YAC1C,WAAW,GAAG,IAAI,oCAAkB,CAAC,kBAAkB,CAAC,CAAC;YAEzD,gEAAgE;YAChE,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,aAAa,EAAE,CAAC;YACpC,CAAC;YAAC,OAAO,SAAkB,EAAE,CAAC;gBAC5B,MAAM,OAAO,GACX,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CACV,yFAAyF,OAAO,EAAE,CACnG,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,aAAa,CAAC,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU;YAC5C,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE;YAC5B,WAAW,EAAE,WAAY;YACzB,WAAW,EAAE,WAAY;SAC1B;KACF,CAAC;AACJ,CAAC"}

package/src/lib/datastore/block-document-store-factory.d.ts

@@ -14,6 +14,9 @@ export type BlockDocumentStoreOptions = {
 /**
  * Create a BlockDocumentStore backed by either a provided BlockStore, a disk store, or an in-memory store.
  * Optionally supports encryption via QuorumService.
+ *
+ * This api-lib version automatically injects DiskBlockAsyncStore for disk-backed stores,
+ * maintaining backward compatibility with existing consumers.
  */
 export declare function createBlockDocumentStore(options: BlockDocumentStoreOptions): DocumentStore;
 //# sourceMappingURL=block-document-store-factory.d.ts.map

package/src/lib/datastore/block-document-store-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-document-store-factory.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/datastore/block-document-store-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,cAAc,EAEf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAC5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,aAAa,CAuBf"}
+{"version":3,"file":"block-document-store-factory.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/datastore/block-document-store-factory.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,SAAS,EACT,WAAW,EACX,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,aAAa,CAWf"}

package/src/lib/datastore/block-document-store-factory.js

@@ -1,29 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBlockDocumentStore = createBlockDocumentStore;
-const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+// Re-export the generic factory and options type from @brightchain/node-express-suite
+// with backward-compatible DiskBlockAsyncStore integration
+const node_express_suite_1 = require("@brightchain/node-express-suite");
 const diskBlockAsyncStore_1 = require("../stores/diskBlockAsyncStore");
-const block_document_store_1 = require("./block-document-store");
 /**
  * Create a BlockDocumentStore backed by either a provided BlockStore, a disk store, or an in-memory store.
  * Optionally supports encryption via QuorumService.
+ *
+ * This api-lib version automatically injects DiskBlockAsyncStore for disk-backed stores,
+ * maintaining backward compatibility with existing consumers.
  */
 function createBlockDocumentStore(options) {
-    const blockSize = options.blockSize ?? brightchain_lib_1.BlockSize.Small;
-    if (options.blockStore) {
-        return new block_document_store_1.BlockDocumentStore(options.blockStore, options.quorumService);
-    }
-    if (options.useMemory) {
-        const memoryStore = new brightchain_lib_1.MemoryBlockStore(blockSize);
-        return new block_document_store_1.BlockDocumentStore(memoryStore, options.quorumService);
-    }
-    if (options.storePath) {
-        const diskStore = new diskBlockAsyncStore_1.DiskBlockAsyncStore({
-            storePath: options.storePath,
-            blockSize,
-        });
-        return new block_document_store_1.BlockDocumentStore(diskStore, options.quorumService);
-    }
-    throw new Error('createBlockDocumentStore requires a blockStore, storePath, or useMemory=true');
+    // Convert to suite options, injecting DiskBlockAsyncStore as the disk factory
+    const suiteOptions = {
+        ...options,
+        diskBlockStoreFactory: (opts) => new diskBlockAsyncStore_1.DiskBlockAsyncStore({
+            storePath: opts.storePath,
+            blockSize: opts.blockSize,
+        }),
+    };
+    return (0, node_express_suite_1.createBlockDocumentStore)(suiteOptions);
 }
 //# sourceMappingURL=block-document-store-factory.js.map

package/src/lib/datastore/block-document-store-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"block-document-store-factory.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/datastore/block-document-store-factory.ts"],"names":[],"mappings":";;AA0BA,4DAyBC;AAnDD,kEAKsC;AAEtC,uEAAoE;AACpE,iEAA4D;AAc5D;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,OAAkC;IAElC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,2BAAS,CAAC,KAAK,CAAC;IAEvD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,IAAI,yCAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,IAAI,kCAAgB,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO,IAAI,yCAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,yCAAmB,CAAC;YACxC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS;SACV,CAAC,CAAC;QACH,OAAO,IAAI,yCAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"block-document-store-factory.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/datastore/block-document-store-factory.ts"],"names":[],"mappings":";;AAiCA,4DAaC;AA9CD,sFAAsF;AACtF,2DAA2D;AAC3D,wEAGyC;AAOzC,uEAAoE;AAcpE;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,OAAkC;IAElC,8EAA8E;IAC9E,MAAM,YAAY,GAAmC;QACnD,GAAG,OAAO;QACV,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC9B,IAAI,yCAAmB,CAAC;YACtB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;KACL,CAAC;IACF,OAAO,IAAA,6CAA6B,EAAC,YAAY,CAAC,CAAC;AACrD,CAAC"}

package/src/lib/datastore/block-document-store.d.ts

@@ -1,192 +1,3 @@
-import { IBlockStore, IQuorumService } from '@brightchain/brightchain-lib';
-import { HexString, IIdProvider, Member, PlatformID } from '@digitaldefiance/ecies-lib';
-import { DocumentCollection, DocumentId, DocumentRecord, DocumentStore, QueryBuilder } from './document-store';
-/**
- * Options for creating a document with optional encryption
- */
-export interface CreateDocumentOptions<TID extends PlatformID = Uint8Array> {
-    /**
-     * Whether to encrypt the document using quorum sealing
-     */
-    encrypt?: boolean;
-    /**
-     * The member performing the sealing operation (required if encrypt is true)
-     */
-    agent?: Member<TID>;
-    /**
-     * IDs of members who will receive shares (required if encrypt is true)
-     */
-    memberIds?: TID[];
-    /**
-     * Number of shares required to unseal (defaults to all members)
-     */
-    sharesRequired?: number;
-}
-/**
- * Options for retrieving an encrypted document
- */
-export interface RetrieveDocumentOptions<TID extends PlatformID = Uint8Array> {
-    /**
-     * Members with loaded private keys for decryption (required for encrypted documents)
-     */
-    membersWithPrivateKey?: Member<TID>[];
-}
-/**
- * Metadata stored alongside encrypted documents
- */
-interface EncryptedDocumentMetadata {
-    isEncrypted: boolean;
-    sealedDocumentId?: HexString;
-    memberIds?: HexString[];
-    sharesRequired?: number;
-    createdAt?: string;
-}
-/**
- * Simple in-memory registry for collection head pointers.
- * This maps collection names to their latest index block IDs.
- *
- * In a production system, this would be persisted to a separate
- * key-value store or database. For now, we use a static map
- * that's shared across all BlockDocumentStore instances.
- */
-export declare class CollectionHeadRegistry {
-    private static instance;
-    private readonly heads;
-    private constructor();
-    static getInstance(): CollectionHeadRegistry;
-    getHead(collectionKey: string): string | undefined;
-    setHead(collectionKey: string, indexBlockId: string): void;
-    /**
-     * Generate a unique key for a collection based on store identity and collection name
-     */
-    static makeKey(storeId: string, collectionName: string): string;
-    /**
-     * Clear all heads (useful for testing)
-     */
-    clear(): void;
-}
-declare class BlockCollection<T extends DocumentRecord, TID extends PlatformID = PlatformID> implements DocumentCollection<T> {
-    private readonly store;
-    private readonly collectionName;
-    private readonly quorumService?;
-    private readonly storeId;
-    private readonly generateId;
-    private readonly index;
-    private readonly registryKey;
-    private indexLoaded;
-    private indexLoading;
-    constructor(store: IBlockStore, collectionName: string, quorumService?: IQuorumService<TID> | undefined, storeId?: string, generateId?: () => string);
-    private ensureIndexLoaded;
-    private persistIndex;
-    private resolveBlockId;
-    private writeDoc;
-    private readDoc;
-    private toSingleQuery;
-    private toManyQuery;
-    find(filter?: Partial<T>): QueryBuilder<T[]>;
-    findOne(filter?: Partial<T>): QueryBuilder<T>;
-    findById(id: DocumentId): QueryBuilder<T>;
-    /**
-     * Retrieve a document by ID, decrypting if necessary
-     * @param id - The document ID
-     * @param options - Options for retrieving encrypted documents
-     * @returns The document (decrypted if it was encrypted)
-     */
-    findByIdDecrypted(id: DocumentId, options?: RetrieveDocumentOptions<TID>): Promise<T | null>;
-    /**
-     * Check if a document is encrypted
-     * @param id - The document ID
-     * @returns True if the document is encrypted
-     */
-    isEncrypted(id: DocumentId): Promise<boolean>;
-    /**
-     * Get encryption metadata for a document
-     * @param id - The document ID
-     * @returns The encryption metadata, or null if not encrypted
-     */
-    getEncryptionMetadata(id: DocumentId): Promise<EncryptedDocumentMetadata | null>;
-    /**
-     * Check if a member has access to a document
-     * @param id - The document ID
-     * @param memberId - The member ID to check access for
-     * @returns True if the member has access (either unencrypted or member is in the encryption list)
-     */
-    hasAccess(id: DocumentId, memberId: HexString): Promise<boolean>;
-    /**
-     * Find all documents accessible by a specific member
-     * @param memberId - The member ID to filter by
-     * @param filter - Optional additional filter criteria
-     * @returns Array of documents the member has access to
-     */
-    findAccessibleBy(memberId: HexString, filter?: Partial<T>): Promise<T[]>;
-    /**
-     * Find one document accessible by a specific member
-     * @param memberId - The member ID to filter by
-     * @param filter - Optional additional filter criteria
-     * @returns The first document the member has access to, or null
-     */
-    findOneAccessibleBy(memberId: HexString, filter?: Partial<T>): Promise<T | null>;
-    /**
-     * Count documents accessible by a specific member
-     * @param memberId - The member ID to filter by
-     * @param filter - Optional additional filter criteria
-     * @returns The count of documents the member has access to
-     */
-    countAccessibleBy(memberId: HexString, filter?: Partial<T>): Promise<number>;
-    findOneAndUpdate(filter: Partial<T>, update: Partial<T>): QueryBuilder<T>;
-    findOneAndDelete(filter: Partial<T>): QueryBuilder<T>;
-    findByIdAndUpdate(id: DocumentId, update: Partial<T>): QueryBuilder<T>;
-    findByIdAndDelete(id: DocumentId): QueryBuilder<T>;
-    create(doc: T): Promise<T>;
-    create(doc: T, options?: CreateDocumentOptions<TID>): Promise<T>;
-    insertMany(docs: T[]): Promise<T[]>;
-    updateOne(filter: Partial<T>, update: Partial<T>): Promise<{
-        modifiedCount: number;
-        matchedCount: number;
-    }>;
-    updateMany(filter: Partial<T>, update: Partial<T>): Promise<{
-        modifiedCount: number;
-        matchedCount: number;
-    }>;
-    replaceOne(filter: Partial<T>, doc: T): Promise<{
-        modifiedCount: number;
-        matchedCount: number;
-    }>;
-    deleteOne(filter: Partial<T>): Promise<{
-        deletedCount: number;
-    }>;
-    deleteMany(filter: Partial<T>): Promise<{
-        deletedCount: number;
-    }>;
-    countDocuments(filter?: Partial<T>): Promise<number>;
-    estimatedDocumentCount(): Promise<number>;
-    aggregate<U = unknown>(_pipeline: unknown[]): QueryBuilder<U[]>;
-    distinct(field: keyof T): QueryBuilder<T[keyof T][]>;
-    exists(filter: Partial<T>): Promise<{
-        _id: DocumentId;
-    } | null>;
-    watch(): void;
-    startSession(): unknown;
-}
-export declare class BlockDocumentStore<TID extends PlatformID = PlatformID> implements DocumentStore {
-    private readonly blockStore;
-    private readonly quorumService?;
-    private readonly collections;
-    private readonly storeId;
-    private readonly generateId;
-    constructor(blockStore: IBlockStore, quorumService?: IQuorumService<TID> | undefined, idProvider?: IIdProvider<TID>);
-    /**
-     * Attempt to resolve the ID provider from the global ServiceProvider.
-     * Returns undefined if the ServiceProvider is not yet initialized.
-     */
-    private resolveIdProvider;
-    collection<T extends DocumentRecord>(name: string): DocumentCollection<T>;
-    /**
-     * Get a collection with encryption support
-     * @param name - The collection name
-     * @returns The collection with encryption methods available
-     */
-    encryptedCollection<T extends DocumentRecord>(name: string): BlockCollection<T, TID>;
-}
-export {};
+export type { CreateDocumentOptions, RetrieveDocumentOptions, } from '@brightchain/node-express-suite';
+export { BlockDocumentStore, CollectionHeadRegistry, } from '@brightchain/node-express-suite';
 //# sourceMappingURL=block-document-store.d.ts.map

package/src/lib/datastore/block-document-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-document-store.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/datastore/block-document-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"block-document-store.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/datastore/block-document-store.ts"],"names":[],"mappings":"AACA,YAAY,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC"}