mongo-query-normalizer 0.1.0

package/dist/utils/compare-values.d.ts

@@ -0,0 +1,6 @@
+export declare function isComparableScalar(value: unknown): value is number | string | boolean | Date;
+/**
+ * @returns -1 | 0 | 1，或 null 表示不可比较
+ */
+export declare function compareScalarValues(a: unknown, b: unknown): -1 | 0 | 1 | null;
+//# sourceMappingURL=compare-values.d.ts.map

package/dist/utils/compare-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-values.d.ts","sourceRoot":"","sources":["../../src/utils/compare-values.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAO5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAmB7E"}

package/dist/utils/compare-values.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isComparableScalar = isComparableScalar;
+exports.compareScalarValues = compareScalarValues;
+function isComparableScalar(value) {
+    return (typeof value === "number" ||
+        typeof value === "string" ||
+        typeof value === "boolean" ||
+        value instanceof Date);
+}
+/**
+ * @returns -1 | 0 | 1，或 null 表示不可比较
+ */
+function compareScalarValues(a, b) {
+    if (!isComparableScalar(a) || !isComparableScalar(b)) {
+        return null;
+    }
+    if (a.constructor !== b.constructor) {
+        return null;
+    }
+    const av = a instanceof Date ? a.getTime() : a;
+    const bv = b instanceof Date ? b.getTime() : b;
+    if (av < bv) {
+        return -1;
+    }
+    if (av > bv) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=compare-values.js.map

package/dist/utils/compare-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-values.js","sourceRoot":"","sources":["../../src/utils/compare-values.ts"],"names":[],"mappings":";;AAAA,gDAOC;AAKD,kDAmBC;AA/BD,SAAgB,kBAAkB,CAAC,KAAc;IAC7C,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,KAAK,YAAY,IAAI,CACxB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,CAAU,EAAE,CAAU;IACtD,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/C,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACV,OAAO,CAAC,CAAC,CAAC;IACd,CAAC;IACD,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACV,OAAO,CAAC,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/utils/deep-equal.d.ts

@@ -0,0 +1,2 @@
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=deep-equal.d.ts.map

package/dist/utils/deep-equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal.d.ts","sourceRoot":"","sources":["../../src/utils/deep-equal.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA4BzD"}

package/dist/utils/deep-equal.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepEqual = deepEqual;
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
+}
+function deepEqual(a, b) {
+    if (a === b) {
+        return true;
+    }
+    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) => deepEqual(item, b[i]));
+    }
+    if (isPlainObject(a) && isPlainObject(b)) {
+        const aKeys = Object.keys(a).sort();
+        const bKeys = Object.keys(b).sort();
+        if (!deepEqual(aKeys, bKeys)) {
+            return false;
+        }
+        return aKeys.every((key) => deepEqual(a[key], b[key]));
+    }
+    return false;
+}
+//# sourceMappingURL=deep-equal.js.map

package/dist/utils/deep-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal.js","sourceRoot":"","sources":["../../src/utils/deep-equal.ts"],"names":[],"mappings":";;AAIA,8BA4BC;AAhCD,SAAS,aAAa,CAAC,KAAc;IACjC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC;AACrG,CAAC;AAED,SAAgB,SAAS,CAAC,CAAU,EAAE,CAAU;IAC5C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QACzC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEpC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/utils/is-opaque.d.ts

@@ -0,0 +1,4 @@
+export declare function isOpaqueOperator(op: string): boolean;
+export declare function shouldTreatAsOpaque(value: unknown): boolean;
+export declare function getOpaqueReason(value: unknown): string;
+//# sourceMappingURL=is-opaque.d.ts.map

package/dist/utils/is-opaque.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-opaque.d.ts","sourceRoot":"","sources":["../../src/utils/is-opaque.ts"],"names":[],"mappings":"AAYA,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAY3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYtD"}

package/dist/utils/is-opaque.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOpaqueOperator = isOpaqueOperator;
+exports.shouldTreatAsOpaque = shouldTreatAsOpaque;
+exports.getOpaqueReason = getOpaqueReason;
+const OPAQUE_OPERATORS = new Set([
+    "$regex",
+    "$not",
+    "$elemMatch",
+    "$expr",
+    "$geoWithin",
+    "$geoIntersects",
+    "$near",
+    "$nearSphere",
+    "$text",
+]);
+function isOpaqueOperator(op) {
+    return OPAQUE_OPERATORS.has(op);
+}
+function shouldTreatAsOpaque(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    for (const key of Object.keys(value)) {
+        if (key.startsWith("$") && isOpaqueOperator(key)) {
+            return true;
+        }
+    }
+    return false;
+}
+function getOpaqueReason(value) {
+    if (!value || typeof value !== "object") {
+        return "value is not object";
+    }
+    for (const key of Object.keys(value)) {
+        if (isOpaqueOperator(key)) {
+            return `operator ${key} is treated as opaque`;
+        }
+    }
+    return "unknown opaque structure";
+}
+//# sourceMappingURL=is-opaque.js.map

package/dist/utils/is-opaque.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-opaque.js","sourceRoot":"","sources":["../../src/utils/is-opaque.ts"],"names":[],"mappings":";;AAYA,4CAEC;AAED,kDAYC;AAED,0CAYC;AA1CD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC7B,QAAQ;IACR,MAAM;IACN,YAAY;IACZ,OAAO;IACP,YAAY;IACZ,gBAAgB;IAChB,OAAO;IACP,aAAa;IACb,OAAO;CACV,CAAC,CAAC;AAEH,SAAgB,gBAAgB,CAAC,EAAU;IACvC,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,EAAE,CAAC;QAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,qBAAqB,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,EAAE,CAAC;QAC7C,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,YAAY,GAAG,uBAAuB,CAAC;QAClD,CAAC;IACL,CAAC;IAED,OAAO,0BAA0B,CAAC;AACtC,CAAC"}

package/dist/utils/stable-sort.d.ts

@@ -0,0 +1,2 @@
+export declare function stableSort<T>(items: readonly T[], compareFn: (a: T, b: T) => number): T[];
+//# sourceMappingURL=stable-sort.d.ts.map

package/dist/utils/stable-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-sort.d.ts","sourceRoot":"","sources":["../../src/utils/stable-sort.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE,CAWzF"}

package/dist/utils/stable-sort.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stableSort = stableSort;
+function stableSort(items, compareFn) {
+    return items
+        .map((item, index) => ({ item, index }))
+        .sort((a, b) => {
+        const cmp = compareFn(a.item, b.item);
+        if (cmp !== 0) {
+            return cmp;
+        }
+        return a.index - b.index;
+    })
+        .map((entry) => entry.item);
+}
+//# sourceMappingURL=stable-sort.js.map

package/dist/utils/stable-sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-sort.js","sourceRoot":"","sources":["../../src/utils/stable-sort.ts"],"names":[],"mappings":";;AAAA,gCAWC;AAXD,SAAgB,UAAU,CAAI,KAAmB,EAAE,SAAiC;IAChF,OAAO,KAAK;SACP,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YACZ,OAAO,GAAG,CAAC;QACf,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC7B,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "mongo-query-normalizer",
+  "version": "0.1.0",
+  "description": "Observable, level-based normalizer for MongoDB query objects. Defaults to conservative shape stabilization; higher levels are preview surfaces in v0.1.0. Predictable output and metadata—not planner optimization.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && npm run test:unit && npm run test:semantic",
+    "test:unit": "mocha \"test/**/*.test.js\" --ignore \"test/semantic/**/*.test.js\" --ignore \"test/regression/**/*.test.js\" --ignore \"test/property/**/*.test.js\"",
+    "test:semantic": "mocha --require ./test/helpers/mocha-semantic-hooks.js \"test/semantic/**/*.test.js\" \"test/regression/**/*.test.js\" \"test/property/**/*.test.js\"",
+    "test:semantic:quick": "FC_SEED=42 FC_RUNS=45 mocha --require ./test/helpers/mocha-semantic-hooks.js \"test/semantic/**/*.test.js\" \"test/regression/**/*.test.js\" \"test/property/**/*.test.js\"",
+    "test:semantic:ci": "FC_RUNS=200 FC_SEED=42 mocha --require ./test/helpers/mocha-semantic-hooks.js \"test/semantic/**/*.test.js\" \"test/regression/**/*.test.js\" \"test/property/**/*.test.js\"",
+    "prepublishOnly": "npm run build"
+  },
+  "author": "",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/verycooltop/mongo-query-normalizer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/verycooltop/mongo-query-normalizer/issues"
+  },
+  "homepage": "https://github.com/verycooltop/mongo-query-normalizer#readme",
+  "keywords": [
+    "mongodb",
+    "query",
+    "normalizer",
+    "normalize",
+    "filter"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "ts-node": "^10.9.2",
+    "fast-check": "^3.23.1",
+    "mocha": "^10.8.2",
+    "mongodb": "^6.8.0",
+    "mongodb-memory-server": "^11.0.1",
+    "typescript": "^5.0.0"
+  }
+}