@yydb/light-db 0.0.0

package/dist/collection/QueryBuilder.js

@@ -0,0 +1,475 @@
+"use strict";
+/**
+ * LightDB 查询构建器
+ * 提供链式查询 API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryBuilder = void 0;
+const QueryParser_1 = require("./QueryParser");
+/**
+ * 查询构建器
+ * 提供链式查询 API
+ */
+class QueryBuilder {
+    /**
+     * 创建查询构建器实例
+     * @param executor 查询执行器
+     */
+    constructor(executor) {
+        this.executor = executor;
+        this.filter = {};
+        this.sortCondition = {};
+        this.skipValue = 0;
+        this.limitValue = 0;
+        this.fieldsValue = null;
+    }
+    /**
+     * 设置查询条件
+     * @param condition 查询条件
+     */
+    where(condition) {
+        this.filter = { ...this.filter, ...condition };
+        return this;
+    }
+    /**
+     * 添加等于条件
+     * @param field 字段名
+     * @param value 值
+     */
+    eq(field, value) {
+        const currentFilter = this.filter[field];
+        if (typeof currentFilter === "object" && currentFilter !== null) {
+            currentFilter["$eq"] = value;
+        } else {
+            this.filter[field] = value;
+        }
+        return this;
+    }
+    /**
+     * 添加不等于条件
+     * @param field 字段名
+     * @param value 值
+     */
+    ne(field, value) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$ne"] = value;
+        return this;
+    }
+    /**
+     * 添加大于条件
+     * @param field 字段名
+     * @param value 值
+     */
+    gt(field, value) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$gt"] = value;
+        return this;
+    }
+    /**
+     * 添加大于等于条件
+     * @param field 字段名
+     * @param value 值
+     */
+    gte(field, value) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$gte"] = value;
+        return this;
+    }
+    /**
+     * 添加小于条件
+     * @param field 字段名
+     * @param value 值
+     */
+    lt(field, value) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$lt"] = value;
+        return this;
+    }
+    /**
+     * 添加小于等于条件
+     * @param field 字段名
+     * @param value 值
+     */
+    lte(field, value) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$lte"] = value;
+        return this;
+    }
+    /**
+     * 添加包含于数组条件
+     * @param field 字段名
+     * @param values 值数组
+     */
+    in(field, values) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$in"] = values;
+        return this;
+    }
+    /**
+     * 添加不包含于数组条件
+     * @param field 字段名
+     * @param values 值数组
+     */
+    nin(field, values) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$nin"] = values;
+        return this;
+    }
+    /**
+     * 添加存在性检查条件
+     * @param field 字段名
+     * @param exists 是否存在
+     */
+    fieldExists(field, exists = true) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$exists"] = exists;
+        return this;
+    }
+    /**
+     * 添加正则表达式匹配条件
+     * @param field 字段名
+     * @param pattern 正则表达式
+     * @param options 正则表达式选项
+     */
+    regex(field, pattern, options) {
+        const fieldCondition = this.getOrCreateFieldCondition(field);
+        fieldCondition["$regex"] = pattern;
+        if (options) {
+            fieldCondition["$options"] = options;
+        }
+        return this;
+    }
+    /**
+     * 添加逻辑与条件
+     * @param conditions 条件数组
+     */
+    and(...conditions) {
+        if (!this.filter.$and) {
+            this.filter.$and = [];
+        }
+        this.filter.$and.push(...conditions);
+        return this;
+    }
+    /**
+     * 添加逻辑或条件
+     * @param conditions 条件数组
+     */
+    or(...conditions) {
+        if (!this.filter.$or) {
+            this.filter.$or = [];
+        }
+        this.filter.$or.push(...conditions);
+        return this;
+    }
+    /**
+     * 添加逻辑非条件
+     * @param condition 条件
+     */
+    not(condition) {
+        this.filter.$not = condition;
+        return this;
+    }
+    /**
+     * 设置排序条件
+     * @param field 字段名
+     * @param direction 排序方向
+     */
+    sortBy(field, direction = 1) {
+        this.sortCondition[field] = direction;
+        return this;
+    }
+    /**
+     * 升序排序
+     * @param field 字段名
+     */
+    asc(field) {
+        return this.sortBy(field, "asc");
+    }
+    /**
+     * 降序排序
+     * @param field 字段名
+     */
+    desc(field) {
+        return this.sortBy(field, "desc");
+    }
+    /**
+     * 设置跳过记录数
+     * @param count 跳过的记录数
+     */
+    skip(count) {
+        this.skipValue = Math.max(0, count);
+        return this;
+    }
+    /**
+     * 设置返回记录数限制
+     * @param count 最大返回记录数
+     */
+    limit(count) {
+        this.limitValue = Math.max(0, count);
+        return this;
+    }
+    /**
+     * 设置返回的字段
+     * @param fields 字段列表
+     */
+    select(...fields) {
+        this.fieldsValue = fields;
+        return this;
+    }
+    /**
+     * 获取或创建字段条件对象
+     */
+    getOrCreateFieldCondition(field) {
+        const fieldKey = field;
+        let condition = this.filter[fieldKey];
+        if (!condition || typeof condition !== "object" || Array.isArray(condition)) {
+            condition = {};
+            this.filter[fieldKey] = condition;
+        }
+        return condition;
+    }
+    /**
+     * 执行查询并返回所有匹配的文档
+     */
+    toArray() {
+        const result = this.execute();
+        const output = {
+            docs: result.docs,
+        };
+        if (result.total !== undefined) {
+            output.total = result.total;
+        }
+        if (result.usedIndex !== undefined) {
+            output.usedIndex = result.usedIndex;
+        }
+        if (result.indexName !== undefined) {
+            output.indexName = result.indexName;
+        }
+        return output;
+    }
+    /**
+     * 执行查询并返回第一条匹配的文档
+     */
+    first() {
+        this.limitValue = 1;
+        const result = this.execute();
+        return result.docs.length > 0 ? (result.docs[0] ?? null) : null;
+    }
+    /**
+     * 执行查询并返回最后一条匹配的文档
+     */
+    last() {
+        this.limitValue = 1;
+        const result = this.execute();
+        return result.docs.length > 0 ? (result.docs[result.docs.length - 1] ?? null) : null;
+    }
+    /**
+     * 统计匹配的文档数量
+     */
+    count() {
+        const result = this.execute();
+        return result.total ?? result.docs.length;
+    }
+    /**
+     * 检查是否存在匹配的文档
+     */
+    hasMatch() {
+        return this.count() > 0;
+    }
+    /**
+     * 执行查询
+     */
+    execute() {
+        const indexFields = [this.executor.getPrimaryKeyField(), ...this.executor.getSecondaryIndexFields()];
+        const analysis = QueryParser_1.QueryParser.analyzeQuery(this.filter, indexFields);
+        let docs;
+        let usedIndex;
+        let indexName;
+        if (analysis.canUseIndex && analysis.indexField) {
+            const result = this.executeWithIndex(analysis);
+            docs = result.docs;
+            usedIndex = result.usedIndex;
+            indexName = result.indexName;
+        } else {
+            docs = this.executeWithScan();
+        }
+        const total = docs.length;
+        if (Object.keys(this.sortCondition).length > 0) {
+            docs = this.applySort(docs);
+        }
+        if (this.skipValue > 0) {
+            docs = docs.slice(this.skipValue);
+        }
+        if (this.limitValue > 0) {
+            docs = docs.slice(0, this.limitValue);
+        }
+        if (this.fieldsValue && this.fieldsValue.length > 0) {
+            docs = this.applyProjection(docs);
+        }
+        const output = {
+            docs,
+            total,
+        };
+        if (usedIndex !== undefined) {
+            output.usedIndex = usedIndex;
+        }
+        if (indexName !== undefined) {
+            output.indexName = indexName;
+        }
+        return output;
+    }
+    /**
+     * 使用索引执行查询
+     */
+    executeWithIndex(analysis) {
+        const primaryKeyField = this.executor.getPrimaryKeyField();
+        if (analysis.indexField === primaryKeyField) {
+            if (analysis.isExactMatch && analysis.indexValue !== undefined) {
+                const doc = this.executor.findByPrimaryKey(analysis.indexValue);
+                if (doc && QueryParser_1.QueryParser.matches(doc, this.filter)) {
+                    const output = {
+                        docs: [doc],
+                        usedIndex: true,
+                    };
+                    output.indexName = primaryKeyField;
+                    return output;
+                }
+                const output = {
+                    docs: [],
+                    usedIndex: true,
+                };
+                output.indexName = primaryKeyField;
+                return output;
+            }
+        }
+        const secondaryIndexFields = this.executor.getSecondaryIndexFields();
+        if (secondaryIndexFields.includes(analysis.indexField)) {
+            if (analysis.isExactMatch && analysis.indexValue !== undefined && analysis.indexField) {
+                const docs = this.executor.findBySecondaryIndex(analysis.indexField, analysis.indexValue);
+                const filtered = docs.filter((doc) => QueryParser_1.QueryParser.matches(doc, this.filter));
+                const output = {
+                    docs: filtered,
+                    usedIndex: true,
+                };
+                output.indexName = analysis.indexField;
+                return output;
+            }
+        }
+        return { docs: this.executeWithScan(), usedIndex: false };
+    }
+    /**
+     * 使用全表扫描执行查询
+     */
+    executeWithScan() {
+        const allDocs = this.executor.getAll();
+        return allDocs.filter((doc) => QueryParser_1.QueryParser.matches(doc, this.filter));
+    }
+    /**
+     * 应用排序
+     */
+    applySort(docs) {
+        const sortEntries = Object.entries(this.sortCondition);
+        if (sortEntries.length === 0) {
+            return docs;
+        }
+        return docs.slice().sort((a, b) => {
+            for (const [field, direction] of sortEntries) {
+                const aVal = a[field];
+                const bVal = b[field];
+                const cmp = this.compareValues(aVal, bVal);
+                if (cmp !== 0) {
+                    const dir = direction === "desc" || direction === -1 ? -1 : 1;
+                    return cmp * dir;
+                }
+            }
+            return 0;
+        });
+    }
+    /**
+     * 比较两个值
+     */
+    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 (a instanceof Date && b instanceof Date) {
+            return a.getTime() - b.getTime();
+        }
+        if (typeof a === "boolean" && typeof b === "boolean") {
+            return a === b ? 0 : a ? 1 : -1;
+        }
+        return 0;
+    }
+    /**
+     * 应用投影
+     */
+    applyProjection(docs) {
+        if (!this.fieldsValue || this.fieldsValue.length === 0) {
+            return docs;
+        }
+        return docs.map((doc) => {
+            const projected = {};
+            for (const field of this.fieldsValue) {
+                if (field in doc) {
+                    projected[field] = doc[field];
+                }
+            }
+            return projected;
+        });
+    }
+    /**
+     * 获取当前查询条件
+     */
+    getFilter() {
+        return { ...this.filter };
+    }
+    /**
+     * 获取当前排序条件
+     */
+    getSort() {
+        return { ...this.sortCondition };
+    }
+    /**
+     * 获取当前跳过值
+     */
+    getSkip() {
+        return this.skipValue;
+    }
+    /**
+     * 获取当前限制值
+     */
+    getLimit() {
+        return this.limitValue;
+    }
+    /**
+     * 重置查询构建器
+     */
+    reset() {
+        this.filter = {};
+        this.sortCondition = {};
+        this.skipValue = 0;
+        this.limitValue = 0;
+        this.fieldsValue = null;
+        return this;
+    }
+    /**
+     * 克隆查询构建器
+     */
+    clone() {
+        const cloned = new QueryBuilder(this.executor);
+        cloned.filter = { ...this.filter };
+        cloned.sortCondition = { ...this.sortCondition };
+        cloned.skipValue = this.skipValue;
+        cloned.limitValue = this.limitValue;
+        cloned.fieldsValue = this.fieldsValue ? [...this.fieldsValue] : null;
+        return cloned;
+    }
+}
+exports.QueryBuilder = QueryBuilder;
+//# sourceMappingURL=QueryBuilder.js.map

package/dist/collection/QueryBuilder.js.map

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

package/dist/collection/QueryParser.d.ts

@@ -0,0 +1,117 @@
+/**
+ * LightDB 查询条件解析器
+ * 解析查询条件并判断文档是否匹配
+ */
+import type { QueryFilter, PrimaryKeyType } from "./types";
+/**
+ * 查询解析结果
+ */
+export interface QueryParseResult {
+    /** 是否可以使用索引 */
+    canUseIndex: boolean;
+    /** 可以使用的索引字段 */
+    indexField?: string;
+    /** 索引查询值 */
+    indexValue?: PrimaryKeyType | PrimaryKeyType[];
+    /** 是否是精确匹配 */
+    isExactMatch: boolean;
+}
+/**
+ * 查询条件解析器
+ * 提供查询条件的解析和匹配功能
+ */
+export declare class QueryParser {
+    /**
+     * 检查文档是否匹配查询条件
+     * @param doc 文档
+     * @param filter 查询条件
+     */
+    static matches<T>(doc: T, filter: QueryFilter<T>): boolean;
+    /**
+     * 匹配逻辑操作符
+     */
+    private static matchesLogicalOperators;
+    /**
+     * 匹配单个字段
+     */
+    private static matchesField;
+    /**
+     * 检查是否是比较操作符
+     */
+    private static isComparisonOperators;
+    /**
+     * 检查是否是数组操作符
+     */
+    private static isArrayOperators;
+    /**
+     * 检查是否是存在性操作符
+     */
+    private static isExistenceOperators;
+    /**
+     * 检查是否是正则表达式操作符
+     */
+    private static isRegexOperators;
+    /**
+     * 匹配比较操作符
+     */
+    private static matchesComparisonOperators;
+    /**
+     * 匹配数组操作符
+     */
+    private static matchesArrayOperators;
+    /**
+     * 匹配存在性操作符
+     */
+    private static matchesExistenceOperators;
+    /**
+     * 匹配正则表达式操作符
+     */
+    private static matchesRegexOperators;
+    /**
+     * 获取嵌套值
+     */
+    private static getNestedValue;
+    /**
+     * 判断两个值是否相等
+     */
+    private static isEqual;
+    /**
+     * 判断是否大于
+     */
+    private static isGreaterThan;
+    /**
+     * 判断是否大于等于
+     */
+    private static isGreaterThanOrEqual;
+    /**
+     * 判断是否小于
+     */
+    private static isLessThan;
+    /**
+     * 判断是否小于等于
+     */
+    private static isLessThanOrEqual;
+    /**
+     * 分析查询条件，判断是否可以使用索引
+     * @param filter 查询条件
+     * @param indexFields 可用的索引字段列表
+     */
+    static analyzeQuery<T>(filter: QueryFilter<T>, indexFields: string[]): QueryParseResult;
+    /**
+     * 检查是否是精确值
+     */
+    private static isExactValue;
+    /**
+     * 检查是否是 $in 操作符
+     */
+    private static isInOperator;
+    /**
+     * 检查是否有比较操作符
+     */
+    private static hasComparisonOperators;
+    /**
+     * 提取查询条件中的字段列表
+     */
+    static extractFields<T>(filter: QueryFilter<T>): string[];
+}
+//# sourceMappingURL=QueryParser.d.ts.map

package/dist/collection/QueryParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryParser.d.ts","sourceRoot":"","sources":["../../src/collection/QueryParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACR,WAAW,EAMX,cAAc,EACjB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,eAAe;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,UAAU,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC/C,cAAc;IACd,YAAY,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACpB;;;;OAIG;WACW,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO;IAyBjE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAyCtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA0B3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IASpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAQ/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAQnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAQ/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAwCzC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAgBpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAcxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAmBpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAuB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAkCtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAgBnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAgBzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgBhC;;;;OAIG;WACW,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,gBAAgB;IA0D9F;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAc3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAO3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC;;OAEG;WACW,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE;CAwBnE"}