Type Alias: MergeContextWithJoinType<TContext, TNewSchema, TJoinType>

type MergeContextWithJoinType<TContext, TNewSchema, TJoinType> = object & PreserveSingleResultFlag<TContext["singleResult"]> & PreserveHasResultFlag<TContext["hasResult"]>;

type MergeContextWithJoinType<TContext, TNewSchema, TJoinType> = object & PreserveSingleResultFlag<TContext["singleResult"]> & PreserveHasResultFlag<TContext["hasResult"]>;

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

MergeContextWithJoinType - Creates a new context after a join operation

This is the core type that handles the complex logic of merging schemas when tables are joined, applying the correct optionality based on join type.

Key Responsibilities:

Schema Merging: Combines existing schema with newly joined tables
Optionality Logic: Applies join-specific optionality rules:
- LEFT JOIN: New table becomes optional
- RIGHT JOIN: Existing tables become optional
- FULL JOIN: Both existing and new become optional
- INNER JOIN: No tables become optional
State Tracking: Updates hasJoins and joinTypes for future operations

Context Evolution:

baseSchema: Unchanged (always the original from() tables)
schema: Expanded with new tables and proper optionality
hasJoins: Set to true
joinTypes: Updated to track this join type
result: Preserved from previous operations
singleResult: Preserved only if already true (via PreserveSingleResultFlag)

Type Declaration

baseSchema

baseSchema: TContext["baseSchema"];

baseSchema: TContext["baseSchema"];

fromSourceName

fromSourceName: TContext["fromSourceName"];

fromSourceName: TContext["fromSourceName"];

hasJoins

hasJoins: true;

hasJoins: true;

joinTypes

joinTypes: TContext["joinTypes"] extends Record<string, any> ? TContext["joinTypes"] : object & { [K in keyof TNewSchema & string]: TJoinType };

joinTypes: TContext["joinTypes"] extends Record<string, any> ? TContext["joinTypes"] : object & { [K in keyof TNewSchema & string]: TJoinType };

result

result: TContext["result"];

result: TContext["result"];

schema

schema: ApplyJoinOptionalityToMergedSchema<TContext["schema"], TNewSchema, TJoinType, TContext["fromSourceName"]>;

schema: ApplyJoinOptionalityToMergedSchema<TContext["schema"], TNewSchema, TJoinType, TContext["fromSourceName"]>;

Type Parameters

TContext

TContext extends Context

TNewSchema

TNewSchema extends ContextSchema

TJoinType