turbine-orm 0.28.0 → 0.28.2

package/dist/cjs/query/builder.js

@@ -52,229 +52,10 @@ const index_advisor_js_1 = require("../index-advisor.js");
 const nested_write_js_1 = require("../nested-write.js");
 const schema_js_1 = require("../schema.js");
 const batched_loader_js_1 = require("./batched-loader.js");
+const filters_js_1 = require("./filters.js");
 const utils_js_1 = require("./utils.js");
-// ---------------------------------------------------------------------------
-// Internal detection helpers — used by QueryInterface
-// ---------------------------------------------------------------------------
-/** Check if a value is a where operator object (has at least one known operator key) */
-function isWhereOperator(value) {
-    if (value === null ||
-        value === undefined ||
-        typeof value !== 'object' ||
-        Array.isArray(value) ||
-        value instanceof Date) {
-        return false;
-    }
-    const keys = Object.keys(value);
-    return keys.length > 0 && keys.every((k) => utils_js_1.OPERATOR_KEYS.has(k));
-}
-/**
- * True for a *plain object literal* that reached an equality fallthrough
- * without matching any known filter shape — the misspelled-operator case.
- * Class instances (Buffer for bytea, Decimal wrappers, ...) are legitimate
- * bind values and return false, as do arrays and Dates.
- */
-function isUnmatchedPlainObject(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value) || value instanceof Date)
-        return false;
-    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value))
-        return false;
-    const proto = Object.getPrototypeOf(value);
-    return proto === Object.prototype || proto === null;
-}
-/**
- * Fingerprint the SHAPE of a where-operator object. Null-valued `equals` /
- * `not` compile to parameterless `IS NULL` / `IS NOT NULL` (different SQL, no
- * param pushed), so null-ness is part of the shape — without it a cache entry
- * warmed by `{ not: 5 }` would serve `{ not: null }` with a desynced param list.
- */
-function fingerprintOperatorShape(value) {
-    const obj = value;
-    const opKeys = Object.keys(obj)
-        .filter((k) => k !== 'mode')
-        .map((k) => ((k === 'equals' || k === 'not') && obj[k] === null ? `${k}:null` : k))
-        .sort();
-    const modeStr = value.mode === 'insensitive' ? ':i' : '';
-    return `op(${opKeys.join(',')}${modeStr})`;
-}
-/**
- * Guard for the value of an `equals` operator reaching the plain-equality
- * operator path. A plain object literal can only legitimately be an equality
- * value on a json/jsonb column — and those route to the JSONB filter branch
- * BEFORE the operator branch, so any plain object that reaches here is a
- * mistake (e.g. `{ equals: { foo: 1 } }` on a text column). Shared by the
- * SQL-build path and the cache-hit param-collect path so a warmed cache can
- * never skip the check.
- */
-function assertBindableEqualsOperand(value, column) {
-    if (!isUnmatchedPlainObject(value))
-        return;
-    throw new errors_js_1.ValidationError(`[turbine] Plain-object value for operator 'equals' on ${column}: ` +
-        `objects are only valid 'equals' values on JSON (json/jsonb) columns, ` +
-        `where 'equals' is the JSONB containment filter.`);
-}
-/**
- * Object keys in sorted order, mirroring the canonical order used by every
- * cache fingerprint. The SQL-build and cache-hit param-collect paths MUST
- * enumerate object keys in this exact order: fingerprints sort keys, so two
- * where clauses with the same fields in different insertion order share one
- * cache entry — if build/collect iterated insertion order, the cached SQL's
- * `$N` placeholders would bind the wrong values (cross-tenant-leak class).
- * Array order (OR/AND members) is positional and is never sorted.
- */
-function sortedKeys(obj) {
-    return Object.keys(obj).sort();
-}
-/** {@link sortedKeys}, but yielding `[key, value]` pairs. */
-function sortedEntries(obj) {
-    return Object.entries(obj).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
-}
-/** Known atomic-update operator keys — used to detect operator objects vs plain JSON values */
 /** Relations already warned about missing FK indexes (once per process, dev only). */
 const unindexedRelationWarned = new Set();
-const UPDATE_OPERATOR_KEYS = new Set(['set', 'increment', 'decrement', 'multiply', 'divide']);
-/** Known JSONB operator keys */
-const JSONB_OPERATOR_KEYS = new Set(['path', 'equals', 'contains', 'hasKey']);
-/**
- * JSONB operator keys that are *unique* to {@link JsonFilter} — they cannot
- * appear in any other where-filter shape, so the presence of one of these is
- * an unambiguous signal that the user meant a JSON filter. Used by the
- * strict-validation path so that `{ contains: 'foo' }` (which is also a valid
- * `WhereOperator` for LIKE) is not misclassified. Note `equals` is NOT in this
- * set: on non-JSON columns it is a plain equality operator (`WhereOperator`),
- * so it must fall through instead of throwing.
- */
-const JSONB_UNIQUE_KEYS = new Set(['path', 'hasKey']);
-/** Check if a value is a JSONB filter object */
-function isJsonFilter(value) {
-    if (value === null ||
-        value === undefined ||
-        typeof value !== 'object' ||
-        Array.isArray(value) ||
-        value instanceof Date) {
-        return false;
-    }
-    const keys = Object.keys(value);
-    return keys.length > 0 && keys.some((k) => JSONB_OPERATOR_KEYS.has(k));
-}
-/**
- * Returns the first JSON-unique key found in `value`, or `null` if none.
- * Used to drive the strict-validation error message.
- */
-function findJsonUniqueKey(value) {
-    for (const k of Object.keys(value)) {
-        if (JSONB_UNIQUE_KEYS.has(k))
-            return k;
-    }
-    return null;
-}
-/** Known Array operator keys */
-const ARRAY_OPERATOR_KEYS = new Set(['has', 'hasEvery', 'hasSome', 'isEmpty']);
-/**
- * Array operator keys that are *unique* to {@link ArrayFilter}. None of the
- * array operators currently overlap with `WhereOperator` or `JsonFilter`, so
- * this set equals {@link ARRAY_OPERATOR_KEYS}; it is kept as a separate
- * constant so a future overlap (e.g. a `contains` for arrays) is easy to
- * carve out.
- */
-const ARRAY_UNIQUE_KEYS = new Set(['has', 'hasEvery', 'hasSome', 'isEmpty']);
-/** Check if a value is an Array filter object */
-function isArrayFilter(value) {
-    if (value === null ||
-        value === undefined ||
-        typeof value !== 'object' ||
-        Array.isArray(value) ||
-        value instanceof Date) {
-        return false;
-    }
-    const keys = Object.keys(value);
-    return keys.length > 0 && keys.some((k) => ARRAY_OPERATOR_KEYS.has(k));
-}
-/**
- * Returns the first array-unique key found in `value`, or `null` if none.
- * Used to drive the strict-validation error message.
- */
-function findArrayUniqueKey(value) {
-    for (const k of Object.keys(value)) {
-        if (ARRAY_UNIQUE_KEYS.has(k))
-            return k;
-    }
-    return null;
-}
-/** Known text search operator keys */
-const TEXT_SEARCH_KEYS = new Set(['search', 'config']);
-/** Check if a value is a TextSearchFilter object */
-function isTextSearchFilter(value) {
-    if (value === null ||
-        value === undefined ||
-        typeof value !== 'object' ||
-        Array.isArray(value) ||
-        value instanceof Date) {
-        return false;
-    }
-    const keys = Object.keys(value);
-    // Must have 'search' key and only known text search keys
-    return keys.includes('search') && keys.every((k) => TEXT_SEARCH_KEYS.has(k));
-}
-/**
- * Validate a text search config name. Only alphanumeric characters and
- * underscores are allowed to prevent SQL injection via the config parameter.
- */
-function validateTextSearchConfig(config) {
-    return /^[a-zA-Z0-9_]+$/.test(config);
-}
-/**
- * pgvector distance metric → operator allow-list. This is the ONLY mapping
- * from a user-supplied metric token to a SQL operator; any token not present
- * here is rejected, so a user value can never become an arbitrary operator.
- *
- *  - `l2`     → `<->` (Euclidean / L2 distance)
- *  - `cosine` → `<=>` (cosine distance)
- *  - `ip`     → `<#>` (negative inner product)
- */
-const VECTOR_METRIC_OPERATORS = {
-    l2: '<->',
-    cosine: '<=>',
-    ip: '<#>',
-};
-/** Comparison keys allowed on a {@link VectorDistanceFilter}. */
-const VECTOR_DISTANCE_COMPARATORS = {
-    lt: '<',
-    lte: '<=',
-    gt: '>',
-    gte: '>=',
-};
-/** Check if a value is a vector distance WHERE filter: `{ distance: { to, metric } }` */
-function isVectorFilter(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value) || value instanceof Date) {
-        return false;
-    }
-    const dist = value.distance;
-    return (typeof dist === 'object' &&
-        dist !== null &&
-        !Array.isArray(dist) &&
-        'to' in dist &&
-        'metric' in dist);
-}
-/** Check if an orderBy value is a vector KNN ordering: `{ distance: { to, metric } }` */
-function isVectorOrderBy(value) {
-    return isVectorFilter(value);
-}
-/** Check if an orderBy value is an explicit `{ sort, nulls? }` spec. */
-function isOrderBySpec(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value) && 'sort' in value;
-}
-/**
- * Normalize an orderBy value into `{ direction, nulls }`. Accepts a plain
- * direction string or an {@link OrderBySpec}. Used by every ORDER BY compile
- * path (findMany, groupBy, relation inner subqueries).
- */
-function normalizeOrderBy(value) {
-    if (isOrderBySpec(value)) {
-        return { dir: value.sort.toLowerCase() === 'desc' ? 'DESC' : 'ASC', nulls: value.nulls };
-    }
-    return { dir: String(value).toLowerCase() === 'desc' ? 'DESC' : 'ASC' };
-}
 // biome-ignore lint/complexity/noBannedTypes: {} means "no relations known" — intentional for untyped table access
 class QueryInterface {
     pool;
@@ -788,7 +569,7 @@ class QueryInterface {
             !whereObj.NOT &&
             whereKeys.every((k) => {
                 const v = whereObj[k];
-                return v !== null && !isWhereOperator(v) && !this.tableMeta.relations[k];
+                return v !== null && !(0, filters_js_1.isWhereOperator)(v) && !this.tableMeta.relations[k];
             });
         // Simple path: plain equality, no operators/null/OR
         if (!args.with && isSimpleWhere) {
@@ -989,14 +770,14 @@ class QueryInterface {
             let sql = `SELECT ${distinctPrefix}${selectClause} FROM ${qt}${freshWhereSql}`;
             if (args?.cursor) {
                 // Sorted (canonical) order — MUST match cursorFp and the cache-hit collect below.
-                const cursorEntries = sortedEntries(args.cursor).filter(([, v]) => v !== undefined);
+                const cursorEntries = (0, filters_js_1.sortedEntries)(args.cursor).filter(([, v]) => v !== undefined);
                 if (cursorEntries.length > 0) {
                     const cursorConditions = cursorEntries.map(([k, v]) => {
                         const col = this.toSqlColumn(k);
                         // orderBy values can be the { sort, nulls } spec form — normalize
                         // before comparing, or a desc spec would seek the ascending side.
                         const dir = args.orderBy?.[k];
-                        const desc = isOrderBySpec(dir) ? dir.sort === 'desc' : dir === 'desc';
+                        const desc = (0, filters_js_1.isOrderBySpec)(dir) ? dir.sort === 'desc' : dir === 'desc';
                         const op = desc ? '<' : '>';
                         freshParams.push(v);
                         return `${qt}.${col} ${op} ${this.p(freshParams.length)}`;
@@ -1016,7 +797,7 @@ class QueryInterface {
                     // order") need two levels: inner DISTINCT ON ordered by the distinct
                     // columns then the user's order (picks the right representative row),
                     // outer re-ordered by the user's order alone.
-                    if (Object.values(args.orderBy).some((d) => isVectorOrderBy(d))) {
+                    if (Object.values(args.orderBy).some((d) => (0, filters_js_1.isVectorOrderBy)(d))) {
                         throw new errors_js_1.ValidationError('[turbine] `distinct` cannot be combined with vector distance ordering.');
                     }
                     const userOrder = this.buildOrderBy(args.orderBy, freshParams);
@@ -1054,7 +835,7 @@ class QueryInterface {
         }
         // 3. Cursor params — sorted (canonical) order, matching cursorFp and the build path.
         if (args?.cursor) {
-            const cursorEntries = sortedEntries(args.cursor).filter(([, v]) => v !== undefined);
+            const cursorEntries = (0, filters_js_1.sortedEntries)(args.cursor).filter(([, v]) => v !== undefined);
             for (const [, v] of cursorEntries) {
                 params.push(v);
             }
@@ -2315,7 +2096,7 @@ class QueryInterface {
             !Buffer.isBuffer(value)) {
             const v = value;
             const keys = Object.keys(v);
-            if (keys.length === 1 && UPDATE_OPERATOR_KEYS.has(keys[0])) {
+            if (keys.length === 1 && filters_js_1.UPDATE_OPERATOR_KEYS.has(keys[0])) {
                 const op = keys[0];
                 const opValue = v[op];
                 if (op === 'set') {
@@ -2432,15 +2213,15 @@ class QueryInterface {
                 continue;
             }
             // Operator objects
-            if (isWhereOperator(value)) {
-                parts.push(`${key}:${fingerprintOperatorShape(value)}`);
+            if ((0, filters_js_1.isWhereOperator)(value)) {
+                parts.push(`${key}:${(0, filters_js_1.fingerprintOperatorShape)(value)}`);
                 continue;
             }
             // Vector distance filter — metric (operator) and present comparators
             // change the SQL shape, so both go in the fingerprint.
-            if (typeof value === 'object' && !Array.isArray(value) && isVectorFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isVectorFilter)(value)) {
                 const dist = value.distance;
-                const cmps = Object.keys(VECTOR_DISTANCE_COMPARATORS)
+                const cmps = Object.keys(filters_js_1.VECTOR_DISTANCE_COMPARATORS)
                     .filter((c) => dist[c] !== undefined)
                     .sort()
                     .join('|');
@@ -2448,18 +2229,18 @@ class QueryInterface {
                 continue;
             }
             // JSON filter
-            if (typeof value === 'object' && !Array.isArray(value) && isJsonFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isJsonFilter)(value)) {
                 const jKeys = Object.keys(value).sort();
                 parts.push(`${key}:json(${jKeys.join(',')})`);
                 continue;
             }
             // Array filter
-            if (typeof value === 'object' && !Array.isArray(value) && isArrayFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isArrayFilter)(value)) {
                 parts.push(`${key}:arr(${this.fingerprintArrayFilter(value)})`);
                 continue;
             }
             // Text search filter
-            if (typeof value === 'object' && !Array.isArray(value) && isTextSearchFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isTextSearchFilter)(value)) {
                 const cfg = value.config ?? 'english';
                 parts.push(`${key}:fts(${cfg})`);
                 continue;
@@ -2468,7 +2249,7 @@ class QueryInterface {
             // fingerprint distinct from real equality. The build path throws for
             // these on non-JSON columns; sharing `key:eq` would let a cache entry
             // warmed by genuine equality serve the bad filter silently.
-            if (isUnmatchedPlainObject(value)) {
+            if ((0, filters_js_1.isUnmatchedPlainObject)(value)) {
                 parts.push(`${key}:obj(${Object.keys(value)
                     .sort()
                     .join(',')})`);
@@ -2533,10 +2314,10 @@ class QueryInterface {
             if (value === null) {
                 parts.push(`${key}:null`);
             }
-            else if (isWhereOperator(value)) {
-                parts.push(`${key}:${fingerprintOperatorShape(value)}`);
+            else if ((0, filters_js_1.isWhereOperator)(value)) {
+                parts.push(`${key}:${(0, filters_js_1.fingerprintOperatorShape)(value)}`);
             }
-            else if (isUnmatchedPlainObject(value)) {
+            else if ((0, filters_js_1.isUnmatchedPlainObject)(value)) {
                 parts.push(`${key}:obj(${Object.keys(value)
                     .sort()
                     .join(',')})`);
@@ -2556,7 +2337,7 @@ class QueryInterface {
      */
     collectWhereParams(where, params) {
         // Sorted (canonical) order — MUST match fingerprintWhere and buildWhereClause.
-        const keys = sortedKeys(where);
+        const keys = (0, filters_js_1.sortedKeys)(where);
         for (const key of keys) {
             const value = where[key];
             if (value === undefined)
@@ -2602,7 +2383,7 @@ class QueryInterface {
                 continue;
             const rawColumn = this.toColumn(key);
             // Vector distance filter — mirrors buildVectorFilterClauses push order.
-            if (typeof value === 'object' && !Array.isArray(value) && isVectorFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isVectorFilter)(value)) {
                 // Validate the same way the build path does so the collect path never
                 // diverges (it would throw before any param was pushed).
                 this.vectorOperator(key, rawColumn, value.distance.metric);
@@ -2610,7 +2391,7 @@ class QueryInterface {
                 continue;
             }
             // JSONB filter
-            if (typeof value === 'object' && !Array.isArray(value) && isJsonFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isJsonFilter)(value)) {
                 const colType = this.getColumnPgType(rawColumn);
                 if (colType === 'json' || colType === 'jsonb') {
                     this.collectJsonFilterParams(value, params);
@@ -2618,7 +2399,7 @@ class QueryInterface {
                 }
             }
             // Array filter
-            if (typeof value === 'object' && !Array.isArray(value) && isArrayFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isArrayFilter)(value)) {
                 const colType = this.getColumnPgType(rawColumn);
                 if (colType.startsWith('_')) {
                     this.collectArrayFilterParams(value, params);
@@ -2626,12 +2407,12 @@ class QueryInterface {
                 }
             }
             // Text search filter
-            if (typeof value === 'object' && !Array.isArray(value) && isTextSearchFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isTextSearchFilter)(value)) {
                 params.push(value.search);
                 continue;
             }
             // Operator objects
-            if (isWhereOperator(value)) {
+            if ((0, filters_js_1.isWhereOperator)(value)) {
                 this.collectOperatorParams(rawColumn, value, params);
                 continue;
             }
@@ -2685,7 +2466,7 @@ class QueryInterface {
         if (!meta)
             return;
         // Sorted (canonical) order — MUST match fingerprintRelFilter and buildSubWhereForRelation.
-        for (const field of sortedKeys(subWhere)) {
+        for (const field of (0, filters_js_1.sortedKeys)(subWhere)) {
             const value = subWhere[field];
             if (value === undefined)
                 continue;
@@ -2714,7 +2495,7 @@ class QueryInterface {
                 }
             }
             const col = meta.columnMap[field] ?? (0, schema_js_1.camelToSnake)(field);
-            if (isWhereOperator(value)) {
+            if ((0, filters_js_1.isWhereOperator)(value)) {
                 this.collectOperatorParams(col, value, params);
                 continue;
             }
@@ -2725,7 +2506,7 @@ class QueryInterface {
     /** Collect params from operator clauses. Mirrors buildOperatorClauses. */
     collectOperatorParams(column, op, params) {
         if (op.equals !== undefined && op.equals !== null) {
-            assertBindableEqualsOperand(op.equals, `"${column}"`);
+            (0, filters_js_1.assertBindableEqualsOperand)(op.equals, `"${column}"`);
             params.push(op.equals);
         }
         if (op.gt !== undefined)
@@ -2783,7 +2564,7 @@ class QueryInterface {
      */
     collectOrderByParams(orderBy, params) {
         for (const [key, dir] of Object.entries(orderBy)) {
-            if (isVectorOrderBy(dir)) {
+            if ((0, filters_js_1.isVectorOrderBy)(dir)) {
                 const rawColumn = this.toColumn(key);
                 // Re-run the same validation as buildOrderBy so the collect path can
                 // never push a param that the build path rejected (or vice versa).
@@ -2815,7 +2596,7 @@ class QueryInterface {
     collectVectorFilterParams(field, rawColumn, filter, params) {
         const dist = filter.distance;
         this.pushVectorParam(field, rawColumn, dist.to, params);
-        for (const cmp of Object.keys(VECTOR_DISTANCE_COMPARATORS)) {
+        for (const cmp of Object.keys(filters_js_1.VECTOR_DISTANCE_COMPARATORS)) {
             const threshold = dist[cmp];
             if (threshold !== undefined)
                 params.push(threshold);
@@ -2911,7 +2692,7 @@ class QueryInterface {
         const meta = this.schema.tables[table ?? this.table];
         if (!meta)
             return;
-        for (const [relName, relSpec] of sortedEntries(withClause)) {
+        for (const [relName, relSpec] of (0, filters_js_1.sortedEntries)(withClause)) {
             const relDef = meta.relations[relName];
             if (!relDef)
                 continue;
@@ -2948,7 +2729,7 @@ class QueryInterface {
                 params.push(Number(spec.limit));
             }
             if (spec.with) {
-                for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+                for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                     const nestedRelDef = targetMeta.relations[nestedRelName];
                     if (!nestedRelDef)
                         continue;
@@ -2962,7 +2743,7 @@ class QueryInterface {
         const willWrap = relDef.type === 'hasMany' && (spec.limit !== undefined || hasOrder);
         // Non-wrapped path: nested relations BEFORE where/limit
         if (!willWrap && spec.with) {
-            for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+            for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                 const nestedRelDef = targetMeta.relations[nestedRelName];
                 if (!nestedRelDef)
                     continue;
@@ -2985,7 +2766,7 @@ class QueryInterface {
         }
         // Wrapped path: nested relations AFTER where/limit (inside inner subquery)
         if (willWrap && spec.with) {
-            for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+            for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                 const nestedRelDef = targetMeta.relations[nestedRelName];
                 if (!nestedRelDef)
                     continue;
@@ -3007,7 +2788,7 @@ class QueryInterface {
                 !(v instanceof Date) &&
                 !(typeof Buffer !== 'undefined' && Buffer.isBuffer(v))) {
                 const keys = Object.keys(v);
-                if (keys.length === 1 && UPDATE_OPERATOR_KEYS.has(keys[0])) {
+                if (keys.length === 1 && filters_js_1.UPDATE_OPERATOR_KEYS.has(keys[0])) {
                     parts.push(`${k}:${keys[0]}`);
                     continue;
                 }
@@ -3029,7 +2810,7 @@ class QueryInterface {
                 !(typeof Buffer !== 'undefined' && Buffer.isBuffer(v))) {
                 const obj = v;
                 const keys = Object.keys(obj);
-                if (keys.length === 1 && UPDATE_OPERATOR_KEYS.has(keys[0])) {
+                if (keys.length === 1 && filters_js_1.UPDATE_OPERATOR_KEYS.has(keys[0])) {
                     params.push(obj[keys[0]]);
                     continue;
                 }
@@ -3202,7 +2983,7 @@ class QueryInterface {
      */
     buildWhereClause(where, params) {
         // Sorted (canonical) order — MUST match fingerprintWhere and collectWhereParams.
-        const keys = sortedKeys(where);
+        const keys = (0, filters_js_1.sortedKeys)(where);
         if (keys.length === 0)
             return null;
         const andClauses = [];
@@ -3270,13 +3051,13 @@ class QueryInterface {
                 continue;
             }
             // Handle vector distance filter (pgvector): `{ distance: { to, metric, lt } }`
-            if (typeof value === 'object' && !Array.isArray(value) && isVectorFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isVectorFilter)(value)) {
                 const vecClauses = this.buildVectorFilterClauses(key, rawColumn, value, params);
                 andClauses.push(...vecClauses);
                 continue;
             }
             // Handle JSONB filter operators (for json/jsonb columns)
-            if (typeof value === 'object' && !Array.isArray(value) && isJsonFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isJsonFilter)(value)) {
                 const colType = this.getColumnPgType(rawColumn);
                 if (colType === 'json' || colType === 'jsonb') {
                     const jsonClauses = this.buildJsonFilterClauses(column, value, params);
@@ -3288,14 +3069,14 @@ class QueryInterface {
                 // equality (the previous behaviour) wasted hours of debugging time. Only
                 // throw when the operator is unambiguously JSON-specific — `contains` is
                 // shared with WhereOperator's LIKE so it must continue to fall through.
-                const jsonKey = findJsonUniqueKey(value);
+                const jsonKey = (0, filters_js_1.findJsonUniqueKey)(value);
                 if (jsonKey) {
                     throw new errors_js_1.ValidationError(`[turbine] Column "${rawColumn}" on table "${this.table}" is not a JSON column ` +
                         `(actual type: ${colType}); cannot apply JSON operator '${jsonKey}'.`);
                 }
             }
             // Handle Array filter operators (for array columns)
-            if (typeof value === 'object' && !Array.isArray(value) && isArrayFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isArrayFilter)(value)) {
                 const colType = this.getColumnPgType(rawColumn);
                 if (colType.startsWith('_')) {
                     const arrayClauses = this.buildArrayFilterClauses(column, value, params, colType);
@@ -3305,20 +3086,20 @@ class QueryInterface {
                 // Strict validation: array operators (`has`, `hasEvery`, ...) on a
                 // non-array column always indicate a mistake. None of these keys
                 // overlap with other filter shapes so we can throw unconditionally.
-                const arrayKey = findArrayUniqueKey(value);
+                const arrayKey = (0, filters_js_1.findArrayUniqueKey)(value);
                 if (arrayKey) {
                     throw new errors_js_1.ValidationError(`[turbine] Column "${rawColumn}" on table "${this.table}" is not an array column ` +
                         `(actual type: ${colType}); cannot apply array operator '${arrayKey}'.`);
                 }
             }
             // Handle full-text search filter
-            if (typeof value === 'object' && !Array.isArray(value) && isTextSearchFilter(value)) {
+            if (typeof value === 'object' && !Array.isArray(value) && (0, filters_js_1.isTextSearchFilter)(value)) {
                 const tsClause = this.buildTextSearchClause(column, value, params);
                 andClauses.push(tsClause);
                 continue;
             }
             // Handle operator objects
-            if (isWhereOperator(value)) {
+            if ((0, filters_js_1.isWhereOperator)(value)) {
                 const opClauses = this.buildOperatorClauses(column, value, params);
                 andClauses.push(...opClauses);
                 continue;
@@ -3436,7 +3217,7 @@ class QueryInterface {
         const qt = this.q(targetTable);
         const conditions = [];
         // Sorted (canonical) order — MUST match fingerprintRelFilter and collectRelFilterParams.
-        for (const field of sortedKeys(subWhere)) {
+        for (const field of (0, filters_js_1.sortedKeys)(subWhere)) {
             const value = subWhere[field];
             if (value === undefined)
                 continue;
@@ -3483,7 +3264,7 @@ class QueryInterface {
                 conditions.push(`${qCol} IS NULL`);
                 continue;
             }
-            if (isWhereOperator(value)) {
+            if ((0, filters_js_1.isWhereOperator)(value)) {
                 const opClauses = this.buildOperatorClauses(qCol, value, params);
                 conditions.push(...opClauses);
                 continue;
@@ -3511,7 +3292,7 @@ class QueryInterface {
      * columns (object equality).
      */
     assertBindableEqualityValue(rawColumn, value, columnPgType, table) {
-        if (!isUnmatchedPlainObject(value))
+        if (!(0, filters_js_1.isUnmatchedPlainObject)(value))
             return;
         if (columnPgType === 'json' || columnPgType === 'jsonb')
             return;
@@ -3536,7 +3317,7 @@ class QueryInterface {
     buildAliasWhere(targetTable, targetMeta, alias, where, params) {
         const clauses = [];
         // Sorted (canonical) order — MUST match fingerprintAliasWhere and collectAliasWhereParams.
-        for (const key of sortedKeys(where)) {
+        for (const key of (0, filters_js_1.sortedKeys)(where)) {
             const value = where[key];
             if (value === undefined)
                 continue;
@@ -3579,7 +3360,7 @@ class QueryInterface {
                 clauses.push(`${qCol} IS NULL`);
                 continue;
             }
-            if (isWhereOperator(value)) {
+            if ((0, filters_js_1.isWhereOperator)(value)) {
                 clauses.push(...this.buildOperatorClauses(qCol, value, params));
                 continue;
             }
@@ -3592,7 +3373,7 @@ class QueryInterface {
     /** Mirrors {@link buildAliasWhere} param-push order for the cache-hit collect path. */
     collectAliasWhereParams(targetTable, targetMeta, where, params) {
         // Sorted (canonical) order — MUST match fingerprintAliasWhere and buildAliasWhere.
-        for (const key of sortedKeys(where)) {
+        for (const key of (0, filters_js_1.sortedKeys)(where)) {
             const value = where[key];
             if (value === undefined)
                 continue;
@@ -3622,7 +3403,7 @@ class QueryInterface {
                 }
             }
             const col = targetMeta.columnMap[key] ?? (0, schema_js_1.camelToSnake)(key);
-            if (isWhereOperator(value)) {
+            if ((0, filters_js_1.isWhereOperator)(value)) {
                 this.collectOperatorParams(col, value, params);
                 continue;
             }
@@ -3676,11 +3457,11 @@ class QueryInterface {
                     continue;
                 }
             }
-            if (isWhereOperator(value)) {
-                parts.push(`${key}:${fingerprintOperatorShape(value)}`);
+            if ((0, filters_js_1.isWhereOperator)(value)) {
+                parts.push(`${key}:${(0, filters_js_1.fingerprintOperatorShape)(value)}`);
                 continue;
             }
-            if (isUnmatchedPlainObject(value)) {
+            if ((0, filters_js_1.isUnmatchedPlainObject)(value)) {
                 parts.push(`${key}:obj(${Object.keys(value)
                     .sort()
                     .join(',')})`);
@@ -3701,7 +3482,7 @@ class QueryInterface {
                 clauses.push(`${column} IS NULL`);
             }
             else {
-                assertBindableEqualsOperand(op.equals, column);
+                (0, filters_js_1.assertBindableEqualsOperand)(op.equals, column);
                 params.push(op.equals);
                 clauses.push(`${column} = ${this.p(params.length)}`);
             }
@@ -3773,10 +3554,10 @@ class QueryInterface {
     orderByEntryFingerprint(d) {
         // Vector KNN ordering changes the emitted operator by metric and adds a
         // `::vector` param, so metric + direction must be part of the cache key.
-        if (isVectorOrderBy(d)) {
+        if ((0, filters_js_1.isVectorOrderBy)(d)) {
             return `vec(${d.distance.metric},${d.distance.direction ?? 'asc'})`;
         }
-        if (isOrderBySpec(d))
+        if ((0, filters_js_1.isOrderBySpec)(d))
             return `spec(${d.sort},${d.nulls ?? ''})`;
         if (d && typeof d === 'object') {
             // Relation ordering (`{ _count: 'desc' }` or `{ name: 'asc' }`).
@@ -3807,7 +3588,7 @@ class QueryInterface {
         return Object.entries(orderBy)
             .map(([key, value]) => {
             // Vector KNN ordering: { distance: { to, metric, direction? } }
-            if (isVectorOrderBy(value)) {
+            if ((0, filters_js_1.isVectorOrderBy)(value)) {
                 if (meta && !(key in meta.columnMap)) {
                     throw new errors_js_1.ValidationError(`[turbine] Unknown field "${key}" in orderBy on table "${this.table}". ` +
                         `Known fields: ${Object.keys(meta.columnMap).join(', ') || '(none)'}.`);
@@ -3832,7 +3613,7 @@ class QueryInterface {
                 throw new errors_js_1.ValidationError(`[turbine] Unknown field "${key}" in orderBy on table "${this.table}". ` +
                     `Known fields: ${Object.keys(meta.columnMap).join(', ') || '(none)'}.`);
             }
-            const { dir, nulls } = normalizeOrderBy(value);
+            const { dir, nulls } = (0, filters_js_1.normalizeOrderBy)(value);
             return `${this.toSqlColumn(key)} ${dir}${this.nullsSuffix(nulls)}`;
         })
             .join(', ');
@@ -3846,8 +3627,8 @@ class QueryInterface {
         return (typeof value === 'object' &&
             value !== null &&
             !Array.isArray(value) &&
-            !isVectorOrderBy(value) &&
-            !isOrderBySpec(value));
+            !(0, filters_js_1.isVectorOrderBy)(value) &&
+            !(0, filters_js_1.isOrderBySpec)(value));
     }
     /**
      * Render the ` NULLS FIRST` / ` NULLS LAST` suffix for a column ordering.
@@ -3885,7 +3666,7 @@ class QueryInterface {
                 throw new errors_js_1.ValidationError(`[turbine] orderBy on to-many relation "${relName}" only supports "_count" ` +
                     `(got: ${keys.join(', ') || '(empty)'}).`);
             }
-            const { dir } = normalizeOrderBy(value._count);
+            const { dir } = (0, filters_js_1.normalizeOrderBy)(value._count);
             return `${this.buildRelationCountExpr(relDef, this.table, alias, params)} ${dir}`;
         }
         // To-one: each entry orders by a correlated scalar subquery on a target column.
@@ -3908,7 +3689,7 @@ class QueryInterface {
             if (!targetMeta.allColumns.includes(snakeCol)) {
                 throw new errors_js_1.ValidationError(`[turbine] Unknown column "${col}" in orderBy on relation "${relName}" (table "${relDef.to}").`);
             }
-            const { dir, nulls } = normalizeOrderBy(dirValue);
+            const { dir, nulls } = (0, filters_js_1.normalizeOrderBy)(dirValue);
             // Target's global filter applies here too — otherwise ordering keys off
             // a soft-deleted / other-tenant related row's value (matches the with
             // subquery semantics for belongsTo/hasOne).
@@ -4032,10 +3813,10 @@ class QueryInterface {
             throw new errors_js_1.ValidationError(`[turbine] Column "${field}" on table "${this.table}" is not a vector column ` +
                 `(actual type: ${colType}); cannot apply a vector distance operation.`);
         }
-        const op = VECTOR_METRIC_OPERATORS[metric];
+        const op = filters_js_1.VECTOR_METRIC_OPERATORS[metric];
         if (!op) {
             throw new errors_js_1.ValidationError(`[turbine] Unknown vector metric "${metric}" for column "${field}". ` +
-                `Valid metrics: ${Object.keys(VECTOR_METRIC_OPERATORS).join(', ')}.`);
+                `Valid metrics: ${Object.keys(filters_js_1.VECTOR_METRIC_OPERATORS).join(', ')}.`);
         }
         return op;
     }
@@ -4264,7 +4045,7 @@ class QueryInterface {
         if (!meta)
             return {};
         const shapes = {};
-        for (const [relName, relSpec] of sortedEntries(withClause)) {
+        for (const [relName, relSpec] of (0, filters_js_1.sortedEntries)(withClause)) {
             const relDef = meta.relations[relName];
             if (!relDef)
                 continue; // buildSelectWithRelations already threw for this
@@ -4287,7 +4068,7 @@ class QueryInterface {
         const keys = targetColumns.map((col) => targetMeta.reverseColumnMap[col] ?? (0, schema_js_1.snakeToCamel)(col));
         const nested = {};
         if (spec !== true && spec.with) {
-            for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+            for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                 const nestedRelDef = targetMeta.relations[nestedRelName];
                 if (!nestedRelDef)
                     continue;
@@ -4420,7 +4201,7 @@ class QueryInterface {
         const baseCols = cols.map((col) => `${qtbl}.${this.q(col)}`).join(', ');
         const relationSelects = [];
         const aliasCounter = { n: 0 };
-        for (const [relName, relSpec] of sortedEntries(withClause)) {
+        for (const [relName, relSpec] of (0, filters_js_1.sortedEntries)(withClause)) {
             // `_count` is a reserved key handled after the relation subqueries.
             if (relName === '_count')
                 continue;
@@ -4624,7 +4405,7 @@ class QueryInterface {
         }
         // Nested relations — only in the non-wrapped path (wrapped path builds them separately)
         if (!willWrap && spec !== true && spec.with) {
-            for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+            for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                 const nestedRelDef = targetMeta.relations[nestedRelName];
                 if (!nestedRelDef) {
                     throw new errors_js_1.RelationError(`[turbine] Unknown relation "${nestedRelName}" on table "${targetTable}". ` +
@@ -4650,7 +4431,7 @@ class QueryInterface {
                 if (!targetMeta.allColumns.includes(col)) {
                     throw new errors_js_1.ValidationError(`[turbine] Unknown column "${k}" in orderBy for table "${targetTable}"`);
                 }
-                const { dir, nulls } = normalizeOrderBy(dirValue);
+                const { dir, nulls } = (0, filters_js_1.normalizeOrderBy)(dirValue);
                 return `${alias}.${this.q(col)} ${dir}${this.nullsSuffix(nulls)}`;
             })
                 .join(', ');
@@ -4708,7 +4489,7 @@ class QueryInterface {
                 ]);
                 // Build nested relation subqueries referencing innerAlias
                 if (spec !== true && spec.with) {
-                    for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+                    for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                         const nestedRelDef = targetMeta.relations[nestedRelName];
                         if (!nestedRelDef) {
                             throw new errors_js_1.RelationError(`[turbine] Unknown relation "${nestedRelName}" on table "${targetTable}". ` +
@@ -4798,7 +4579,7 @@ class QueryInterface {
                 if (!targetMeta.allColumns.includes(col)) {
                     throw new errors_js_1.ValidationError(`[turbine] Unknown column "${k}" in orderBy for table "${targetTable}"`);
                 }
-                const { dir, nulls } = normalizeOrderBy(dirValue);
+                const { dir, nulls } = (0, filters_js_1.normalizeOrderBy)(dirValue);
                 return `${talias}.${this.q(col)} ${dir}${this.nullsSuffix(nulls)}`;
             })
                 .join(', ');
@@ -4834,7 +4615,7 @@ class QueryInterface {
             ]);
             // Nested relations reference the inner alias.
             if (spec !== true && spec.with) {
-                for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+                for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                     const nestedRelDef = targetMeta.relations[nestedRelName];
                     if (!nestedRelDef) {
                         throw new errors_js_1.RelationError(`[turbine] Unknown relation "${nestedRelName}" on table "${targetTable}". ` +
@@ -4857,7 +4638,7 @@ class QueryInterface {
             `${talias}.${this.q(col)}`,
         ]);
         if (spec !== true && spec.with) {
-            for (const [nestedRelName, nestedSpec] of sortedEntries(spec.with)) {
+            for (const [nestedRelName, nestedSpec] of (0, filters_js_1.sortedEntries)(spec.with)) {
                 const nestedRelDef = targetMeta.relations[nestedRelName];
                 if (!nestedRelDef) {
                     throw new errors_js_1.RelationError(`[turbine] Unknown relation "${nestedRelName}" on table "${targetTable}". ` +
@@ -4983,7 +4764,7 @@ class QueryInterface {
         const placeholder = this.pushVectorParam(field, rawColumn, dist.to, params);
         const distanceExpr = `${this.q(rawColumn)} ${operator} ${placeholder}`;
         const clauses = [];
-        for (const [cmp, sqlOp] of Object.entries(VECTOR_DISTANCE_COMPARATORS)) {
+        for (const [cmp, sqlOp] of Object.entries(filters_js_1.VECTOR_DISTANCE_COMPARATORS)) {
             const threshold = dist[cmp];
             if (threshold === undefined)
                 continue;
@@ -5005,7 +4786,7 @@ class QueryInterface {
      */
     buildTextSearchClause(column, filter, params) {
         const config = filter.config ?? 'english';
-        if (!validateTextSearchConfig(config)) {
+        if (!(0, filters_js_1.validateTextSearchConfig)(config)) {
             throw new errors_js_1.ValidationError(`[turbine] Invalid text search config "${config}": only alphanumeric characters and underscores are allowed.`);
         }
         params.push(filter.search);