@brightchain/node-express-suite 0.25.0

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

@@ -0,0 +1,83 @@
+export type DocumentId = string;
+export type DocumentRecord = Record<string, unknown> & {
+    _id?: DocumentId;
+};
+export type QueryResultType = DocumentRecord | DocumentRecord[] | unknown[];
+export interface QueryResult<T extends QueryResultType> {
+    exec(): Promise<T | null>;
+    then<TResult1 = T | null, TResult2 = never>(onfulfilled?: ((value: T | null) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+}
+export interface QueryBuilder<T extends QueryResultType> extends QueryResult<T> {
+    select(_: unknown): QueryBuilder<T>;
+    populate(_: unknown): QueryBuilder<T>;
+    sort(_: unknown): QueryBuilder<T>;
+    limit(_: number): QueryBuilder<T>;
+    skip(_: number): QueryBuilder<T>;
+    lean(): QueryBuilder<T>;
+    collation(_: unknown): QueryBuilder<T>;
+    session(_: unknown): QueryBuilder<T>;
+    where(_: unknown): QueryBuilder<T>;
+    distinct(_: unknown): QueryBuilder<T>;
+}
+export interface DocumentCollection<T extends DocumentRecord> {
+    find(filter?: Partial<T>): QueryBuilder<T[]>;
+    findOne(filter?: Partial<T>): QueryBuilder<T>;
+    findById(id: DocumentId): QueryBuilder<T>;
+    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>;
+    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 interface DocumentStore {
+    collection<T extends DocumentRecord>(name: string): DocumentCollection<T>;
+}
+/**
+ * Extended document store interface with lifecycle methods.
+ * Parallel to upstream's IDocumentStore but without Mongoose dependencies.
+ * Implementations should provide connect/disconnect lifecycle and
+ * model retrieval via getModel().
+ */
+export interface IBrightDbDocumentStore extends DocumentStore {
+    /** Connect to the backing store. URI may be ignored by non-network stores. */
+    connect(uri?: string): Promise<void>;
+    /** Disconnect from the backing store. */
+    disconnect(): Promise<void>;
+    /** Whether the store is currently connected and ready for operations. */
+    isConnected(): boolean;
+    /** Retrieve a collection by model name (alias for collection()). */
+    getModel<T extends DocumentRecord>(modelName: string): DocumentCollection<T>;
+    /** Optional: provision a dev/test database. */
+    setupDevStore?(): Promise<string | void>;
+    /** Optional: seed the dev database with initial data. */
+    initializeDevStore?(): Promise<unknown>;
+}
+//# sourceMappingURL=document-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-store.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/datastore/document-store.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-store.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/datastore/document-store.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,6 @@
+export type { CreateDocumentOptions, RetrieveDocumentOptions, } from './block-document-store';
+export { BlockDocumentStore, CollectionHeadRegistry } from './block-document-store';
+export * from './block-document-store-factory';
+export * from './document-store';
+export * from './memory-document-store';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/datastore/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACpF,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/src/lib/datastore/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionHeadRegistry = exports.BlockDocumentStore = void 0;
+const tslib_1 = require("tslib");
+var block_document_store_1 = require("./block-document-store");
+Object.defineProperty(exports, "BlockDocumentStore", { enumerable: true, get: function () { return block_document_store_1.BlockDocumentStore; } });
+Object.defineProperty(exports, "CollectionHeadRegistry", { enumerable: true, get: function () { return block_document_store_1.CollectionHeadRegistry; } });
+tslib_1.__exportStar(require("./block-document-store-factory"), exports);
+tslib_1.__exportStar(require("./document-store"), exports);
+tslib_1.__exportStar(require("./memory-document-store"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/datastore/index.ts"],"names":[],"mappings":";;;;AAIA,+DAAoF;AAA3E,0HAAA,kBAAkB,OAAA;AAAE,8HAAA,sBAAsB,OAAA;AACnD,yEAA+C;AAC/C,2DAAiC;AACjC,kEAAwC"}

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

@@ -0,0 +1,9 @@
+import { IIdProvider, PlatformID } from '@digitaldefiance/ecies-lib';
+import { DocumentCollection, DocumentRecord, DocumentStore } from './document-store';
+export declare class MemoryDocumentStore implements DocumentStore {
+    private readonly collections;
+    private readonly generateId;
+    constructor(idProvider?: IIdProvider<PlatformID>);
+    collection<T extends DocumentRecord>(name: string): DocumentCollection<T>;
+}
+//# sourceMappingURL=memory-document-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-document-store.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/datastore/memory-document-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EACL,kBAAkB,EAElB,cAAc,EACd,aAAa,EAGd,MAAM,kBAAkB,CAAC;AA4P1B,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IACJ,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;gBAE9B,UAAU,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC;IAIhD,UAAU,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC;CAS1E"}

package/src/lib/datastore/memory-document-store.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryDocumentStore = void 0;
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+const crypto_1 = require("crypto");
+/**
+ * Resolve an ID generator function from the given provider, or fall back
+ * to the global ServiceProvider, or finally to crypto.randomUUID().
+ */
+function resolveIdGenerator(idProvider) {
+    if (idProvider) {
+        return () => idProvider.serialize(idProvider.generate());
+    }
+    try {
+        const provider = brightchain_lib_1.ServiceProvider.getInstance().idProvider;
+        return () => provider.serialize(provider.generate());
+    }
+    catch {
+        return () => (0, crypto_1.randomUUID)();
+    }
+}
+// In-memory implementation of QueryBuilder for document queries
+class MemoryQuery {
+    resolveValue;
+    constructor(resolveValue) {
+        this.resolveValue = resolveValue;
+    }
+    self() {
+        return this;
+    }
+    select() {
+        return this.self();
+    }
+    populate() {
+        return this.self();
+    }
+    sort() {
+        return this.self();
+    }
+    limit() {
+        return this.self();
+    }
+    skip() {
+        return this.self();
+    }
+    lean() {
+        return this.self();
+    }
+    collation() {
+        return this.self();
+    }
+    session() {
+        return this.self();
+    }
+    where() {
+        return this.self();
+    }
+    distinct() {
+        return this.self();
+    }
+    async exec() {
+        return this.resolveValue();
+    }
+    then(onfulfilled, onrejected) {
+        return this.exec().then(onfulfilled, onrejected);
+    }
+}
+function matchFilter(doc, filter = {}) {
+    return Object.entries(filter).every(([key, value]) => {
+        if (value === undefined)
+            return true;
+        return doc[key] === value;
+    });
+}
+function ensureId(doc, generateId) {
+    if (!doc._id) {
+        doc._id = generateId();
+    }
+    return doc;
+}
+class MemoryCollection {
+    generateId;
+    data = [];
+    constructor(generateId) {
+        this.generateId = generateId;
+    }
+    querySingle(filter) {
+        return new MemoryQuery(async () => {
+            const found = this.data.find((doc) => matchFilter(doc, filter));
+            return found ?? null;
+        });
+    }
+    queryMany(filter) {
+        return new MemoryQuery(async () => this.data.filter((doc) => matchFilter(doc, filter)));
+    }
+    find(filter) {
+        return this.queryMany(filter);
+    }
+    findOne(filter) {
+        return this.querySingle(filter);
+    }
+    findById(id) {
+        return this.querySingle({ _id: id });
+    }
+    findOneAndUpdate(filter, update) {
+        return new MemoryQuery(async () => {
+            const doc = this.data.find((d) => matchFilter(d, filter));
+            if (!doc)
+                return null;
+            Object.assign(doc, update);
+            return doc;
+        });
+    }
+    findOneAndDelete(filter) {
+        return new MemoryQuery(async () => {
+            const idx = this.data.findIndex((d) => matchFilter(d, filter));
+            if (idx === -1)
+                return null;
+            const [removed] = this.data.splice(idx, 1);
+            return removed ?? null;
+        });
+    }
+    findByIdAndUpdate(id, update) {
+        return this.findOneAndUpdate({ _id: id }, update);
+    }
+    findByIdAndDelete(id) {
+        return this.findOneAndDelete({ _id: id });
+    }
+    async create(doc) {
+        const withId = ensureId({ ...doc }, this.generateId);
+        this.data.push(withId);
+        return withId;
+    }
+    async insertMany(docs) {
+        const inserted = docs.map((d) => ensureId({ ...d }, this.generateId));
+        this.data.push(...inserted);
+        return inserted;
+    }
+    async updateOne(filter, update) {
+        const doc = this.data.find((d) => matchFilter(d, filter));
+        if (!doc)
+            return { modifiedCount: 0, matchedCount: 0 };
+        Object.assign(doc, update);
+        return { modifiedCount: 1, matchedCount: 1 };
+    }
+    async updateMany(filter, update) {
+        const matches = this.data.filter((d) => matchFilter(d, filter));
+        matches.forEach((doc) => Object.assign(doc, update));
+        return { modifiedCount: matches.length, matchedCount: matches.length };
+    }
+    async replaceOne(filter, doc) {
+        const idx = this.data.findIndex((d) => matchFilter(d, filter));
+        if (idx === -1)
+            return { modifiedCount: 0, matchedCount: 0 };
+        this.data[idx] = ensureId({ ...doc }, this.generateId);
+        return { modifiedCount: 1, matchedCount: 1 };
+    }
+    async deleteOne(filter) {
+        const idx = this.data.findIndex((d) => matchFilter(d, filter));
+        if (idx === -1)
+            return { deletedCount: 0 };
+        this.data.splice(idx, 1);
+        return { deletedCount: 1 };
+    }
+    async deleteMany(filter) {
+        const before = this.data.length;
+        const remaining = this.data.filter((d) => !matchFilter(d, filter));
+        const deletedCount = before - remaining.length;
+        this.data.length = 0;
+        this.data.push(...remaining);
+        return { deletedCount };
+    }
+    async countDocuments(filter) {
+        return this.data.filter((d) => matchFilter(d, filter)).length;
+    }
+    async estimatedDocumentCount() {
+        return this.data.length;
+    }
+    aggregate(_pipeline) {
+        return new MemoryQuery(async () => []);
+    }
+    distinct(field) {
+        return new MemoryQuery(async () => {
+            const values = new Set();
+            for (const doc of this.data) {
+                const value = doc[field];
+                if (value !== undefined)
+                    values.add(value);
+            }
+            return Array.from(values);
+        });
+    }
+    async exists(filter) {
+        const doc = this.data.find((d) => matchFilter(d, filter));
+        return doc ? { _id: doc._id } : null;
+    }
+    watch() {
+        /* noop */
+    }
+    startSession() {
+        return undefined;
+    }
+}
+class MemoryDocumentStore {
+    collections = new Map();
+    generateId;
+    constructor(idProvider) {
+        this.generateId = resolveIdGenerator(idProvider);
+    }
+    collection(name) {
+        if (!this.collections.has(name)) {
+            this.collections.set(name, new MemoryCollection(this.generateId));
+        }
+        return this.collections.get(name);
+    }
+}
+exports.MemoryDocumentStore = MemoryDocumentStore;
+//# sourceMappingURL=memory-document-store.js.map

package/src/lib/datastore/memory-document-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-document-store.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/datastore/memory-document-store.ts"],"names":[],"mappings":";;;AAAA,kEAA+D;AAE/D,mCAAoC;AAUpC;;;GAGG;AACH,SAAS,kBAAkB,CACzB,UAAoC;IAEpC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,iCAAe,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC;QAC1D,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,EAAE,CAAC,IAAA,mBAAU,GAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,WAAW;IACE,YAAY,CAA0B;IAEvD,YAAY,YAAqC;QAC/C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,CACF,WAGQ,EACR,UAGQ;QAER,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;CACF;AAED,SAAS,WAAW,CAClB,GAAM,EACN,SAAqB,EAAE;IAEvB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACnD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,OAAQ,GAA+B,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CACf,GAAmB,EACnB,UAAwB;IAExB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,gBAAgB;IAKS;IAFZ,IAAI,GAAQ,EAAE,CAAC;IAEhC,YAA6B,UAAwB;QAAxB,eAAU,GAAV,UAAU,CAAc;IAAG,CAAC;IAEjD,WAAW,CAAC,MAAmB;QACrC,OAAO,IAAI,WAAW,CAAI,KAAK,IAAI,EAAE;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,OAAO,KAAK,IAAI,IAAI,CAAC;QACvB,CAAC,CAAoB,CAAC;IACxB,CAAC;IAEO,SAAS,CAAC,MAAmB;QACnC,OAAO,IAAI,WAAW,CAAM,KAAK,IAAI,EAAE,CACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAC/B,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,MAAmB;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,MAAmB;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,EAAc;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,EAAgB,CAAC,CAAC;IACrD,CAAC;IAED,gBAAgB,CAAC,MAAkB,EAAE,MAAkB;QACrD,OAAO,IAAI,WAAW,CAAI,KAAK,IAAI,EAAE;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC3B,OAAO,GAAG,CAAC;QACb,CAAC,CAAoB,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,MAAkB;QACjC,OAAO,IAAI,WAAW,CAAI,KAAK,IAAI,EAAE;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAC/D,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5B,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC3C,OAAO,OAAO,IAAI,IAAI,CAAC;QACzB,CAAC,CAAoB,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,EAAc,EAAE,MAAkB;QAClD,OAAO,IAAI,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,EAAE,EAAgB,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,iBAAiB,CAAC,EAAc;QAC9B,OAAO,IAAI,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,EAAE,EAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAM;QACjB,MAAM,MAAM,GAAG,QAAQ,CACrB,EAAE,GAAI,GAAsB,EAAE,EAC9B,IAAI,CAAC,UAAU,CACX,CAAC;QACP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAS;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAI,CAAoB,EAAE,EAAE,IAAI,CAAC,UAAU,CAAM,CACpE,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAkB,EAAE,MAAkB;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAkB,EAAE,MAAkB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACrD,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAkB,EAAE,GAAM;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CACvB,EAAE,GAAI,GAAsB,EAAE,EAC9B,IAAI,CAAC,UAAU,CACX,CAAC;QACP,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAkB;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAkB;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAmB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,SAAS,CAAc,SAAoB;QACzC,OAAO,IAAI,WAAW,CAAM,KAAK,IAAI,EAAE,CAAC,EAAE,CAAsB,CAAC;IACnE,CAAC;IAED,QAAQ,CAAC,KAAc;QACrB,OAAO,IAAI,WAAW,CAAe,KAAK,IAAI,EAAE;YAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAc,CAAC;YACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;gBACzB,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,GAAG,CAAC,KAAmB,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAA+B,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAkB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAG,GAAsB,CAAC,GAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IAED,KAAK;QACH,UAAU;IACZ,CAAC;IAED,YAAY;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,MAAa,mBAAmB;IACb,WAAW,GAAG,IAAI,GAAG,EAGnC,CAAC;IACa,UAAU,CAAe;IAE1C,YAAY,UAAoC;QAC9C,IAAI,CAAC,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,UAAU,CAA2B,IAAY;QAC/C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAClB,IAAI,EACJ,IAAI,gBAAgB,CAAiB,IAAI,CAAC,UAAU,CAAC,CACtD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAwB,CAAC;IAC3D,CAAC;CACF;AApBD,kDAoBC"}

package/src/lib/environment.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview BrightDbEnvironment — generic BrightDB-specific environment configuration.
+ *
+ * Extends the upstream BaseEnvironment with BrightDB block store configuration:
+ * block store path, block sizes, store type, cloud configs (Azure, S3),
+ * dev database pool name, and memory document store flag.
+ *
+ * Domain-specific env vars (UPnP, FontAwesome, AWS credentials, etc.)
+ * remain in api-lib's Environment subclass.
+ *
+ * @module environment
+ */
+import { Environment as BaseEnvironment, IConstants } from '@digitaldefiance/node-express-suite';
+import { BlockSize, BlockStoreType } from '@brightchain/brightchain-lib';
+import { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import { IAzureEnvironmentConfig, IS3EnvironmentConfig } from './interfaces/environment';
+import { DefaultBackendIdType } from './shared-types';
+export declare class BrightDbEnvironment<TID extends PlatformID = DefaultBackendIdType> extends BaseEnvironment<TID> {
+    protected _blockStorePath?: string;
+    protected _blockStoreBlockSizes: BlockSize[];
+    protected _useMemoryDocumentStore: boolean;
+    protected _devDatabasePoolName: string | undefined;
+    protected _blockStoreType: BlockStoreType;
+    protected _azureConfig?: IAzureEnvironmentConfig;
+    protected _s3Config?: IS3EnvironmentConfig;
+    protected _memberPoolName: string;
+    constructor(path?: string, initialization?: boolean, override?: boolean, constants?: IConstants);
+    get blockStorePath(): string | undefined;
+    /**
+     * Configured block sizes for block-backed document store (plural).
+     * Parsed from the comma-separated `BRIGHTCHAIN_BLOCKSIZE_BYTES` env var.
+     */
+    get blockStoreBlockSizes(): readonly BlockSize[];
+    /**
+     * @deprecated Use `blockStoreBlockSizes` instead. Returns the first configured block size.
+     */
+    get blockStoreBlockSize(): BlockSize;
+    get useMemoryDocumentStore(): boolean;
+    /**
+     * Pool name for the in-memory dev database.
+     * Set when `DEV_DATABASE` env var is a non-empty string; `undefined` otherwise.
+     */
+    get devDatabasePoolName(): string | undefined;
+    /**
+     * The active block store backend type.
+     * Defaults to `BlockStoreType.Disk` when `BRIGHTCHAIN_BLOCKSTORE_TYPE` is unset.
+     */
+    get blockStoreType(): BlockStoreType;
+    /**
+     * Azure Blob Storage configuration.
+     * Only populated when `blockStoreType` is `BlockStoreType.AzureBlob`.
+     */
+    get azureConfig(): IAzureEnvironmentConfig | undefined;
+    /**
+     * Amazon S3 configuration.
+     * Only populated when `blockStoreType` is `BlockStoreType.S3`.
+     */
+    get s3Config(): IS3EnvironmentConfig | undefined;
+    /**
+     * Member pool name (e.g. 'BrightChain')
+     */
+    get memberPoolName(): string;
+}
+//# sourceMappingURL=environment.d.ts.map

package/src/lib/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,WAAW,IAAI,eAAe,EAC9B,UAAU,EACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,SAAS,EACT,cAAc,EAEf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,qBAAa,mBAAmB,CAAC,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC5E,SAAQ,eAAe,CAAC,GAAG,CAAC;IAE5B,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,qBAAqB,EAAE,SAAS,EAAE,CAAC;IAC7C,SAAS,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC3C,SAAS,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,SAAS,CAAC,eAAe,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACjD,SAAS,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC3C,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;gBAGhC,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,UAAQ,EACtB,QAAQ,UAAO,EACf,SAAS,CAAC,EAAE,UAAU;IAkHxB,IAAW,cAAc,IAAI,MAAM,GAAG,SAAS,CAE9C;IAED;;;OAGG;IACH,IAAW,oBAAoB,IAAI,SAAS,SAAS,EAAE,CAEtD;IAED;;OAEG;IACH,IAAW,mBAAmB,IAAI,SAAS,CAE1C;IAED,IAAW,sBAAsB,IAAI,OAAO,CAE3C;IAED;;;OAGG;IACH,IAAW,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAEnD;IAED;;;OAGG;IACH,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,uBAAuB,GAAG,SAAS,CAE5D;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,oBAAoB,GAAG,SAAS,CAEtD;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,MAAM,CAElC;CACF"}

package/src/lib/environment.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * @fileoverview BrightDbEnvironment — generic BrightDB-specific environment configuration.
+ *
+ * Extends the upstream BaseEnvironment with BrightDB block store configuration:
+ * block store path, block sizes, store type, cloud configs (Azure, S3),
+ * dev database pool name, and memory document store flag.
+ *
+ * Domain-specific env vars (UPnP, FontAwesome, AWS credentials, etc.)
+ * remain in api-lib's Environment subclass.
+ *
+ * @module environment
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbEnvironment = void 0;
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+class BrightDbEnvironment extends node_express_suite_1.Environment {
+    _blockStorePath;
+    _blockStoreBlockSizes;
+    _useMemoryDocumentStore;
+    _devDatabasePoolName;
+    _blockStoreType;
+    _azureConfig;
+    _s3Config;
+    _memberPoolName;
+    constructor(path, initialization = false, override = true, constants) {
+        super(path, initialization, override, constants);
+        const envObj = this.getObject();
+        // --- Block store path ---
+        this._blockStorePath =
+            envObj['BRIGHTCHAIN_BLOCKSTORE_PATH'] ?? envObj['BLOCKSTORE_PATH'];
+        // --- Block sizes ---
+        const rawBlockSizes = envObj['BRIGHTCHAIN_BLOCKSIZE_BYTES'];
+        if (rawBlockSizes) {
+            const parsed = rawBlockSizes
+                .split(',')
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0)
+                .map((s) => Number.parseInt(s, 10));
+            // Validate each parsed value is a known BlockSize
+            const validated = parsed.filter((bs) => brightchain_lib_1.validBlockSizes.includes(bs));
+            this._blockStoreBlockSizes =
+                validated.length > 0 ? validated : [brightchain_lib_1.BlockSize.Medium];
+        }
+        else {
+            this._blockStoreBlockSizes = [brightchain_lib_1.BlockSize.Medium];
+        }
+        // --- Memory document store ---
+        this._useMemoryDocumentStore = Boolean(envObj['USE_MEMORY_DOCSTORE']);
+        // --- Dev database pool name ---
+        const devDatabase = envObj['DEV_DATABASE'];
+        this._devDatabasePoolName =
+            devDatabase && devDatabase.trim() !== '' ? devDatabase.trim() : undefined;
+        if (this._devDatabasePoolName !== undefined) {
+            this._useMemoryDocumentStore = true;
+        }
+        // --- Member pool name ---
+        this._memberPoolName = envObj['MEMBER_POOL_NAME'] ?? 'BrightChain';
+        // --- Block store type ---
+        const rawStoreType = (envObj['BRIGHTCHAIN_BLOCKSTORE_TYPE'] ?? 'disk').toLowerCase();
+        if (!Object.values(brightchain_lib_1.BlockStoreType).includes(rawStoreType)) {
+            throw new Error(`Invalid BRIGHTCHAIN_BLOCKSTORE_TYPE "${rawStoreType}". ` +
+                `Valid values: ${Object.values(brightchain_lib_1.BlockStoreType).join(', ')}`);
+        }
+        this._blockStoreType = rawStoreType;
+        // --- Azure Blob Storage config ---
+        if (this._blockStoreType === brightchain_lib_1.BlockStoreType.AzureBlob) {
+            const connectionString = envObj['AZURE_STORAGE_CONNECTION_STRING'];
+            const accountName = envObj['AZURE_STORAGE_ACCOUNT_NAME'];
+            const containerName = envObj['AZURE_STORAGE_CONTAINER_NAME'];
+            const missing = [];
+            if (!connectionString && !accountName) {
+                missing.push('AZURE_STORAGE_CONNECTION_STRING or AZURE_STORAGE_ACCOUNT_NAME');
+            }
+            if (!containerName) {
+                missing.push('AZURE_STORAGE_CONTAINER_NAME');
+            }
+            if (missing.length > 0) {
+                throw new Error(`Missing required environment variables for Azure block store: ${missing.join(', ')}`);
+            }
+            this._azureConfig = {
+                region: envObj['AWS_REGION'] ?? 'eastus',
+                containerOrBucketName: containerName,
+                supportedBlockSizes: this._blockStoreBlockSizes,
+                connectionString: connectionString,
+                accountName: accountName,
+                accountKey: envObj['AZURE_STORAGE_ACCOUNT_KEY'],
+                useManagedIdentity: !connectionString && !envObj['AZURE_STORAGE_ACCOUNT_KEY'],
+            };
+        }
+        // --- S3 config ---
+        if (this._blockStoreType === brightchain_lib_1.BlockStoreType.S3) {
+            const bucketName = envObj['AWS_S3_BUCKET_NAME'];
+            if (!bucketName) {
+                throw new Error('Missing required environment variable for S3 block store: AWS_S3_BUCKET_NAME');
+            }
+            this._s3Config = {
+                region: envObj['AWS_REGION'] ?? 'us-east-1',
+                containerOrBucketName: bucketName,
+                supportedBlockSizes: this._blockStoreBlockSizes,
+                keyPrefix: envObj['AWS_S3_KEY_PREFIX'],
+                accessKeyId: envObj['AWS_ACCESS_KEY_ID'],
+                secretAccessKey: envObj['AWS_SECRET_ACCESS_KEY'],
+                useIamRole: !envObj['AWS_ACCESS_KEY_ID'] && !envObj['AWS_SECRET_ACCESS_KEY'],
+            };
+        }
+    }
+    // ── Accessors ──────────────────────────────────────────────────────
+    get blockStorePath() {
+        return this._blockStorePath;
+    }
+    /**
+     * Configured block sizes for block-backed document store (plural).
+     * Parsed from the comma-separated `BRIGHTCHAIN_BLOCKSIZE_BYTES` env var.
+     */
+    get blockStoreBlockSizes() {
+        return this._blockStoreBlockSizes;
+    }
+    /**
+     * @deprecated Use `blockStoreBlockSizes` instead. Returns the first configured block size.
+     */
+    get blockStoreBlockSize() {
+        return this._blockStoreBlockSizes[0];
+    }
+    get useMemoryDocumentStore() {
+        return this._useMemoryDocumentStore || !this._blockStorePath;
+    }
+    /**
+     * Pool name for the in-memory dev database.
+     * Set when `DEV_DATABASE` env var is a non-empty string; `undefined` otherwise.
+     */
+    get devDatabasePoolName() {
+        return this._devDatabasePoolName;
+    }
+    /**
+     * The active block store backend type.
+     * Defaults to `BlockStoreType.Disk` when `BRIGHTCHAIN_BLOCKSTORE_TYPE` is unset.
+     */
+    get blockStoreType() {
+        return this._blockStoreType;
+    }
+    /**
+     * Azure Blob Storage configuration.
+     * Only populated when `blockStoreType` is `BlockStoreType.AzureBlob`.
+     */
+    get azureConfig() {
+        return this._azureConfig;
+    }
+    /**
+     * Amazon S3 configuration.
+     * Only populated when `blockStoreType` is `BlockStoreType.S3`.
+     */
+    get s3Config() {
+        return this._s3Config;
+    }
+    /**
+     * Member pool name (e.g. 'BrightChain')
+     */
+    get memberPoolName() {
+        return this._memberPoolName;
+    }
+}
+exports.BrightDbEnvironment = BrightDbEnvironment;
+//# sourceMappingURL=environment.js.map

package/src/lib/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/environment.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,4EAG6C;AAC7C,kEAIsC;AAQtC,MAAa,mBACX,SAAQ,gCAAoB;IAElB,eAAe,CAAU;IACzB,qBAAqB,CAAc;IACnC,uBAAuB,CAAU;IACjC,oBAAoB,CAAqB;IACzC,eAAe,CAAiB;IAChC,YAAY,CAA2B;IACvC,SAAS,CAAwB;IACjC,eAAe,CAAS;IAElC,YACE,IAAa,EACb,cAAc,GAAG,KAAK,EACtB,QAAQ,GAAG,IAAI,EACf,SAAsB;QAEtB,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,2BAA2B;QAC3B,IAAI,CAAC,eAAe;YAClB,MAAM,CAAC,6BAA6B,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAErE,sBAAsB;QACtB,MAAM,aAAa,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;QAC5D,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,aAAa;iBACzB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBAC5B,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;iBACnC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAc,CAAC,CAAC;YAC3D,kDAAkD;YAClD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAa,EAAE,EAAE,CAChD,iCAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAC7B,CAAC;YACF,IAAI,CAAC,qBAAqB;gBACxB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,2BAAS,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,qBAAqB,GAAG,CAAC,2BAAS,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,gCAAgC;QAChC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAEtE,iCAAiC;QACjC,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QAC3C,IAAI,CAAC,oBAAoB;YACvB,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;QACtC,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,kBAAkB,CAAC,IAAI,aAAa,CAAC;QAEnE,2BAA2B;QAC3B,MAAM,YAAY,GAAG,CACnB,MAAM,CAAC,6BAA6B,CAAC,IAAI,MAAM,CAChD,CAAC,WAAW,EAAE,CAAC;QAChB,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,gCAAc,CAAC,CAAC,QAAQ,CAAC,YAA8B,CAAC,EACvE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,wCAAwC,YAAY,KAAK;gBACvD,iBAAiB,MAAM,CAAC,MAAM,CAAC,gCAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,YAA8B,CAAC;QAEtD,oCAAoC;QACpC,IAAI,IAAI,CAAC,eAAe,KAAK,gCAAc,CAAC,SAAS,EAAE,CAAC;YACtD,MAAM,gBAAgB,GAAG,MAAM,CAAC,iCAAiC,CAAC,CAAC;YACnE,MAAM,WAAW,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACzD,MAAM,aAAa,GAAG,MAAM,CAAC,8BAA8B,CAAC,CAAC;YAE7D,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CACV,+DAA+D,CAChE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,iEAAiE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,YAAY,GAAG;gBAClB,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,QAAQ;gBACxC,qBAAqB,EAAE,aAAc;gBACrC,mBAAmB,EAAE,IAAI,CAAC,qBAAqB;gBAC/C,gBAAgB,EAAE,gBAAgB;gBAClC,WAAW,EAAE,WAAW;gBACxB,UAAU,EAAE,MAAM,CAAC,2BAA2B,CAAC;gBAC/C,kBAAkB,EAChB,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC;aAC5D,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IAAI,IAAI,CAAC,eAAe,KAAK,gCAAc,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAEhD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,SAAS,GAAG;gBACf,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW;gBAC3C,qBAAqB,EAAE,UAAU;gBACjC,mBAAmB,EAAE,IAAI,CAAC,qBAAqB;gBAC/C,SAAS,EAAE,MAAM,CAAC,mBAAmB,CAAC;gBACtC,WAAW,EAAE,MAAM,CAAC,mBAAmB,CAAC;gBACxC,eAAe,EAAE,MAAM,CAAC,uBAAuB,CAAC;gBAChD,UAAU,EACR,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;aACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sEAAsE;IAEtE,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAW,oBAAoB;QAC7B,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAW,mBAAmB;QAC5B,OAAO,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,IAAW,sBAAsB;QAC/B,OAAO,IAAI,CAAC,uBAAuB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,IAAW,mBAAmB;QAC5B,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF;AA/LD,kDA+LC"}

package/src/lib/factories/blockStoreFactory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Re-export BlockStoreFactory from brightchain-lib.
+ *
+ * The new library does NOT register any disk store factory — that's the
+ * responsibility of api-lib (which imports DiskBlockAsyncStore, a Node.js-
+ * specific implementation). This module simply provides a convenient
+ * import path for consumers.
+ */
+export { BlockStoreFactory } from '@brightchain/brightchain-lib';
+//# sourceMappingURL=blockStoreFactory.d.ts.map

package/src/lib/factories/blockStoreFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockStoreFactory.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/factories/blockStoreFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/src/lib/factories/blockStoreFactory.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockStoreFactory = void 0;
+/**
+ * Re-export BlockStoreFactory from brightchain-lib.
+ *
+ * The new library does NOT register any disk store factory — that's the
+ * responsibility of api-lib (which imports DiskBlockAsyncStore, a Node.js-
+ * specific implementation). This module simply provides a convenient
+ * import path for consumers.
+ */
+var brightchain_lib_1 = require("@brightchain/brightchain-lib");
+Object.defineProperty(exports, "BlockStoreFactory", { enumerable: true, get: function () { return brightchain_lib_1.BlockStoreFactory; } });
+//# sourceMappingURL=blockStoreFactory.js.map

package/src/lib/factories/blockStoreFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockStoreFactory.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/factories/blockStoreFactory.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,gEAAiE;AAAxD,oHAAA,iBAAiB,OAAA"}