@aiao/rxdb-query-builder 0.0.10

package/dist/services/query-builder.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.service.d.ts","sourceRoot":"","sources":["../../src/services/query-builder.service.ts"],"names":[],"mappings":"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"}

package/dist/services/query-converter.service.d.ts

@@ -0,0 +1,74 @@
+import { RuleGroup } from '../../packages/rxdb/src/index.ts';
+import { QueryBuilderState } from '../models/query-builder-state.js';
+/**
+ * 转换选项
+ */
+export interface QueryConverterOptions {
+    /**
+     * ID 生成器
+     * @default generateId()
+     */
+    idGenerator?: () => string;
+}
+/**
+ * Query 转换服务
+ * 负责 QueryBuilder 状态与 RxDB Query 之间的双向转换
+ */
+export declare class QueryConverter<T = Record<string, unknown>> {
+    private readonly idGenerator;
+    constructor(options?: QueryConverterOptions);
+    /**
+     * 将 QueryBuilder 状态转换为 RxDB Query
+     *
+     * @param state - QueryBuilder 状态
+     * @returns RxDB RuleGroup 查询对象
+     *
+     * @example
+     * ```typescript
+     * const converter = new QueryConverter<User>();
+     * const query = converter.toRxDBQuery(queryBuilderState);
+     * // { combinator: 'and', rules: [...] }
+     * ```
+     */
+    toRxDBQuery(state: QueryBuilderState<T>): RuleGroup<T>;
+    /**
+     * 将 RxDB Query 转换为 QueryBuilder 状态
+     *
+     * @param query - RxDB RuleGroup 查询对象
+     * @returns QueryBuilder 状态
+     *
+     * @example
+     * ```typescript
+     * const converter = new QueryConverter<User>();
+     * const state = converter.fromRxDBQuery(rxdbQuery);
+     * ```
+     */
+    fromRxDBQuery(query: RuleGroup<T>): QueryBuilderState<T>;
+    /**
+     * 转换单个规则组到 RxDB 格式
+     */
+    private convertGroupToRxDB;
+    /**
+     * 转换单条规则到 RxDB 格式
+     * 移除 QueryBuilder 特有的 id 字段
+     */
+    private convertRuleToRxDB;
+    /**
+     * 从 RxDB 格式转换规则组
+     */
+    private convertGroupFromRxDB;
+    /**
+     * 从 RxDB 格式转换单条规则
+     * 添加 QueryBuilder 需要的 id 字段
+     */
+    private convertRuleFromRxDB;
+    /**
+     * 判断是否为 RxDB RuleGroup
+     */
+    private isRxDBRuleGroup;
+}
+/**
+ * 创建 QueryConverter 实例的工厂函数
+ */
+export declare function createQueryConverter<T = Record<string, unknown>>(options?: QueryConverterOptions): QueryConverter<T>;
+//# sourceMappingURL=query-converter.service.d.ts.map

package/dist/services/query-converter.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-converter.service.d.ts","sourceRoot":"","sources":["../../src/services/query-converter.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAQ,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAA2C,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAInH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAE/B,OAAO,GAAE,qBAA0B;IAI/C;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAItD;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAMxD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,CAAC,CAAC,CAEpH"}

package/dist/services/schema-parser.service.d.ts

@@ -0,0 +1,83 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+import { FieldMetadata } from '../models/query-builder-state.js';
+/**
+ * 解析器配置选项
+ */
+export interface SchemaParserOptions {
+    /**
+     * 是否包含外键字段
+     * @default false
+     */
+    includeForeignKeys?: boolean;
+    /**
+     * 是否包含计算属性
+     * @default false
+     */
+    includeComputedProperties?: boolean;
+    /**
+     * 是否包含关系字段（用于 EXISTS 操作符）
+     * @default false
+     */
+    includeRelations?: boolean;
+    /**
+     * 实体元数据映射（用于解析关系字段的目标实体字段）
+     * 键为实体名称，值为实体元数据
+     */
+    entityMetadataMap?: Map<string, EntityMetadata>;
+    /**
+     * 自定义字段过滤器
+     */
+    fieldFilter?: (field: FieldMetadata) => boolean;
+    /**
+     * 自定义显示名称生成器
+     */
+    displayNameGenerator?: (fieldName: string, metadata?: {
+        displayName?: string;
+    }) => string;
+}
+/**
+ * Schema 解析服务
+ * 负责将 RxDB EntityMetadata 转换为 QueryBuilder 可用的字段元数据
+ */
+export declare class SchemaParser {
+    private readonly options;
+    constructor(options?: SchemaParserOptions);
+    /**
+     * 从 EntityMetadata 解析字段元数据
+     *
+     * @param metadata - RxDB 实体元数据
+     * @returns 字段元数据数组
+     *
+     * @example
+     * ```typescript
+     * const parser = new SchemaParser();
+     * const fields = parser.parse(userMetadata);
+     * // [{ name: 'id', displayName: 'ID', type: 'string' }, ...]
+     * ```
+     */
+    parse(metadata: EntityMetadata): FieldMetadata[];
+    /**
+     * 从多个 EntityMetadata 批量解析
+     *
+     * @param metadataMap - 实体名称到元数据的映射
+     * @returns 实体名称到字段数组的映射
+     */
+    parseMany(metadataMap: Map<string, EntityMetadata>): Map<string, FieldMetadata[]>;
+    /**
+     * 解析单个属性
+     */
+    private parseProperty;
+    /**
+     * 将 RxDB PropertyType 映射到 QueryBuilder 类型
+     */
+    private mapPropertyType;
+    /**
+     * 解析关系字段
+     */
+    private parseRelation;
+}
+/**
+ * 创建 SchemaParser 实例的工厂函数
+ */
+export declare function createSchemaParser(options?: SchemaParserOptions): SchemaParser;
+//# sourceMappingURL=schema-parser.service.d.ts.map

package/dist/services/schema-parser.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-parser.service.d.ts","sourceRoot":"","sources":["../../src/services/schema-parser.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAmBtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAEhD;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC3F;AA4BD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;gBAEU,OAAO,GAAE,mBAAwB;IAW7C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,EAAE;IAuChD;;;;;OAKG;IACH,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAUjF;;OAEG;IACH,OAAO,CAAC,aAAa;IA6CrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAgCtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAE9E"}

package/dist/services/validation.service.d.ts

@@ -0,0 +1,67 @@
+import { FieldMetadata, QueryBuilderRule, QueryBuilderRuleGroup } from '../models/query-builder-state.js';
+import { ValidationResult, ValidationRule } from '../models/validation.interface.js';
+import { OperatorRegistry } from './operator-registry.service.js';
+/**
+ * 校验服务选项
+ */
+export interface ValidationServiceOptions {
+    /**
+     * 自定义校验规则
+     */
+    customRules?: ValidationRule[];
+    /**
+     * 操作符注册表
+     */
+    operatorRegistry?: OperatorRegistry;
+    /**
+     * 是否启用内置校验规则
+     * @default true
+     */
+    useBuiltinRules?: boolean;
+}
+/**
+ * 校验服务
+ * 负责验证 QueryBuilder 规则和值
+ */
+export declare class ValidationService {
+    private readonly rules;
+    private readonly operatorRegistry;
+    constructor(options?: ValidationServiceOptions);
+    /**
+     * 校验单条规则
+     */
+    validateRule<T>(rule: QueryBuilderRule<T>, field: FieldMetadata): ValidationResult;
+    /**
+     * 校验整个规则组
+     */
+    validateGroup<T>(group: QueryBuilderRuleGroup<T>, fields: Map<string, FieldMetadata>): ValidationResult;
+    /**
+     * 注册自定义校验规则
+     */
+    registerRule(rule: ValidationRule): void;
+    /**
+     * 移除校验规则
+     */
+    unregisterRule(name: string): boolean;
+    /**
+     * 获取所有校验规则
+     */
+    getRules(): ValidationRule[];
+    /**
+     * 校验值类型
+     */
+    private validateValueType;
+    /**
+     * 验证子查询规则的基本有效性（不依赖字段元数据）
+     *
+     * @description
+     * 子查询可能引用关系实体的字段，我们无法获取其 FieldMetadata。
+     * 因此只验证规则的基本结构和值类型，不验证字段是否存在或操作符是否匹配。
+     */
+    private validateSubqueryRules;
+}
+/**
+ * 创建 ValidationService 实例的工厂函数
+ */
+export declare function createValidationService(options?: ValidationServiceOptions): ValidationService;
+//# sourceMappingURL=validation.service.d.ts.map

package/dist/services/validation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.service.d.ts","sourceRoot":"","sources":["../../src/services/validation.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE/G,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAA8B,MAAM,gCAAgC,CAAC;AAe9F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAE/B;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiBD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,OAAO,GAAE,wBAA6B;IAmBlD;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,gBAAgB;IA4FlF;;OAEG;IACH,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,gBAAgB;IAiCvG;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoDzB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAgD9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAE7F"}

package/dist/utils/field-tree.d.ts

@@ -0,0 +1,119 @@
+import { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
+/**
+ * 字段树节点（用于 CascadeSelect）
+ *
+ * @description
+ * 将扁平的 FieldMetadata[] 转换为树形结构，
+ * 以便 CascadeSelect 组件级联展示嵌套字段。
+ */
+export interface FieldTreeNode {
+    /** 当前层的字段名 */
+    label: string;
+    /** 完整路径（作为选中值） */
+    value: string;
+    /** 显示名称 */
+    displayName: string;
+    /** 字段类型 */
+    type: PropertyType;
+    /** 是否是关系字段 */
+    isRelation: boolean;
+    /** 子节点 */
+    children?: FieldTreeNode[];
+    /** 字段描述 */
+    description?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 枚举值 */
+    enum?: unknown[];
+    /** 关系目标实体的字段列表（用于 EXISTS 子查询） */
+    relationFields?: FieldMetadata[];
+}
+/**
+ * 将扁平字段列表转换为树结构
+ *
+ * @description
+ * 将 `orders.items.productName` 这样的扁平路径转换为嵌套树结构：
+ * ```
+ * orders
+ * └── items
+ *     └── productName
+ * ```
+ *
+ * @param fields 扁平的字段元数据列表
+ * @returns 树形结构的字段节点
+ *
+ * @example
+ * ```ts
+ * const fields = [
+ *   { name: 'name', displayName: '姓名', type: 'string' },
+ *   { name: 'orders', displayName: '订单', type: 'relation' },
+ *   { name: 'orders.amount', displayName: '订单.金额', type: 'number' }
+ * ];
+ * const tree = buildFieldTree(fields);
+ * // tree[0] = { label: 'name', displayName: '姓名', ... }
+ * // tree[1] = { label: 'orders', displayName: '订单', children: [...] }
+ * ```
+ */
+export declare function buildFieldTree(fields: FieldMetadata[]): FieldTreeNode[];
+/**
+ * 在树中查找节点
+ *
+ * @param nodes 树节点列表
+ * @param value 要查找的值（完整路径）
+ * @returns 找到的节点或 undefined
+ *
+ * @example
+ * ```ts
+ * const node = findNodeByValue(tree, 'orders.items.productName');
+ * console.log(node?.displayName); // '商品名称'
+ * ```
+ */
+export declare function findNodeByValue(nodes: FieldTreeNode[], value: string): FieldTreeNode | undefined;
+/**
+ * 创建字段名到节点的映射
+ *
+ * @description
+ * 递归遍历树结构，创建一个 Map 用于快速查找节点。
+ * 对于需要频繁查找的场景，比直接递归更高效。
+ *
+ * @param tree 字段树
+ * @returns 字段名到节点的映射
+ *
+ * @example
+ * ```ts
+ * const nodeMap = createFieldNodeMap(tree);
+ * const node = nodeMap.get('orders.amount');
+ * ```
+ */
+export declare function createFieldNodeMap(tree: FieldTreeNode[]): Map<string, FieldTreeNode>;
+/**
+ * 获取 CascadeSelect 的 optionGroupChildren 配置
+ *
+ * @description
+ * CascadeSelect 需要知道每一层的子节点属性名。
+ * 由于我们统一使用 'children'，返回重复的 ['children', 'children', ...]
+ * 深度根据最大嵌套层级决定。
+ *
+ * @param maxDepth 最大深度，默认 10
+ * @returns children 属性名数组
+ */
+export declare function getOptionGroupChildren(maxDepth?: number): string[];
+/**
+ * 获取完整的 displayName 路径
+ *
+ * @description
+ * 给定字段路径（如 `orders.createdAt`），返回完整的显示名路径（如 `订单.创建时间`）。
+ * 通过遍历树结构，将每一级的 displayName 拼接起来。
+ *
+ * @param tree 字段树
+ * @param value 字段路径（如 `orders.createdAt`）
+ * @returns 显示名路径（如 `订单.创建时间`）
+ *
+ * @example
+ * ```ts
+ * const displayPath = getDisplayNamePath(tree, 'orders.createdAt');
+ * console.log(displayPath); // '订单.创建时间'
+ * ```
+ */
+export declare function getDisplayNamePath(tree: FieldTreeNode[], value: string): string;
+//# sourceMappingURL=field-tree.d.ts.map

package/dist/utils/field-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tree.d.ts","sourceRoot":"","sources":["../../src/utils/field-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIpF;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU;IACV,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU;IACV,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,iCAAiC;IACjC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAiHvE;AA8CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAWhG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAcpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,SAAK,GAAG,MAAM,EAAE,CAE9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB/E"}

package/dist/utils/id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview ID 生成工具
+ */
+/**
+ * 生成唯一 ID
+ * 用于 QueryBuilder 规则和规则组的标识
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Utils 导出
+ */
+export * from './field-tree.js';
+export * from './id.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/utils/metadata-field-extractor.d.ts

@@ -0,0 +1,150 @@
+import { EntityMetadata, EntityRelationMetadata, PropertyType } from '../../packages/rxdb/src/index.ts';
+import { FieldMetadata, PropertyType as QBPropertyType } from '../models/query-builder-state.js';
+/**
+ * 模型信息接口
+ */
+export interface ModelInfo {
+    name: string;
+    displayName: string;
+    entityClass: new (...args: any[]) => any;
+    metadata: EntityMetadata;
+}
+/**
+ * 查询示例接口
+ */
+export interface QueryExample {
+    name: string;
+    description: string;
+    modelName: string;
+    query: unknown;
+}
+/**
+ * 字段提取器配置
+ */
+export interface FieldExtractorConfig {
+    /** 关系查询深度，默认 4 */
+    relationQueryDeep?: number;
+    /** 系统字段列表，默认 ['id', 'createdAt', 'updatedAt', 'createdBy', 'updatedBy'] */
+    systemFields?: string[];
+}
+/**
+ * 将 PropertyType 映射到 FieldMetadata 的 type
+ *
+ * @param type - RxDB 属性类型
+ * @returns QueryBuilder 属性类型
+ *
+ * @example
+ * ```typescript
+ * mapPropertyType(PropertyType.string) // 'string'
+ * mapPropertyType(PropertyType.number) // 'number'
+ * mapPropertyType(PropertyType.boolean) // 'boolean'
+ * ```
+ */
+export declare function mapPropertyType(type: PropertyType): QBPropertyType;
+/**
+ * 获取关系需要忽略的键（避免循环引用）
+ *
+ * @param relation - 实体关系元数据
+ * @returns 需要忽略的键列表
+ *
+ * @remarks
+ * 对于 ONE_TO_MANY 和 MANY_TO_MANY 关系，返回 mappedProperty（如果存在）
+ * 以避免无限递归
+ *
+ * @example
+ * ```typescript
+ * // ONE_TO_MANY: User.orders -> Order.owner
+ * getRelationIgnoreKeys(ordersRelation) // ['owner']
+ * ```
+ */
+export declare function getRelationIgnoreKeys(relation: EntityRelationMetadata): string[];
+/**
+ * 从 EntityMetadata 提取字段（支持递归关系）
+ *
+ * @param metadata - 实体元数据
+ * @param allModels - 所有模型的映射表
+ * @param config - 字段提取器配置
+ * @param firstMetadata - 第一个实体的元数据（用于检测循环）
+ * @param ignoreKeys - 需要忽略的字段名列表
+ * @param prefix - 字段名前缀（用于嵌套关系）
+ * @param visitedEntities - 已访问的实体集合（防止循环）
+ * @param depth - 当前递归深度
+ * @returns 字段元数据列表
+ *
+ * @remarks
+ * 此函数会递归提取实体的所有字段，包括：
+ * 1. 系统字段（id, createdAt, updatedAt 等）
+ * 2. 实体属性字段
+ * 3. 外键字段
+ * 4. 关系字段（递归，直到达到深度限制）
+ *
+ * @example
+ * ```typescript
+ * const fields = extractFieldsFromMetadata(
+ *   userMetadata,
+ *   modelMap,
+ *   { relationQueryDeep: 3 }
+ * );
+ * // 返回: [
+ * //   { name: 'id', displayName: 'ID', type: 'string' },
+ * //   { name: 'name', displayName: '姓名', type: 'string' },
+ * //   { name: 'orders', displayName: '订单 (ONE_TO_MANY)', type: 'relation', ... },
+ * //   { name: 'orders.id', displayName: '订单.ID', type: 'string' },
+ * //   ...
+ * // ]
+ * ```
+ */
+export declare function extractFieldsFromMetadata(metadata: EntityMetadata, allModels: Map<string, ModelInfo>, config?: FieldExtractorConfig, firstMetadata?: EntityMetadata, ignoreKeys?: string[], prefix?: string, visitedEntities?: Set<string>, depth?: number): FieldMetadata[];
+/**
+ * 提取关系目标实体的字段（用于 EXISTS 子查询）
+ *
+ * @param metadata - 实体元数据
+ * @param config - 字段提取器配置
+ * @returns 字段元数据列表（仅一层，不递归）
+ *
+ * @remarks
+ * 此函数只提取一层字段，不递归关系。用于 EXISTS/NOT EXISTS 子查询的字段列表。
+ *
+ * @example
+ * ```typescript
+ * const fields = extractRelationTargetFields(orderMetadata);
+ * // 返回: [
+ * //   { name: 'id', displayName: 'ID', type: 'string' },
+ * //   { name: 'total', displayName: '总金额', type: 'number' },
+ * //   { name: 'ownerId', displayName: '用户ID', type: 'string' },
+ * //   ...
+ * // ]
+ * ```
+ */
+export declare function extractRelationTargetFields(metadata: EntityMetadata, config?: FieldExtractorConfig): FieldMetadata[];
+/**
+ * 对字段进行分组和排序
+ *
+ * @param fields - 字段元数据列表
+ * @returns 排序后的字段列表
+ *
+ * @remarks
+ * 排序规则：
+ * 1. 按层级深度排序（字段名中 '.' 的数量）
+ * 2. 同一层级按字段名字母顺序排序
+ *
+ * @example
+ * ```typescript
+ * const fields = [
+ *   { name: 'orders.id', ... },
+ *   { name: 'name', ... },
+ *   { name: 'id', ... },
+ *   { name: 'orders.total', ... }
+ * ];
+ *
+ * const sorted = organizeFields(fields);
+ * // 返回: [
+ * //   { name: 'id', ... },
+ * //   { name: 'name', ... },
+ * //   { name: 'orders.id', ... },
+ * //   { name: 'orders.total', ... }
+ * // ]
+ * ```
+ */
+export declare function organizeFields(fields: FieldMetadata[]): FieldMetadata[];
+//# sourceMappingURL=metadata-field-extractor.d.ts.map

package/dist/utils/metadata-field-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-field-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/metadata-field-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACzC,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAsBlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAKhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,MAAM,GAAE,oBAAyB,EACjC,aAAa,CAAC,EAAE,cAAc,EAC9B,UAAU,GAAE,MAAM,EAAO,EACzB,MAAM,SAAK,EACX,eAAe,GAAE,GAAG,CAAC,MAAM,CAAa,EACxC,KAAK,SAAI,GACR,aAAa,EAAE,CAkHjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,oBAAyB,GAChC,aAAa,EAAE,CA4CjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAOvE"}

package/dist/utils/schema-factory.d.ts

@@ -0,0 +1,60 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+import { FieldMetadata } from '../models/query-builder-state.js';
+import { SchemaParserOptions } from '../services/schema-parser.service.js';
+/**
+ * 从 EntityMetadata 创建字段元数据
+ *
+ * 这是一个便捷的工厂函数，封装了 SchemaParser 的创建和解析过程
+ *
+ * @param metadata - RxDB 实体元数据
+ * @param options - 解析器选项
+ * @returns 字段元数据数组
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * const fields = createSchemaFromEntity(userMetadata);
+ *
+ * // 包含外键
+ * const fieldsWithFK = createSchemaFromEntity(userMetadata, {
+ *   includeForeignKeys: true
+ * });
+ *
+ * // 包含计算属性
+ * const fieldsWithComputed = createSchemaFromEntity(userMetadata, {
+ *   includeComputedProperties: true
+ * });
+ *
+ * // 自定义过滤器
+ * const onlyStringFields = createSchemaFromEntity(userMetadata, {
+ *   fieldFilter: (field) => field.type === 'string'
+ * });
+ * ```
+ */
+export declare function createSchemaFromEntity(metadata: EntityMetadata, options?: SchemaParserOptions): FieldMetadata[];
+/**
+ * 从多个 EntityMetadata 批量创建字段元数据
+ *
+ * @param metadataMap - 实体名称到元数据的映射
+ * @param options - 解析器选项
+ * @returns 实体名称到字段数组的映射
+ *
+ * @example
+ * ```typescript
+ * const entities = new Map([
+ *   ['User', userMetadata],
+ *   ['Post', postMetadata],
+ *   ['Comment', commentMetadata]
+ * ]);
+ *
+ * const schemas = createSchemaFromEntities(entities, {
+ *   includeForeignKeys: true
+ * });
+ *
+ * // 使用结果
+ * const userFields = schemas.get('User');
+ * const postFields = schemas.get('Post');
+ * ```
+ */
+export declare function createSchemaFromEntities(metadataMap: Map<string, EntityMetadata>, options?: SchemaParserOptions): Map<string, FieldMetadata[]>;
+//# sourceMappingURL=schema-factory.d.ts.map

package/dist/utils/schema-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-factory.d.ts","sourceRoot":"","sources":["../../src/utils/schema-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAG/G;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACxC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAG9B"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@aiao/rxdb-query-builder",
+  "version": "0.0.10",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@aiao/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "name": "rxdb-query-builder",
+    "tags": [
+      "js-lib"
+    ]
+  },
+  "dependencies": {
+    "rxjs": "^7.8.2",
+    "uuid": "^13.0.0",
+    "@aiao/rxdb": "0.0.10"
+  }
+}