mongo-query-normalizer 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AACvB,6CAA4D;AAAnD,kHAAA,uBAAuB,OAAA"}

package/dist/merge-ops.d.ts

@@ -0,0 +1,33 @@
+import type { ParsedOp } from "./types";
+/**
+ * 按字段分组后，对同一字段的多个操作符进行合并（如多个 $eq -> $in，$gt 取 max，$in 取交集等）。
+ * 语义参考「合并同类项」，减少冗余条件并可能暴露冲突（如合并后 $in: []）。
+ *
+ * @param parsedOps - 解析后的条件列表（通常来自同一 $and 下的 parseSelector 结果）
+ * @returns 合并后的条件列表，可能更短或出现不可满足项
+ */
+export declare function reduceOps(parsedOps: ParsedOp[]): ParsedOp[];
+/**
+ * 对同一字段的多个 ParsedOp 做合并（$eq/$gt/$gte/$lt/$lte/$in/$nin 等可合并，其余保留）。
+ *
+ * @param field - 字段名
+ * @param ops - 该字段的 op+value 列表
+ * @returns 合并后的该字段对应的 ParsedOp 列表
+ */
+export declare function mergeFieldOps(field: string, ops: ParsedOp[]): ParsedOp[];
+/**
+ * 深度比较两个值是否相等（含 Date、数组、对象），用于去重与交集等。
+ *
+ * @param a - 任意值
+ * @param b - 任意值
+ * @returns 是否相等
+ */
+export declare function valueIsEqual(a: unknown, b: unknown): boolean;
+/**
+ * 数组去重（使用 valueIsEqual 比较）。
+ *
+ * @param array - 待去重数组
+ * @returns 去重后的新数组
+ */
+export declare function deduplicateArray<T>(array: T[]): T[];
+//# sourceMappingURL=merge-ops.d.ts.map

package/dist/merge-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-ops.d.ts","sourceRoot":"","sources":["../src/merge-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAIxE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGnD"}

package/dist/merge-ops.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reduceOps = reduceOps;
+exports.mergeFieldOps = mergeFieldOps;
+exports.valueIsEqual = valueIsEqual;
+exports.deduplicateArray = deduplicateArray;
+/**
+ * 按字段分组后，对同一字段的多个操作符进行合并（如多个 $eq -> $in，$gt 取 max，$in 取交集等）。
+ * 语义参考「合并同类项」，减少冗余条件并可能暴露冲突（如合并后 $in: []）。
+ *
+ * @param parsedOps - 解析后的条件列表（通常来自同一 $and 下的 parseSelector 结果）
+ * @returns 合并后的条件列表，可能更短或出现不可满足项
+ */
+function reduceOps(parsedOps) {
+    void parsedOps;
+    return [];
+}
+/**
+ * 对同一字段的多个 ParsedOp 做合并（$eq/$gt/$gte/$lt/$lte/$in/$nin 等可合并，其余保留）。
+ *
+ * @param field - 字段名
+ * @param ops - 该字段的 op+value 列表
+ * @returns 合并后的该字段对应的 ParsedOp 列表
+ */
+function mergeFieldOps(field, ops) {
+    void field;
+    void ops;
+    return [];
+}
+/**
+ * 深度比较两个值是否相等（含 Date、数组、对象），用于去重与交集等。
+ *
+ * @param a - 任意值
+ * @param b - 任意值
+ * @returns 是否相等
+ */
+function valueIsEqual(a, b) {
+    void a;
+    void b;
+    return false;
+}
+/**
+ * 数组去重（使用 valueIsEqual 比较）。
+ *
+ * @param array - 待去重数组
+ * @returns 去重后的新数组
+ */
+function deduplicateArray(array) {
+    void array;
+    return [];
+}
+//# sourceMappingURL=merge-ops.js.map

package/dist/merge-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-ops.js","sourceRoot":"","sources":["../src/merge-ops.ts"],"names":[],"mappings":";;AASA,8BAGC;AASD,sCAIC;AASD,oCAIC;AAQD,4CAGC;AA/CD;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,SAAqB;IAC7C,KAAK,SAAS,CAAC;IACf,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,KAAa,EAAE,GAAe;IAC1D,KAAK,KAAK,CAAC;IACX,KAAK,GAAG,CAAC;IACT,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,CAAU,EAAE,CAAU;IACjD,KAAK,CAAC,CAAC;IACP,KAAK,CAAC,CAAC;IACP,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAI,KAAU;IAC5C,KAAK,KAAK,CAAC;IACX,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/normalize-context.d.ts

@@ -0,0 +1,16 @@
+import type { NodeStats, ResolvedNormalizeOptions } from "./types";
+export interface NormalizeContext {
+    options: ResolvedNormalizeOptions;
+    appliedRules: string[];
+    skippedRules: string[];
+    warnings: string[];
+    bailedOut: boolean;
+    bailoutReason?: string;
+    beforeHash?: string;
+    afterHash?: string;
+    beforeStats?: NodeStats;
+    afterStats?: NodeStats;
+    depth: number;
+}
+export declare function createNormalizeContext(options: ResolvedNormalizeOptions): NormalizeContext;
+//# sourceMappingURL=normalize-context.d.ts.map

package/dist/normalize-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-context.d.ts","sourceRoot":"","sources":["../src/normalize-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,wBAAwB,CAAC;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,gBAAgB,CAc1F"}

package/dist/normalize-context.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNormalizeContext = createNormalizeContext;
+function createNormalizeContext(options) {
+    return {
+        options,
+        appliedRules: [],
+        skippedRules: [],
+        warnings: [],
+        bailedOut: false,
+        bailoutReason: undefined,
+        beforeHash: undefined,
+        afterHash: undefined,
+        beforeStats: undefined,
+        afterStats: undefined,
+        depth: 0,
+    };
+}
+//# sourceMappingURL=normalize-context.js.map

package/dist/normalize-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-context.js","sourceRoot":"","sources":["../src/normalize-context.ts"],"names":[],"mappings":";;AAgBA,wDAcC;AAdD,SAAgB,sBAAsB,CAAC,OAAiC;IACpE,OAAO;QACH,OAAO;QACP,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,SAAS;QACxB,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,CAAC;KACX,CAAC;AACN,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,6 @@
+import type { NormalizeOptions, NormalizeResult, Query } from "./types";
+/**
+ * 主入口：parse →（shape / predicate 直至稳定）→（可选 logical / experimental）→ canonicalize → compile。
+ */
+export declare function normalizeQuery(query: Query, options?: NormalizeOptions): NormalizeResult;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAExE;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAgBxF"}

package/dist/normalize.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeQuery = normalizeQuery;
+const hash_1 = require("./ast/hash");
+const compile_1 = require("./compile/compile");
+const normalize_context_1 = require("./normalize-context");
+const metrics_1 = require("./observe/metrics");
+const level_boundary_hints_1 = require("./observe/level-boundary-hints");
+const resolve_1 = require("./options/resolve");
+const canonicalize_1 = require("./passes/canonicalize");
+const normalize_predicate_1 = require("./passes/normalize-predicate");
+const normalize_shape_1 = require("./passes/normalize-shape");
+const simplify_1 = require("./passes/simplify");
+const parse_1 = require("./parse/parse");
+const hoist_common_predicates_from_or_1 = require("./rules/experimental/hoist-common-predicates-from-or");
+const detect_common_predicates_in_or_1 = require("./rules/logical/detect-common-predicates-in-or");
+/**
+ * 主入口：parse →（shape / predicate 直至稳定）→（可选 logical / experimental）→ canonicalize → compile。
+ */
+function normalizeQuery(query, options) {
+    const normalizeContext = (0, normalize_context_1.createNormalizeContext)((0, resolve_1.resolveNormalizeOptions)(options));
+    (0, level_boundary_hints_1.applyPreviewLevelBoundaryHints)(normalizeContext);
+    const beforeNode = (0, parse_1.parseQuery)(query, normalizeContext);
+    recordBeforeObservation(normalizeContext, beforeNode);
+    let workingNode = beforeNode;
+    workingNode = runNormalizePipeline(workingNode, normalizeContext);
+    const afterNode = normalizeContext.bailedOut ? beforeNode : workingNode;
+    recordAfterObservation(normalizeContext, afterNode);
+    const finalQuery = (0, compile_1.compileQuery)(afterNode, normalizeContext);
+    return buildNormalizeResult(query, finalQuery, beforeNode, afterNode, normalizeContext);
+}
+function recordBeforeObservation(normalizeContext, node) {
+    if (normalizeContext.options.observe.collectMetrics) {
+        normalizeContext.beforeStats = (0, metrics_1.collectNodeStats)(node);
+    }
+    normalizeContext.beforeHash = (0, hash_1.hashNode)(node);
+}
+function recordAfterObservation(normalizeContext, node) {
+    if (normalizeContext.options.observe.collectMetrics) {
+        normalizeContext.afterStats = (0, metrics_1.collectNodeStats)(node);
+    }
+    normalizeContext.afterHash = (0, hash_1.hashNode)(node);
+}
+const MAX_NORMALIZE_STABLE_ROUNDS = 8;
+function runNormalizePipeline(root, normalizeContext) {
+    let node = root;
+    const shouldRunPredicate = normalizeContext.options.level === "predicate" ||
+        normalizeContext.options.level === "logical" ||
+        normalizeContext.options.level === "experimental";
+    for (let o = 0; o < MAX_NORMALIZE_STABLE_ROUNDS; o++) {
+        const outerStart = (0, hash_1.hashNode)(node);
+        for (let r = 0; r < MAX_NORMALIZE_STABLE_ROUNDS; r++) {
+            const beforeRound = (0, hash_1.hashNode)(node);
+            node = (0, normalize_shape_1.normalizeShape)(node, normalizeContext);
+            if (normalizeContext.bailedOut) {
+                return root;
+            }
+            if ((0, hash_1.hashNode)(node) === beforeRound) {
+                break;
+            }
+        }
+        if (shouldRunPredicate) {
+            for (let r = 0; r < MAX_NORMALIZE_STABLE_ROUNDS; r++) {
+                const beforeRound = (0, hash_1.hashNode)(node);
+                node = (0, normalize_predicate_1.normalizePredicate)(node, normalizeContext);
+                if (normalizeContext.bailedOut) {
+                    return root;
+                }
+                node = (0, simplify_1.simplify)(node, normalizeContext);
+                if (normalizeContext.bailedOut) {
+                    return root;
+                }
+                if ((0, hash_1.hashNode)(node) === beforeRound) {
+                    break;
+                }
+            }
+        }
+        if ((0, hash_1.hashNode)(node) === outerStart) {
+            break;
+        }
+    }
+    const shouldRunLogicalDetect = normalizeContext.options.level === "logical" || normalizeContext.options.level === "experimental";
+    if (shouldRunLogicalDetect && normalizeContext.options.rules.detectCommonPredicatesInOr) {
+        node = (0, detect_common_predicates_in_or_1.detectCommonPredicatesInOr)(node, normalizeContext);
+        if (normalizeContext.bailedOut) {
+            return root;
+        }
+    }
+    const shouldRunExperimental = normalizeContext.options.level === "experimental" && normalizeContext.options.rules.hoistCommonPredicatesFromOr;
+    if (shouldRunExperimental) {
+        node = (0, hoist_common_predicates_from_or_1.hoistCommonPredicatesFromOr)(node, normalizeContext);
+        if (normalizeContext.bailedOut) {
+            return root;
+        }
+    }
+    node = (0, canonicalize_1.canonicalize)(node, normalizeContext);
+    return node;
+}
+function buildNormalizeResult(_originalQuery, finalQuery, _beforeNode, _afterNode, normalizeContext) {
+    const changed = normalizeContext.beforeHash !== normalizeContext.afterHash;
+    return {
+        query: finalQuery,
+        meta: {
+            changed,
+            level: normalizeContext.options.level,
+            appliedRules: normalizeContext.appliedRules,
+            skippedRules: normalizeContext.skippedRules,
+            warnings: normalizeContext.warnings,
+            bailedOut: normalizeContext.bailedOut,
+            bailoutReason: normalizeContext.bailoutReason,
+            beforeHash: normalizeContext.beforeHash,
+            afterHash: normalizeContext.afterHash,
+            stats: normalizeContext.options.observe.collectMetrics && normalizeContext.beforeStats && normalizeContext.afterStats
+                ? {
+                    before: normalizeContext.beforeStats,
+                    after: normalizeContext.afterStats,
+                }
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/observe/diff.d.ts

@@ -0,0 +1,7 @@
+import type { QueryNode } from "../ast/types";
+export declare function hasNodeChanged(before: QueryNode, after: QueryNode): boolean;
+export declare function createHashPair(before: QueryNode, after: QueryNode): {
+    beforeHash: string;
+    afterHash: string;
+};
+//# sourceMappingURL=diff.d.ts.map

package/dist/observe/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/observe/diff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAE3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAK7G"}

package/dist/observe/diff.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasNodeChanged = hasNodeChanged;
+exports.createHashPair = createHashPair;
+const hash_1 = require("../ast/hash");
+function hasNodeChanged(before, after) {
+    return (0, hash_1.hashNode)(before) !== (0, hash_1.hashNode)(after);
+}
+function createHashPair(before, after) {
+    return {
+        beforeHash: (0, hash_1.hashNode)(before),
+        afterHash: (0, hash_1.hashNode)(after),
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/observe/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/observe/diff.ts"],"names":[],"mappings":";;AAGA,wCAEC;AAED,wCAKC;AAZD,sCAAuC;AAGvC,SAAgB,cAAc,CAAC,MAAiB,EAAE,KAAgB;IAC9D,OAAO,IAAA,eAAQ,EAAC,MAAM,CAAC,KAAK,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,cAAc,CAAC,MAAiB,EAAE,KAAgB;IAC9D,OAAO;QACH,UAAU,EAAE,IAAA,eAAQ,EAAC,MAAM,CAAC;QAC5B,SAAS,EAAE,IAAA,eAAQ,EAAC,KAAK,CAAC;KAC7B,CAAC;AACN,CAAC"}

package/dist/observe/level-boundary-hints.d.ts

@@ -0,0 +1,11 @@
+import type { NormalizeContext } from "../normalize-context";
+import type { NormalizeLevel } from "../types";
+/** Clears process-wide console dedupe state; for unit tests only. */
+export declare function resetLevelPreviewConsoleStateForTests(): void;
+export declare function formatPreviewOnlyWarningMessage(level: NormalizeLevel): string;
+/**
+ * Records a v0.1.0 boundary hint for non-`shape` levels in `meta.warnings`, and may emit a
+ * one-time-per-level `console.warn` in non-production environments.
+ */
+export declare function applyPreviewLevelBoundaryHints(normalizeContext: NormalizeContext): void;
+//# sourceMappingURL=level-boundary-hints.d.ts.map

package/dist/observe/level-boundary-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-boundary-hints.d.ts","sourceRoot":"","sources":["../../src/observe/level-boundary-hints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C,qEAAqE;AACrE,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE7E;AASD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAmBvF"}

package/dist/observe/level-boundary-hints.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetLevelPreviewConsoleStateForTests = resetLevelPreviewConsoleStateForTests;
+exports.formatPreviewOnlyWarningMessage = formatPreviewOnlyWarningMessage;
+exports.applyPreviewLevelBoundaryHints = applyPreviewLevelBoundaryHints;
+const warnedPreviewLevelsInProcess = new Set();
+/** Clears process-wide console dedupe state; for unit tests only. */
+function resetLevelPreviewConsoleStateForTests() {
+    warnedPreviewLevelsInProcess.clear();
+}
+function formatPreviewOnlyWarningMessage(level) {
+    return `[mongo-query-normalizer] level "${level}" is preview-only in v0.1.0 and is not recommended for general production use. Prefer level "shape" for production traffic.`;
+}
+function shouldEmitConsoleWarning() {
+    if (typeof process === "undefined") {
+        return false;
+    }
+    return process.env.NODE_ENV !== "production";
+}
+/**
+ * Records a v0.1.0 boundary hint for non-`shape` levels in `meta.warnings`, and may emit a
+ * one-time-per-level `console.warn` in non-production environments.
+ */
+function applyPreviewLevelBoundaryHints(normalizeContext) {
+    const level = normalizeContext.options.level;
+    if (level === "shape") {
+        return;
+    }
+    const message = formatPreviewOnlyWarningMessage(level);
+    if (!normalizeContext.warnings.includes(message)) {
+        normalizeContext.warnings.push(message);
+    }
+    if (!shouldEmitConsoleWarning()) {
+        return;
+    }
+    if (warnedPreviewLevelsInProcess.has(level)) {
+        return;
+    }
+    warnedPreviewLevelsInProcess.add(level);
+    console.warn(message);
+}
+//# sourceMappingURL=level-boundary-hints.js.map

package/dist/observe/level-boundary-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-boundary-hints.js","sourceRoot":"","sources":["../../src/observe/level-boundary-hints.ts"],"names":[],"mappings":";;AAMA,sFAEC;AAED,0EAEC;AAaD,wEAmBC;AAzCD,MAAM,4BAA4B,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE/D,qEAAqE;AACrE,SAAgB,qCAAqC;IACjD,4BAA4B,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,+BAA+B,CAAC,KAAqB;IACjE,OAAO,mCAAmC,KAAK,6HAA6H,CAAC;AACjL,CAAC;AAED,SAAS,wBAAwB;IAC7B,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAgB,8BAA8B,CAAC,gBAAkC;IAC7E,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO;IACX,CAAC;IAED,MAAM,OAAO,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC;QAC9B,OAAO;IACX,CAAC;IACD,IAAI,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO;IACX,CAAC;IACD,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC"}

package/dist/observe/level-preview-warning.d.ts

@@ -0,0 +1,11 @@
+import type { NormalizeContext } from "../normalize-context";
+import type { NormalizeLevel } from "../types";
+/** Clears process-wide console dedupe state; for unit tests only. */
+export declare function resetLevelPreviewConsoleStateForTests(): void;
+export declare function formatPreviewOnlyWarningMessage(level: NormalizeLevel): string;
+/**
+ * Records a v0.1.0 boundary hint for non-`shape` levels in `meta.warnings`, and may emit a
+ * one-time-per-level `console.warn` in non-production environments.
+ */
+export declare function applyPreviewLevelBoundaryHints(normalizeContext: NormalizeContext): void;
+//# sourceMappingURL=level-preview-warning.d.ts.map

package/dist/observe/level-preview-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-preview-warning.d.ts","sourceRoot":"","sources":["../../src/observe/level-preview-warning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C,qEAAqE;AACrE,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE7E;AASD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAmBvF"}

package/dist/observe/level-preview-warning.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetLevelPreviewConsoleStateForTests = resetLevelPreviewConsoleStateForTests;
+exports.formatPreviewOnlyWarningMessage = formatPreviewOnlyWarningMessage;
+exports.applyPreviewLevelBoundaryHints = applyPreviewLevelBoundaryHints;
+const warnedPreviewLevelsInProcess = new Set();
+/** Clears process-wide console dedupe state; for unit tests only. */
+function resetLevelPreviewConsoleStateForTests() {
+    warnedPreviewLevelsInProcess.clear();
+}
+function formatPreviewOnlyWarningMessage(level) {
+    return `[mongo-query-normalizer] level "${level}" is preview-only in v0.1.0 and is not recommended for general production use. Prefer level "shape" for production traffic.`;
+}
+function shouldEmitConsoleWarning() {
+    if (typeof process === "undefined") {
+        return false;
+    }
+    return process.env.NODE_ENV !== "production";
+}
+/**
+ * Records a v0.1.0 boundary hint for non-`shape` levels in `meta.warnings`, and may emit a
+ * one-time-per-level `console.warn` in non-production environments.
+ */
+function applyPreviewLevelBoundaryHints(normalizeContext) {
+    const level = normalizeContext.options.level;
+    if (level === "shape") {
+        return;
+    }
+    const message = formatPreviewOnlyWarningMessage(level);
+    if (!normalizeContext.warnings.includes(message)) {
+        normalizeContext.warnings.push(message);
+    }
+    if (!shouldEmitConsoleWarning()) {
+        return;
+    }
+    if (warnedPreviewLevelsInProcess.has(level)) {
+        return;
+    }
+    warnedPreviewLevelsInProcess.add(level);
+    console.warn(message);
+}
+//# sourceMappingURL=level-preview-warning.js.map

package/dist/observe/level-preview-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-preview-warning.js","sourceRoot":"","sources":["../../src/observe/level-preview-warning.ts"],"names":[],"mappings":";;AAMA,sFAEC;AAED,0EAEC;AAaD,wEAmBC;AAzCD,MAAM,4BAA4B,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE/D,qEAAqE;AACrE,SAAgB,qCAAqC;IACjD,4BAA4B,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,+BAA+B,CAAC,KAAqB;IACjE,OAAO,mCAAmC,KAAK,6HAA6H,CAAC;AACjL,CAAC;AAED,SAAS,wBAAwB;IAC7B,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAgB,8BAA8B,CAAC,gBAAkC;IAC7E,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO;IACX,CAAC;IAED,MAAM,OAAO,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC;QAC9B,OAAO;IACX,CAAC;IACD,IAAI,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO;IACX,CAAC;IACD,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC"}

package/dist/observe/metrics.d.ts

@@ -0,0 +1,4 @@
+import type { QueryNode } from "../ast/types";
+import type { NodeStats } from "../types";
+export declare function collectNodeStats(node: QueryNode): NodeStats;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observe/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observe/metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAS3D"}

package/dist/observe/metrics.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectNodeStats = collectNodeStats;
+const guards_1 = require("../ast/guards");
+function collectNodeStats(node) {
+    const acc = {
+        nodeCount: 0,
+        maxDepth: 0,
+        andCount: 0,
+        orCount: 0,
+    };
+    walkNode(node, 1, acc);
+    return acc;
+}
+function walkNode(node, depth, acc) {
+    acc.nodeCount += 1;
+    acc.maxDepth = Math.max(acc.maxDepth, depth);
+    if ((0, guards_1.isLogicalNode)(node)) {
+        if (node.op === "$and") {
+            acc.andCount += 1;
+        }
+        if (node.op === "$or") {
+            acc.orCount += 1;
+        }
+        for (const child of node.children) {
+            walkNode(child, depth + 1, acc);
+        }
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observe/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observe/metrics.ts"],"names":[],"mappings":";;AAIA,4CASC;AAbD,0CAA8C;AAI9C,SAAgB,gBAAgB,CAAC,IAAe;IAC5C,MAAM,GAAG,GAAc;QACnB,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;KACb,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,IAAe,EAAE,KAAa,EAAE,GAAc;IAC5D,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC;IACnB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE7C,IAAI,IAAA,sBAAa,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACrB,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YACpB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/observe/warnings.d.ts

@@ -0,0 +1,6 @@
+import type { NormalizeContext } from "../normalize-context";
+export declare function addWarning(normalizeContext: NormalizeContext, message: string): void;
+export declare function markRuleApplied(normalizeContext: NormalizeContext, ruleId: string): void;
+export declare function markRuleSkipped(normalizeContext: NormalizeContext, ruleId: string, reason?: string): void;
+export declare function bailout(normalizeContext: NormalizeContext, reason: string): void;
+//# sourceMappingURL=warnings.d.ts.map

package/dist/observe/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../src/observe/warnings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wBAAgB,UAAU,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKpF;AAED,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAExF;AAED,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzG;AAED,wBAAgB,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIhF"}

package/dist/observe/warnings.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addWarning = addWarning;
+exports.markRuleApplied = markRuleApplied;
+exports.markRuleSkipped = markRuleSkipped;
+exports.bailout = bailout;
+function addWarning(normalizeContext, message) {
+    if (!normalizeContext.options.observe.collectWarnings) {
+        return;
+    }
+    normalizeContext.warnings.push(message);
+}
+function markRuleApplied(normalizeContext, ruleId) {
+    normalizeContext.appliedRules.push(ruleId);
+}
+function markRuleSkipped(normalizeContext, ruleId, reason) {
+    normalizeContext.skippedRules.push(reason ? `${ruleId}: ${reason}` : ruleId);
+}
+function bailout(normalizeContext, reason) {
+    normalizeContext.bailedOut = true;
+    normalizeContext.bailoutReason = reason;
+    addWarning(normalizeContext, `bailout: ${reason}`);
+}
+//# sourceMappingURL=warnings.js.map

package/dist/observe/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../src/observe/warnings.ts"],"names":[],"mappings":";;AAEA,gCAKC;AAED,0CAEC;AAED,0CAEC;AAED,0BAIC;AAnBD,SAAgB,UAAU,CAAC,gBAAkC,EAAE,OAAe;IAC1E,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QACpD,OAAO;IACX,CAAC;IACD,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,eAAe,CAAC,gBAAkC,EAAE,MAAc;IAC9E,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,eAAe,CAAC,gBAAkC,EAAE,MAAc,EAAE,MAAe;IAC/F,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,SAAgB,OAAO,CAAC,gBAAkC,EAAE,MAAc;IACtE,gBAAgB,CAAC,SAAS,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,aAAa,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,gBAAgB,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/operations/compile.d.ts

@@ -0,0 +1,7 @@
+import type { Selector } from "../types";
+import type { SelectorAST } from "../ast/types";
+/**
+ * AST → Mongo Selector 纯直译，不修改结构（结构由 canonicalize 保证）。
+ */
+export declare function compileSelector(ast: SelectorAST): Selector;
+//# sourceMappingURL=compile.d.ts.map

package/dist/operations/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/operations/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhE;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,QAAQ,CAkC1D"}

package/dist/operations/compile.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileSelector = compileSelector;
+const types_1 = require("../types");
+function isEmptyObject(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.keys(value).length === 0);
+}
+/**
+ * AST → Mongo Selector 纯直译，不修改结构（结构由 canonicalize 保证）。
+ */
+function compileSelector(ast) {
+    switch (ast.type) {
+        case "true":
+            return {};
+        case "false":
+            return types_1.IMPOSSIBLE_SELECTOR;
+        case "field":
+            return { [ast.field]: compileFieldConditions(ast.conditions) };
+        case "logical": {
+            if (ast.op === "$and") {
+                const compiled = [];
+                for (const child of ast.children) {
+                    const c = compileSelector(child);
+                    if (!isEmptyObject(c)) {
+                        compiled.push(c);
+                    }
+                }
+                if (compiled.length === 0) {
+                    return {};
+                }
+                if (compiled.length === 1) {
+                    return compiled[0];
+                }
+                return { $and: compiled };
+            }
+            return {
+                [ast.op]: ast.children.map((c) => compileSelector(c)),
+            };
+        }
+        default:
+            throw new Error("Unknown AST node type: " + (ast && typeof ast === "object" && "type" in ast ? ast.type : String(ast)));
+    }
+}
+/**
+ * 将已规范化的 FieldCondition[] 编译为 Mongo 字段值（字面量或 { $op: value }）。
+ * 条件合并与 $eq/$in 规范化由 fieldConditionNormalize 在 AST 层完成，此处仅做直译。
+ *
+ * **不变量（前置条件）**：同一 `op` 在 `conditions` 中至多出现一次。
+ * 若违反，对象字面量赋值会静默覆盖；开发环境下会抛出以便尽早发现上游回归。
+ */
+function compileFieldConditions(conditions) {
+    if (conditions.length === 0) {
+        return undefined;
+    }
+    if (conditions.length === 1 && conditions[0].op === "$eq") {
+        return conditions[0].value;
+    }
+    const out = {};
+    for (const c of conditions) {
+        if (Object.prototype.hasOwnProperty.call(out, c.op)) {
+            throw new Error(`compileFieldConditions: duplicate operator "${c.op}" — upstream must merge or order uniquely`);
+        }
+        out[c.op] = c.value;
+    }
+    return out;
+}
+//# sourceMappingURL=compile.js.map

package/dist/operations/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/operations/compile.ts"],"names":[],"mappings":";;AAgBA,0CAkCC;AAjDD,oCAA+C;AAG/C,SAAS,aAAa,CAAC,KAAc;IACjC,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,KAAK,CAAC,CAC5C,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAgB;IAC5C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,MAAM;YACP,OAAO,EAAE,CAAC;QACd,KAAK,OAAO;YACR,OAAO,2BAAmB,CAAC;QAC/B,KAAK,OAAO;YACR,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAc,CAAC;QAC/E,KAAK,SAAS,CAAC,CAAC,CAAC;YACb,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAe,EAAE,CAAC;gBAChC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAC/B,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;oBACjC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACrB,CAAC;gBACL,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,EAAE,CAAC;gBACd,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACvB,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAc,CAAC;YAC1C,CAAC;YACD,OAAO;gBACH,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;aAC5C,CAAC;QAClB,CAAC;QACD;YACI,MAAM,IAAI,KAAK,CACX,yBAAyB,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,GAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAChI,CAAC;IACV,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,UAA4B;IACxD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACX,+CAA+C,CAAC,CAAC,EAAE,2CAA2C,CACjG,CAAC;QACN,CAAC;QACD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}