@brightchain/db 0.20.0

package/src/lib/expressMiddleware.js

@@ -0,0 +1,488 @@
+"use strict";
+/**
+ * Express middleware/router for BrightChainDb.
+ *
+ * Provides a REST API for interacting with the document database:
+ *
+ *   GET    /:collection                      - Find documents (query params as filter)
+ *   GET    /:collection/:id                  - Find document by ID
+ *   POST   /:collection                      - Insert one document (body = document)
+ *   POST   /:collection/find                 - Find with rich filter (body = { filter, sort, limit, skip, projection })
+ *   POST   /:collection/aggregate            - Aggregation pipeline (body = { pipeline })
+ *   PUT    /:collection/:id                  - Replace document
+ *   PATCH  /:collection/:id                  - Update document (body = update operators)
+ *   DELETE /:collection/:id                  - Delete document by ID
+ *   POST   /:collection/insertMany           - Bulk insert (body = { documents })
+ *   POST   /:collection/updateMany           - Bulk update (body = { filter, update })
+ *   POST   /:collection/deleteMany           - Bulk delete (body = { filter })
+ *   POST   /:collection/count                - Count documents (body = { filter })
+ *   POST   /:collection/distinct             - Distinct values (body = { field, filter })
+ *   POST   /:collection/indexes              - Create index (body = { spec, options })
+ *   DELETE /:collection/indexes/:name         - Drop index
+ *   GET    /:collection/indexes              - List indexes
+ *   POST   /:collection/bulkWrite            - Bulk write operations
+ *   POST   /:collection/cursor               - Create a server-side cursor
+ *   GET    /cursors/:cursorId                 - Fetch next batch from cursor
+ *   DELETE /cursors/:cursorId                 - Close a cursor
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDbRouter = createDbRouter;
+/**
+ * Create an Express router that provides REST access to a BrightChainDb instance.
+ *
+ * @param db - The database instance
+ * @param options - Router options
+ * @returns Express router
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { BrightChainDb, createDbRouter } from '@brightchain/db';
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * const db = new BrightChainDb(blockStore);
+ * app.use('/api/db', createDbRouter(db));
+ * ```
+ */
+function createDbRouter(db, options) {
+    // Dynamic import to avoid hard dependency on express at module level
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const express = require('express');
+    const router = express.Router();
+    const maxResults = options?.maxResults ?? 1000;
+    function checkCollection(collectionName, res) {
+        if (options?.allowedCollections &&
+            !options.allowedCollections.includes(collectionName)) {
+            res
+                .status(403)
+                .json({ error: `Collection "${collectionName}" is not allowed` });
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Extract a route param as a plain string.
+     * Express 5 types declare params values as `string | string[]`;
+     * for our named `:param` routes the value is always a string.
+     */
+    function param(req, name) {
+        const v = req.params[name];
+        return Array.isArray(v) ? v[0] : v;
+    }
+    // ── Get next batch from cursor ──
+    // (Must be before /:collection/:id to avoid matching 'cursors' as a collection)
+    router.get('/cursors/:cursorId', async (req, res) => {
+        const cursorId = param(req, 'cursorId');
+        try {
+            const batch = db.getNextBatch(cursorId);
+            if (batch === null) {
+                res.status(404).json({ error: 'Cursor not found or expired' });
+                return;
+            }
+            const cursor = db.getCursorSession(cursorId);
+            const coll = db.collection(cursor.collection);
+            const docs = [];
+            for (const id of batch) {
+                const doc = await coll.findById(id);
+                if (doc)
+                    docs.push(doc);
+            }
+            res.json({
+                cursorId,
+                nextBatch: docs,
+                hasMore: cursor.position < cursor.documentIds.length,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Close cursor ──
+    // (Must be before /:collection/:id to avoid matching 'cursors' as a collection)
+    router.delete('/cursors/:cursorId', (req, res) => {
+        const cursorId = param(req, 'cursorId');
+        const closed = db.closeCursorSession(cursorId);
+        if (!closed) {
+            res.status(404).json({ error: 'Cursor not found' });
+            return;
+        }
+        res.json({ acknowledged: true });
+    });
+    // ── List indexes ──
+    router.get('/:collection/indexes', (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const indexes = coll.listIndexes();
+            res.json({ indexes });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Find by ID ──
+    router.get('/:collection/:id', async (req, res) => {
+        const collection = param(req, 'collection');
+        const id = param(req, 'id');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const doc = await coll.findById(id);
+            if (!doc) {
+                res.status(404).json({ error: 'Document not found' });
+                return;
+            }
+            res.json(doc);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Find documents (query string filter) ──
+    router.get('/:collection', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const filter = parseQueryFilter(req.query);
+            const docs = await coll.find(filter).limit(maxResults).toArray();
+            res.json(docs);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Insert one ──
+    router.post('/:collection', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const result = await coll.insertOne(req.body);
+            res.status(201).json(result);
+        }
+        catch (err) {
+            if (isDuplicateKeyError(err)) {
+                res.status(409).json({ error: String(err) });
+                return;
+            }
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Find with rich filter ──
+    router.post('/:collection/find', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { filter, sort, limit, skip, projection } = req.body ?? {};
+            let cursor = coll.find(filter ?? {});
+            if (sort)
+                cursor = cursor.sort(sort);
+            if (skip)
+                cursor = cursor.skip(skip);
+            cursor = cursor.limit(Math.min(limit ?? maxResults, maxResults));
+            if (projection)
+                cursor = cursor.project(projection);
+            const docs = await cursor.toArray();
+            res.json(docs);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Aggregation ──
+    router.post('/:collection/aggregate', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { pipeline } = req.body ?? {};
+            if (!Array.isArray(pipeline)) {
+                res.status(400).json({ error: 'pipeline must be an array' });
+                return;
+            }
+            const result = await coll.aggregate(pipeline);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Insert many ──
+    router.post('/:collection/insertMany', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { documents } = req.body ?? {};
+            if (!Array.isArray(documents)) {
+                res.status(400).json({ error: 'documents must be an array' });
+                return;
+            }
+            const result = await coll.insertMany(documents);
+            res.status(201).json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Update many ──
+    router.post('/:collection/updateMany', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { filter, update } = req.body ?? {};
+            const result = await coll.updateMany(filter ?? {}, update ?? {});
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Delete many ──
+    router.post('/:collection/deleteMany', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { filter } = req.body ?? {};
+            const result = await coll.deleteMany(filter ?? {});
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Count ──
+    router.post('/:collection/count', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { filter } = req.body ?? {};
+            const count = await coll.countDocuments(filter ?? {});
+            res.json({ count });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Distinct ──
+    router.post('/:collection/distinct', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { field, filter } = req.body ?? {};
+            if (!field) {
+                res.status(400).json({ error: 'field is required' });
+                return;
+            }
+            const values = await coll.distinct(field, filter ?? {});
+            res.json({ values });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Create index ──
+    router.post('/:collection/indexes', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { spec, options: indexOptions } = req.body ?? {};
+            if (!spec || typeof spec !== 'object') {
+                res
+                    .status(400)
+                    .json({ error: 'spec is required and must be an object' });
+                return;
+            }
+            const name = await coll.createIndex(spec, indexOptions ?? {});
+            res.status(201).json({ name });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Drop index ──
+    router.delete('/:collection/indexes/:name', async (req, res) => {
+        const collection = param(req, 'collection');
+        const name = param(req, 'name');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            await coll.dropIndex(name);
+            res.json({ acknowledged: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Replace document ──
+    router.put('/:collection/:id', async (req, res) => {
+        const collection = param(req, 'collection');
+        const id = param(req, 'id');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const result = await coll.replaceOne({ _id: id }, req.body);
+            if (result.matchedCount === 0) {
+                res.status(404).json({ error: 'Document not found' });
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Update document ──
+    router.patch('/:collection/:id', async (req, res) => {
+        const collection = param(req, 'collection');
+        const id = param(req, 'id');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const result = await coll.updateOne({ _id: id }, req.body);
+            if (result.matchedCount === 0) {
+                res.status(404).json({ error: 'Document not found' });
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Delete document ──
+    router.delete('/:collection/:id', async (req, res) => {
+        const collection = param(req, 'collection');
+        const id = param(req, 'id');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const result = await coll.deleteOne({ _id: id });
+            if (result.deletedCount === 0) {
+                res.status(404).json({ error: 'Document not found' });
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Bulk write ──
+    router.post('/:collection/bulkWrite', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { operations, ordered } = req.body ?? {};
+            if (!Array.isArray(operations)) {
+                res.status(400).json({ error: 'operations must be an array' });
+                return;
+            }
+            const result = await coll.bulkWrite(operations, {
+                ordered: ordered ?? true,
+            });
+            res.json(result);
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'BulkWriteError') {
+                res.status(400).json({
+                    error: String(err),
+                    details: err['writeErrors'],
+                });
+                return;
+            }
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // ── Create server-side cursor ──
+    router.post('/:collection/cursor', async (req, res) => {
+        const collection = param(req, 'collection');
+        if (!checkCollection(collection, res))
+            return;
+        try {
+            const coll = db.collection(collection);
+            const { filter, sort, projection, batchSize } = req.body ?? {};
+            const docs = await coll
+                .find(filter ?? {}, { sort, projection })
+                .toArray();
+            const docIds = docs.map((d) => d['_id']).filter(Boolean);
+            const cursor = db.createCursorSession({
+                collection,
+                documentIds: docIds,
+                position: 0,
+                batchSize: Math.min(batchSize ?? 100, maxResults),
+                filter: filter ?? {},
+                sort,
+                projection,
+            });
+            // Return first batch
+            const firstBatch = docIds.slice(0, cursor.batchSize);
+            const batchDocs = [];
+            for (const id of firstBatch) {
+                const doc = await coll.findById(id);
+                if (doc)
+                    batchDocs.push(doc);
+            }
+            cursor.position = firstBatch.length;
+            res.status(201).json({
+                cursorId: cursor.id,
+                firstBatch: batchDocs,
+                hasMore: cursor.position < docIds.length,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    return router;
+}
+// ── Helpers ──
+function parseQueryFilter(query) {
+    const filter = {};
+    for (const [key, value] of Object.entries(query)) {
+        // Skip reserved query params
+        if (['limit', 'skip', 'sort', 'projection'].includes(key))
+            continue;
+        // Try to parse JSON values
+        try {
+            filter[key] = JSON.parse(value);
+        }
+        catch {
+            filter[key] = value;
+        }
+    }
+    return filter;
+}
+function isDuplicateKeyError(err) {
+    return (err instanceof Error &&
+        (err.name === 'DuplicateKeyError' || err.message.includes('E11000')));
+}
+//# sourceMappingURL=expressMiddleware.js.map

package/src/lib/expressMiddleware.js.map

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

package/src/lib/headRegistry.d.ts

@@ -0,0 +1,60 @@
+import { DeferredHeadUpdate, IHeadRegistry } from '@brightchain/brightchain-lib';
+export { InMemoryHeadRegistry } from '@brightchain/brightchain-lib/lib/db/inMemoryHeadRegistry';
+/**
+ * Options for creating a PersistentHeadRegistry.
+ */
+export interface HeadRegistryOptions {
+    /** Path to the directory where the registry file is stored */
+    dataDir: string;
+    /** File name for the registry (default: 'head-registry.json') */
+    fileName?: string;
+}
+/**
+ * Persistent HeadRegistry that writes through to a JSON file on disk.
+ *
+ * The in-memory Map is the primary read path; disk is the persistence layer.
+ * Every mutation (setHead, removeHead, clear) writes the full JSON to disk
+ * before returning, ensuring durability across process restarts.
+ *
+ * File-level locking via `fs.open` with exclusive create prevents concurrent
+ * write corruption when multiple processes share the same data directory.
+ *
+ * If the persisted file is missing or corrupt on load(), the registry starts
+ * empty and logs a warning rather than crashing.
+ */
+export declare class PersistentHeadRegistry implements IHeadRegistry {
+    private readonly heads;
+    private readonly timestamps;
+    private readonly deferred;
+    private readonly filePath;
+    private readonly lockPath;
+    constructor(options: HeadRegistryOptions);
+    private makeKey;
+    getHead(dbName: string, collectionName: string): string | undefined;
+    setHead(dbName: string, collectionName: string, blockId: string): Promise<void>;
+    removeHead(dbName: string, collectionName: string): Promise<void>;
+    clear(): Promise<void>;
+    load(): Promise<void>;
+    getAllHeads(): Map<string, string>;
+    getHeadTimestamp(dbName: string, collectionName: string): Date | undefined;
+    mergeHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<boolean>;
+    deferHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<void>;
+    applyDeferredUpdates(blockId: string): Promise<number>;
+    getDeferredUpdates(): DeferredHeadUpdate[];
+    /**
+     * Write the current in-memory state to disk with file-level locking.
+     *
+     * Locking strategy: create a `.lock` file with exclusive flag (`wx`).
+     * If the lock file already exists, retry with a short delay.
+     * The lock file is always removed after writing, even on error.
+     */
+    private writeToDisk;
+    private acquireLock;
+    private releaseLock;
+    private delay;
+    /**
+     * Factory method that creates a PersistentHeadRegistry for the given directory.
+     * Useful for tests that need an isolated persistent registry.
+     */
+    static create(options: HeadRegistryOptions): PersistentHeadRegistry;
+}