Skip to content

Context.md

Latest commit

 

History

History
99 lines (63 loc) · 2.53 KB

Context.md

File metadata and controls

99 lines (63 loc) · 2.53 KB
id Context
title Context

Interface: Context

Defined in: packages/db/src/query/builder/types.ts:35

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 the from() clause
  • schema: Current available tables (expands with joins, contracts with subqueries)

Query State:

  • fromSourceName: Which table was used in from() - needed for optionality logic
  • hasJoins: 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 after select() - undefined until select is called

The context evolves through the query builder chain:

  1. from() sets baseSchema and schema to the same thing
  2. join() expands schema and sets hasJoins/joinTypes
  3. select() sets result to the projected shape

Properties

baseSchema

baseSchema: ContextSchema;

Defined in: packages/db/src/query/builder/types.ts:37

fromSourceName

fromSourceName: string;

Defined in: packages/db/src/query/builder/types.ts:41

hasJoins?

optional hasJoins: boolean;

Defined in: packages/db/src/query/builder/types.ts:43

joinTypes?

optional joinTypes: Record<string, "inner" | "left" | "right" | "full" | "outer" | "cross">;

Defined in: packages/db/src/query/builder/types.ts:45

result?

optional result: any;

Defined in: packages/db/src/query/builder/types.ts:50

schema

schema: ContextSchema;

Defined in: packages/db/src/query/builder/types.ts:39

singleResult?

optional singleResult: boolean;

Defined in: packages/db/src/query/builder/types.ts:52