joist-core 2.3.0-next.99 → 2.4.0

package/build/queries/sql/Tables.cjs

@@ -8,11 +8,12 @@ const require_utils = require("../../utils.cjs");
 const require_configure = require("../../configure.cjs");
 const require_EntityMetadata = require("../../EntityMetadata.cjs");
 const require_queries_renderConditions = require("../renderConditions.cjs");
+const require_queries_sql_custom = require("./custom.cjs");
 const require_Entity = require("../../Entity.cjs");
 let joist_utils = require("joist-utils");
 //#region src/queries/sql/Tables.ts
 function table(cstr, _name) {
-	return newTableProxy(cstr);
+	return require_queries_sql_custom.isCustomTableDefinition(cstr) ? newCustomTableProxy(cstr) : newTableProxy(cstr);
 }
 /** Creates multiple physical table handles. */
 function tables(...type) {
@@ -21,9 +22,14 @@ function tables(...type) {
 /** The source of a default reference join, used to inherit optional paths within each query. */
 const referenceJoinSource = Symbol("joist.referenceJoinSource");
 const tableMgmt = Symbol("tableMgmt");
+const inQueryCondition = Symbol("joist.inQueryCondition");
 function getTableMgmt(table) {
 	return table[tableMgmt];
 }
+/** Qualifies custom tables without changing SQL for tables on the default search path. */
+function tableSqlName(table) {
+	return table.schema ? `${require_queries_sql_keywords.safeKq(table.schema)}.${require_queries_sql_keywords.kq(table.tableName)}` : require_queries_sql_keywords.kq(table.tableName);
+}
 /** Returns the metadata for the entity that `table` is bound to. */
 function getTableMetadata(table) {
 	return table[tableMgmt].meta;
@@ -41,7 +47,7 @@ function newTableProxy(cstr) {
 			if (key === tableMgmt) return mgmt;
 			if (typeof key !== "string") return void 0;
 			const descriptor = Object.hasOwn(meta.columns, key) ? meta.columns[key] : void 0;
-			if (descriptor) return descriptor.idMetadata && key !== "id" ? new EntityColumnImpl(meta, descriptor, mgmt) : new PrimitiveColumnImpl(meta, descriptor, mgmt);
+			if (descriptor) return descriptor.idMetadata ? new EntityColumnImpl(meta, descriptor, mgmt, key) : new PrimitiveColumnImpl(meta, descriptor, mgmt, key);
 			const subtype = subtypes.get(key);
 			if (subtype) {
 				const join = new SubtypeJoinImpl(proxy, subtype);
@@ -53,6 +59,7 @@ function newTableProxy(cstr) {
 			}
 			const relation = physicalRelation(meta, key);
 			if (key === "where" && !isRelation(meta.allFields[key])) return (filter) => tableWhere(mgmt, filter);
+			if (key === "column" && !isRelation(meta.allFields[key])) return (column) => new require_queries_sql_Expr.RefExpr(mgmt, column);
 			const field = relation ?? require_utils.fail(`No physical field ${key} on ${cstr.name}; join its base table explicitly`);
 			switch (field.kind) {
 				case "m2o": return new ReferenceJoinImpl(new EntityColumnImpl(meta, field.serde.columns[0].column, mgmt));
@@ -65,13 +72,43 @@ function newTableProxy(cstr) {
 			}
 		},
 		has(_, key) {
-			return key === tableMgmt || typeof key === "string" && (key === "where" || Object.hasOwn(meta.columns, key) || !!physicalRelation(meta, key) || subtypes.has(key));
+			return key === tableMgmt || typeof key === "string" && (key === "where" || key === "column" || Object.hasOwn(meta.columns, key) || !!physicalRelation(meta, key) || subtypes.has(key));
 		}
 	});
 	return proxy;
 }
+/** Creates a typed handle for primitive columns declared outside Joist codegen. */
+function newCustomTableProxy(definition) {
+	const { tableName, schema, columns } = require_queries_sql_custom.getCustomTableDefinition(definition);
+	const mgmt = {
+		tableName,
+		schema,
+		columns
+	};
+	return new Proxy({}, {
+		get(_, key) {
+			if (key === tableMgmt) return mgmt;
+			if (typeof key !== "string") return void 0;
+			const descriptor = Object.hasOwn(columns, key) ? columns[key] : void 0;
+			if (descriptor) return new PrimitiveColumnImpl(void 0, descriptor, mgmt, key);
+			if (key === "column") return (column) => new require_queries_sql_Expr.RefExpr(mgmt, column);
+			return require_utils.fail(`Custom table ${tableName} has no declared column ${key}; use .column("${key}")`);
+		},
+		has(_, key) {
+			return key === tableMgmt || key === "column" || typeof key === "string" && Object.hasOwn(columns, key);
+		}
+	});
+}
 function isTable(obj) {
-	return typeof obj === "function" && tableMgmt in obj;
+	return (typeof obj === "function" || typeof obj === "object" && obj !== null) && tableMgmt in obj;
+}
+/** Whether a physical table has generated entity metadata. */
+function isEntityTable(obj) {
+	return isTable(obj) && "meta" in obj[tableMgmt];
+}
+/** Whether a physical table has columns declared through `declareTable`. */
+function isCustomTable(obj) {
+	return isTable(obj) && "columns" in obj[tableMgmt];
 }
 /**
 * A physical table column implements `Expr`: it renders as `alias."column"`, decodes result
@@ -81,11 +118,16 @@ var TableColumn = class extends require_queries_sql_Expr.BaseExpr {
 	meta;
 	column;
 	mgmt;
-	constructor(meta, column, mgmt) {
+	selectKey;
+	constructor(meta, column, mgmt, selectKey = column.columnName) {
 		super();
 		this.meta = meta;
 		this.column = column;
 		this.mgmt = mgmt;
+		this.selectKey = selectKey;
+	}
+	get [require_queries_sql_Expr.selectKeyBrand]() {
+		return this.selectKey;
 	}
 	/** Author.id, Book.authorId, and Comment.parentAuthorId use the same Author ID domain. */
 	get outputType() {
@@ -283,10 +325,18 @@ var PrimitiveColumnImpl = class extends TableColumn {
 	}
 };
 var EntityColumnImpl = class extends TableColumn {
+	/** Uses the ID target's tag, including for foreign keys and polymorphic components. */
+	taggedId() {
+		return new TaggedIdExpr(this);
+	}
 	in(values) {
 		if (values === void 0) return require_queries_skipCondition.skipCondition;
 		else if (values === null) throw new Error("Unsupported");
 		else if (require_queries_sql_Expr.isExpr(values)) return this.inList("IN", values);
+		else if (!Array.isArray(values)) return { [inQueryCondition]: {
+			column: this,
+			query: values
+		} };
 		else if (values.includes(null)) return { or: [this.addCondition({ kind: "is-null" }), this.addCondition({
 			kind: "in",
 			value: values.filter((v) => v !== null)
@@ -354,6 +404,36 @@ var EntityColumnImpl = class extends TableColumn {
 		});
 	}
 };
+/** Converts a physical ID to SQL text so nested SQL expressions also receive the tag. */
+var TaggedIdExpr = class extends require_queries_sql_Expr.BaseExpr {
+	column;
+	constructor(column) {
+		super();
+		this.column = column;
+	}
+	toSql(ctx) {
+		const fragment = this.column.toSql(ctx);
+		const meta = this.column.idMetadata ?? require_utils.fail("Tagged IDs require an ID column");
+		return {
+			...fragment,
+			sql: `(? || ${fragment.sql}::text)`,
+			bindings: [require_keys.taggedIdPrefix(meta), ...fragment.bindings]
+		};
+	}
+	get outputType() {
+		return {
+			dbType: "text",
+			domain: String,
+			arrayElementSafe: true
+		};
+	}
+	get sqlNullable() {
+		return this.column.sqlNullable;
+	}
+	get sqlSource() {
+		return this.column.sqlSource;
+	}
+};
 var PolyReferenceImpl = class {
 	meta;
 	mgmt;
@@ -582,7 +662,7 @@ var ManyToManyJoinImpl = class extends CollectionJoinImpl {
 };
 /** Fails fast when a join factory is passed something other than a table. */
 function requireTable(other) {
-	if (!isTable(other)) return require_utils.fail(`Expected a table to join, got ${other}`);
+	if (!isEntityTable(other)) return require_utils.fail(`Expected an entity table to join, got ${other}`);
 	return other;
 }
 /** The id column of a joined table, for building sugar ON conditions. */
@@ -676,6 +756,17 @@ function tableWhere(mgmt, filter) {
 	}
 	return conditions.length === 0 ? require_queries_skipCondition.skipCondition : { and: conditions };
 }
+/**
+* Converts relationship filters into conditions on the joined table's id column.
+* I.e. Author's `join: { books: "b:1" }` filters Book.id to 1; `{ books: book }` uses book.id.
+* Lists match any supplied ID, `true` requires a Book, and `null` or `false` requires no Book.
+*/
+function tableEntityWhere(mgmt, value) {
+	const parsed = require_queries_valueFilters.parseEntityFilter(mgmt.meta, value);
+	if (!parsed) return require_queries_skipCondition.skipCondition;
+	if (parsed.kind === "join") require_utils.fail(`Expected an entity or ID filter for ${mgmt.meta.type}`);
+	return new TableColumn(mgmt.meta, mgmt.meta.fields.id.serde.columns[0].column, mgmt).addCondition(parsed);
+}
 /** Rejects nested relations, scopes, and aliases before parsing owning-reference values. */
 function isTableReferenceFilter(value) {
 	if (value == null || typeof value === "boolean" || isTableReferenceValue(value)) return true;
@@ -695,12 +786,18 @@ exports.JoinTableHandle = JoinTableHandle;
 exports.collectionJoin = collectionJoin;
 exports.getTableMetadata = getTableMetadata;
 exports.getTableMgmt = getTableMgmt;
+exports.inQueryCondition = inQueryCondition;
+exports.isCustomTable = isCustomTable;
+exports.isEntityTable = isEntityTable;
 exports.isTable = isTable;
 exports.m2mJoinTable = m2mJoinTable;
 exports.newTableProxy = newTableProxy;
 exports.referenceJoinSource = referenceJoinSource;
 exports.table = table;
+exports.tableEntityWhere = tableEntityWhere;
 exports.tableMgmt = tableMgmt;
+exports.tableSqlName = tableSqlName;
+exports.tableWhere = tableWhere;
 exports.tables = tables;
 
 //# sourceMappingURL=Tables.cjs.map

package/build/queries/sql/Tables.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Tables.cjs","names":["getMetadata","fail","BaseExpr","kqDot","toIdOf","mapToDb","deferredCondition","buildValueCondition","isExpr","skipCondition","makeLike","groupBy","getConstructorFromTaggedId","maybeResolveReferenceToId","asNode","getBaseAndSelfMetas","getBaseSelfAndSubMetas","getBaseMeta","parseEntityFilter","parseValueFilter","isEntity"],"sources":["../../../src/queries/sql/Tables.ts"],"sourcesContent":["import { groupBy } from \"joist-utils\";\n// Load configure first: otherwise the built cjs/esm module graph evaluates relations/* before their\n// base classes exist (\"Class extends value undefined\").\nimport { getConstructorFromTaggedId } from \"src/configure.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport type { IdOf, MaybeAbstractEntityConstructor, TaggedId } from \"src/EntityManager.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type LargeOneToManyField,\n  type ManyToManyField,\n  type OneToManyField,\n  type OneToOneField,\n  type PolymorphicField,\n  type PolymorphicFieldComponent,\n  getBaseAndSelfMetas,\n  getBaseMeta,\n  getBaseSelfAndSubMetas,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { maybeResolveReferenceToId, toIdOf } from \"src/keys.ts\";\nimport type { SqlCondition } from \"src/queries/conditions.ts\";\nimport type { ParsedValueFilter } from \"src/queries/parsedConditions.ts\";\nimport { buildValueCondition } from \"src/queries/renderConditions.ts\";\nimport { skipCondition } from \"src/queries/skipCondition.ts\";\nimport {\n  BaseExpr,\n  type Expr,\n  type ExprContext,\n  type ExprLike,\n  type InnerJoin,\n  type LeftJoin,\n  type SqlFragment,\n  asNode,\n  deferredCondition,\n  isExpr,\n} from \"src/queries/sql/Expr.ts\";\nimport { kqDot } from \"src/queries/sql/keywords.ts\";\nimport { makeLike, mapToDb, parseEntityFilter, parseValueFilter } from \"src/queries/valueFilters.ts\";\nimport type { Column } from \"src/serde/columns.ts\";\nimport type { TypeInfo } from \"src/serde/TypeInfo.ts\";\nimport type { ColumnsOf, FieldsOf, FilterOf, TypeMap, TypeNameOf } from \"src/typeMap.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/** Creates physical column expressions and relationship joins for `T`. */\nexport function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T>;\n/**\n * Creates a table with an explicit type-level name, i.e. `table(Author, \"m\")` for a self-join.\n *\n * The name is the table's source key in `em.query`: two bare `table(Author)`s share the key `\"Author\"`,\n * so a left-joined mentor would also mark the mentee's columns nullable; a named alias has its own key.\n */\nexport function table<T extends Entity, Name extends string>(\n  cstr: MaybeAbstractEntityConstructor<T>,\n  name: Name,\n): Table<T, Name>;\nexport function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>, _name?: string): unknown {\n  // The name only exists at the type level; the SQL alias is still assigned by the query parser\n  return newTableProxy(cstr);\n}\n\n/** Creates multiple physical table handles. */\nexport function tables<T extends readonly MaybeAbstractEntityConstructor<any>[]>(\n  ...type: T\n): { [P in keyof T]: T[P] extends MaybeAbstractEntityConstructor<infer E extends Entity> ? Table<E> : never } {\n  return type.map((t) => newTableProxy(t)) as any;\n}\n\n/**\n * The runtime management interface plus phantom type information for `em.query`.\n *\n * `__entity` lets `QueryRow` recover `T` for entity mode (you cannot `infer T` back out of a mapped\n * type), and `__name` is the table's source key (see `Expr`).\n */\nexport interface TableBrand<T, Name extends string> extends TableMgmt {\n  readonly __entity: T;\n  readonly __name: Name;\n}\n\n/**\n * A physical table for `T`: one expression per SQL column, with relationship names as join factories.\n * Selecting the table itself retains entity hydration; selecting columns returns decoded SQL values.\n *\n * Unlike an Alias, a Table is an explicit SQL source, not a place to bind in an em.find relationship\n * tree. I.e. with `a = table(Author)`, `{ from: a }` registers that handle in the query's scope.\n * Its columns already know their physical column and codec, but their SQL name still depends on the\n * query: the same Author handle might be `a` in one query and `a1` in a nested query.\n *\n * Each predicate occurrence renders through ExprContext.aliasFor using the current scope (or an\n * enclosing scope for a correlation). Rendering returns SQL, ordered bindings, and source references\n * together. A comparison records both sides' references; templates and subqueries carry their\n * references too. Join pruning follows these references and join dependencies, rather than guessing\n * which tables a SQL string mentions. It also accounts for select/order/group expressions and keep.\n *\n * I.e. if a joined Author is used only by `a.firstName.eq(name)`, supplying undefined removes that\n * predicate and lets the unused join prune. Both APIs share this undefined-condition pruning rule;\n * they differ in how they get the references: Alias resolves domain conditions against a relationship\n * tree, while Table renders SQL expressions against explicit sources. Neither caches SQL names on\n * the reusable handle or predicate, so one parse cannot overwrite another parse's bindings.\n *\n * `Name` is the table's type-level source key, defaulting to the entity's own type name, so a\n * LEFT-joined SmallPublisher does not make Publisher columns nullable. `table(Author, \"m\")`\n * gives a self-join table its own key.\n */\nexport type Table<T extends Entity, Name extends string = TableNameOf<T>> = TableShape<T, Name> &\n  (\"where\" extends keyof TableShape<T, Name>\n    ? {}\n    : {\n        /** Builds an AND condition from local domain fields, without implicit joins. */\n        where(filter: TableFilter<T>): SqlCondition;\n      });\n\n/** Domain filters for fields stored on this physical table, without relationship traversal. */\nexport type TableFilter<T extends Entity> = {\n  [K in LocalFieldNames<T> & keyof FieldsOf<T>]?: FieldsOf<T>[K] extends {\n    kind: \"m2o\";\n    type: infer U extends Entity;\n    nullable: infer N;\n  }\n    ? TableReferenceFilter<U, N extends undefined ? null : never>\n    : FilterOf<T>[K];\n};\n\n/** Generated column ownership excludes CTI base fields and polymorphic components. */\ntype LocalFieldNames<T> = ColumnsOf<T>[keyof ColumnsOf<T>] extends { fieldName: infer F }\n  ? Extract<F, keyof FilterOf<T>>\n  : never;\n\n/** The owning-reference subset of find filters that only compares a foreign key. */\ntype TableReferenceFilter<T extends Entity, N> =\n  | T\n  | IdOf<T>\n  | readonly (T | IdOf<T>)[]\n  | boolean\n  | N\n  | undefined\n  | { ne: T | IdOf<T> | N | undefined };\n\ntype TableShape<T extends Entity, Name extends string> = {\n  readonly [tableMgmt]: TableBrand<T, Name>;\n} & {\n  [P in keyof ColumnsOf<T>]: P extends \"id\"\n    ? EntityColumn<T, never, Name>\n    : ColumnsOf<T>[P] extends { entity: infer U extends Entity; nullable: infer N }\n      ? ReferenceColumn<U, N extends true ? null : never, Name>\n      : ColumnsOf<T>[P] extends { type: infer V; nullable: infer N }\n        ? PrimitiveColumn<V, N extends true ? null : never, Name>\n        : never;\n} & {\n  [\n    P in keyof FieldsOf<T> as P extends keyof ColumnsOf<T>\n      ? never\n      : FieldsOf<T>[P] extends { kind: \"m2o\" | \"poly\" | \"o2m\" | \"lo2m\" | \"m2m\" | \"o2o\" }\n        ? P\n        : never\n  ]: FieldsOf<T>[P] extends { kind: \"m2o\"; type: infer U extends Entity; nullable: infer N }\n    ? ReferenceJoin<U, N extends undefined ? null : never, Name>\n    : FieldsOf<T>[P] extends { kind: \"poly\"; type: infer U extends Entity; nullable: infer N }\n      ? PolyReference<U, N extends undefined ? null : never, Name>\n      : FieldsOf<T>[P] extends { kind: \"o2m\" | \"lo2m\" | \"m2m\" | \"o2o\"; type: infer U extends Entity }\n        ? CollectionJoin<U>\n        : never;\n} & {\n  [\n    K in keyof TypeMap as TypeMap[K] extends {\n      entityType: infer U extends Entity & { __type: { 0: TypeNameOf<T>; 1: string } };\n    }\n      ? Uncapitalize<TypeNameOf<U> & string>\n      : never\n  ]: TypeMap[K] extends { entityType: infer U extends Entity } ? SubtypeJoin<U> : never;\n};\n\n/** Keeps explicit base and subtype sources independent, with generic entities untracked. */\ntype TableNameOf<T> = T extends { __type: { 0: string } } ? TypeNameOf<T> & string : string;\n\n/** Provides fluent methods for creating joins through an owning reference relationship. */\nexport interface ReferenceJoin<U extends Entity, N extends null | never, Src extends string = string> {\n  /**\n   * Required reference joins like `b.author.as(a)` are INNER unless `b` is already a LEFT-joined alias.\n   * Nullable references are always LEFT joined.\n   */\n  as<A extends TableFor<U>>(other: A): [N] extends [never] ? DefaultReferenceJoin<A, Src> : LeftJoin<A>;\n  inner<A extends TableFor<U>>(other: A): InnerJoin<A>;\n  left<A extends TableFor<U>>(other: A): LeftJoin<A>;\n}\n\n/** The source of a default reference join, used to inherit optional paths within each query. */\nexport const referenceJoinSource: unique symbol = Symbol(\"joist.referenceJoinSource\");\n\n/** A required reference defaults to INNER unless its source was LEFT joined. */\nexport type DefaultReferenceJoin<A, Src extends string> = InnerJoin<A> & {\n  readonly [referenceJoinSource]: Src;\n};\n\n/** Any table whose entity is (a subtype of) `U`, i.e. what a relation join factory accepts. */\nexport type TableFor<U> = { readonly [tableMgmt]: TableBrand<U, string> };\n\n/**\n * A collection relation (o2m/o2o/m2m) as a join factory: `a.books.as(b)` returns the same\n * `{ left: b, on: ... }` entry the expanded form writes, with the FK condition built from metadata, so\n * join-list inference, nullability, scope checking, and pruning are unchanged and both forms mix freely.\n *\n * `as` binds the joined alias, the same way em.find's `{ books: { as: b } }` does. The default is LEFT\n * (a collection may be empty, and a LEFT join never filters rows, so pruning it is always safe);\n * `.inner(b)` opts into filtering. An m2m entry carries a hidden second join through the join table,\n * which the parser expands; the pair prunes together.\n */\nexport interface CollectionJoin<U extends Entity> {\n  as<A extends TableFor<U>>(other: A): LeftJoin<A>;\n  inner<A extends TableFor<U>>(other: A): InnerJoin<A>;\n  left<A extends TableFor<U>>(other: A): LeftJoin<A>;\n}\n\n/** A named subtype join, defaulting to LEFT because a root row may belong to another subtype. */\ninterface SubtypeJoin<U extends Entity> extends CollectionJoin<U> {\n  <A extends TableFor<U>>(other: A): LeftJoin<A>;\n}\n\n/**\n * A physical FK column expression (`b.authorId` selects/compares the `author_id` FK) plus a join factory\n * (`b.authorId.as(a)` joins). The default join kind follows physical column nullability:\n * a NOT NULL FK is INNER unless its source was LEFT joined, a nullable one is LEFT, and the row type reflects it.\n */\nexport interface ReferenceColumn<U extends Entity, N extends null | never, Src extends string>\n  extends EntityColumn<U, N, Src>, ReferenceJoin<U, N, Src> {}\n\n/**\n * A polymorphic reference: condition methods (each resolving the component column from the value), plus\n * a join factory that picks the component from the argument's entity, i.e. `c.parent.as(a)` joins\n * through `parent_author_id`, like an explicit join with `on: c.parent.eq(a.id)`.\n */\nexport interface PolyReference<\n  U extends Entity,\n  N extends null | never,\n  Src extends string = string,\n> extends ReferenceJoin<U, N, Src> {\n  eq(value: U | TaggedId | ExprLike<IdOf<U> | null> | null | undefined): SqlCondition;\n  ne(value: U | TaggedId | ExprLike<IdOf<U> | null> | null | undefined): SqlCondition;\n  in(values: readonly (U | TaggedId)[] | ExprLike<IdOf<U> | null> | undefined): SqlCondition;\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (U | TaggedId)[] | undefined): SqlCondition;\n}\n\nexport interface PrimitiveColumn<V, N extends null | never, Src extends string = string> extends Expr<V | N, Src> {\n  eq(value: V | ExprLike<V | N> | N | undefined): SqlCondition;\n  ne(value: V | ExprLike<V | N> | N | undefined): SqlCondition;\n  in(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition;\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (V | null)[] | undefined): SqlCondition;\n  nin(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition;\n  gt(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  gte(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  lt(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  lte(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  like(value: V | undefined): SqlCondition;\n  ilike(value: V | undefined): SqlCondition;\n  search(value: V | undefined): SqlCondition;\n  between(v1: V | undefined, v2: V | undefined): SqlCondition;\n  // need to move to ArrayColumn\n  // ...added the `string` to support jsonb contains like `WHERE profile @> '{\"age\": 25}'`\n  // Ideally this would go in a JsonbColumn\n  contains(value: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n  ncontains(value: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n  overlaps(value: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n  noverlaps(value: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n\n  /**\n   * Adds a JSON path existence condition, using the `@?` operator.\n   *\n   * Any values should be embedded directly within the `jsonPath`, because postgres does not\n   * support parameterized JSON path expressions. The entire `jsonPath` is treated as a parameter,\n   * so this is safe from SQL injection.\n   */\n  pathExists(jsonPath: string | undefined): SqlCondition;\n\n  /**\n   * Adds a JSON path predicate condition, using the `@@` operator.\n   *\n   * Any values should be embedded directly within the `jsonPath`, because postgres does not\n   * support parameterized JSON path expressions. The entire `jsonPath` is treated as a parameter,\n   * so this is safe from SQL injection.\n   */\n  pathIsTrue(jsonPath: string | undefined): SqlCondition;\n\n  /**\n   * Add `exp` to the query, which should include the operator & expression and any\n   * bound parameters (but not include the column name).\n   *\n   * We use knex-style placeholders, i.e. `?` and `\\\\?` to escape question marks, i.e.\n   *\n   * ```ts\n   * a.address.raw(\"@\\\\? ?\", ['$.street ? (@ == \"rr2\")'])`\n   * ```\n   */\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;\n}\n\nexport interface EntityColumn<T, N extends null | never = never, Src extends string = string> extends Expr<\n  IdOf<T> | N,\n  Src\n> {\n  eq(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  ne(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  // Adding `| null` for GraphQL support\n  in(value: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  /** Applies an IN condition unless the list is empty, null, or undefined. */\n  inNonEmpty(value: readonly (T | IdOf<T> | null)[] | null | undefined): SqlCondition;\n  nin(value: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  gt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  gte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  lt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  lte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;\n}\n\nexport const tableMgmt = Symbol(\"tableMgmt\");\n\nexport function getTableMgmt(table: TableFor<unknown>): TableMgmt {\n  return table[tableMgmt];\n}\n\n/** The identity SQL queries bind a table by, plus its original entity metadata. */\nexport interface TableMgmt {\n  tableName: string;\n  /**\n   * The metadata this table was created with, i.e. `table(TaskNew)` keeps `taskNewMeta`.\n   *\n   * It cannot be re-derived from `tableName`: STI subtypes share their base's table (`Task`, `TaskNew`,\n   * and `TaskOld` are all `tasks`), so a `getMetadataForTable(\"tasks\")` lookup can only return the base\n   * `Task`, and the alias would lose its subtype identity for explicit subtype joins and entity hydration.\n   */\n  meta: EntityMetadata;\n}\n\n/** Returns the metadata for the entity that `table` is bound to. */\nexport function getTableMetadata<T extends Entity>(table: TableFor<T>): EntityMetadata<T> {\n  const mgmt = table[tableMgmt];\n  return mgmt.meta as EntityMetadata<T>;\n}\n\nexport function newTableProxy<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T> {\n  const meta = getMetadata(cstr);\n  // The identity SQL queries bind to a source, retaining STI subtype metadata.\n  const mgmt: TableMgmt = { tableName: meta.tableName, meta };\n  const subtypes = new Map(meta.subTypes.map((m) => [m.type[0].toLowerCase() + m.type.slice(1), m]));\n  const proxy: any = new Proxy(cstr, {\n    /** Create a physical column expression or a relation join factory. */\n    get(_, key: PropertyKey): any {\n      if (key === tableMgmt) {\n        return mgmt;\n      }\n      if (typeof key !== \"string\") return undefined;\n      const descriptor = Object.hasOwn(meta.columns, key) ? meta.columns[key] : undefined;\n      if (descriptor) {\n        return descriptor.idMetadata && key !== \"id\"\n          ? new EntityColumnImpl(meta, descriptor, mgmt)\n          : new PrimitiveColumnImpl(meta, descriptor, mgmt);\n      }\n      const subtype = subtypes.get(key);\n      if (subtype) {\n        const join = new SubtypeJoinImpl(proxy, subtype);\n        return Object.assign(join.as.bind(join), {\n          as: join.as.bind(join),\n          inner: join.inner.bind(join),\n          left: join.left.bind(join),\n        });\n      }\n      const relation = physicalRelation(meta, key);\n      if (key === \"where\" && !isRelation(meta.allFields[key])) {\n        return (filter: TableFilter<T>) => tableWhere(mgmt, filter);\n      }\n      const field = relation ?? fail(`No physical field ${key} on ${cstr.name}; join its base table explicitly`);\n      switch (field.kind) {\n        case \"m2o\":\n          return new ReferenceJoinImpl(new EntityColumnImpl(meta, field.serde.columns[0].column, mgmt));\n        case \"poly\":\n          return new PolyReferenceImpl(meta, mgmt, field);\n        case \"o2m\":\n        case \"o2o\":\n        case \"lo2m\":\n          return new OneToManyJoinImpl(proxy, field);\n        case \"m2m\":\n          return new ManyToManyJoinImpl(proxy, field);\n        default:\n          throw new Error(`Unsupported table field kind ${field.kind}`);\n      }\n    },\n\n    has(_, key) {\n      return (\n        key === tableMgmt ||\n        (typeof key === \"string\" &&\n          (key === \"where\" || Object.hasOwn(meta.columns, key) || !!physicalRelation(meta, key) || subtypes.has(key)))\n      );\n    },\n  });\n  return proxy;\n}\n\nexport function isTable(obj: unknown): obj is Table<any, any> {\n  // Oddly enough `typeof` will be a function b/c we are proxying the constructors\n  return typeof obj === \"function\" && tableMgmt in obj;\n}\n\n/**\n * A physical table column implements `Expr`: it renders as `alias.\"column\"`, decodes result\n * values through the column's shared scalar codec, and inherits aggregate methods from `BaseExpr`.\n */\nclass TableColumn extends BaseExpr {\n  public constructor(\n    readonly meta: EntityMetadata,\n    readonly column: Column,\n    readonly mgmt: TableMgmt,\n  ) {\n    super();\n  }\n\n  /** Author.id, Book.authorId, and Comment.parentAuthorId use the same Author ID domain. */\n  get outputType(): TypeInfo | undefined {\n    return this.column.outputType;\n  }\n\n  get sqlNullable(): boolean | undefined {\n    return this.column.sqlNullable;\n  }\n\n  get sqlSource(): object {\n    return this.mgmt;\n  }\n\n  toSql(ctx: ExprContext): SqlFragment {\n    const alias = ctx.aliasFor(this.mgmt);\n    return { sql: kqDot(alias, this.column.columnName), bindings: [], refs: [alias] };\n  }\n\n  /** Decodes result-set values with public PK/FK ids, while hydration keeps internal tagged ids. */\n  decode(value: unknown): unknown {\n    if (value === null || value === undefined) return value;\n    const idMeta = this.idMetadata;\n    if (idMeta) return toIdOf(idMeta, this.column.mapFromDb(value) as TaggedId | undefined);\n    return this.column.mapFromDb(value);\n  }\n\n  encode(value: unknown): unknown {\n    return this.column.mapToDb(value);\n  }\n\n  /** Identifies the ID domain of a primary key, FK, or physical polymorphic component. */\n  get idMetadata(): EntityMetadata | undefined {\n    return this.column.idMetadata?.();\n  }\n\n  /** Encodes literals when the condition is created and renders with each query's aliases. */\n  addCondition(value: ParsedValueFilter<unknown>): SqlCondition {\n    const encoded = mapToDb(this.column, value);\n    return deferredCondition((ctx) => {\n      const left = this.toSql(ctx);\n      const [sql, bindings] = buildValueCondition(left.sql, encoded);\n      return { sql, bindings: [...left.bindings, ...bindings], refs: left.refs };\n    });\n  }\n\n  /** Renders raw operators against the same quoted column SQL as other expressions. */\n  protected addRawCondition(exp: string, bindings: readonly any[]): SqlCondition {\n    return deferredCondition((ctx) => {\n      const left = this.toSql(ctx);\n      return { sql: `${left.sql} ${exp}`, bindings: [...left.bindings, ...bindings], refs: left.refs };\n    });\n  }\n\n  /** Uses column filter conversions for literals and shared comparisons for expressions and null equality. */\n  protected compare(op: string, value: unknown): SqlCondition {\n    if (value === undefined || isExpr(value) || (value === null && (op === \"=\" || op === \"!=\"))) {\n      return super.compare(op, value);\n    }\n    // Primitive relational comparisons historically bind null through mapToDb.\n    const kind = ({ \"=\": \"eq\", \"!=\": \"ne\", \">\": \"gt\", \">=\": \"gte\", \"<\": \"lt\", \"<=\": \"lte\" } as const)[op];\n    if (!kind) return fail(`Invalid operator ${op}`);\n    return this.addCondition({ kind, value });\n  }\n\n  /**\n   * Compares this column to another expression.\n   *\n   * Table columns, aggregates, subquery columns, and `sql` templates use the expression context\n   * to render their complete SQL.\n   * Negated array operators wrap the complete comparison in NOT.\n   */\n  protected compareToExpr(op: string, value: ExprLike<any>, negate = false): SqlCondition {\n    if (negate) {\n      return deferredCondition((ctx) => {\n        const comparison = ctx.conditionToSql(this.compareToExpr(op, value))!;\n        return { ...comparison, sql: `NOT (${comparison.sql})` };\n      });\n    }\n    return super.compare(op, value);\n  }\n}\n\nclass PrimitiveColumnImpl<V, N extends null | never> extends TableColumn implements PrimitiveColumn<V, N> {\n  between(v1: V | undefined, v2: V | undefined): SqlCondition {\n    if (v1 === undefined || v2 === undefined) return skipCondition;\n    return this.addCondition({ kind: \"between\", value: [v1, v2] });\n  }\n\n  like(value: V | undefined): SqlCondition {\n    if (value === undefined) return skipCondition;\n    return this.addCondition({ kind: \"like\", value });\n  }\n\n  ilike(value: V | undefined): SqlCondition {\n    if (value === undefined) return skipCondition;\n    return this.addCondition({ kind: \"ilike\", value });\n  }\n\n  search(value: V | undefined): SqlCondition {\n    // Check !value so that empty strings are pruned\n    if (!value) return skipCondition;\n    return this.addCondition({ kind: \"ilike\", value: makeLike(value) });\n  }\n\n  in(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition {\n    if (values === undefined) return skipCondition;\n    if (isExpr(values)) return this.inList(\"IN\", values);\n    if (values.includes(null)) {\n      const isNull = this.addCondition({ kind: \"is-null\" });\n      const hasValue = this.addCondition({ kind: \"in\", value: values.filter((v) => v !== null) });\n      return { or: [isNull, hasValue] };\n    } else {\n      return this.addCondition({ kind: \"in\", value: values as V[] });\n    }\n  }\n\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (V | null)[] | undefined): SqlCondition {\n    return values === undefined || values.length === 0 ? skipCondition : this.in(values);\n  }\n\n  nin(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition {\n    if (values === undefined) return skipCondition;\n    if (isExpr(values)) return this.inList(\"NOT IN\", values);\n    return this.addCondition({ kind: \"nin\", value: values.filter((v) => v !== null) as V[] });\n  }\n\n  // V will already be an array\n  contains(v1: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"@>\", v1);\n    return this.addCondition({ kind: \"contains\", value: v1 as any });\n  }\n\n  // V will already be an array\n  ncontains(v1: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"@>\", v1, true);\n    return this.addCondition({ kind: \"ncontains\", value: v1 as any });\n  }\n\n  // V will already be an array\n  overlaps(v1: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"&&\", v1);\n    return this.addCondition({ kind: \"overlaps\", value: v1 as any });\n  }\n\n  noverlaps(v1: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"&&\", v1, true);\n    return this.addCondition({ kind: \"noverlaps\", value: v1 as any });\n  }\n\n  pathExists(jsonPath: string | undefined): SqlCondition {\n    if (jsonPath === undefined) return skipCondition;\n    return this.addCondition({ kind: \"jsonPathExists\", value: jsonPath });\n  }\n\n  pathIsTrue(jsonPath: string | undefined): SqlCondition {\n    if (jsonPath === undefined) return skipCondition;\n    return this.addCondition({ kind: \"jsonPathPredicate\", value: jsonPath });\n  }\n\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition {\n    if (bindings === undefined) return skipCondition;\n    return this.addRawCondition(exp, bindings);\n  }\n}\n\nclass EntityColumnImpl<T> extends TableColumn implements EntityColumn<T> {\n  in(values: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    if (values === undefined) {\n      return skipCondition;\n    } else if (values === null) {\n      throw new Error(\"Unsupported\");\n    } else if (isExpr(values)) {\n      return this.inList(\"IN\", values);\n    } else if (values.includes(null)) {\n      // Like `PrimitiveColumn.in`, split `[a1, null]` into `IS NULL OR IN (...)`\n      const isNull = this.addCondition({ kind: \"is-null\" });\n      const hasValue = this.addCondition({ kind: \"in\", value: values.filter((v) => v !== null) as any });\n      return { or: [isNull, hasValue] };\n    } else {\n      return this.addCondition({ kind: \"in\", value: values as any });\n    }\n  }\n\n  /** Applies an IN condition unless the list is empty, null, or undefined. */\n  inNonEmpty(values: readonly (T | IdOf<T> | null)[] | null | undefined): SqlCondition {\n    return values === null || values === undefined || values.length === 0 ? skipCondition : this.in(values);\n  }\n\n  nin(values: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    if (values === undefined) {\n      return skipCondition;\n    } else if (values === null) {\n      throw new Error(\"Unsupported\");\n    } else if (isExpr(values)) {\n      return this.inList(\"NOT IN\", values);\n    } else {\n      return this.addCondition({ kind: \"nin\", value: values.filter((v) => v !== null) as any });\n    }\n  }\n\n  gt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\">\", \"gt\", value);\n  }\n\n  gte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\">=\", \"gte\", value);\n  }\n\n  lt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\"<\", \"lt\", value);\n  }\n\n  lte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\"<=\", \"lte\", value);\n  }\n\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition {\n    if (bindings === undefined) return skipCondition;\n    return this.addRawCondition(exp, bindings);\n  }\n\n  /** Joins via this FK, inheriting the source's LEFT join for otherwise required references. */\n  as(other: object): object {\n    return {\n      ...this.joinEntry(this.sqlNullable === false ? \"inner\" : \"left\", other),\n      [referenceJoinSource]: this.mgmt,\n    };\n  }\n\n  inner(other: object): object {\n    return this.joinEntry(\"inner\", other);\n  }\n\n  left(other: object): object {\n    return this.joinEntry(\"left\", other);\n  }\n\n  private joinEntry(kind: JoinKind, other: object): object {\n    return { [kind]: requireTable(other), on: this.eq(idColumnOf(other)) };\n  }\n\n  private compareId(op: string, kind: \"gt\" | \"gte\" | \"lt\" | \"lte\", value: unknown): SqlCondition {\n    if (value === undefined) return skipCondition;\n    if (value === null) throw new Error(\"Unsupported\");\n    if (isExpr(value)) return this.compareToExpr(op, value);\n    return this.addCondition({ kind, value: value as any });\n  }\n}\n\nclass PolyReferenceImpl<T extends Entity> {\n  public constructor(\n    private meta: EntityMetadata,\n    private mgmt: TableMgmt,\n    private field: PolymorphicField,\n  ) {}\n\n  /** Compares to a tagged id, an entity, or another table's id column, which picks the component (`c.parent.eq(a.id)`). */\n  eq(value: T | TaggedId | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.addEqOrNe(\"eq\", value);\n  }\n\n  ne(value: T | TaggedId | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.addEqOrNe(\"ne\", value);\n  }\n\n  // We required tagged ids for polys\n  in(values: readonly (T | TaggedId)[] | ExprLike<IdOf<T> | null> | undefined): SqlCondition {\n    if (values === undefined) return skipCondition;\n    if (isExpr(values)) return this.inSubquery(values);\n    // Split up the ids by constructor\n    const idsByConstructor = groupBy(values, (id) => getConstructorFromTaggedId(maybeResolveReferenceToId(id)!).name);\n    // Or together `parent_book_id in (1,2,3) OR parent_author_id IN (4,5,6)`\n    return {\n      or: Object.entries(idsByConstructor).map(([cstrName, ids]) => {\n        const comp =\n          this.field.components.find((p) => p.otherMetadata().cstr.name === cstrName) ??\n          fail(`No component for ${cstrName}`);\n        return this.componentColumn(comp).addCondition({ kind: \"in\", value: ids });\n      }),\n    };\n  }\n\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (T | TaggedId)[] | undefined): SqlCondition {\n    return values === undefined || values.length === 0 ? skipCondition : this.in(values);\n  }\n\n  /** Joins via this poly's component, inheriting the source's LEFT join when the poly is required. */\n  as(other: object): object {\n    return { ...this.joinEntry(this.field.required ? \"inner\" : \"left\", other), [referenceJoinSource]: this.mgmt };\n  }\n\n  inner(other: object): object {\n    return this.joinEntry(\"inner\", other);\n  }\n\n  left(other: object): object {\n    return this.joinEntry(\"left\", other);\n  }\n\n  private joinEntry(kind: JoinKind, other: object): object {\n    return { [kind]: requireTable(other), on: this.eq(idColumnOf(other) as any) };\n  }\n\n  /**\n   * i.e. `c.parent.in(query({ from: a, ..., select: a.id }))`: like `eq` against a table column, the\n   * subquery's agreed ID domain picks the component, i.e. authors pick `parent_author_id`.\n   */\n  private inSubquery(values: ExprLike<any>): SqlCondition {\n    // Only actual subqueries expose this getter; importing query.ts would create a load-order cycle.\n    const selected = asNode(values).subquerySelect;\n    const outputType = selected?.outputType;\n    let otherMeta = outputType?.idMeta;\n    if (!otherMeta) {\n      // Ordinary reads can select an unknown key serde. Compounds validate codecs before exposing a select.\n      if (!outputType && selected instanceof TableColumn) {\n        otherMeta = selected.idMetadata;\n      }\n      if (!otherMeta) {\n        return fail(\n          selected instanceof TableColumn\n            ? `${this.field.fieldName} \\`in\\` needs an id or FK column, got ${selected.column.columnName}`\n            : `${this.field.fieldName} is polymorphic, so \\`in\\` needs a subquery selecting an id or FK column`,\n        );\n      }\n    }\n    const comp =\n      this.field.components.find((p) => getBaseAndSelfMetas(otherMeta).includes(p.otherMetadata())) ??\n      fail(`${this.field.fieldName} has no component for ${otherMeta.type}`);\n    return this.componentColumn(comp).in(values);\n  }\n\n  private addEqOrNe(\n    kind: \"eq\" | \"ne\",\n    value: T | TaggedId | ExprLike<IdOf<T> | null> | null | undefined,\n  ): SqlCondition {\n    if (value === undefined) {\n      return skipCondition;\n    } else if (value instanceof TableColumn) {\n      // Joining through the poly, i.e. `c.parent.eq(a.id)`: the other table column's ID domain picks the component\n      const otherMeta = value.idMetadata ?? fail(`${this.field.fieldName} needs an id or FK column`);\n      const comp =\n        this.field.components.find((p) => getBaseAndSelfMetas(otherMeta).includes(p.otherMetadata())) ??\n        fail(`${this.field.fieldName} has no component for ${otherMeta.type}`);\n      return this.componentColumn(comp)[kind](value);\n    } else if (isExpr(value)) {\n      return fail(\n        `${this.field.fieldName} is polymorphic, so it can only be compared to tagged ids or entity table columns`,\n      );\n    } else if (value === null) {\n      // We can AND each of the components as many conditions\n      const value = kind === \"eq\" ? ({ kind: \"is-null\" } as const) : ({ kind: \"not-null\" } as const);\n      return {\n        and: this.field.components.map((p) => this.componentColumn(p).addCondition(value)),\n      };\n    } else {\n      // If we have a value, we can find the component\n      const comp =\n        this.field.components.find(\n          (p) => p.otherMetadata().cstr === getConstructorFromTaggedId(maybeResolveReferenceToId(value) as string),\n        ) || fail(`Could not find component for ${value}`);\n      return this.componentColumn(comp)[kind](value);\n    }\n  }\n\n  /** Returns the physical FK expression for one polymorphic target. */\n  private componentColumn(comp: PolymorphicFieldComponent): EntityColumnImpl<T> {\n    const descriptor = comp.column;\n    return new EntityColumnImpl<T>(this.meta, descriptor, this.mgmt);\n  }\n}\n\n/**\n * Marks a sugar join entry whose target is a *collection* (o2m/m2m), which filter soft-deletes like\n * em.find's \"collections filter out soft-deletes, but m2o/o2o references still return them\"; see\n * `QueryParser.addSoftDeleteCondition`'s call site. Reference joins and explicit joins are unmarked.\n */\nexport const collectionJoin: unique symbol = Symbol(\"joist.collectionJoin\");\n\n/** Marks a sugar m2m join entry (`a.tags.as(t)`) with its hidden join-table join; `parseQuery` expands it. */\nexport const m2mJoinTable: unique symbol = Symbol(\"joist.m2mJoinTable\");\n\nexport interface M2mJoinTable {\n  handle: JoinTableHandle;\n  on: SqlCondition;\n}\n\n/** The runtime identity of an m2m join table in a query, i.e. `authors_to_tags`; it has no entity. */\nexport class JoinTableHandle {\n  constructor(readonly joinTableName: string) {}\n}\n\ntype JoinKind = \"inner\" | \"left\";\n\n/**\n * The `as`/`inner`/`left` join factory for collection relations, i.e. `a.books.as(b)` joins with the\n * relation's default kind (LEFT: a collection may be empty) and `.inner`/`.left` override. m2o/poly\n * relations implement the same three methods on their join factories. Physical FKs such as\n * `b.author_id` are expressions that also expose a join factory.\n */\nabstract class CollectionJoinImpl {\n  as(other: object): object {\n    return this.joinEntry(\"left\", requireTable(other));\n  }\n\n  inner(other: object): object {\n    return this.joinEntry(\"inner\", requireTable(other));\n  }\n\n  left(other: object): object {\n    return this.joinEntry(\"left\", requireTable(other));\n  }\n\n  protected abstract joinEntry(kind: JoinKind, other: TableFor<Entity>): object;\n}\n\n/** Joins a named subtype explicitly; only STI subtype sugar adds a discriminator to its ON. */\nclass SubtypeJoinImpl extends CollectionJoinImpl {\n  constructor(\n    private proxy: TableFor<Entity>,\n    private subtype: EntityMetadata,\n  ) {\n    super();\n  }\n\n  protected joinEntry(kind: JoinKind, other: TableFor<Entity>): object {\n    if (getTableMetadata(other) !== this.subtype) {\n      return fail(`Expected table(${this.subtype.type}) for the explicit subtype join`);\n    }\n    const on = idColumnOf(this.proxy).eq(idColumnOf(other));\n    if (this.subtype.inheritanceType !== \"sti\" || this.subtype.stiDiscriminatorValue === undefined) {\n      return { [kind]: other, on };\n    }\n    const base = this.subtype.baseTypes.find((m) => m.stiDiscriminatorField !== undefined)!;\n    const columnName = base.fields[base.stiDiscriminatorField!].serde!.columns[0].columnName;\n    // Discriminator values are database enum ids, not domain enum values to pass through the field codec.\n    const discriminator = deferredCondition((ctx) => {\n      const alias = ctx.aliasFor(other[tableMgmt]);\n      return {\n        sql: `${kqDot(alias, columnName)} = ?`,\n        bindings: [this.subtype.stiDiscriminatorValue],\n        refs: [alias],\n      };\n    });\n    return { [kind]: other, on: { and: [on, discriminator] } };\n  }\n}\n\n/** An o2m/lo2m/o2o relation: the ON is the other side's FK (an m2o or a poly component) back to our id. */\nclass OneToManyJoinImpl extends CollectionJoinImpl {\n  constructor(\n    private proxy: any,\n    private field: OneToManyField | LargeOneToManyField | OneToOneField,\n  ) {\n    super();\n  }\n\n  protected joinEntry(kind: JoinKind, other: TableFor<Entity>): object {\n    const { field } = this;\n    const otherMeta = getTableMetadata(other);\n    const descriptor = Object.values(otherMeta.columns).find((column) => column.columnName === field.otherColumnName);\n    if (!descriptor) {\n      return fail(\n        `Cannot join ${getTableMetadata(this.proxy).type}.${field.fieldName} to ${otherMeta.type}: ` +\n          `${field.otherColumnName} is not physically present on ${otherMeta.tableName}; join the base table explicitly`,\n      );\n    }\n    const column = new EntityColumnImpl(otherMeta, descriptor, other[tableMgmt]);\n    const on = column.eq(this.proxy.id);\n    // Collections (o2m/lo2m) filter soft-deletes like em.find; o2o references resolve them\n    const filtered = field.kind === \"o2m\" ? field.softDeletes !== \"include\" : field.kind === \"lo2m\";\n    return { [kind]: other, on, [collectionJoin]: filtered };\n  }\n}\n\n/**\n * An m2m relation, i.e. `a.tags.as(t)`.\n *\n * The entry's own ON is `t.id = att.tag_id`, and the hidden `[m2mJoinTable]` half is\n * `att.author_id = a.id`; only the target's ON references the join table, so reference pruning keeps\n * or drops the pair together. Both are deferred conditions: the join table has no entity metadata, so\n * its alias only exists once the parser registers it.\n */\nclass ManyToManyJoinImpl extends CollectionJoinImpl {\n  constructor(\n    private proxy: any,\n    private field: ManyToManyField,\n  ) {\n    super();\n  }\n\n  protected joinEntry(kind: JoinKind, other: TableFor<Entity>): object {\n    const { joinTableName, columnNames } = this.field;\n    const [ourColumn, otherColumn] = columnNames;\n    const jt = new JoinTableHandle(joinTableName);\n    const ourId = idColumnOf(this.proxy);\n    const otherId = idColumnOf(other);\n    const jtOn = deferredCondition((ctx) => {\n      const jtAlias = ctx.aliasFor(jt);\n      const id = ourId.toSql(ctx);\n      return { sql: `${kqDot(jtAlias, ourColumn)} = ${id.sql}`, bindings: id.bindings, refs: id.refs };\n    });\n    const on = deferredCondition((ctx) => {\n      const jtAlias = ctx.aliasFor(jt);\n      const id = otherId.toSql(ctx);\n      return { sql: `${id.sql} = ${kqDot(jtAlias, otherColumn)}`, bindings: id.bindings, refs: [...id.refs, jtAlias] };\n    });\n    const filtered = this.field.softDeletes !== \"include\";\n    return {\n      [kind]: other,\n      on,\n      [collectionJoin]: filtered,\n      [m2mJoinTable]: { handle: jt, on: jtOn } satisfies M2mJoinTable,\n    };\n  }\n}\n\n/** Fails fast when a join factory is passed something other than a table. */\nfunction requireTable(other: object): TableFor<Entity> {\n  if (!isTable(other)) return fail(`Expected a table to join, got ${other}`);\n  return other;\n}\n\n/** The id column of a joined table, for building sugar ON conditions. */\nfunction idColumnOf(other: object): TableColumn {\n  return (other as any).id;\n}\n\n/** Keeps relation names join-only; physical FK columns retain expression methods. */\nclass ReferenceJoinImpl {\n  constructor(private column: EntityColumnImpl<unknown>) {}\n\n  as(other: object): object {\n    return this.column.as(other);\n  }\n\n  inner(other: object): object {\n    return this.column.inner(other);\n  }\n\n  left(other: object): object {\n    return this.column.left(other);\n  }\n}\n\n/** Identifies domain relationship keys exposed alongside physical columns. */\nfunction isRelation(field: Field | undefined): boolean {\n  return field !== undefined && [\"m2o\", \"poly\", \"o2m\", \"lo2m\", \"m2m\", \"o2o\"].includes(field.kind);\n}\n\n/** Resolves relationship sugar only from domain fields owned by this physical table. */\nfunction physicalRelation(meta: EntityMetadata, key: string): Field | undefined {\n  const owners = [meta, ...getBaseSelfAndSubMetas(getBaseMeta(meta))];\n  const owner = owners.find((owner) => owner.tableName === meta.tableName && Object.hasOwn(owner.fields, key));\n  const field = owner?.fields[key];\n  if (!isRelation(field)) return undefined;\n  // I.e. TaskNew.copiedFrom uses Task's original FK domain, not its specialized TaskNew target.\n  if (field?.kind === \"m2o\" || field?.kind === \"poly\") {\n    if (!field.serde.columns.every((binding) => Object.values(meta.columns).includes(binding.column))) return undefined;\n    return field.kind === \"poly\"\n      ? {\n          ...field,\n          components: field.components.map((component) => ({\n            column: component.column,\n            columnName: component.columnName,\n            otherFieldName: component.otherFieldName,\n            otherMetadata: component.column.idMetadata!,\n          })),\n        }\n      : field;\n  }\n  return field;\n}\n\n/**\n * Maps local domain fields to table-bound conditions, encoding each leaf once.\n * I.e. Author.firstName uses the first_name column but resolves its alias in each query scope.\n * Collections, polymorphic references, and inherited nonlocal fields require explicit expressions.\n */\nfunction tableWhere(mgmt: TableMgmt, filter: object): SqlCondition {\n  const { meta } = mgmt;\n  const conditions: SqlCondition[] = [];\n  if (!filter || typeof filter !== \"object\" || Array.isArray(filter)) {\n    throw new Error(`Expected a domain field filter for ${meta.type}`);\n  }\n  for (const [key, value] of Object.entries(filter)) {\n    // CTI allFields.id points at the base key; the subtype has its own physical key.\n    const field = key === \"id\" ? meta.fields.id : Object.hasOwn(meta.allFields, key) ? meta.allFields[key] : undefined;\n    if (\n      !field ||\n      ![\"primaryKey\", \"primitive\", \"enum\", \"m2o\"].includes(field.kind) ||\n      !field.serde ||\n      field.serde.columns.length !== 1 ||\n      !field.serde.columns.every((binding) => Object.values(meta.columns).includes(binding.column))\n    ) {\n      throw new Error(`Unsupported table filter field ${meta.type}.${key}; use an explicit join`);\n    }\n    const column = new TableColumn(meta, field.serde.columns[0].column, mgmt);\n    let leaves: ParsedValueFilter<unknown>[];\n    if (field.kind === \"m2o\") {\n      if (!isTableReferenceFilter(value)) {\n        throw new Error(`Unsupported table reference filter ${meta.type}.${key}; use an entity or ID`);\n      }\n      const parsed = parseEntityFilter(field.otherMetadata(), value);\n      if (parsed?.kind === \"join\") {\n        throw new Error(`Unsupported table reference filter ${meta.type}.${key}; use an entity or ID`);\n      }\n      leaves = parsed ? [parsed] : [];\n    } else {\n      leaves = parseValueFilter(value);\n    }\n    for (const leaf of leaves) {\n      if (leaf.kind === \"between\" && leaf.value.some((v) => v === undefined)) {\n        if (leaf.value[0] !== undefined) conditions.push(column.addCondition({ kind: \"gte\", value: leaf.value[0] }));\n        if (leaf.value[1] !== undefined) conditions.push(column.addCondition({ kind: \"lte\", value: leaf.value[1] }));\n      } else if (leaf.kind === \"in\" && !column.column.isArray && leaf.value.includes(null)) {\n        conditions.push({\n          or: [\n            column.addCondition({ kind: \"is-null\" }),\n            column.addCondition({ kind: \"in\", value: leaf.value.filter((v) => v !== null) }),\n          ],\n        });\n      } else {\n        conditions.push(column.addCondition(leaf));\n      }\n    }\n  }\n  return conditions.length === 0 ? skipCondition : { and: conditions };\n}\n\n/** Rejects nested relations, scopes, and aliases before parsing owning-reference values. */\nfunction isTableReferenceFilter(value: unknown): boolean {\n  if (value == null || typeof value === \"boolean\" || isTableReferenceValue(value)) return true;\n  if (Array.isArray(value)) return value.every(isTableReferenceValue);\n  if (typeof value === \"object\" && Object.keys(value).length === 1 && Object.hasOwn(value, \"ne\")) {\n    const excluded = (value as { ne: unknown }).ne;\n    return excluded == null || isTableReferenceValue(excluded);\n  }\n  return false;\n}\n\n/** Recognizes an entity or public ID without accepting another filter object. */\nfunction isTableReferenceValue(value: unknown): boolean {\n  return typeof value === \"string\" || typeof value === \"number\" || isEntity(value);\n}\n"],"mappings":"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"}
+{"version":3,"file":"Tables.cjs","names":["isCustomTableDefinition","safeKq","kq","getMetadata","RefExpr","fail","getCustomTableDefinition","BaseExpr","selectKeyBrand","kqDot","toIdOf","mapToDb","deferredCondition","buildValueCondition","isExpr","skipCondition","makeLike","taggedIdPrefix","groupBy","getConstructorFromTaggedId","maybeResolveReferenceToId","asNode","getBaseAndSelfMetas","getBaseSelfAndSubMetas","getBaseMeta","parseEntityFilter","parseValueFilter","isEntity"],"sources":["../../../src/queries/sql/Tables.ts"],"sourcesContent":["import { groupBy } from \"joist-utils\";\n// Load configure first: otherwise the built cjs/esm module graph evaluates relations/* before their\n// base classes exist (\"Class extends value undefined\").\nimport { getConstructorFromTaggedId } from \"src/configure.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport type { IdOf, MaybeAbstractEntityConstructor, TaggedId } from \"src/EntityManager.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type LargeOneToManyField,\n  type ManyToManyField,\n  type OneToManyField,\n  type OneToOneField,\n  type PolymorphicField,\n  type PolymorphicFieldComponent,\n  getBaseAndSelfMetas,\n  getBaseMeta,\n  getBaseSelfAndSubMetas,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { maybeResolveReferenceToId, taggedIdPrefix, toIdOf } from \"src/keys.ts\";\nimport type { SqlCondition } from \"src/queries/conditions.ts\";\nimport type { ParsedValueFilter } from \"src/queries/parsedConditions.ts\";\nimport { buildValueCondition } from \"src/queries/renderConditions.ts\";\nimport { skipCondition } from \"src/queries/skipCondition.ts\";\nimport {\n  type CustomColumnInputs,\n  type CustomTable,\n  type CustomTableDefinition,\n  type CustomTableFor,\n  type CustomTableMgmt,\n  getCustomTableDefinition,\n  isCustomTableDefinition,\n} from \"src/queries/sql/custom.ts\";\nimport {\n  BaseExpr,\n  type Expr,\n  type ExprContext,\n  type ExprLike,\n  type InnerJoin,\n  type LeftJoin,\n  RefExpr,\n  type SqlFragment,\n  asNode,\n  deferredCondition,\n  isExpr,\n  selectKeyBrand,\n} from \"src/queries/sql/Expr.ts\";\nimport { kq, kqDot, safeKq } from \"src/queries/sql/keywords.ts\";\nimport type { QueryArg, QueryJoinInput, QuerySource } from \"src/queries/sql/query.ts\";\nimport { makeLike, mapToDb, parseEntityFilter, parseValueFilter } from \"src/queries/valueFilters.ts\";\nimport type { Column } from \"src/serde/columns.ts\";\nimport type { TypeInfo } from \"src/serde/TypeInfo.ts\";\nimport type { ColumnsOf, FieldsOf, FilterOf, TypeMap, TypeNameOf } from \"src/typeMap.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/** Creates physical column expressions and relationship joins for `T`. */\nexport function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T>;\n/** Creates a typed physical handle for a table declared with `declareTable`. */\nexport function table<TableName extends string, C extends CustomColumnInputs>(\n  definition: CustomTableDefinition<TableName, C>,\n): CustomTable<C, TableName>;\n/**\n * Creates a table with an explicit type-level name, i.e. `table(Author, \"m\")` for a self-join.\n *\n * The name is the table's source key in `em.query`: two bare `table(Author)`s share the key `\"Author\"`,\n * so a left-joined mentor would also mark the mentee's columns nullable; a named alias has its own key.\n */\nexport function table<T extends Entity, Name extends string>(\n  cstr: MaybeAbstractEntityConstructor<T>,\n  name: Name,\n): Table<T, Name>;\n/** Creates a named custom-table handle for joins and self-joins. */\nexport function table<C extends CustomColumnInputs, TableName extends string, Name extends string>(\n  definition: CustomTableDefinition<TableName, C>,\n  name: Name,\n): CustomTable<C, Name>;\nexport function table<T extends Entity>(\n  cstr: MaybeAbstractEntityConstructor<T> | CustomTableDefinition<string, CustomColumnInputs>,\n  _name?: string,\n): unknown {\n  // The name only exists at the type level; the SQL alias is still assigned by the query parser\n  return isCustomTableDefinition(cstr) ? newCustomTableProxy(cstr) : newTableProxy(cstr);\n}\n\n/** Creates multiple physical table handles. */\nexport function tables<T extends readonly MaybeAbstractEntityConstructor<any>[]>(\n  ...type: T\n): { [P in keyof T]: T[P] extends MaybeAbstractEntityConstructor<infer E extends Entity> ? Table<E> : never } {\n  return type.map((t) => newTableProxy(t)) as any;\n}\n\n/**\n * The runtime management interface plus phantom type information for `em.query`.\n *\n * `__entity` lets `QueryRow` recover `T` for entity mode (you cannot `infer T` back out of a mapped\n * type), and `__name` is the table's source key (see `Expr`).\n */\nexport interface TableSourceBrand<Name extends string> extends TableSourceMgmt {\n  readonly __name: Name;\n}\n\n/** A modeled table source that can hydrate its generated entity type. */\nexport interface TableBrand<T, Name extends string> extends TableSourceBrand<Name>, TableMgmt {\n  readonly __entity: T;\n}\n\n/**\n * A physical table for `T`: one expression per SQL column, with relationship names as join factories.\n * Selecting the table itself retains entity hydration; selecting columns returns decoded SQL values.\n *\n * Unlike an Alias, a Table is an explicit SQL source, not a place to bind in an em.find relationship\n * tree. I.e. with `a = table(Author)`, `{ from: a }` registers that handle in the query's scope.\n * Its columns already know their physical column and codec, but their SQL name still depends on the\n * query: the same Author handle might be `a` in one query and `a1` in a nested query.\n *\n * Each predicate occurrence renders through ExprContext.aliasFor using the current scope (or an\n * enclosing scope for a correlation). Rendering returns SQL, ordered bindings, and source references\n * together. A comparison records both sides' references; templates and subqueries carry their\n * references too. Join pruning follows these references and join dependencies, rather than guessing\n * which tables a SQL string mentions. It also accounts for select/order/group expressions and keep.\n *\n * I.e. if a joined Author is used only by `a.firstName.eq(name)`, supplying undefined removes that\n * predicate and lets the unused join prune. Both APIs share this undefined-condition pruning rule;\n * they differ in how they get the references: Alias resolves domain conditions against a relationship\n * tree, while Table renders SQL expressions against explicit sources. Neither caches SQL names on\n * the reusable handle or predicate, so one parse cannot overwrite another parse's bindings.\n *\n * `Name` is the table's type-level source key, defaulting to the entity's own type name, so a\n * LEFT-joined SmallPublisher does not make Publisher columns nullable. `table(Author, \"m\")`\n * gives a self-join table its own key.\n */\nexport type Table<T extends Entity, Name extends string = TableNameOf<T>> = TableShape<T, Name> &\n  (\"where\" extends keyof TableShape<T, Name>\n    ? {}\n    : {\n        /** Builds an AND condition from local domain fields, without implicit joins. */\n        where(filter: TableFilter<T>): SqlCondition;\n      }) &\n  (\"column\" extends keyof TableShape<T, Name>\n    ? {}\n    : {\n        /**\n         * References a column Joist does not model, i.e. `a.column<string>(\"ts_search\")`.\n         *\n         * The expression keeps this table's source key, so it is scope-checked and nullified by a\n         * LEFT join like any modeled column. `R` is unchecked: it asserts what the database returns,\n         * and the value is not decoded through a codec.\n         *\n         * A schema that has its own `column` column or relation keeps that meaning, and then has no\n         * escape hatch for unmodeled columns.\n         */\n        column<R = unknown>(column: string): Expr<R, Name>;\n      });\n\n/** Domain filters for fields stored on this physical table, without relationship traversal. */\nexport type TableFilter<T extends Entity> = {\n  [K in LocalFieldNames<T> & keyof FieldsOf<T>]?: FieldsOf<T>[K] extends {\n    kind: \"m2o\";\n    type: infer U extends Entity;\n    nullable: infer N;\n  }\n    ? TableReferenceFilter<U, N extends undefined ? null : never>\n    : FilterOf<T>[K];\n};\n\n/** Generated column ownership excludes CTI base fields and polymorphic components. */\ntype LocalFieldNames<T> = ColumnsOf<T>[keyof ColumnsOf<T>] extends { fieldName: infer F }\n  ? Extract<F, keyof FilterOf<T>>\n  : never;\n\n/** The owning-reference subset of find filters that only compares a foreign key. */\ntype TableReferenceFilter<T extends Entity, N> =\n  | T\n  | IdOf<T>\n  | readonly (T | IdOf<T>)[]\n  | boolean\n  | N\n  | undefined\n  | { ne: T | IdOf<T> | N | undefined };\n\n/** Maps an entity's columns and relationships to expressions and joins for one typed table handle. */\ntype TableShape<T extends Entity, Name extends string> = {\n  readonly [tableMgmt]: TableBrand<T, Name>;\n} & {\n  // Add typed expressions for each physical column, including its property name for array selects.\n  [P in keyof ColumnsOf<T> & string]: P extends \"id\"\n    ? EntityColumn<T, never, Name, P>\n    : ColumnsOf<T>[P] extends { entity: infer U extends Entity; nullable: infer N }\n      ? ReferenceColumn<U, N extends true ? null : never, Name, P>\n      : ColumnsOf<T>[P] extends { type: infer V; nullable: infer N }\n        ? PrimitiveColumn<V, N extends true ? null : never, Name, P>\n        : never;\n} & {\n  // Add relation join sugar such as `a.books.as(b)` for fields that are not physical columns.\n  [\n    P in keyof FieldsOf<T> as P extends keyof ColumnsOf<T>\n      ? never\n      : FieldsOf<T>[P] extends { kind: \"m2o\" | \"poly\" | \"o2m\" | \"lo2m\" | \"m2m\" | \"o2o\" }\n        ? P\n        : never\n  ]: FieldsOf<T>[P] extends { kind: \"m2o\"; type: infer U extends Entity; nullable: infer N }\n    ? ReferenceJoin<U, N extends undefined ? null : never, Name>\n    : FieldsOf<T>[P] extends { kind: \"poly\"; type: infer U extends Entity; nullable: infer N }\n      ? PolyReference<U, N extends undefined ? null : never, Name>\n      : FieldsOf<T>[P] extends { kind: \"o2m\" | \"lo2m\" | \"m2m\" | \"o2o\"; type: infer U extends Entity }\n        ? CollectionJoin<U>\n        : never;\n} & {\n  // Add subtype join sugar such as `p.smallPublisher(sp)` for entities whose __type root is T.\n  // CTI joins the physical tables by ID; STI self-joins the shared table by ID plus its discriminator.\n  [\n    K in keyof TypeMap as TypeMap[K] extends {\n      entityType: infer U extends Entity & { __type: { 0: TypeNameOf<T>; 1: string } };\n    }\n      ? Uncapitalize<TypeNameOf<U> & string>\n      : never\n  ]: TypeMap[K] extends { entityType: infer U extends Entity } ? SubtypeJoin<U> : never;\n};\n\n/** Keeps explicit base and subtype sources independent, with generic entities untracked. */\ntype TableNameOf<T> = T extends { __type: { 0: string } } ? TypeNameOf<T> & string : string;\n\n/** Provides fluent methods for creating joins through an owning reference relationship. */\nexport interface ReferenceJoin<U extends Entity, N extends null | never, Src extends string = string> {\n  /**\n   * Required reference joins like `b.author.as(a)` are INNER unless `b` is already a LEFT-joined alias.\n   * Nullable references are always LEFT joined.\n   */\n  as<A extends TableFor<U>>(other: A): [N] extends [never] ? DefaultReferenceJoin<A, Src> : LeftJoin<A>;\n  inner<A extends TableFor<U>>(other: A): InnerJoin<A>;\n  left<A extends TableFor<U>>(other: A): LeftJoin<A>;\n}\n\n/** The source of a default reference join, used to inherit optional paths within each query. */\nexport const referenceJoinSource: unique symbol = Symbol(\"joist.referenceJoinSource\");\n\n/** A required reference defaults to INNER unless its source was LEFT joined. */\nexport type DefaultReferenceJoin<A, Src extends string> = InnerJoin<A> & {\n  readonly [referenceJoinSource]: Src;\n};\n\n/** Any table whose entity is (a subtype of) `U`, i.e. what a relation join factory accepts. */\nexport type TableFor<U> = { readonly [tableMgmt]: TableBrand<U, string> };\n\n/**\n * A collection relation (o2m/o2o/m2m) as a join factory: `a.books.as(b)` returns the same\n * `{ left: b, on: ... }` entry the expanded form writes, with the FK condition built from metadata, so\n * join-list inference, nullability, scope checking, and pruning are unchanged and both forms mix freely.\n *\n * `as` binds the joined alias, the same way em.find's `{ books: { as: b } }` does. The default is LEFT\n * (a collection may be empty, and a LEFT join never filters rows, so pruning it is always safe);\n * `.inner(b)` opts into filtering. An m2m entry carries a hidden second join through the join table,\n * which the parser expands; the pair prunes together.\n */\nexport interface CollectionJoin<U extends Entity> {\n  as<A extends TableFor<U>>(other: A): LeftJoin<A>;\n  inner<A extends TableFor<U>>(other: A): InnerJoin<A>;\n  left<A extends TableFor<U>>(other: A): LeftJoin<A>;\n}\n\n/** A named subtype join, defaulting to LEFT because a root row may belong to another subtype. */\ninterface SubtypeJoin<U extends Entity> extends CollectionJoin<U> {\n  <A extends TableFor<U>>(other: A): LeftJoin<A>;\n}\n\n/**\n * A physical FK column expression (`b.authorId` selects/compares the `author_id` FK) plus a join factory\n * (`b.authorId.as(a)` joins). The default join kind follows physical column nullability:\n * a NOT NULL FK is INNER unless its source was LEFT joined, a nullable one is LEFT, and the row type reflects it.\n */\nexport interface ReferenceColumn<\n  U extends Entity,\n  N extends null | never,\n  Src extends string,\n  Key extends string = string,\n>\n  extends EntityColumn<U, N, Src, Key>, ReferenceJoin<U, N, Src> {}\n\n/**\n * A polymorphic reference: condition methods (each resolving the component column from the value), plus\n * a join factory that picks the component from the argument's entity, i.e. `c.parent.as(a)` joins\n * through `parent_author_id`, like an explicit join with `on: c.parent.eq(a.id)`.\n */\nexport interface PolyReference<\n  U extends Entity,\n  N extends null | never,\n  Src extends string = string,\n> extends ReferenceJoin<U, N, Src> {\n  eq(value: U | TaggedId | ExprLike<IdOf<U> | null> | null | undefined): SqlCondition;\n  ne(value: U | TaggedId | ExprLike<IdOf<U> | null> | null | undefined): SqlCondition;\n  in(values: readonly (U | TaggedId)[] | ExprLike<IdOf<U> | null> | undefined): SqlCondition;\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (U | TaggedId)[] | undefined): SqlCondition;\n}\n\nexport interface PrimitiveColumn<\n  V,\n  N extends null | never,\n  Src extends string = string,\n  Key extends string = string,\n> extends Expr<V | N, Src> {\n  readonly [selectKeyBrand]: Key;\n  eq(value: V | ExprLike<V | N> | N | undefined): SqlCondition;\n  ne(value: V | ExprLike<V | N> | N | undefined): SqlCondition;\n  in(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition;\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (V | null)[] | undefined): SqlCondition;\n  nin(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition;\n  gt(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  gte(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  lt(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  lte(value: V | ExprLike<V | N> | undefined): SqlCondition;\n  like(value: V | undefined): SqlCondition;\n  ilike(value: V | undefined): SqlCondition;\n  search(value: V | undefined): SqlCondition;\n  between(v1: V | undefined, v2: V | undefined): SqlCondition;\n  // need to move to ArrayColumn\n  // ...added the `string` to support jsonb contains like `WHERE profile @> '{\"age\": 25}'`\n  // Ideally this would go in a JsonbColumn\n  contains(value: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n  ncontains(value: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n  overlaps(value: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n  noverlaps(value: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition;\n\n  /**\n   * Adds a JSON path existence condition, using the `@?` operator.\n   *\n   * Any values should be embedded directly within the `jsonPath`, because postgres does not\n   * support parameterized JSON path expressions. The entire `jsonPath` is treated as a parameter,\n   * so this is safe from SQL injection.\n   */\n  pathExists(jsonPath: string | undefined): SqlCondition;\n\n  /**\n   * Adds a JSON path predicate condition, using the `@@` operator.\n   *\n   * Any values should be embedded directly within the `jsonPath`, because postgres does not\n   * support parameterized JSON path expressions. The entire `jsonPath` is treated as a parameter,\n   * so this is safe from SQL injection.\n   */\n  pathIsTrue(jsonPath: string | undefined): SqlCondition;\n\n  /**\n   * Add `exp` to the query, which should include the operator & expression and any\n   * bound parameters (but not include the column name).\n   *\n   * We use knex-style placeholders, i.e. `?` and `\\\\?` to escape question marks, i.e.\n   *\n   * ```ts\n   * a.address.raw(\"@\\\\? ?\", ['$.street ? (@ == \"rr2\")'])`\n   * ```\n   */\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;\n}\n\nexport interface EntityColumn<\n  T,\n  N extends null | never = never,\n  Src extends string = string,\n  Key extends string = string,\n> extends Expr<IdOf<T> | N, Src> {\n  readonly [selectKeyBrand]: Key;\n  /** Produces the tagged ID as SQL text, preserving NULL and the column's source. */\n  taggedId(): Expr<string | N, Src>;\n  eq(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  ne(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  // Adding `| null` for GraphQL support\n  in<\n    F extends QuerySource,\n    const S extends ExprLike<IdOf<T> | null>,\n    J extends QueryJoinInput = [],\n    Name extends string = \"?\",\n  >(\n    value: QueryArg<F, S, J, Name>,\n  ): SqlCondition;\n  in(value: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  /** Applies an IN condition unless the list is empty, null, or undefined. */\n  inNonEmpty(value: readonly (T | IdOf<T> | null)[] | null | undefined): SqlCondition;\n  nin(value: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  gt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  gte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  lt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  lte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;\n}\n\nexport const tableMgmt = Symbol(\"tableMgmt\");\nexport const inQueryCondition: unique symbol = Symbol(\"joist.inQueryCondition\");\n\n/** Defers a direct IN query literal to query.ts, which owns query pruning and SQL generation. */\nexport interface InQueryCondition {\n  readonly [inQueryCondition]: { column: BaseExpr; query: object };\n}\n\nexport function getTableMgmt<T extends Entity>(table: TableFor<T>): TableMgmt;\nexport function getTableMgmt(table: CustomTableFor): CustomTableMgmt;\nexport function getTableMgmt(table: TableFor<Entity> | CustomTableFor): TableSourceMgmt;\nexport function getTableMgmt(table: TableFor<Entity> | CustomTableFor): TableSourceMgmt {\n  return table[tableMgmt];\n}\n\n/** The identity SQL queries bind a table by, plus its original entity metadata. */\nexport interface TableSourceMgmt {\n  tableName: string;\n  schema?: string;\n}\n\n/** Qualifies custom tables without changing SQL for tables on the default search path. */\nexport function tableSqlName(table: TableSourceMgmt): string {\n  return table.schema ? `${safeKq(table.schema)}.${kq(table.tableName)}` : kq(table.tableName);\n}\n\n/** The identity and generated metadata of a modeled entity table. */\nexport interface TableMgmt extends TableSourceMgmt {\n  /**\n   * The metadata this table was created with, i.e. `table(TaskNew)` keeps `taskNewMeta`.\n   *\n   * It cannot be re-derived from `tableName`: STI subtypes share their base's table (`Task`, `TaskNew`,\n   * and `TaskOld` are all `tasks`), so a `getMetadataForTable(\"tasks\")` lookup can only return the base\n   * `Task`, and the alias would lose its subtype identity for explicit subtype joins and entity hydration.\n   */\n  meta: EntityMetadata;\n}\n\n/** Returns the metadata for the entity that `table` is bound to. */\nexport function getTableMetadata<T extends Entity>(table: TableFor<T>): EntityMetadata<T> {\n  const mgmt = table[tableMgmt];\n  return mgmt.meta as EntityMetadata<T>;\n}\n\nexport function newTableProxy<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T> {\n  const meta = getMetadata(cstr);\n  // The identity SQL queries bind to a source, retaining STI subtype metadata.\n  const mgmt: TableMgmt = { tableName: meta.tableName, meta };\n  const subtypes = new Map(meta.subTypes.map((m) => [m.type[0].toLowerCase() + m.type.slice(1), m]));\n  const proxy: any = new Proxy(cstr, {\n    /** Create a physical column expression or a relation join factory. */\n    get(_, key: PropertyKey): any {\n      if (key === tableMgmt) {\n        return mgmt;\n      }\n      if (typeof key !== \"string\") return undefined;\n      const descriptor = Object.hasOwn(meta.columns, key) ? meta.columns[key] : undefined;\n      if (descriptor) {\n        return descriptor.idMetadata\n          ? new EntityColumnImpl(meta, descriptor, mgmt, key)\n          : new PrimitiveColumnImpl(meta, descriptor, mgmt, key);\n      }\n      const subtype = subtypes.get(key);\n      if (subtype) {\n        const join = new SubtypeJoinImpl(proxy, subtype);\n        return Object.assign(join.as.bind(join), {\n          as: join.as.bind(join),\n          inner: join.inner.bind(join),\n          left: join.left.bind(join),\n        });\n      }\n      const relation = physicalRelation(meta, key);\n      if (key === \"where\" && !isRelation(meta.allFields[key])) {\n        return (filter: TableFilter<T>) => tableWhere(mgmt, filter);\n      }\n      if (key === \"column\" && !isRelation(meta.allFields[key])) {\n        return (column: string) => new RefExpr(mgmt, column);\n      }\n      const field = relation ?? fail(`No physical field ${key} on ${cstr.name}; join its base table explicitly`);\n      switch (field.kind) {\n        case \"m2o\":\n          return new ReferenceJoinImpl(new EntityColumnImpl(meta, field.serde.columns[0].column, mgmt));\n        case \"poly\":\n          return new PolyReferenceImpl(meta, mgmt, field);\n        case \"o2m\":\n        case \"o2o\":\n        case \"lo2m\":\n          return new OneToManyJoinImpl(proxy, field);\n        case \"m2m\":\n          return new ManyToManyJoinImpl(proxy, field);\n        default:\n          throw new Error(`Unsupported table field kind ${field.kind}`);\n      }\n    },\n\n    has(_, key) {\n      return (\n        key === tableMgmt ||\n        (typeof key === \"string\" &&\n          (key === \"where\" ||\n            key === \"column\" ||\n            Object.hasOwn(meta.columns, key) ||\n            !!physicalRelation(meta, key) ||\n            subtypes.has(key)))\n      );\n    },\n  });\n  return proxy;\n}\n\n/** Creates a typed handle for primitive columns declared outside Joist codegen. */\nfunction newCustomTableProxy<TableName extends string, C extends CustomColumnInputs>(\n  definition: CustomTableDefinition<TableName, C>,\n): CustomTable<C, TableName> {\n  const { tableName, schema, columns } = getCustomTableDefinition(definition);\n  const mgmt: CustomTableMgmt = { tableName, schema, columns };\n  return new Proxy(\n    {},\n    {\n      get(_, key: PropertyKey): unknown {\n        if (key === tableMgmt) return mgmt;\n        if (typeof key !== \"string\") return undefined;\n        const descriptor = Object.hasOwn(columns, key) ? columns[key] : undefined;\n        if (descriptor) return new PrimitiveColumnImpl(undefined, descriptor, mgmt, key);\n        if (key === \"column\") return (column: string) => new RefExpr(mgmt, column);\n        return fail(`Custom table ${tableName} has no declared column ${key}; use .column(\"${key}\")`);\n      },\n      has(_, key): boolean {\n        return key === tableMgmt || key === \"column\" || (typeof key === \"string\" && Object.hasOwn(columns, key));\n      },\n    },\n  ) as CustomTable<C, TableName>;\n}\n\nexport function isTable(obj: unknown): obj is Table<any, any> | CustomTableFor {\n  return (typeof obj === \"function\" || (typeof obj === \"object\" && obj !== null)) && tableMgmt in obj;\n}\n\n/** Whether a physical table has generated entity metadata. */\nexport function isEntityTable(obj: unknown): obj is Table<any, any> {\n  return isTable(obj) && \"meta\" in obj[tableMgmt];\n}\n\n/** Whether a physical table has columns declared through `declareTable`. */\nexport function isCustomTable(obj: unknown): obj is CustomTableFor {\n  return isTable(obj) && \"columns\" in obj[tableMgmt];\n}\n\n/**\n * A physical table column implements `Expr`: it renders as `alias.\"column\"`, decodes result\n * values through the column's shared scalar codec, and inherits aggregate methods from `BaseExpr`.\n */\nclass TableColumn extends BaseExpr {\n  public constructor(\n    readonly meta: EntityMetadata | undefined,\n    readonly column: Column,\n    readonly mgmt: TableSourceMgmt,\n    private readonly selectKey: string = column.columnName,\n  ) {\n    super();\n  }\n\n  get [selectKeyBrand](): string {\n    return this.selectKey;\n  }\n\n  /** Author.id, Book.authorId, and Comment.parentAuthorId use the same Author ID domain. */\n  get outputType(): TypeInfo | undefined {\n    return this.column.outputType;\n  }\n\n  get sqlNullable(): boolean | undefined {\n    return this.column.sqlNullable;\n  }\n\n  get sqlSource(): object {\n    return this.mgmt;\n  }\n\n  toSql(ctx: ExprContext): SqlFragment {\n    const alias = ctx.aliasFor(this.mgmt);\n    return { sql: kqDot(alias, this.column.columnName), bindings: [], refs: [alias] };\n  }\n\n  /** Decodes result-set values with public PK/FK ids, while hydration keeps internal tagged ids. */\n  decode(value: unknown): unknown {\n    if (value === null || value === undefined) return value;\n    const idMeta = this.idMetadata;\n    if (idMeta) return toIdOf(idMeta, this.column.mapFromDb(value) as TaggedId | undefined);\n    return this.column.mapFromDb(value);\n  }\n\n  encode(value: unknown): unknown {\n    return this.column.mapToDb(value);\n  }\n\n  /** Identifies the ID domain of a primary key, FK, or physical polymorphic component. */\n  get idMetadata(): EntityMetadata | undefined {\n    return this.column.idMetadata?.();\n  }\n\n  /** Encodes literals when the condition is created and renders with each query's aliases. */\n  addCondition(value: ParsedValueFilter<unknown>): SqlCondition {\n    const encoded = mapToDb(this.column, value);\n    return deferredCondition((ctx) => {\n      const left = this.toSql(ctx);\n      const [sql, bindings] = buildValueCondition(left.sql, encoded);\n      return { sql, bindings: [...left.bindings, ...bindings], refs: left.refs };\n    });\n  }\n\n  /** Renders raw operators against the same quoted column SQL as other expressions. */\n  protected addRawCondition(exp: string, bindings: readonly any[]): SqlCondition {\n    return deferredCondition((ctx) => {\n      const left = this.toSql(ctx);\n      return { sql: `${left.sql} ${exp}`, bindings: [...left.bindings, ...bindings], refs: left.refs };\n    });\n  }\n\n  /** Uses column filter conversions for literals and shared comparisons for expressions and null equality. */\n  protected compare(op: string, value: unknown): SqlCondition {\n    if (value === undefined || isExpr(value) || (value === null && (op === \"=\" || op === \"!=\"))) {\n      return super.compare(op, value);\n    }\n    // Primitive relational comparisons historically bind null through mapToDb.\n    const kind = ({ \"=\": \"eq\", \"!=\": \"ne\", \">\": \"gt\", \">=\": \"gte\", \"<\": \"lt\", \"<=\": \"lte\" } as const)[op];\n    if (!kind) return fail(`Invalid operator ${op}`);\n    return this.addCondition({ kind, value });\n  }\n\n  /**\n   * Compares this column to another expression.\n   *\n   * Table columns, aggregates, subquery columns, and `sql` templates use the expression context\n   * to render their complete SQL.\n   * Negated array operators wrap the complete comparison in NOT.\n   */\n  protected compareToExpr(op: string, value: ExprLike<any>, negate = false): SqlCondition {\n    if (negate) {\n      return deferredCondition((ctx) => {\n        const comparison = ctx.conditionToSql(this.compareToExpr(op, value))!;\n        return { ...comparison, sql: `NOT (${comparison.sql})` };\n      });\n    }\n    return super.compare(op, value);\n  }\n}\n\nclass PrimitiveColumnImpl<V, N extends null | never> extends TableColumn implements PrimitiveColumn<V, N> {\n  between(v1: V | undefined, v2: V | undefined): SqlCondition {\n    if (v1 === undefined || v2 === undefined) return skipCondition;\n    return this.addCondition({ kind: \"between\", value: [v1, v2] });\n  }\n\n  like(value: V | undefined): SqlCondition {\n    if (value === undefined) return skipCondition;\n    return this.addCondition({ kind: \"like\", value });\n  }\n\n  ilike(value: V | undefined): SqlCondition {\n    if (value === undefined) return skipCondition;\n    return this.addCondition({ kind: \"ilike\", value });\n  }\n\n  search(value: V | undefined): SqlCondition {\n    // Check !value so that empty strings are pruned\n    if (!value) return skipCondition;\n    return this.addCondition({ kind: \"ilike\", value: makeLike(value) });\n  }\n\n  in(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition {\n    if (values === undefined) return skipCondition;\n    if (isExpr(values)) return this.inList(\"IN\", values);\n    if (values.includes(null)) {\n      const isNull = this.addCondition({ kind: \"is-null\" });\n      const hasValue = this.addCondition({ kind: \"in\", value: values.filter((v) => v !== null) });\n      return { or: [isNull, hasValue] };\n    } else {\n      return this.addCondition({ kind: \"in\", value: values as V[] });\n    }\n  }\n\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (V | null)[] | undefined): SqlCondition {\n    return values === undefined || values.length === 0 ? skipCondition : this.in(values);\n  }\n\n  nin(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition {\n    if (values === undefined) return skipCondition;\n    if (isExpr(values)) return this.inList(\"NOT IN\", values);\n    return this.addCondition({ kind: \"nin\", value: values.filter((v) => v !== null) as V[] });\n  }\n\n  // V will already be an array\n  contains(v1: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"@>\", v1);\n    return this.addCondition({ kind: \"contains\", value: v1 as any });\n  }\n\n  // V will already be an array\n  ncontains(v1: string | V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"@>\", v1, true);\n    return this.addCondition({ kind: \"ncontains\", value: v1 as any });\n  }\n\n  // V will already be an array\n  overlaps(v1: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"&&\", v1);\n    return this.addCondition({ kind: \"overlaps\", value: v1 as any });\n  }\n\n  noverlaps(v1: V | PrimitiveColumn<V, any> | N | undefined): SqlCondition {\n    if (v1 === undefined) return skipCondition;\n    if (isExpr(v1)) return this.compareToExpr(\"&&\", v1, true);\n    return this.addCondition({ kind: \"noverlaps\", value: v1 as any });\n  }\n\n  pathExists(jsonPath: string | undefined): SqlCondition {\n    if (jsonPath === undefined) return skipCondition;\n    return this.addCondition({ kind: \"jsonPathExists\", value: jsonPath });\n  }\n\n  pathIsTrue(jsonPath: string | undefined): SqlCondition {\n    if (jsonPath === undefined) return skipCondition;\n    return this.addCondition({ kind: \"jsonPathPredicate\", value: jsonPath });\n  }\n\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition {\n    if (bindings === undefined) return skipCondition;\n    return this.addRawCondition(exp, bindings);\n  }\n}\n\nclass EntityColumnImpl<T> extends TableColumn implements EntityColumn<T> {\n  /** Uses the ID target's tag, including for foreign keys and polymorphic components. */\n  taggedId(): Expr<string, string> {\n    return new TaggedIdExpr(this) as unknown as Expr<string, string>;\n  }\n\n  in<\n    F extends QuerySource,\n    const S extends ExprLike<IdOf<T> | null>,\n    J extends QueryJoinInput = [],\n    Name extends string = \"?\",\n  >(values: QueryArg<F, S, J, Name>): SqlCondition;\n  in(values: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;\n  in(values: object | readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    if (values === undefined) {\n      return skipCondition;\n    } else if (values === null) {\n      throw new Error(\"Unsupported\");\n    } else if (isExpr(values)) {\n      return this.inList(\"IN\", values);\n    } else if (!Array.isArray(values)) {\n      return { [inQueryCondition]: { column: this, query: values } } as unknown as SqlCondition;\n    } else if (values.includes(null)) {\n      // Like `PrimitiveColumn.in`, split `[a1, null]` into `IS NULL OR IN (...)`\n      const isNull = this.addCondition({ kind: \"is-null\" });\n      const hasValue = this.addCondition({ kind: \"in\", value: values.filter((v) => v !== null) as any });\n      return { or: [isNull, hasValue] };\n    } else {\n      return this.addCondition({ kind: \"in\", value: values as any });\n    }\n  }\n\n  /** Applies an IN condition unless the list is empty, null, or undefined. */\n  inNonEmpty(values: readonly (T | IdOf<T> | null)[] | null | undefined): SqlCondition {\n    return values === null || values === undefined || values.length === 0 ? skipCondition : this.in(values);\n  }\n\n  nin(values: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    if (values === undefined) {\n      return skipCondition;\n    } else if (values === null) {\n      throw new Error(\"Unsupported\");\n    } else if (isExpr(values)) {\n      return this.inList(\"NOT IN\", values);\n    } else {\n      return this.addCondition({ kind: \"nin\", value: values.filter((v) => v !== null) as any });\n    }\n  }\n\n  gt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\">\", \"gt\", value);\n  }\n\n  gte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\">=\", \"gte\", value);\n  }\n\n  lt(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\"<\", \"lt\", value);\n  }\n\n  lte(value: IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.compareId(\"<=\", \"lte\", value);\n  }\n\n  raw(exp: string, bindings: readonly any[] | undefined): SqlCondition {\n    if (bindings === undefined) return skipCondition;\n    return this.addRawCondition(exp, bindings);\n  }\n\n  /** Joins via this FK, inheriting the source's LEFT join for otherwise required references. */\n  as(other: object): object {\n    return {\n      ...this.joinEntry(this.sqlNullable === false ? \"inner\" : \"left\", other),\n      [referenceJoinSource]: this.mgmt,\n    };\n  }\n\n  inner(other: object): object {\n    return this.joinEntry(\"inner\", other);\n  }\n\n  left(other: object): object {\n    return this.joinEntry(\"left\", other);\n  }\n\n  private joinEntry(kind: JoinKind, other: object): object {\n    return { [kind]: requireTable(other), on: this.eq(idColumnOf(other)) };\n  }\n\n  private compareId(op: string, kind: \"gt\" | \"gte\" | \"lt\" | \"lte\", value: unknown): SqlCondition {\n    if (value === undefined) return skipCondition;\n    if (value === null) throw new Error(\"Unsupported\");\n    if (isExpr(value)) return this.compareToExpr(op, value);\n    return this.addCondition({ kind, value: value as any });\n  }\n}\n\n/** Converts a physical ID to SQL text so nested SQL expressions also receive the tag. */\nclass TaggedIdExpr extends BaseExpr {\n  constructor(private column: TableColumn) {\n    super();\n  }\n\n  toSql(ctx: ExprContext): SqlFragment {\n    const fragment = this.column.toSql(ctx);\n    const meta = this.column.idMetadata ?? fail(\"Tagged IDs require an ID column\");\n    return {\n      ...fragment,\n      sql: `(? || ${fragment.sql}::text)`,\n      bindings: [taggedIdPrefix(meta), ...fragment.bindings],\n    };\n  }\n\n  get outputType(): TypeInfo {\n    return { dbType: \"text\", domain: String, arrayElementSafe: true };\n  }\n\n  get sqlNullable(): boolean | undefined {\n    return this.column.sqlNullable;\n  }\n\n  get sqlSource(): object {\n    return this.column.sqlSource;\n  }\n}\n\nclass PolyReferenceImpl<T extends Entity> {\n  public constructor(\n    private meta: EntityMetadata,\n    private mgmt: TableMgmt,\n    private field: PolymorphicField,\n  ) {}\n\n  /** Compares to a tagged id, an entity, or another table's id column, which picks the component (`c.parent.eq(a.id)`). */\n  eq(value: T | TaggedId | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.addEqOrNe(\"eq\", value);\n  }\n\n  ne(value: T | TaggedId | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition {\n    return this.addEqOrNe(\"ne\", value);\n  }\n\n  // We required tagged ids for polys\n  in(values: readonly (T | TaggedId)[] | ExprLike<IdOf<T> | null> | undefined): SqlCondition {\n    if (values === undefined) return skipCondition;\n    if (isExpr(values)) return this.inSubquery(values);\n    // Split up the ids by constructor\n    const idsByConstructor = groupBy(values, (id) => getConstructorFromTaggedId(maybeResolveReferenceToId(id)!).name);\n    // Or together `parent_book_id in (1,2,3) OR parent_author_id IN (4,5,6)`\n    return {\n      or: Object.entries(idsByConstructor).map(([cstrName, ids]) => {\n        const comp =\n          this.field.components.find((p) => p.otherMetadata().cstr.name === cstrName) ??\n          fail(`No component for ${cstrName}`);\n        return this.componentColumn(comp).addCondition({ kind: \"in\", value: ids });\n      }),\n    };\n  }\n\n  /** Applies an IN condition unless the list is empty or undefined. */\n  inNonEmpty(values: readonly (T | TaggedId)[] | undefined): SqlCondition {\n    return values === undefined || values.length === 0 ? skipCondition : this.in(values);\n  }\n\n  /** Joins via this poly's component, inheriting the source's LEFT join when the poly is required. */\n  as(other: object): object {\n    return { ...this.joinEntry(this.field.required ? \"inner\" : \"left\", other), [referenceJoinSource]: this.mgmt };\n  }\n\n  inner(other: object): object {\n    return this.joinEntry(\"inner\", other);\n  }\n\n  left(other: object): object {\n    return this.joinEntry(\"left\", other);\n  }\n\n  private joinEntry(kind: JoinKind, other: object): object {\n    return { [kind]: requireTable(other), on: this.eq(idColumnOf(other) as any) };\n  }\n\n  /**\n   * i.e. `c.parent.in(query({ from: a, ..., select: a.id }))`: like `eq` against a table column, the\n   * subquery's agreed ID domain picks the component, i.e. authors pick `parent_author_id`.\n   */\n  private inSubquery(values: ExprLike<any>): SqlCondition {\n    // Only actual subqueries expose this getter; importing query.ts would create a load-order cycle.\n    const selected = asNode(values).subquerySelect;\n    const outputType = selected?.outputType;\n    let otherMeta = outputType?.idMeta;\n    if (!otherMeta) {\n      // Ordinary reads can select an unknown key serde. Compounds validate codecs before exposing a select.\n      if (!outputType && selected instanceof TableColumn) {\n        otherMeta = selected.idMetadata;\n      }\n      if (!otherMeta) {\n        return fail(\n          selected instanceof TableColumn\n            ? `${this.field.fieldName} \\`in\\` needs an id or FK column, got ${selected.column.columnName}`\n            : `${this.field.fieldName} is polymorphic, so \\`in\\` needs a subquery selecting an id or FK column`,\n        );\n      }\n    }\n    const comp =\n      this.field.components.find((p) => getBaseAndSelfMetas(otherMeta).includes(p.otherMetadata())) ??\n      fail(`${this.field.fieldName} has no component for ${otherMeta.type}`);\n    return this.componentColumn(comp).in(values);\n  }\n\n  private addEqOrNe(\n    kind: \"eq\" | \"ne\",\n    value: T | TaggedId | ExprLike<IdOf<T> | null> | null | undefined,\n  ): SqlCondition {\n    if (value === undefined) {\n      return skipCondition;\n    } else if (value instanceof TableColumn) {\n      // Joining through the poly, i.e. `c.parent.eq(a.id)`: the other table column's ID domain picks the component\n      const otherMeta = value.idMetadata ?? fail(`${this.field.fieldName} needs an id or FK column`);\n      const comp =\n        this.field.components.find((p) => getBaseAndSelfMetas(otherMeta).includes(p.otherMetadata())) ??\n        fail(`${this.field.fieldName} has no component for ${otherMeta.type}`);\n      return this.componentColumn(comp)[kind](value);\n    } else if (isExpr(value)) {\n      return fail(\n        `${this.field.fieldName} is polymorphic, so it can only be compared to tagged ids or entity table columns`,\n      );\n    } else if (value === null) {\n      // We can AND each of the components as many conditions\n      const value = kind === \"eq\" ? ({ kind: \"is-null\" } as const) : ({ kind: \"not-null\" } as const);\n      return {\n        and: this.field.components.map((p) => this.componentColumn(p).addCondition(value)),\n      };\n    } else {\n      // If we have a value, we can find the component\n      const comp =\n        this.field.components.find(\n          (p) => p.otherMetadata().cstr === getConstructorFromTaggedId(maybeResolveReferenceToId(value) as string),\n        ) || fail(`Could not find component for ${value}`);\n      return this.componentColumn(comp)[kind](value);\n    }\n  }\n\n  /** Returns the physical FK expression for one polymorphic target. */\n  private componentColumn(comp: PolymorphicFieldComponent): EntityColumnImpl<T> {\n    const descriptor = comp.column;\n    return new EntityColumnImpl<T>(this.meta, descriptor, this.mgmt);\n  }\n}\n\n/**\n * Marks a sugar join entry whose target is a *collection* (o2m/m2m), which filter soft-deletes like\n * em.find's \"collections filter out soft-deletes, but m2o/o2o references still return them\"; see\n * `QueryParser.addSoftDeleteCondition`'s call site. Reference joins and explicit joins are unmarked.\n */\nexport const collectionJoin: unique symbol = Symbol(\"joist.collectionJoin\");\n\n/** Marks a sugar m2m join entry (`a.tags.as(t)`) with its hidden join-table join; `parseQuery` expands it. */\nexport const m2mJoinTable: unique symbol = Symbol(\"joist.m2mJoinTable\");\n\nexport interface M2mJoinTable {\n  handle: JoinTableHandle;\n  on: SqlCondition;\n}\n\n/** The runtime identity of an m2m join table in a query, i.e. `authors_to_tags`; it has no entity. */\nexport class JoinTableHandle {\n  constructor(readonly joinTableName: string) {}\n}\n\ntype JoinKind = \"inner\" | \"left\";\n\n/**\n * The `as`/`inner`/`left` join factory for collection relations, i.e. `a.books.as(b)` joins with the\n * relation's default kind (LEFT: a collection may be empty) and `.inner`/`.left` override. m2o/poly\n * relations implement the same three methods on their join factories. Physical FKs such as\n * `b.author_id` are expressions that also expose a join factory.\n */\nabstract class CollectionJoinImpl {\n  as(other: object): object {\n    return this.joinEntry(\"left\", requireTable(other));\n  }\n\n  inner(other: object): object {\n    return this.joinEntry(\"inner\", requireTable(other));\n  }\n\n  left(other: object): object {\n    return this.joinEntry(\"left\", requireTable(other));\n  }\n\n  protected abstract joinEntry(kind: JoinKind, other: TableFor<Entity>): object;\n}\n\n/** Joins a named subtype explicitly; only STI subtype sugar adds a discriminator to its ON. */\nclass SubtypeJoinImpl extends CollectionJoinImpl {\n  constructor(\n    private proxy: TableFor<Entity>,\n    private subtype: EntityMetadata,\n  ) {\n    super();\n  }\n\n  protected joinEntry(kind: JoinKind, other: TableFor<Entity>): object {\n    if (getTableMetadata(other) !== this.subtype) {\n      return fail(`Expected table(${this.subtype.type}) for the explicit subtype join`);\n    }\n    const on = idColumnOf(this.proxy).eq(idColumnOf(other));\n    if (this.subtype.inheritanceType !== \"sti\" || this.subtype.stiDiscriminatorValue === undefined) {\n      return { [kind]: other, on };\n    }\n    const base = this.subtype.baseTypes.find((m) => m.stiDiscriminatorField !== undefined)!;\n    const columnName = base.fields[base.stiDiscriminatorField!].serde!.columns[0].columnName;\n    // Discriminator values are database enum ids, not domain enum values to pass through the field codec.\n    const discriminator = deferredCondition((ctx) => {\n      const alias = ctx.aliasFor(other[tableMgmt]);\n      return {\n        sql: `${kqDot(alias, columnName)} = ?`,\n        bindings: [this.subtype.stiDiscriminatorValue],\n        refs: [alias],\n      };\n    });\n    return { [kind]: other, on: { and: [on, discriminator] } };\n  }\n}\n\n/** An o2m/lo2m/o2o relation: the ON is the other side's FK (an m2o or a poly component) back to our id. */\nclass OneToManyJoinImpl extends CollectionJoinImpl {\n  constructor(\n    private proxy: any,\n    private field: OneToManyField | LargeOneToManyField | OneToOneField,\n  ) {\n    super();\n  }\n\n  protected joinEntry(kind: JoinKind, other: TableFor<Entity>): object {\n    const { field } = this;\n    const otherMeta = getTableMetadata(other);\n    const descriptor = Object.values(otherMeta.columns).find((column) => column.columnName === field.otherColumnName);\n    if (!descriptor) {\n      return fail(\n        `Cannot join ${getTableMetadata(this.proxy).type}.${field.fieldName} to ${otherMeta.type}: ` +\n          `${field.otherColumnName} is not physically present on ${otherMeta.tableName}; join the base table explicitly`,\n      );\n    }\n    const column = new EntityColumnImpl(otherMeta, descriptor, other[tableMgmt]);\n    const on = column.eq(this.proxy.id);\n    // Collections (o2m/lo2m) filter soft-deletes like em.find; o2o references resolve them\n    const filtered = field.kind === \"o2m\" ? field.softDeletes !== \"include\" : field.kind === \"lo2m\";\n    return { [kind]: other, on, [collectionJoin]: filtered };\n  }\n}\n\n/**\n * An m2m relation, i.e. `a.tags.as(t)`.\n *\n * The entry's own ON is `t.id = att.tag_id`, and the hidden `[m2mJoinTable]` half is\n * `att.author_id = a.id`; only the target's ON references the join table, so reference pruning keeps\n * or drops the pair together. Both are deferred conditions: the join table has no entity metadata, so\n * its alias only exists once the parser registers it.\n */\nclass ManyToManyJoinImpl extends CollectionJoinImpl {\n  constructor(\n    private proxy: any,\n    private field: ManyToManyField,\n  ) {\n    super();\n  }\n\n  protected joinEntry(kind: JoinKind, other: TableFor<Entity>): object {\n    const { joinTableName, columnNames } = this.field;\n    const [ourColumn, otherColumn] = columnNames;\n    const jt = new JoinTableHandle(joinTableName);\n    const ourId = idColumnOf(this.proxy);\n    const otherId = idColumnOf(other);\n    const jtOn = deferredCondition((ctx) => {\n      const jtAlias = ctx.aliasFor(jt);\n      const id = ourId.toSql(ctx);\n      return { sql: `${kqDot(jtAlias, ourColumn)} = ${id.sql}`, bindings: id.bindings, refs: id.refs };\n    });\n    const on = deferredCondition((ctx) => {\n      const jtAlias = ctx.aliasFor(jt);\n      const id = otherId.toSql(ctx);\n      return { sql: `${id.sql} = ${kqDot(jtAlias, otherColumn)}`, bindings: id.bindings, refs: [...id.refs, jtAlias] };\n    });\n    const filtered = this.field.softDeletes !== \"include\";\n    return {\n      [kind]: other,\n      on,\n      [collectionJoin]: filtered,\n      [m2mJoinTable]: { handle: jt, on: jtOn } satisfies M2mJoinTable,\n    };\n  }\n}\n\n/** Fails fast when a join factory is passed something other than a table. */\nfunction requireTable(other: object): TableFor<Entity> {\n  if (!isEntityTable(other)) return fail(`Expected an entity table to join, got ${other}`);\n  return other;\n}\n\n/** The id column of a joined table, for building sugar ON conditions. */\nfunction idColumnOf(other: object): TableColumn {\n  return (other as any).id;\n}\n\n/** Keeps relation names join-only; physical FK columns retain expression methods. */\nclass ReferenceJoinImpl {\n  constructor(private column: EntityColumnImpl<unknown>) {}\n\n  as(other: object): object {\n    return this.column.as(other);\n  }\n\n  inner(other: object): object {\n    return this.column.inner(other);\n  }\n\n  left(other: object): object {\n    return this.column.left(other);\n  }\n}\n\n/** Identifies domain relationship keys exposed alongside physical columns. */\nfunction isRelation(field: Field | undefined): boolean {\n  return field !== undefined && [\"m2o\", \"poly\", \"o2m\", \"lo2m\", \"m2m\", \"o2o\"].includes(field.kind);\n}\n\n/** Resolves relationship sugar only from domain fields owned by this physical table. */\nfunction physicalRelation(meta: EntityMetadata, key: string): Field | undefined {\n  const owners = [meta, ...getBaseSelfAndSubMetas(getBaseMeta(meta))];\n  const owner = owners.find((owner) => owner.tableName === meta.tableName && Object.hasOwn(owner.fields, key));\n  const field = owner?.fields[key];\n  if (!isRelation(field)) return undefined;\n  // I.e. TaskNew.copiedFrom uses Task's original FK domain, not its specialized TaskNew target.\n  if (field?.kind === \"m2o\" || field?.kind === \"poly\") {\n    if (!field.serde.columns.every((binding) => Object.values(meta.columns).includes(binding.column))) return undefined;\n    return field.kind === \"poly\"\n      ? {\n          ...field,\n          components: field.components.map((component) => ({\n            column: component.column,\n            columnName: component.columnName,\n            otherFieldName: component.otherFieldName,\n            otherMetadata: component.column.idMetadata!,\n          })),\n        }\n      : field;\n  }\n  return field;\n}\n\n/**\n * Maps local domain fields to table-bound conditions, encoding each leaf once.\n * I.e. Author.firstName uses the first_name column but resolves its alias in each query scope.\n * Collections, polymorphic references, and inherited nonlocal fields require explicit expressions.\n */\nexport function tableWhere(mgmt: TableMgmt, filter: object): SqlCondition {\n  const { meta } = mgmt;\n  const conditions: SqlCondition[] = [];\n  if (!filter || typeof filter !== \"object\" || Array.isArray(filter)) {\n    throw new Error(`Expected a domain field filter for ${meta.type}`);\n  }\n  for (const [key, value] of Object.entries(filter)) {\n    // CTI allFields.id points at the base key; the subtype has its own physical key.\n    const field = key === \"id\" ? meta.fields.id : Object.hasOwn(meta.allFields, key) ? meta.allFields[key] : undefined;\n    if (\n      !field ||\n      ![\"primaryKey\", \"primitive\", \"enum\", \"m2o\"].includes(field.kind) ||\n      !field.serde ||\n      field.serde.columns.length !== 1 ||\n      !field.serde.columns.every((binding) => Object.values(meta.columns).includes(binding.column))\n    ) {\n      throw new Error(`Unsupported table filter field ${meta.type}.${key}; use an explicit join`);\n    }\n    const column = new TableColumn(meta, field.serde.columns[0].column, mgmt);\n    let leaves: ParsedValueFilter<unknown>[];\n    if (field.kind === \"m2o\") {\n      if (!isTableReferenceFilter(value)) {\n        throw new Error(`Unsupported table reference filter ${meta.type}.${key}; use an entity or ID`);\n      }\n      const parsed = parseEntityFilter(field.otherMetadata(), value);\n      if (parsed?.kind === \"join\") {\n        throw new Error(`Unsupported table reference filter ${meta.type}.${key}; use an entity or ID`);\n      }\n      leaves = parsed ? [parsed] : [];\n    } else {\n      leaves = parseValueFilter(value);\n    }\n    for (const leaf of leaves) {\n      if (leaf.kind === \"between\" && leaf.value.some((v) => v === undefined)) {\n        if (leaf.value[0] !== undefined) conditions.push(column.addCondition({ kind: \"gte\", value: leaf.value[0] }));\n        if (leaf.value[1] !== undefined) conditions.push(column.addCondition({ kind: \"lte\", value: leaf.value[1] }));\n      } else if (leaf.kind === \"in\" && !column.column.isArray && leaf.value.includes(null)) {\n        conditions.push({\n          or: [\n            column.addCondition({ kind: \"is-null\" }),\n            column.addCondition({ kind: \"in\", value: leaf.value.filter((v) => v !== null) }),\n          ],\n        });\n      } else {\n        conditions.push(column.addCondition(leaf));\n      }\n    }\n  }\n  return conditions.length === 0 ? skipCondition : { and: conditions };\n}\n\n/**\n * Converts relationship filters into conditions on the joined table's id column.\n * I.e. Author's `join: { books: \"b:1\" }` filters Book.id to 1; `{ books: book }` uses book.id.\n * Lists match any supplied ID, `true` requires a Book, and `null` or `false` requires no Book.\n */\nexport function tableEntityWhere(mgmt: TableMgmt, value: unknown): SqlCondition {\n  const parsed = parseEntityFilter(mgmt.meta, value);\n  if (!parsed) return skipCondition;\n  if (parsed.kind === \"join\") fail(`Expected an entity or ID filter for ${mgmt.meta.type}`);\n  return new TableColumn(mgmt.meta, mgmt.meta.fields.id.serde!.columns[0].column, mgmt).addCondition(parsed);\n}\n\n/** Rejects nested relations, scopes, and aliases before parsing owning-reference values. */\nfunction isTableReferenceFilter(value: unknown): boolean {\n  if (value == null || typeof value === \"boolean\" || isTableReferenceValue(value)) return true;\n  if (Array.isArray(value)) return value.every(isTableReferenceValue);\n  if (typeof value === \"object\" && Object.keys(value).length === 1 && Object.hasOwn(value, \"ne\")) {\n    const excluded = (value as { ne: unknown }).ne;\n    return excluded == null || isTableReferenceValue(excluded);\n  }\n  return false;\n}\n\n/** Recognizes an entity or public ID without accepting another filter object. */\nfunction isTableReferenceValue(value: unknown): boolean {\n  return typeof value === \"string\" || typeof value === \"number\" || isEntity(value);\n}\n"],"mappings":"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"}