joist-core 2.3.0-next.99 → 2.4.0

package/build/queries/sql/Tables.d.cts

@@ -1,12 +1,16 @@
 import { ColumnsOf, FieldsOf, FilterOf, TypeMap, TypeNameOf } from "../../typeMap.cjs";
 import { SqlCondition } from "../conditions.cjs";
 import { EntityMetadata } from "../../EntityMetadata.cjs";
-import { Expr, ExprLike, InnerJoin, LeftJoin } from "./Expr.cjs";
+import { CustomColumnInputs, CustomTable, CustomTableDefinition, CustomTableFor, CustomTableMgmt } from "./custom.cjs";
+import { QueryArg, QueryJoinInput, QuerySource } from "./query.cjs";
+import { BaseExpr, Expr, ExprLike, InnerJoin, LeftJoin, selectKeyBrand } from "./Expr.cjs";
 import { IdOf, MaybeAbstractEntityConstructor, TaggedId } from "../../EntityManager.cjs";
 import { Entity } from "../../Entity.cjs";
 //#region src/queries/sql/Tables.d.ts
 /** Creates physical column expressions and relationship joins for `T`. */
 declare function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T>;
+/** Creates a typed physical handle for a table declared with `declareTable`. */
+declare function table<TableName extends string, C extends CustomColumnInputs>(definition: CustomTableDefinition<TableName, C>): CustomTable<C, TableName>;
 /**
  * Creates a table with an explicit type-level name, i.e. `table(Author, "m")` for a self-join.
  *
@@ -14,6 +18,8 @@ declare function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>
  * so a left-joined mentor would also mark the mentee's columns nullable; a named alias has its own key.
  */
 declare function table<T extends Entity, Name extends string>(cstr: MaybeAbstractEntityConstructor<T>, name: Name): Table<T, Name>;
+/** Creates a named custom-table handle for joins and self-joins. */
+declare function table<C extends CustomColumnInputs, TableName extends string, Name extends string>(definition: CustomTableDefinition<TableName, C>, name: Name): CustomTable<C, Name>;
 /** Creates multiple physical table handles. */
 declare function tables<T extends readonly MaybeAbstractEntityConstructor<any>[]>(...type: T): { [P in keyof T]: T[P] extends MaybeAbstractEntityConstructor<infer E extends Entity> ? Table<E> : never; };
 /**
@@ -22,10 +28,13 @@ declare function tables<T extends readonly MaybeAbstractEntityConstructor<any>[]
  * `__entity` lets `QueryRow` recover `T` for entity mode (you cannot `infer T` back out of a mapped
  * type), and `__name` is the table's source key (see `Expr`).
  */
-interface TableBrand<T, Name extends string> extends TableMgmt {
-  readonly __entity: T;
+interface TableSourceBrand<Name extends string> extends TableSourceMgmt {
   readonly __name: Name;
 }
+/** A modeled table source that can hydrate its generated entity type. */
+interface TableBrand<T, Name extends string> extends TableSourceBrand<Name>, TableMgmt {
+  readonly __entity: T;
+}
 /**
  * A physical table for `T`: one expression per SQL column, with relationship names as join factories.
  * Selecting the table itself retains entity hydration; selecting columns returns decoded SQL values.
@@ -54,6 +63,18 @@ interface TableBrand<T, Name extends string> extends TableMgmt {
 type Table<T extends Entity, Name extends string = TableNameOf<T>> = TableShape<T, Name> & ("where" extends keyof TableShape<T, Name> ? {} : {
   /** Builds an AND condition from local domain fields, without implicit joins. */
   where(filter: TableFilter<T>): SqlCondition;
+}) & ("column" extends keyof TableShape<T, Name> ? {} : {
+  /**
+   * References a column Joist does not model, i.e. `a.column<string>("ts_search")`.
+   *
+   * The expression keeps this table's source key, so it is scope-checked and nullified by a
+   * LEFT join like any modeled column. `R` is unchecked: it asserts what the database returns,
+   * and the value is not decoded through a codec.
+   *
+   * A schema that has its own `column` column or relation keeps that meaning, and then has no
+   * escape hatch for unmodeled columns.
+   */
+  column<R = unknown>(column: string): Expr<R, Name>;
 });
 /** Domain filters for fields stored on this physical table, without relationship traversal. */
 type TableFilter<T extends Entity> = { [K in LocalFieldNames<T> & keyof FieldsOf<T>]?: FieldsOf<T>[K] extends {
@@ -69,15 +90,16 @@ type LocalFieldNames<T> = ColumnsOf<T>[keyof ColumnsOf<T>] extends {
 type TableReferenceFilter<T extends Entity, N> = T | IdOf<T> | readonly (T | IdOf<T>)[] | boolean | N | undefined | {
   ne: T | IdOf<T> | N | undefined;
 };
+/** Maps an entity's columns and relationships to expressions and joins for one typed table handle. */
 type TableShape<T extends Entity, Name extends string> = {
   readonly [tableMgmt]: TableBrand<T, Name>;
-} & { [P in keyof ColumnsOf<T>]: P extends "id" ? EntityColumn<T, never, Name> : ColumnsOf<T>[P] extends {
+} & { [P in keyof ColumnsOf<T> & string]: P extends "id" ? EntityColumn<T, never, Name, P> : ColumnsOf<T>[P] extends {
   entity: infer U extends Entity;
   nullable: infer N;
-} ? ReferenceColumn<U, N extends true ? null : never, Name> : ColumnsOf<T>[P] extends {
+} ? ReferenceColumn<U, N extends true ? null : never, Name, P> : ColumnsOf<T>[P] extends {
   type: infer V;
   nullable: infer N;
-} ? PrimitiveColumn<V, N extends true ? null : never, Name> : never; } & { [P in keyof FieldsOf<T> as P extends keyof ColumnsOf<T> ? never : FieldsOf<T>[P] extends {
+} ? PrimitiveColumn<V, N extends true ? null : never, Name, P> : never; } & { [P in keyof FieldsOf<T> as P extends keyof ColumnsOf<T> ? never : FieldsOf<T>[P] extends {
   kind: "m2o" | "poly" | "o2m" | "lo2m" | "m2m" | "o2o";
 } ? P : never]: FieldsOf<T>[P] extends {
   kind: "m2o";
@@ -150,7 +172,7 @@ interface SubtypeJoin<U extends Entity> extends CollectionJoin<U> {
  * (`b.authorId.as(a)` joins). The default join kind follows physical column nullability:
  * a NOT NULL FK is INNER unless its source was LEFT joined, a nullable one is LEFT, and the row type reflects it.
  */
-interface ReferenceColumn<U extends Entity, N extends null | never, Src extends string> extends EntityColumn<U, N, Src>, ReferenceJoin<U, N, Src> {}
+interface ReferenceColumn<U extends Entity, N extends null | never, Src extends string, Key extends string = string> extends EntityColumn<U, N, Src, Key>, ReferenceJoin<U, N, Src> {}
 /**
  * A polymorphic reference: condition methods (each resolving the component column from the value), plus
  * a join factory that picks the component from the argument's entity, i.e. `c.parent.as(a)` joins
@@ -163,7 +185,8 @@ interface PolyReference<U extends Entity, N extends null | never, Src extends st
   /** Applies an IN condition unless the list is empty or undefined. */
   inNonEmpty(values: readonly (U | TaggedId)[] | undefined): SqlCondition;
 }
-interface PrimitiveColumn<V, N extends null | never, Src extends string = string> extends Expr<V | N, Src> {
+interface PrimitiveColumn<V, N extends null | never, Src extends string = string, Key extends string = string> extends Expr<V | N, Src> {
+  readonly [selectKeyBrand]: Key;
   eq(value: V | ExprLike<V | N> | N | undefined): SqlCondition;
   ne(value: V | ExprLike<V | N> | N | undefined): SqlCondition;
   in(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition;
@@ -210,9 +233,13 @@ interface PrimitiveColumn<V, N extends null | never, Src extends string = string
    */
   raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;
 }
-interface EntityColumn<T, N extends null | never = never, Src extends string = string> extends Expr<IdOf<T> | N, Src> {
+interface EntityColumn<T, N extends null | never = never, Src extends string = string, Key extends string = string> extends Expr<IdOf<T> | N, Src> {
+  readonly [selectKeyBrand]: Key;
+  /** Produces the tagged ID as SQL text, preserving NULL and the column's source. */
+  taggedId(): Expr<string | N, Src>;
   eq(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;
   ne(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;
+  in<F extends QuerySource, const S extends ExprLike<IdOf<T> | null>, J extends QueryJoinInput = [], Name extends string = "?">(value: QueryArg<F, S, J, Name>): SqlCondition;
   in(value: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;
   /** Applies an IN condition unless the list is empty, null, or undefined. */
   inNonEmpty(value: readonly (T | IdOf<T> | null)[] | null | undefined): SqlCondition;
@@ -224,10 +251,26 @@ interface EntityColumn<T, N extends null | never = never, Src extends string = s
   raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;
 }
 declare const tableMgmt: unique symbol;
-declare function getTableMgmt(table: TableFor<unknown>): TableMgmt;
+declare const inQueryCondition: unique symbol;
+/** Defers a direct IN query literal to query.ts, which owns query pruning and SQL generation. */
+interface InQueryCondition {
+  readonly [inQueryCondition]: {
+    column: BaseExpr;
+    query: object;
+  };
+}
+declare function getTableMgmt<T extends Entity>(table: TableFor<T>): TableMgmt;
+declare function getTableMgmt(table: CustomTableFor): CustomTableMgmt;
+declare function getTableMgmt(table: TableFor<Entity> | CustomTableFor): TableSourceMgmt;
 /** The identity SQL queries bind a table by, plus its original entity metadata. */
-interface TableMgmt {
+interface TableSourceMgmt {
   tableName: string;
+  schema?: string;
+}
+/** Qualifies custom tables without changing SQL for tables on the default search path. */
+declare function tableSqlName(table: TableSourceMgmt): string;
+/** The identity and generated metadata of a modeled entity table. */
+interface TableMgmt extends TableSourceMgmt {
   /**
    * The metadata this table was created with, i.e. `table(TaskNew)` keeps `taskNewMeta`.
    *
@@ -240,7 +283,11 @@ interface TableMgmt {
 /** Returns the metadata for the entity that `table` is bound to. */
 declare function getTableMetadata<T extends Entity>(table: TableFor<T>): EntityMetadata<T>;
 declare function newTableProxy<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T>;
-declare function isTable(obj: unknown): obj is Table<any, any>;
+declare function isTable(obj: unknown): obj is Table<any, any> | CustomTableFor;
+/** Whether a physical table has generated entity metadata. */
+declare function isEntityTable(obj: unknown): obj is Table<any, any>;
+/** Whether a physical table has columns declared through `declareTable`. */
+declare function isCustomTable(obj: unknown): obj is CustomTableFor;
 /**
  * Marks a sugar join entry whose target is a *collection* (o2m/m2m), which filter soft-deletes like
  * em.find's "collections filter out soft-deletes, but m2o/o2o references still return them"; see
@@ -258,6 +305,18 @@ declare class JoinTableHandle {
   readonly joinTableName: string;
   constructor(joinTableName: string);
 }
+/**
+ * Maps local domain fields to table-bound conditions, encoding each leaf once.
+ * I.e. Author.firstName uses the first_name column but resolves its alias in each query scope.
+ * Collections, polymorphic references, and inherited nonlocal fields require explicit expressions.
+ */
+declare function tableWhere(mgmt: TableMgmt, filter: object): SqlCondition;
+/**
+ * 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.
+ */
+declare function tableEntityWhere(mgmt: TableMgmt, value: unknown): SqlCondition;
 //#endregion
-export { CollectionJoin, DefaultReferenceJoin, EntityColumn, JoinTableHandle, M2mJoinTable, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, collectionJoin, getTableMetadata, getTableMgmt, isTable, m2mJoinTable, newTableProxy, referenceJoinSource, table, tableMgmt, tables };
+export { CollectionJoin, DefaultReferenceJoin, EntityColumn, InQueryCondition, JoinTableHandle, M2mJoinTable, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, TableSourceBrand, TableSourceMgmt, collectionJoin, getTableMetadata, getTableMgmt, inQueryCondition, isCustomTable, isEntityTable, isTable, m2mJoinTable, newTableProxy, referenceJoinSource, table, tableEntityWhere, tableMgmt, tableSqlName, tableWhere, tables };
 //# sourceMappingURL=Tables.d.cts.map

package/build/queries/sql/Tables.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"Tables.d.cts","names":[],"sources":["../../../src/queries/sql/Tables.ts"],"mappings":"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"}
+{"version":3,"file":"Tables.d.cts","names":[],"sources":["../../../src/queries/sql/Tables.ts"],"mappings":";;;;;;;;;;iBAyDgB,MAAM,UAAU,QAAQ,MAAM,+BAA+B,KAAK,MAAM;;iBAExE,MAAM,0BAA0B,UAAU,oBACxD,YAAY,sBAAsB,WAAW,KAC5C,YAAY,GAAG;;;;;;;iBAOF,MAAM,UAAU,QAAQ,qBACtC,MAAM,+BAA+B,IACrC,MAAM,OACL,MAAM,GAAG;;iBAEI,MAAM,UAAU,oBAAoB,0BAA0B,qBAC5E,YAAY,sBAAsB,WAAW,IAC7C,MAAM,OACL,YAAY,GAAG;;iBAUF,OAAO,mBAAmB,0CACrC,MAAM,OACL,WAAW,IAAI,EAAE,WAAW,qCAAqC,UAAU,UAAU,MAAM;;;;;;;UAUhF,iBAAiB,6BAA6B;WACpD,QAAQ;;;UAIF,WAAW,GAAG,6BAA6B,iBAAiB,OAAO;WACzE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BT,MAAM,UAAU,QAAQ,sBAAsB,YAAY,MAAM,WAAW,GAAG,+BACjE,WAAW,GAAG;;EAI/B,MAAM,QAAQ,YAAY,KAAK;6BAEb,WAAW,GAAG;;;;;;;;;;;EAahC,OAAO,aAAa,iBAAiB,KAAK,GAAG;;;KAIzC,YAAY,UAAU,aAC/B,KAAK,gBAAgB,WAAW,SAAS,MAAM,SAAS,GAAG;EAC1D;EACA,YAAY,UAAU;EACtB,gBAAgB;IAEd,qBAAqB,GAAG,sCACxB,SAAS,GAAG;;KAIb,gBAAgB,KAAK,UAAU,SAAS,UAAU;EAAc,iBAAiB;IAClF,QAAQ,SAAS,SAAS;;KAIzB,qBAAqB,UAAU,QAAQ,KACxC,IACA,KAAK,eACK,IAAI,KAAK,kBAEnB;EAEE,IAAI,IAAI,KAAK,KAAK;;;KAGnB,WAAW,UAAU,QAAQ;YACtB,YAAY,WAAW,GAAG;OAGnC,WAAW,UAAU,cAAc,iBAChC,aAAa,UAAU,MAAM,KAC7B,UAAU,GAAG;EAAa,cAAc,UAAU;EAAQ,gBAAgB;IACxE,gBAAgB,GAAG,+BAA+B,MAAM,KACxD,UAAU,GAAG;EAAa,YAAY;EAAG,gBAAgB;IACvD,gBAAgB,GAAG,+BAA+B,MAAM,mBAK9D,WAAW,SAAS,MAAM,gBAAgB,UAAU,aAEhD,SAAS,GAAG;EAAa;IACvB,YAEL,SAAS,GAAG;EAAa;EAAa,YAAY,UAAU;EAAQ,gBAAgB;IACnF,cAAc,GAAG,oCAAoC,QACrD,SAAS,GAAG;EAAa;EAAc,YAAY,UAAU;EAAQ,gBAAgB;IACnF,cAAc,GAAG,oCAAoC,QACrD,SAAS,GAAG;EAAa;EAAsC,YAAY,UAAU;IACnF,eAAe,mBAMrB,WAAW,WAAW,QAAQ;EAC5B,kBAAkB,UAAU;IAAW;MAAU,GAAG,WAAW;MAAI;;;IAEjE,aAAa,WAAW,uBAE3B,QAAQ;EAAa,kBAAkB,UAAU;IAAW,YAAY;;KAIxE,YAAY,KAAK;EAAY;IAAU;;IAAgB,WAAW;;UAGtD,cAAc,UAAU,QAAQ,wBAAwB;;;;;EAKvE,GAAG,UAAU,SAAS,IAAI,OAAO,KAAK,qBAAqB,qBAAqB,GAAG,OAAO,SAAS;EACnG,MAAM,UAAU,SAAS,IAAI,OAAO,IAAI,UAAU;EAClD,KAAK,UAAU,SAAS,IAAI,OAAO,IAAI,SAAS;;;cAIrC;;KAGD,qBAAqB,GAAG,sBAAsB,UAAU;YACxD,sBAAsB;;;KAItB,SAAS;YAAiB,YAAY,WAAW;;;;;;;;;;;;UAY5C,eAAe,UAAU;EACxC,GAAG,UAAU,SAAS,IAAI,OAAO,IAAI,SAAS;EAC9C,MAAM,UAAU,SAAS,IAAI,OAAO,IAAI,UAAU;EAClD,KAAK,UAAU,SAAS,IAAI,OAAO,IAAI,SAAS;;;UAIxC,YAAY,UAAU,gBAAgB,eAAe;GAC5D,UAAU,SAAS,IAAI,OAAO,IAAI,SAAS;;;;;;;UAQ7B,gBACf,UAAU,QACV,wBACA,oBACA,qCAEQ,aAAa,GAAG,GAAG,KAAK,MAAM,cAAc,GAAG,GAAG;;;;;;UAO3C,cACf,UAAU,QACV,wBACA,qCACQ,cAAc,GAAG,GAAG;EAC5B,GAAG,OAAO,IAAI,WAAW,SAAS,KAAK,gCAAgC;EACvE,GAAG,OAAO,IAAI,WAAW,SAAS,KAAK,gCAAgC;EACvE,GAAG,kBAAkB,IAAI,cAAc,SAAS,KAAK,yBAAyB;;EAE9E,WAAW,kBAAkB,IAAI,0BAA0B;;UAG5C,gBACf,GACA,wBACA,6BACA,qCACQ,KAAK,IAAI,GAAG;YACV,iBAAiB;EAC3B,GAAG,OAAO,IAAI,SAAS,IAAI,KAAK,gBAAgB;EAChD,GAAG,OAAO,IAAI,SAAS,IAAI,KAAK,gBAAgB;EAChD,GAAG,kBAAkB,cAAc,SAAS,wBAAwB;;EAEpE,WAAW,kBAAkB,0BAA0B;EACvD,IAAI,kBAAkB,cAAc,SAAS,wBAAwB;EACrE,GAAG,OAAO,IAAI,SAAS,IAAI,iBAAiB;EAC5C,IAAI,OAAO,IAAI,SAAS,IAAI,iBAAiB;EAC7C,GAAG,OAAO,IAAI,SAAS,IAAI,iBAAiB;EAC5C,IAAI,OAAO,IAAI,SAAS,IAAI,iBAAiB;EAC7C,KAAK,OAAO,gBAAgB;EAC5B,MAAM,OAAO,gBAAgB;EAC7B,OAAO,OAAO,gBAAgB;EAC9B,QAAQ,IAAI,eAAe,IAAI,gBAAgB;EAI/C,SAAS,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACvE,UAAU,gBAAgB,IAAI,gBAAgB,UAAU,gBAAgB;EACxE,SAAS,OAAO,IAAI,gBAAgB,UAAU,gBAAgB;EAC9D,UAAU,OAAO,IAAI,gBAAgB,UAAU,gBAAgB;;;;;;;;EAS/D,WAAW,+BAA+B;;;;;;;;EAS1C,WAAW,+BAA+B;;;;;;;;;;;EAY1C,IAAI,aAAa,uCAAuC;;UAGzC,aACf,GACA,gCACA,6BACA,qCACQ,KAAK,KAAK,KAAK,GAAG;YAChB,iBAAiB;;EAE3B,YAAY,cAAc,GAAG;EAC7B,GAAG,OAAO,IAAI,KAAK,KAAK,SAAS,KAAK,gCAAgC;EACtE,GAAG,OAAO,IAAI,KAAK,KAAK,SAAS,KAAK,gCAAgC;EAEtE,GACE,UAAU,mBACJ,UAAU,SAAS,KAAK,YAC9B,UAAU,qBACV,2BAEA,OAAO,SAAS,GAAG,GAAG,GAAG,QACxB;EACH,GAAG,iBAAiB,IAAI,KAAK,eAAe,SAAS,KAAK,gCAAgC;;EAE1F,WAAW,iBAAiB,IAAI,KAAK,kCAAkC;EACvE,IAAI,iBAAiB,IAAI,KAAK,eAAe,SAAS,KAAK,gCAAgC;EAC3F,GAAG,OAAO,KAAK,KAAK,SAAS,KAAK,gCAAgC;EAClE,IAAI,OAAO,KAAK,KAAK,SAAS,KAAK,gCAAgC;EACnE,GAAG,OAAO,KAAK,KAAK,SAAS,KAAK,gCAAgC;EAClE,IAAI,OAAO,KAAK,KAAK,SAAS,KAAK,gCAAgC;EACnE,IAAI,aAAa,uCAAuC;;cAG7C;cACA;;UAGI;YACL;IAAqB,QAAQ;IAAU;;;iBAGnC,aAAa,UAAU,QAAQ,OAAO,SAAS,KAAK;iBACpD,aAAa,OAAO,iBAAiB;iBACrC,aAAa,OAAO,SAAS,UAAU,iBAAiB;;UAMvD;EACf;EACA;;;iBAIc,aAAa,OAAO;;UAKnB,kBAAkB;;;;;;;;EAQjC,MAAM;;;iBAIQ,iBAAiB,UAAU,QAAQ,OAAO,SAAS,KAAK,eAAe;iBAKvE,cAAc,UAAU,QAAQ,MAAM,+BAA+B,KAAK,MAAM;iBA0FhF,QAAQ,eAAe,OAAO,kBAAkB;;iBAKhD,cAAc,eAAe,OAAO;;iBAKpC,cAAc,eAAe,OAAO;;;;;;cA+bvC;;cAGA;UAEI;EACf,QAAQ;EACR,IAAI;;;cAIO;WACU;EAArB,YAAqB;;;;;;;iBA8LP,WAAW,MAAM,WAAW,iBAAiB;;;;;;iBAwD7C,iBAAiB,MAAM,WAAW,iBAAiB"}

package/build/queries/sql/Tables.d.mts

@@ -1,12 +1,16 @@
 import { ColumnsOf, FieldsOf, FilterOf, TypeMap, TypeNameOf } from "../../typeMap.mjs";
 import { SqlCondition } from "../conditions.mjs";
 import { EntityMetadata } from "../../EntityMetadata.mjs";
-import { Expr, ExprLike, InnerJoin, LeftJoin } from "./Expr.mjs";
+import { CustomColumnInputs, CustomTable, CustomTableDefinition, CustomTableFor, CustomTableMgmt } from "./custom.mjs";
+import { QueryArg, QueryJoinInput, QuerySource } from "./query.mjs";
+import { BaseExpr, Expr, ExprLike, InnerJoin, LeftJoin, selectKeyBrand } from "./Expr.mjs";
 import { IdOf, MaybeAbstractEntityConstructor, TaggedId } from "../../EntityManager.mjs";
 import { Entity } from "../../Entity.mjs";
 //#region src/queries/sql/Tables.d.ts
 /** Creates physical column expressions and relationship joins for `T`. */
 declare function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T>;
+/** Creates a typed physical handle for a table declared with `declareTable`. */
+declare function table<TableName extends string, C extends CustomColumnInputs>(definition: CustomTableDefinition<TableName, C>): CustomTable<C, TableName>;
 /**
  * Creates a table with an explicit type-level name, i.e. `table(Author, "m")` for a self-join.
  *
@@ -14,6 +18,8 @@ declare function table<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>
  * so a left-joined mentor would also mark the mentee's columns nullable; a named alias has its own key.
  */
 declare function table<T extends Entity, Name extends string>(cstr: MaybeAbstractEntityConstructor<T>, name: Name): Table<T, Name>;
+/** Creates a named custom-table handle for joins and self-joins. */
+declare function table<C extends CustomColumnInputs, TableName extends string, Name extends string>(definition: CustomTableDefinition<TableName, C>, name: Name): CustomTable<C, Name>;
 /** Creates multiple physical table handles. */
 declare function tables<T extends readonly MaybeAbstractEntityConstructor<any>[]>(...type: T): { [P in keyof T]: T[P] extends MaybeAbstractEntityConstructor<infer E extends Entity> ? Table<E> : never; };
 /**
@@ -22,10 +28,13 @@ declare function tables<T extends readonly MaybeAbstractEntityConstructor<any>[]
  * `__entity` lets `QueryRow` recover `T` for entity mode (you cannot `infer T` back out of a mapped
  * type), and `__name` is the table's source key (see `Expr`).
  */
-interface TableBrand<T, Name extends string> extends TableMgmt {
-  readonly __entity: T;
+interface TableSourceBrand<Name extends string> extends TableSourceMgmt {
   readonly __name: Name;
 }
+/** A modeled table source that can hydrate its generated entity type. */
+interface TableBrand<T, Name extends string> extends TableSourceBrand<Name>, TableMgmt {
+  readonly __entity: T;
+}
 /**
  * A physical table for `T`: one expression per SQL column, with relationship names as join factories.
  * Selecting the table itself retains entity hydration; selecting columns returns decoded SQL values.
@@ -54,6 +63,18 @@ interface TableBrand<T, Name extends string> extends TableMgmt {
 type Table<T extends Entity, Name extends string = TableNameOf<T>> = TableShape<T, Name> & ("where" extends keyof TableShape<T, Name> ? {} : {
   /** Builds an AND condition from local domain fields, without implicit joins. */
   where(filter: TableFilter<T>): SqlCondition;
+}) & ("column" extends keyof TableShape<T, Name> ? {} : {
+  /**
+   * References a column Joist does not model, i.e. `a.column<string>("ts_search")`.
+   *
+   * The expression keeps this table's source key, so it is scope-checked and nullified by a
+   * LEFT join like any modeled column. `R` is unchecked: it asserts what the database returns,
+   * and the value is not decoded through a codec.
+   *
+   * A schema that has its own `column` column or relation keeps that meaning, and then has no
+   * escape hatch for unmodeled columns.
+   */
+  column<R = unknown>(column: string): Expr<R, Name>;
 });
 /** Domain filters for fields stored on this physical table, without relationship traversal. */
 type TableFilter<T extends Entity> = { [K in LocalFieldNames<T> & keyof FieldsOf<T>]?: FieldsOf<T>[K] extends {
@@ -69,15 +90,16 @@ type LocalFieldNames<T> = ColumnsOf<T>[keyof ColumnsOf<T>] extends {
 type TableReferenceFilter<T extends Entity, N> = T | IdOf<T> | readonly (T | IdOf<T>)[] | boolean | N | undefined | {
   ne: T | IdOf<T> | N | undefined;
 };
+/** Maps an entity's columns and relationships to expressions and joins for one typed table handle. */
 type TableShape<T extends Entity, Name extends string> = {
   readonly [tableMgmt]: TableBrand<T, Name>;
-} & { [P in keyof ColumnsOf<T>]: P extends "id" ? EntityColumn<T, never, Name> : ColumnsOf<T>[P] extends {
+} & { [P in keyof ColumnsOf<T> & string]: P extends "id" ? EntityColumn<T, never, Name, P> : ColumnsOf<T>[P] extends {
   entity: infer U extends Entity;
   nullable: infer N;
-} ? ReferenceColumn<U, N extends true ? null : never, Name> : ColumnsOf<T>[P] extends {
+} ? ReferenceColumn<U, N extends true ? null : never, Name, P> : ColumnsOf<T>[P] extends {
   type: infer V;
   nullable: infer N;
-} ? PrimitiveColumn<V, N extends true ? null : never, Name> : never; } & { [P in keyof FieldsOf<T> as P extends keyof ColumnsOf<T> ? never : FieldsOf<T>[P] extends {
+} ? PrimitiveColumn<V, N extends true ? null : never, Name, P> : never; } & { [P in keyof FieldsOf<T> as P extends keyof ColumnsOf<T> ? never : FieldsOf<T>[P] extends {
   kind: "m2o" | "poly" | "o2m" | "lo2m" | "m2m" | "o2o";
 } ? P : never]: FieldsOf<T>[P] extends {
   kind: "m2o";
@@ -150,7 +172,7 @@ interface SubtypeJoin<U extends Entity> extends CollectionJoin<U> {
  * (`b.authorId.as(a)` joins). The default join kind follows physical column nullability:
  * a NOT NULL FK is INNER unless its source was LEFT joined, a nullable one is LEFT, and the row type reflects it.
  */
-interface ReferenceColumn<U extends Entity, N extends null | never, Src extends string> extends EntityColumn<U, N, Src>, ReferenceJoin<U, N, Src> {}
+interface ReferenceColumn<U extends Entity, N extends null | never, Src extends string, Key extends string = string> extends EntityColumn<U, N, Src, Key>, ReferenceJoin<U, N, Src> {}
 /**
  * A polymorphic reference: condition methods (each resolving the component column from the value), plus
  * a join factory that picks the component from the argument's entity, i.e. `c.parent.as(a)` joins
@@ -163,7 +185,8 @@ interface PolyReference<U extends Entity, N extends null | never, Src extends st
   /** Applies an IN condition unless the list is empty or undefined. */
   inNonEmpty(values: readonly (U | TaggedId)[] | undefined): SqlCondition;
 }
-interface PrimitiveColumn<V, N extends null | never, Src extends string = string> extends Expr<V | N, Src> {
+interface PrimitiveColumn<V, N extends null | never, Src extends string = string, Key extends string = string> extends Expr<V | N, Src> {
+  readonly [selectKeyBrand]: Key;
   eq(value: V | ExprLike<V | N> | N | undefined): SqlCondition;
   ne(value: V | ExprLike<V | N> | N | undefined): SqlCondition;
   in(values: readonly (V | null)[] | ExprLike<V | null> | undefined): SqlCondition;
@@ -210,9 +233,13 @@ interface PrimitiveColumn<V, N extends null | never, Src extends string = string
    */
   raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;
 }
-interface EntityColumn<T, N extends null | never = never, Src extends string = string> extends Expr<IdOf<T> | N, Src> {
+interface EntityColumn<T, N extends null | never = never, Src extends string = string, Key extends string = string> extends Expr<IdOf<T> | N, Src> {
+  readonly [selectKeyBrand]: Key;
+  /** Produces the tagged ID as SQL text, preserving NULL and the column's source. */
+  taggedId(): Expr<string | N, Src>;
   eq(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;
   ne(value: T | IdOf<T> | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;
+  in<F extends QuerySource, const S extends ExprLike<IdOf<T> | null>, J extends QueryJoinInput = [], Name extends string = "?">(value: QueryArg<F, S, J, Name>): SqlCondition;
   in(value: readonly (T | IdOf<T> | null)[] | ExprLike<IdOf<T> | null> | null | undefined): SqlCondition;
   /** Applies an IN condition unless the list is empty, null, or undefined. */
   inNonEmpty(value: readonly (T | IdOf<T> | null)[] | null | undefined): SqlCondition;
@@ -224,10 +251,26 @@ interface EntityColumn<T, N extends null | never = never, Src extends string = s
   raw(exp: string, bindings: readonly any[] | undefined): SqlCondition;
 }
 declare const tableMgmt: unique symbol;
-declare function getTableMgmt(table: TableFor<unknown>): TableMgmt;
+declare const inQueryCondition: unique symbol;
+/** Defers a direct IN query literal to query.ts, which owns query pruning and SQL generation. */
+interface InQueryCondition {
+  readonly [inQueryCondition]: {
+    column: BaseExpr;
+    query: object;
+  };
+}
+declare function getTableMgmt<T extends Entity>(table: TableFor<T>): TableMgmt;
+declare function getTableMgmt(table: CustomTableFor): CustomTableMgmt;
+declare function getTableMgmt(table: TableFor<Entity> | CustomTableFor): TableSourceMgmt;
 /** The identity SQL queries bind a table by, plus its original entity metadata. */
-interface TableMgmt {
+interface TableSourceMgmt {
   tableName: string;
+  schema?: string;
+}
+/** Qualifies custom tables without changing SQL for tables on the default search path. */
+declare function tableSqlName(table: TableSourceMgmt): string;
+/** The identity and generated metadata of a modeled entity table. */
+interface TableMgmt extends TableSourceMgmt {
   /**
    * The metadata this table was created with, i.e. `table(TaskNew)` keeps `taskNewMeta`.
    *
@@ -240,7 +283,11 @@ interface TableMgmt {
 /** Returns the metadata for the entity that `table` is bound to. */
 declare function getTableMetadata<T extends Entity>(table: TableFor<T>): EntityMetadata<T>;
 declare function newTableProxy<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): Table<T>;
-declare function isTable(obj: unknown): obj is Table<any, any>;
+declare function isTable(obj: unknown): obj is Table<any, any> | CustomTableFor;
+/** Whether a physical table has generated entity metadata. */
+declare function isEntityTable(obj: unknown): obj is Table<any, any>;
+/** Whether a physical table has columns declared through `declareTable`. */
+declare function isCustomTable(obj: unknown): obj is CustomTableFor;
 /**
  * Marks a sugar join entry whose target is a *collection* (o2m/m2m), which filter soft-deletes like
  * em.find's "collections filter out soft-deletes, but m2o/o2o references still return them"; see
@@ -258,6 +305,18 @@ declare class JoinTableHandle {
   readonly joinTableName: string;
   constructor(joinTableName: string);
 }
+/**
+ * Maps local domain fields to table-bound conditions, encoding each leaf once.
+ * I.e. Author.firstName uses the first_name column but resolves its alias in each query scope.
+ * Collections, polymorphic references, and inherited nonlocal fields require explicit expressions.
+ */
+declare function tableWhere(mgmt: TableMgmt, filter: object): SqlCondition;
+/**
+ * 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.
+ */
+declare function tableEntityWhere(mgmt: TableMgmt, value: unknown): SqlCondition;
 //#endregion
-export { CollectionJoin, DefaultReferenceJoin, EntityColumn, JoinTableHandle, M2mJoinTable, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, collectionJoin, getTableMetadata, getTableMgmt, isTable, m2mJoinTable, newTableProxy, referenceJoinSource, table, tableMgmt, tables };
+export { CollectionJoin, DefaultReferenceJoin, EntityColumn, InQueryCondition, JoinTableHandle, M2mJoinTable, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, TableSourceBrand, TableSourceMgmt, collectionJoin, getTableMetadata, getTableMgmt, inQueryCondition, isCustomTable, isEntityTable, isTable, m2mJoinTable, newTableProxy, referenceJoinSource, table, tableEntityWhere, tableMgmt, tableSqlName, tableWhere, tables };
 //# sourceMappingURL=Tables.d.mts.map

package/build/queries/sql/Tables.d.mts.map

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

package/build/queries/sql/Tables.js

@@ -1,17 +1,18 @@
-import { maybeResolveReferenceToId, toIdOf } from "../../keys.js";
-import { kqDot } from "./keywords.js";
+import { maybeResolveReferenceToId, taggedIdPrefix, toIdOf } from "../../keys.js";
+import { kq, kqDot, safeKq } from "./keywords.js";
 import { skipCondition } from "../skipCondition.js";
 import { makeLike, mapToDb, parseEntityFilter, parseValueFilter } from "../valueFilters.js";
-import { BaseExpr, asNode, deferredCondition, isExpr } from "./Expr.js";
+import { BaseExpr, RefExpr, asNode, deferredCondition, isExpr, selectKeyBrand } from "./Expr.js";
 import { fail } from "../../utils.js";
 import { getConstructorFromTaggedId } from "../../configure.js";
 import { getBaseAndSelfMetas, getBaseMeta, getBaseSelfAndSubMetas, getMetadata } from "../../EntityMetadata.js";
 import { buildValueCondition } from "../renderConditions.js";
+import { getCustomTableDefinition, isCustomTableDefinition } from "./custom.js";
 import { isEntity } from "../../Entity.js";
 import { groupBy } from "joist-utils";
 //#region src/queries/sql/Tables.ts
 function table(cstr, _name) {
-	return newTableProxy(cstr);
+	return isCustomTableDefinition(cstr) ? newCustomTableProxy(cstr) : newTableProxy(cstr);
 }
 /** Creates multiple physical table handles. */
 function tables(...type) {
@@ -20,9 +21,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 ? `${safeKq(table.schema)}.${kq(table.tableName)}` : kq(table.tableName);
+}
 /** Returns the metadata for the entity that `table` is bound to. */
 function getTableMetadata(table) {
 	return table[tableMgmt].meta;
@@ -40,7 +46,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);
@@ -52,6 +58,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 RefExpr(mgmt, column);
 			const field = relation ?? 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));
@@ -64,13 +71,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 } = 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 RefExpr(mgmt, column);
+			return 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
@@ -80,11 +117,16 @@ var TableColumn = class extends 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 [selectKeyBrand]() {
+		return this.selectKey;
 	}
 	/** Author.id, Book.authorId, and Comment.parentAuthorId use the same Author ID domain. */
 	get outputType() {
@@ -282,10 +324,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 skipCondition;
 		else if (values === null) throw new Error("Unsupported");
 		else if (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)
@@ -353,6 +403,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 BaseExpr {
+	column;
+	constructor(column) {
+		super();
+		this.column = column;
+	}
+	toSql(ctx) {
+		const fragment = this.column.toSql(ctx);
+		const meta = this.column.idMetadata ?? fail("Tagged IDs require an ID column");
+		return {
+			...fragment,
+			sql: `(? || ${fragment.sql}::text)`,
+			bindings: [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;
@@ -581,7 +661,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 fail(`Expected a table to join, got ${other}`);
+	if (!isEntityTable(other)) return fail(`Expected an entity table to join, got ${other}`);
 	return other;
 }
 /** The id column of a joined table, for building sugar ON conditions. */
@@ -675,6 +755,17 @@ function tableWhere(mgmt, filter) {
 	}
 	return conditions.length === 0 ? 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 = parseEntityFilter(mgmt.meta, value);
+	if (!parsed) return skipCondition;
+	if (parsed.kind === "join") 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;
@@ -690,6 +781,6 @@ function isTableReferenceValue(value) {
 	return typeof value === "string" || typeof value === "number" || isEntity(value);
 }
 //#endregion
-export { JoinTableHandle, collectionJoin, getTableMetadata, getTableMgmt, isTable, m2mJoinTable, newTableProxy, referenceJoinSource, table, tableMgmt, tables };
+export { JoinTableHandle, collectionJoin, getTableMetadata, getTableMgmt, inQueryCondition, isCustomTable, isEntityTable, isTable, m2mJoinTable, newTableProxy, referenceJoinSource, table, tableEntityWhere, tableMgmt, tableSqlName, tableWhere, tables };
 
 //# sourceMappingURL=Tables.js.map