@brightchain/brightchain-lib 0.18.0 → 0.20.0

package/src/lib/db/queryEngine.js

@@ -0,0 +1,461 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTextSearchFields = setTextSearchFields;
+exports.getTextSearchFields = getTextSearchFields;
+exports.compareValues = compareValues;
+exports.deepEquals = deepEquals;
+exports.matchesFilter = matchesFilter;
+exports.applyProjection = applyProjection;
+exports.sortDocuments = sortDocuments;
+exports.tokenize = tokenize;
+/** Reserved operator keys */
+const LOGICAL_OPS = new Set(['$and', '$or', '$nor', '$not']);
+/** Fields to search for $text queries – set by the collection before querying */
+let textSearchFields = [];
+/**
+ * Configure which fields are included in $text search.
+ * Call this before running a filter that contains $text.
+ */
+function setTextSearchFields(fields) {
+    textSearchFields = fields;
+}
+/**
+ * Get the currently configured text search fields.
+ */
+function getTextSearchFields() {
+    return textSearchFields;
+}
+/**
+ * Resolve a potentially nested field path like "address.city" on a document.
+ */
+function getNestedValue(doc, path) {
+    const parts = path.split('.');
+    let current = doc;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (Array.isArray(current)) {
+            const idx = Number(part);
+            if (!Number.isNaN(idx)) {
+                current = current[idx];
+            }
+            else {
+                // Array implicit iteration – match any element
+                const results = current
+                    .map((item) => typeof item === 'object' && item !== null
+                    ? item[part]
+                    : undefined)
+                    .filter((v) => v !== undefined);
+                return results.length === 1
+                    ? results[0]
+                    : results.length > 0
+                        ? results
+                        : undefined;
+            }
+        }
+        else if (typeof current === 'object') {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Compare two values for ordering (like MongoDB's BSON comparison).
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+function compareValues(a, b) {
+    if (a === b)
+        return 0;
+    if (a === null || a === undefined)
+        return -1;
+    if (b === null || b === undefined)
+        return 1;
+    if (typeof a === 'number' && typeof b === 'number')
+        return a - b;
+    if (typeof a === 'string' && typeof b === 'string')
+        return a.localeCompare(b);
+    if (typeof a === 'boolean' && typeof b === 'boolean')
+        return a === b ? 0 : a ? 1 : -1;
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() - b.getTime();
+    // Fallback: stringify comparison
+    return String(a).localeCompare(String(b));
+}
+/**
+ * Check if a value matches a filter operator object.
+ */
+function matchOperator(value, op) {
+    for (const [key, operand] of Object.entries(op)) {
+        switch (key) {
+            case '$eq':
+                if (!deepEquals(value, operand))
+                    return false;
+                break;
+            case '$ne':
+                if (deepEquals(value, operand))
+                    return false;
+                break;
+            case '$gt':
+                if (compareValues(value, operand) <= 0)
+                    return false;
+                break;
+            case '$gte':
+                if (compareValues(value, operand) < 0)
+                    return false;
+                break;
+            case '$lt':
+                if (compareValues(value, operand) >= 0)
+                    return false;
+                break;
+            case '$lte':
+                if (compareValues(value, operand) > 0)
+                    return false;
+                break;
+            case '$in': {
+                const arr = operand;
+                if (!arr.some((item) => deepEquals(value, item)))
+                    return false;
+                break;
+            }
+            case '$nin': {
+                const arr = operand;
+                if (arr.some((item) => deepEquals(value, item)))
+                    return false;
+                break;
+            }
+            case '$regex': {
+                if (typeof value !== 'string')
+                    return false;
+                const re = operand instanceof RegExp ? operand : new RegExp(operand);
+                if (!re.test(value))
+                    return false;
+                break;
+            }
+            case '$exists':
+                if (operand && value === undefined)
+                    return false;
+                if (!operand && value !== undefined)
+                    return false;
+                break;
+            case '$not':
+                if (matchOperator(value, operand))
+                    return false;
+                break;
+            case '$elemMatch': {
+                if (!Array.isArray(value))
+                    return false;
+                const subFilter = operand;
+                if (!value.some((elem) => matchesFilter(elem, subFilter))) {
+                    return false;
+                }
+                break;
+            }
+            case '$size':
+                if (!Array.isArray(value) || value.length !== operand)
+                    return false;
+                break;
+            case '$all': {
+                if (!Array.isArray(value))
+                    return false;
+                const allItems = operand;
+                if (!allItems.every((item) => value.some((v) => deepEquals(v, item))))
+                    return false;
+                break;
+            }
+            case '$type': {
+                const expectedType = operand;
+                if (!matchesType(value, expectedType))
+                    return false;
+                break;
+            }
+            default:
+                // Unknown operator – ignore
+                break;
+        }
+    }
+    return true;
+}
+function matchesType(value, expectedType) {
+    switch (expectedType) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+        case 'int':
+        case 'long':
+        case 'double':
+        case 'decimal':
+            return typeof value === 'number';
+        case 'bool':
+            return typeof value === 'boolean';
+        case 'object':
+            return (typeof value === 'object' && value !== null && !Array.isArray(value));
+        case 'array':
+            return Array.isArray(value);
+        case 'null':
+            return value === null;
+        case 'date':
+            return value instanceof Date;
+        case 'undefined':
+            return value === undefined;
+        default:
+            return typeof value === expectedType;
+    }
+}
+/**
+ * Deep equality check (handles primitives, arrays, plain objects, Dates).
+ */
+function deepEquals(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || a === undefined || b === undefined)
+        return a === b;
+    if (typeof a !== typeof b)
+        return false;
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((item, i) => deepEquals(item, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object') {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((k) => deepEquals(a[k], b[k]));
+    }
+    return false;
+}
+/**
+ * Check if a document matches a filter query.
+ */
+function matchesFilter(doc, filter) {
+    for (const [key, condition] of Object.entries(filter)) {
+        // Handle logical operators at the top level
+        if (key === '$and') {
+            const clauses = condition;
+            if (!clauses.every((clause) => matchesFilter(doc, clause)))
+                return false;
+            continue;
+        }
+        if (key === '$or') {
+            const clauses = condition;
+            if (!clauses.some((clause) => matchesFilter(doc, clause)))
+                return false;
+            continue;
+        }
+        if (key === '$nor') {
+            const clauses = condition;
+            if (clauses.some((clause) => matchesFilter(doc, clause)))
+                return false;
+            continue;
+        }
+        if (key === '$not') {
+            if (matchesFilter(doc, condition))
+                return false;
+            continue;
+        }
+        if (key === '$text') {
+            const textSpec = condition;
+            const searchStr = textSpec['$search'] ?? '';
+            if (!matchesTextSearch(doc, searchStr))
+                return false;
+            continue;
+        }
+        if (LOGICAL_OPS.has(key))
+            continue;
+        const value = getNestedValue(doc, key);
+        if (condition !== null &&
+            typeof condition === 'object' &&
+            !Array.isArray(condition) &&
+            !(condition instanceof RegExp) &&
+            !(condition instanceof Date)) {
+            // Check if any keys look like operators
+            const condObj = condition;
+            const hasOps = Object.keys(condObj).some((k) => k.startsWith('$'));
+            if (hasOps) {
+                if (!matchOperator(value, condObj))
+                    return false;
+                continue;
+            }
+        }
+        // Exact match – if the value is in an array, match against array elements (MongoDB behavior)
+        if (Array.isArray(value)) {
+            if (!value.some((v) => deepEquals(v, condition)) &&
+                !deepEquals(value, condition)) {
+                return false;
+            }
+        }
+        else {
+            if (!deepEquals(value, condition))
+                return false;
+        }
+    }
+    return true;
+}
+/**
+ * Apply projection to a document.
+ */
+function applyProjection(doc, projection) {
+    const keys = Object.keys(projection);
+    if (keys.length === 0)
+        return { ...doc };
+    const isInclusion = Object.values(projection).some((v) => v === 1);
+    const result = {};
+    if (isInclusion) {
+        // Always include _id unless explicitly excluded
+        if (projection['_id'] !== 0) {
+            result['_id'] = doc._id;
+        }
+        for (const key of keys) {
+            if (key === '_id')
+                continue;
+            if (projection[key] === 1) {
+                result[key] = getNestedValue(doc, key);
+            }
+        }
+    }
+    else {
+        // Exclusion mode – include everything except excluded fields
+        for (const [k, v] of Object.entries(doc)) {
+            if (projection[k] === 0)
+                continue;
+            result[k] = v;
+        }
+    }
+    return result;
+}
+/**
+ * Sort an array of documents by a sort specification.
+ */
+function sortDocuments(docs, sort) {
+    const sortEntries = Object.entries(sort);
+    if (sortEntries.length === 0)
+        return docs;
+    return [...docs].sort((a, b) => {
+        for (const [field, direction] of sortEntries) {
+            const va = getNestedValue(a, field);
+            const vb = getNestedValue(b, field);
+            const cmp = compareValues(va, vb);
+            if (cmp !== 0)
+                return cmp * direction;
+        }
+        return 0;
+    });
+}
+// ── Text search ──
+/**
+ * Tokenize a string into lowercase words (basic whitespace + punctuation split).
+ */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ')
+        .split(/\s+/)
+        .filter(Boolean);
+}
+/**
+ * Check whether a document matches a `$text: { $search: ... }` query.
+ *
+ * When `textSearchFields` is configured, only those fields are searched.
+ * Otherwise falls back to searching all string fields in the document.
+ *
+ * Supports:
+ *   - Multiple search terms (OR semantics – any token match)
+ *   - Quoted phrases for exact substring matching: `"hello world"`
+ *   - Negation with minus prefix: `-unwanted`
+ */
+function matchesTextSearch(doc, search) {
+    if (!search)
+        return true;
+    // Collect text from document
+    const fieldsToSearch = textSearchFields.length > 0 ? textSearchFields : null;
+    const docText = extractText(doc, fieldsToSearch).toLowerCase();
+    // Parse search string: quoted phrases, negated terms, and regular terms
+    const phrases = [];
+    const negated = [];
+    const tokens = [];
+    // Extract quoted phrases
+    const quoteRegex = /"([^"]+)"/g;
+    let cleaned = search;
+    let match;
+    while ((match = quoteRegex.exec(search)) !== null) {
+        phrases.push(match[1].toLowerCase());
+    }
+    cleaned = cleaned.replace(quoteRegex, '').trim();
+    // Split remaining into tokens
+    for (const word of cleaned.split(/\s+/).filter(Boolean)) {
+        if (word.startsWith('-') && word.length > 1) {
+            negated.push(word.slice(1).toLowerCase());
+        }
+        else {
+            tokens.push(word.toLowerCase());
+        }
+    }
+    // Check negated terms (must NOT appear)
+    for (const neg of negated) {
+        if (docText.includes(neg))
+            return false;
+    }
+    // Check quoted phrases (must appear as substring)
+    for (const phrase of phrases) {
+        if (!docText.includes(phrase))
+            return false;
+    }
+    // Check tokens (at least one must match, or if no tokens – phrases already matched)
+    if (tokens.length > 0) {
+        const docTokens = new Set(tokenize(docText));
+        if (!tokens.some((t) => docTokens.has(t)))
+            return false;
+    }
+    return true;
+}
+/**
+ * Extract all text content from a document for full-text search.
+ */
+function extractText(obj, fields, prefix = '') {
+    const parts = [];
+    for (const [key, value] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (fields &&
+            !fields.some((f) => path.startsWith(f) || f.startsWith(path))) {
+            continue;
+        }
+        if (typeof value === 'string') {
+            parts.push(value);
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                if (typeof item === 'string')
+                    parts.push(item);
+                else if (typeof item === 'object' && item !== null) {
+                    parts.push(extractText(item, fields, path));
+                }
+            }
+        }
+        else if (typeof value === 'object' &&
+            value !== null &&
+            !(value instanceof Date)) {
+            parts.push(extractText(value, fields, path));
+        }
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=queryEngine.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Schema validation for brightchain-db collections.
+ *
+ * Provides a lightweight JSON-Schema-like validator that can enforce
+ * document structure on insert and update operations.
+ *
+ * Supported types: 'string', 'number', 'boolean', 'object', 'array', 'null', 'date', 'any',
+ *   'branded-primitive', 'branded-interface'
+ * Supported constraints:
+ *   - required: array of required field names
+ *   - properties: per-field type + constraints
+ *   - minLength / maxLength: for strings and arrays
+ *   - minimum / maximum: for numbers
+ *   - pattern: regex pattern for strings
+ *   - enum: allowed values
+ *   - items: schema for array elements
+ *   - additionalProperties: whether extra fields are allowed (default: true)
+ */
+import type { CollectionSchema, CollectionSchemaFieldType } from '@digitaldefiance/suite-core-lib';
+import type { BsonDocument, FieldSchema, ValidationFieldError } from '../interfaces/storage/documentTypes';
+export type { CollectionSchema, FieldSchema };
+/**
+ * Local alias for backward compatibility.
+ * The canonical type is `CollectionSchemaFieldType` in brightchain-lib.
+ */
+export type SchemaType = CollectionSchemaFieldType;
+/**
+ * Validate a document against a collection schema.
+ *
+ * @param doc - The document to validate
+ * @param schema - The collection schema
+ * @param collectionName - Collection name for error messages
+ * @throws ValidationError if validationAction is 'error'
+ * @returns Array of validation field errors (empty if valid)
+ */
+export declare function validateDocument(doc: BsonDocument, schema: CollectionSchema, collectionName: string): ValidationFieldError[];
+/**
+ * Apply default values from schema to a document (mutates a copy).
+ */
+export declare function applyDefaults(doc: BsonDocument, schema: CollectionSchema): BsonDocument;
+//# sourceMappingURL=schemaValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidation.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/db/schemaValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACrB,MAAM,qCAAqC,CAAC;AAI7C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAInD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,MAAM,GACrB,oBAAoB,EAAE,CAkDxB;AAkOD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,gBAAgB,GACvB,YAAY,CAed"}