140 lines
13 KiB
Plaintext
140 lines
13 KiB
Plaintext
import type { GelColumn } from "../columns/index.js";
|
|
import type { GelTable, GelTableWithColumns } from "../table.js";
|
|
import type { GelViewBase } from "../view-base.js";
|
|
import type { GelViewWithSelection } from "../view.js";
|
|
import type { SelectedFields as SelectedFieldsBase, SelectedFieldsFlat as SelectedFieldsFlatBase, SelectedFieldsOrdered as SelectedFieldsOrderedBase } from "../../operations.js";
|
|
import type { TypedQueryBuilder } from "../../query-builders/query-builder.js";
|
|
import type { AppendToNullabilityMap, AppendToResult, BuildSubquerySelection, GetSelectTableName, JoinNullability, JoinType, MapColumnsToTableAlias, SelectMode, SelectResult, SetOperator } from "../../query-builders/select.types.js";
|
|
import type { ColumnsSelection, Placeholder, SQL, SQLWrapper, View } from "../../sql/sql.js";
|
|
import type { Subquery } from "../../subquery.js";
|
|
import type { Table, UpdateTableConfig } from "../../table.js";
|
|
import type { Assume, ValidateShape, ValueOrArray } from "../../utils.js";
|
|
import type { GelPreparedQuery, PreparedQueryConfig } from "../session.js";
|
|
import type { GelSelectBase, GelSelectQueryBuilderBase } from "./select.js";
|
|
export interface GelSelectJoinConfig {
|
|
on: SQL | undefined;
|
|
table: GelTable | Subquery | GelViewBase | SQL;
|
|
alias: string | undefined;
|
|
joinType: JoinType;
|
|
lateral?: boolean;
|
|
}
|
|
export type BuildAliasTable<TTable extends GelTable | View, TAlias extends string> = TTable extends Table ? GelTableWithColumns<UpdateTableConfig<TTable['_']['config'], {
|
|
name: TAlias;
|
|
columns: MapColumnsToTableAlias<TTable['_']['columns'], TAlias, 'gel'>;
|
|
}>> : TTable extends View ? GelViewWithSelection<TAlias, TTable['_']['existing'], MapColumnsToTableAlias<TTable['_']['selectedFields'], TAlias, 'gel'>> : never;
|
|
export interface GelSelectConfig {
|
|
withList?: Subquery[];
|
|
fields: Record<string, unknown>;
|
|
fieldsFlat?: SelectedFieldsOrdered;
|
|
where?: SQL;
|
|
having?: SQL;
|
|
table: GelTable | Subquery | GelViewBase | SQL;
|
|
limit?: number | Placeholder;
|
|
offset?: number | Placeholder;
|
|
joins?: GelSelectJoinConfig[];
|
|
orderBy?: (GelColumn | SQL | SQL.Aliased)[];
|
|
groupBy?: (GelColumn | SQL | SQL.Aliased)[];
|
|
lockingClause?: {
|
|
strength: LockStrength;
|
|
config: LockConfig;
|
|
};
|
|
distinct?: boolean | {
|
|
on: (GelColumn | SQLWrapper)[];
|
|
};
|
|
setOperators: {
|
|
rightSelect: TypedQueryBuilder<any, any>;
|
|
type: SetOperator;
|
|
isAll: boolean;
|
|
orderBy?: (GelColumn | SQL | SQL.Aliased)[];
|
|
limit?: number | Placeholder;
|
|
offset?: number | Placeholder;
|
|
}[];
|
|
}
|
|
export type GelSelectJoin<T extends AnyGelSelectQueryBuilder, TDynamic extends boolean, TJoinType extends JoinType, TJoinedTable extends GelTable | Subquery | GelViewBase | SQL, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>> = T extends any ? GelSelectWithout<GelSelectKind<T['_']['hkt'], T['_']['tableName'], AppendToResult<T['_']['tableName'], T['_']['selection'], TJoinedName, TJoinedTable extends Table ? TJoinedTable['_']['columns'] : TJoinedTable extends Subquery ? Assume<TJoinedTable['_']['selectedFields'], SelectedFields> : never, T['_']['selectMode']>, T['_']['selectMode'] extends 'partial' ? T['_']['selectMode'] : 'multiple', AppendToNullabilityMap<T['_']['nullabilityMap'], TJoinedName, TJoinType>, T['_']['dynamic'], T['_']['excludedMethods']>, TDynamic, T['_']['excludedMethods']> : never;
|
|
export type GelSelectJoinFn<T extends AnyGelSelectQueryBuilder, TDynamic extends boolean, TJoinType extends JoinType, TIsLateral extends boolean> = <TJoinedTable extends (TIsLateral extends true ? Subquery | SQL : GelTable | Subquery | GelViewBase | SQL), TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: ((aliases: T['_']['selection']) => SQL | undefined) | SQL | undefined) => GelSelectJoin<T, TDynamic, TJoinType, TJoinedTable, TJoinedName>;
|
|
export type GelSelectCrossJoinFn<T extends AnyGelSelectQueryBuilder, TDynamic extends boolean, TIsLateral extends boolean> = <TJoinedTable extends (TIsLateral extends true ? Subquery | SQL : GelTable | Subquery | GelViewBase | SQL), TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable) => GelSelectJoin<T, TDynamic, 'cross', TJoinedTable, TJoinedName>;
|
|
export type SelectedFieldsFlat = SelectedFieldsFlatBase<GelColumn>;
|
|
export type SelectedFields = SelectedFieldsBase<GelColumn, GelTable>;
|
|
export type SelectedFieldsOrdered = SelectedFieldsOrderedBase<GelColumn>;
|
|
export type LockStrength = 'update' | 'no key update' | 'share' | 'key share';
|
|
export type LockConfig = {
|
|
of?: ValueOrArray<GelTable>;
|
|
} & ({
|
|
noWait: true;
|
|
skipLocked?: undefined;
|
|
} | {
|
|
noWait?: undefined;
|
|
skipLocked: true;
|
|
} | {
|
|
noWait?: undefined;
|
|
skipLocked?: undefined;
|
|
});
|
|
export interface GelSelectHKTBase {
|
|
tableName: string | undefined;
|
|
selection: unknown;
|
|
selectMode: SelectMode;
|
|
nullabilityMap: unknown;
|
|
dynamic: boolean;
|
|
excludedMethods: string;
|
|
result: unknown;
|
|
selectedFields: unknown;
|
|
_type: unknown;
|
|
}
|
|
export type GelSelectKind<T extends GelSelectHKTBase, TTableName extends string | undefined, TSelection extends ColumnsSelection, TSelectMode extends SelectMode, TNullabilityMap extends Record<string, JoinNullability>, TDynamic extends boolean, TExcludedMethods extends string, TResult = SelectResult<TSelection, TSelectMode, TNullabilityMap>[], TSelectedFields = BuildSubquerySelection<TSelection, TNullabilityMap>> = (T & {
|
|
tableName: TTableName;
|
|
selection: TSelection;
|
|
selectMode: TSelectMode;
|
|
nullabilityMap: TNullabilityMap;
|
|
dynamic: TDynamic;
|
|
excludedMethods: TExcludedMethods;
|
|
result: TResult;
|
|
selectedFields: TSelectedFields;
|
|
})['_type'];
|
|
export interface GelSelectQueryBuilderHKT extends GelSelectHKTBase {
|
|
_type: GelSelectQueryBuilderBase<GelSelectQueryBuilderHKT, this['tableName'], Assume<this['selection'], ColumnsSelection>, this['selectMode'], Assume<this['nullabilityMap'], Record<string, JoinNullability>>, this['dynamic'], this['excludedMethods'], Assume<this['result'], any[]>, Assume<this['selectedFields'], ColumnsSelection>>;
|
|
}
|
|
export interface GelSelectHKT extends GelSelectHKTBase {
|
|
_type: GelSelectBase<this['tableName'], Assume<this['selection'], ColumnsSelection>, this['selectMode'], Assume<this['nullabilityMap'], Record<string, JoinNullability>>, this['dynamic'], this['excludedMethods'], Assume<this['result'], any[]>, Assume<this['selectedFields'], ColumnsSelection>>;
|
|
}
|
|
export type CreateGelSelectFromBuilderMode<TBuilderMode extends 'db' | 'qb', TTableName extends string | undefined, TSelection extends ColumnsSelection, TSelectMode extends SelectMode> = TBuilderMode extends 'db' ? GelSelectBase<TTableName, TSelection, TSelectMode> : GelSelectQueryBuilderBase<GelSelectQueryBuilderHKT, TTableName, TSelection, TSelectMode>;
|
|
export type GelSetOperatorExcludedMethods = 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin' | 'where' | 'having' | 'groupBy' | 'for';
|
|
export type GelSelectWithout<T extends AnyGelSelectQueryBuilder, TDynamic extends boolean, K extends keyof T & string, TResetExcluded extends boolean = false> = TDynamic extends true ? T : Omit<GelSelectKind<T['_']['hkt'], T['_']['tableName'], T['_']['selection'], T['_']['selectMode'], T['_']['nullabilityMap'], TDynamic, TResetExcluded extends true ? K : T['_']['excludedMethods'] | K, T['_']['result'], T['_']['selectedFields']>, TResetExcluded extends true ? K : T['_']['excludedMethods'] | K>;
|
|
export type GelSelectPrepare<T extends AnyGelSelect> = GelPreparedQuery<PreparedQueryConfig & {
|
|
execute: T['_']['result'];
|
|
}>;
|
|
export type GelSelectDynamic<T extends AnyGelSelectQueryBuilder> = GelSelectKind<T['_']['hkt'], T['_']['tableName'], T['_']['selection'], T['_']['selectMode'], T['_']['nullabilityMap'], true, never, T['_']['result'], T['_']['selectedFields']>;
|
|
export type GelSelectQueryBuilder<THKT extends GelSelectHKTBase = GelSelectQueryBuilderHKT, TTableName extends string | undefined = string | undefined, TSelection extends ColumnsSelection = ColumnsSelection, TSelectMode extends SelectMode = SelectMode, TNullabilityMap extends Record<string, JoinNullability> = Record<string, JoinNullability>, TResult extends any[] = unknown[], TSelectedFields extends ColumnsSelection = ColumnsSelection> = GelSelectQueryBuilderBase<THKT, TTableName, TSelection, TSelectMode, TNullabilityMap, true, never, TResult, TSelectedFields>;
|
|
export type AnyGelSelectQueryBuilder = GelSelectQueryBuilderBase<any, any, any, any, any, any, any, any, any>;
|
|
export type AnyGelSetOperatorInterface = GelSetOperatorInterface<any, any, any, any, any, any, any, any>;
|
|
export interface GelSetOperatorInterface<TTableName extends string | undefined, TSelection extends ColumnsSelection, TSelectMode extends SelectMode, TNullabilityMap extends Record<string, JoinNullability> = TTableName extends string ? Record<TTableName, 'not-null'> : {}, TDynamic extends boolean = false, TExcludedMethods extends string = never, TResult extends any[] = SelectResult<TSelection, TSelectMode, TNullabilityMap>[], TSelectedFields extends ColumnsSelection = BuildSubquerySelection<TSelection, TNullabilityMap>> {
|
|
_: {
|
|
readonly hkt: GelSelectHKT;
|
|
readonly tableName: TTableName;
|
|
readonly selection: TSelection;
|
|
readonly selectMode: TSelectMode;
|
|
readonly nullabilityMap: TNullabilityMap;
|
|
readonly dynamic: TDynamic;
|
|
readonly excludedMethods: TExcludedMethods;
|
|
readonly result: TResult;
|
|
readonly selectedFields: TSelectedFields;
|
|
};
|
|
}
|
|
export type GelSetOperatorWithResult<TResult extends any[]> = GelSetOperatorInterface<any, any, any, any, any, any, TResult, any>;
|
|
export type GelSelect<TTableName extends string | undefined = string | undefined, TSelection extends ColumnsSelection = Record<string, any>, TSelectMode extends SelectMode = SelectMode, TNullabilityMap extends Record<string, JoinNullability> = Record<string, JoinNullability>> = GelSelectBase<TTableName, TSelection, TSelectMode, TNullabilityMap, true, never>;
|
|
export type AnyGelSelect = GelSelectBase<any, any, any, any, any, any, any, any>;
|
|
export type GelSetOperator<TTableName extends string | undefined = string | undefined, TSelection extends ColumnsSelection = Record<string, any>, TSelectMode extends SelectMode = SelectMode, TNullabilityMap extends Record<string, JoinNullability> = Record<string, JoinNullability>> = GelSelectBase<TTableName, TSelection, TSelectMode, TNullabilityMap, true, GelSetOperatorExcludedMethods>;
|
|
export type SetOperatorRightSelect<TValue extends GelSetOperatorWithResult<TResult>, TResult extends any[]> = TValue extends GelSetOperatorInterface<any, any, any, any, any, any, infer TValueResult, any> ? ValidateShape<TValueResult[number], TResult[number], TypedQueryBuilder<any, TValueResult>> : TValue;
|
|
export type SetOperatorRestSelect<TValue extends readonly GelSetOperatorWithResult<TResult>[], TResult extends any[]> = TValue extends [infer First, ...infer Rest] ? First extends GelSetOperatorInterface<any, any, any, any, any, any, infer TValueResult, any> ? Rest extends AnyGelSetOperatorInterface[] ? [
|
|
ValidateShape<TValueResult[number], TResult[number], TypedQueryBuilder<any, TValueResult>>,
|
|
...SetOperatorRestSelect<Rest, TResult>
|
|
] : ValidateShape<TValueResult[number], TResult[number], TypedQueryBuilder<any, TValueResult>[]> : never : TValue;
|
|
export type GelCreateSetOperatorFn = <TTableName extends string | undefined, TSelection extends ColumnsSelection, TSelectMode extends SelectMode, TValue extends GelSetOperatorWithResult<TResult>, TRest extends GelSetOperatorWithResult<TResult>[], TNullabilityMap extends Record<string, JoinNullability> = TTableName extends string ? Record<TTableName, 'not-null'> : {}, TDynamic extends boolean = false, TExcludedMethods extends string = never, TResult extends any[] = SelectResult<TSelection, TSelectMode, TNullabilityMap>[], TSelectedFields extends ColumnsSelection = BuildSubquerySelection<TSelection, TNullabilityMap>>(leftSelect: GelSetOperatorInterface<TTableName, TSelection, TSelectMode, TNullabilityMap, TDynamic, TExcludedMethods, TResult, TSelectedFields>, rightSelect: SetOperatorRightSelect<TValue, TResult>, ...restSelects: SetOperatorRestSelect<TRest, TResult>) => GelSelectWithout<GelSelectBase<TTableName, TSelection, TSelectMode, TNullabilityMap, TDynamic, TExcludedMethods, TResult, TSelectedFields>, false, GelSetOperatorExcludedMethods, true>;
|
|
export type GetGelSetOperators = {
|
|
union: GelCreateSetOperatorFn;
|
|
intersect: GelCreateSetOperatorFn;
|
|
except: GelCreateSetOperatorFn;
|
|
unionAll: GelCreateSetOperatorFn;
|
|
intersectAll: GelCreateSetOperatorFn;
|
|
exceptAll: GelCreateSetOperatorFn;
|
|
};
|