Defined in: packages/db/src/query/builder/types.ts:44
Context - The central state container for query builder operations
This interface tracks all the information needed to build and type-check queries:
Schema Management:
baseSchema: The original tables/collections from thefrom()clauseschema: Current available tables (expands with joins, contracts with subqueries)
Query State:
fromSourceName: Which table was used infrom()or the firstunionAll()source - needed for optionality logichasJoins: Whether any joins have been added (affects result type inference)joinTypes: Maps table aliases to their join types for optionality calculations
Result Tracking:
result: The final shape afterselect()- undefined until select is called
The context evolves through the query builder chain:
from()sets baseSchema and schema to the same thingjoin()expands schema and sets hasJoins/joinTypesselect()sets result to the projected shape
Properties#
baseSchema#
baseSchema: ContextSchema;
Defined in: packages/db/src/query/builder/types.ts:46
fromSourceName#
fromSourceName: string;
Defined in: packages/db/src/query/builder/types.ts:52
fromSourceNames?#
optional fromSourceNames: readonly string[];
Defined in: packages/db/src/query/builder/types.ts:54
hasJoins?#
optional hasJoins: boolean;
Defined in: packages/db/src/query/builder/types.ts:58
hasResult?#
optional hasResult: true;
Defined in: packages/db/src/query/builder/types.ts:67
hasUnionFrom?#
optional hasUnionFrom: true;
Defined in: packages/db/src/query/builder/types.ts:56
joinTypes?#
optional joinTypes: Record<string, "inner" | "left" | "right" | "full" | "outer" | "cross">;
Defined in: packages/db/src/query/builder/types.ts:60
refsSchema?#
optional refsSchema: ContextSchema;
Defined in: packages/db/src/query/builder/types.ts:50
result?#
optional result: any;
Defined in: packages/db/src/query/builder/types.ts:65
schema#
schema: ContextSchema;
Defined in: packages/db/src/query/builder/types.ts:48
singleResult?#
optional singleResult: boolean;
Defined in: packages/db/src/query/builder/types.ts:69