@brightchain/brightchain-lib 0.18.0 → 0.19.0

package/src/lib/db/indexing.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * In-memory index engine for fast document lookups.
+ *
+ * Supports single-field and compound indexes with optional uniqueness.
+ * Indexes are stored as sorted maps from stringified key values to sets of document IDs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicateKeyError = exports.IndexManager = exports.CollectionIndex = void 0;
+/**
+ * Represents a single index on a collection.
+ */
+class CollectionIndex {
+    constructor(spec, options = {}) {
+        /**
+         * Map from stringified key → Set of document IDs.
+         * For unique indexes the set will have at most 1 entry.
+         */
+        this.entries = new Map();
+        this.spec = spec;
+        this.unique = options.unique ?? false;
+        this.sparse = options.sparse ?? false;
+        this.name =
+            options.name ??
+                Object.entries(spec)
+                    .map(([k, v]) => `${k}_${v}`)
+                    .join('_');
+    }
+    /**
+     * Extract the index key from a document.
+     * Returns `undefined` if the document is missing a required field (and the index is sparse).
+     */
+    extractKey(doc) {
+        const parts = [];
+        for (const field of Object.keys(this.spec)) {
+            const value = getNestedValue(doc, field);
+            if (value === undefined && this.sparse)
+                return undefined;
+            parts.push(value ?? null);
+        }
+        return JSON.stringify(parts);
+    }
+    /**
+     * Add a document to the index.
+     * @throws Error if the index is unique and a duplicate key is found.
+     */
+    addDocument(doc) {
+        const key = this.extractKey(doc);
+        if (key === undefined)
+            return; // sparse index – skip
+        const docId = doc._id;
+        if (!docId)
+            return;
+        if (this.unique) {
+            const existing = this.entries.get(key);
+            if (existing && existing.size > 0) {
+                // Allow re-indexing the same document
+                if (!existing.has(docId)) {
+                    throw new DuplicateKeyError(this.name, key);
+                }
+            }
+        }
+        if (!this.entries.has(key)) {
+            this.entries.set(key, new Set());
+        }
+        this.entries.get(key).add(docId);
+    }
+    /**
+     * Remove a document from the index.
+     */
+    removeDocument(doc) {
+        const key = this.extractKey(doc);
+        if (key === undefined)
+            return;
+        const docId = doc._id;
+        if (!docId)
+            return;
+        const set = this.entries.get(key);
+        if (set) {
+            set.delete(docId);
+            if (set.size === 0)
+                this.entries.delete(key);
+        }
+    }
+    /**
+     * Look up document IDs by exact field values.
+     * Returns `undefined` if the query cannot use this index.
+     */
+    lookup(query) {
+        const fields = Object.keys(this.spec);
+        // Check that the query has exact equality on all index fields
+        const parts = [];
+        for (const field of fields) {
+            if (!(field in query))
+                return undefined;
+            const cond = query[field];
+            // Only support exact match for index lookup (not operator queries)
+            if (typeof cond === 'object' &&
+                cond !== null &&
+                !Array.isArray(cond) &&
+                !(cond instanceof Date) &&
+                !(cond instanceof RegExp)) {
+                // Check for $eq operator
+                const condObj = cond;
+                if ('$eq' in condObj) {
+                    parts.push(condObj['$eq'] ?? null);
+                    continue;
+                }
+                return undefined; // Complex operator – can't use this index
+            }
+            parts.push(cond ?? null);
+        }
+        const key = JSON.stringify(parts);
+        return this.entries.get(key);
+    }
+    /**
+     * Get all document IDs in the index.
+     */
+    allIds() {
+        const all = new Set();
+        for (const set of this.entries.values()) {
+            for (const id of set)
+                all.add(id);
+        }
+        return all;
+    }
+    /**
+     * Clear the index.
+     */
+    clear() {
+        this.entries.clear();
+    }
+    /**
+     * Get the number of entries in the index.
+     */
+    get size() {
+        return this.entries.size;
+    }
+    /**
+     * Serialize the index metadata for persistence.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            spec: this.spec,
+            unique: this.unique,
+            sparse: this.sparse,
+        };
+    }
+}
+exports.CollectionIndex = CollectionIndex;
+/**
+ * Manages multiple indexes for a collection.
+ */
+class IndexManager {
+    constructor() {
+        this.indexes = new Map();
+    }
+    /**
+     * Create a new index.
+     * @returns The name of the created index.
+     * @throws Error if an index with the same name already exists with different options.
+     */
+    createIndex(spec, options = {}) {
+        const index = new CollectionIndex(spec, options);
+        if (this.indexes.has(index.name)) {
+            const existing = this.indexes.get(index.name);
+            if (JSON.stringify(existing.spec) !== JSON.stringify(spec)) {
+                throw new Error(`Index "${index.name}" already exists with a different spec`);
+            }
+            return index.name;
+        }
+        this.indexes.set(index.name, index);
+        return index.name;
+    }
+    /**
+     * Drop an index by name.
+     */
+    dropIndex(name) {
+        return this.indexes.delete(name);
+    }
+    /**
+     * Get all index names.
+     */
+    listIndexes() {
+        return Array.from(this.indexes.keys());
+    }
+    /**
+     * Get an index by name.
+     */
+    getIndex(name) {
+        return this.indexes.get(name);
+    }
+    /**
+     * Index a document in all indexes.
+     * @throws DuplicateKeyError if a unique constraint is violated.
+     */
+    addDocument(doc) {
+        // Validate first (so we don't partially index if one fails)
+        const toAdd = [];
+        for (const index of this.indexes.values()) {
+            toAdd.push(index);
+        }
+        // Add to all
+        for (const index of toAdd) {
+            index.addDocument(doc);
+        }
+    }
+    /**
+     * Remove a document from all indexes.
+     */
+    removeDocument(doc) {
+        for (const index of this.indexes.values()) {
+            index.removeDocument(doc);
+        }
+    }
+    /**
+     * Rebuild all indexes from a set of documents.
+     */
+    rebuildAll(docs) {
+        for (const index of this.indexes.values()) {
+            index.clear();
+            for (const doc of docs) {
+                index.addDocument(doc);
+            }
+        }
+    }
+    /**
+     * Try to find an index that can serve the given query filter.
+     * Returns the set of matching document IDs if an index applies, otherwise undefined.
+     */
+    findCandidates(filter) {
+        for (const index of this.indexes.values()) {
+            const ids = index.lookup(filter);
+            if (ids !== undefined)
+                return ids;
+        }
+        return undefined;
+    }
+    /**
+     * Serialize all index metadata for persistence.
+     */
+    toJSON() {
+        return Array.from(this.indexes.values()).map((idx) => idx.toJSON());
+    }
+    /**
+     * Restore indexes from serialized metadata and rebuild from docs.
+     */
+    restoreFromJSON(metadata, docs) {
+        for (const meta of metadata) {
+            this.createIndex(meta.spec, {
+                name: meta.name,
+                unique: meta.unique,
+                sparse: meta.sparse,
+            });
+        }
+        this.rebuildAll(docs);
+    }
+}
+exports.IndexManager = IndexManager;
+// ── Errors ──
+class DuplicateKeyError extends Error {
+    constructor(indexName, keyValue) {
+        super(`E11000 duplicate key error collection: index "${indexName}" dup key: ${keyValue}`);
+        this.name = 'DuplicateKeyError';
+        this.indexName = indexName;
+        this.keyValue = keyValue;
+    }
+}
+exports.DuplicateKeyError = DuplicateKeyError;
+// ── Helpers ──
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current === 'object') {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=indexing.js.map

package/src/lib/db/indexing.js.map

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

package/src/lib/db/queryEngine.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Query engine – evaluates MongoDB-style filter queries against documents.
+ *
+ * Supports:
+ *   - Comparison: $eq, $ne, $gt, $gte, $lt, $lte
+ *   - Set membership: $in, $nin
+ *   - Pattern: $regex
+ *   - Existence: $exists
+ *   - Array: $elemMatch, $size, $all
+ *   - Logical: $and, $or, $nor, $not
+ *   - Type: $type
+ *   - Text: $text / $search (full-text search across indexed fields)
+ */
+import type { FilterQuery } from '@digitaldefiance/suite-core-lib';
+import type { BsonDocument } from '../interfaces/storage/documentTypes';
+/**
+ * Configure which fields are included in $text search.
+ * Call this before running a filter that contains $text.
+ */
+export declare function setTextSearchFields(fields: string[]): void;
+/**
+ * Get the currently configured text search fields.
+ */
+export declare function getTextSearchFields(): string[];
+/**
+ * Compare two values for ordering (like MongoDB's BSON comparison).
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+export declare function compareValues(a: unknown, b: unknown): number;
+/**
+ * Deep equality check (handles primitives, arrays, plain objects, Dates).
+ */
+export declare function deepEquals(a: unknown, b: unknown): boolean;
+/**
+ * Check if a document matches a filter query.
+ */
+export declare function matchesFilter<T extends BsonDocument>(doc: T, filter: FilterQuery<T>): boolean;
+/**
+ * Apply projection to a document.
+ */
+export declare function applyProjection<T extends BsonDocument>(doc: T, projection: Record<string, 0 | 1>): Partial<T>;
+/**
+ * Sort an array of documents by a sort specification.
+ */
+export declare function sortDocuments<T extends BsonDocument>(docs: T[], sort: Record<string, 1 | -1>): T[];
+/**
+ * Tokenize a string into lowercase words (basic whitespace + punctuation split).
+ */
+export declare function tokenize(text: string): string[];
+//# sourceMappingURL=queryEngine.d.ts.map

package/src/lib/db/queryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryEngine.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/db/queryEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAQxE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAsCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAW5D;AAuHD;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAuB1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAClD,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,OAAO,CA+DT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EACpD,GAAG,EAAE,CAAC,EACN,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC,CA0BZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAClD,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAC3B,CAAC,EAAE,CAaL;AAID;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM/C"}