joist-core 2.2.0-next.5 → 2.2.0-next.50

package/build/QueryParser.d.ts

@@ -1,5 +1,5 @@
 import { ExpressionFilter, OrderBy, ValueFilter } from "./EntityFilter";
-import { type EntityMetadata } from "./EntityMetadata";
+import { type EntityMetadata, type Field } from "./EntityMetadata";
 import { Column } from "./index";
 /** A tree of ANDs/ORs with conditions or nested conditions. */
 export interface ParsedExpressionFilter {
@@ -229,6 +229,10 @@ export type ParsedEntityFilter = ParsedValueFilter<string | number> | {
 };
 /** Parses an entity filter, which could be "just an id", an array of ids, or a nested filter. */
 export declare function parseEntityFilter(meta: EntityMetadata, filter: any): ParsedEntityFilter | undefined;
+/** Finds a filter field by fieldName or generated fieldIdName. */
+export declare function findFilterField(meta: EntityMetadata, key: string): (Field & {
+    aliasSuffix: string;
+}) | undefined;
 /**
  * An ADT version of `ValueFilter`.
  *
@@ -324,6 +328,7 @@ export declare function mapToDb(column: Column, filter: ParsedValueFilter<any>):
 export declare function maybeAddOrderBy(query: ParsedFindQuery, meta: EntityMetadata, alias: string): void;
 export declare function addTablePerClassJoinsAndClassTag(query: ParsedFindQuery, meta: EntityMetadata, alias: string, isPrimary: boolean): void;
 export declare function maybeAddNotSoftDeleted(conditions: ColumnCondition[], meta: EntityMetadata, alias: string, softDeletes: "include" | "exclude"): void;
+export declare function filterSoftDeletes(meta: EntityMetadata, softDeletes: "include" | "exclude"): boolean;
 export declare function getTables(query: ParsedFindQuery): [PrimaryTable, JoinTable[], LateralJoinTable[], CrossJoinTable[]];
 /** Converts a search term like `foo bar` into a SQL `like` pattern like `%foo%bar%`. */
 export declare function makeLike(search: any | undefined): any;

package/build/QueryParser.d.ts.map

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

package/build/QueryParser.js

@@ -5,11 +5,13 @@ exports.parseFindQuery = parseFindQuery;
 exports.maybeAddIdNotNulls = maybeAddIdNotNulls;
 exports.parseAlias = parseAlias;
 exports.parseEntityFilter = parseEntityFilter;
+exports.findFilterField = findFilterField;
 exports.parseValueFilter = parseValueFilter;
 exports.mapToDb = mapToDb;
 exports.maybeAddOrderBy = maybeAddOrderBy;
 exports.addTablePerClassJoinsAndClassTag = addTablePerClassJoinsAndClassTag;
 exports.maybeAddNotSoftDeleted = maybeAddNotSoftDeleted;
+exports.filterSoftDeletes = filterSoftDeletes;
 exports.getTables = getTables;
 exports.makeLike = makeLike;
 const joist_utils_1 = require("joist-utils");
@@ -21,6 +23,7 @@ const QueryVisitor_1 = require("./QueryVisitor");
 const configure_1 = require("./configure");
 const index_1 = require("./index");
 const keywords_1 = require("./keywords");
+const scopes_1 = require("./scopes");
 const utils_1 = require("./utils");
 /** A marker condition for alias methods to indicate they should be skipped/pruned. */
 exports.skipCondition = {
@@ -50,10 +53,10 @@ function parseFindQuery(meta, filter, opts = {}) {
         aliases[abbrev] = i + 1;
         return i === 0 ? abbrev : `${abbrev}${i}`;
     }
-    function addSoftDeleteCondition(meta, alias) {
+    function addSoftDeleteCondition(meta, alias, targetCb) {
         if (filterSoftDeletes(meta, softDeletes)) {
             const column = meta.allFields[(0, EntityMetadata_1.getBaseMeta)(meta).timestampFields.deletedAt].serde?.columns[0];
-            cb.addSimpleCondition({
+            targetCb.addSimpleCondition({
                 kind: "column",
                 alias,
                 column: column.columnName,
@@ -63,10 +66,11 @@ function parseFindQuery(meta, filter, opts = {}) {
             });
         }
     }
-    function addTable(meta, alias, join, col1, col2, filter, fieldName) {
+    function addTable(meta, alias, join, col1, col2, filter, fieldName, targetCb = cb) {
         // look at filter, is it `{ book: "b2" }` or `{ book: { ... } }`
-        const ef = parseEntityFilter(meta, filter);
-        if (!ef && join !== "primary" && !(0, Aliases_1.isAlias)(filter)) {
+        const scopeFilter = (0, scopes_1.isScope)(filter);
+        const ef = scopeFilter ? undefined : parseEntityFilter(meta, filter);
+        if (!scopeFilter && !ef && join !== "primary" && !(0, Aliases_1.isAlias)(filter)) {
             return;
         }
         if (join === "primary") {
@@ -106,9 +110,9 @@ function parseFindQuery(meta, filter, opts = {}) {
             addTablePerClassJoinsAndClassTag({ selects, tables, orderBys }, meta, alias, false);
         }
         if (needsStiDiscriminator(meta)) {
-            addStiSubtypeFilter(cb, meta, alias);
+            addStiSubtypeFilter(targetCb, meta, alias);
         }
-        addSoftDeleteCondition(meta, alias);
+        addSoftDeleteCondition(meta, alias, targetCb);
         // The user's locally declared aliases, i.e. `const [a, b] = aliases(Author, Book)`,
         // aren't guaranteed to line up with the aliases we've assigned internally, like `a`
         // might actually be `a1` if there are two `authors` tables in the query, so push the
@@ -119,202 +123,253 @@ function parseFindQuery(meta, filter, opts = {}) {
         else if ((0, Aliases_1.isAlias)(filter)) {
             (0, Aliases_1.getAliasMgmt)(filter).setAlias(meta, alias);
         }
-        if (ef && ef.kind === "join") {
-            // subFilter really means we're matching against the entity columns/further joins
-            Object.keys(ef.subFilter).forEach((key) => {
-                // Skip the `{ as: ... }` alias binding
-                if (key === "as")
-                    return;
-                const field = meta.allFields[key] ??
-                    meta.polyComponentFields?.[key] ??
-                    (0, utils_1.fail)(`Field '${key}' not found on ${meta.tableName}`);
-                const fa = `${alias}${field.aliasSuffix}`;
-                if (field.kind === "primitive" || field.kind === "primaryKey" || field.kind === "enum") {
-                    const column = field.serde.columns[0];
-                    parseValueFilter(ef.subFilter[key]).forEach((filter) => {
-                        cb.addValueFilter(fa, column, filter);
-                    });
+        addFilterAt(meta, alias, filter, targetCb, ef, join);
+    }
+    function addFilterAt(meta, tableAlias, filter, targetCb, parsed = parseEntityFilter(meta, filter), parentJoin = "primary") {
+        if ((0, scopes_1.isScope)(filter)) {
+            addScopeFilterAt(meta, tableAlias, filter, targetCb, parentJoin);
+        }
+        else if (parsed && parsed.kind === "join") {
+            addSubFilter(meta, tableAlias, parsed.subFilter, targetCb, parentJoin);
+        }
+        else if (parsed) {
+            const column = meta.fields["id"].serde.columns[0];
+            targetCb.addValueFilter(tableAlias, column, parsed);
+        }
+    }
+    function addScopeFilterAt(meta, tableAlias, scope, targetCb, parentJoin) {
+        for (const fragment of (0, scopes_1.resolveScope)(scope).fragments) {
+            if (fragment.kind === "filter") {
+                addFilterAt(meta, tableAlias, fragment.filter, targetCb, undefined, parentJoin);
+            }
+            else {
+                const a = (0, Aliases_1.alias)(meta.cstr);
+                const result = fragment.fn(a);
+                (0, Aliases_1.getAliasMgmt)(a).setAlias(meta, tableAlias);
+                if ((0, scopes_1.isScopeJoinFilter)(result)) {
+                    // Parse the join tree first so its `as:` bindings re-root the aliases that
+                    // `conditions` reference, then add the conditions against the now-bound aliases.
+                    addFilterAt(meta, tableAlias, result.where, targetCb, undefined, parentJoin);
+                    targetCb.maybeAddExpression(result.conditions);
                 }
-                else if (field.kind === "m2o") {
-                    const column = field.serde.columns[0];
-                    const sub = ef.subFilter[key];
-                    const joinKind = field.required && join !== "outer" ? "inner" : "outer";
-                    if ((0, Aliases_1.isAlias)(sub)) {
-                        const a = getAlias(field.otherMetadata().tableName);
-                        addTable(field.otherMetadata(), a, joinKind, (0, keywords_1.kqDot)(fa, column.columnName), (0, keywords_1.kqDot)(a, "id"), sub);
-                    }
-                    const f = parseEntityFilter(field.otherMetadata(), sub);
-                    // Probe the filter and see if it's just an id (...and not soft deleted), if so we can avoid the join
-                    if (!f) {
-                        // skip
-                    }
-                    else if (f.kind === "join" || filterSoftDeletes(field.otherMetadata(), softDeletes)) {
-                        const a = getAlias(field.otherMetadata().tableName);
-                        addTable(field.otherMetadata(), a, joinKind, (0, keywords_1.kqDot)(fa, column.columnName), (0, keywords_1.kqDot)(a, "id"), sub);
-                    }
-                    else {
-                        cb.addValueFilter(fa, column, f);
-                    }
+                else {
+                    const conditions = Array.isArray(result) ? result : [result];
+                    if (conditions.length > 0)
+                        targetCb.maybeAddExpression({ and: conditions });
                 }
-                else if (field.kind === "poly") {
-                    const f = parseEntityFilter(meta, ef.subFilter[key]);
-                    if (!f) {
-                        // skip
-                    }
-                    else if (f.kind === "join") {
-                        throw new Error("Joins through polys are not supported");
+            }
+        }
+    }
+    function addSubFilter(meta, tableAlias, subFilter, targetCb, parentJoin) {
+        // subFilter really means we're matching against the entity columns/further joins
+        Object.keys(subFilter).forEach((key) => {
+            // Skip the `{ as: ... }` alias binding
+            if (key === "as")
+                return;
+            if (key === "and" || key === "or") {
+                addLogicalFilter(meta, tableAlias, key, subFilter[key], targetCb, parentJoin);
+                return;
+            }
+            const field = findFilterField(meta, key) ?? (0, utils_1.fail)(`Field '${key}' not found on ${meta.tableName}`);
+            const fa = `${tableAlias}${field.aliasSuffix}`;
+            if (field.kind === "primitive" || field.kind === "primaryKey" || field.kind === "enum") {
+                const column = field.serde.columns[0];
+                parseValueFilter(subFilter[key]).forEach((filter) => {
+                    targetCb.addValueFilter(fa, column, filter);
+                });
+            }
+            else if (field.kind === "m2o") {
+                const column = field.serde.columns[0];
+                const sub = subFilter[key];
+                const joinKind = field.required && parentJoin !== "outer" ? "inner" : "outer";
+                if ((0, Aliases_1.isAlias)(sub)) {
+                    const a = getAlias(field.otherMetadata().tableName);
+                    addTable(field.otherMetadata(), a, joinKind, (0, keywords_1.kqDot)(fa, column.columnName), (0, keywords_1.kqDot)(a, "id"), sub, undefined, targetCb);
+                }
+                const f = parseEntityFilter(field.otherMetadata(), sub);
+                // Probe the filter and see if it's just an id (...and not soft deleted), if so we can avoid the join
+                if (!f) {
+                    // skip
+                }
+                else if (f.kind === "join" || filterSoftDeletes(field.otherMetadata(), softDeletes)) {
+                    const a = getAlias(field.otherMetadata().tableName);
+                    addTable(field.otherMetadata(), a, joinKind, (0, keywords_1.kqDot)(fa, column.columnName), (0, keywords_1.kqDot)(a, "id"), sub, undefined, targetCb);
+                }
+                else {
+                    targetCb.addValueFilter(fa, column, f);
+                }
+            }
+            else if (field.kind === "poly") {
+                const f = parseEntityFilter(meta, subFilter[key]);
+                if (!f) {
+                    // skip
+                }
+                else if (f.kind === "join") {
+                    throw new Error("Joins through polys are not supported");
+                }
+                else {
+                    // We're left with basically a ValueFilter against the ids
+                    // For now only support eq/ne/in/is-null
+                    if (f.kind === "eq" || f.kind === "ne") {
+                        if (isNilIdValue(f.value))
+                            return;
+                        const comp = field.components.find((p) => {
+                            const otherMeta = p.otherMetadata();
+                            const cstr = (0, index_1.getConstructorFromTaggedId)(f.value);
+                            // tagged ids from subclasses always map to the base class, so we should compare to the base class if we don't directly match
+                            return otherMeta.cstr === cstr || otherMeta.baseType === cstr.name;
+                        });
+                        if (!comp)
+                            (0, utils_1.fail)(`Invalid tagged id passed to ${meta.type}.${key}: ${f.value}`);
+                        const column = field.serde.columns.find((c) => c.columnName === comp.columnName);
+                        targetCb.addValueFilter(fa, column, f);
                     }
-                    else {
-                        // We're left with basically a ValueFilter against the ids
-                        // For now only support eq/ne/in/is-null
-                        if (f.kind === "eq" || f.kind === "ne") {
-                            if (isNilIdValue(f.value))
-                                return;
-                            const comp = field.components.find((p) => {
-                                const otherMeta = p.otherMetadata();
-                                const cstr = (0, index_1.getConstructorFromTaggedId)(f.value);
-                                // tagged ids from subclasses always map to the base class, so we should compare to the base class if we don't directly match
-                                return otherMeta.cstr === cstr || otherMeta.baseType === cstr.name;
-                            });
-                            if (!comp)
-                                (0, utils_1.fail)(`Invalid tagged id passed to ${meta.type}.${key}: ${f.value}`);
+                    else if (f.kind === "is-null") {
+                        // Add a condition for every component--these can be AND-d with the rest of the simple/inline conditions
+                        field.components.forEach((comp) => {
                             const column = field.serde.columns.find((c) => c.columnName === comp.columnName);
-                            cb.addValueFilter(fa, column, f);
-                        }
-                        else if (f.kind === "is-null") {
-                            // Add a condition for every component--these can be AND-d with the rest of the simple/inline conditions
-                            field.components.forEach((comp) => {
-                                const column = field.serde.columns.find((c) => c.columnName === comp.columnName);
-                                cb.addSimpleCondition({
-                                    kind: "column",
-                                    alias: fa,
-                                    column: comp.columnName,
-                                    dbType: column.dbType,
-                                    cond: f,
-                                });
+                            targetCb.addSimpleCondition({
+                                kind: "column",
+                                alias: fa,
+                                column: comp.columnName,
+                                dbType: column.dbType,
+                                cond: f,
                             });
+                        });
+                    }
+                    else if (f.kind === "not-null") {
+                        const conditions = field.components.map((comp) => {
+                            const column = field.serde.columns.find((c) => c.columnName === comp.columnName);
+                            return {
+                                kind: "column",
+                                alias: fa,
+                                column: comp.columnName,
+                                dbType: column.dbType,
+                                cond: { kind: "not-null" },
+                            };
+                        });
+                        targetCb.addParsedExpression({ kind: "exp", op: "or", conditions });
+                    }
+                    else if (f.kind === "in") {
+                        // An empty `in` matches nothing, so emit a single always-false condition (consistent
+                        // with a non-poly m2o `{ relation: [] }`); otherwise grouping by constructor would yield
+                        // zero conditions and prune the filter entirely, incorrectly matching every row.
+                        if (f.value.length === 0) {
+                            targetCb.addValueFilter(fa, field.serde.columns[0], { kind: "in", value: [] });
+                            return;
                         }
-                        else if (f.kind === "not-null") {
-                            const conditions = field.components.map((comp) => {
-                                const column = field.serde.columns.find((c) => c.columnName === comp.columnName);
-                                return {
-                                    kind: "column",
-                                    alias: fa,
-                                    column: comp.columnName,
-                                    dbType: column.dbType,
-                                    cond: { kind: "not-null" },
-                                };
-                            });
-                            cb.addParsedExpression({ kind: "exp", op: "or", conditions });
-                        }
-                        else if (f.kind === "in") {
-                            // Split up the ids by constructor
-                            const idsByConstructor = (0, joist_utils_1.groupBy)(f.value, (id) => (0, index_1.getConstructorFromTaggedId)(id).name);
-                            // Or together `parent_book_id in (1,2,3) OR parent_author_id IN (4,5,6)`
-                            // ...if there is a `parent IN [b:1, b:2, a:1, null]` we'd need to pull the `null` out and do an `OR (all columns are null)`...
-                            const conditions = Object.entries(idsByConstructor).map(([cstrName, ids]) => {
-                                const column = field.serde.columns.find(
-                                // tagged ids from subclasses always map to the base class, so we should compare to the base class if we don't directly match
-                                (c) => c.otherMetadata().cstr.name === cstrName || c.otherMetadata().baseType === cstrName) ?? (0, utils_1.fail)(`Invalid tagged ids passed to ${meta.type}.${key}: ${ids}`);
-                                return {
-                                    kind: "column",
-                                    alias: fa,
-                                    column: column.columnName,
-                                    dbType: column.dbType,
-                                    cond: mapToDb(column, { kind: "in", value: ids }),
-                                };
-                            });
-                            if (conditions.length > 0) {
-                                cb.addParsedExpression({ kind: "exp", op: "or", conditions });
-                            }
-                        }
-                        else {
-                            throw new Error(`Filters on polys for ${f.kind} are not supported`);
-                        }
+                        // Split up the ids by constructor
+                        const idsByConstructor = (0, joist_utils_1.groupBy)(f.value, (id) => (0, index_1.getConstructorFromTaggedId)(id).name);
+                        // Or together `parent_book_id in (1,2,3) OR parent_author_id IN (4,5,6)`
+                        // ...if there is a `parent IN [b:1, b:2, a:1, null]` we'd need to pull the `null` out and do an `OR (all columns are null)`...
+                        const conditions = Object.entries(idsByConstructor).map(([cstrName, ids]) => {
+                            const column = field.serde.columns.find(
+                            // tagged ids from subclasses always map to the base class, so we should compare to the base class if we don't directly match
+                            (c) => c.otherMetadata().cstr.name === cstrName || c.otherMetadata().baseType === cstrName) ?? (0, utils_1.fail)(`Invalid tagged ids passed to ${meta.type}.${key}: ${ids}`);
+                            return {
+                                kind: "column",
+                                alias: fa,
+                                column: column.columnName,
+                                dbType: column.dbType,
+                                cond: mapToDb(column, { kind: "in", value: ids }),
+                            };
+                        });
+                        targetCb.addParsedExpression({ kind: "exp", op: "or", conditions });
+                    }
+                    else {
+                        throw new Error(`Filters on polys for ${f.kind} are not supported`);
                     }
                 }
-                else if (field.kind === "o2o") {
-                    // We have to always join into o2os, i.e. we can't probe the filter like we do for m2os
-                    const otherMeta = field.otherMetadata();
-                    const a = getAlias(otherMeta.tableName);
-                    const otherField = otherMeta.allFields[field.otherFieldName];
-                    const otherColumn = 
-                    // if our other is a poly, we need to find a matching column rather than just picking the first
-                    otherField.kind === "poly"
-                        ? otherField.components.find((c) => c.otherMetadata() === meta || c.otherMetadata() === (0, EntityMetadata_1.getBaseMeta)(meta)).columnName
-                        : otherField.serde.columns[0].columnName;
-                    addTable(field.otherMetadata(), a, "outer", (0, keywords_1.kqDot)(alias, "id"), (0, keywords_1.kqDot)(a, otherColumn), ef.subFilter[key], field.otherFieldName);
+            }
+            else if (field.kind === "o2o") {
+                // We have to always join into o2os, i.e. we can't probe the filter like we do for m2os
+                const otherMeta = field.otherMetadata();
+                const a = getAlias(otherMeta.tableName);
+                const otherField = otherMeta.allFields[field.otherFieldName];
+                const otherColumn = 
+                // if our other is a poly, we need to find a matching column rather than just picking the first
+                otherField.kind === "poly"
+                    ? otherField.components.find((c) => c.otherMetadata() === meta || c.otherMetadata() === (0, EntityMetadata_1.getBaseMeta)(meta))
+                        .columnName
+                    : otherField.serde.columns[0].columnName;
+                addTable(field.otherMetadata(), a, "outer", (0, keywords_1.kqDot)(tableAlias, "id"), (0, keywords_1.kqDot)(a, otherColumn), subFilter[key], field.otherFieldName, targetCb);
+            }
+            else if (field.kind === "o2m") {
+                const otherMeta = field.otherMetadata();
+                const otherField = otherMeta.allFields[field.otherFieldName];
+                let otherColumn = otherField.serde.columns[0].columnName;
+                if (otherField.kind === "poly") {
+                    const otherComponent = otherField.components.find((c) => c.otherMetadata() === meta) ??
+                        (0, utils_1.fail)(`No poly component found for ${otherField.fieldName}`);
+                    otherColumn = otherComponent.columnName;
                 }
-                else if (field.kind === "o2m") {
-                    const otherMeta = field.otherMetadata();
-                    const otherField = otherMeta.allFields[field.otherFieldName];
-                    let otherColumn = otherField.serde.columns[0].columnName;
-                    if (otherField.kind === "poly") {
-                        const otherComponent = otherField.components.find((c) => c.otherMetadata() === meta) ??
-                            (0, utils_1.fail)(`No poly component found for ${otherField.fieldName}`);
-                        otherColumn = otherComponent.columnName;
+                const isCtiBaseFk = otherMeta.inheritanceType === "cti" && field.otherFieldName && !(field.otherFieldName in otherMeta.fields);
+                const a = getAlias(otherMeta.tableName);
+                addTable(otherMeta, a, "outer", (0, keywords_1.kqDot)(tableAlias, "id"), (0, keywords_1.kqDot)(a, otherColumn), subFilter[key], field.otherFieldName, targetCb);
+                if (!isCtiBaseFk) {
+                    const table = tables.find((t) => t.alias === a);
+                    if (table && (table.join === "inner" || table.join === "outer")) {
+                        table.collection = { parentAlias: tableAlias, rootAlias: a, kind: "o2m" };
                     }
-                    const isCtiBaseFk = otherMeta.inheritanceType === "cti" && field.otherFieldName && !(field.otherFieldName in otherMeta.fields);
-                    const a = getAlias(otherMeta.tableName);
-                    addTable(otherMeta, a, "outer", (0, keywords_1.kqDot)(alias, "id"), (0, keywords_1.kqDot)(a, otherColumn), ef.subFilter[key], field.otherFieldName);
-                    if (!isCtiBaseFk) {
-                        const table = tables.find((t) => t.alias === a);
-                        if (table && (table.join === "inner" || table.join === "outer")) {
-                            table.collection = { parentAlias: alias, rootAlias: a, kind: "o2m" };
-                        }
+                }
+            }
+            else if (field.kind === "m2m") {
+                const sub = subFilter[key];
+                const f = parseEntityFilter(field.otherMetadata(), sub);
+                if (!f && !(0, Aliases_1.isAlias)(sub))
+                    return;
+                const ja = getAlias(field.joinTableName);
+                tables.push({
+                    join: "outer",
+                    alias: ja,
+                    table: field.joinTableName,
+                    col1: (0, keywords_1.kqDot)(tableAlias, "id"),
+                    col2: (0, keywords_1.kqDot)(ja, field.columnNames[0]),
+                    collection: { parentAlias: tableAlias, rootAlias: ja, kind: "m2m" },
+                });
+                if ((0, Aliases_1.isAlias)(sub) || f?.kind === "join" || filterSoftDeletes(field.otherMetadata(), softDeletes)) {
+                    const a = getAlias(field.otherMetadata().tableName);
+                    addTable(field.otherMetadata(), a, "outer", (0, keywords_1.kqDot)(ja, field.columnNames[1]), (0, keywords_1.kqDot)(a, "id"), sub, undefined, targetCb);
+                    const table = tables.find((t) => t.alias === a);
+                    if (table && (table.join === "inner" || table.join === "outer")) {
+                        table.collection = { parentAlias: ja, rootAlias: ja, kind: "m2m" };
                     }
                 }
-                else if (field.kind === "m2m") {
-                    const sub = ef.subFilter[key];
-                    const f = parseEntityFilter(field.otherMetadata(), sub);
-                    if (!f && !(0, Aliases_1.isAlias)(sub))
-                        return;
-                    const ja = getAlias(field.joinTableName);
-                    tables.push({
-                        join: "outer",
+                else if (f) {
+                    const otherMeta = field.otherMetadata();
+                    const column = {
+                        columnName: field.columnNames[1],
+                        dbType: otherMeta.idDbType,
+                        mapToDb(value) {
+                            return value === null || isNilIdValue(value)
+                                ? value
+                                : (0, index_1.keyToNumber)(otherMeta, (0, index_1.maybeResolveReferenceToId)(value));
+                        },
+                    };
+                    targetCb.addSimpleCondition({
+                        kind: "column",
                         alias: ja,
-                        table: field.joinTableName,
-                        col1: (0, keywords_1.kqDot)(alias, "id"),
-                        col2: (0, keywords_1.kqDot)(ja, field.columnNames[0]),
-                        collection: { parentAlias: alias, rootAlias: ja, kind: "m2m" },
+                        column: field.columnNames[1],
+                        dbType: otherMeta.idDbType,
+                        cond: mapToDb(column, f),
                     });
-                    if ((0, Aliases_1.isAlias)(sub) || f?.kind === "join" || filterSoftDeletes(field.otherMetadata(), softDeletes)) {
-                        const a = getAlias(field.otherMetadata().tableName);
-                        addTable(field.otherMetadata(), a, "outer", (0, keywords_1.kqDot)(ja, field.columnNames[1]), (0, keywords_1.kqDot)(a, "id"), sub);
-                        const table = tables.find((t) => t.alias === a);
-                        if (table && (table.join === "inner" || table.join === "outer")) {
-                            table.collection = { parentAlias: ja, rootAlias: ja, kind: "m2m" };
-                        }
-                    }
-                    else if (f) {
-                        const otherMeta = field.otherMetadata();
-                        const column = {
-                            columnName: field.columnNames[1],
-                            dbType: otherMeta.idDbType,
-                            mapToDb(value) {
-                                return value === null || isNilIdValue(value)
-                                    ? value
-                                    : (0, index_1.keyToNumber)(otherMeta, (0, index_1.maybeResolveReferenceToId)(value));
-                            },
-                        };
-                        cb.addSimpleCondition({
-                            kind: "column",
-                            alias: ja,
-                            column: field.columnNames[1],
-                            dbType: otherMeta.idDbType,
-                            cond: mapToDb(column, f),
-                        });
-                    }
-                }
-                else {
-                    throw new Error(`Unsupported field ${key}`);
                 }
-            });
-        }
-        else if (ef) {
-            const column = meta.fields["id"].serde.columns[0];
-            cb.addValueFilter(alias, column, ef);
-        }
+            }
+            else {
+                throw new Error(`Unsupported field ${key}`);
+            }
+        });
+    }
+    function addLogicalFilter(meta, tableAlias, op, value, targetCb, parentJoin) {
+        const filters = Array.isArray(value) ? value : [value];
+        const conditions = filters.flatMap((filter) => {
+            const branchCb = new index_1.ConditionBuilder();
+            addFilterAt(meta, tableAlias, filter, branchCb, undefined, parentJoin);
+            const condition = branchCb.toExpressionFilter();
+            return condition ? [condition] : [];
+        });
+        if (conditions.length > 0)
+            targetCb.addParsedExpression({ kind: "exp", op, conditions });
     }
     function addOrderBy(meta, alias, orderBy) {
         const entries = Object.entries(orderBy);
@@ -446,6 +501,15 @@ function parseEntityFilter(meta, filter) {
         // We're just binding an alias to this position in the join tree
         return undefined;
     }
+    else if ((0, scopes_1.isScope)(filter)) {
+        // A scope on a relation (e.g. `{ author: Author.adult }`) always implies conditions on the
+        // related entity, so signal "needs a join" via the existing `join` discriminant rather than
+        // adding a dedicated `kind: "scope"` that every relation branch would have to learn. The empty
+        // `subFilter` is intentionally never read: the m2o/m2m branches only check `kind === "join"` to
+        // decide whether to join, then re-dispatch the original scope value back through `addTable`,
+        // where `isScope(...)` routes it to `addScopeFilterAt` to apply the scope's actual fragments.
+        return { kind: "join", subFilter: {} };
+    }
     else if (filter === null) {
         return { kind: "is-null" };
     }
@@ -553,6 +617,13 @@ function nilIdValue(meta) {
 function isNilIdValue(value) {
     return value === -1 || value === "00000000-0000-0000-0000-000000000000";
 }
+/** Finds a filter field by fieldName or generated fieldIdName. */
+function findFilterField(meta, key) {
+    return (meta.allFields[key] ??
+        meta.polyComponentFields?.[key] ??
+        Object.values(meta.allFields).find((field) => field.fieldIdName === key) ??
+        Object.values(meta.polyComponentFields ?? {}).find((field) => field.fieldIdName === key));
+}
 /**
  * Parses the many/hodgepodge (ergonomic!) patterns of value filters into a `ParsedValueFilter[]`.
  *
@@ -579,7 +650,10 @@ function parseValueFilter(filter) {
         else if (keys.length === 2 && "op" in filter && "value" in filter) {
             // Probe for `findGql` op & value
             const { op, value } = filter;
-            if (value === null) {
+            if (shouldPruneValueFilter(op, value)) {
+                return [];
+            }
+            else if (value === null) {
                 return [{ kind: "is-null" }];
             }
             else {
@@ -594,7 +668,7 @@ function parseValueFilter(filter) {
             return Object.entries(filter)
                 .map(([key, value]) => {
                 // Always do condition pruning on the value
-                if (value === undefined) {
+                if (shouldPruneValueFilter(key, value)) {
                     return undefined;
                 }
                 switch (key) {
@@ -859,4 +933,10 @@ function addStiSubtypeFilter(cb, subtypeMeta, alias) {
 function makeLike(search) {
     return search ? `%${search.replace(/\s+/g, "%")}%` : undefined;
 }
+/** Returns true for values that should be treated like an omitted filter. */
+function shouldPruneValueFilter(key, value) {
+    if (value === undefined)
+        return true;
+    return value === false && key !== "eq" && key !== "ne";
+}
 //# sourceMappingURL=QueryParser.js.map