import { Adapter, AdapterClass, AdapterConfigBase, AdapterParams, AdapterSchemaConfigOptions, AfterCommitStandaloneHook, AfterHook, ArrayColumn, ArrayColumnValue, ArrayData, AsyncState, AsyncStateStorage, BaseNumberData, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, BrandColumn, BrandColumnsShape, ByteaColumn, CidrColumn, CircleColumn, CitextColumn, Code, Codes, Column, ColumnFromDbParams, ColumnRefExpression, ColumnSchemaConfig, ColumnSchemaGetterColumns, ColumnSchemaGetterTableClass, ColumnToCodeCtx, ColumnTypeSchemaArg, ColumnsByType, ColumnsShape, ComputedColumnsFromOptions, ComputedOptionsConfig, ComputedOptionsFactory, CreateCtx, CreateData, CreateManyMethodsNames, CreateMethodsNames, CreateSelf, CustomTypeColumn, DateColumn, DateColumnData, DateColumnInput, DbDomainArg, DbExtension, DbOptions, DbResult, DbSharedOptions, DbSqlMethod, DbStructureDomainsMap, DbTableOptionScopes, DbTableOptions, DecimalColumn, DecimalColumnData, DefaultColumnTypes, DefaultPrivileges, DefaultSchemaConfig, DeleteMethodsNames, DomainColumn, DoublePrecisionColumn, DriverAdapter, DynamicRawSQL, EmptyObject, EmptyTuple, EnumColumn, Expression, ExpressionData, FromArg, FromResult, GeneratorIgnore, HookSelectValue, InetColumn, IntegerColumn, IntervalColumn, IsQuery, IsolationLevel, JSONColumn, JSONTextColumn, JoinedShapes, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MapTableScopesOption, MaybeArray, MaybePromise, MergeQuery, MoneyColumn, NoPrimaryKeyOption, NonUniqDataItem, NumberColumnData, Operators, OperatorsArray, OperatorsDate, OperatorsJson, OperatorsNumber, OperatorsOrdinalText, OperatorsText, Ord, PathColumn, PickQueryInputType, PickQueryInternal, PickQueryQ, PickQueryRelations, PickQuerySelectableRelations, PickQueryShape, PointColumn, PolygonColumn, PostgisGeographyPointColumn, QueryAfterHook, QueryBeforeActionHook, QueryBeforeHook, QueryCatch, QueryData, QueryHasWhere, QueryHookUtils, QueryHooks, QueryInternal, QueryLogObject, QueryLogOptions, QueryLogger, QueryManyTake, QueryManyTakeOptional, QueryOrExpression, QueryResult, QueryResultRow, QueryReturnType, QuerySchema, QueryScopes, QueryTake, QueryThenShallowSimplify, RawSql, RawSqlBase, RealColumn, RecordKeyTrue, RecordOptionalString, RecordString, RecordStringOrNumber, RecordUnknown, RelationConfigBase, RelationJoinQuery, RelationsBase, Rls, RlsPolicy, SchemaConfigFnWithOptions, SearchWeight, SelectAs, SelectAsFnReturnType, SelectResultObj, SelectSqlColumn, SelectableFromShape, SerialColumn, SerialColumnData, ShallowSimplify, ShapeUniqueColumns, SingleSql, SingleSqlItem, SmallIntColumn, SmallSerialColumn, Sql, SqlFn, SqlSessionState, StaticSQLArgs, StorageOptions, StringColumn, StringData, TableData, TableDataFn, TableDataInput, TableDataItem, TableDataItemsUniqueColumnTuples, TableDataItemsUniqueColumns, TableDataItemsUniqueConstraints, TableDataMethods, TemplateLiteralArgs, TextColumn, TimeColumn, TimestampColumn, TimestampTZColumn, Timestamps, ToSQLCtx, ToSqlValues, TransactionAdapter, TransactionAdapterClass, TransactionOptions, TsQueryColumn, TsVectorColumn, UUIDColumn, UniqueConstraints, UniqueTableDataItem, UnknownColumn, UpdateData, UpsertData, UpsertThis, ValExpression, VarCharColumn, VirtualColumn, WhereArg, XMLColumn, _appendQuery, _appendQueryOnUpsertCreate, _clone, _createDbSqlMethod, _hookSelectColumns, _initQueryBuilder, _onUpsertUpdate, _orCreate, _prependWith, _prependWithOnUpsertCreate, _queryCreate, _queryCreateMany, _queryCreateManyFrom, _queryDefaults, _queryDelete, _queryFindBy, _queryFindByOptional, _queryHookAfterCreate, _queryHookAfterUpdate, _queryInsert, _queryInsertForEachFrom, _queryInsertMany, _queryJoinOn, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUpdate, _queryUpdateOrThrow, _queryUpsert, _queryWhere, _queryWhereExists, _queryWhereIn, addCode, addTopCte, addTopCteSql, applyMixins, assignDbDataToColumn, backtickQuote, cloneQueryBaseUnscoped, codeToString, colors, columnsShapeToCode, constraintInnerToCode, constraintToCode, consumeColumnName, deepCompare, defaultSchemaConfig, emptyArray, emptyObject, escapeForMigration, escapeString, excludeInnerToCode, excludeToCode, exhaustive, getCallerFilePath, getClonedQueryData, getColumnBaseType, getColumnTypes, getDateAsDateFn, getDateAsNumberFn, getDriverErrorCode, getFreeAlias, getFreeSetAlias, getImportPath, getPrimaryKeys, getQueryAs, getQuerySchema, getShapeFromSelect, getSqlText, getStackTrace, getSupportedDefaultPrivileges, indexInnerToCode, indexToCode, internalSchemaConfig, isExpression, isQueryReturnsAll, isRawSQL, isRelationCondition, logColors, logParamToLogObject, makeColumnNullable, makeColumnTypes, makeColumnsByType, makeConnectRetryConfig, markRelationConditions, noop, objectHasValues, omit, parseTableData, parseTableDataInput, pathToLog, pick, pluralize, prepareSubQueryForSql, primaryKeyInnerToCode, pushQueryOnForOuter, pushQueryValueImmutable, pushTableDataCode, queryToSql, quoteIdentifier, quoteObjectKey, quoteTableWithSchema, raw, rawSqlToCode, rawSqlToSql, referencesArgsToCode, returnArg, setColumnData, setColumnEncode, setColumnParse, setColumnParseNull, setCurrentColumnName, setDataValue, setDefaultLanguage, setFreeAlias, setQueryObjectValueImmutable, singleQuote, sqlToRawSql, tableDataMethods, toArray, toCamelCase, toPascalCase, toSnakeCase, wrapAdapterFnWithConnectRetry } from "./index.d.ts";
import "node:util";
import "tagged-tag";
type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never;
type MaybeArray$1<T> = T | T[];
type MaybePromise$1<T> = T | Promise<T>;
interface FnUnknownToUnknown {
  (a: unknown): unknown;
}
interface RecordString$1 {
  [K: string]: string;
}
interface RecordOptionalString$1 {
  [K: string]: string | undefined;
}
interface RecordUnknown$1 {
  [K: string]: unknown;
}
type ShallowSimplify$1<T> = T extends any ? { [K in keyof T]: T[K]; } : T;
type EmptyObject$1 = {};
type EmptyTuple$1 = [];
interface RelationJoinQuery$1 {
  (joiningQuery: IsQuery$1, baseQuery: IsQuery$1): IsQuery$1;
}
interface RelationConfigQuery extends PickQueryResult, PickQuerySelectable, PickQueryShape$1, PickQueryTable, PickQueryAs, PickQueryRelations$1, PickQueryReturnType {}
interface RelationConfigBase$1 extends IsQuery$1 {
  returnsOne: boolean;
  required?: unknown;
  query: RelationConfigQuery;
  joinQuery: RelationJoinQuery$1;
  reverseJoin: RelationJoinQuery$1;
  params: unknown;
  queryRelated(params: unknown): unknown;
  modifyRelatedQuery?(relatedQuery: IsQuery$1): (query: IsQuery$1) => void;
  omitForeignKeyInCreate: PropertyKey;
  dataForUpdate: unknown;
  dataForUpdateOne: unknown;
  primaryKeys: string[];
}
interface RelationConfigDataForCreate {
  columns: PropertyKey;
  nested: RecordUnknown$1;
}
interface RelationsBase$1 {
  [relationName: string]: RelationConfigBase$1;
}
interface RelationsDataForCreateBase {
  [relationName: string]: unknown;
}
interface RelationsDataForCreateOptionalBase {
  [relationName: string]: unknown;
}
type RelationQueryMaybeSingle<T extends RelationConfigBase$1> = T['returnsOne'] extends true ? T['required'] extends true ? QueryManyTake$1<T['query']> : QueryManyTakeOptional$1<T['query']> : T['query'];
interface SubQueryForSql extends ToSQLQuery {
  __forSql: true;
}
interface HasBeforeAndBeforeSet {
  before?: QueryBeforeHook$1[];
  beforeSet?: QueryData$1['beforeSet'];
}
interface ColumnsShape$1 {
  [K: string]: Column$1;
}
declare namespace ColumnsShape$1 {
  export type DefaultSelectKeys<S extends Column$1.QueryColumnsInit> = { [K in keyof S]: S[K]['data']['explicitSelect'] extends true | undefined ? never : K; }[keyof S];
  export type DefaultOutput<Set extends Column$1.QueryColumnsInit> = { [K in DefaultSelectKeys<Set>]: Set[K]['__outputType']; };
  export type Input<Shape extends Column$1.QueryColumnsInit, AppReadOnly = { [K in keyof Shape]: Shape[K]['data']['appReadOnly'] extends true ? K : never; }[keyof Shape], Optional extends keyof Shape = { [K in keyof Shape]: Shape[K]['data']['optional'] extends true ? K : never; }[keyof Shape]> = { [K in Exclude<keyof Shape, AppReadOnly | Optional>]: Shape[K]['__inputType']; } & { [K in Exclude<Optional, AppReadOnly>]?: Shape[K]['__inputType']; };
  export type InputPartial<Shape extends Column$1.QueryColumnsInit> = { [K in keyof Shape]?: Shape[K]['__inputType']; };
  export type Output<Shape extends Column$1.QueryColumns> = { [K in keyof Shape]: Shape[K]['__outputType']; };
  export type DefaultSelectOutput<Shape extends Column$1.QueryColumnsInit> = { [K in { [K in keyof Shape]: Shape[K]['data']['explicitSelect'] extends true | undefined ? never : K; }[keyof Shape]]: Shape[K]['__outputType']; };
  export interface MapToObjectColumn<Shape extends Column$1.QueryColumns> {
    dataType: 'object';
    __type: { [K in keyof Shape]: Shape[K]['__type']; };
    __outputType: ShallowSimplify$1<ObjectOutput<Shape>>;
    __queryType: { [K in keyof Shape]: Shape[K]['__queryType']; };
    operators: OperatorsAny;
  }
  export interface MapToNullableObjectColumn<Shape extends Column$1.QueryColumns> {
    dataType: 'object';
    __type: { [K in keyof Shape]: Shape[K]['__type']; };
    __outputType: ShallowSimplify$1<ObjectOutput<Shape>> | undefined;
    __queryType: { [K in keyof Shape]: Shape[K]['__queryType']; } | null;
    operators: OperatorsAny;
  }
  export interface MapToPluckColumn<Shape extends Column$1.QueryColumns> {
    dataType: 'array';
    __type: Shape['pluck']['__type'][];
    __outputType: Shape['pluck']['__outputType'][];
    __queryType: Shape['pluck']['__queryType'][];
    operators: OperatorsAny;
  }
  export interface MapToObjectArrayColumn<Shape extends Column$1.QueryColumns> {
    dataType: 'array';
    __type: { [K in keyof Shape]: Shape[K]['__type']; }[];
    __outputType: ShallowSimplify$1<ObjectOutput<Shape>>[];
    __queryType: { [K in keyof Shape]: Shape[K]['__queryType']; }[];
    operators: OperatorsAny;
  }
  type ObjectOutput<Shape extends Column$1.QueryColumns> = { [K in keyof Shape]: Shape[K]['__outputType']; };
  export {};
}
declare abstract class OrchidOrmError extends Error {}
declare class OrchidOrmInternalError extends Error {
  #private;
  data?: RecordUnknown$1 | undefined;
  constructor(query: IsQuery$1, message?: string, data?: RecordUnknown$1 | undefined);
  getQuery(): Query;
}
type QueryErrorName = 'parseComplete' | 'bindComplete' | 'closeComplete' | 'noData' | 'portalSuspended' | 'replicationStart' | 'emptyQuery' | 'copyDone' | 'copyData' | 'rowDescription' | 'parameterDescription' | 'parameterStatus' | 'backendKeyData' | 'notification' | 'readyForQuery' | 'commandComplete' | 'dataRow' | 'copyInResponse' | 'copyOutResponse' | 'authenticationOk' | 'authenticationMD5Password' | 'authenticationCleartextPassword' | 'authenticationSASL' | 'authenticationSASLContinue' | 'authenticationSASLFinal' | 'error' | 'notice';
declare abstract class QueryError<T extends PickQueryShape$1 = PickQueryShape$1> extends OrchidOrmInternalError {
  #private;
  message: string;
  length?: number;
  name: QueryErrorName;
  stack: string | undefined;
  code: string | undefined;
  detail: string | undefined;
  severity: string | undefined;
  hint: string | undefined;
  position: string | undefined;
  internalPosition: string | undefined;
  internalQuery: string | undefined;
  where: string | undefined;
  schema: string | undefined;
  table: string | undefined;
  column: string | undefined;
  dataType: string | undefined;
  constraint: string | undefined;
  file: string | undefined;
  line: string | undefined;
  routine: string | undefined;
  get isUnique(): boolean;
  get columns(): { [K in keyof T["shape"]]?: true | undefined; };
}
declare class CannotMutateReadOnlyTableError extends OrchidOrmInternalError {
  constructor(query: IsQuery$1);
}
type HookPurpose = 'Create' | 'Update' | 'Delete';
interface HasCteHooks {
  cteHooks?: CteHooks;
}
interface CteHooks {
  hasSelect?: boolean;
  tableHooks?: CteTableHooks;
  ensureCount?: EnsureCount;
}
interface EnsureCount {
  [cteName: string]: EnsureCountItem;
}
type EnsureCountItem = {
  count: number;
  message?: string;
} | {
  jsonNotNull: string;
  message?: string;
};
interface CteTableHooks {
  [K: string]: CteTableHook;
}
interface CteTableHook {
  table: string;
  shape: Column$1.Shape.Data;
  tableHook: TableHook;
  throwOnNotFound?: boolean;
}
interface TableHook {
  hookPurpose?: HookPurpose;
  select?: HookSelect;
  afterCreate?: QueryAfterHook$1[];
  afterUpdate?: QueryAfterHook$1[];
  afterSave?: QueryAfterHook$1[];
  afterDelete?: QueryAfterHook$1[];
  afterCreateCommit?: QueryAfterHook$1[];
  afterUpdateCommit?: QueryAfterHook$1[];
  afterSaveCommit?: QueryAfterHook$1[];
  afterDeleteCommit?: QueryAfterHook$1[];
}
type HookSelect = Map<string, HookSelectValue$1>;
interface HookSelectValue$1 {
  select: string | {
    sql: string;
  };
  as?: string;
  temp?: string;
  onAs?: ((as: string) => void)[];
  notLoaded?: boolean;
}
interface HasTableHook {
  tableHook?: TableHook;
}
interface HasHookSelect {
  hookSelect?: HookSelect;
}
interface SqlJoinExpression<T extends Column$1.Pick.QueryColumn> extends Expression$1<T>, ExpressionTypeMethod {}
declare class SqlJoinExpression<T extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumn> extends Expression$1<T> {
  items: readonly unknown[];
  separator?: RawSqlBase$1 | undefined;
  result: {
    value: T;
  };
  q: ExpressionData$1;
  constructor(items: readonly unknown[], separator?: RawSqlBase$1 | undefined);
  makeSQL(ctx: ToSqlValues$1, quotedAs?: string): string;
}
/**
 * Expression for a SQL identifier reference.
 * Used to safely quote identifiers in raw SQL queries.
 */
declare class SqlRefExpression extends Expression$1 {
  name: string;
  result: {
    value: Column$1.Pick.QueryColumn;
  };
  q: ExpressionData$1;
  constructor(name: string);
  makeSQL(): string;
}
declare class ValExpression$1<T> extends Expression$1 {
  value: unknown;
  result: {
    value: Column$1.Pick.QueryColumnOfType<T>;
  };
  q: ExpressionData$1;
  constructor(value: unknown);
  makeSQL(ctx: ToSqlValues$1): string;
}
interface PostgresInterval {
  years: number;
  months: number;
  days: number;
  hours: number;
  minutes: number;
  seconds: number;
  milliseconds: number;
}
interface ColumnSchemaGetterTableClass$1 {
  data?: {
    table: string | undefined;
    name: string | undefined;
  };
  prototype: {
    columns: {
      shape: Column$1.Shape.ForValidation;
    };
  };
  inputSchema(): unknown;
  querySchema(): unknown;
  pkeySchema(): unknown;
  createSchema(): unknown;
}
interface ColumnTypeSchemaArg$1 {
  __schemaType: unknown;
  nullable: unknown;
  encode: unknown;
  parse: unknown;
  parseNull: unknown;
  asType: unknown;
  narrowType: unknown;
  narrowAllTypes: unknown;
  error?: unknown;
}
interface ColumnSchemaConfig$1<T extends Column$1.Pick.Data = Column$1.Pick.Data> extends ColumnTypeSchemaArg$1 {
  intervalParse?(input: unknown): PostgresInterval;
  dateAsNumber: unknown;
  dateAsDate: unknown;
  enum: unknown;
  array: unknown;
  boolean(): unknown;
  buffer(): unknown;
  unknown(): unknown;
  never(): unknown;
  stringSchema(): unknown;
  stringMin(max: number): unknown;
  stringMax(max: number): unknown;
  stringMinMax(min: number, max: number): unknown;
  number(): unknown;
  int(): unknown;
  stringNumberDate(): unknown;
  timeInterval(): unknown;
  bit(max?: number): unknown;
  uuid(): unknown;
  json(): T;
  jsonText(): T;
  inputSchema(this: ColumnSchemaGetterTableClass$1): unknown;
  outputSchema(this: ColumnSchemaGetterTableClass$1): unknown;
  querySchema(this: ColumnSchemaGetterTableClass$1): unknown;
  createSchema(this: ColumnSchemaGetterTableClass$1): unknown;
  updateSchema(this: ColumnSchemaGetterTableClass$1): unknown;
  pkeySchema(this: ColumnSchemaGetterTableClass$1): unknown;
  smallint(): T;
  integer(): T;
  real(): T;
  smallSerial(): T;
  serial(): T;
  bigint(): T;
  decimal(precision?: number, scale?: number): T;
  doublePrecision(): T;
  bigSerial(): T;
  money(): T;
  varchar(limit?: number): T;
  text(): T;
  string(limit?: number): T;
  citext(): T;
  date(): T;
  timestampNoTZ(precision?: number): T;
  timestamp(precision?: number): T;
  geographyPointSchema(): unknown;
}
type SimpleJoinItemNonSubQueryArgs = [{
  [K: string]: string | Expression$1;
} | Expression$1 | true] | [leftColumn: string | Expression$1, rightColumn: string | Expression$1] | [leftColumn: string | Expression$1, op: string, rightColumn: string | Expression$1];
type JoinItemArgs = {
  u?: true;
  x: RawSql$1;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  l: SubQueryForSql;
  a: string;
  i?: boolean;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  j: IsQuery$1;
  s: boolean;
  r?: IsQuery$1;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  w: string;
  r: IsQuery$1;
  s: boolean;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  w: string;
  a: SimpleJoinItemNonSubQueryArgs;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  q: IsQuery$1;
  s: boolean;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  q: IsQuery$1;
  r: IsQuery$1;
  s: boolean;
} | {
  u?: true;
  c?: Column$1.QueryColumns;
  q: IsQuery$1;
  a: SimpleJoinItemNonSubQueryArgs;
  s: boolean;
} | {
  u?: true;
  c: Column$1.Shape.Data;
  a: string;
  d: RecordUnknown$1[];
};
interface JoinItem {
  type: string;
  args: JoinItemArgs;
}
type WithSelectable<W extends WithDataItem> = keyof W['shape'] | `${W['table']}.${keyof W['shape'] & string}`;
/**
 * The first argument of all `join` and `joinLateral` methods.
 * See argument of {@link join}.
 */
type JoinFirstArg<T extends PickQueryRelationsWithData> = PickQueryResultAs | keyof T['relations'] | keyof T['withData'] | ((q: { [K in keyof T['relations']]: T['relations'][K]['query']; }) => PickQueryResultAs) | FnPickQueryResultAs;
interface FnPickQueryResultAs {
  (): PickQueryResultAs;
}
/**
 * Arguments of `join` methods (not `joinLateral`).
 * See {@link join}
 */
type JoinArgs<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>> = Arg extends PickQueryResultAs ? [conditions: { [K in JoinSelectable<Arg>]: keyof T['__selectable'] | Expression$1; } | Expression$1] | [leftColumn: JoinSelectable<Arg> | Expression$1, rightColumn: keyof T['__selectable'] | Expression$1] | [leftColumn: JoinSelectable<Arg> | Expression$1, op: string, rightColumn: keyof T['__selectable'] | Expression$1] : Arg extends keyof T['withData'] ? JoinWithArgs<T, T['withData'][Arg]> : EmptyTuple$1;
/**
 * Column names of the joined table that can be used to join.
 * Derived from 'result', not from 'shape',
 * because if the joined table has a specific selection, it will be wrapped like:
 * ```sql
 * JOIN (SELECT something FROM joined) joined ON joined.something = ...
 * ```
 * And the selection becomes available to use in the `ON` and to select from the joined table.
 */
type JoinSelectable<Q extends PickQueryResultAs> = keyof Q['result'] | `${Q['__as']}.${keyof Q['result'] & string}`;
type JoinWithArgs<T extends PickQuerySelectable, Arg extends WithDataItem> = [conditions: { [K in WithSelectable<Arg>]: keyof T['__selectable'] | Expression$1; } | Expression$1] | [leftColumn: WithSelectable<Arg> | Expression$1, rightColumn: keyof T['__selectable'] | Expression$1] | [leftColumn: WithSelectable<Arg> | Expression$1, op: string, rightColumn: keyof T['__selectable'] | Expression$1];
type JoinResultRequireMain<T extends PickQuerySelectable, JoinedSelectable> = { [K in keyof T]: K extends '__selectable' ? T['__selectable'] & JoinedSelectable : T[K]; };
/**
 * Result of all `join` methods, not `joinLateral`.
 * Adds joined table columns from its 'result' to the '__selectable' of the query.
 */
type JoinResult<T extends PickQuerySelectableRelationsResultReturnType, Joined extends PickQuerySelectableRelations$1, RequireMain> = RequireMain extends true ? { [K in keyof T]: K extends '__selectable' ? T['__selectable'] & Joined['__selectable'] : K extends 'relations' ? { [K in keyof T['relations'] | keyof Joined['relations']]: K extends keyof Joined['relations'] ? Joined['relations'][K] : T['relations'][K]; } : T[K]; } : { [K in keyof T]: K extends '__selectable' ? { [K in keyof T['__selectable']]: {
  as: T['__selectable'][K]['as'];
  column: Column$1.QueryColumnToNullable<T['__selectable'][K]['column']>;
}; } & Joined['__selectable'] : K extends 'result' ? { [K in keyof T['result']]: Column$1.QueryColumnToNullable<T['result'][K]>; } : K extends 'then' ? QueryThenByQuery<T, { [K in keyof T['result']]: Column$1.QueryColumnToNullable<T['result'][K]>; }> : K extends 'relations' ? { [K in keyof T['relations'] | keyof Joined['relations']]: K extends keyof Joined['relations'] ? Joined['relations'][K] : T['relations'][K]; } : T[K]; };
/**
 * Calls {@link JoinResult} with either callback result, if join has a callback,
 * or with a query derived from the first join argument.
 */
type JoinResultFromArgs<T extends PickQuerySelectableResultRelationsWithDataReturnType, Arg, Args extends unknown[], RequireJoined, RequireMain> = JoinResult<T, Args[0] extends GenericJoinCallback ? JoinResultSelectable<ReturnType<Args[0]>['result'], ReturnType<Args[0]>['__as'], ReturnType<Args[0]>['relations'], RequireJoined> : Arg extends PickQueryHasSelectResultShapeAsRelations ? JoinResultSelectable<Arg['__hasSelect'] extends true ? Arg['result'] : Arg['shape'], Arg['__as'], Arg['relations'], RequireJoined> : Arg extends keyof T['relations'] ? JoinResultSelectable<T['relations'][Arg]['query']['shape'], T['relations'][Arg]['query']['__as'], T['relations'][Arg]['query']['relations'], RequireJoined> : Arg extends FirstArgCallback ? JoinResultSelectable<ReturnType<Arg>['shape'], ReturnType<Arg>['__as'], ReturnType<Arg>['relations'], RequireJoined> : Arg extends keyof T['withData'] ? T['withData'][Arg] extends WithDataItem ? JoinResultSelectable<T['withData'][Arg]['shape'], T['withData'][Arg]['table'], EmptyObject$1, RequireJoined> : never : never, RequireMain>;
interface GenericJoinCallback {
  (...args: any[]): PickQueryResultAsRelations;
}
interface FirstArgCallback {
  (...args: any[]): PickQueryShapeAsRelations;
}
/**
 * Result of all `joinLateral` methods.
 * Adds joined table columns from its 'result' to the '__selectable' of the query.
 *
 * @param T - query type to join to
 * @param Arg - first arg of join, see {@link JoinFirstArg}
 * @param RequireJoined - when false, joined table shape will be mapped to make all columns optional
 */
type JoinLateralResult<T extends PickQuerySelectable, As extends string, Result extends Column$1.QueryColumns, JoinedRelations extends RelationsBase$1, RequireJoined> = JoinAddSelectable<T, JoinResultSelectable<Result, As, JoinedRelations, RequireJoined>>;
/**
 * Build `selectable` type for joined table.
 *
 * When `RequireJoined` parameter is false,
 * the result type of the joined table will be mapped to make all columns optional.
 *
 * Callback may override the joined table alias.
 *
 * The resulting selectable receives all joined table columns prefixed with the table name or alias,
 * and a star prefixed with the table name or alias to select all joined columns.
 */
type JoinResultSelectable<Result extends Column$1.QueryColumns, As extends string, JoinedRelations, RequireJoined> = RequireJoined extends true ? {
  __selectable: { [K in '*' | (keyof Result & string) as `${As}.${K}`]: K extends '*' ? {
    as: As;
    column: ColumnsShape$1.MapToObjectColumn<Result>;
  } : {
    as: K;
    column: Result[K];
  }; };
  relations: { [K in keyof JoinedRelations & string as `${As}.${K}`]: JoinedRelations[K]; };
} : {
  __selectable: { [K in '*' | (keyof Result & string) as `${As}.${K}`]: K extends '*' ? {
    as: As;
    column: ColumnsShape$1.MapToNullableObjectColumn<Result>;
  } : {
    as: K;
    column: Column$1.QueryColumnToNullable<Result[K]>;
  }; };
  relations: { [K in keyof JoinedRelations & string as `${As}.${K}`]: JoinedRelations[K]; };
};
type JoinAddSelectable<T extends PickQuerySelectable, Joined extends PickQuerySelectableRelations$1> = { [K in keyof T]: K extends '__selectable' ? T['__selectable'] & Joined['__selectable'] : T[K]; };
/**
 * Map the first argument of `join` or `joinLateral` to a query type.
 *
 * `with` table arg is mapped into `QueryBase`,
 * query arg is returned as is,
 * relation name is replaced with a relation table.
 */
type JoinArgToQuery<T extends PickQueryRelationsWithData, Arg extends JoinFirstArg<T>> = Arg extends keyof T['withData'] ? T['withData'][Arg] extends WithDataItem ? { [K in 'result' | '__as' | keyof T]: K extends '__as' ? T['withData'][Arg]['table'] : K extends '__selectable' ? { [K in keyof T['withData'][Arg]['shape'] & string as `${T['withData'][Arg]['table']}.${K}`]: {
  as: K;
  column: T['withData'][Arg]['shape'][K];
}; } : K extends 'result' ? T['withData'][Arg]['shape'] : K extends keyof T ? T[K] : never; } : never : Arg extends PickQuerySelectableResultAs ? Arg : Arg extends keyof T['relations'] ? T['relations'][Arg]['query'] : Arg extends JoinArgToQueryCallback ? ReturnType<Arg> : never;
interface JoinArgToQueryCallback {
  (...args: any[]): IsQuery$1;
}
/**
 * Type of the `join` callback (not `joinLateral`).
 *
 * Receives a query builder that can access columns of both the main and the joined table.
 *
 * The query builder is limited to `or` and `where` methods only.
 *
 * Callback must return a query builder.
 */
interface JoinCallback<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>> {
  (q: JoinQueryBuilder<T, JoinArgToQuery<T, Arg>>): IsQuery$1;
}
type JoinCallbackArgs<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>> = [cb?: JoinCallback<T, Arg> | true];
declare class QueryJoin {
  /**
   * ## Select relation
   *
   * Before joining a table, consider if selecting a relation is enough for your case:
   *
   * ```ts
   * // select users with profiles
   * // result type is Array<{ name: string, profile: Profile }>
   * await db.user.select('name', {
   *   profile: (q) => q.profile,
   * });
   *
   * // select posts with counts of comments, filter and order by comments count
   * // result type is Array<Post & { commentsCount: number }>
   * await db.post
   *   .select('*', {
   *     commentsCount: (q) => q.comments.count(),
   *   })
   *   .where({ commentsCount: { gt: 10 } })
   *   .order({ commentsCount: 'DESC' });
   *
   * // select authors with array of their book titles
   * // result type is Array<Author & { books: string[] }>
   * await db.author.select('*', {
   *   books: (q) => q.books.pluck('title'),
   * });
   * ```
   *
   * Internally, such selects will use `LEFT JOIN LATERAL` to join a relation.
   * If you're loading users with profiles (one-to-one relation), and some users don't have a profile, `profile` property will have `NULL` for such users.
   * If you want to load only users that have profiles, and filter out the rest, add `.join()` method to the relation without arguments:
   *
   * ```ts
   * // load only users who have a profile
   * await db.user.select('*', {
   *   profile: (q) => q.profile.join(),
   * });
   *
   * // load only users who have a specific profile
   * await db.user.select('*', {
   *   profile: (q) => q.profile.join().where({ age: { gt: 20 } }),
   * });
   * ```
   *
   * You can also use this `.join()` method on the one-to-many relations, and records with empty array will be filtered out:
   *
   * ```ts
   * // posts that have no tags won't be loaded
   * // result type is Array<Post & { tags: Tag[] }>
   * db.post.select('*', {
   *   tags: (q) => q.tags.join(),
   * });
   * ```
   *
   * # join
   *
   * `join` methods allows to join other tables, relations by name, [with](/guide/advanced-queries#with) statements, sub queries.
   *
   * All the `join` methods accept the same arguments, but returning type is different because with `join` it's guaranteed to load joined table, and with `leftJoin` the joined table columns may be `NULL` when no matching record was found.
   *
   * For the following examples, imagine you have a `User` table with `id` and `name`, and `Message` table with `id`, `text`, messages belongs to user via `userId` column:
   *
   * ```ts
   * export const UserTable = defineTable('user', (t) => ({
   *   id: t.identity().primaryKey(),
   *   name: t.text(),
   * })).relations((user) => ({
   *   messages: user('id').hasMany(() => MessageTable('userId')),
   * }));
   *
   * export const MessageTable = defineTable('message', (t) => ({
   *   id: t.identity().primaryKey(),
   *   userId: t.integer(),
   *   text: t.text(),
   *   ...t.timestamps(),
   * })).relations((message) => ({
   *   user: message('userId').belongsTo(() => UserTable('id')),
   * }));
   * ```
   *
   * `join` is a method for SQL `JOIN`, which is equivalent to `INNER JOIN`, `LEFT INNERT JOIN`.
   *
   * When no matching record is found, it will skip records of the main table.
   *
   * ### join relation
   *
   * When relations are defined between the tables, you can join them by a relation name.
   * Joined table can be references from `where` and `select` by a relation name.
   *
   * ```ts
   * const result = await db.user
   *   .join('messages')
   *   // after joining a table, you can use it in `where` conditions:
   *   .where({ 'messages.text': { startsWith: 'Hi' } })
   *   .select(
   *     'name', // name is User column, table name may be omitted
   *     'messages.text', // text is the Message column, and the table name is required
   *   );
   *
   * // result has the following type:
   * const ok: { name: string; text: string }[] = result;
   * ```
   *
   * The first argument can also be a callback, where instead of relation name as a string you're picking it as a property of `q`.
   * In such a way, you can alias the relation with `as`, add `where` conditions, use other query methods.
   *
   * ```ts
   * const result = await db.user.join((q) =>
   *   q.messages.as('m').where({ text: 'some text' }),
   * );
   * ```
   *
   * Optionally, you can pass a second callback argument, it makes `on` and `orOn` methods available.
   *
   * But remember that when joining a relation, the relevant `ON` conditions are already handled automatically.
   *
   * ```ts
   * const result = await db.user.join(
   *   (q) => q.messages.as('m'),
   *   (q) =>
   *     q
   *       .on('messages.text', 'user.name') // additionally, match message with user name
   *       .where({ text: 'some text' }), // you can add `where` in a second callback as well.
   * );
   * ```
   *
   * ### join a relation of the joined
   *
   * After joining a relation or a table:
   *
   * ```ts
   * db.post.join('comments');
   *
   * db.post.join(() => db.comment);
   * ```
   *
   * You can join a relation of that joined table:
   *
   * ```ts
   * db.post.join('comments').join('comments.author');
   *
   * db.post.join(() => db.comment).join('comment.author');
   * ```
   *
   * Note that in the first case it's `comments` - a relation name, while in the second case it is a table name.
   *
   * ### joins deduplication
   *
   * When joining the same table with the same condition more than once, duplicated joins will be ignored:
   *
   * ```ts
   * // joining a relation
   * db.post.join('comments').join('comments');
   *
   * // joining a table with a condition
   * db.post
   *   .join('comments', 'comments.postId', 'post.id')
   *   .join('comments', 'comments.postId', 'post.id');
   * ```
   *
   * Both queries will produce SQL with only 1 join
   *
   * ```sql
   * SELECT * FROM post JOIN comments ON comments.postId = post.id
   * ```
   *
   * However, this is only possible if the join has no dynamic values:
   *
   * ```ts
   * db.post
   *   .join('comments', (q) => q.where({ rating: { gt: 5 } }))
   *   .join('comments', (q) => q.where({ rating: { gt: 5 } }));
   * ```
   *
   * Both joins above have the same `{ gt: 5 }`, but still, the `5` is a dynamic value and in this case joins will be duplicated,
   * resulting in a database error.
   *
   * ### select full joined records
   *
   * `select` supports selecting a full record of a previously joined table by passing a table name with `.*` at the end:
   *
   * ```ts
   * const result = await db.book.join('author').select('title', {
   *   author: 'author.*',
   * });
   *
   * // result has the following type:
   * const ok: {
   *   // title of the book
   *   title: string;
   *   // a full author record is included:
   *   author: { id: number; name: string; updatedAt: Date; createdAt: Date };
   * }[] = result;
   * ```
   *
   * It works fine for `1:1` (`belongsTo`, `hasOne`) relations, but it may have an unexpected result for `1:M` or `M:M` (`hasMany`, `hasAndBelongsToMany`) relations.
   * For any kind of relation, it results in one main table record with data of exactly one joined table record, i.e. when selecting in this way, the records **won't** be collected into arrays.
   *
   * ```ts
   * const result = await db.user
   *   .join('messages')
   *   .where({ 'messages.text': { startsWith: 'Hi' } })
   *   .select('name', { messages: 'messages.*' });
   *
   * // result has the following type:
   * const ok: {
   *   name: string;
   *   // full message is included:
   *   messages: { id: number; text: string; updatedAt: Date; createdAt: Date };
   * }[] = result;
   * ```
   *
   * Because it's a one-to-many relation, one user has many messages, the user data will be duplicated for different messages data:
   *
   * | name   | msg                            |
   * | ------ | ------------------------------ |
   * | user 1 | `{ id: 1, text: 'message 1' }` |
   * | user 1 | `{ id: 2, text: 'message 2' }` |
   * | user 1 | `{ id: 3, text: 'message 3' }` |
   *
   * ### join table
   *
   * If relation wasn't defined, provide a `db.table` instance and specify columns for the join.
   * Joined table can be references from `where` and `select` by a table name.
   *
   * ```ts
   * db.user
   *   .join(db.message, 'userId', 'user.id')
   *   .where({ 'message.text': { startsWith: 'Hi' } })
   *   .select('name', 'message.text');
   * ```
   *
   * The name of the joining table can be omitted, but not the name of the main table:
   *
   * ```ts
   * db.user.join(db.message, 'userId', 'user.id');
   * ```
   *
   * Joined table can have an alias for referencing it further:
   *
   * ```ts
   * db.user
   *   .join(db.message.as('m'), 'message.userId', 'user.id')
   *   .where({ 'm.text': { startsWith: 'Hi' } })
   *   .select('name', 'm.text');
   * ```
   *
   * Joined table can be selected as an object as well as the relation join above:
   *
   * ```ts
   * const result = await db.user
   *   .join(db.message.as('m'), 'message.userId', 'user.id')
   *   .where({ 'm.text': { startsWith: 'Hi' } })
   *   .select('name', { msg: 'm.*' });
   *
   * // result has the following type:
   * const ok: {
   *   name: string;
   *   // full message is included as msg:
   *   msg: { id: number; text: string; updatedAt: Date; createdAt: Date };
   * }[] = result;
   * ```
   *
   * You can provide a custom comparison operator
   *
   * ```ts
   * db.user.join(db.message, 'userId', '!=', 'user.id');
   * ```
   *
   * Join can accept raw SQL for the `ON` part of join:
   *
   * ```ts
   * db.user.join(
   *   db.message,
   *   // `sql` can be imported from your table factory file
   *   sql`lower("message"."text") = lower("user"."name")`,
   * );
   * ```
   *
   * Join can accept raw SQL instead of columns:
   *
   * ```ts
   * db.user.join(
   *   db.message,
   *   sql`lower("message"."text")`,
   *   sql`lower("user"."name")`,
   * );
   *
   * // with operator:
   * db.user.join(
   *   db.message,
   *   sql`lower("message"."text")`,
   *   '!=',
   *   sql`lower("user"."name")`,
   * );
   * ```
   *
   * To join based on multiple columns, you can provide an object where keys are joining table columns, and values are main table columns or a raw SQL:
   *
   * ```ts
   * db.user.join(db.message, {
   *   'message.userId': 'user.id',
   *
   *   // joined table name may be omitted
   *   userId: 'user.id',
   *
   *   // value can be a raw SQL expression:
   *   text: sql`lower("user"."name")`,
   * });
   * ```
   *
   * Join all records without conditions by providing `true`:
   *
   * ```ts
   * db.user.join(db.message, true);
   * ```
   *
   * Join methods can accept a callback with a special query builder that has `on` and `orOn` methods for handling advanced cases:
   *
   * ```ts
   * db.user.join(
   *   db.message,
   *   (q) =>
   *     q
   *       .on('message.userId', 'user.id')
   *       // joined table name may be omitted
   *       .on('userId', 'user.id')
   *       // operator can be specified:
   *       .on('userId', '!=', 'user.id')
   *       // operator can be specified with table names as well:
   *       .on('message.userId', '!=', 'user.id')
   *       // `.orOn` takes the same arguments as `.on` and acts like `.or`:
   *       .on('userId', 'user.id') // where message.userId = user.id
   *       .orOn('text', 'user.name'), // or message.text = user.name
   * );
   * ```
   *
   * Column names in the where conditions are applied for the joined table, but you can specify a table name to add a condition for the main table.
   *
   * ```ts
   * db.user.join(db.message, (q) =>
   *   q
   *     .on('userId', 'user.id')
   *     .where({
   *       // not prefixed column name is for joined table:
   *       text: { startsWith: 'hello' },
   *       // specify a table name to set condition on the main table:
   *       'user.name': 'Bob',
   *     })
   *     // id is a column of a joined table Message
   *     .whereIn('id', [1, 2, 3])
   *     // condition for id of a user
   *     .whereIn('user.id', [4, 5, 6]),
   * );
   * ```
   *
   * The query above will generate the following SQL (simplified):
   *
   * ```sql
   * SELECT * FROM "user"
   * JOIN "message"
   *   ON "message"."userId" = "user"."id"
   *  AND "message"."text" ILIKE 'hello%'
   *  AND "user"."name" = 'Bob'
   *  AND "message"."id" IN (1, 2, 3)
   *  AND "user"."id" IN (4, 5, 6)
   * ```
   *
   * The join argument can be a query with `select`, `where`, and other methods. In such case, it will be handled as a sub query:
   *
   * ```ts
   * db.user.join(
   *   db.message
   *     .select('id', 'userId', 'text')
   *     .where({ text: { startsWith: 'Hi' } })
   *     .as('t'),
   *   'userId',
   *   'user.id',
   * );
   * ```
   *
   * It will produce such SQL:
   *
   * ```sql
   * SELECT * FROM "user"
   * JOIN (
   *   SELECT "t"."id", "t"."userId", "t"."text"
   *   FROM "message" AS "t"
   * ) "t" ON "t"."userId" = "user"."id"
   * ```
   *
   * ## implicit join lateral
   *
   * `JOIN`'s source expression that comes before `ON` cannot access other tables, but in some cases this may be needed.
   *
   * For example, let's consider joining last 10 messages of a user:
   *
   * ```ts
   * await db.user.join('messages', (q) => q.order({ createdAt: 'DESC' }).limit(10));
   * ```
   *
   * When the `join`'s callback returns a more complex query than the one that simply applies certain conditions,
   * it will implicitly generate a `JOIN LATERAL` SQL query, as the following:
   *
   * ```sql
   * SELECT *
   * FROM "user"
   * JOIN LATERAL (
   *   SELECT *
   *   FROM "message" AS "messages"
   *   WHERE "message"."userId" = "user"."id"
   *   ORDER BY "message"."createdAt" DESC
   *   LIMIT 10
   * ) "messages" ON true
   * ```
   *
   * @param arg - {@link JoinFirstArg}
   * @param args - {@link JoinArgs}
   */
  join<T extends PickQuerySelectableShapeRelationsWithDataAsResultReturnType, Arg extends JoinFirstArg<T>, Cb extends JoinCallbackArgs<T, Arg>>(this: T, arg: Arg, ...args: Cb | JoinArgs<T, Arg>): JoinResultFromArgs<T, Arg, Cb, true, true>;
  /**
   * `leftJoin` is a method for SQL `LEFT JOIN`, which is equivalent to `OUTER JOIN`, `LEFT OUTER JOIN`.
   *
   * When no matching record is found, it will fill joined table columns with `NULL` values in the result rows.
   *
   * Works just like `join`, except for result type that may have `null`:
   *
   * ```ts
   * const result = await db.user
   *   .leftJoin('messages')
   *   .select('name', 'messages.text');
   *
   * // the same query, but joining table explicitly
   * const result2: typeof result = await db.user
   *   .leftJoin(db.message, 'userId', 'user.id')
   *   .select('name', 'message.text');
   *
   * // result has the following type:
   * const ok: { name: string; text: string | null }[] = result;
   * ```
   *
   * @param arg - {@link JoinFirstArg}
   * @param args - {@link JoinArgs}
   */
  leftJoin<T extends PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs, Arg extends JoinFirstArg<T>, Cb extends JoinCallbackArgs<T, Arg>>(this: T, arg: Arg, ...args: Cb | JoinArgs<T, Arg>): JoinResultFromArgs<T, Arg, Cb, false, true>;
  /**
   * `rightJoin` is a method for SQL `RIGHT JOIN`, which is equivalent to `RIGHT OUTER JOIN`.
   *
   * Takes the same arguments as `json`.
   *
   * It will load all records from the joining table, and fill the main table columns with `null` when no match is found.
   *
   * The columns of the table you're joining to are becoming nullable when using `rightJoin`.
   *
   * ```ts
   * const result = await db.user
   *   .rightJoin('messages')
   *   .select('name', 'messages.text');
   *
   * // even though name is not a nullable column, it becomes nullable after using rightJoin
   * const ok: { name: string | null; text: string }[] = result;
   * ```
   *
   * @param arg - {@link JoinFirstArg}
   * @param args - {@link JoinArgs}
   */
  rightJoin<T extends PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs, Arg extends JoinFirstArg<T>, Cb extends JoinCallbackArgs<T, Arg>>(this: T, arg: Arg, ...args: Cb | JoinArgs<T, Arg>): JoinResultFromArgs<T, Arg, Cb, true, false>;
  /**
   * `fullJoin` is a method for SQL `FULL JOIN`, which is equivalent to `FULL OUTER JOIN`.
   *
   * Takes the same arguments as `json`.
   *
   * It will load all records from the joining table, both sides of the join may result in `null` values when there is no match.
   *
   * All columns become nullable after using `fullJoin`.
   *
   * ```ts
   * const result = await db.user
   *   .rightJoin('messages')
   *   .select('name', 'messages.text');
   *
   * // all columns can be null
   * const ok: { name: string | null; text: string | null }[] = result;
   * ```
   *
   * @param arg - {@link JoinFirstArg}
   * @param args - {@link JoinArgs}
   */
  fullJoin<T extends PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs, Arg extends JoinFirstArg<T>, Cb extends JoinCallbackArgs<T, Arg>>(this: T, arg: Arg, ...args: Cb | JoinArgs<T, Arg>): JoinResultFromArgs<T, Arg, Cb, false, false>;
  /**
   * `joinLateral` allows joining a table with a sub-query that can reference the main table of current query and the other joined tables.
   *
   * First argument is the other table you want to join, or a name of relation, or a name of `with` defined table.
   *
   * Second argument is a callback where you can reference other tables using `on` and `orOn`, select columns, do `where` conditions, and use any other query methods to build a sub-query.
   *
   * Note that the regular `join` will also generate `JOIN LATERAL` SQL expression when the query returned from callback is complex enough (see the bottom of {@link join} description).
   *
   * ```ts
   * // joinLateral messages relation, alias it as `m`
   * // without aliasing you can refer to the message by a table name
   * db.user
   *   .joinLateral(db.message.as('m'), (q) =>
   *     q
   *       // select message columns
   *       .select('text')
   *       // join the message to the user, column names can be prefixed with table names
   *       .on('authorId', 'user.id')
   *       // message columns are available without prefixing,
   *       // outer table columns are available with a table name
   *       .where({ text: 'some text', 'user.name': 'name' })
   *       .order({ createdAt: 'DESC' }),
   *   )
   *   // only selected message columns are available in select and where
   *   .select('id', 'name', 'm.text')
   *   .where({ 'm.text': messageData.text });
   * ```
   *
   * As well as simple `join`, `joinLateral` can select an object of full joined record:
   *
   * ```ts
   * // join by relation name
   * const result = await db.user
   *   .joinLateral('messages', (q) => q.as('message')) // alias to 'message'
   *   .select('name', { message: 'message.*' });
   *
   * // result has the following type:
   * const ok: {
   *   name: string;
   *   // full message is included:
   *   message: { id: number; text: string; updatedAt: Date; createdAt: Date };
   * }[] = result;
   * ```
   *
   * `message` can be aliased withing the `select` as well as in case of a simple `join`:
   *
   * ```ts
   * // join by relation name
   * const result = await db.user
   *   .joinLateral('messages', (q) => q.as('message')) // alias to 'message'
   *   .select('name', { msg: 'message.*' });
   *
   * // result has the following type:
   * const ok: {
   *   name: string;
   *   // full message is included as msg:
   *   msg: { id: number; text: string; updatedAt: Date; createdAt: Date };
   * }[] = result;
   * ```
   *
   * @param arg - {@link JoinFirstArg}
   * @param cb - callback for shaping the joined query
   */
  joinLateral<T extends PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs, Arg extends JoinFirstArg<T>, As extends string, Result extends Column$1.QueryColumns, JoinedRelations extends RelationsBase$1>(this: T, arg: Arg, cb: (q: JoinQueryBuilder<T, JoinArgToQuery<T, Arg>>) => {
    __as: As;
    result: Result;
    relations: JoinedRelations;
  }): JoinLateralResult<T, As, Result, JoinedRelations, true>;
  /**
   * The same as {@link joinLateral}, but when no records found for the join it will result in `null`:
   *
   * ```ts
   * const result = await db.user
   *   .leftJoinLateral('messages', (q) => q.as('message'))
   *   .select('name', 'message.text');
   *
   * // result has the following type:
   * const ok: { name: string; text: string | null }[] = result;
   * ```
   *
   * @param arg - {@link JoinFirstArg}
   * @param cb - callback for shaping the joined query
   */
  leftJoinLateral<T extends PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs, Arg extends JoinFirstArg<T>, As extends string, Result extends Column$1.QueryColumns, JoinedRelations extends RelationsBase$1>(this: T, arg: Arg, cb: (q: JoinQueryBuilder<T, JoinArgToQuery<T, Arg>>) => {
    __as: As;
    result: Result;
    relations: JoinedRelations;
  }): JoinLateralResult<T, As, Result, JoinedRelations, false>;
  /**
   * This method may be useful
   * for combining with [createForEachFrom](/guide/create-update-delete.html#createForEachFrom-insertForEachFrom).
   *
   * `createForEachFrom` creates multiple record based on a selecting query:
   *
   * ```sql
   * INSERT INTO t1(c1, c2)
   * SELECT c1, c2 FROM t2
   * ```
   *
   * Such a query inserts one record per one selected record.
   *
   * Use `joinData` to insert a multiplication of selected records and the provided data.
   *
   * ```ts
   * const data = [{ column2: 'one' }, { column2: 'two' }, { column2: 'three' }];
   *
   * await db.table.createForEachFrom(
   *   db.otherTable
   *     .joinData('data', (t) => ({ column2: t.text() }), data)
   *     .select('otherTable.column1', 'data.column2'),
   * );
   * ```
   *
   * If the query on the other table returns 2 records,
   * and the data array contains 3 records, then 2 \* 3 = 6 will be inserted - every combination.
   *
   * Joined data values are available in `where` just as usual.
   *
   * @param as - alias to reference joined columns
   * @param fn - declare column types
   * @param data - array of data to join
   */
  joinData<T extends PickQuerySelectableColumnTypes, As extends string, RecordType extends Column$1.QueryColumnsInit, Item extends ColumnsShape$1.Input<RecordType>>(this: T, as: As, fn: (types: T['columnTypes']) => RecordType, data: Item[]): { [K in keyof T]: K extends '__selectable' ? T['__selectable'] & { [K in keyof RecordType & string as `${As}.${K}`]: {
    as: K;
    column: RecordType[K];
  }; } : T[K]; };
}
type OnArgs<S extends QuerySelectable> = [leftColumn: keyof S, rightColumn: keyof S] | [leftColumn: keyof S, op: string, rightColumn: keyof S];
type OnJsonPathEqualsArgs<S extends QuerySelectable> = [leftColumn: keyof S, leftPath: string, rightColumn: keyof S, rightPath: string];
/**
 * Argument of join callback.
 * It is a query object of table that you're joining, with ability to select main table's columns.
 * Adds {@link OnMethods.prototype.on} method and similar to the query.
 */
type JoinQueryBuilder<T extends PickQuerySelectableShape, J extends PickQuerySelectableResultAs> = { [K in keyof J | keyof OnMethods]: K extends '__selectable' ? SelectableFromShape$1<J['result'], J['__as']> & Omit<T['__selectable'], keyof T['shape']> : K extends keyof OnMethods ? OnMethods[K] : K extends keyof J ? J[K] : never; };
declare class OnMethods {
  /**
   * Use `on` to specify columns to join records.
   *
   * ```ts
   * q
   *   .on('message.userId', 'user.id')
   *   // joined table name may be omitted
   *   .on('userId', 'user.id')
   *   // operator can be specified:
   *   .on('userId', '!=', 'user.id')
   *   // operator can be specified with table names as well:
   *   .on('message.userId', '!=', 'user.id')
   * ```
   *
   * @param args - columns to join with
   */
  on<T extends PickQuerySelectable>(this: T, ...args: OnArgs<T['__selectable']>): T;
  /**
   * Works as {@link on}, but the added conditions will be separated from previous with `OR`.
   *
   * @param args - columns to join with
   */
  orOn<T extends PickQuerySelectable>(this: T, ...args: OnArgs<T['__selectable']>): T;
  /**
   * Use `onJsonPathEquals` to join record based on a field of their JSON column:
   *
   * ```ts
   * db.table.join(db.otherTable, (q) =>
   *   // '$.key' is a JSON path
   *   q.onJsonPathEquals('otherTable.data', '$.key', 'table.data', '$.key'),
   * );
   * ```
   *
   * @param args - columns and JSON paths to join with.
   */
  onJsonPathEquals<T extends PickQuerySelectable>(this: T, ...args: OnJsonPathEqualsArgs<T['__selectable']>): T;
}
declare class ColumnRefExpression$1<T extends Column$1.Pick.QueryColumn> extends Expression$1<T> {
  name: string;
  result: {
    value: T;
  };
  q: ExpressionData$1;
  constructor(value: T, name: string);
  makeSQL(ctx: ToSQLCtx$1, quotedAs?: string): string;
}
declare class RefExpression<T extends Column$1.Pick.QueryColumn> extends Expression$1<T> {
  ref: string;
  result: {
    value: T;
  };
  q: ExpressionData$1;
  table?: string;
  constructor(value: T, query: Query, ref: string);
  makeSQL(ctx: ToSQLCtx$1): string;
}
type SortDir = 'ASC' | 'DESC' | 'ASC NULLS FIRST' | 'DESC NULLS LAST';
type OrderItem = string | {
  [K: string]: SortDir;
} | Expression$1;
type OrderTsQueryConfig = true | OrderTsQueryConfigObject;
interface OrderTsQueryConfigObject {
  coverDensity?: boolean;
  weights?: number[];
  normalization?: number;
  dir?: SortDir;
}
type SearchWeight$1 = 'A' | 'B' | 'C' | 'D';
interface SearchWeightRecord {
  [K: string]: SearchWeight$1;
}
interface WhereSearchItem {
  as: string;
  vectorSQL: string;
}
type QuerySourceItem = {
  queryAs: string;
  as?: string;
  textSQL?: MaybeArray$1<string>;
  langSQL?: string;
  vectorSQL?: string;
  order?: OrderTsQueryConfig;
} & ({
  language?: string;
} | {
  languageColumn: string;
}) & ({
  text: string | Expression$1;
} | {
  in: MaybeArray$1<string> | SearchWeightRecord;
} | {
  vector: string;
}) & ({
  query: string | Expression$1;
} | {
  plainQuery: string | Expression$1;
} | {
  phraseQuery: string | Expression$1;
} | {
  tsQuery: string | Expression$1;
});
interface QueryDataSources {
  [K: string]: QuerySourceItem;
}
declare namespace Order {
  export interface ArgThis extends PickQuerySelectable, PickQueryResult, PickQueryTsQuery {}
  export type Arg<T extends ArgThis> = ArgKey<T> | ArgTsQuery<T> | { [K in ArgKey<T> | ArgTsQuery<T>]?: K extends ArgTsQuery<T> ? OrderTsQueryConfig : SortDir; } | Expression$1;
  export type Args<T extends ArgThis> = Arg<T>[];
  type ArgTsQuery<T extends ArgThis> = string | undefined extends T['__tsQuery'] ? never : Exclude<T['__tsQuery'], undefined>;
  type ArgKey<T extends ArgThis> = { [K in keyof T['__selectable']]: T['__selectable'][K]['column']['__queryType'] extends undefined ? never : K; }[keyof T['__selectable']] | { [K in keyof T['result']]: T['result'][K]['dataType'] extends 'array' | 'object' | 'runtimeComputed' ? never : K; }[keyof T['result']];
  export {};
}
declare class QueryOrder {
  /**
   * Adds an order by clause to the query.
   *
   * Takes one or more arguments, each argument can be a column name or an object.
   *
   * ```ts
   * db.table.order('id', 'name'); // ASC by default
   *
   * db.table.order({
   *   id: 'ASC', // or DESC
   *
   *   // to set nulls order:
   *   name: 'ASC NULLS FIRST',
   *   age: 'DESC NULLS LAST',
   * });
   * ```
   *
   * `order` can refer to the values returned from `select` sub-queries (unlike `where` which cannot).
   * So you can select a count of related records and order by it.
   *
   * For example, `comment` has many `likes`.
   * We are selecting few columns of `comment`, selecting `likesCount` by a sub-query in a select, and ordering comments by likes count:
   *
   * ```ts
   * db.comment
   *   .select('title', 'content', {
   *     likesCount: (q) => q.likes.count(),
   *   })
   *   .order({
   *     likesCount: 'DESC',
   *   });
   * ```
   *
   * @param args - column name(s) or an object with column names and sort directions.
   */
  order<T extends Order.ArgThis>(this: T, ...args: Order.Args<T>): T;
  /**
   * Order by SQL expression
   *
   * Order by raw SQL expression.
   *
   * ```ts
   * db.table.orderSql`raw sql`;
   * ```
   *
   * @param args - SQL expression
   */
  orderSql<T>(this: T, ...args: SQLQueryArgs): T;
}
interface WindowArg<T extends Order.ArgThis> {
  [K: string]: WindowArgDeclaration<T> | Expression$1;
}
interface WindowArgDeclaration<T extends Order.ArgThis = Order.ArgThis> {
  partitionBy?: SelectableOrExpression<T> | SelectableOrExpressions<T>;
  order?: Order.Arg<T>;
}
type WindowResult<T, W extends RecordUnknown$1> = T & {
  windows: { [K in keyof W]: true; };
};
declare class QueryWindow {
  /**
   * Add a window with `window` and use it later by its name for aggregate or window functions:
   *
   * ```ts
   * db.table
   *   // define window `windowName`
   *   .window({
   *     windowName: {
   *       partitionBy: 'someColumn',
   *       order: {
   *         id: 'DESC',
   *       },
   *     },
   *   })
   *   .select({
   *     avg: (q) =>
   *       // calculate average price over the window
   *       q.avg('price', {
   *         // use window by its name
   *         over: 'windowName',
   *       }),
   *   });
   * ```
   *
   * @param arg - window config
   */
  window<T extends Order.ArgThis, W extends WindowArg<T>>(this: T, arg: W): WindowResult<T, W>;
}
interface AggregateOptions<T extends PickQuerySelectableResultRelationsWindows> {
  distinct?: boolean;
  order?: Order.Arg<T> | Order.Args<T>;
  filter?: WhereArg$1<T>;
  filterOr?: WhereArgs<T>;
  withinGroup?: boolean;
  over?: Over<T>;
}
type Over<T extends PickQuerySelectableResultWindows> = keyof T['windows'] | WindowArgDeclaration<T>;
type HeadlineSearchArg<T extends PickQueryTsQuery> = Exclude<T['__tsQuery'], undefined>;
interface HeadlineParams<T extends PickQuerySelectable> {
  text?: SelectableOrExpressionOfType<T, Column$1.Pick.QueryColumnOfType<string>>;
  options?: string | Expression$1;
}
interface SearchAggregateMethods {
  /**
   * Give the `as` alias for the search, and it becomes possible to select a text with highlights of the matching words or phrases:
   *
   * ```ts
   * db.table
   *   .search({
   *     as: 'search',
   *     in: 'body',
   *     query: 'query',
   *   })
   *   .select({
   *     highlightedText: (q) => q.headline('search'),
   *   });
   * ```
   *
   * When searching in the generated `tsvector` column, need to provide a text source to the `headline`:
   *
   * ```ts
   * db.table
   *   .search({
   *     as: 'search',
   *     vector: 'textVector',
   *     query: 'query',
   *   })
   *   .select({
   *     // `body` is a column name
   *     highlightedText: (q) => q.headline('search', { text: 'body' }),
   *   });
   * ```
   *
   * `text` can be a raw SQL, here we are joining multiple columns:
   *
   * ```ts
   * import { raw } from 'orchid-orm';
   *
   * db.table
   *   .search({
   *     as: 'search',
   *     vector: 'titleAndBodyVector',
   *     query: 'query',
   *   })
   *   .select({
   *     highlightedText: (q) =>
   *       q.headline('search', { text: raw`concat_ws(' ', title, body)` }),
   *   });
   * ```
   *
   * `headline` supports a string for `options`, see details [in Postgres doc](https://www.postgresql.org/docs/current/textsearch-controls.html#TEXTSEARCH-HEADLINE).
   *
   * Provide a simple string or a raw SQL:
   *
   * ```ts
   * db.table
   *   .search({
   *     as: 'search',
   *     in: 'body',
   *     query: 'query',
   *   })
   *   .select({
   *     highlightedText: (q) =>
   *       q.headline('search', {
   *         options:
   *           'MaxFragments=10, MaxWords=7, MinWords=3, StartSel=<<, StopSel=>>',
   *       }),
   *   });
   * ```
   *
   * @param search - name of the search to use the query from
   * @param options - `text` for a text source, `options` for `ts_headline` options
   */
  headline<T extends Order.ArgThis>(this: T, search: HeadlineSearchArg<T>, options?: HeadlineParams<T>): SetQueryReturnsColumnOrThrow<T, Column$1.Pick.QueryColumnOfType<string>>;
}
type SearchArg<T extends PickQuerySelectable, As extends string> = {
  as?: As;
  order?: OrderTsQueryConfig;
} & ({
  language?: string | Expression$1;
} | {
  languageColumn?: keyof T['__selectable'];
}) & ({
  text: string | Expression$1;
} | {
  in: MaybeArray$1<keyof T['__selectable']> | { [K in keyof T['__selectable']]?: SearchWeight$1; };
} | {
  vector: { [K in keyof T['__selectable']]: T['__selectable'][K]['column']['dataType'] extends 'tsvector' ? K : never; }[keyof T['__selectable']];
}) & ({
  query: string | Expression$1;
} | {
  plainQuery: string | Expression$1;
} | {
  phraseQuery: string | Expression$1;
} | {
  tsQuery: string | Expression$1;
});
type WhereSearchResult<T, As extends string> = T & {
  __tsQuery: string extends As ? never : As;
};
declare class SearchMethods {
  /**
   * ## language
   *
   * By default, the search language is English.
   *
   * You can set a different default language in the `createTableFactory` config:
   *
   * ```ts
   * import { createTableFactory } from 'orchid-orm';
   *
   * export const { defineTable, defineView, sql } = createTableFactory({
   *   language: 'swedish',
   * });
   * ```
   *
   * See the list of supported language configs with the SQL:
   *
   * ```sql
   * SELECT cfgname FROM pg_ts_config;
   * ```
   *
   * When performing a search, you can override the default language:
   *
   * ```ts
   * db.table.search({
   *   language: 'finnish',
   *   in: 'body',
   *   query: 'query',
   * });
   * ```
   *
   * `language` also accepts a raw SQL.
   *
   * The language can be stored in the column of this table, then you can use `languageColumn` to use this column for the search:
   *
   * ```ts
   * db.table.search({
   *   // the table has `lang` column, use it for the search
   *   languageColumn: 'lang',
   *   in: 'body',
   *   query: 'query',
   * });
   * ```
   *
   * ## text vector to search in
   *
   * The text to search in can be a simple string, or a raw SQL, or a text column, or multiple columns:
   *
   * ```ts
   * db.table.search({
   *   // search in the given string
   *   text: 'simply a string to search in',
   *   query: 'query',
   * });
   *
   * import { raw } from 'orchid-orm';
   *
   * db.table.search({
   *   // raw SQL: join text columns with space
   *   text: raw`concat_ws(' ', title, body)`,
   *   query: 'query',
   * });
   *
   * db.table.search({
   *   // search in a single text column
   *   in: 'body',
   *   query: 'query',
   * });
   *
   * db.table.search({
   *   // search in multiple columns, they are concatenated with `concat_ws` as shown above
   *   in: ['title', 'body'],
   *   query: 'query',
   * });
   *
   * db.table.search({
   *   // search in multiple columns with different weights. Weight can be A, B, C, or D
   *   in: {
   *     title: 'A',
   *     body: 'B',
   *   },
   *   query: 'query',
   * });
   * ```
   *
   * For better performance, define a [generated](/guide/migration-column-methods.html#generated) column of `tsvector` type, and use it in the search with `vector` keyword:
   *
   * ```ts
   * db.table.search({
   *   vector: 'titleAndBodyVector',
   *   query: 'query',
   * });
   * ```
   *
   * ## search query
   *
   * Read about different search queries in [this Postgres doc](https://www.postgresql.org/docs/current/textsearch-controls.html#TEXTSEARCH-PARSING-QUERIES).
   *
   * `search` method can accept one of the following queries:
   *
   * - `query`: corresponds to `websearch_to_tsquery` in Postgres, good to use by default
   * - `plainQuery`: corresponds to `plainto_tsquery`
   * - `phraseQuery`: corresponds to `phraseto_tsquery`
   * - `tsQuery`: corresponds to `to_tsquery`
   *
   * The `query` (`websearch_to_tsquery`) can work with any user input, while other query kinds require a specific format and will fail for invalid input.
   *
   * Each query kind accepts a string or a raw SQL.
   *
   * ```ts
   * import { raw } from 'orchid-orm';
   *
   * db.table.search({
   *   vector: 'titleAndBodyVector',
   *   // can accept raw SQL:
   *   phraseQuery: raw`'The Fat Rats'`,
   * });
   * ```
   *
   * ## order by search rank
   *
   * Read about search ranking in [this Postgres doc](https://www.postgresql.org/docs/current/textsearch-controls.html#TEXTSEARCH-RANKING).
   *
   * Set `order: true` to order results by the search rank:
   *
   * ```ts
   * db.table.search({
   *   in: 'body',
   *   query: 'query',
   *   // will add ORDER BY ts_rank(to_tsvector('english', body)) DESC
   *   order: true,
   * });
   * ```
   *
   * To order with `ts_rank_cd` instead of `ts_rank`, set `coverDensity: true`:
   *
   * ```ts
   * db.table.search({
   *   in: 'body',
   *   query: 'query',
   *   // will add ORDER BY ts_rank_cd(to_tsvector('english', body)) DESC
   *   order: {
   *     coverDensity: true,
   *   },
   * });
   * ```
   *
   * Other options are:
   *
   * ```ts
   * db.table.search({
   *   in: 'body',
   *   query: 'query',
   *   order: {
   *     // weights for D, C, B, A:
   *     weights: [0.1, 0.2, 0.4, 1],
   *     // by default, rank ignores the document length
   *     // change rank behavior by providing here a special number
   *     normalization: 32,
   *     // it's possible to change the order direction:
   *     dir: 'ASC', // DESC by default
   *   },
   * });
   * ```
   *
   * Giving the `as` alias for the search allows to set the ordering in the `order` method:
   *
   * ```ts
   * db.table
   *   .search({
   *     as: 'search',
   *     in: 'body',
   *     query: 'query',
   *   })
   *   .order({
   *     // can be `search: true` for defaults
   *     search: {
   *       // same options as above
   *       coverDensity: true,
   *       weights: [0.1, 0.2, 0.4, 1.0],
   *       normalization: 32,
   *       dir: 'ASC',
   *     },
   *   });
   * ```
   *
   * @param arg - search config
   */
  search<T extends PickQuerySelectable, As extends string>(this: T, arg: SearchArg<T, As>): WhereSearchResult<T, As>;
}
interface OperatorsCount extends OperatorsNumber$1 {
  isCount: true;
}
type CountColumn = Column$1.Pick.QueryColumnOfTypeAndOps<'int8', number, OperatorsCount>;
type CountReturn<T> = SetQueryReturnsColumnOrThrow<T, CountColumn> & OperatorsCount;
type SelectableDataType<T extends PickQuerySelectable, DataType extends string> = { [K in keyof T['__selectable']]: T['__selectable'][K]['column']['dataType'] extends DataType ? K : never; }[keyof T['__selectable']] | Expression$1<Column$1.Pick.QueryColumnOfDataType<DataType>>;
type NumericReturn<T extends PickQuerySelectable, Arg> = Arg extends keyof T['__selectable'] ? SetQueryReturnsColumnOrThrow<T, Column$1.Pick.QueryColumnOfTypeAndOps<T['__selectable'][Arg]['column']['dataType'], T['__selectable'][Arg]['column']['__type'] | null, OperatorsNumber$1>> & OperatorsNumber$1 : Arg extends Expression$1 ? SetQueryReturnsColumnOrThrow<T, Column$1.Pick.QueryColumnOfTypeAndOps<Arg['result']['value']['dataType'], Arg['result']['value']['__type'] | null, OperatorsNumber$1>> & OperatorsNumber$1 : never;
type NullableNumberReturn<T, DataType> = SetQueryReturnsColumnOrThrow<T, Column$1.Pick.QueryColumnOfTypeAndOps<DataType, number | null, OperatorsNumber$1>> & OperatorsNumber$1;
type BooleanQueryColumn = Column$1.Pick.QueryColumnOfTypeAndOps<'bool', boolean, OperatorsBoolean>;
type BooleanNullable = Column$1.Pick.QueryColumnOfTypeAndOps<'bool', boolean | null, OperatorsBoolean>;
type NullableBooleanReturn<T> = SetQueryReturnsColumnOrThrow<T, BooleanNullable> & OperatorsBoolean;
type NullableJSONAggReturn<T extends PickQuerySelectable, Arg extends SelectableOrExpression<T>> = SetQueryReturnsColumnOrThrow<T, {
  dataType: 'json';
  __type: (ExpressionOutput<T, Arg>['__type'] | null)[] | null;
  __outputType: (ExpressionOutput<T, Arg>['__outputType'] | null)[] | null;
  __queryType: (ExpressionOutput<T, Arg>['__queryType'] | null)[] | null;
  operators: OperatorsArray$1<never>;
}> & OperatorsArray$1<never>;
interface RecordSelectableOrExpression<T extends PickQuerySelectable> {
  [K: string]: SelectableOrExpression<T>;
}
type NullableJSONObjectReturn<T extends PickQuerySelectable, Obj extends RecordSelectableOrExpression<T>> = SetQueryReturnsColumnOrThrow<T, {
  dataType: 'json';
  __type: { [K in keyof Obj]: ExpressionOutput<T, Obj[K]>['__type']; } | null;
  __outputType: { [K in keyof Obj]: ExpressionOutput<T, Obj[K]>['__outputType']; } | null;
  __queryType: { [K in keyof Obj]: ExpressionOutput<T, Obj[K]>['__queryType']; } | null;
  operators: OperatorsAny;
}> & OperatorsAny;
type StringColumn$2 = Column$1.Pick.QueryColumnOfTypeAndOps<string, string, OperatorsText$1>;
type StringNullable = Column$1.Pick.QueryColumnOfTypeAndOps<string, string | null, OperatorsText$1>;
type NullableStringReturn<T> = SetQueryReturnsColumnOrThrow<T, StringNullable> & OperatorsText$1;
interface AggregateArgTypes {
  minMax: 'citext' | 'date' | 'float4' | 'float8' | 'inet' | 'int2' | 'int4' | 'int8' | 'interval' | 'money' | 'numeric' | 'text' | 'time' | 'timestamp' | 'timestamptz';
  sum: 'float4' | 'float8' | 'int2' | 'int4' | 'int8' | 'interval' | 'money' | 'numeric';
  avg:
  // unlike sum, avg has no money
  'float4' | 'float8' | 'int2' | 'int4' | 'int8' | 'interval' | 'numeric';
  bit: 'bit' | 'int2' | 'int4' | 'int8';
  bool: 'bool';
  stringAgg: 'bytea' | 'text';
}
interface AggregateMethods extends SearchAggregateMethods {}
declare class AggregateMethods {
  /**
   * Count records with the `count` function:
   *
   * ```ts
   * // count all records:
   * const result: number = await db.table.count();
   *
   * // count records where a column is not NULL:
   * db.table.count('name');
   *
   * // see options above:
   * db.table.count('*', aggregateOptions);
   *
   * // select counts of people grouped by city
   * db.people
   *   .select('city', {
   *     population: (q) => q.count(),
   *   })
   *   .group('city');
   * ```
   *
   * @param arg - optionally, provide a column or a raw SQL for the `count` argument
   * @param options - aggregation options
   */
  count<T extends PickQuerySelectableResultRelationsWindows>(this: T, arg?: SelectableOrExpression<T>, options?: AggregateOptions<T>): CountReturn<T>;
  /**
   * Get the minimum value for the specified numeric column, returns number or `null` if there are no records.
   *
   * ```ts
   * const result: number | null = await db.table.min(
   *   'numericColumn',
   *   aggregateOptions,
   * );
   *
   * // select min product price grouped by product category
   * db.product
   *   .select('category', {
   *     minPrice: (q) => q.min('price'),
   *   })
   *   .group('category')
   *   .take();
   * ```
   *
   * @param arg - numeric column or raw SQL
   * @param options - aggregation options
   */
  min<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableDataType<T, AggregateArgTypes['minMax']>>(this: T, arg: Arg, options?: AggregateOptions<T>): NumericReturn<T, Arg>;
  /**
   * Gets the maximum value for the specified numeric column, returns number or `null` if there are no records.
   *
   * ```ts
   * const result: number | null = await db.table.max(
   *   'numericColumn',
   *   aggregateOptions,
   * );
   *
   * // select max product price grouped by product category
   * db.product
   *   .select('category', {
   *     maxPrice: (q) => q.max('price'),
   *   })
   *   .group('category')
   *   .take();
   * ```
   *
   * @param arg - numeric column or raw SQL
   * @param options - aggregation options
   */
  max<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableDataType<T, AggregateArgTypes['minMax']>>(this: T, arg: Arg, options?: AggregateOptions<T>): NumericReturn<T, Arg>;
  /**
   * Retrieve the sum of the values of a given numeric column, returns number or `null` if there are no records.
   *
   * ```ts
   * const result: number | null = await db.table.sum(
   *   'numericColumn',
   *   aggregateOptions,
   * );
   *
   * // select sum of employee salaries grouped by years
   * db.employee
   *   .select('year', {
   *     yearlySalaries: (q) => q.sum('salary'),
   *   })
   *   .group('year');
   * ```
   *
   * @param arg - numeric column or raw SQL
   * @param options - aggregation options
   */
  sum<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableDataType<T, AggregateArgTypes['sum']>>(this: T, arg: Arg, options?: AggregateOptions<T>): NumericReturn<T, Arg>;
  /**
   * Retrieve the average value of a numeric column, it returns a number or `null` if there are no records.
   *
   * ```ts
   * const result: number | null = db.table.avg('numericColumn', aggregateOptions);
   *
   * // select average movies ratings
   * db.movie
   *   .select('title', {
   *     averageRating: (q) => q.avg('rating'),
   *   })
   *   .group('title');
   * ```
   *
   * @param arg - numeric column or raw SQL
   * @param options - aggregation options
   */
  avg<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableDataType<T, AggregateArgTypes['avg']>>(this: T, arg: Arg, options?: AggregateOptions<T>): NumericReturn<T, Arg>;
  /**
   * Bitwise `and` aggregation, returns `number` or `null` if there are no records.
   *
   * ```ts
   * const result: number | null = db.table.bitAnd(
   *   'numericColumn',
   *   aggregateOptions,
   * );
   *
   * // select grouped `bitAnd`
   * db.table
   *   .select('someColumn', {
   *     bitAnd: (q) => q.bitAnd('numericColumn'),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - numeric column or raw SQL
   * @param options - aggregation options
   */
  bitAnd<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableDataType<T, AggregateArgTypes['bit']>>(this: T, arg: Arg, options?: AggregateOptions<T>): NumericReturn<T, Arg>;
  /**
   * Bitwise `or` aggregation, returns `number` or `null` if there are no records.
   *
   * ```ts
   * const result: number | null = db.table.bitOr('numericColumn', aggregateOptions);
   *
   * // select grouped `bitOr`
   * db.table
   *   .select('someColumn', {
   *     bitOr: (q) => q.bitOr('numericColumn'),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - numeric column or raw SQL
   * @param options - aggregation options
   */
  bitOr<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableDataType<T, AggregateArgTypes['bit']>>(this: T, arg: Arg, options?: AggregateOptions<T>): NumericReturn<T, Arg>;
  /**
   * Aggregate booleans with `and` logic, it returns `boolean` or `null` if there are no records.
   *
   * ```ts
   * const result: boolean | null = db.table.boolAnd(
   *   'booleanColumn',
   *   aggregateOptions,
   * );
   *
   * // select grouped `boolAnd`
   * db.table
   *   .select('someColumn', {
   *     boolAnd: (q) => q.boolAnd('booleanColumn'),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - boolean column or raw SQL
   * @param options - aggregation options
   */
  boolAnd<T extends PickQuerySelectableResultRelationsWindows>(this: T, arg: SelectableDataType<T, AggregateArgTypes['bool']>, options?: AggregateOptions<T>): NullableBooleanReturn<T>;
  /**
   * Aggregate booleans with `or` logic, it returns `boolean` or `null` if there are no records.
   *
   * ```ts
   * const result: boolean | null = db.table.boolOr(
   *   'booleanColumn',
   *   aggregateOptions,
   * );
   *
   * // select grouped `boolOr`
   * db.table
   *   .select('someColumn', {
   *     boolOr: (q) => q.boolOr('booleanColumn'),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - boolean column or raw SQL
   * @param options - aggregation options
   */
  boolOr<T extends PickQuerySelectableResultRelationsWindows>(this: T, arg: SelectableDataType<T, AggregateArgTypes['bool']>, options?: AggregateOptions<T>): NullableBooleanReturn<T>;
  /**
   * Equivalent to {@link boolAnd}
   */
  every<T extends PickQuerySelectableResultRelationsWindows>(this: T, arg: SelectableDataType<T, AggregateArgTypes['bool']>, options?: AggregateOptions<T>): NullableBooleanReturn<T>;
  /**
   * Aggregate values into an array by using `json_agg`. Returns array of values or `null` if there are no records.
   *
   * `jsonAgg` is working a bit faster, `jsonbAgg` is better only when applying JSON operations in SQL.
   *
   * ```ts
   * const idsOrNull: number[] | null = db.table.jsonAgg('id', aggregateOptions);
   *
   * const namesOrNull: string[] | null = db.table.jsonbAgg(
   *   'name',
   *   aggregateOptions,
   * );
   *
   * // select grouped `jsonAgg`
   * db.table
   *   .select('someColumn', {
   *     jsonAgg: (q) => q.jsonAgg('anyColumn'),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - any column or raw SQL
   * @param options - aggregation options
   */
  jsonAgg<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableOrExpression<T>>(this: T, arg: Arg, options?: AggregateOptions<T>): NullableJSONAggReturn<T, Arg>;
  /**
   * See {@link jsonAgg}
   */
  jsonbAgg<T extends PickQuerySelectableResultRelationsWindows, Arg extends SelectableOrExpression<T>>(this: T, arg: Arg, options?: AggregateOptions<T>): NullableJSONAggReturn<T, Arg>;
  /**
   * It does the construction of JSON objects, keys are provided strings and values can be table columns or raw SQL expressions, and returns `object` or `null` if no records.
   *
   * `jsonObjectAgg` is different from `jsonbObjectAgg` by internal representation in the database, `jsonObjectAgg` is a bit faster as it constructs a simple string.
   *
   * ```ts
   * import { TextColumn } from './string';
   *
   * // object has type { nameAlias: string, foo: string } | null
   * const object = await db.table.jsonObjectAgg(
   *   {
   *     // select a column with alias
   *     nameAlias: 'name',
   *     // select raw SQL with alias
   *     foo: sql<string>`"bar" || "baz"`,
   *   },
   *   aggregateOptions,
   * );
   *
   * // select aggregated object
   * db.table.select('id', {
   *   object: (q) =>
   *     q.jsonObjectAgg({
   *       nameAlias: 'name',
   *       foo: sql<string>`"bar" || "baz"`,
   *     }),
   * });
   * ```
   *
   * @param arg - object where values are column names or SQL
   * @param options - aggregation options
   */
  jsonObjectAgg<T extends PickQuerySelectableResultRelationsWindows, Obj extends RecordSelectableOrExpression<T>>(this: T, arg: Obj, options?: AggregateOptions<T>): NullableJSONObjectReturn<T, Obj>;
  /**
   * See {@link jsonObjectAgg}
   */
  jsonbObjectAgg<T extends PickQuerySelectableResultRelationsWindows, Obj extends RecordSelectableOrExpression<T>>(this: T, arg: Obj, options?: AggregateOptions<T>): NullableJSONObjectReturn<T, Obj>;
  /**
   * Select joined strings, it returns a string or `null` if no records.
   *
   * ```ts
   * const result: string | null = db.table.stringAgg(
   *   'name',
   *   ', ',
   *   aggregateOptions,
   * );
   *
   * // select joined strings grouped by some column
   * db.table
   *   .select('someColumn', {
   *     joinedNames: (q) => q.stringAgg('name', ', '),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - string column or SQL
   * @param delimiter - string to join with
   * @param options - aggration options
   */
  stringAgg<T extends PickQuerySelectableResultRelationsWindows>(this: T, arg: SelectableDataType<T, AggregateArgTypes['stringAgg']>, delimiter: string, options?: AggregateOptions<T>): NullableStringReturn<T>;
  /**
   * Concatenates `xml` columns, returns a `string` or `null` if no records.
   *
   * ```ts
   * const xml: string | null = await db.table.xmlAgg('xmlColumn', aggregateOptions);
   *
   * // select joined XMLs grouped by some column
   * db.table
   *   .select('someColumn', {
   *     joinedXMLs: (q) => q.xmlAgg('xml'),
   *   })
   *   .group('someColumn');
   * ```
   *
   * @param arg - column or SQL with XML
   * @param options - aggregation options
   */
  xmlAgg<T extends PickQuerySelectableResultRelationsWindows>(this: T, arg: SelectableOrExpressionOfType<T, StringColumn$2>, options?: AggregateOptions<T>): NullableStringReturn<T>;
  /**
   * Selects the` row_number` window function.
   *
   * Returns the number of the current row within its partition, counting from 1.
   *
   * ```ts
   * // result is of type Array<{ rowNumber: number }>
   * const result = await db.table.select({
   *   rowNumber: (q) =>
   *     q.rowNumber({
   *       partitionBy: 'someColumn',
   *       order: { createdAt: 'ASC' },
   *     }),
   * });
   * ```
   *
   * @param over - OVER clause config
   */
  rowNumber<T extends PickQuerySelectableResultRelationsWindows>(this: T, over?: Over<T>): NullableNumberReturn<T, 'int8'>;
  /**
   * Selects the` rank` window function.
   *
   * Returns the rank of the current row, with gaps; that is, the row_number of the first row in its peer group.
   *
   * ```ts
   * // result is of type Array<{ rank: number }>
   * const result = await db.table.select({
   *   rank: (q) =>
   *     q.rank({
   *       partitionBy: 'someColumn',
   *       order: { createdAt: 'ASC' },
   *     }),
   * });
   * ```
   *
   * @param over - OVER clause config
   */
  rank<T extends PickQuerySelectableResultRelationsWindows>(this: T, over?: Over<T>): NullableNumberReturn<T, 'int8'>;
  /**
   * Selects the` dense_rank` window function.
   *
   * Returns the rank of the current row, without gaps; this function effectively counts peer groups.
   *
   * ```ts
   * // result is of type Array<{ denseRank: number }>
   * const result = await db.table.select({
   *   denseRank: (q) =>
   *     q.denseRank({
   *       partitionBy: 'someColumn',
   *       order: { createdAt: 'ASC' },
   *     }),
   * });
   * ```
   *
   * @param over - OVER clause config
   */
  denseRank<T extends PickQuerySelectableResultRelationsWindows>(this: T, over?: Over<T>): NullableNumberReturn<T, 'int8'>;
  /**
   * Selects the `percent_rank` window function.
   *
   * Returns the relative rank of the current row, that is (rank - 1) / (total partition rows - 1). The value thus ranges from 0 to 1 inclusive.
   *
   * ```ts
   * // result is of type Array<{ percentRank: number }>
   * const result = await db.table.select({
   *   percentRank: (q) =>
   *     q.percentRank({
   *       partitionBy: 'someColumn',
   *       order: { createdAt: 'ASC' },
   *     }),
   * });
   * ```
   *
   * @param over - OVER clause config
   */
  percentRank<T extends PickQuerySelectableResultRelationsWindows>(this: T, over?: Over<T>): NullableNumberReturn<T, 'float8'>;
  /**
   * Selects the `cume_dist` window function.
   *
   * Returns the cumulative distribution, that is (number of partition rows preceding or peers with current row) / (total partition rows). The value thus ranges from 1/N to 1.
   *
   * ```ts
   * // result is of type Array<{ cumeDist: number }>
   * const result = await db.table.select({
   *   cumeDist: (q) =>
   *     q.cumeDist({
   *       partitionBy: 'someColumn',
   *       order: { createdAt: 'ASC' },
   *     }),
   * });
   * ```
   *
   * @param over - OVER clause config
   */
  cumeDist<T extends PickQuerySelectableResultRelationsWindows>(this: T, over?: Over<T>): NullableNumberReturn<T, 'float8'>;
}
interface OrExpression extends Expression$1<BooleanQueryColumn>, OperatorsBoolean {}
type OrExpressionArg = QueryOrExpressionBooleanOrNullResult | undefined;
declare class OrExpression extends Expression$1<BooleanQueryColumn> {
  args: [OrExpressionArg, ...OrExpressionArg[]];
  result: {
    value: BooleanQueryColumn;
  };
  q: ExpressionData$1;
  constructor(args: [OrExpressionArg, ...OrExpressionArg[]]);
  makeSQL(ctx: ToSQLCtx$1, quotedAs?: string): string;
}
interface QueryReturnsFnAdd<T extends PickQueryColumTypes> extends PickQueryHasSelect {
  type<C extends Column$1.Pick.QueryColumn>(fn: (types: T['columnTypes']) => C): { [K in keyof T]: K extends 'result' ? {
    value: C;
  } : K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<C['__outputType']> : T[K]; } & C['operators'];
}
type SetQueryReturnsFn<T extends PickQueryColumTypes, C extends Column$1.Pick.OutputType> = { [K in keyof T]: K extends 'result' ? {
  value: C;
} : K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<C['__outputType']> : T[K]; } & QueryReturnsFnAdd<T>;
declare class QueryExpressions {
  /**
   * `column` references a table column, this can be used in raw SQL or when building a column expression.
   * Only for referencing a column in the query's table. For referencing joined table's columns, see [ref](#ref).
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * await db.table.select({
   *   // select `("table"."id" = 1 OR "table"."name" = 'name') AS "one"`,
   *   // returns a boolean
   *   one: (q) =>
   *     sql<boolean>`${q.column('id')} = ${1} OR ${q.column('name')} = ${'name'}`,
   *
   *   // selects the same as above, but by building a query
   *   two: (q) => q.column('id').equals(1).or(q.column('name').equals('name')),
   * });
   * ```
   *
   * @param name - column name
   */
  column<T extends PickQueryShape$1, K extends keyof T['shape']>(this: T, name: K): ColumnRefExpression$1<T['shape'][K]> & T['shape'][K]['operators'];
  /**
   * `ref` is similar to [column](#column), but it also allows to reference a column of joined table,
   * and other dynamically defined columns.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * await db.table.join('otherTable').select({
   *   // select `("otherTable"."id" = 1 OR "otherTable"."name" = 'name') AS "one"`,
   *   // returns a boolean
   *   one: (q) =>
   *     sql<boolean>`${q.ref('otherTable.id')} = ${1} OR ${q.ref(
   *       'otherTable.name',
   *     )} = ${'name'}`,
   *
   *   // selects the same as above, but by building a query
   *   two: (q) =>
   *     q
   *       .ref('otherTable.id')
   *       .equals(1)
   *       .or(q.ref('otherTable.name').equals('name')),
   * });
   * ```
   *
   * @param arg - any available column name, such as of a joined table
   */
  ref<T extends PickQuerySelectable, K extends keyof T['__selectable'] & string>(this: T, arg: K): RefExpression<T['__selectable'][K]['column']> & T['__selectable'][K]['column']['operators'];
  /**
   * `fn` allows to call an arbitrary SQL function.
   *
   * For example, calling `sqrt` function to get a square root from some numeric column:
   *
   * ```ts
   * const q = await db.table.select({
   *   sqrt: (q) => q.fn<number>('sqrt', ['numericColumn']),
   * }).take();
   *
   * q.sqrt; // has type `number` just as provided
   * ```
   *
   * If this is an aggregate function, you can specify aggregation options (see [Aggregate](/guide/aggregate.html)) via third parameter.
   *
   * Use `type` method to specify a column type so that its operators such as `lt` and `gt` become available:
   *
   * ```ts
   * const q = await db.table.select({
   *   // Produces `sqrt("numericColumn") > 5`
   *   sqrtIsGreaterThan5: (q) =>
   *     q
   *       .fn('sqrt', ['numericColumn'])
   *       .type((t) => t.float())
   *       .gt(5),
   * }).take();
   *
   * // Return type is boolean | null
   * // todo: it should be just boolean if the column is not nullable, but for now it's always nullable
   * q.sqrtIsGreaterThan5;
   * ```
   *
   * @param fn
   * @param args
   * @param options
   */
  fn<T extends PickQueryMetaSelectableResultRelationsWindowsColumnTypes, Type = unknown, C extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumnOfType<Type>>(this: T, fn: string, args: SelectableOrExpressions<T>, options?: AggregateOptions<T>): SetQueryReturnsFn<T, C>;
  or(...args: [OrExpressionArg, ...OrExpressionArg[]]): OrExpression;
}
type WhereArg$1<T extends PickQuerySelectableRelations$1> = { [K in keyof T['__selectable'] | 'NOT' | 'OR' | 'IN']?: K extends 'NOT' ? WhereArg$1<T> | WhereArgs<T> : K extends 'OR' ? (WhereArg$1<T> | WhereArgs<T>)[] : K extends 'IN' ? MaybeArray$1<{
  columns: (keyof T['__selectable'])[];
  values: unknown[][] | IsQuery$1 | Expression$1;
}> : T['__selectable'][K]['column']['__queryType'] | null | { [O in keyof T['__selectable'][K]['column']['operators']]?: T['__selectable'][K]['column']['operators'][O]['_opType']; } | {
  result: {
    value: {
      __queryType: T['__selectable'][K]['column']['__queryType'] | null;
    };
  };
} | ((q: T) => {
  result: {
    value: {
      __queryType: T['__selectable'][K]['column']['__queryType'] | null;
    };
  };
}); } | ((q: WhereQueryBuilder<T>) => QueryOrExpressionBooleanOrNullResult | WhereQueryBuilder<T>);
/**
 * Callback argument of `where`.
 * It has `where` methods (`where`, `whereNot`, `whereExists`, etc.),
 * and it has relations that you can aggregate and use a boolean comparison with, such as:
 * ```ts
 * db.table.where((q) => q.relation.count().equals(10))
 * ```
 */
type WhereQueryBuilder<T extends PickQueryRelations$1> = EmptyObject$1 extends T['relations'] ? { [K in keyof T]: K extends keyof Where | keyof QueryExpressions | 'table' | 'get' | 'columnTypes' | '__selectable' | 'relations' | 'useHelper' | 'modify' | 'result' | 'returnType' | 'withData' | 'windows' | 'then' | 'none' ? T[K] : never; } : { [K in keyof T['relations'] | keyof T]: K extends keyof T['relations'] ? T['relations'][K]['query'] : K extends keyof T & (keyof Where | keyof QueryExpressions | 'table' | 'get' | 'columnTypes' | '__selectable' | 'relations' | 'useHelper' | 'modify' | 'result' | 'returnType' | 'withData' | 'windows' | 'then' | 'none') ? T[K] : never; };
type WhereArgs<T extends PickQuerySelectableRelations$1> = WhereArg$1<T>[];
type WhereNotArgs<T extends PickQuerySelectableRelations$1> = [WhereArg$1<T>];
type WhereInColumn<T extends PickQuerySelectableRelations$1> = keyof T['__selectable'] | [keyof T['__selectable'], ...(keyof T['__selectable'])[]];
type WhereInValues<T extends PickQuerySelectableRelations$1, Column> = Column extends keyof T['__selectable'] ? Iterable<T['__selectable'][Column]['column']['__queryType']> | IsQuery$1 | Expression$1 : ({ [I in keyof Column]: Column[I] extends keyof T['__selectable'] ? T['__selectable'][Column[I]]['column']['__queryType'] : never; } & {
  length: Column extends {
    length: number;
  } ? Column['length'] : never;
})[] | IsQuery$1 | Expression$1;
type WhereInArg<T extends PickQuerySelectableRelations$1> = { [K in keyof T['__selectable']]?: Iterable<T['__selectable'][K]['column']['__queryType']> | IsQuery$1 | Expression$1; };
interface QueryHasWhere$1 {
  __hasWhere: true;
}
interface QueryFnReturningSelect {
  (q: never): QueryHasSelect;
}
declare class Where {
  /**
   * Constructing `WHERE` conditions:
   *
   * ```ts
   * import { sql } from './table-factory';
   *
   * db.table.where({
   *   // column of the current table
   *   name: 'John',
   *
   *   // table name may be specified, it can be the name of a joined table
   *   'table.lastName': 'Johnsonuk',
   *
   *   // object with operators, see the "column operators" section to see a full list of them:
   *   age: {
   *     gt: 30,
   *     lt: 70,
   *   },
   *
   *   // where column equals to raw SQL
   *   // import `sql` from your table factory
   *   column: sql`sql expression`,
   *   // or use `(q) => sql` for the same
   *   column2: (q) => sql`sql expression`,
   *
   *   // reference other columns in such a way:
   *   firstName: (q) => q.ref('lastName'),
   * });
   * ```
   *
   * Multiple `where`s are joined with `AND`:
   *
   * ```ts
   * db.table.where({ foo: 'foo' }).where({ bar: 'bar' });
   * ```
   *
   * ```sql
   * SELECT * FROM table WHERE foo = 'foo' AND bar = 'bar'
   * ```
   *
   * `undefined` values are ignored, so you can supply a partial object with conditions:
   *
   * ```ts
   * type Params = {
   *   // allow providing exact age, or lower or greater than
   *   age?: number | { lt?: number; gt?: number };
   * };
   *
   * const loadRecords = async (params: Params) => {
   *   // this will load all records if params is an empty object
   *   const records = await db.table.where(params);
   * };
   * ```
   *
   * It supports a sub-query that is selecting a single value to compare it with a column:
   *
   * ```ts
   * db.table.where({
   *   // compare `someColumn` in one table with the `column` value returned from another query.
   *   someColumn: db.otherTable.where(...conditions).get('column'),
   * });
   * ```
   *
   * `where` can accept other queries and merge their conditions:
   *
   * ```ts
   * const otherQuery = db.table.where({ name: 'John' });
   *
   * db.table.where({ id: 1 }, otherQuery);
   * // this will produce WHERE "table"."id" = 1 AND "table"."name' = 'John'
   * ```
   *
   * `where` supports raw SQL:
   *
   * ```ts
   * db.table.where(sql`a = b`);
   * ```
   *
   * `where` can accept a callback with a specific query builder containing all "where" methods such as `where`, `orWhere`, `whereNot`, `whereIn`, `whereExists`:
   *
   * ```ts
   * db.table.where((q) =>
   *   q
   *     .where({ name: 'Name' })
   *     .orWhere({ id: 1 }, { id: 2 })
   *     .whereIn('letter', ['a', 'b', 'c'])
   *     .whereExists(db.message, 'authorId', 'id'),
   * );
   * ```
   *
   * `where` can accept multiple arguments, conditions are joined with `AND`:
   *
   * ```ts
   * db.table.where(
   *   { id: 1 },
   *   db.table.where({ name: 'John' }),
   *   sql`a = b`,
   * );
   * ```
   *
   * ## where sub query
   *
   * `where` handles a special callback where you can query a relation to get some value and filter by that value.
   *
   * It is useful for a faceted search. For instance, posts have tags, and we want to find all posts that have all the given tags.
   *
   * ```ts
   * const givenTags = ['typescript', 'node.js'];
   *
   * const posts = await db.post.where(
   *   (post) =>
   *     post.tags // query tags of the post
   *       .whereIn('tagName', givenTags) // where name of the tag is inside array
   *       .count() // count how many such tags were found
   *       .equals(wantedTags.length), // the count must be exactly the length of array
   *   // if the post has ony `typescript` tag but not the `node.js` it will be omitted
   * );
   * ```
   *
   * This will produce an efficient SQL query:
   *
   * ```sql
   * SELECT * FROM "post"
   * WHERE (
   *   SELECT count(*) = 3
   *   FROM "tag" AS "tags"
   *   WHERE "tag"."tagName" IN ('typescript', 'node.js')
   *     -- join tags to the post via "postTag" table
   *     AND EXISTS (
   *       SELECT 1 FROM "postTag"
   *       WHERE "postTag"."postId" = "post"."id"
   *         AND "postTag"."tagId" = "tag"."id"
   *     )
   * )
   * ```
   *
   * In the example above we use `count()`, you can also use any other aggregate method instead, such as `min`, `max`, `avg`.
   *
   * The `count()` is chained with `equals` to check for a strict equality, any other operation is also allowed, such as `not`, `lt`, `gt`.
   *
   * ## where special keys
   *
   * The object passed to `where` can contain special keys, each of the keys corresponds to its own method and takes the same value as the type of argument of the method.
   *
   * For example:
   *
   * ```ts
   * db.table.where({
   *   NOT: { key: 'value' },
   *   OR: [{ name: 'a' }, { name: 'b' }],
   *   IN: {
   *     columns: ['id', 'name'],
   *     values: [
   *       [1, 'a'],
   *       [2, 'b'],
   *     ],
   *   },
   * });
   * ```
   *
   * Using methods `whereNot`, `orWhere`, `whereIn` instead of this is a shorter and cleaner way, but in some cases, such object keys way may be more convenient.
   *
   * ```ts
   * db.table.where({
   *   // see .whereNot
   *   NOT: { id: 1 },
   *   // can be an array:
   *   NOT: [{ id: 1 }, { id: 2 }],
   *
   *   // see .orWhere
   *   OR: [{ name: 'a' }, { name: 'b' }],
   *   // can be an array:
   *   // this will give id = 1 AND id = 2 OR id = 3 AND id = 4
   *   OR: [
   *     [{ id: 1 }, { id: 2 }],
   *     [{ id: 3 }, { id: 4 }],
   *   ],
   *
   *   // see .in, the key syntax requires an object with columns and values
   *   IN: {
   *     columns: ['id', 'name'],
   *     values: [
   *       [1, 'a'],
   *       [2, 'b'],
   *     ],
   *   },
   *   // can be an array:
   *   IN: [
   *     {
   *       columns: ['id', 'name'],
   *       values: [
   *         [1, 'a'],
   *         [2, 'b'],
   *       ],
   *     },
   *     { columns: ['someColumn'], values: [['foo', 'bar']] },
   *   ],
   * });
   * ```
   *
   * ## column operators
   *
   * `where` argument can take an object where the key is the name of the operator and the value is its argument.
   *
   * Different types of columns support different sets of operators.
   *
   * All column operators can take a value of the same type as the column, a sub-query, or a raw SQL expression:
   *
   * ```ts
   * db.table.where({
   *   numericColumn: {
   *     // lower than 5
   *     lt: 5,
   *
   *     // lower than the value returned by sub-query
   *     lt: db.otherTable.select('someNumber').take(),
   *
   *     // raw SQL expression produces WHERE "numericColumn" < "otherColumn" + 10
   *     lt: sql`"otherColumn" + 10`,
   *   },
   * });
   * ```
   *
   * ### Any type of column operators
   *
   * `equals` is a simple `=` operator, it may be useful for comparing column value with JSON object:
   *
   * ```ts
   * db.table.where({
   *  // when searching for an exact same JSON value, this won't work:
   *   jsonColumn: someObject,
   *
   *   // use `{ equals: ... }` instead:
   *   jsonColumn: { equals: someObject },
   * });
   * ```
   *
   * `not` is `!=` (aka `<>`) not equal operator:
   *
   * ```ts
   * db.table.where({
   *   anyColumn: { not: value },
   * });
   * ```
   *
   * `in` is for the `IN` operator to check if the column value is included in a list of values.
   *
   * Takes an array of the same type as a column, a sub-query that returns a list of values, or a raw SQL expression that returns a list.
   *
   * ```ts
   * db.table.where({
   *   column: {
   *     in: ['a', 'b', 'c'],
   *
   *     // WHERE "column" IN (SELECT "column" FROM "otherTable")
   *     in: db.otherTable.select('column'),
   *
   *     in: sql`('a', 'b')`,
   *   },
   * });
   * ```
   *
   * `notIn` is for the `NOT IN` operator, and takes the same arguments as `in`
   *
   * ### Numeric, Date, and Time column operators
   *
   * To compare numbers, dates, and times.
   *
   * `lt` is for `<` (lower than)
   *
   * `lte` is for `<=` (lower than or equal)
   *
   * `gt` is for `>` (greater than)
   *
   * `gte` is for `>=` (greater than or equal)
   *
   * ```ts
   * db.table.where({
   *   numericColumn: {
   *     gt: 5,
   *     lt: 10,
   *   },
   *
   *   date: {
   *     lte: new Date(),
   *   },
   *
   *   time: {
   *     gte: new Date(),
   *   },
   * });
   * ```
   *
   * `between` also works with numeric, dates, and time columns, it takes an array of two elements.
   *
   * Both elements can be of the same type as a column, a sub-query, or a raw SQL expression.
   *
   * ```ts
   * db.table.where({
   *   column: {
   *     // simple values
   *     between: [1, 10],
   *
   *     // sub-query and raw SQL expression
   *     between: [db.otherTable.select('column').take(), sql`2 + 2`],
   *   },
   * });
   * ```
   *
   * ### Text column operators
   *
   * For `text`, `varchar`, `string`, and `json` columns.
   *
   * `json` is stored as text, so it has text operators. Use the `jsonb` type for JSON operators.
   *
   * Takes a string, or sub-query returning string, or raw SQL expression as well as other operators.
   *
   * ```ts
   * db.table.where({
   *   textColumn: {
   *     // WHERE "textColumn" LIKE '%string%'
   *     contains: 'string',
   *     // WHERE "textColumn" ILIKE '%string%'
   *     containsInsensitive: 'string',
   *     // WHERE "textColumn" LIKE 'string%'
   *     startsWith: 'string',
   *     // WHERE "textColumn" ILIKE 'string%'
   *     startsWithInsensitive: 'string',
   *     // WHERE "textColumn" LIKE '%string'
   *     endsWith: 'string',
   *     // WHERE "textColumn" ILIKE '%string'
   *     endsWithInsensitive: 'string',
   *   },
   * });
   * ```
   *
   * ### JSONB column operators
   *
   * JSON functions are available only for the `jsonb` column, note that the `json` type has text operators instead.
   *
   * You can use [jsonPathQueryFirst](/guide/json.html#jsonpathqueryfirst) to filter by a JSON value, follow the link for details.
   *
   * The value can be of any type, it can also be returned from a sub-query, raw SQL expression.
   *
   * ```ts
   * db.table.where((q) =>
   *   q.get('jsonbColumn').jsonPathQueryFirst('$.name').equals(value),
   * );
   * ```
   *
   * `jsonSupersetOf`: check if the column value is a superset of provided value.
   *
   * For instance, it is true if the column has JSON `{ "a": 1, "b": 2 }` and provided value is `{ "a": 1 }`.
   *
   * Takes the value of any type, or sub query which returns a single value, or a raw SQL expression.
   *
   * ```ts
   * db.table.where({
   *   jsonbColumn: {
   *     jsonSupersetOf: { a: 1 },
   *   },
   * });
   * ```
   *
   * `jsonSubsetOf`: check if the column value is a subset of provided value.
   *
   * For instance, it is true if the column has JSON `{ "a": 1 }` and provided value is `{ "a": 1, "b": 2 }`.
   *
   * Takes the value of any type, or sub query which returns a single value, or a raw SQL expression.
   *
   * ```ts
   * db.table.where({
   *   jsonbColumn: {
   *     jsonSubsetOf: { a: 1 },
   *   },
   * });
   * ```
   *
   * @param args - {@link WhereArgs}
   */
  where<T extends PickQuerySelectableRelations$1>(this: T, ...args: WhereArgs<T>): T & QueryHasWhere$1;
  /**
   * Use a custom SQL expression in `WHERE` statement:
   *
   * ```ts
   * db.table.whereSql`a = b`;
   * ```
   *
   * @param args - SQL expression
   */
  whereSql<T>(this: T, ...args: SQLQueryArgs): T & QueryHasWhere$1;
  /**
   * `whereNot` takes the same argument as `where`,
   * multiple conditions are combined with `AND`,
   * the whole group of conditions is negated with `NOT`.
   *
   * ```ts
   * // find records of different colors than red
   * db.table.whereNot({ color: 'red' });
   * // WHERE NOT color = 'red'
   * db.table.whereNot({ one: 1, two: 2 });
   * // WHERE NOT (one = 1 AND two = 2)
   * ```
   *
   * @param args - {@link WhereArgs}
   */
  whereNot<T extends PickQuerySelectableRelations$1>(this: T, ...args: WhereNotArgs<T>): T & QueryHasWhere$1;
  /**
   * `whereNotSql` is a version of `whereNot` accepting SQL expression:
   *
   * ```ts
   * db.table.whereNotSql`sql expression`
   * ```
   *
   * @param args - SQL expression
   */
  whereNotSql<T>(this: T, ...args: SQLQueryArgs): T;
  /**
   * `whereOneOf` stands for "...**and** where one of the given is true".
   *
   * Accepts the same arguments as `where`.
   *
   * ```ts
   * db.table.where({ id: 1 }).whereOneOf({ color: 'red' }, { color: 'blue' });
   * ```
   *
   * ```sql
   * SELECT * FROM table
   * WHERE id = 1 AND (color = 'red' OR color = 'blue')
   * ```
   *
   * Note that columns inside every argument are joined with `AND`:
   *
   * ```ts
   * db.table.whereOneOf({ id: 1, color: 'red' }, { id: 2 });
   * ```
   *
   * ```sql
   * SELECT * FROM table
   * WHERE (id = 1 AND color = 'red') OR (id = 2)
   * ```
   *
   * @param args - same arguments as in {@link where}, joined with `OR`
   */
  whereOneOf<T extends PickQuerySelectableRelations$1>(this: T, ...args: WhereArgs<T>): T & QueryHasWhere$1;
  /**
   * Negative {@link whereOneOf}:
   *
   * ```ts
   * db.table.where({ id: 1 }).whereNotOneOf({ color: 'red' }, { color: 'blue' });
   * ```
   *
   * ```sql
   * SELECT * FROM table
   * WHERE id = 1 AND NOT (color = 'red' OR color = 'blue')
   * ```
   *
   * @param args - same arguments as in {@link where}, joined with `OR`
   */
  whereNotOneOf<T extends PickQuerySelectableRelations$1>(this: T, ...args: WhereArgs<T>): T;
  /**
   * `orWhere` stands for "...**or** where one of the given is true".
   *
   * Accepts the same arguments as `where`.
   *
   * ```ts
   * db.table.where({ id: 1, color: 'red' }).orWhere({ id: 2, color: 'blue' });
   * // equivalent:
   * db.table.orWhere({ id: 1, color: 'red' }, { id: 2, color: 'blue' });
   * ```
   *
   * ```sql
   * SELECT * FROM table
   * WHERE (id = 1 AND color = 'red') OR (id = 2 AND color = 'blue')
   * ```
   *
   * @param args - same arguments as in {@link where}, joined with `OR`
   */
  orWhere<T extends PickQuerySelectableRelations$1>(this: T, ...args: WhereArgs<T>): T & QueryHasWhere$1;
  /**
   * `orWhereNot` takes the same arguments as {@link orWhere}, and prepends each condition with `NOT` just as {@link whereNot} does.
   *
   * @param args - {@link WhereArgs} will be prefixed with `NOT` and joined with `OR`
   */
  orWhereNot<T extends PickQuerySelectableRelations$1>(this: T, ...args: WhereArgs<T>): T & QueryHasWhere$1;
  /**
   * `whereIn` and related methods are for the `IN` operator to check for inclusion in a list of values.
   *
   * When used with a single column it works equivalent to the `in` column operator:
   *
   * ```ts
   * db.table.whereIn('column', [1, 2, 3]);
   * db.table.whereIn('column', new Set([1, 2, 3]));
   * // the same as:
   * db.table.where({ column: { in: [1, 2, 3] } });
   * db.table.where({ column: { in: new Set([1, 2, 3]) } });
   * ```
   *
   * `whereIn` can support a tuple of columns, that's what the `in` operator cannot support:
   *
   * ```ts
   * db.table.whereIn(
   *   ['id', 'name'],
   *   [
   *     [1, 'Alice'],
   *     [2, 'Bob'],
   *   ],
   * );
   * ```
   *
   * It supports sub query which should return records with columns of the same type:
   *
   * ```ts
   * db.table.whereIn(['id', 'name'], db.otherTable.select('id', 'name'));
   * ```
   *
   * It supports raw SQL expression:
   *
   * ```ts
   * db.table.whereIn(['id', 'name'], sql`((1, 'one'), (2, 'two'))`);
   * ```
   *
   * An empty list passed to `whereIn` or `orWhereIn` matches no records, and an empty list passed to `whereNotIn` or `orWhereNotIn` matches all records.
   *
   * An empty `whereIn` list, alone or with other `where` conditions, makes the query return an empty result without querying the database, the same as {@link QueryMethods.none}.
   * A query with `with` or `union` still queries the database.
   *
   * ```ts
   * // return an empty result without querying the database:
   * db.table.whereIn('id', []);
   * db.table.whereIn(['id', 'name'], []);
   * db.table.whereIn({ id: [] });
   * db.table.where({ name: 'Ann' }).whereIn('id', []);
   *
   * // return records named Ann:
   * db.table.whereIn('id', []).orWhere({ name: 'Ann' });
   * db.table.where({ name: 'Ann' }).orWhereIn('id', []);
   * db.table.where({ name: 'Ann' }).whereNotIn('id', []);
   * ```
   *
   * `update` and `delete` throw when an empty `whereNotIn` or `orWhereNotIn` list makes them match all records, unless `all()` is called.
   */
  whereIn<T extends PickQuerySelectableRelations$1, Column extends WhereInColumn<T>>(this: T, ...args: [column: Column, values: WhereInValues<T, Column>] | [arg: WhereInArg<T>]): T & QueryHasWhere$1;
  /**
   * Takes the same arguments as {@link whereIn}.
   * Add a `WHERE IN` condition prefixed with `OR` to the query:
   *
   * ```ts
   * db.table.whereIn('a', [1, 2, 3]).orWhereIn('b', ['one', 'two']);
   * ```
   */
  orWhereIn<T extends PickQuerySelectableRelations$1, Column extends WhereInColumn<T>>(this: T, ...args: [column: Column, values: WhereInValues<T, Column>] | [WhereInArg<T>]): T & QueryHasWhere$1;
  /**
   * Acts as `whereIn`, but negates the condition with `NOT`:
   *
   * ```ts
   * db.table.whereNotIn('color', ['red', 'green', 'blue']);
   * ```
   */
  whereNotIn<T extends PickQuerySelectableRelations$1, Column extends WhereInColumn<T>>(this: T, ...args: [column: Column, values: WhereInValues<T, Column>] | [arg: WhereInArg<T>]): T & QueryHasWhere$1;
  /**
   * Acts as `whereIn`, but prepends `OR` to the condition and negates it with `NOT`:
   *
   * ```ts
   * db.table.whereNotIn('a', [1, 2, 3]).orWhereNoIn('b', ['one', 'two']);
   * ```
   */
  orWhereNotIn<T extends PickQuerySelectableRelations$1, Column extends WhereInColumn<T>>(this: T, ...args: [column: Column, values: WhereInValues<T, Column>] | [arg: WhereInArg<T>]): T & QueryHasWhere$1;
  /**
   * `whereExists` is for support of the `WHERE EXISTS (query)` clause.
   *
   * This method is accepting the same arguments as `join`, see the {@link Join.join} section for more details.
   *
   * ```ts
   * // find users who have accounts
   * // find by a relation name if it's defined
   * db.user.whereExists('account');
   *
   * // find users who have an account with positive balance
   * // `accounts` is a relation name
   * db.user.whereExists((q) => q.accounts.where({ balance: { gt: 0 } }));
   *
   * // find using a table and a join conditions
   * db.user.whereExists(db.account, 'account.id', 'user.id');
   *
   * // find using a query builder in a callback:
   * db.user.whereExists(db.account, (q) => q.on('account.id', '=', 'user.id'));
   * ```
   */
  whereExists<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>, Cb extends JoinCallbackArgs<T, Arg>>(this: T, arg: Arg, ...args: Cb | JoinArgs<T, Arg>): Arg extends QueryFnReturningSelect ? {
    error: 'Cannot select in whereExists';
  } : Cb[0] extends QueryFnReturningSelect ? {
    error: 'Cannot select in whereExists';
  } : T & QueryHasWhere$1;
  /**
   * Acts as `whereExists`, but prepends the condition with `OR`:
   *
   * ```ts
   * // find users who have an account or a profile,
   * // imagine that the user has both `account` and `profile` relations defined.
   * db.user.whereExist('account').orWhereExists('profile');
   * ```
   */
  orWhereExists<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>>(this: T, arg: Arg, ...args: JoinArgs<T, Arg>): T & QueryHasWhere$1;
  /**
   * Acts as `whereExists`, but negates the condition with `NOT`:
   *
   * ```ts
   * // find users who don't have an account,
   * // image that the user `belongsTo` or `hasOne` account.
   * db.user.whereNotExist('account');
   * ```
   *
   * @param arg - relation name, or a query object, or a `with` table alias, or a callback returning a query object.
   * @param args - no arguments needed when the first argument is a relation name, or conditions to join the table with.
   */
  whereNotExists<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>>(this: T, arg: Arg, ...args: JoinArgs<T, Arg>): T & QueryHasWhere$1;
  /**
   * Acts as `whereExists`, but prepends the condition with `OR` and negates it with `NOT`:
   *
   * ```ts
   * // find users who don't have an account OR who don't have a profile
   * // imagine that the user has both `account` and `profile` relations defined.
   * db.user.whereNotExists('account').orWhereNotExists('profile');
   * ```
   */
  orWhereNotExists<T extends PickQuerySelectableShapeRelationsWithDataAs, Arg extends JoinFirstArg<T>>(this: T, arg: Arg, ...args: JoinArgs<T, Arg>): T & QueryHasWhere$1;
}
/**
 * This feature allows defining a set of query modifiers to use it later.
 * Only [where conditions](/guide/where.html) can be set in a scope.
 * If you define a scope with name `default`, it will be applied for all table queries by default.
 *
 * ```ts
 * import { defineTable } from './table-factory';
 *
 * export const SomeTable = defineTable('some', (t) => ({
 *   id: t.identity().primaryKey(),
 *   hidden: t.boolean(),
 *   active: t.boolean(),
 * })).scopes({
 *   default: (q) => q.where({ hidden: false }),
 *   active: (q) => q.where({ active: true }),
 * });
 *
 * const db = orchidORM(
 *   { databaseURL: '...' },
 *   {
 *     some: SomeTable,
 *   },
 * );
 *
 * // the default scope is applied for all queries:
 * const nonHiddenRecords = await db.some;
 * ```
 */
declare class QueryScope {
  /**
   * See {@link QueryScope}
   *
   * Use the `scope` method to apply a pre-defined scope.
   *
   * ```ts
   * // use the `active` scope that is defined in the table:
   * await db.some.scope('active');
   * ```
   *
   * @param scope - name of the scope to apply
   */
  scope<T extends PickQueryScopes>(this: T, scope: keyof T['__scopes']): T & QueryHasWhere$1;
  /**
   * See {@link QueryScope}
   *
   * Remove conditions that were added by the scope from the query.
   *
   * ```ts
   * // SomeTable has a default scope, ignore it for this query:
   * await db.some.unscope('default');
   * ```
   *
   * @param scope - name of the scope to remove from the query
   */
  unscope<T extends PickQueryScopes>(this: T, scope: keyof T['__scopes']): T;
}
interface TableData$1 {
  primaryKey?: TableData$1.PrimaryKey;
  indexes?: TableData$1.Index[];
  excludes?: TableData$1.Exclude[];
  constraints?: TableData$1.Constraint[];
}
declare namespace TableData$1 {
  export type DropMode = 'CASCADE' | 'RESTRICT';
  export interface PrimaryKey {
    columns: string[];
    name?: string;
  }
  export interface ColumnIndex {
    options: Index.ColumnOptionsData;
  }
  export interface ColumnExclude extends ColumnIndex {
    with: string;
  }
  export interface Index {
    columns: Index.ColumnOrExpressionOptions[];
    options: Index.Options;
  }
  export interface Exclude {
    columns: Exclude.ColumnOrExpressionOptions[];
    options: Exclude.Options;
  }
  export interface Constraint {
    name?: string;
    check?: Check;
    identity?: Identity;
    references?: References;
    dropMode?: TableData$1.DropMode;
  }
  export type Check = RawSqlBase$1;
  export interface ColumnReferences {
    fnOrTable: TableData$1.References.FnOrTable;
    foreignColumns: string[];
    options?: References.Options;
  }
  export interface References extends ColumnReferences {
    columns: string[];
  }
  export interface Identity extends SequenceBaseOptions {
    always?: boolean;
  }
  interface SequenceBaseOptions {
    increment?: number;
    start?: number;
    min?: number;
    max?: number;
    cache?: number;
    cycle?: boolean;
  }
  export interface SequenceOptions extends SequenceBaseOptions {
    dataType?: 'smallint' | 'integer' | 'bigint';
    ownedBy?: string;
  }
  export namespace Index {
    export interface ColumnOptions {
      collate?: string;
      opclass?: string;
      order?: string;
      weight?: SearchWeight$1;
    }
    /**
     * Controls when Postgres checks a unique constraint.
     */
    export type UniqueDeferrable = false | 'immediate' | 'deferred';
    export interface BaseUniqueOptionsArg<Name extends string = string> {
      name?: Name;
      nullsNotDistinct?: boolean;
      using?: string;
      include?: MaybeArray$1<string>;
      with?: string;
      tablespace?: string;
      where?: string;
      dropMode?: DropMode;
    }
    export interface UniqueOptionsArg<Name extends string = string> extends BaseUniqueOptionsArg<Name> {
      /**
       * Makes this unique definition a deferrable Postgres constraint.
       */
      deferrable?: UniqueDeferrable;
    }
    export interface NonUniqueIndexOptionsArg<Name extends string = string> extends BaseUniqueOptionsArg<Name> {
      unique?: false;
      deferrable?: never;
    }
    export interface UniqueIndexOptionsArg<Name extends string = string> extends UniqueOptionsArg<Name> {
      unique: true;
    }
    export type OptionsArg<Name extends string = string> = NonUniqueIndexOptionsArg<Name> | UniqueIndexOptionsArg<Name>;
    export type TsVectorArg = OptionsArg & TsVectorOptions;
    export interface Options extends UniqueOptionsArg, TsVectorOptions {
      unique?: boolean;
    }
    export interface UniqueColumnArg<Name extends string = string> extends ColumnOptions, UniqueOptionsArg<Name> {
      expression?: string;
    }
    export interface NonUniqueColumnArg<Name extends string = string> extends ColumnOptions, BaseUniqueOptionsArg<Name> {
      expression?: string;
      unique?: false;
      deferrable?: never;
    }
    export interface UniqueIndexColumnArg<Name extends string = string> extends UniqueColumnArg<Name> {
      unique: true;
    }
    export interface ColumnOptionsData extends ColumnOptions, Options {
      expression?: string;
    }
    export type ColumnArg<Name extends string = string> = NonUniqueColumnArg<Name> | UniqueIndexColumnArg<Name>;
    interface TsVectorOptions {
      language?: string;
      languageColumn?: string;
      tsVector?: boolean;
    }
    export type TsVectorColumnArg = ColumnArg & TsVectorOptions;
    export interface ExpressionOptions extends ColumnOptions {
      expression: string;
    }
    export interface ColumnOptionsForColumn<Column extends PropertyKey> extends ColumnOptions {
      column: Column;
    }
    export type ColumnOrExpressionOptions<Column extends PropertyKey = string> = ColumnOptionsForColumn<Column> | ExpressionOptions;
    export {};
  }
  export namespace Exclude {
    export interface Options {
      name?: string;
      using?: string;
      include?: MaybeArray$1<string>;
      with?: string;
      tablespace?: string;
      where?: string;
      dropMode?: DropMode;
    }
    export interface ArgColumnOptions {
      collate?: string;
      opclass?: string;
      order?: string;
    }
    export interface ColumnArg extends Options, ArgColumnOptions {}
    interface ColumnBaseOptions extends ArgColumnOptions {
      with: string;
    }
    interface ColumnOptions<Column extends PropertyKey> extends ColumnBaseOptions {
      column: Column;
    }
    interface ExpressionOptions extends ColumnBaseOptions {
      expression: string;
    }
    export type ColumnOrExpressionOptions<Column extends PropertyKey = string> = ColumnOptions<Column> | ExpressionOptions;
    export {};
  }
  export namespace References {
    type FnOrTable = (() => Column.ForeignKey.TableParam) | string;
    /**
     * - MATCH FULL will not allow one column of a multicolumn foreign key to be null unless all foreign key columns are null;
     * if they are all null, the row is not required to have a match in the referenced table.
     * - MATCH SIMPLE (default) allows any of the foreign key columns to be null; if any of them are null, the row is not required to have a match in the referenced table.
     * - MATCH PARTIAL - PG docs say it's not implemented.
     */
    type Match = 'FULL' | 'PARTIAL' | 'SIMPLE';
    /**
     * - NO ACTION Produce an error indicating that the deletion or update would create a foreign key constraint violation. If the constraint is deferred, this error will be produced at constraint check time if there still exist any referencing rows. This is the default action.
     * - RESTRICT Produce an error indicating that the deletion or update would create a foreign key constraint violation. This is the same as NO ACTION except that the check is not deferrable.
     * - CASCADE Delete any rows referencing the deleted row, or update the values of the referencing column(s) to the new values of the referenced columns, respectively.
     * - SET NULL Set all the referencing columns, or a specified subset of the referencing columns, to null. A subset of columns can only be specified for ON DELETE actions.
     * - SET DEFAULT Set all the referencing columns, or a specified subset of the referencing columns, to their default values. A subset of columns can only be specified for ON DELETE actions. (There must be a row in the referenced table matching the default values, if they are not null, or the operation will fail.)
     */
    type Action = 'NO ACTION' | 'RESTRICT' | 'CASCADE' | 'SET NULL' | 'SET DEFAULT';
    interface BaseOptions {
      match?: Match;
      onUpdate?: Action;
      onDelete?: Action;
      dropMode?: TableData$1.DropMode;
    }
    interface Options extends BaseOptions {
      name?: string;
    }
  }
  export {};
}
interface AdditionalNumberData {
  lt?: number;
  lte?: number;
  gt?: number;
  gte?: number;
  step?: number;
  int?: boolean;
  finite?: boolean;
  safe?: boolean;
}
interface BaseNumberData$1 extends Column$1.Data, AdditionalNumberData {}
interface AdditionalStringData {
  min?: number;
  max?: number;
  length?: number;
  email?: boolean;
  url?: boolean;
  emoji?: boolean;
  uuid?: boolean;
  cuid?: boolean;
  cuid2?: boolean;
  ulid?: boolean;
  regex?: RegExp;
  includes?: string;
  startsWith?: string;
  endsWith?: string;
  datetime?: {
    offset?: boolean;
    precision?: number;
  };
  ipv4?: true;
  ipv6?: true;
  nonEmpty?: boolean;
  trim?: boolean;
  toLowerCase?: boolean;
  toUpperCase?: boolean;
}
interface StringData$1 extends Column$1.Data, AdditionalStringData {}
interface AdditionalDateData {
  min?: Date;
  max?: Date;
}
interface DateColumnData$1 extends Column$1.Data, AdditionalDateData {}
interface ArrayMethodsData {
  min?: number;
  max?: number;
  length?: number;
  nonEmpty?: boolean;
}
type Code$1 = string | Codes$1;
type Codes$1 = Code$1[];
interface ColumnToCodeCtx$1 {
  t: string;
  table: string;
  currentSchema: string;
  migration?: boolean;
  snakeCase?: boolean;
  sql?: string;
  isSqlUsed?: boolean;
}
type DateColumnInput$1 = string | number | Date;
declare abstract class DateBaseColumn<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  dateParsedByDriver?: boolean | undefined;
  __schema: Schema;
  __type: string;
  __inputType: DateColumnInput$1;
  inputSchema: ReturnType<Schema['stringNumberDate']>;
  data: DateColumnData$1;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: DateColumnInput$1;
  querySchema: ReturnType<Schema['stringNumberDate']>;
  operators: OperatorsDate$1;
  asNumber: Schema['dateAsNumber'];
  asDate: Schema['dateAsDate'];
  constructor(schema: Schema, dateParsedByDriver?: boolean | undefined);
}
declare class DateColumn$1<Schema extends ColumnSchemaConfig$1> extends DateBaseColumn<Schema> {
  dataType: 'date';
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare abstract class DateTimeBaseClass<Schema extends ColumnSchemaConfig$1> extends DateBaseColumn<Schema> {
  data: DateColumnData$1 & {
    dateTimePrecision?: number;
  };
  constructor(schema: Schema, dateTimePrecision?: number, dateParsedByDriver?: boolean);
  toSQL(): string;
}
declare abstract class DateTimeTzBaseClass<Schema extends ColumnSchemaConfig$1> extends DateTimeBaseClass<Schema> {
  abstract baseDataType: string;
  toSQL(): string;
}
declare class TimestampColumn$1<Schema extends ColumnSchemaConfig$1> extends DateTimeBaseClass<Schema> {
  dataType: 'timestamp';
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class TimestampTZColumn$1<Schema extends ColumnSchemaConfig$1> extends DateTimeTzBaseClass<Schema> {
  dataType: 'timestamptz';
  baseDataType: 'timestamp';
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class TimeColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  __type: string;
  __inputType: ReturnType<Schema['stringSchema']>;
  inputSchema: ReturnType<Schema['stringSchema']>;
  data: DateColumnData$1 & {
    dateTimePrecision?: number;
  };
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  dataType: 'time';
  operators: OperatorsTime;
  constructor(schema: Schema, dateTimePrecision?: number);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class IntervalColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  __type: PostgresInterval;
  data: Column$1.Data & {
    fields?: string;
    precision?: number;
  };
  __inputType: Partial<PostgresInterval>;
  inputSchema: ReturnType<Schema['timeInterval']>;
  __outputType: PostgresInterval;
  outputSchema: ReturnType<Schema['timeInterval']>;
  __queryType: PostgresInterval;
  querySchema: ReturnType<Schema['timeInterval']>;
  dataType: 'interval';
  operators: OperatorsDate$1;
  constructor(schema: Schema, fields?: string, precision?: number, parse?: (input: string) => PostgresInterval);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  toSQL(): string;
}
declare class EnumColumn$1<Schema extends ColumnTypeSchemaArg$1, SchemaType extends Schema['__schemaType'], const T extends readonly string[]> extends Column$1 {
  enumName: string;
  options: T;
  __schema: Schema;
  operators: OperatorsOrdinalText$1;
  __type: T[number];
  __inputType: T[number];
  inputSchema: SchemaType;
  __outputType: T[number];
  outputSchema: SchemaType;
  __queryType: T[number];
  querySchema: SchemaType;
  dataType: string;
  constructor(schema: Schema, enumName: string, options: T, schemaType: SchemaType);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  toSQL(): string;
}
interface ArrayColumnValue$1 {
  __type: unknown;
  inputSchema: any;
  __inputType: unknown;
  __outputType: unknown;
  outputSchema: any;
  __queryType: any;
  querySchema: any;
  toSQL(): string;
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  data: Column$1.Data;
}
interface ArrayData$1<Item extends ArrayColumnValue$1> extends Column$1.Data, ArrayMethodsData {
  item: Item;
  arrayDims: number;
}
declare class ArrayColumn$1<Schema extends ColumnTypeSchemaArg$1, Item extends ArrayColumnValue$1, InputType, OutputType, QueryType> extends Column$1 {
  __schema: Schema;
  dataType: 'array';
  operators: OperatorsArray$1<Item['__queryType']>;
  data: ArrayData$1<Item>;
  __type: Item['__type'][];
  __inputType: Item['__type'][];
  inputSchema: InputType;
  __outputType: Item['__outputType'][];
  outputSchema: OutputType;
  __queryType: Item['__queryType'][];
  querySchema: QueryType;
  constructor(schema: Schema, item: Item, __inputType: InputType, defaultEncode?: (input: unknown) => unknown, __outputType?: OutputType, __queryType?: QueryType);
  toSQL(): string;
  toCode(this: ArrayColumn$1<ColumnSchemaConfig$1, ArrayColumnValue$1, unknown, unknown, unknown>, ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class JSONColumn$1<T, Schema extends ColumnTypeSchemaArg$1, InputSchema = Schema['__schemaType']> extends Column$1 {
  __schema: Schema;
  dataType: 'jsonb';
  __type: T;
  __inputType: T;
  inputSchema: InputSchema;
  __outputType: T;
  outputSchema: InputSchema;
  __queryType: T;
  querySchema: InputSchema;
  operators: OperatorsJson$1;
  constructor(schema: Schema, __inputType: InputSchema, encodedByDriver?: boolean);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class JSONTextColumn$1<T, Schema extends ColumnTypeSchemaArg$1, InputSchema = Schema['__schemaType']> extends Column$1 {
  __schema: Schema;
  dataType: 'json';
  __type: T;
  __inputType: T;
  inputSchema: InputSchema;
  __outputType: T;
  outputSchema: InputSchema;
  __queryType: T;
  querySchema: InputSchema;
  operators: OperatorsText$1;
  private static _instance;
  static get instance(): JSONTextColumn$1<unknown, DefaultSchemaConfig$1, unknown>;
  constructor(schema: Schema, __inputType: InputSchema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
interface NumberColumnData$1 extends BaseNumberData$1, Column$1.Data {
  identity?: TableData$1.Identity;
}
interface SerialColumnData$1 extends NumberColumnData$1 {
  default: true;
}
declare abstract class NumberBaseColumn<Schema extends ColumnSchemaConfig$1, SchemaType extends Schema['__schemaType']> extends Column$1 {
  __schema: Schema;
  __type: number;
  __inputType: number;
  inputSchema: SchemaType;
  data: NumberColumnData$1;
  __outputType: number;
  outputSchema: SchemaType;
  __queryType: number;
  querySchema: SchemaType;
  operators: OperatorsNumber$1;
}
declare abstract class IntegerBaseColumn<Schema extends ColumnSchemaConfig$1> extends NumberBaseColumn<Schema, ReturnType<Schema['int']>> {
  data: NumberColumnData$1;
  querySchema: ReturnType<Schema['int']>;
  constructor(schema: Schema);
}
declare abstract class NumberAsStringBaseColumn<Schema extends ColumnSchemaConfig$1, InputType = string | number> extends Column$1 {
  __schema: Schema;
  __type: string;
  __inputType: InputType;
  inputSchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsNumber$1;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: InputType;
  querySchema: ReturnType<Schema['stringSchema']>;
  data: Column$1.Data;
  constructor(schema: Schema);
}
interface DecimalColumnData$1 extends Column$1.Data {
  numericPrecision?: number;
  numericScale?: number;
}
declare class DecimalColumn$1<Schema extends ColumnSchemaConfig$1> extends NumberAsStringBaseColumn<Schema> {
  data: DecimalColumnData$1;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsNumber$1;
  dataType: 'numeric';
  constructor(schema: Schema, numericPrecision?: number, numericScale?: number);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  toSQL(): string;
}
declare class SmallIntColumn$1<Schema extends ColumnSchemaConfig$1> extends IntegerBaseColumn<Schema> {
  dataType: 'int2';
  querySchema: ReturnType<Schema['int']>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  identity<T extends Column$1.Pick.Data>(this: T, options?: TableData$1.Identity): Column$1.HasDefault<T>;
}
declare class IntegerColumn$1<Schema extends ColumnSchemaConfig$1> extends IntegerBaseColumn<Schema> {
  dataType: 'int4';
  querySchema: ReturnType<Schema['int']>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  identity<T extends Column$1.Pick.Data>(this: T, options?: TableData$1.Identity): Column$1.HasDefault<T>;
}
declare class BigIntColumn$1<Schema extends ColumnSchemaConfig$1> extends NumberAsStringBaseColumn<Schema, string | number | bigint> {
  dataType: 'int8';
  querySchema: ReturnType<Schema['stringSchema']>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  identity<T extends Column$1.Pick.Data>(this: T, options?: TableData$1.Identity): Column$1.HasDefault<T>;
}
declare class RealColumn$1<Schema extends ColumnSchemaConfig$1> extends NumberBaseColumn<Schema, ReturnType<Schema['number']>> {
  dataType: 'float4';
  querySchema: ReturnType<Schema['number']>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class DoublePrecisionColumn$1<Schema extends ColumnSchemaConfig$1> extends NumberAsStringBaseColumn<Schema> {
  dataType: 'float8';
  querySchema: ReturnType<Schema['stringSchema']>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class SmallSerialColumn$1<Schema extends ColumnSchemaConfig$1> extends IntegerBaseColumn<Schema> {
  dataType: 'int2';
  data: SerialColumnData$1;
  querySchema: ReturnType<Schema['int']>;
  constructor(schema: Schema);
  toSQL(): string;
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class SerialColumn$1<Schema extends ColumnSchemaConfig$1> extends IntegerBaseColumn<Schema> {
  dataType: 'int4';
  data: SerialColumnData$1;
  querySchema: ReturnType<Schema['int']>;
  constructor(schema: Schema);
  toSQL(): string;
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class BigSerialColumn$1<Schema extends ColumnSchemaConfig$1> extends NumberAsStringBaseColumn<Schema> {
  dataType: 'int8';
  data: SerialColumnData$1;
  querySchema: ReturnType<Schema['stringSchema']>;
  constructor(schema: Schema);
  toSQL(): string;
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
interface DefaultSchemaConfig$1 extends ColumnSchemaConfig$1<Column$1> {
  nullable<T extends Column$1.Pick.ForNullable>(this: T): Column$1.Nullable<T>;
  parse<T extends Column$1.Pick.ForParse, Output>(this: T, fn: (input: T['__type']) => Output): Column$1.Parse<T, unknown, Output>;
  parseNull<T extends Column$1.Pick.ForParseNull, Output>(this: T, fn: () => Output): Column$1.ParseNull<T, unknown, Output>;
  encode<T extends Column$1.Pick.Type, Input>(this: T, fn: (input: Input) => unknown): Column$1.Encode<T, unknown, Input>;
  /**
   * @deprecated use narrowType instead
   */
  asType<T, Types extends {
    type: unknown;
    __inputType: unknown;
    __outputType: unknown;
    __queryType: unknown;
  }>(this: T, _fn: (type: <Type, Input = Type, Output = Type, Query = Type>() => {
    type: Type;
    __inputType: Input;
    __outputType: Output;
    __queryType: Query;
  }) => Types): { [K in keyof T]: K extends '__type' ? Types['type'] : K extends keyof Types ? Types[K] : T[K]; };
  narrowType<T extends Column$1.InputOutputQueryTypes, Types extends Column$1.InputOutputQueryTypes>(this: T, _fn: (type: <Type extends T['__inputType'] extends T['__outputType'] & T['__queryType'] ? T['__outputType'] & T['__queryType'] : T['__inputType'] & T['__outputType'] & T['__queryType']>() => {
    __inputType: T['__inputType'] extends never ? never : Type;
    __outputType: Type;
    __queryType: Type;
  }) => Types): { [K in keyof T]: K extends keyof Types ? Types[K] : T[K]; };
  narrowAllTypes<T extends Column$1.InputOutputQueryTypes, Types extends Column$1.InputOutputQueryTypes>(this: T, _fn: (type: <Types extends {
    input?: T['__inputType'];
    output?: T['__outputType'];
    query?: T['__queryType'];
  }>() => {
    __inputType: undefined extends Types['input'] ? T['__inputType'] : Types['input'];
    __outputType: undefined extends Types['output'] ? T['__outputType'] : Types['output'];
    __queryType: undefined extends Types['query'] ? T['__queryType'] : Types['query'];
  }) => Types): { [K in keyof T]: K extends keyof Types ? Types[K] : T[K]; };
  dateAsNumber<T extends Column$1.Pick.ForParse>(this: T): Column$1.Parse<T, unknown, number>;
  dateAsDate<T extends Column$1.Pick.ForParse>(this: T): Column$1.Parse<T, unknown, Date>;
  enum<const T extends readonly [string, ...string[]]>(dataType: string, type: T): EnumColumn$1<DefaultSchemaConfig$1, unknown, T>;
  array<Item extends ArrayColumnValue$1>(item: Item): ArrayColumn$1<DefaultSchemaConfig$1, Item, unknown, unknown, unknown>;
  json<T>(): JSONColumn$1<unknown extends T ? MaybeArray$1<string | number | boolean | object> : T, DefaultSchemaConfig$1>;
  jsonText<T>(): JSONTextColumn$1<unknown extends T ? MaybeArray$1<string | number | boolean | object> : T, DefaultSchemaConfig$1>;
  inputSchema(): undefined;
  outputSchema(): undefined;
  querySchema(): undefined;
  updateSchema(): undefined;
  pkeySchema(): undefined;
  smallint(): SmallIntColumn$1<DefaultSchemaConfig$1>;
  integer(): IntegerColumn$1<DefaultSchemaConfig$1>;
  real(): RealColumn$1<DefaultSchemaConfig$1>;
  smallSerial(): SmallSerialColumn$1<DefaultSchemaConfig$1>;
  serial(): SerialColumn$1<DefaultSchemaConfig$1>;
  bigint(): BigIntColumn$1<DefaultSchemaConfig$1>;
  decimal(precision?: number, scale?: number): DecimalColumn$1<DefaultSchemaConfig$1>;
  doublePrecision(): DoublePrecisionColumn$1<DefaultSchemaConfig$1>;
  bigSerial(): BigSerialColumn$1<DefaultSchemaConfig$1>;
  money(): MoneyColumn$1<DefaultSchemaConfig$1>;
  varchar(limit?: number): VarCharColumn$1<DefaultSchemaConfig$1>;
  text(): TextColumn$1<DefaultSchemaConfig$1>;
  string(limit?: number): StringColumn$1<DefaultSchemaConfig$1>;
  citext(): CitextColumn$1<DefaultSchemaConfig$1>;
  date(): DateColumn$1<DefaultSchemaConfig$1>;
  timestampNoTZ(precision?: number): TimestampColumn$1<DefaultSchemaConfig$1>;
  timestamp(precision?: number): TimestampTZColumn$1<DefaultSchemaConfig$1>;
}
type DeleteArgs<T extends PickQueryHasWhere> = T['__hasWhere'] extends true ? EmptyTuple$1 : [never];
type DeleteResult<T extends PickQueryHasSelectResultReturnType> = T['__hasSelect'] extends true ? T : T['returnType'] extends undefined | 'all' ? SetQueryReturnsRowCountMany<T> : SetQueryReturnsRowCount<T>;
interface DeleteSelf extends PickQueryHasSelectHasWhereResultReturnType, Query.Pick.IsNotReadOnly {}
declare class QueryDelete {
  /**
   * This method deletes one or more rows, based on other conditions specified in the query.
   *
   * By default, `delete` will return a count of deleted records.
   *
   * Place `select`, `selectAll`, or `get` before `delete` to specify returning columns.
   *
   * Need to provide `where`, `findBy`, or `find` conditions before calling `delete`.
   * To prevent accidental deletion of all records, deleting without where will result in TypeScript and a runtime error.
   *
   * Use `all()` to delete ALL records without conditions:
   *
   * ```ts
   * await db.table.all().delete();
   * ```
   *
   * ```ts
   * // deletedCount is the number of deleted records
   * const deletedCount = await db.table.where(...conditions).delete();
   *
   * // returns a single value, throws if not found
   * const id: number | undefined = await db.table
   *   .findBy(...conditions)
   *   .get('id')
   *   .delete();
   *
   * // returns an array of records with specified columns
   * const deletedRecord = await db.table
   *   .select('id', 'name', 'age')
   *   .where(...conditions)
   *   .delete();
   *
   * // returns an array of fully deleted records
   * const deletedUsersFull = await db.table
   *   .selectAll()
   *   .where(...conditions)
   *   .delete();
   * ```
   *
   * `delete` supports joining, under the hood the join is transformed to `USING` and `WHERE` statements:
   *
   * ```ts
   * // delete all users who have corresponding profile records:
   * db.table.join(db.profile, 'profile.userId', 'user.id').all().delete();
   * ```
   *
   * `delete` can be used in {@link WithMethods.with} expressions:
   *
   * ```ts
   * db.$qb
   *   // delete a record in one table
   *   .with('a', db.table.find(1).select('id').delete())
   *   // delete a record in other table using the first table record id
   *   .with('b', (q) =>
   *     db.otherTable.select('id').whereIn('aId', q.from('a').pluck('id')).delete(),
   *   )
   *   .from('b');
   * ```
   */
  delete<T extends DeleteSelf>(this: T, ..._args: DeleteArgs<T>): DeleteResult<T>;
}
interface QueryWithSoftDelete extends PickQueryResult, PickQueryReturnType, PickQueryHasSelect, PickQueryHasWhere, Query.Pick.IsNotReadOnly {
  __scopes: NonDeletedScope;
}
interface NonDeletedScope {
  nonDeleted: true;
}
/**
 * `softDelete` configures the table to set `deletedAt` to current time instead of deleting records.
 * All queries on such table will filter out deleted records by default.
 *
 * ```ts
 * import { defineTable } from './table-factory';
 *
 * export const SomeTable = defineTable('some', (t) => ({
 *   id: t.identity().primaryKey(),
 *   deletedAt: t.timestamp().nullable(),
 * }))
 *   // true is for using `deletedAt` column
 *   .softDelete();
 *
 * // or provide a different column name
 * export const OtherTable = defineTable('other', (t) => ({
 *   id: t.identity().primaryKey(),
 *   myDeletedAt: t.timestamp().nullable(),
 * })).softDelete('myDeletedAt');
 *
 * const db = orchidORM(
 *   { databaseURL: '...' },
 *   {
 *     someTable: SomeTable,
 *   },
 * );
 *
 * // deleted records are ignored by default
 * const onlyNonDeleted = await db.someTable;
 * ```
 */
declare class SoftDeleteMethods {
  /**
   * `includeDeleted` disables the default `deletedAt` filter:
   *
   * ```ts
   * const allRecords = await db.someTable.includeDeleted();
   * ```
   */
  includeDeleted<T extends QueryWithSoftDelete>(this: T): T;
  /**
   * `hardDelete` deletes records bypassing the `softDelete` behavior:
   *
   * ```ts
   * await db.someTable.find(1).hardDelete();
   * ```
   */
  hardDelete<T extends QueryWithSoftDelete>(this: T, ..._args: DeleteArgs<T>): DeleteResult<T>;
}
interface QueryInternalColumnNameToKey {
  columnNameToKeyMap?: Map<string, string>;
}
declare namespace RlsPolicy$1 {
  export type PolicyMode = 'PERMISSIVE' | 'RESTRICTIVE';
  export type PolicyCommand = 'ALL' | 'SELECT' | 'INSERT' | 'UPDATE' | 'DELETE';
  interface Base {
    name: string;
    to: string | string[];
  }
  export interface ForSelectOrDelete extends Base {
    for: 'SELECT' | 'DELETE';
    using: RawSqlBase$1;
    withCheck?: never;
  }
  export interface ForInsert extends Base {
    for: 'INSERT';
    using?: never;
    withCheck: RawSqlBase$1;
  }
  export interface ForAllOrUpdate extends Base {
    for?: 'ALL' | 'UPDATE';
    using: RawSqlBase$1;
    withCheck: RawSqlBase$1;
  }
  export type Policy = ForSelectOrDelete | ForInsert | ForAllOrUpdate;
  export {};
}
declare namespace Rls$1 {
  interface TableConfigBase {
    enable?: boolean;
    force?: boolean;
  }
  interface TableConfig extends TableConfigBase {
    permit: [RlsPolicy$1.Policy, ...RlsPolicy$1.Policy[]];
    restrict?: RlsPolicy$1.Policy[];
  }
  interface TableDefaults {
    /**
     * Default RLS table flags for declarations that omit them.
     */
    enable?: boolean;
    force?: boolean;
  }
  interface Options {
    tableRlsDefaults?: TableDefaults;
  }
}
declare namespace DefaultPrivileges$1 {
  export type ObjectType = (typeof DEFAULT_PRIVILEGE.OBJECT_TYPES)[number];
  export interface Privilege {
    Table: (typeof DEFAULT_PRIVILEGE.PRIVILEGES.TABLE)[number];
    Sequence: (typeof DEFAULT_PRIVILEGE.PRIVILEGES.SEQUENCE)[number];
    Function: (typeof DEFAULT_PRIVILEGE.PRIVILEGES.FUNCTION)[number];
    Type: (typeof DEFAULT_PRIVILEGE.PRIVILEGES.TYPE)[number];
    Schema: (typeof DEFAULT_PRIVILEGE.PRIVILEGES.SCHEMA)[number];
    LargeObject: (typeof DEFAULT_PRIVILEGE.PRIVILEGES.LARGE_OBJECT)[number];
  }
  interface ObjectSetting<T> {
    privileges?: T[];
    grantablePrivileges?: T[];
  }
  export interface SchemaTargetConfig {
    owner?: string;
    schema: string;
    all?: boolean;
    allGrantable?: boolean;
    tables?: ObjectSetting<Privilege['Table']>;
    sequences?: ObjectSetting<Privilege['Sequence']>;
    functions?: ObjectSetting<Privilege['Function']>;
    types?: ObjectSetting<Privilege['Type']>;
  }
  export interface GlobalTargetConfig {
    owner?: string;
    schema?: never;
    all?: boolean;
    allGrantable?: boolean;
    tables?: ObjectSetting<Privilege['Table']>;
    sequences?: ObjectSetting<Privilege['Sequence']>;
    functions?: ObjectSetting<Privilege['Function']>;
    types?: ObjectSetting<Privilege['Type']>;
    schemas?: ObjectSetting<Privilege['Schema']>;
    largeObjects?: ObjectSetting<Privilege['LargeObject']>;
  }
  export interface SupportedDefaultPrivileges {
    OBJECT_TYPES: string[];
    PRIVILEGES: {
      TABLE: string[];
      SEQUENCE: string[];
      FUNCTION: string[];
      TYPE: string[];
      SCHEMA: string[];
      LARGE_OBJECT?: string[];
    };
  }
  export type SchemaConfig = SchemaTargetConfig | GlobalTargetConfig;
  export {};
}
declare const DEFAULT_PRIVILEGE: {
  OBJECT_TYPES: readonly ['TABLES', 'SEQUENCES', 'FUNCTIONS', 'TYPES', 'SCHEMAS', 'LARGE_OBJECTS'];
  PRIVILEGES: {
    TABLE: readonly ['ALL', 'SELECT', 'INSERT', 'UPDATE', 'DELETE', 'TRUNCATE', 'REFERENCES', 'TRIGGER', 'MAINTAIN'];
    SEQUENCE: readonly ['ALL', 'USAGE', 'SELECT', 'UPDATE'];
    FUNCTION: readonly ['ALL', 'EXECUTE'];
    TYPE: readonly ['ALL', 'USAGE'];
    SCHEMA: readonly ['ALL', 'USAGE', 'CREATE'];
    LARGE_OBJECT: readonly ['ALL', 'SELECT', 'UPDATE'];
  };
};
interface DbRole {
  name: string;
  super?: boolean;
  inherit?: boolean;
  createRole?: boolean;
  createDb?: boolean;
  canLogin?: boolean;
  replication?: boolean;
  connLimit?: number;
  validUntil?: Date;
  bypassRls?: boolean;
  config?: RecordOptionalString$1;
  defaultPrivileges?: DefaultPrivileges$1.SchemaConfig[];
}
declare namespace Grant {
  type Role = string | [string, ...string[]];
  type TablePrivilege = 'ALL' | 'SELECT' | 'INSERT' | 'UPDATE' | 'DELETE' | 'TRUNCATE' | 'REFERENCES' | 'TRIGGER' | 'MAINTAIN';
  type SequencePrivilege = 'ALL' | 'USAGE' | 'SELECT' | 'UPDATE';
  type RoutinePrivilege = 'ALL' | 'EXECUTE';
  type TypePrivilege = 'ALL' | 'USAGE';
  type DomainPrivilege = 'ALL' | 'USAGE';
  type SchemaPrivilege = 'ALL' | 'USAGE' | 'CREATE';
  type DatabasePrivilege = 'ALL' | 'CREATE' | 'CONNECT' | 'TEMPORARY' | 'TEMP';
  interface SchemaGrant {
    to: Role;
    grantedBy?: string;
    schemas: string[];
    privileges?: SchemaPrivilege[];
    grantablePrivileges?: SchemaPrivilege[];
  }
  interface TableGrant {
    to: Role;
    grantedBy?: string;
    tables: string[];
    privileges?: TablePrivilege[];
    grantablePrivileges?: TablePrivilege[];
  }
  interface TableClassGrant {
    to: Role;
    grantedBy?: string;
    privileges?: TablePrivilege[];
    grantablePrivileges?: TablePrivilege[];
  }
  interface AllTablesInGrant {
    to: Role;
    grantedBy?: string;
    allTablesIn: string[];
    privileges?: TablePrivilege[];
    grantablePrivileges?: TablePrivilege[];
  }
  interface SequenceGrant {
    to: Role;
    grantedBy?: string;
    sequences: string[];
    privileges?: SequencePrivilege[];
    grantablePrivileges?: SequencePrivilege[];
  }
  interface AllSequencesInGrant {
    to: Role;
    grantedBy?: string;
    allSequencesIn: string[];
    privileges?: SequencePrivilege[];
    grantablePrivileges?: SequencePrivilege[];
  }
  interface RoutineGrant {
    to: Role;
    grantedBy?: string;
    routines: string[];
    privileges?: RoutinePrivilege[];
    grantablePrivileges?: RoutinePrivilege[];
  }
  interface AllRoutinesInGrant {
    to: Role;
    grantedBy?: string;
    allRoutinesIn: string[];
    privileges?: RoutinePrivilege[];
    grantablePrivileges?: RoutinePrivilege[];
  }
  interface TypeGrant {
    to: Role;
    grantedBy?: string;
    types: string[];
    privileges?: TypePrivilege[];
    grantablePrivileges?: TypePrivilege[];
  }
  interface DomainGrant {
    to: Role;
    grantedBy?: string;
    domains: string[];
    privileges?: DomainPrivilege[];
    grantablePrivileges?: DomainPrivilege[];
  }
  interface DatabaseGrant {
    to: Role;
    grantedBy?: string;
    databases: string[];
    privileges?: DatabasePrivilege[];
    grantablePrivileges?: DatabasePrivilege[];
  }
  type Privilege = SchemaGrant | TableGrant | AllTablesInGrant | SequenceGrant | AllSequencesInGrant | RoutineGrant | AllRoutinesInGrant | TypeGrant | DomainGrant | DatabaseGrant;
  interface InternalPrivilege {
    to: string[];
    grantedBy?: string;
    schemas?: string[];
    tables?: string[];
    allTablesIn?: string[];
    sequences?: string[];
    allSequencesIn?: string[];
    routines?: string[];
    allRoutinesIn?: string[];
    types?: string[];
    domains?: string[];
    databases?: string[];
    privileges?: string[];
    grantablePrivileges?: string[];
  }
  type IgnoreSelector = string | RegExp | (string | RegExp)[];
  interface Ignore {
    roles?: IgnoreSelector;
    schemas?: IgnoreSelector;
    tables?: IgnoreSelector;
    allTablesIn?: IgnoreSelector;
    sequences?: IgnoreSelector;
    allSequencesIn?: IgnoreSelector;
    routines?: IgnoreSelector;
    allRoutinesIn?: IgnoreSelector;
    types?: IgnoreSelector;
    domains?: IgnoreSelector;
    databases?: IgnoreSelector;
  }
}
interface QueryInternal$1<SinglePrimaryKey = any, UniqueColumns = any, UniqueColumnNames = any, UniqueColumnTuples = any, UniqueConstraints = any> extends QueryInternalColumnNameToKey {
  runtimeDefaultColumns?: string[];
  asyncStorage: AsyncStateStorage$1;
  scopes?: RecordUnknown$1;
  snakeCase?: boolean;
  noPrimaryKey: boolean;
  comment?: string;
  readOnly?: boolean;
  materialized?: boolean;
  generatorIgnored?: true;
  primaryKeys?: string[];
  singlePrimaryKey: SinglePrimaryKey;
  uniqueColumns: UniqueColumns;
  uniqueColumnNames: UniqueColumnNames;
  uniqueColumnTuples: UniqueColumnTuples;
  uniqueConstraints: UniqueConstraints;
  extensions?: DbExtension$1[];
  domains?: DbDomainArgRecord;
  generatorIgnore?: GeneratorIgnore$1;
  roles?: DbRole[];
  rls?: Rls$1.Options;
  tableRls?: Rls$1.TableConfig;
  tableGrants?: Grant.TableClassGrant[];
  viewData?: {
    query?: Query;
    sql?: string | RawSqlBase$1;
    recursive?: boolean;
    checkOption?: 'LOCAL' | 'CASCADED';
    securityBarrier?: boolean;
    securityInvoker?: boolean;
    withData?: boolean;
  };
  managedRolesSql?: string;
  defaultGrantedBy?: string;
  grants?: Grant.InternalPrivilege[];
  tableData: TableData$1;
  nowSQL?: string;
  callbackArg?: Query;
  selectAllCount: number;
  /**
   * @see DbSharedOptions
   */
  nestedCreateBatchMax: number;
}
type QuerySchema$1 = (() => string) | string;
declare class QueryWithSchema {
  /**
   * Specifies the schema to be used as a prefix of a table name.
   *
   * Though this method can be used to set the schema right when building the query,
   * it's better to specify schema when calling `db(table, () => columns, { schema: string })`
   *
   * ```ts
   * db.table.withSchema('customSchema').select('id');
   * ```
   *
   * Resulting SQL:
   *
   * ```sql
   * SELECT "user"."id" FROM "customSchema"."user"
   * ```
   *
   * You can set a **default** schema for all tables in a callback by using {@link $withOptions}.
   *
   * @param schema - a name of the database schema to use
   */
  withSchema<T>(this: T, schema: QuerySchema$1 | undefined): T;
}
interface QueryBuilder extends Query.NotReadOnlyQuery {
  returnType: undefined;
}
type SQLQueryArgs = TemplateLiteralArgs$1 | [RawSqlBase$1];
interface RawSqlBase$1<T extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumn> extends Expression$1<T> {
  _sql: string | TemplateLiteralArgs$1;
  _values?: RawSQLValues;
}
interface RawSql$1<T extends Column$1.Pick.QueryColumn, ColumnTypes> extends Expression$1<T>, RawSqlBase$1<T>, ExpressionTypeMethod {}
declare class RawSql$1<T extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumn, ColumnTypes = DefaultColumnTypes$1<ColumnSchemaConfig$1>> extends Expression$1<T> {
  result: {
    value: T;
  };
  columnTypes: ColumnTypes;
  q: ExpressionData$1;
  _sql: string | TemplateLiteralArgs$1;
  _values?: RawSQLValues;
  constructor(sql: string | TemplateLiteralArgs$1, values?: RawSQLValues, type?: T);
  values<Self extends RawSqlBase$1>(this: Self, values: RawSQLValues): Self;
  makeSQL(ctx: ToSqlValues$1, quotedAs?: string): string;
}
interface DynamicRawSQL$1<T extends Column$1.Pick.QueryColumn> extends Expression$1<T>, ExpressionTypeMethod {}
declare class DynamicRawSQL$1<T extends Column$1.Pick.QueryColumn, ColumnTypes = DefaultColumnTypes$1<ColumnSchemaConfig$1>> extends Expression$1<T> {
  fn: DynamicSQLArg<T>;
  columnTypes: ColumnTypes;
  result: {
    value: T;
  };
  q: ExpressionData$1;
  dynamicBefore: boolean;
  constructor(fn: DynamicSQLArg<T>);
  makeSQL(ctx: ToSQLCtx$1, quotedAs?: string): string;
}
interface SqlFnMethods {
  /**
   * `sql.join` builds a SQL list from values and expressions.
   * Plain values are bound as query parameters, while SQL expressions render as SQL.
   *
   * Use it for SQL constructs such as `ARRAY[...]`, `IN (...)`, function arguments,
   * or tuple lists. The default separator is `, `. Provide a SQL expression as the
   * custom separator when a different separator is needed.
   *
   * ```ts
   * await db.user.whereSql`"id" IN (${sql.join([1, 2, 3])})`;
   * ```
   *
   * ```ts
   * await db.user.whereSql`
   *   (${sql.join([sql.ref('name'), sql.ref('age')])}) IN (${sql.join(
   *     users.map((user) => sql`(${user.name}, ${user.age})`),
   *   )})
   * `;
   * ```
   *
   * ```ts
   * await db.user.select({
   *   displayName: (q) =>
   *     sql<string>`concat(${sql.join(
   *       [q.column('firstName'), q.column('lastName')],
   *       sql` || ' ' || `,
   *     )})`,
   * });
   * ```
   */
  join<T = unknown>(items: readonly unknown[], separator?: RawSqlBase$1): SqlJoinExpression<Column$1.Pick.QueryColumnOfType<T>>;
  /**
   * `sql.ref` quotes a SQL identifier such as a table name, column name, or schema name.
   * Use it when you need to dynamically reference an identifier in raw SQL.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * const schema = 'my_schema';
   *
   * // Produces: SET LOCAL search_path TO "my_schema"
   * await db.$query`SET LOCAL search_path TO ${sql.ref(schema)}`
   * ```
   *
   * It handles dots to support qualified names:
   *
   * ```ts
   * // "my_schema"."my_table"
   * sql.ref('my_schema.my_table');
   * ```
   */
  ref(name: string): SqlRefExpression;
  unsafe(sql: string | number | boolean): UnsafeSqlExpression;
  val<T>(value: T): ValExpression$1<T>;
}
interface SqlFn$1 extends SqlFnMethods {
  <T, Args extends TemplateLiteralArgs$1 | [sql: string] | [values: RecordUnknown$1, sql?: string]>(this: T, ...args: Args): Args extends [RecordUnknown$1] ? (...sql: TemplateLiteralArgs$1) => RawSql$1<Column$1.Pick.QueryColumn, T> : RawSql$1<Column$1.Pick.QueryColumn, T>;
}
declare class UnsafeSqlExpression extends Expression$1 {
  sql: string | number | boolean;
  result: {
    value: Column$1.Pick.QueryColumn;
  };
  q: ExpressionData$1;
  constructor(sql: string | number | boolean);
  makeSQL(): string;
}
interface MutativeQueriesSelectRelationsQueryData {
  selectRelation?: true;
}
interface MutativeQueriesSelectRelationsSqlProp {
  mutativeQueriesSelectRelationsState?: MutativeQueriesSelectRelationsSqlState;
}
interface MutativeQueriesSelectRelationsSqlState {
  query: IsQuery$1;
  value?: MutativeQueriesSelectRelationsValue;
}
interface MutativeQueriesSelectRelationsValue {
  [K: string]: IsQuery$1;
}
interface SqlCommonOptions extends HasTableHook, HasCteHooks, MutativeQueriesSelectRelationsSqlProp {}
interface SingleSqlItem$1 {
  text: string;
  values?: unknown[];
  prepare?: true;
  runAfterQuery?: RunAfterQuery;
}
interface RunAfterQuery {
  (queryResult: QueryResult$1): void | Promise<{
    result: unknown;
  }>;
}
interface SingleSql$1 extends SingleSqlItem$1, SqlCommonOptions {}
interface BatchSql extends SqlCommonOptions {
  batch: SingleSql$1[];
}
type Sql$1 = SingleSql$1 | BatchSql;
declare class QuerySql<ColumnTypes> {
  /**
   * @deprecated: use `sql` exported from the table factory file.
   *
   * When there is a need to use a piece of raw SQL, use the `sql` exported from the table factory file, it is also attached to query objects for convenience.
   *
   * When selecting a custom SQL, specify a resulting type with `<generic>` syntax:
   *
   * ```ts
   * import { sql } from './table-factory';
   *
   * const result: { num: number }[] = await db.table.select({
   *   num: sql<number>`random() * 100`,
   * });
   * ```
   *
   * In a situation when you want the result to be parsed, such as when returning a timestamp that you want to be parsed into a `Date` object, provide a column type in such a way:
   *
   * This example assumes that the `timestamp` column was overridden with `asDate` as shown in [Override column types](/guide/columns-overview#override-column-types).
   *
   * ```ts
   * import { sql } from './table-factory';
   *
   * const result: { timestamp: Date }[] = await db.table.select({
   *   timestamp: sql`now()`.type((t) => t.timestamp()),
   * });
   * ```
   *
   * In some cases such as when using [from](/guide/orm-and-query-builder.html#from), setting column type via callback allows for special `where` operations:
   *
   * ```ts
   * const subQuery = db.someTable.select({
   *   sum: () => sql`$a + $b`.type((t) => t.decimal()).values({ a: 1, b: 2 }),
   * });
   *
   * // `gt`, `gte`, `min`, `lt`, `lte`, `max` in `where`
   * // are allowed only for numeric columns:
   * const result = await db.$from(subQuery).where({ sum: { gte: 5 } });
   * ```
   *
   * Many query methods have a version suffixed with `Sql`, you can pass an SQL template literal directly to these methods.
   * These methods are: `whereSql`, `whereNotSql`, `orderSql`, `havingSql`, `fromSql`, `findBySql`.
   *
   * ```ts
   * await db.table.whereSql`"someValue" = random() * 100`;
   * ```
   *
   * Interpolating values in template literals is completely safe:
   *
   * ```ts
   * // get value from user-provided params
   * const { value } = req.params;
   *
   * // SQL injection is prevented by a library, this is safe:
   * await db.table.whereSql`column = ${value}`;
   * ```
   *
   * In the example above, TS cannot check if the table has `column` column, or if there are joined tables that have such column which will lead to error.
   * Instead, use the [column](/guide/sql-expressions#column) or [ref](/guide/sql-expressions#ref) to reference a column:
   *
   * ```ts
   * // ids will be prefixed with proper table names, no ambiguity:
   * db.table.join(db.otherTable, 'id', 'other.otherId').where`
   *   ${db.table.column('id')} = 1 AND
   *   ${db.otherTable.ref('id')} = 2
   * `;
   * ```
   *
   * SQL can be passed with a simple string, it's important to note that this is not safe to interpolate values in it.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // no interpolation is okay
   * await db.table.where(sql({ raw: 'column = random() * 100' }));
   *
   * // get value from user-provided params
   * const { value } = req.params;
   *
   * // this is NOT safe, SQL injection is possible:
   * await db.table.where(sql({ raw: `column = random() * ${value}` }));
   * ```
   *
   * To inject values into `sql({ raw: '...' })` SQL strings, denote it with `$` in the string and provide `values` object.
   *
   * Use `$$` to provide column or/and table name (`column` or `ref` are preferable). Column names will be quoted so don't quote them manually.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // get value from user-provided params
   * const { value } = req.params;
   *
   * // this is SAFE, SQL injection are prevented:
   * await db.table.where(
   *   sql<boolean>({
   *     raw: '$$column = random() * $value',
   *     values: {
   *       column: 'someTable.someColumn', // or simply 'column'
   *       one: value,
   *       two: 123,
   *     },
   *   }),
   * );
   * ```
   *
   * Summarizing:
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // simplest form:
   * sql`key = ${value}`;
   *
   * // with resulting type:
   * sql<boolean>`key = ${value}`;
   *
   * // with column type for select:
   * sql`key = ${value}`.type((t) => t.boolean());
   *
   * // with column name via `column` method:
   * sql`${db.table.column('column')} = ${value}`;
   *
   * // raw SQL string, not allowed to interpolate values:
   * sql({ raw: 'random()' });
   *
   * // with resulting type and `raw` string:
   * sql<number>({ raw: 'random()' });
   *
   * // with column name and a value in a `raw` string:
   * sql({
   *   raw: `$$column = $value`,
   *   values: { column: 'columnName', value: 123 },
   * });
   *
   * // combine template literal, column type, and values:
   * sql`($one + $two) / $one`.type((t) => t.numeric()).values({ one: 1, two: 2 });
   * ```
   *
   * @param args - template literal or an object { raw: string }
   * @return object that has `type` and `values` methods
   */
  sql<T = unknown>(this: PickQueryColumTypes, ...args: StaticSQLArgs$1): RawSql$1<Column$1.Pick.QueryColumnOfType<T>, ColumnTypes>;
  sql<T = unknown>(this: PickQueryColumTypes, ...args: [DynamicSQLArg<Column$1.Pick.QueryColumnOfType<T>>]): DynamicRawSQL$1<Column$1.Pick.QueryColumnOfType<T>, ColumnTypes>;
}
interface QueryLogObject$1 {
  colors: boolean;
  beforeQuery(sql: SingleSql$1): unknown;
  afterQuery(sql: SingleSql$1, logData: unknown): void;
  onError(error: Error, sql: SingleSql$1, logData: unknown): void;
}
interface QueryLogger$1 {
  log(message: string): void;
  warn(message: string): void;
  error(message: string): void;
}
declare class QueryLog {
  /**
   * Override the `log` option, which can also be set in `createDb` or when creating a table instance:
   *
   * ```ts
   * // turn log on for this query:
   * await db.table.all().log(true);
   * await db.table.all().log(); // no argument for true
   *
   * // turn log off for this query:
   * await db.table.all().log(false);
   * ```
   *
   * Use {@link $withOptions} to override `log` for a scope of a callback.
   */
  log<T>(this: T, log?: boolean): T;
}
interface SqlSessionState$1 {
  /**
   * Postgres role for SQL session context.
   *
   * `$withOptions` applies it around query execution; transaction options apply
   * it with transaction-local semantics.
   */
  role?: string;
  /**
   * Postgres custom settings for SQL session context.
   *
   * `$withOptions` applies them around query execution; transaction options
   * apply them with transaction-local semantics.
   */
  setConfig?: Record<string, string | number | boolean>;
}
interface AsyncState$1 extends SqlSessionState$1 {
  transactionAdapter?: TransactionAdapter$1;
  transactionId?: number;
  afterCommit?: TransactionAfterCommitHook[];
  log?: QueryLogObject$1;
  testTransactionCount?: number;
  schema?: QuerySchema$1;
  transactionRole?: SqlSessionState$1['role'];
  transactionSetConfig?: SqlSessionState$1['setConfig'];
}
/**
 * Async local storage of the query state that falls back to a state set for code running outside of its `run` callbacks.
 *
 * It wraps `AsyncLocalStorage` instead of extending it, because Node.js `run` restores the previous state read with `getStore`,
 * and an overridden `getStore` would leave the fallback state in the caller's context.
 */
declare class AsyncStateStorage$1 {
  /**
   * State of the innermost test transaction, for code running outside of `run` callbacks.
   */
  fallback?: AsyncState$1;
  private storage;
  getStore(): AsyncState$1 | undefined;
  run<Result>(state: AsyncState$1, cb: () => Result): Result;
}
interface StorageOptions$1 extends SqlSessionState$1 {
  log?: boolean;
  schema?: QuerySchema$1;
}
interface ProcessedStorageOptions extends SqlSessionState$1 {
  log?: QueryLogObject$1;
  schema?: QuerySchema$1;
}
declare class QueryStorage {
  withOptions<Result>(this: PickQueryQAndInternal, options: StorageOptions$1, cb: () => Promise<Result>): Promise<Result>;
}
/**
 * Generic result returning from query methods.
 */
interface QueryResultRow$1 {
  [K: string]: any;
}
interface QueryResult$1<T = any> {
  rowCount: number;
  rows: T[];
  /**
   * node-postgres and postgres-js: fields are present even for empty results.
   * Bun doesn't implement fields in the same way, fields are empty if no rows returned.
   */
  fields: {
    name: string;
  }[];
}
interface AdapterConfigBase$1 {
  databaseURL?: string;
  database?: string;
  user?: string;
  password?: string | (() => string | Promise<string>);
  searchPath?: string;
  ssl?: any;
  /**
   * Postgres settings to apply when driver connections are configured.
   *
   * `searchPath` is normalized to `search_path` in this map.
   */
  setConfig?: RecordString$1;
  schema?: QuerySchema$1;
  host?: string;
  /**
   * This option may be useful in CI when database container has started, CI starts performing next steps,
   * migrations begin to apply though database may be not fully ready for connections yet.
   *
   * Set `connectRetry: true` for the default backoff strategy. It performs 10 attempts starting with 50ms delay and increases delay exponentially according to this formula:
   *
   * ```
   * (factor, defaults to 1.5) ** (currentAttempt - 1) * (delay, defaults to 50)
   * ```
   *
   * So the 2nd attempt will happen in 50ms from start, 3rd attempt in 125ms, 3rd in 237ms, and so on.
   *
   * You can customize max attempts to be made, `factor` multiplier and the starting delay by passing:
   *
   * ```ts
   * const options = {
   *   databaseURL: process.env.DATABASE_URL,
   *   connectRetry: {
   *     attempts: 15, // max attempts
   *     strategy: {
   *       delay: 100, // initial delay
   *       factor: 2, // multiplier for the formula above
   *     }
   *   }
   * };
   *
   * rakeDb(options, { ... });
   * ```
   *
   * You can pass a custom function to `strategy` to customize delay behavior:
   *
   * ```ts
   * import { setTimeout } from 'timers/promises';
   *
   * const options = {
   *   databaseURL: process.env.DATABASE_URL,
   *   connectRetry: {
   *     attempts: 5,
   *     strategy(currentAttempt: number, maxAttempts: number) {
   *       // linear: wait 100ms after 1st attempt, then 200m after 2nd, and so on.
   *       return setTimeout(currentAttempt * 100);
   *     },
   *   },
   * };
   * ```
   */
  connectRetry?: AdapterConfigConnectRetryParam | true;
}
interface AdapterConfigConnectRetryParam {
  attempts?: number;
  strategy?: AdapterConfigConnectRetryStrategyParam | AdapterConfigConnectRetryStrategy;
}
interface AdapterConfigConnectRetryStrategyParam {
  delay?: number;
  factor?: number;
}
interface AdapterConfigConnectRetryStrategy {
  (attempt: number, attempts: number): Promise<void> | void;
}
interface AdapterTransactionOptions extends ProcessedStorageOptions {
  level?: IsolationLevel$1;
  readOnly?: boolean;
  deferrable?: boolean;
}
interface Adapter$1 {
  errorClass: new (...args: any[]) => Error;
  searchPath?: string;
  driverAdapter: DriverAdapter$1;
  isInTransaction(this: Adapter$1): this is TransactionAdapter$1;
  assignError(to: QueryError, from: Error): void;
  query<T extends QueryResultRow$1 = QueryResultRow$1>(text: string, values?: unknown[], sqlSessionState?: SqlSessionState$1, prepare?: true): Promise<QueryResult$1<T>>;
  arrays<R extends any[] = any[]>(text: string, values?: unknown[], sqlSessionState?: SqlSessionState$1, prepare?: true): Promise<QueryResult$1<R>>;
  /**
   * Run a transaction
   *
   * `options` can be `undefined`.
   */
  transaction<T>(asyncStorage: AsyncStateStorage$1 | undefined, options: AdapterTransactionOptions | undefined, cb: (adapter: TransactionAdapter$1) => Promise<T>): Promise<T>;
  close(): Promise<void>;
  getDatabase(): string;
  getUser(): string;
  getSearchPath(): string | undefined;
  getHost(): string;
  getSchema(): QuerySchema$1 | undefined;
  clone(params?: AdapterConfigBase$1): Adapter$1;
}
/**
 * Adapter interface for transaction contexts.
 */
interface TransactionAdapter$1 extends Adapter$1 {
  isInTransaction(this: Adapter$1): this is TransactionAdapter$1;
  savepoint<T>(name: string, log: QueryLogObject$1 | undefined, cb: () => Promise<T>): Promise<T>;
  /**
   * This is a workaround for postgres-js savepoint limitations.
   * Postgres-js dictates this:
   * - must use its `savepoint` method over manual `SAVEPOINT` because when doing it manually there is no way to prevent transaction from being rolled back when a query in a savepoint fails.
   * - must use its `sql` client from inside the `savepoint` method for the lifetime of the savepoint because of the reason above.
   */
  hackySavepoint<T extends QueryResultRow$1 = QueryResultRow$1>(state: HackySavepointState, text: string, values?: unknown[], arraysMode?: boolean, prepare?: true, log?: QueryLogObject$1): Promise<QueryResult$1<T>>;
}
type Pool = any;
type Client = any;
interface AdapterSchemaConfigOptions$1 {
  jsonEncodedByDriver?: boolean;
  dateParsedByDriver?: boolean;
  arrayEncode?(input: unknown): unknown;
  intervalParse?(input: string): PostgresInterval;
}
/**
 * Adapter class used by runtime orchestrator to create driver-specific adapters.
 */
interface DriverAdapter$1 {
  noFieldsForArrays?: boolean;
  schemaConfig?: AdapterSchemaConfigOptions$1;
  errorClass: new (...args: any[]) => Error;
  errorFields: RecordString$1;
  configure(config: AdapterConfigBase$1): Pool;
  manualPool: boolean;
  borrow(pool: Pool): Client;
  release(client: Client): void;
  queryClient<T = QueryResultRow$1>(client: Client, text: string, values?: unknown[], arraysMode?: boolean, prepare?: true): Promise<QueryResult$1<T>>;
  begin<DriverClient, Result>(pool: Pool, cb: (client: DriverClient) => Promise<Result>, options?: string): Promise<Result>;
  savepoint<T>(client: Client, setClient: (client: Client) => void, name: string, cb: () => Promise<T>, onSavepoint?: SavepointCallback, beforeRelease?: SavepointCallback, onRelease?: SavepointCallback, beforeRollback?: SavepointCallback, onRollback?: SavepointCallback): Promise<T>;
  hackySavepoint<T extends QueryResultRow$1>(client: Client, setClient: (client: Client) => void, state: HackySavepointState, text: string, values?: unknown[], arraysMode?: boolean, prepare?: true, onSavepoint?: SavepointCallback, beforeRelease?: SavepointCallback, onRelease?: SavepointCallback, beforeRollback?: SavepointCallback, onRollback?: SavepointCallback): Promise<QueryResult$1<T>>;
  close(pool: Pool): Promise<void>;
}
type SavepointCallback = () => void;
interface HackySavepointStateActiveSavepoint {
  release(): Promise<void>;
  rollback(err: unknown): Promise<void>;
}
interface HackySavepointState {
  name: string;
  activeSavepoint?: HackySavepointStateActiveSavepoint;
}
/**
 * Element of `afterCommit` transaction array. See {@link AsyncState.afterCommit}.
 */
type TransactionAfterCommitHook = unknown[] | Query | AfterCommitHook[] | AfterCommitStandaloneHook$1;
interface AfterCommitHook {
  (data: unknown[], q: Query): unknown | Promise<unknown>;
}
interface AfterCommitStandaloneHook$1 {
  (): unknown | Promise<unknown>;
}
interface PickQueryDataParsers {
  defaultParsers?: ColumnsParsers;
  parsers?: ColumnsParsers;
  batchParsers?: BatchParsers;
}
type ColumnParser = FnUnknownToUnknown;
interface BatchParserPathEntry {
  key: string;
  returnType: QueryReturnType$1;
}
interface BatchParser {
  path: BatchParserPathEntry[];
  fn: (path: BatchParserPathEntry[], queryResult: {
    rows: unknown[];
  }) => MaybePromise$1<void>;
}
type ColumnsParsers = { [K in string]?: ColumnParser; };
type BatchParsers = BatchParser[];
interface QueryThen<T> {
  <TResult1 = T, TResult2 = never>(onfulfilled?: (value: T) => TResult1 | PromiseLike<TResult1>, onrejected?: (reason: any) => TResult2 | PromiseLike<TResult2>): Promise<TResult1 | TResult2>;
}
type QueryThenShallowSimplify$1<T> = QueryThen<ShallowSimplify$1<T>>;
type QueryThenShallowSimplifyArr<T> = QueryThen<ShallowSimplify$1<T>[]>;
type QueryThenShallowSimplifyOptional<T> = QueryThen<ShallowSimplify$1<T> | undefined>;
type QueryThenByQuery<T extends PickQueryReturnType, Result extends Column$1.QueryColumns> = T['returnType'] extends undefined | 'all' ? QueryThenShallowSimplifyArr<ColumnsShape$1.Output<Result>> : T['returnType'] extends 'one' ? QueryThenShallowSimplifyOptional<ColumnsShape$1.Output<Result>> : T['returnType'] extends 'oneOrThrow' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<Result>> : T['returnType'] extends 'value' ? QueryThen<Result['value']['__outputType'] | undefined> : T['returnType'] extends 'valueOrThrow' ? QueryThen<Result['value']['__outputType']> : T['returnType'] extends 'rows' ? QueryThen<ColumnsShape$1.Output<Result>[keyof Result][][]> : T['returnType'] extends 'pluck' ? QueryThen<Result['pluck']['__outputType'][]> : QueryThen<void>;
type QueryThenByReturnType<T extends QueryReturnType$1, Result extends Column$1.QueryColumns> = T extends undefined | 'all' ? QueryThenShallowSimplifyArr<ColumnsShape$1.Output<Result>> : T extends 'one' ? QueryThenShallowSimplifyOptional<ColumnsShape$1.Output<Result>> : T extends 'oneOrThrow' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<Result>> : T extends 'value' ? QueryThen<Result['value']['__outputType'] | undefined> : T extends 'valueOrThrow' ? QueryThen<Result['value']['__outputType']> : T extends 'rows' ? QueryThen<ColumnsShape$1.Output<Result>[keyof Result][][]> : T extends 'pluck' ? QueryThen<Result['pluck']['__outputType'][]> : QueryThen<void>;
interface QueryCatch$1 {
  <Q, TResult = never>(this: {
    then: (onfulfilled?: (value: Q) => any) => any;
  }, onrejected?: (reason: any) => TResult | PromiseLike<TResult>): Promise<Q | TResult>;
}
interface QueryCatchers {
  catchUniqueError<ThenResult, CatchResult>(this: {
    then: (onfulfilled?: (value: ThenResult) => any) => any;
  }, fn: (reason: QueryError) => CatchResult): Promise<ThenResult | CatchResult>;
}
interface SelectSelf extends PickQuerySelectable, PickQueryHasSelect, PickQueryDefaultSelect, PickQueryShape$1, PickQueryRelations$1, PickQueryResult, PickQueryReturnType, PickQueryWithData {}
type SelectArgs<T extends SelectSelf> = ('*' | keyof T['__selectable'])[];
interface SubQueryAddition<T extends PickQueryWithData> extends IsSubQuery {
  withData: T['withData'];
}
type SelectAsFnArg<T extends PickQueryRelationsWithData> = EmptyObject$1 extends T['relations'] ? T : { [K in keyof T['relations'] | keyof T]: K extends keyof T['relations'] ? RelationQueryMaybeSingle<T['relations'][K]> & SubQueryAddition<T> : K extends keyof T ? T[K] : never; };
interface SelectAsArg<T extends SelectSelf> {
  [K: string]: keyof T['__selectable'] | Expression$1 | ((q: SelectAsFnArg<T>) => unknown);
}
type SelectAsFnReturnType$1 = {
  result: Column$1.QueryColumns;
  returnType: Exclude<QueryReturnType$1, 'rows'>;
} | Expression$1;
interface SelectAsCheckReturnTypes {
  [K: string]: PropertyKey | Expression$1 | ((q: never) => SelectAsFnReturnType$1);
}
type SelectReturnType<T extends PickQueryReturnType> = T['returnType'] extends 'valueOrThrow' ? 'oneOrThrow' : T extends 'value' ? 'one' : T['returnType'] extends 'pluck' ? 'all' : T['returnType'];
type SelectResult<T extends SelectSelf, Columns extends PropertyKey[]> = { [K in keyof T]: K extends '__hasSelect' ? true : K extends 'result' ? { [K in '*' extends Columns[number] ? Exclude<Columns[number], '*'> | T['__defaultSelect'] : Columns[number] as T['__selectable'][K]['as']]: T['__selectable'][K]['column']; } & (T['__hasSelect'] extends (T['returnType'] extends 'value' | 'valueOrThrow' ? never : true) ? Omit<T['result'], Columns[number]> : unknown) : K extends 'returnType' ? SelectReturnType<T> : K extends 'then' ? QueryThenByReturnType<SelectReturnType<T>, { [K in '*' extends Columns[number] ? Exclude<Columns[number], '*'> | T['__defaultSelect'] : Columns[number] as T['__selectable'][K]['as']]: T['__selectable'][K]['column']; } & (T['__hasSelect'] extends (T['returnType'] extends 'value' | 'valueOrThrow' ? never : true) ? Omit<T['result'], Columns[number]> : unknown)> : T[K]; };
type SelectResultObj$1<T extends SelectSelf, Obj> = Obj extends SelectAsCheckReturnTypes ? { [K in keyof T]: K extends '__hasSelect' ? true : K extends '__selectable' ? T['__selectable'] & SelectAsSelectable<Obj> : K extends 'result' ? { [K in T['__hasSelect'] extends (T['returnType'] extends 'value' | 'valueOrThrow' ? never : true) ? keyof Obj | keyof T['result'] : keyof Obj]: K extends keyof Obj ? SelectAsValueResult<T, Obj[K]> : K extends keyof T['result'] ? T['result'][K] : never; } : K extends 'returnType' ? SelectReturnType<T> : K extends 'then' ? QueryThenByReturnType<SelectReturnType<T>, { [K in T['__hasSelect'] extends (T['returnType'] extends 'value' | 'valueOrThrow' ? never : true) ? keyof Obj | keyof T['result'] : keyof Obj]: K extends keyof Obj ? SelectAsValueResult<T, Obj[K]> : K extends keyof T['result'] ? T['result'][K] : never; }> : T[K]; } : `Invalid return type of ${{ [K in keyof Obj]: Obj[K] extends ((...args: any[]) => any) ? ReturnType<Obj[K]> extends SelectAsFnReturnType$1 ? never : K : never; }[keyof Obj] & string}`;
type SelectResultColumnsAndObj<T extends SelectSelf, Columns extends PropertyKey[], Obj> = { [K in keyof T]: K extends '__hasSelect' ? true : K extends '__selectable' ? T['__selectable'] & SelectAsSelectable<Obj> : K extends 'result' // Combine previously selected items, all columns if * was provided,
 ? { [K in ('*' extends Columns[number] ? Exclude<Columns[number], '*'> | T['__defaultSelect'] : Columns[number]) | keyof Obj as K extends Columns[number] ? T['__selectable'][K]['as'] : K]: K extends keyof Obj ? SelectAsValueResult<T, Obj[K]> : T['__selectable'][K]['column']; } & (T['__hasSelect'] extends (T['returnType'] extends 'value' | 'valueOrThrow' ? never : true) ? Omit<T['result'], Columns[number]> : unknown) : K extends 'returnType' ? SelectReturnType<T> : K extends 'then' ? QueryThenByReturnType<SelectReturnType<T>, { [K in ('*' extends Columns[number] ? Exclude<Columns[number], '*'> | T['__defaultSelect'] : Columns[number]) | keyof Obj as K extends Columns[number] ? T['__selectable'][K]['as'] : K]: K extends keyof Obj ? SelectAsValueResult<T, Obj[K]> : T['__selectable'][K]['column']; } & (T['__hasSelect'] extends (T['returnType'] extends 'value' | 'valueOrThrow' ? never : true) ? Omit<T['result'], Columns[number]> : unknown)> : T[K]; };
interface AllowedRelationOneQueryForSelectable extends IsSubQuery {
  result: Column$1.QueryColumns;
  returnType: 'value' | 'valueOrThrow' | 'one' | 'oneOrThrow';
}
type SelectAsSelectable<Obj> = UnionToIntersection<{ [K in keyof Obj]: Obj[K] extends ((q: never) => infer R extends AllowedRelationOneQueryForSelectable) ? { [C in R['returnType'] extends 'value' | 'valueOrThrow' ? K : keyof R['result'] as R['returnType'] extends 'value' | 'valueOrThrow' ? K : `${K & string}.${C & string}`]: {
  as: C;
  column: R['returnType'] extends 'value' | 'valueOrThrow' ? R['result']['value'] : R['result'][C & keyof R['result']];
}; } : never; }[keyof Obj]>;
type SelectAsValueResult<T extends SelectSelf, Arg> = Arg extends keyof T['__selectable'] ? T['__selectable'][Arg]['column'] : Arg extends Expression$1 ? Arg['result']['value'] : Arg extends ((q: never) => IsQuery$1) ? SelectSubQueryResult<ReturnType<Arg>> : Arg extends ((q: never) => Expression$1) ? ReturnType<Arg>['result']['value'] : Arg extends ((q: never) => IsQuery$1 | Expression$1) ? SelectSubQueryResult<Exclude<ReturnType<Arg>, Expression$1>> | Exclude<ReturnType<Arg>, IsQuery$1>['result']['value'] : never;
type SelectSubQueryResult<Arg extends SelectSelf> = Arg['returnType'] extends undefined | 'all' ? ColumnsShape$1.MapToObjectArrayColumn<Arg['result']> : Arg['returnType'] extends 'value' | 'valueOrThrow' ? Arg['result']['value'] : Arg['returnType'] extends 'pluck' ? ColumnsShape$1.MapToPluckColumn<Arg['result']> : Arg['returnType'] extends 'one' ? ColumnsShape$1.MapToNullableObjectColumn<Arg['result']> : ColumnsShape$1.MapToObjectColumn<Arg['result']>;
declare class Select {
  /**
   * Takes a list of columns to be selected, and by default, the query builder will select all columns of the table.
   *
   * The last argument can be an object. Keys of the object are column aliases, value can be a column name, sub-query, or raw SQL expression.
   *
   * ```ts
   * import { sql } from './baseTable'
   *
   * // select columns of the table:
   * db.table.select('id', 'name', { idAlias: 'id' });
   *
   * // accepts columns with table names:
   * db.table.select('user.id', 'user.name', { nameAlias: 'user.name' });
   *
   * // table name may refer to the current table or a joined table:
   * db.table
   *   .join(db.message, 'authorId', 'user.id')
   *   .select('user.name', 'message.text', { textAlias: 'message.text' });
   *
   * // select value from the sub-query,
   * // this sub-query should return a single record and a single column:
   * db.table.select({
   *   subQueryResult: Otherdb.table.select('column').take(),
   * });
   *
   * // select raw SQL value, specify the returning type via <generic> syntax:
   * db.table.select({
   *   raw: sql<number>`1 + 2`,
   * });
   *
   * // select raw SQL value, the resulting type can be set by providing a column type in such way:
   * db.table.select({
   *   raw: sql`1 + 2`.type((t) => t.integer()),
   * });
   *
   * // same raw SQL query as above, but the sql is returned from a callback
   * db.table.select({
   *   raw: () => sql`1 + 2`.type((t) => t.integer()),
   * });
   * ```
   *
   * When you use the ORM and defined relations, `select` can also accept callbacks with related table queries:
   *
   * ```ts
   * await db.author.select({
   *   allBooks: (q) => q.books,
   *   firstBook: (q) => q.books.order({ createdAt: 'ASC' }).take(),
   *   booksCount: (q) => q.books.count(),
   * });
   * ```
   *
   * When you're selecting a relation that's connected via `belongsTo` or `hasOne`, it becomes available to use in `order` or in `where`:
   *
   * ```ts
   * // select books with their authors included, order by author name and filter by author column:
   * await db.books
   *   .select({
   *     author: (q) => q.author,
   *   })
   *   .order('author.name')
   *   .where({ 'author.isPopular': true });
   * ```
   */
  select<T extends SelectSelf, Columns extends SelectArgs<T>>(this: T, ...args: Columns): SelectResult<T, Columns>;
  select<T extends SelectSelf, Obj extends SelectAsArg<T>>(this: T, obj: Obj): SelectResultObj$1<T, Obj>;
  select<T extends SelectSelf, Columns extends SelectArgs<T>, Obj extends SelectAsArg<T>>(this: T, ...args: [...columns: Columns, obj: Obj]): SelectResultColumnsAndObj<T, Columns, Obj>;
  /**
   * When querying the table or creating records, all columns are selected by default,
   * but updating and deleting queries are returning affected row counts by default.
   *
   * Use `selectAll` to select all columns. If the `.select` method was applied before it will be discarded.
   *
   * ```ts
   * const selectFull = await db.table
   *   .select('id', 'name') // discarded by `selectAll`
   *   .selectAll();
   *
   * const updatedFull = await db.table.selectAll().where(conditions).update(data);
   *
   * const deletedFull = await db.table.selectAll().where(conditions).delete();
   * ```
   */
  selectAll<T extends SelectSelf>(this: T): SelectResult<T, ['*']>;
}
type SelectItem = string | SelectAs$1 | Expression$1 | undefined;
interface SelectAs$1 {
  selectAs: SelectAsValue;
}
interface SelectAsValue {
  [K: string]: string | Query | Expression$1 | undefined;
}
type QueryDataTransform = QueryDataTransformFn | {
  map: (record: unknown, index: number, array: unknown) => unknown;
  thisArg?: unknown;
};
interface QueryDataTransformFn {
  (data: unknown, queryData: unknown): unknown;
}
declare class QueryTransform {
  /**
   * Transform the result of the query right after loading it.
   *
   * `transform` method should be called in the last order, other methods can't be chained after calling it.
   *
   * It is meant to transform the whole result of a query, for transforming individual records consider using {@link QueryMap.map}.
   *
   * The [hooks](/guide/hooks.html) that are going to run after the query will receive the query result **before** transferring.
   *
   * Consider the following example of a cursor-based pagination by `id`:
   *
   * ```ts
   * const lastId: number | undefined = req.query.cursor;
   *
   * type Result = {
   *   nodes: { id: number; text: string }[];
   *   cursor?: number;
   * };
   *
   * // result is only for demo, it will be inferred
   * const posts: Result = await db.post
   *   .select('id', 'text')
   *   .where({ id: { lt: lastId } })
   *   .order({ id: 'DESC' })
   *   .limit(100)
   *   .transform((nodes) => ({ nodes, cursor: nodes.at(-1)?.id }));
   * ```
   *
   * You can also use the `tranform` on nested sub-queries:
   *
   * ```ts
   * type Result = {
   *   nodes: {
   *     id: number;
   *     text: string;
   *     comments: { nodes: { id: number; text: string }[]; cursor?: number };
   *   }[];
   *   cursor?: number;
   * };
   *
   * const postsWithComments: Result = await db.post
   *   .select('id', 'text')
   *   .select({
   *     comments: (q) =>
   *       q.comments
   *         .select('id', 'text')
   *         .transform((nodes) => ({ nodes, cursor: nodes.at(-1)?.id })),
   *   })
   *   .transform((nodes) => ({ nodes, cursor: nodes.at(-1)?.id }));
   * ```
   *
   * @param fn - function to transform query result with
   */
  transform<T extends IsQuery$1, Result>(this: T, fn: (input: T extends {
    then: QueryThen<infer Data>;
  } ? Data : never, queryData: QueryData$1) => Result): { [K in keyof T]: K extends 'returnType' ? 'valueOrThrow' : K extends 'result' ? {
    value: Column$1.Pick.QueryColumnOfType<Result>;
  } : K extends 'then' ? QueryThen<Result> : T[K]; };
}
type SelectableOrExpression<T extends PickQuerySelectable = PickQuerySelectable, C extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumn> = '*' | keyof T['__selectable'] | Expression$1<C>;
type SelectableOrExpressions<T extends PickQuerySelectable = PickQuerySelectable, C extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumn> = ('*' | keyof T['__selectable'] | Expression$1<C>)[];
type ExpressionOutput<T extends PickQuerySelectable, Expr extends SelectableOrExpression<T>> = Expr extends keyof T['__selectable'] ? T['__selectable'][Expr]['column'] : Expr extends Expression$1 ? Expr['result']['value'] : never;
type ExpressionChain = (OperatorToSQL | unknown)[];
interface ExpressionData$1 extends HasBeforeAndBeforeSet {
  chain?: ExpressionChain;
  expr?: Expression$1;
  before?: QueryBeforeHook$1[];
  dynamicBefore?: boolean;
  getColumn?: Column$1;
  transform?: QueryDataTransform[];
}
declare abstract class Expression$1<T extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumn> {
  abstract result: {
    value: T;
  };
  abstract q: ExpressionData$1;
  meta: {
    kind: 'select';
  };
  toSQL(ctx: ToSqlValues$1, quotedAs?: string): string;
  /**
   * Transform the expression value after loading it.
   *
   * It is meant to transform expressions selected by a query.
   *
   * @param fn - function to transform expression value with
   */
  transform<Self extends {
    result: {
      value: Column$1.Pick.QueryColumn;
    };
    q: ExpressionData$1;
  }, Result>(this: Self, fn: (input: Self['result']['value']['__type'], queryData: ExpressionData$1) => Result): Omit<Self, 'result'> & {
    result: {
      value: Column$1.Pick.QueryColumnOfType<Result>;
    };
  };
  abstract makeSQL(ctx: ToSqlValues$1, quotedAs?: string): string;
}
type TemplateLiteralArgs$1 = [strings: TemplateStringsArray, ...values: unknown[]];
interface DynamicSQLArg<T extends Column$1.Pick.QueryColumn> {
  (sql: (...args: StaticSQLArgs$1) => Expression$1<T>): Expression$1<T>;
}
type StaticSQLArgs$1 = TemplateLiteralArgs$1 | [{
  raw: string;
  values?: RawSQLValues;
}];
type RawSQLValues = RecordUnknown$1;
declare abstract class ExpressionTypeMethod {
  type<T extends {
    q: {
      expr?: Expression$1;
    };
    columnTypes: unknown;
  }, C extends Column$1.Pick.QueryColumn>(this: T, fn: (types: T['columnTypes']) => C):
  // Omit is optimal
  Omit<T, 'result'> & {
    result: {
      value: C;
    };
  };
}
interface WithDataItem {
  table: string;
  shape: Column$1.QueryColumns;
}
interface WithDataItems {
  [K: string]: WithDataItem;
}
interface CteItem {
  n: string | ((as: string) => void);
  o?: CteOptions;
  q?: SubQueryForSql;
  s?: Expression$1;
  p?: boolean;
}
interface CteOptions {
  columns?: string[];
  recursive?: true;
  materialized?: true;
  notMaterialized?: true;
}
interface TopCTE {
  names: RecordUnknown$1;
  stack: string[][];
  append: string[][];
}
interface PickQueryTable {
  table?: string;
}
interface PickQueryThen {
  then: unknown;
}
interface PickQueryHasSelect {
  __hasSelect: boolean;
}
interface PickQueryHasWhere {
  __hasWhere: boolean;
}
interface PickQueryDefaults {
  __defaults: EmptyObject$1;
}
interface PickQueryTsQuery {
  __tsQuery?: string;
}
interface PickQueryScopes {
  __scopes: EmptyObject$1;
}
interface PickQueryDefaultSelect {
  __defaultSelect: PropertyKey;
}
interface PickQueryHasSelectResultReturnType extends PickQueryHasSelect, PickQueryResult, PickQueryReturnType {}
interface PickQueryHasSelectResultShapeAsRelations extends PickQueryHasSelect, PickQueryResult, PickQueryShape$1, PickQueryAs, PickQueryRelations$1 {}
interface PickQueryHasSelectHasWhereResultReturnType extends PickQueryHasSelect, PickQueryHasWhere, PickQueryResult, PickQueryReturnType {}
interface PickQueryHasSelectResult extends PickQueryHasSelect, PickQueryResult {}
interface PickQuerySelectable {
  __selectable: QuerySelectable;
}
interface PickQuerySelectableResult extends PickQuerySelectable, PickQueryResult {}
interface PickQuerySelectableRelations$1 extends PickQuerySelectable, PickQueryRelations$1 {}
interface PickQuerySelectableResultWindows extends PickQuerySelectable, PickQueryResult, PickQueryWindows {}
interface PickQuerySelectableResultRelationsWindows extends PickQuerySelectableResult, PickQueryRelations$1, PickQueryWindows {}
interface PickQueryMetaSelectableResultRelationsWindowsColumnTypes extends PickQuerySelectableResultRelationsWindows, PickQueryColumTypes {}
interface PickQuerySelectableShapeAs extends PickQuerySelectable, PickQueryShape$1, PickQueryAs {}
interface PickQueryTableMetaShapeTableAs extends PickQuerySelectableShapeAs, PickQueryTable {}
interface PickQuerySelectableShapeRelationsWithData extends PickQuerySelectable, PickQueryShape$1, PickQueryRelations$1, PickQueryWithData {}
interface PickQuerySelectableShapeRelationsWithDataAs extends PickQuerySelectableShapeRelationsWithData, PickQueryAs {}
interface PickQuerySelectableShapeRelationsWithDataAsResultReturnType extends PickQuerySelectableShapeRelationsWithDataAs, PickQueryResult, PickQueryReturnType {}
interface PickQuerySelectableRelationsResultReturnType extends PickQuerySelectableRelations$1, PickQueryResult, PickQueryReturnType {}
interface PickQuerySelectableResultRelationsWithDataReturnType extends PickQuerySelectable, PickQueryResult, PickQueryRelations$1, PickQueryWithData, PickQueryReturnType {}
interface PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs extends PickQuerySelectableResultRelationsWithDataReturnType, PickQueryShape$1, PickQueryAs {}
interface PickQuerySelectableShape extends PickQuerySelectable, PickQueryShape$1 {}
interface PickQuerySelectableColumnTypes extends PickQuerySelectable, PickQueryColumTypes {}
interface PickQuerySelectableShapeRelationsReturnTypeIsSubQuery extends PickQueryIsSubQuery, PickQuerySelectable, PickQueryShape$1, PickQueryRelations$1, PickQueryReturnType {}
interface PickQuerySelectableResultInputTypeAs extends PickQuerySelectableResult, PickQueryInputType$1, PickQueryAs {}
interface PickQuerySelectableResultAs extends PickQuerySelectable, PickQueryResult, PickQueryAs {}
interface PickQueryIsSubQuery {
  __subQuery?: boolean;
}
interface PickQueryResult {
  result: Column$1.QueryColumns;
}
interface PickQueryShape$1 {
  shape: Column$1.QueryColumns;
}
interface PickQueryReturnType {
  returnType: QueryReturnType$1;
}
interface PickQueryResultReturnType extends PickQueryResult, PickQueryReturnType {}
interface PickQueryResultUniqueColumns extends PickQueryResult {
  internal: {
    uniqueColumns: unknown;
  };
}
interface PickQueryResultReturnTypeUniqueColumns extends PickQueryResultUniqueColumns, PickQueryReturnType {}
interface PickQueryUniqueProperties {
  internal: {
    uniqueColumnNames: unknown;
    uniqueColumnTuples: unknown;
    uniqueConstraints: unknown;
  };
}
interface PickQueryInputType$1 {
  __inputType: RecordUnknown$1;
}
interface PickQueryWithData {
  withData: WithDataItems;
}
interface PickQueryWindows {
  windows: EmptyObject$1;
}
interface PickQueryRelations$1 {
  relations: RelationsBase$1;
}
interface PickQueryRelationsDataForCreate {
  relationsDataForCreate: RelationsDataForCreateBase;
}
interface PickQueryRelationsDataForCreateOptional {
  relationsDataForCreateOptional: RelationsDataForCreateOptionalBase;
}
interface PickQueryColumTypes {
  columnTypes: unknown;
}
interface PickQueryWithDataColumnTypes extends PickQueryWithData, PickQueryColumTypes {}
interface PickQueryResultColumnTypes extends PickQueryResult, PickQueryColumTypes {}
interface PickQueryAs {
  __as: string;
}
interface PickQueryResultAs extends PickQueryResult, PickQueryAs {}
interface PickQueryResultAsRelations extends PickQueryResultAs, PickQueryRelations$1 {}
interface PickQueryShapeAsRelations extends PickQueryShape$1, PickQueryAs, PickQueryRelations$1 {}
interface PickQueryRelationsWithData extends PickQueryWithData, PickQueryRelations$1 {}
interface PickQuerySinglePrimaryKey {
  internal: {
    singlePrimaryKey: unknown;
  };
}
interface PickQueryShapeSinglePrimaryKey extends PickQueryShape$1, PickQuerySinglePrimaryKey {}
interface PickQueryShapeResultSinglePrimaryKey extends PickQueryShapeSinglePrimaryKey, PickQueryResult {}
interface PickQueryShapeResultReturnTypeSinglePrimaryKey extends PickQueryShapeResultSinglePrimaryKey, PickQueryReturnType {}
interface PickQueryQ$1 {
  q: QueryData$1;
}
interface PickQueryInternal$1 {
  internal: QueryInternal$1;
}
interface PickQueryQAndInternal extends IsQuery$1, PickQueryQ$1, PickQueryInternal$1 {}
interface PickQueryDataAliases {
  aliases?: RecordString$1;
}
interface QueryDataAliases extends PickQueryDataAliases {
  as?: string;
  outerAliases?: RecordString$1;
}
type SetQueryTableAlias<T extends PickQuerySelectableShapeAs, As extends string> = { [K in keyof T]: K extends '__selectable' ? Omit<T['__selectable'], `${T['__as']}.${keyof T['shape'] & string}`> & { [K in keyof T['shape'] & string as `${As}.${K}`]: {
  as: K;
  column: T['shape'][K];
}; } : K extends '__as' ? As : T[K]; };
type AsQueryArg = PickQuerySelectableShapeAs;
declare abstract class QueryAsMethods {
  /**
   * Sets table alias:
   *
   * ```ts
   * db.table.as('u').select('u.name');
   *
   * // Can be used in the join:
   * db.table.join(db.profile.as('p'), 'p.userId', 'user.id');
   * ```
   *
   * @param as - alias for the table of this query
   */
  as<T extends AsQueryArg, As extends string>(this: T, as: As): SetQueryTableAlias<T, As>;
}
declare class QueryClone {
  /**
   * Clones the current query chain, useful for re-using partial query snippets in other queries without mutating the original.
   *
   * Used under the hood, and not really needed on the app side.
   */
  clone<T>(this: T): T;
}
interface CteArgsOptions {
  columns?: string[] | boolean;
  materialized?: true;
  notMaterialized?: true;
}
interface CteRecursiveOptions extends CteArgsOptions {
  union?: 'UNION' | 'UNION ALL' | 'INTERSECT' | 'INTERSECT ALL' | 'EXCEPT' | 'EXCEPT ALL';
}
interface CteQueryBuilder<T extends PickQueryWithDataColumnTypes> extends Query {
  sql: QuerySql<T['columnTypes']>['sql'];
  relations: EmptyObject$1;
  withData: T['withData'];
}
type CteResult<T extends PickQueryWithDataColumnTypes, Name extends string, Q extends PickQueryResult> = { [K in keyof T]: K extends 'withData' ? { [K in keyof T['withData'] | Name]: K extends Name ? {
  table: Name;
  shape: Q['result'];
} : K extends keyof T['withData'] ? T['withData'][K] : never; } : T[K]; };
type CteSqlResult<T extends PickQueryWithDataColumnTypes, Name extends string, Shape extends Column$1.QueryColumns> = { [K in keyof T]: K extends 'withData' ? { [K in Name | keyof T['withData']]: K extends Name ? {
  table: Name;
  shape: Shape;
} : K extends keyof T['withData'] ? T['withData'][K] : never; } : T[K]; };
declare class CteQuery {
  /**
   * Use `with` to add a Common Table Expression (CTE) to the query.
   *
   * `with` can be chained to any table on `db` instance, or to `db.$qb`,
   * note that in the latter case it won't have customized column types to use for typing SQL.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // can access custom columns when using off a table
   * db.anyTable.with('x', (q) =>
   *   q.select({ column: (q) => sql`123`.type((t) => t.customColumn()) }),
   * );
   *
   * // only default columns are available when using off `$qb`
   * db.$qb.with('x', (q) =>
   *   q.select({ column: (q) => sql`123`.type((t) => t.integer()) }),
   * );
   * ```
   *
   * `with` accepts query objects, callbacks returning query objects, and custom SQL expressions returned from callbacks.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * db.table
   *   .with(
   *     'alias',
   *     // define CTE by building a query
   *     db.table.select('one', 'two', 'three').where({ x: 123 }),
   *   )
   *   .from('alias')
   *   .select('one')
   *   .where({ two: 123 });
   *
   * // 2nd argument can be a callback accepting a query builder
   * db.table
   *   .with('alias', (q) =>
   *     // select a custom sql
   *     q.select({ column: (q) => sql`123`.type((t) => t.integer()) }),
   *   )
   *   .from('alias')
   *   .select('column')
   *   .where({ column: 123 });
   *
   * // 2nd argument can be used for options
   * db.table
   *   .with(
   *     'alias',
   *     {
   *       // all parameters are optional
   *       materialized: true,
   *       notMaterialized: true,
   *     },
   *     db.table,
   *   )
   *   .from('alias');
   * ```
   *
   * One `WITH` expression can reference the other:
   *
   * ```ts
   * db.$qb
   *   .with('a', db.table.select('id', 'name'))
   *   .with('b', (q) => q.from('a').where({ key: 'value' }))
   *   .from('b');
   * ```
   *
   * Defined `WITH` expression can be used in `.from` or `.join` with all the type safeness:
   *
   * ```ts
   * db.table.with('alias', db.table).from('alias').select('alias.id');
   *
   * db.firstTable
   *   .with('secondTable', db.secondTable)
   *   .join('secondTable', 'secondTable.someId', 'firstTable.id')
   *   .select('firstTable.column', 'secondTable.column');
   * ```
   *
   * ## creating records using `with` values
   *
   * You can use values returned from `with` statements when creating records:
   *
   * ```ts
   * db.table
   *   .with('created', () => db.someTable.create(data).select('one', 'two'))
   *   .create({
   *     column: (q) => q.from('created').get('one'),
   *     otherColumn: (q) => q.from('created').get('two'),
   *   });
   *
   * // A record in `with` is created once, its values are used to create two records
   * db.table
   *   .with('created', () => db.someTable.create(data).select('one', 'two'))
   *   .createMany([
   *     {
   *       column: (q) => q.from('created').get('one'),
   *       otherColumn: (q) => q.from('created').get('two'),
   *     },
   *     {
   *       column: (q) => q.from('created').get('one'),
   *       otherColumn: (q) => q.from('created').get('two'),
   *     },
   *   ]);
   * ```
   */
  with<T extends PickQueryWithDataColumnTypes, Name extends string, Q>(this: T, name: Name, query: Q | ((q: CteQueryBuilder<T>) => Q)): CteResult<T, Name, Q extends PickQueryResult ? Q : never>;
  with<T extends PickQueryWithDataColumnTypes, Name extends string, Q extends PickQueryResult>(this: T, name: Name, options: CteArgsOptions, query: Q | ((q: CteQueryBuilder<T>) => Q)): CteResult<T, Name, Q>;
  /**
   * It is priceless for fetching tree-like structures, or any other recursive cases.
   *
   * For example, it is useful for loading a tree of categories, where one category can include many other categories.
   *
   * Similarly to [with](#with), `withRecursive` can be chained to any table or `db.$qb`.
   *
   * For the first example, consider the employee table, an employee may or may not have a manager.
   *
   * ```ts
   * export const Employee = defineTable('employee', (t) => ({
   *   id: t.identity().primaryKey(),
   *   name: t.string(),
   *   managerId: t.integer().nullable(),
   * }));
   * ```
   *
   * The task is to load all subordinates of the manager with the id 1.
   *
   * ```ts
   * db.$qb
   *   .withRecursive(
   *     'subordinates',
   *     // the base, anchor query: find the manager to begin recursion with
   *     db.employee.select('id', 'name', 'managerId').find(1),
   *     // recursive query:
   *     // find employees whos managerId is id from the surrounding subordinates CTE
   *     (q) =>
   *       q
   *         .from(db.employee)
   *         .select('id', 'name', 'managerId')
   *         .join('subordinates', 'subordinates.id', 'profile.managerId'),
   *   )
   *   .from('subordinates');
   * ```
   *
   * As being shown, `withRecursive` accepts one query to begin with, and a second query in a callback that can reference the surrounding table expression "subordinates".
   *
   * These two queries are joined with `UNION ALL` by default.
   *
   * You can customize it by passing options after the name.
   *
   * ```ts
   * db.$qb
   *   .withRecursive(
   *     'subordinates',
   *     {
   *       // all parameters are optional
   *       union: 'UNION',
   *       materialized: true,
   *       notMaterialized: true,
   *     },
   *     // ...snip
   *   )
   *   .from('subordinates');
   * ```
   *
   * Recursive query can be constructed with basic SQL instructions only, without referencing other tables.
   * In the following example, we recursively select numbers from 1 to 100, and additionally apply n > 10 filter in the end.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * db.$qb
   *   .withRecursive(
   *     't',
   *     // select `1 AS n` for the base query
   *     (q) => q.select({ n: (q) => sql`1`.type((t) => t.integer()) }),
   *     // select `n + 1 AS n` for the recursive part
   *     (q) =>
   *       q
   *         .from('t')
   *         // type can be omitted here because it was defined in the base query
   *         .select({ n: (q) => sql`n + 1` })
   *         .where({ n: { lt: 100 } }),
   *   )
   *   .from('t')
   *   .where({ n: { gt: 10 } });
   * ```
   */
  withRecursive<T extends PickQueryWithDataColumnTypes, Name extends string, Q extends PickQueryResult, Result = CteResult<T, Name, Q>>(this: T, name: Name, base: Q | ((qb: CteQueryBuilder<T>) => Q), recursive: (qb: { [K in keyof Result]: K extends 'result' ? Q['result'] : Result[K]; }) => PickQueryResult): Result;
  withRecursive<T extends PickQueryWithDataColumnTypes, Name extends string, Q extends PickQueryResult, Result = CteResult<T, Name, Q>>(this: T, name: Name, options: CteRecursiveOptions, base: Q | ((qb: CteQueryBuilder<T>) => Q), recursive: (qb: { [K in keyof Result]: K extends 'result' ? Q['result'] : Result[K]; }) => PickQueryResult): Result;
  /**
   * Use `withSql` to add a Common Table Expression (CTE) based on a custom SQL.
   *
   * Similarly to [with](#with), `withRecursive` can be chained to any table or `db.$qb`.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * db.table
   *   .withSql(
   *     'alias',
   *     // define column types of the expression:
   *     (t) => ({
   *       one: t.integer(),
   *       two: t.string(),
   *     }),
   *     // define SQL expression:
   *     (q) => sql`VALUES (1, 'two')`,
   *   )
   *   // is not prefixed in the middle of a query chain
   *   .withSql(
   *     'second',
   *     (t) => ({
   *       x: t.integer(),
   *     }),
   *     (q) => sql`VALUES (1)`,
   *   )
   *   .from('alias');
   * ```
   *
   * Options can be passed via a second argument:
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * db.table
   *   .withSql(
   *     'alias',
   *     {
   *       // all parameters are optional
   *       recursive: true,
   *       materialized: true,
   *       notMaterialized: true,
   *     },
   *     (t) => ({
   *       one: t.integer(),
   *       two: t.string(),
   *     }),
   *     (q) => sql`VALUES (1, 'two')`,
   *   )
   *   .from('alias');
   * ```
   */
  withSql<T extends PickQueryWithDataColumnTypes, Name extends string, Shape extends Column$1.Shape.QueryInit>(this: T, name: Name, options: CteOptions, shape: (t: T['columnTypes']) => Shape, expr: (q: T) => Expression$1): CteSqlResult<T, Name, Shape>;
  withSql<T extends PickQueryWithDataColumnTypes, Name extends string, Shape extends Column$1.Shape.QueryInit>(this: T, name: Name, shape: (t: T['columnTypes']) => Shape, expr: (q: T) => Expression$1): CteSqlResult<T, Name, Shape>;
}
interface FromQuerySelf extends PickQuerySelectable, PickQueryShape$1, PickQueryReturnType, PickQueryWithData, PickQueryAs, PickQueryHasSelect {}
type FromArg$1<T extends FromQuerySelf> = IsQuery$1 | Exclude<keyof T['withData'], symbol | number>;
type FromResult$1<T extends FromQuerySelf, Arg extends MaybeArray$1<FromArg$1<T>>> = Arg extends string ? T['withData'] extends WithDataItems ? { [K in keyof T]: K extends '__selectable' ? SelectableFromShape$1<T['withData'][Arg]['shape'], Arg> : K extends 'result' ? T['withData'][Arg]['shape'] : K extends 'then' ? QueryThenByQuery<T, T['withData'][Arg]['shape']> : T[K]; } : SetQueryTableAlias<T, Arg> : Arg extends PickQuerySelectableResultInputTypeAs ? { [K in keyof T]: K extends '__defaultSelect' ? keyof Arg['result'] : K extends '__selectable' ? SelectableFromShape$1<Arg['result'], Arg['__as']> : K extends '__as' ? Arg['__as'] : K extends 'result' ? Arg['result'] : K extends 'shape' ? Arg['result'] : K extends '__inputType' ? Arg['__inputType'] : K extends 'then' ? QueryThenByQuery<T, Arg['result']> : T[K]; } : Arg extends (infer A)[] ? { [K in keyof T]: K extends '__selectable' ? UnionToIntersection<A extends string ? T['withData'] extends WithDataItems ? { [K in keyof T['withData'][A]['shape'] & string as `${A}.${K}`]: {
  as: K;
  column: T['withData'][A]['shape'][K];
}; } : never : A extends PickQueryResultAs ? { [K in keyof A['result'] & string as `${A['__as']}.${K}`]: K extends string ? {
  as: K;
  column: A['result'][K];
} : never; } : never> : T[K]; } : T;
declare class FromMethods {
  /**
   * Set the `FROM` value, by default the table name is used.
   *
   * `from` determines a set of available tables and columns withing the query,
   * and thus it must not follow `select`, use `select` only after `from`.
   *
   * ```ts
   * // accepts sub-query:
   * db.table.from(db.otherTable.select('foo', 'bar'));
   *
   * // accepts alias of `WITH` expression:
   * q.with('withTable', db.table.select('id', 'name'))
   *   .from('withTable')
   *   // `select` is after `from`
   *   .select('id', 'name');
   * ```
   *
   * `from` can accept multiple sources:
   *
   * ```ts
   * db.table
   *   // add a `WITH` statement called `withTable
   *   .with('withTable', db.table.select('one'))
   *   // select from `withTable` and from `otherTable`
   *   .from('withTable', db.otherTable.select('two'))
   *   // source names and column names are properly typed when selecting
   *   .select('withTable.one', 'otherTable.two');
   * ```
   *
   * @param arg - query or name of CTE table
   */
  from<T extends FromQuerySelf, Arg extends MaybeArray$1<FromArg$1<T>>>(this: T, arg: T['__hasSelect'] extends true ? '`select` must be placed after `from`' : Arg): FromResult$1<T, Arg>;
  /**
   * Set the `FROM` value with custom SQL:
   *
   * ```ts
   * const value = 123;
   * db.table.fromSql`value = ${value}`;
   * ```
   *
   * @param args - SQL expression
   */
  fromSql<T extends FromQuerySelf>(this: T, ...args: SQLQueryArgs): T;
  /**
   * Adds `ONLY` SQL keyword to the `FROM`.
   * When selecting from a parent table that has a table inheritance,
   * setting `only` will make it to select rows only from the parent table.
   *
   * ```ts
   * db.table.only();
   *
   * // disabling `only` after being enabled
   * db.table.only().only(false);
   * ```
   *
   * @param only - can be disabled by passing `false` if was enabled previously.
   */
  only<T>(this: T, only?: boolean): T;
}
interface QueryGetSelf extends PickQuerySelectable, PickQueryRelationsWithData {}
type GetArg<T extends QueryGetSelf> = GetStringArg<T> | Expression$1 | ((q: SelectAsFnArg<T>) => Expression$1 | Query.Pick.SingleValueResult);
type GetStringArg<T extends PickQuerySelectable> = keyof T['__selectable'] & string;
type ResolveGetArgColumn<Arg> = Arg extends Expression$1 ? Arg['result']['value'] : Arg extends ((q: never) => infer R) ? R extends Expression$1 ? R['result']['value'] : R extends Query.Pick.SingleValueResult ? R['result']['value'] : never : never;
type GetResult<T extends QueryGetSelf, Arg extends GetArg<T>> = Arg extends string ? SetQueryReturnsValueOrThrow<T, Arg> : SetQueryReturnsColumnOrThrow<T, ResolveGetArgColumn<Arg>>;
type OptionalValueColumn<C> = { [K in keyof C]: K extends '__outputType' ? C[K] | undefined : C[K]; };
type GetResultOptional<T extends QueryGetSelf, Arg extends GetArg<T>> = Arg extends string ? SetQueryReturnsValueOptional<T, Arg> : SetQueryReturnsColumnOptional<T, OptionalValueColumn<ResolveGetArgColumn<Arg>>>;
declare class QueryGet {
  /**
   * `.get` returns a single value, adds `LIMIT 1` to the query, and accepts a column name or a raw SQL expression.
   *
   * `get` throws a `NotFoundError` when not found, and `getOptional` returns `undefined`.
   *
   * ```ts
   * import { NumberColumn } from 'orchid-orm';
   * import { sql } from './baseTable';
   *
   * const firstName: string = await db.table.get('name');
   *
   * const rawResult: number = await db.table.get(sql((t) => t.integer())`1 + 1`);
   *
   * const firstNameOptional: string | undefined = await db.table.getOptional(
   *   'name',
   * );
   * ```
   *
   * @param arg - string for a column to get, or a raw SQL
   */
  get<T extends QueryGetSelf, Arg extends GetArg<T>>(this: T, arg: Arg): GetResult<T, Arg>;
  /**
   * `.getOptional` returns a single value or undefined when not found:
   *
   * ```ts
   * const firstName: string | undefined = await db.table.getOptional('name');
   * ```
   *
   * @param arg - string for a column to get, or a raw SQL
   */
  getOptional<T extends QueryGetSelf, Arg extends GetArg<T>>(this: T, arg: Arg): GetResultOptional<T, Arg>;
}
type HavingItem = TemplateLiteralArgs$1 | Expression$1[];
interface QueryReturningOne extends IsQuery$1 {
  result: Column$1.QueryColumns;
  returnType: 'one' | 'oneOrThrow';
}
type CreateRawOrFromResult<T extends CreateSelf$1> = T extends {
  isCount: true;
} ? T : T['returnType'] extends undefined | 'all' ? SetQueryReturnsOne<T> : T['returnType'] extends 'pluck' ? SetQueryReturnsColumn<T> : T;
type InsertRawOrFromResult<T extends CreateSelf$1> = T['__hasSelect'] extends true ? T['returnType'] extends undefined | 'all' ? SetQueryReturnsOne<T> : T['returnType'] extends 'pluck' ? SetQueryReturnsColumn<T> : T : SetQueryReturnsRowCount<T>;
type CreateManyFromResult<T extends CreateSelf$1> = T extends {
  isCount: true;
} ? T : T['returnType'] extends 'one' | 'oneOrThrow' ? SetQueryReturnsAll<T> : T['returnType'] extends 'value' | 'valueOrThrow' ? SetValueQueryReturnsPluckColumn<T> : T;
type InsertManyFromResult<T extends CreateSelf$1> = T['__hasSelect'] extends true ? T['returnType'] extends 'one' | 'oneOrThrow' ? SetQueryReturnsAll<T> : T['returnType'] extends 'value' | 'valueOrThrow' ? SetValueQueryReturnsPluckColumn<T> : T : SetQueryReturnsRowCountMany<T>;
declare const _queryInsertManyFrom: <T extends CreateSelf$1, Q extends QueryReturningOne>(q: T, query: Q, data: Omit<CreateData$1<T>, keyof Q['result']>[]) => InsertManyFromResult<T>;
declare class QueryCreateFrom {
  /**
   * Inserts a single record based on a query that selects a single record.
   *
   * Performs a single SQL query based on `INSERT ... SELECT ... FROM`.
   *
   * See {@link createManyFrom} to insert multiple records based on a single record query,
   * and {@link createForEachFrom} to insert a record per every one found by the query.
   *
   * The first argument is a query of a **single** record, it should have `find`, `take`, or similar.
   *
   * The second optional argument is a data which will be merged with columns returned by the query.
   *
   * The data for the second argument is the same as in {@link create}.
   *
   * Columns with runtime defaults (defined with a callback) are supported here.
   * The value for such a column will be injected unless selected from a related table or provided in a data object.
   *
   * ```ts
   * const oneRecord = await db.table.createOneFrom(
   *   db.relatedTable
   *     // use select to map columns from one table to another
   *     .select({
   *       // relatedTable's id will be inserted as "relatedId"
   *       relatedId: 'id',
   *     })
   *     .findBy({ key: 'value' }),
   *   // optional argument:
   *   {
   *     key: 'value',
   *     // supports sql, nested select, create, update, delete queries
   *     fromSql: () => sql`custom sql`,
   *     fromQuery: () => db.otherTable.find(id).update(data).get('column'),
   *     fromRelated: (q) => q.relatedTable.create(data).get('column'),
   *   },
   * );
   * ```
   *
   * The query above will produce such a SQL (omitting `from*` values):
   *
   * ```sql
   * INSERT INTO "table"("relatedId", "key")
   * SELECT "relatedTable"."id" AS "relatedId", 'value'
   * FROM "relatedTable"
   * WHERE "relatedTable"."key" = 'value'
   * LIMIT 1
   * RETURNING *
   * ```
   *
   * @param query - query to create new records from
   * @param data - additionally you can set some columns
   */
  createOneFrom<T extends CreateSelf$1, Q extends QueryReturningOne>(this: T, query: Q, data?: CreateDataOmit<T, Q['result'] extends never ? never : keyof Q['result']>): CreateRawOrFromResult<T>;
  /**
   * Works exactly as {@link createOneFrom}, except that it returns inserted row count by default.
   *
   * @param query - query to create new records from
   * @param data - additionally you can set some columns
   */
  insertOneFrom<T extends CreateSelf$1, Q extends QueryReturningOne>(this: T, query: Q, data?: CreateDataOmit<T, Q['result'] extends never ? never : keyof Q['result']>): InsertRawOrFromResult<T>;
  /**
   * Inserts multiple records based on a query that selects a single record.
   *
   * Performs a single SQL query based on `INSERT ... SELECT ... FROM`.
   *
   * See {@link createOneFrom} to insert a single record based on a single record query,
   * and {@link createForEachFrom} to insert a record per every one found by the query.
   *
   * The first argument is a query of a **single** record, it should have `find`, `take`, or similar.
   *
   * The second argument is array of objects to be merged with columns returned by the query.
   *
   * The data for the second argument is the same as in {@link createMany}.
   *
   * Columns with runtime defaults (defined with a callback) are supported here.
   * The value for such a column will be injected unless selected from a related table or provided in a data object.
   *
   * ```ts
   * const twoRecords = await db.table.createManyFrom(
   *   db.relatedTable
   *     // use select to map columns from one table to another
   *     .select({
   *       // relatedTable's id will be inserted as "relatedId"
   *       relatedId: 'id',
   *     })
   *     .findBy({ key: 'value' }),
   *   [
   *     {
   *       key: 'value 1',
   *       // supports sql, nested select, create, update, delete queries
   *       fromSql: () => sql`custom sql`,
   *       fromQuery: () => db.otherTable.find(id).update(data).get('column'),
   *       fromRelated: (q) => q.relatedTable.create(data).get('column'),
   *     },
   *     {
   *       key: 'value 2',
   *     },
   *   ],
   * );
   * ```
   *
   * The query above will produce such a SQL (omitting `from*` values):
   *
   * ```sql
   * WITH "relatedTable" AS (
   *   SELECT "relatedTable"."id" AS "relatedId", 'value'
   *   FROM "relatedTable"
   *   WHERE "relatedTable"."key" = 'value'
   *   LIMIT 1
   * )
   * INSERT INTO "table"("relatedId", "key")
   * SELECT "relatedTable".*, v."key"::text
   * FROM "relatedTable", (VALUES ('value1'), ('value2')) v("key")
   * RETURNING *
   * ```
   *
   * @param query - query to create new records from
   * @param data - array of records to create
   */
  createManyFrom<T extends CreateSelf$1, Q extends QueryReturningOne>(this: T, query: Q, data: CreateDataOmit<T, Q['result'] extends never ? never : keyof Q['result']>[]): CreateManyFromResult<T>;
  /**
   * Works exactly as {@link createManyFrom}, except that it returns inserted row count by default.
   *
   * @param query - query to create new records from
   * @param data - array of records to create
   */
  insertManyFrom<T extends CreateSelf$1, Q extends QueryReturningOne>(this: T, query: Q, data: CreateDataOmit<T, Q['result'] extends never ? never : keyof Q['result']>[]): InsertManyFromResult<T>;
  /**
   * Inserts a single record per every record found in a given query.
   *
   * Performs a single SQL query based on `INSERT ... SELECT ... FROM`.
   *
   * Unlike {@link createOneFrom}, it doesn't accept second argument with data.
   *
   * Runtime defaults cannot work with it.
   *
   * ```ts
   * const manyRecords = await db.table.createForEachFrom(
   *   db.relatedTable.select({ relatedId: 'id' }).where({ key: 'value' }),
   * );
   * ```
   *
   * @param query - query to create new records from
   */
  createForEachFrom<T extends CreateSelf$1>(this: T, query: IsQuery$1): CreateManyFromResult<T>;
  /**
   * Works exactly as {@link createForEachFrom}, except that it returns inserted row count by default.
   *
   * @param query - query to create new records from
   */
  insertForEachFrom<T extends CreateSelf$1>(this: T, query: IsQuery$1): InsertManyFromResult<T>;
}
interface CreateSelf$1 extends PickQueryHasSelect, PickQueryDefaults, PickQueryResult, PickQueryRelations$1, PickQueryRelationsDataForCreate, PickQueryRelationsDataForCreateOptional, PickQueryWithData, PickQueryReturnType, PickQueryShape$1, PickQueryUniqueProperties, PickQueryInputType$1, Query.Pick.IsNotReadOnly {}
type CreateData$1<T extends CreateSelf$1> = EmptyObject$1 extends T['relations'] ? CreateDataWithDefaults<T, keyof T['__defaults']> : CreateRelationsData<T>;
type CreateDataOmit<T extends CreateSelf$1, OmitKeys> = EmptyObject$1 extends T['relations'] ? CreateDataWithDefaultsOmit<T, keyof T['__defaults'], OmitKeys> : CreateRelationsDataOmit<T, OmitKeys>;
type CreateDataWithDefaults<T extends CreateSelf$1, Defaults extends PropertyKey> = { [K in keyof T['__inputType'] as K extends Defaults ? never : K]: K extends Defaults ? never : CreateColumn<T, K>; } & { [K in Defaults]?: K extends keyof T['__inputType'] ? CreateColumn<T, K> : never; };
type CreateDataWithDefaultsOmit<T extends CreateSelf$1, Defaults extends PropertyKey, OmitKeys> = { [K in keyof T['__inputType'] as K extends Defaults | OmitKeys ? never : K]: K extends Defaults ? never : CreateColumn<T, K>; } & { [K in Defaults as K extends OmitKeys ? never : K]?: K extends keyof T['__inputType'] ? CreateColumn<T, K> : never; };
type WritableForeignKeys<T extends CreateSelf$1, AllFKeys extends PropertyKey> = AllFKeys extends (infer K) ? K extends keyof T['shape'] ? T['shape'][K] extends {
  data: {
    makeColumnWritable: true;
  };
} ? K : never : never : never;
type CreateColumn<T extends CreateSelf$1, K extends keyof T['__inputType']> = T['__inputType'][K] | ((q: T) => QueryOrExpression$1<T['__inputType'][K]>);
type CreateRelationsData<T extends CreateSelf$1> = CreateDataWithDefaultsOmit<T, keyof T['__defaults'], Exclude<T['relations'][keyof T['relations']]['omitForeignKeyInCreate'], WritableForeignKeys<T, T['relations'][keyof T['relations']]['omitForeignKeyInCreate']>>> & CreateRelationsDataOmittingFKeys<T, T['relationsDataForCreate']> & CreateRelationsDataValidation<T> & T['relationsDataForCreateOptional'];
type CreateRelationsDataOmit<T extends CreateSelf$1, OmitKeys> = CreateDataWithDefaultsOmit<T, keyof T['__defaults'], Exclude<T['relations'][keyof T['relations']]['omitForeignKeyInCreate'], WritableForeignKeys<T, T['relations'][keyof T['relations']]['omitForeignKeyInCreate']>> | OmitKeys> & CreateRelationsDataOmittingFKeys<T, T['relationsDataForCreate']> & CreateRelationsDataValidation<T> & T['relationsDataForCreateOptional'];
type CreateRelationsDataOmittingFKeys<T extends CreateSelf$1, Data> = EmptyObject$1 extends Data ? EmptyObject$1 : { [K in keyof Data]: CreateRelationDataOmittingFKeys<T, Data[K]>; }[keyof Data] extends ((u: infer Obj) => void) ? Obj : never;
type CreateRelationDataOmittingFKeys<T extends CreateSelf$1, Union> = (u: Union extends RelationConfigDataForCreate ? Union['columns'] extends keyof T['__defaults'] ? Pick<CreateDataWithDefaults<T, keyof T['__defaults']>, Union['columns']> & Partial<Union['nested']> : (Pick<{ [P in keyof T['__inputType']]: CreateColumn<T, P>; }, Union['columns'] & keyof T['__inputType']> & { [K in keyof Union['nested']]?: never; }) | Union['nested'] : Union) => void;
type RelationNestedNames<Data> = Data extends RelationConfigDataForCreate ? keyof Data['nested'] : never;
type RelationNestedData<Data, Name> = Data extends RelationConfigDataForCreate ? Name extends keyof Data['nested'] ? Data['nested'][Name] : never : never;
type CreateRelationsDataValidation<T extends CreateSelf$1, Data = T['relationsDataForCreate'][keyof T['relationsDataForCreate']]> = { [K in RelationNestedNames<Data>]?: RelationNestedData<Data, K>; };
type CreateResult<T extends CreateSelf$1, Data> = T extends {
  isCount: true;
} ? T : T['returnType'] extends undefined | 'all' ? SetQueryReturnsOneResult<T, NarrowCreateResult<T, Data>> : T['returnType'] extends 'pluck' ? SetQueryReturnsColumnResult<T, NarrowCreateResult<T, Data>> : SetQueryResult<T, NarrowCreateResult<T, Data>>;
type InsertResult<T extends CreateSelf$1, Data> = T['__hasSelect'] extends true ? T['returnType'] extends undefined | 'all' ? SetQueryReturnsOneResult<T, NarrowCreateResult<T, Data>> : T['returnType'] extends 'pluck' ? SetQueryReturnsColumnResult<T, NarrowCreateResult<T, Data>> : SetQueryResult<T, NarrowCreateResult<T, Data>> : SetQueryReturnsRowCount<T>;
type CreateManyResult<T extends CreateSelf$1> = T extends {
  isCount: true;
} ? T : T['returnType'] extends 'one' | 'oneOrThrow' ? SetQueryReturnsAll<T> : T['returnType'] extends 'value' | 'valueOrThrow' ? SetValueQueryReturnsPluckColumn<T> : T;
type InsertManyResult<T extends CreateSelf$1> = T['__hasSelect'] extends true ? T['returnType'] extends 'one' | 'oneOrThrow' ? SetQueryReturnsAll<T> : T['returnType'] extends 'value' | 'valueOrThrow' ? SetValueQueryReturnsPluckColumn<T> : T : SetQueryReturnsRowCountMany<T>;
/**
 * When creating a record with a *belongs to* nested record,
 * un-nullify foreign key columns of the result.
 *
 * The same should work as well with any non-null columns passed to `create`, but it's to be implemented later.
 */
type NarrowCreateResult<T extends CreateSelf$1, Data> = EmptyObject$1 extends T['relations'] ? T['result'] : { [K in keyof T['result']]: true extends { [R in keyof T['relations']]: K extends T['relations'][R]['omitForeignKeyInCreate'] ? R extends keyof Data ? true : T['relations'][R]['omitForeignKeyInCreate'] extends keyof Data ? null | undefined extends Data[T['relations'][R]['omitForeignKeyInCreate']] ? never : true : never : never; }[keyof T['relations']] ? Column$1.Pick.QueryColumnOfTypeAndOps<string, Exclude<T['result'][K]['__outputType'], null>, T['result'][K]['operators']> : T['result'][K]; };
type IgnoreResult<T extends CreateSelf$1> = T['returnType'] extends 'oneOrThrow' ? QueryTakeOptional<T> : T['returnType'] extends 'valueOrThrow' ? SetQueryReturnsColumnOptional<T, T['result']['value']> : T;
type OnConflictArg<T extends PickQueryUniqueProperties> = T['internal']['uniqueColumnNames'] | T['internal']['uniqueColumnTuples'] | Expression$1 | {
  constraint: T['internal']['uniqueConstraints'];
};
type AddQueryDefaults<T extends CreateSelf$1, DefaultKeys extends PropertyKey> = { [K in keyof T]: K extends '__defaults' ? { [K in keyof T['__defaults'] | DefaultKeys]: true; } : T[K]; };
type ExtraPropertiesAreNotAllowed<T extends CreateSelf$1, Data> = keyof Data extends keyof T['__inputType'] | keyof T['relations'] ? Data : `Extra properties are not allowed: ${Exclude<keyof Data, keyof T['__inputType'] | keyof T['relations']> & string}`;
declare class QueryCreate {
  /**
   * `create` and `insert` create a single record.
   *
   * Use `select`, `selectAll`, `get`, or `pluck` alongside `create` or `insert` to
   * specify returning columns.
   *
   * Each column may accept a specific value, a raw SQL, or a query that returns a single value.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * const oneRecord = await db.table.create({
   *   name: 'John',
   *   password: '1234',
   * });
   *
   * // When using `.onConflictDoNothing()`,
   * // the record may be not created and the `createdCount` will be 0.
   * const createdCount = await db.table.insert(data).onConflictDoNothing();
   *
   * await db.table.create({
   *   // raw SQL
   *   column1: () => sql`'John' || ' ' || 'Doe'`,
   *
   *   // query that returns a single value
   *   // returning multiple values will result in Postgres error
   *   column2: () => db.otherTable.get('someColumn'),
   *
   *   // nesting creates, updates, deletes produces a single SQL
   *   column4: () => db.otherTable.create(data).get('someColumn'),
   *   column5: (q) => q.relatedTable.find(id).update(data).get('someColumn'),
   * });
   * ```
   *
   * Creational methods can be used in {@link WithMethods.with} expressions:
   *
   * ```ts
   * db.$qb
   *   // create a record in one table
   *   .with('a', db.table.select('id').create(data))
   *   // create a record in other table using the first table record id
   *   .with('b', (q) =>
   *     db.otherTable.select('id').create({
   *       ...otherData,
   *       aId: () => q.from('a').get('id'),
   *     }),
   *   )
   *   .from('b');
   * ```
   */
  create<T extends CreateSelf$1, Data extends CreateData$1<T>>(this: T, data: ExtraPropertiesAreNotAllowed<T, Data>): CreateResult<T, Data>;
  /**
   * Works exactly as {@link create}, except that it returns inserted row count by default.
   */
  insert<T extends CreateSelf$1, Data extends CreateData$1<T>>(this: T, data: ExtraPropertiesAreNotAllowed<T, Data>): InsertResult<T, Data>;
  /**
   * `createMany` and `insertMany` will create a batch of records.
   *
   * Each column may be set with a specific value, a raw SQL, or a query, the same as in {@link create}.
   *
   * In case one of the objects has fewer fields, the `DEFAULT` SQL keyword will be placed in its place in the `VALUES` statement.
   *
   * ```ts
   * const manyRecords = await db.table.createMany([
   *   { key: 'value', otherKey: 'other value' },
   *   { key: 'value' }, // default will be used for `otherKey`
   * ]);
   *
   * // `createdCount` will be 3.
   * const createdCount = await db.table.insertMany([data, data, data]);
   * ```
   *
   * When nesting creates, a separate create query will be executed for every time it's used:
   *
   * ```ts
   * // will be performed twice, even though it is defined once
   * const nestedCreate = db.otherTable.create(data).get('column');
   *
   * await db.table.createMany([{ column: nestedCreate }, { column: nestedCreate }]);
   * ```
   *
   * Because of a limitation of Postgres protocol, queries having more than **65535** of values are going to fail in runtime.
   * To solve this seamlessly, `OrchidORM` will automatically batch such queries, and wrap them into a transaction, unless they are already in a transaction.
   *
   * ```ts
   * // OK: executes 2 inserts wrapped into a transaction
   * await db.table.createMany(
   *   Array.from({ length: 65536 }, () => ({ text: 'text' })),
   * );
   * ```
   *
   * However, this only works in the case shown above. This **won't** work if you're using the `createMany` in `with` statement,
   * or if the insert is used as a sub-query in other query part.
   *
   * @param data - array of records data, may have values, raw SQL, queries, relation operations
   */
  createMany<T extends CreateSelf$1>(this: T, data: CreateData$1<T>[]): CreateManyResult<T>;
  /**
   * Works exactly as {@link createMany}, except that it returns inserted row count by default.
   *
   * @param data - array of records data, may have values, raw SQL, queries, relation operations
   */
  insertMany<T extends CreateSelf$1>(this: T, data: CreateData$1<T>[]): InsertManyResult<T>;
  /**
   * `defaults` allows setting values that will be used later in `create`.
   *
   * Columns provided in `defaults` are marked as optional in the following `create`.
   *
   * Default data is the same as in {@link create} and {@link createMany},
   * so you can provide a raw SQL, or a query with a query.
   *
   * ```ts
   * // Will use firstName from defaults and lastName from create argument:
   * db.table
   *   .defaults({
   *     firstName: 'first name',
   *     lastName: 'last name',
   *   })
   *   .create({
   *     lastName: 'override the last name',
   *   });
   * ```
   *
   * @param data - default values for `create` and `createMany` which will follow `defaults`
   */
  defaults<T extends CreateSelf$1, Data extends Partial<CreateData$1<T>>>(this: T, data: Data): AddQueryDefaults<T, keyof Data>;
  /**
   * By default, violating unique constraint will cause the creative query to throw,
   * you can define what to do on a conflict: to ignore it, or to merge the existing record with a new data.
   *
   * A conflict occurs when a table has a primary key or a unique index on a column,
   * or a composite primary key unique index on a set of columns,
   * and a row being created has the same value as a row that already exists in the table in this column(s).
   *
   * Use {@link onConflictDoNothing} to suppress the error and continue without updating the record,
   * or the `merge` to update the record with new values automatically,
   * or the `set` to specify own values for the update.
   *
   * `onConflict` only accepts column names that are defined in `primaryKey` or `unique` in the table definition.
   * To specify a constraint, its name also must be explicitly set in `primaryKey` or `unique` in the table code.
   *
   * Postgres has a limitation that a single `INSERT` query can have only a single `ON CONFLICT` clause that can target only a single unique constraint
   * for updating the record.
   *
   * If your table has multiple potential reasons for unique constraint violation, such as username and email columns in a user table,
   * consider using `upsert` instead.
   *
   * ```ts
   * // leave `onConflict` without argument to ignore or merge on any conflict
   * db.table.create(data).onConflictDoNothing();
   *
   * // single column:
   * // (this requires a composite primary key or unique index, see below)
   * db.table.create(data).onConflict('email').merge();
   *
   * // array of columns:
   * db.table.create(data).onConflict(['email', 'name']).merge();
   *
   * // constraint name
   * db.table.create(data).onConflict({ constraint: 'unique_index_name' }).merge();
   *
   * // raw SQL expression:
   * db.table
   *   .create(data)
   *   .onConflict(sql`(email) where condition`)
   *   .merge();
   * ```
   *
   * :::info
   * A primary key or a unique index for a **single** column can be fined on a column:
   *
   * ```ts
   * export const MyTable = defineTable('myTable', (t) => ({
   *   pkey: t.uuid().primaryKey(),
   *   unique: t.string().unique(),
   * }));
   * ```
   *
   * But for composite primary keys or indexes (having multiple columns), define it in a separate function:
   *
   * ```ts
   * export const MyTable = defineTable('myTable', (t) => ({
   *   one: t.integer(),
   *   two: t.string(),
   *   three: t.boolean(),
   * }))
   *   .primaryKey(['one', 'two'])
   *   .unique(['two', 'three']);
   * ```
   * :::
   *
   * You can use the `sql` function exported from your table factory file in onConflict.
   * It can be useful to specify a condition when you have a partial index:
   *
   * ```ts
   * db.table
   *   .create({
   *     email: 'ignore@example.com',
   *     name: 'John Doe',
   *     active: true,
   *   })
   *   // ignore only when having conflicting email and when active is true.
   *   .onConflict(sql`(email) where active`)
   *   .ignore();
   * ```
   *
   * For `merge` and `set`, you can append `where` to update data only for the matching rows:
   *
   * ```ts
   * const timestamp = Date.now();
   *
   * db.table
   *   .create(data)
   *   .onConflict('email')
   *   .set({
   *     name: 'John Doe',
   *     updatedAt: timestamp,
   *   })
   *   .where({ updatedAt: { lt: timestamp } });
   * ```
   *
   * @param arg - optionally provide an array of columns
   */
  onConflict<T extends CreateSelf$1, Arg extends OnConflictArg<T>>(this: T, arg: Arg): OnConflictQueryBuilder<T, Arg>;
  /**
   * Use `onConflictDoNothing` to suppress unique constraint violation error when creating a record.
   *
   * Adds `ON CONFLICT (columns) DO NOTHING` clause to the insert statement, columns are optional.
   *
   * Can also accept a constraint name.
   *
   * ```ts
   * db.table
   *   .create({
   *     email: 'ignore@example.com',
   *     name: 'John Doe',
   *   })
   *   // on any conflict:
   *   .onConflictDoNothing()
   *   // or, for a specific column:
   *   .onConflictDoNothing('email')
   *   // or, for a specific constraint:
   *   .onConflictDoNothing({ constraint: 'unique_index_name' });
   * ```
   *
   * When there is a conflict, nothing can be returned from the database, so `onConflictDoNothing` adds `| undefined` part to the response type.
   *
   * ```ts
   * const maybeRecord: RecordType | undefined = await db.table
   *   .create(data)
   *   .onConflictDoNothing();
   *
   * const maybeId: number | undefined = await db.table
   *   .get('id')
   *   .create(data)
   *   .onConflictDoNothing();
   * ```
   *
   * When creating multiple records, only created records will be returned. If no records were created, array will be empty:
   *
   * ```ts
   * // array can be empty
   * const arr = await db.table.createMany([data, data, data]).onConflictDoNothing();
   * ```
   */
  onConflictDoNothing<T extends CreateSelf$1, Arg extends OnConflictArg<T>>(this: T, arg?: Arg): IgnoreResult<T>;
}
type OnConflictSet$1<T extends CreateSelf$1> = { [K in keyof T['__inputType']]?: T['__inputType'][K] | (() => QueryOrExpression$1<T['__inputType'][K]>); };
declare class OnConflictQueryBuilder<T extends CreateSelf$1, Arg extends OnConflictArg<T> | undefined> {
  private query;
  private onConflict;
  constructor(query: T, onConflict: Arg);
  /**
   * Available only after `onConflict`.
   *
   * Updates the record with a given data when conflict occurs.
   *
   * ```ts
   * db.table
   *   .create(data)
   *   .onConflict('email')
   *   .set({
   *     // supports plain values and SQL expressions
   *     key: 'value',
   *     fromSql: () => sql`custom sql`,
   *   })
   *   // to update records only on certain conditions
   *   .where({ ...certainConditions });
   * ```
   *
   * @param set - object containing new column values
   */
  set(set: OnConflictSet$1<T>): T;
  /**
   * Available only after `onConflict`.
   *
   * Use this method to merge all the data you have passed into `create` to update the existing record on conflict.
   *
   * If the table has columns with **dynamic** default values, such values will be applied as well.
   *
   * You can exclude certain columns from being merged by passing the `except` option.
   *
   * ```ts
   * // merge the full data
   * db.table.create(data).onConflict('email').merge();
   *
   * // merge only a single column
   * db.table.create(data).onConflict('email').merge('name');
   *
   * // merge multiple columns
   * db.table.create(data).onConflict('email').merge(['name', 'quantity']);
   *
   * // merge all columns except some
   * db.table
   *   .create(data)
   *   .onConflict('email')
   *   .merge({ except: ['name', 'quantity'] });
   *
   * // merge can be applied also for batch creates
   * db.table.createMany([data1, data2, data2]).onConflict('email').merge();
   *
   * // update records only on certain conditions
   * db.table
   *   .create(data)
   *   .onConflict('email')
   *   .merge()
   *   .where({ ...certainConditions });
   * ```
   *
   * @param merge - no argument will merge all data, or provide a column(s) to merge, or provide `except` to update all except some.
   */
  merge(merge?: keyof T['shape'] | (keyof T['shape'])[] | {
    except: keyof T['shape'] | (keyof T['shape'])[];
  }): T;
}
type OnConflictTarget = string | string[] | Expression$1 | {
  constraint: string;
};
type OnConflictSet = RecordUnknown$1;
type OnConflictMerge = string | string[] | {
  except: string | string[];
};
interface UpdateSelf extends PickQuerySelectable, PickQueryResult, PickQueryRelations$1, PickQueryWithData, PickQueryReturnType, PickQueryShape$1, PickQueryInputType$1, PickQueryAs, PickQueryHasSelect, PickQueryHasWhere, Query.Pick.IsNotReadOnly {}
type UpdateData$1<T extends UpdateSelf> = { [K in keyof T['__inputType'] | keyof T['relations']]?: K extends keyof T['__inputType'] ? T['__inputType'][K] | ((q: { [K in keyof T['relations'] | keyof T]: K extends keyof T['relations'] ? T['relations'][K]['query'] : K extends keyof T ? T[K] : never; }) => QueryOrExpression$1<T['__inputType'][K]>) : T['returnType'] extends undefined | 'all' ? T['relations'][K]['dataForUpdate'] : T['relations'][K]['dataForUpdateOne']; };
type UpdateArg<T extends UpdateSelf> = T['__hasWhere'] extends true ? UpdateData$1<T> : 'Update statement must have where conditions. To update all prefix `update` with `all()`';
type UpdateResult<T extends UpdateSelf> = T['__hasSelect'] extends true ? T : T['returnType'] extends undefined | 'all' ? SetQueryReturnsRowCountMany<T> : SetQueryReturnsRowCount<T>;
type NumericColumns<T extends UpdateSelf> = { [K in keyof T['__inputType']]: Exclude<T['shape'][K]['__queryType'], string> extends number | bigint | null ? K : never; }[keyof T['__inputType']];
type ChangeCountArg<T extends UpdateSelf> = NumericColumns<T> | { [K in NumericColumns<T>]?: T['shape'][K]['__type'] extends number | null ? number : number | string | bigint; };
interface UpdateManyBySelf extends UpdateSelf {
  internal: {
    uniqueColumns: unknown;
    uniqueColumnNames: unknown;
    uniqueColumnTuples: unknown;
    uniqueConstraints: unknown;
  };
}
type UpdateManyData<T extends UpdateSelf> = ({ [K in keyof T['shape'] as T['shape'][K] extends Column$1.IsPrimaryKey<string> ? K : never]: T['shape'][K]['__queryType'] | Expression$1; } & { [P in keyof T['__inputType']]?: T['__inputType'][P] | Expression$1; })[];
type UpdateManyByKeys<T extends UpdateManyBySelf> = T['internal']['uniqueColumnNames'] | T['internal']['uniqueColumnTuples'];
type UpdateManyByKeyColumns<K> = K extends string[] ? K[number] : K;
type UpdateManyByData<T extends UpdateSelf, K> = ({ [P in K & keyof T['__inputType']]: T['__inputType'][P]; } & { [P in keyof T['__inputType']]?: P extends K ? T['__inputType'][P] : T['__inputType'][P] | Expression$1; })[];
type UpdateManyResult<T extends UpdateSelf> = T['__hasSelect'] extends true ? T['returnType'] extends 'one' | 'oneOrThrow' ? SetQueryReturnsAllResult<T, T['result']> : T['returnType'] extends 'value' | 'valueOrThrow' ? SetQueryReturnsPluckColumnResult<T, T['result']> : SetQueryResult<T, T['result']> : SetQueryReturnsRowCountMany<T>;
declare class QueryUpdate {
  /**
   * `update` takes an object with columns and values to update records.
   *
   * By default, `update` will return a count of updated records.
   *
   * Use `select`, `selectAll`, `get`, or `pluck` alongside `update` to specify
   * returning columns.
   *
   * You need to provide `where`, `findBy`, or `find` conditions before calling `update`.
   * To ensure that the whole table won't be updated by accident, updating without where conditions will result in TypeScript and runtime errors.
   *
   * Use `all()` to update ALL records without conditions:
   *
   * ```ts
   * await db.table.all().update({ name: 'new name' });
   * ```
   *
   * If `select` and `where` were specified before the update it will return an array of updated records.
   *
   * If `select` and `take`, `find`, or similar were specified before the update it will return one updated record.
   *
   * For a column value you can provide a specific value, raw SQL, a query object that returns a single value, or a callback with a sub-query.
   *
   * The callback is allowed to select a single value from a relation (see `fromRelation` column below),
   * or to use a [jsonSet](/guide/advanced-queries.html#jsonset),
   * [jsonInsert](/guide/advanced-queries.html#jsoninsert),
   * and [jsonRemove](/guide/advanced-queries.html#jsonremove) for a JSON column (see `jsonColumn` below).
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // returns number of updated records by default
   * const updatedCount = await db.table
   *   .where({ name: 'old name' })
   *   .update({ name: 'new name' });
   *
   * // returning only `id`
   * const id = await db.table.find(1).get('id').update({ name: 'new name' });
   *
   * // `selectAll` + `find` will return a full record
   * const oneFullRecord = await db.table
   *   .selectAll()
   *   .find(1)
   *   .update({ name: 'new name' });
   *
   * // `selectAll` + `where` will return array of full records
   * const recordsArray = await db.table
   *   .select('id', 'name')
   *   .where({ id: 1 })
   *   .update({ name: 'new name' });
   *
   * await db.table.where({ ...conditions }).update({
   *   // set the column to a specific value
   *   value: 123,
   *
   *   // use custom SQL to update the column
   *   fromSql: () => sql`2 + 2`,
   *
   *   // use query that returns a single value
   *   // returning multiple values will result in Postgres error
   *   fromQuery: () => db.otherTable.get('someColumn'),
   *
   *   // select a single value from a related record
   *   fromRelation: (q) => q.relatedTable.get('someColumn'),
   *
   *   // set a new value to the `.foo.bar` path into a JSON column
   *   jsonColumn: (q) => q.jsonSet('jsonColumn', ['foo', 'bar'], 'new value'),
   * });
   * ```
   *
   * `update` can be used in [with](/guide/advanced-queries#with) expressions:
   *
   * ```ts
   * db.$qb
   *   // update record in one table
   *   .with('a', db.table.find(1).select('id').update(data))
   *   // update record in other table using the first table record id
   *   .with('b', (q) =>
   *     db.otherTable
   *       .find(1)
   *       .select('id')
   *       .update({
   *         ...otherData,
   *         aId: () => q.from('a').get('id'),
   *       }),
   *   )
   *   .from('b');
   *
   * `update` can be used in {@link WithMethods.with} expressions:
   *
   * ```ts
   * db.$qb
   *   // update record in one table
   *   .with('a', db.table.find(1).select('id').update(data))
   *   // update record in other table using the first table record id
   *   .with('b', (q) =>
   *     db.otherTable
   *       .find(1)
   *       .select('id')
   *       .update({
   *         ...otherData,
   *         aId: () => q.from('a').get('id'),
   *       }),
   *   )
   *   .from('b');
   * ```
   *
   * ### sub-queries
   *
   * In all `create`, `update`, `upsert` methods,
   * you can use sub queries that are either selecting a single value,
   * or creating/updating/deleting a record and return a single value.
   *
   * ```ts
   * await db.table.where({ ...conditions }).update({
   *   // `column` will be set to a value of the `otherColumn` of the created record.
   *   column: () => db.otherTable.get('otherColumn').create({ ...data }),
   *
   *   // `column2` will be set to a value of the `otherColumn` of the updated record.
   *   column2: () =>
   *     db.otherTable
   *       .get('otherColumn')
   *       .findBy({ ...conditions })
   *       .update({ key: 'value' }),
   *
   *   // `column3` will be set to a value of the `otherColumn` of the deleted record.
   *   column3: () =>
   *     db.otherTable
   *       .get('otherColumn')
   *       .findBy({ ...conditions })
   *       .delete(),
   * });
   * ```
   *
   * This is achieved by defining a `WITH` clause under the hood, it produces such a query:
   *
   * ```sql
   * WITH q AS (
   *   INSERT INTO "otherTable"(col1, col2, col3)
   *   VALUES ('val1', 'val2', 'val3')
   *   RETURNING "otherTable"."selectedColumn"
   * )
   * -- In a case of create
   * INSERT INTO "table"("column") VALUES ((SELECT * FROM "q"))
   * -- In a case of update
   * UPDATE "table"
   * SET "column" = (SELECT * FROM "q")
   * ```
   *
   * The query is atomic.
   * No changes will persist in the database if the sub-query fails, or if the top-level query fails, or if multiple rows are returned from a sub-query.
   *
   * [//]: # 'not supported in create because cannot query related records for a thing that is not created yet'
   * [//]: # 'modificational sub queries are not allowed in update because it would be too hard to join a with statement to the update query'
   *
   * Only selective sub-queries are supported in `update` queries when the sub-query is using a relation:
   *
   * ```ts
   * db.book.update({
   *   authorName: (q) => q.author.get('name'),
   * });
   * ```
   *
   * ### null, undefined, unknown columns
   *
   * - `null` value will set a column to `NULL`
   * - `undefined` value will be ignored
   * - unknown columns will be ignored
   *
   * ```ts
   * db.table.findBy({ id: 1 }).update({
   *   name: null, // updates to null
   *   age: undefined, // skipped, no effect
   *   lalala: 123, // skipped
   * });
   * ```
   *
   * ### empty set
   *
   * When trying to query update with an empty object, it will be transformed seamlessly to a `SELECT` query:
   *
   * ```ts
   * // imagine the data is an empty object
   * const data = req.body;
   *
   * // query is transformed to `SELECT count(*) WHERE key = 'value'`
   * const count = await db.table.where({ key: 'value' }).update(data);
   *
   * // will select a full record by id
   * const record = await db.table.find(1).selectAll().update(data);
   *
   * // will select a single column by id
   * const name = await db.table.find(1).get('name').update(data);
   * ```
   *
   * If the table has `updatedAt` [timestamp](/guide/common-column-methods.html#timestamps), it will be updated even for an empty data.
   *
   * @param arg - data to update records with, may have specific values, raw SQL, queries, or callbacks with sub-queries.
   */
  update<T extends UpdateSelf>(this: T, arg: UpdateArg<T>): UpdateResult<T>;
  /**
   * To make sure that at least one row was updated use `updateOrThrow`:
   *
   * ```ts
   * import { NotFoundError } from 'orchid-orm';
   *
   * try {
   *   // updatedCount is guaranteed to be greater than 0
   *   const updatedCount = await db.table
   *     .where(conditions)
   *     .updateOrThrow({ name: 'name' });
   *
   *   // updatedRecords is guaranteed to be a non-empty array
   *   const updatedRecords = await db.table
   *     .where(conditions)
   *     .select('id')
   *     .updateOrThrow({ name: 'name' });
   * } catch (err) {
   *   if (err instanceof NotFoundError) {
   *     // handle error
   *   }
   * }
   * ```
   *
   * @param arg - data to update records with, may have specific values, raw SQL, queries, or callbacks with sub-queries.
   */
  updateOrThrow<T extends UpdateSelf>(this: T, arg: UpdateArg<T>): UpdateResult<T>;
  /**
   * Use `updateFrom` to update records in one table based on a query result from another table or CTE.
   *
   * `updateFrom` accepts the same arguments as {@link Query.join}.
   *
   * ```ts
   * // save all author names to their books by using a relation name:
   * db.books.updateFrom('author').set({ authorName: (q) => q.ref('author.name') });
   *
   * // update from authors that match the condition:
   * db.books
   *   .updateFrom((q) => q.author.where({ writingSkills: 'good' }))
   *   .set({ authorName: (q) => q.ref('author.name') });
   *
   * // update from any table using custom `on` conditions:
   * db.books
   *   .updateFrom(
   *     () => db.authors,
   *     (q) => q.on('authors.id', 'books.authorId'),
   *   )
   *   .set({ authorName: (q) => q.ref('author.name') });
   *
   * // conditions after `updateFrom` can reference both tables:
   * db.books
   *   .updateFrom(() => db.authors)
   *   .where({
   *     'authors.id': (q) => q.ref('books.authorId'),
   *   })
   *   .set({ authorName: (q) => q.ref('author.name') });
   *
   * // can join and use another table in between `updateFrom` and `set`:
   * db.books
   *   .updateFrom('author')
   *   .join('publisher')
   *   .set({
   *     authorName: (q) => q.ref('author.name'),
   *     publisherName: (q) => q.ref('publisher.name'),
   *   });
   *
   * // updating from a CTE
   * db.books
   *   .with('a', () =>
   *     db.authors.where({ writingSkills: 'good' }).select('id', 'name').limit(10),
   *   )
   *   .updateFrom('a', (q) => q.on('a.id', 'books.authorId'))
   *   .set({ authorName: (q) => q.ref('author.name') });
   * ```
   */
  updateFrom<T extends UpdateSelf, Arg extends JoinFirstArg<T>, Cb extends JoinCallbackArgs<T, Arg>>(this: T, arg: Arg, ...args: Cb | JoinArgs<T, Arg>): JoinResultFromArgs<T, Arg, Cb, true, true> & QueryHasWhere$1;
  /**
   * Use after {@link updateFrom}
   */
  set<T extends UpdateSelf>(this: T, arg: UpdateArg<T>): UpdateResult<T>;
  /**
   * Increments a column by `1`, returns a count of updated records by default.
   *
   * ```ts
   * const updatedCount = await db.table
   *   .where(...conditions)
   *   .increment('numericColumn');
   * ```
   *
   * When using `find` or `get` it will throw `NotFoundError` when no records found.
   *
   * ```ts
   * // throws when not found
   * const updatedCount = await db.table.find(1).increment('numericColumn');
   *
   * // also throws when not found
   * const updatedCount2 = await db.table
   *   .where(...conditions)
   *   .get('columnName')
   *   .increment('numericColumn');
   * ```
   *
   * Provide an object to increment multiple columns with different values.
   * Use `select` to specify columns to return.
   *
   * ```ts
   * // increment someColumn by 5 and otherColumn by 10, return updated records
   * const result = await db.table
   *   .selectAll()
   *   .where(...conditions)
   *   .increment({
   *     someColumn: 5,
   *     otherColumn: 10,
   *   });
   * ```
   *
   * @param data - name of the column to increment, or an object with columns and values to add
   */
  increment<T extends UpdateSelf>(this: T, data: ChangeCountArg<T>): UpdateResult<T>;
  /**
   * Decrements a column by `1`, returns a count of updated records by default.
   *
   * ```ts
   * const updatedCount = await db.table
   *   .where(...conditions)
   *   .decrement('numericColumn');
   * ```
   *
   * When using `find` or `get` it will throw `NotFoundError` when no records found.
   *
   * ```ts
   * // throws when not found
   * const updatedCount = await db.table.find(1).decrement('numericColumn');
   *
   * // also throws when not found
   * const updatedCount2 = await db.table
   *   .where(...conditions)
   *   .get('columnName')
   *   .decrement('numericColumn');
   * ```
   *
   * Provide an object to decrement multiple columns with different values.
   * Use `select` to specify columns to return.
   *
   * ```ts
   * // decrement someColumn by 5 and otherColumn by 10, return updated records
   * const result = await db.table
   *   .selectAll()
   *   .where(...conditions)
   *   .decrement({
   *     someColumn: 5,
   *     otherColumn: 10,
   *   });
   * ```
   *
   * @param data - name of the column to decrement, or an object with columns and values to subtract
   */
  decrement<T extends UpdateSelf>(this: T, data: ChangeCountArg<T>): UpdateResult<T>;
  /**
   * Updates multiple records with different per-row data in a single query.
   *
   * Each row must include the primary key and the columns to update.
   * All rows must have the same set of non-key columns.
   *
   * Returns a count of updated records by default.
   * Use `select`, `selectAll`, `get`, or `pluck` alongside `updateMany` to return
   * updated records.
   *
   * Throws {@link NotFoundError} if any record is not found.
   * Use {@link updateManyOptional} to skip missing records without throwing.
   *
   * ```ts
   * // returns count of updated records
   * const count = await db.table.updateMany([
   *   { id: 1, name: 'Alice', age: 30 },
   *   { id: 2, name: 'Bob', age: 25 },
   * ]);
   *
   * // returns array of updated records
   * const records = await db.table.select('id', 'name').updateMany([
   *   { id: 1, name: 'Alice' },
   *   { id: 2, name: 'Bob' },
   * ]);
   * ```
   *
   * `.set()` applies shared values to all rows.
   * `.set()` values take precedence over per-row values for the same column.
   *
   * ```ts
   * await db.table
   *   .updateMany([
   *     { id: 1, name: 'Alice' },
   *     { id: 2, name: 'Bob' },
   *   ])
   *   .set({ updatedBy: currentUser.id });
   * ```
   */
  updateMany<T extends UpdateSelf>(this: T, data: UpdateManyData<T>): UpdateManyResult<T> & QueryHasWhere$1;
  /**
   * Same as {@link updateMany}, but skips missing records rather than throwing.
   *
   * ```ts
   * // updates what it can, doesn't throw for missing id: 999
   * const count = await db.table.updateManyOptional([
   *   { id: 1, name: 'Alice' },
   *   { id: 999, name: 'Ghost' },
   * ]);
   * ```
   */
  updateManyOptional<T extends UpdateSelf>(this: T, data: UpdateManyData<T>): UpdateManyResult<T> & QueryHasWhere$1;
  /**
   * Like {@link updateMany}, but matches rows by a unique column or a compound unique constraint instead of the primary key.
   *
   * Throws {@link NotFoundError} if any record is not found.
   * Use {@link updateManyByOptional} to skip records with no matching key without throwing.
   *
   * ```ts
   * // single unique column
   * await db.table.updateManyBy('email', [
   *   { email: 'alice@test.com', name: 'Alice' },
   *   { email: 'bob@test.com', name: 'Bob' },
   * ]);
   *
   * // compound unique constraint
   * await db.table.updateManyBy(['firstName', 'lastName'], [
   *   { firstName: 'John', lastName: 'Doe', bio: 'updated' },
   * ]);
   * ```
   */
  updateManyBy<T extends UpdateManyBySelf, Keys extends UpdateManyByKeys<T>, K = UpdateManyByKeyColumns<Keys>>(this: T, keys: Keys, data: UpdateManyByData<T, K>): UpdateManyResult<T> & QueryHasWhere$1;
  /**
   * Same as {@link updateManyBy}, but skips records with no matching key rather than throwing.
   *
   * ```ts
   * await db.table.updateManyByOptional('email', [
   *   { email: 'alice@test.com', name: 'Alice' },
   *   { email: 'unknown@test.com', name: 'Ghost' },
   * ]);
   * ```
   */
  updateManyByOptional<T extends UpdateManyBySelf, Keys extends UpdateManyByKeys<T>, K = UpdateManyByKeyColumns<Keys>>(this: T, keys: Keys, data: UpdateManyByData<T, K>): UpdateManyResult<T> & QueryHasWhere$1;
}
type UpsertCreate<DataKey extends PropertyKey, CD> = { [K in keyof CD as K extends DataKey ? never : K]: CD[K]; } & { [K in DataKey]?: K extends keyof CD ? CD[K] : never; };
type UpsertResult<T extends PickQueryHasSelectResultReturnType> = T['__hasSelect'] extends true ? T['returnType'] extends 'value' | 'valueOrThrow' ? SetValueQueryReturnsValueOrThrow<T> : SetQueryReturnsOne<T> : SetQueryReturnsVoid<T>;
interface UpsertThis$1 extends UpdateSelf, CreateSelf$1 {
  __hasWhere: true;
  returnType: 'one' | 'oneOrThrow' | 'value' | 'valueOrThrow' | 'void';
}
type UpsertData$1<T extends UpsertThis$1, Update extends UpdateData$1<T>> = {
  update: Update;
  create: CreateData$1<T> | ((update: Update) => CreateData$1<T>);
} | {
  data: Update;
  create: UpsertCreate<keyof Update, CreateData$1<T>> | ((update: Update) => UpsertCreate<keyof Update, CreateData$1<T>>);
};
declare class QueryUpsert {
  /**
   * `upsert` tries to update a single record, and then it creates the record if it doesn't yet exist.
   *
   * `find` or `findBy` must precede `upsert` because it does not work with multiple updates.
   *
   * In case more than one row was updated, it will throw `MoreThanOneRowError` and the transaction will be rolled back.
   *
   * It can take `update` and `create` objects, then they are used separately for update and create queries.
   * Or, it can take `data` and `create` objects, `data` will be used for update and be mixed to `create` object.
   *
   * `data` and `update` objects are of the same type that's expected by `update` method, `create` object is of type of `create` method argument.
   *
   * No values are returned by default, place `select` or `selectAll` before `upsert` to specify returning columns.
   *
   * ```ts
   * await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .upsert({
   *     data: {
   *       // update record's name
   *       name: 'new name',
   *       // supports sql and nested queries
   *       fromSQL: () => sql`*SQL expression*`,
   *       fromQuery: () => db.someTable.create(data).get('column'),
   *     },
   *     create: {
   *       // create a new record with this email and a name 'new name'
   *       email: 'some@email.com',
   *       // supports sql and nested queries as well
   *     },
   *     create: {
   *       // create a new record with this email and a name 'new name'
   *       email: 'some@email.com',
   *     },
   *   });
   *
   * // the same as above but using `update` and `create`
   * await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .upsert({
   *     update: {
   *       name: 'updated user',
   *     },
   *     create: {
   *       email: 'some@email.com',
   *       // here we use a different name when creating a record
   *       name: 'created user',
   *     },
   *   });
   * ```
   *
   * The data for `create` may be returned from a function, it won't be called if a record was updated:
   *
   * ```ts
   * await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .upsert({
   *     update: {
   *       name: 'updated user',
   *     },
   *     create: () => ({
   *       email: 'some@email.com',
   *       name: 'created user',
   *     }),
   *   });
   *
   * // the same as above using `data`
   * await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .upsert({
   *     data: {
   *       name: 'updated user',
   *     },
   *     create: () => ({
   *       email: 'some@email.com',
   *       // name in `create` is overriding the name from `data`
   *       name: 'created user',
   *     }),
   *   });
   * ```
   *
   * Data from `data` or `update` is passed to the `create` function and can be used:
   *
   * ```ts
   * const user = await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .upsert({
   *     data: {
   *       name: 'updated user',
   *     },
   *     // `updateData` has the exact type of what is passed to `data`
   *     create: (updateData) => ({
   *       email: `${updateData.name}@email.com`,
   *     }),
   *   });
   * ```
   *
   * `upsert` works in the exact same way as [orCreate](#orCreate), but with `UPDATE` statement instead of `SELECT`.
   * it also performs a single query if the record exists, and two queries if there is no record yet.
   *
   * @param data - `update` property for the data to update, `create` property for the data to create
   */
  upsert<T extends UpsertThis$1, Update extends UpdateData$1<T>>(this: T, data: UpsertData$1<T, Update>): UpsertResult<T>;
}
type OrCreateArg<Data> = Data | (() => Data);
declare class QueryOrCreate {
  /**
   * `orCreate` creates a record only if it was not found by conditions.
   *
   * `find` or `findBy` must precede `orCreate`.
   *
   * It is accepting the same argument as `create` commands.
   *
   * No result is returned by default, place `get`, `select`, or `selectAll` before `orCreate` to specify returning columns.
   *
   * ```ts
   * const user = await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .orCreate({
   *     email: 'some@email.com',
   *     name: 'created user',
   *     // supports sql and nested queries
   *     fromSQL: () => sql`*SQL expression*`,
   *     fromQuery: () => db.someTable.create(data).get('column'),
   *     fromRelated: (q) => q.relatedTable.update(data).get('column'),
   *   });
   * ```
   *
   * The data can be returned from a function, it won't be called if the record was found:
   *
   * ```ts
   * const user = await db.user
   *   .selectAll()
   *   .findBy({ email: 'some@email.com' })
   *   .orCreate(() => ({
   *     email: 'some@email.com',
   *     name: 'created user',
   *   }));
   * ```
   *
   * `orCreate` works by performing just a single query in the case if the record exists, and one additional query when the record does not exist.
   *
   * At first, it performs a "find" query, the query cost is exact same as if you didn't use `orCreate`.
   *
   * Then, if the record wasn't found, it performs a single query with CTE expressions to try finding it again, for the case it was already created just a moment before,
   * and then it creates the record if it's still not found. Using such CTE allows to skip using transactions, while still conforming to atomicity.
   *
   * ```sql
   * -- first query
   * SELECT * FROM "table" WHERE "key" = 'value'
   *
   * -- the record could have been created in between these two queries
   *
   * -- second query
   * WITH find_row AS (
   *   SELECT * FROM "table" WHERE "key" = 'value'
   * )
   * WITH insert_row AS (
   *   INSERT INTO "table" ("key")
   *   SELECT 'value'
   *   -- skip the insert if the row already exists
   *   WHERE NOT EXISTS (SELECT 1 FROM find_row)
   *   RETURNING *
   * )
   * SELECT * FROM find_row
   * UNION ALL
   * SELECT * FROM insert_row
   * ```
   *
   * Called after [none](/guide/query-methods.html#none), `orCreate` performs only the second query.
   *
   * @param data - the same data as for `create`, it may be returned from a callback
   */
  orCreate<T extends UpsertThis$1>(this: T, data: OrCreateArg<CreateData$1<T>>): UpsertResult<T>;
}
type IsolationLevel$1 = 'SERIALIZABLE' | 'REPEATABLE READ' | 'READ COMMITTED' | 'READ UNCOMMITTED';
interface TransactionOptions$1 extends SqlSessionState$1 {
  /**
   * Enable or disable logging for all queries in the transaction.
   */
  log?: boolean;
  /**
   * Default schema to use for queries in the transaction.
   */
  schema?: QuerySchema$1;
  /**
   * Postgres isolation level for the top-level transaction.
   */
  level?: IsolationLevel$1;
  /**
   * Whether the top-level transaction should be read-only.
   */
  readOnly?: boolean;
  /**
   * Whether the top-level transaction should be deferrable.
   */
  deferrable?: boolean;
  /**
   * Postgres role to apply for the transaction callback.
   *
   * Nested transactions can temporarily replace the parent transaction role.
   */
  role?: SqlSessionState$1['role'];
  /**
   * Postgres custom settings to apply for the transaction callback.
   *
   * Nested transaction settings are shallow-merged over the parent transaction
   * settings while the nested callback runs.
   */
  setConfig?: SqlSessionState$1['setConfig'];
}
interface AfterCommitErrorFulfilledResult extends PromiseFulfilledResult<unknown> {
  name?: string;
}
interface AfterCommitErrorRejectedResult extends PromiseRejectedResult {
  name?: string;
}
type AfterCommitErrorResult = AfterCommitErrorFulfilledResult | AfterCommitErrorRejectedResult;
/**
 * `AfterCommitError` is thrown when one of after commit hooks throws.
 *
 * ```ts
 * interface AfterCommitError extends OrchidOrmError {
 *   // the result of transaction functions
 *   result: unknown;
 *
 *   // Promise.allSettled result + optional function names
 *   hookResults: (
 *     | {
 *         status: 'fulfilled';
 *         value: unknown;
 *         name?: string;
 *       }
 *     | {
 *         status: 'rejected';
 *         reason: any; // the error object thrown by a hook
 *         name?: string;
 *       }
 *   )[];
 * }
 * ```
 *
 * Use `function name() {}` function syntax for hooks to give them names,
 * so later they can be identified when handling after commit errors.
 *
 * ```ts
 * export const SomeTable = defineTable('someTable', (t) => ({
 *   ...someColumns,
 * })).init((orm: typeof db, hooks) => {
 *   // anonymous funciton - has no name
 *   hooks.afterCreateCommit([], async () => {
 *     // ...
 *   });
 *
 *   // named function
 *   hooks.afterCreateCommit([], function myHook() {
 *     // ...
 *   });
 * });
 * ```
 */
declare class AfterCommitError extends OrchidOrmError {
  result: unknown;
  hookResults: AfterCommitErrorResult[];
  constructor(result: unknown, hookResults: AfterCommitErrorResult[]);
}
type AfterCommitErrorHandler = (error: AfterCommitError) => void | Promise<void>;
declare class QueryTransaction {
  /**
   * In Orchid ORM the method is `$transaction`, when using `pqb` on its own it is `transaction`.
   *
   * `COMMIT` happens automatically after the callback was successfully resolved, and `ROLLBACK` is done automatically if the callback fails.
   *
   * Let's consider the case of transferring money from one user to another:
   *
   * ```ts
   * export const transferMoney = async (
   *   fromId: number,
   *   toId: number,
   *   amount: number,
   * ) => {
   *   try {
   *     // db.$transaction returns data that is returned from the callback
   *     // result here is senderRemainder
   *     const result = await db.$transaction(async () => {
   *       const sender = await db.user.find(fromId);
   *       const senderRemainder = sender.balance - amount;
   *       if (senderRemainder < 0) {
   *         throw new Error('Sender does not have enough money');
   *       }
   *
   *       await db.user.find(fromId).decrement({
   *         balance: amount,
   *       });
   *       await db.user.find(toId).increment({
   *         balance: amount,
   *       });
   *
   *       return senderRemainder;
   *     });
   *   } catch (error) {
   *     // handle transaction error
   *   }
   * };
   * ```
   *
   * It performs 3 queries in a single transaction: load sender record, decrement sender's balance, increment receiver's balance.
   *
   * If sender or receiver record doesn't exist, it will throw `NotFound` error, and there is an error thrown when sender's balance is too low.
   * In such case, the transaction will be rolled back and no changes will be applied to the database.
   *
   * Internally, ORM relies on [AsyncLocalStorage](https://nodejs.org/api/async_context.html#class-asynclocalstorage) feature of node.js,
   * it allows passing the transaction object implicitly. So that any query that is done inside of callback, will run inside a transaction.
   *
   * ## nested transactions
   *
   * Transactions can be nested one in another.
   * The top level transaction is the real one,
   * and the nested ones are emulated with [savepoint](https://www.postgresql.org/docs/current/sql-savepoint.html) instead of `BEGIN`
   * and [release savepoint](https://www.postgresql.org/docs/current/sql-release-savepoint.html) instead of `COMMIT`.
   *
   * Use [ensureTransaction](#ensuretransaction) to run all queries in a single transaction.
   *
   * ```ts
   * const result = await db.$transaction(async () => {
   *   await db.table.create(...one);
   *
   *   const result = await db.$transaction(async () => {
   *     await db.table.create(...two);
   *     return 123;
   *   });
   *
   *   await db.table.create(...three);
   *
   *   return result;
   * });
   *
   * // result is returned from the inner transaction
   * result === 123;
   * ```
   *
   * If the inner transaction throws an error, and it is caught by `try/catch` of outer transaction,
   * it performs [rollback to savepoint](https://www.postgresql.org/docs/current/sql-rollback-to.html)
   * and the outer transaction can continue:
   *
   * ```ts
   * class CustomError extends Error {}
   *
   * await db.$transaction(async () => {
   *   try {
   *     await db.$transaction(async () => {
   *       throw new CustomError();
   *     });
   *   } catch (err) {
   *     if (err instanceof CustomError) {
   *       // ignore this error
   *       return;
   *     }
   *     throw err;
   *   }
   *
   *   // this transaction can continue
   *   await db.table.create(...data);
   * });
   * ```
   *
   * If the error in the inner transaction is not caught, all nested transactions are rolled back and aborted.
   *
   * ## SQL session context in transactions
   *
   * Pass `role` and `setConfig` in transaction options to apply Postgres SQL session context for the whole transaction:
   *
   * ```ts
   * await db.$transaction(
   *   {
   *     role: 'app_user',
   *     setConfig: {
   *       'app.tenant_id': tenantId,
   *       'app.user_id': userId,
   *     },
   *   },
   *   async () => {
   *     const project = await db.project.find(projectId);
   *
   *     await db.project.find(projectId).update({ lastViewedAt: new Date() });
   *
   *     return project;
   *   },
   * );
   * ```
   *
   * This is different from `$withOptions({ role, setConfig }, cb)`.
   * `$withOptions` is query-scoped and reconciles SQL session state around each query.
   * Transaction options are applied once for the transaction and are useful for request-scoped RLS work that is already transaction-bound.
   *
   * Nested transactions can temporarily override the parent transaction role and config.
   * When the nested transaction finishes, Orchid restores the parent transaction context before the outer callback continues.
   */
  transaction<Result>(this: PickQueryQAndInternal, cb: () => Promise<Result>): Promise<Result>;
  transaction<Result>(this: PickQueryQAndInternal, options: IsolationLevel$1 | TransactionOptions$1, cb: () => Promise<Result>): Promise<Result>;
  /**
   * Use the `$ensureTransaction` when you want to ensure the sequence of queries is running in a transaction, but there is no need for Postgres [savepoints](https://www.postgresql.org/docs/current/sql-savepoint.html).
   *
   * ```ts
   * async function updateUserBalance(userId: string, amount: number) {
   *   await db.$ensureTransaction(async () => {
   *     await db.transfer.create({ userId, amount })
   *     await db.user.find(userId).increment({ balance: amount })
   *   })
   * }
   *
   * async function saveDeposit(userId: string, deposit: { ... }) {
   *   await db.$ensureTransaction(async () => {
   *     await db.deposit.create(deposit)
   *     // transaction in updateUserBalance won't be started
   *     await updateUserBalance(userId, deposit.amount)
   *   })
   * }
   * ```
   */
  ensureTransaction<Result>(this: PickQueryQAndInternal, cb: () => Promise<Result>): Promise<Result>;
  isInTransaction(): boolean;
  /**
   * Schedules a hook to run after the outermost transaction commits:
   *
   * ```ts
   * await db.$transaction(async () => {
   *   await db.table.create(data)
   *   await db.table.where({ ...conditions }).update({ key: 'value' })
   *
   *   db.$afterCommit(() => { // can be sync or async
   *     console.log('after commit')
   *   })
   * })
   * ```
   *
   * If used outside the transaction, the hook will be executed almost immediately, on the next microtask:
   *
   * ```ts
   * db.$afterCommit(async () => { // can be sync or async
   *   console.log('after commit')
   * })
   * ```
   *
   * If the callback has no `try/catch` and throws an error,
   * this will cause `uncaughtException` if the callback is sync and `unhandledRejection` if it is async.
   *
   * While a test transaction is open, a hook added outside of a transaction causes `unhandledRejection` when its returned promise rejects, even when that promise is handled elsewhere.
   */
  afterCommit(this: Query, hook: AfterCommitStandaloneHook$1): void;
  /**
   * Whenever a query in a transaction fails, the transaction is transitioned to a failed state, no further queries are possible.
   *
   * Use [catchUniqueError](/guide/error-handling.html#catchuniqueerror) to handle uniqueness errors,
   * the following examples do not use it to illustrate error handling.
   *
   * ```ts
   * // This transaction is going to fail
   * db.$transaction(async () => {
   *   try {
   *     // imagine it fails because the username is already taken
   *     await db.user.insert({ username: 'taken' });
   *   } catch (err) {
   *     // even though the query is wrapped in a try-catch, the transaction fails anyway
   *   }
   * });
   * ```
   *
   * You can use `catch` method on a query instead of `try-catch` to surpass the problem.
   * The following transaction won't fail:
   *
   * ```ts
   * // Transaction succeeds
   * db.$transaction(async () => {
   *   const result = await db.user.insert({ username: 'taken' }).catch(() => 'failed');
   *
   *   if (result === 'failed') {
   *     await db.user.insert({ username: 'another' });
   *   }
   * });
   * ```
   *
   * This is because when using `catch` method, `OrchidORM` will wrap the query with a savepoint.
   *
   * Alternatively, you can use the `recoverable()` method:
   *
   * ```ts
   * // Transaction succeeds
   * db.$transaction(async () => {
   *   try {
   *     await db.user.insert({ username: 'taken' }).recoverable();
   *   } catch (err) {
   *     await db.user.insert({ username: 'another' });
   *   }
   * });
   * ```
   */
  recoverable<T>(this: T): T;
}
interface UnionItem {
  a: SubQueryForSql | Expression$1;
  k: UnionKind;
  p?: boolean;
}
type UnionKind = 'UNION' | 'UNION ALL' | 'INTERSECT' | 'INTERSECT ALL' | 'EXCEPT' | 'EXCEPT ALL';
interface QueryDataUnion {
  b: SubQueryForSql;
  u: UnionItem[];
  p?: boolean;
}
/**
 * Condition that a relation adds to a query.
 * It is joined by `AND` with the whole condition of the query, so `orWhere` can't bypass it, and `clear('where')` keeps it.
 */
declare class RelationCondition {
  readonly condition: WhereItem;
  constructor(condition: WhereItem);
}
type WhereItem = {
  [K: string]: unknown | {
    [K: string]: unknown | SubQueryForSql | Expression$1;
  } | Expression$1;
  NOT?: MaybeArray$1<WhereItem>;
  AND?: MaybeArray$1<WhereItem>;
  OR?: MaybeArray$1<WhereItem>[];
  IN?: MaybeArray$1<WhereInItem>;
  EXISTS?: MaybeArray$1<JoinItemArgs>;
  ON?: WhereOnItem | WhereJsonPathEqualsItem;
  SEARCH?: MaybeArray$1<WhereSearchItem>;
} | Query | Expression$1 | RelationCondition;
interface WhereInItem {
  columns: string[];
  values: unknown[][] | SubQueryForSql | Expression$1;
}
type WhereJsonPathEqualsItem = [leftColumn: string, leftPath: string, rightColumn: string, rightPath: string];
interface WhereOnItem {
  joinFrom: WhereOnJoinItem;
  from: string;
  joinTo: WhereOnJoinItem;
  to: string;
  useOuterAliases?: true;
  op?: string;
}
type WhereOnJoinItem = {
  table?: string;
  q: {
    as?: string;
  };
} | string;
interface WindowItem {
  [K: string]: WindowDeclaration | Expression$1;
}
interface WindowDeclaration {
  partitionBy?: SelectableOrExpression | SelectableOrExpression[];
  order?: OrderItem;
}
type WrapQueryArg = FromQuerySelf;
declare class QueryWrap {
  wrap<T extends IsQuery$1, Q extends WrapQueryArg, As extends string = 't'>(this: T, query: Q, as?: As): SetQueryTableAlias<Q, As>;
}
type AfterHook$1<Select extends PropertyKey[], Shape extends Column$1.QueryColumns> = QueryAfterHook$1<{ [K in Select[number]]: K extends keyof Shape ? Shape[K]['__outputType'] : never; }[]>;
type HookSelectArg<T extends PickQueryShape$1> = (keyof T['shape'] & string)[];
declare class QueryHookUtils$1<T extends PickQueryInputType$1> {
  query: IsQuery$1;
  columns: string[];
  private key;
  constructor(query: IsQuery$1, columns: string[], key: 'hookCreateSet' | 'hookUpdateSet');
  set: (data: { [K in keyof T['__inputType']]?: T['__inputType'][K] | (() => QueryOrExpression$1<T['__inputType'][K]>); }) => void;
}
declare abstract class QueryHooks$1 {
  /**
   * Run the function before any kind of query.
   *
   * @param cb - function to call, first argument is a query object
   */
  beforeQuery<T>(this: T, cb: QueryBeforeHook$1): T;
  /**
   * Run the function after any kind of query.
   * Enforces wrapping the query into a transaction.
   * The function will run after the query is succeeded, but before the transaction commit.
   *
   * @param cb - function to call, first argument is the query result of type `unknown`, second argument is a query object
   */
  afterQuery<T>(this: T, cb: QueryAfterHook$1): T;
  /**
   * Run the function before a `create` kind of query.
   *
   * @param cb - function to call, first argument is a query object
   */
  beforeCreate<T>(this: T, cb: QueryBeforeActionHook$1): T;
  /**
   * Run the function after a `create` kind of query.
   * Enforces wrapping the query into a transaction.
   * The function will run after the query is succeeded, but before the transaction commit.
   * Queries inside the function will run in the same transaction as the target query.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterCreate<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function after transaction for a `create` kind of query will be committed.
   * If the query wasn't wrapped in a transaction, will run after the query.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterCreateCommit<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function before an `update` kind of query.
   *
   * @param cb - function to call, first argument is a query object
   */
  beforeUpdate<T>(this: T, cb: QueryBeforeActionHook$1): T;
  /**
   * Run the function after an `update` kind of query.
   * Enforces wrapping the query into a transaction.
   * The function will run after the query is succeeded, but before the transaction commit.
   * Queries inside the function will run in the same transaction as the target query.
   * If no records were updated, the hook *won't* run.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterUpdate<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function after transaction for an `update` kind of query will be committed.
   * If the query wasn't wrapped in a transaction, will run after the query.
   * If no records were updated, the hook *won't* run.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterUpdateCommit<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function before a `create` or an `update` kind of query.
   *
   * @param cb - function to call, first argument is a query object
   */
  beforeSave<T>(this: T, cb: QueryBeforeActionHook$1): T;
  /**
   * Run the function after a `create` or an `update` kind of query.
   * Enforces wrapping the query into a transaction.
   * The function will run after the query is succeeded, but before the transaction commit.
   * Queries inside the function will run in the same transaction as the target query.
   * For the `update` query, if no records were updated, the hook *won't* run.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterSave<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function after transaction for a `create` or an `update` kind of query will be committed.
   * If the query wasn't wrapped in a transaction, will run after the query.
   * For the `update` query, if no records were updated, the hook *won't* run.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterSaveCommit<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function before a `delete` kind of query.
   *
   * @param cb - function to call, first argument is a query object
   */
  beforeDelete<T>(this: T, cb: QueryBeforeHook$1): T;
  /**
   * Run the function after a `delete` kind of query.
   * Enforces wrapping the query into a transaction.
   * The function will run after the query is succeeded, but before the transaction commit.
   * Queries inside the function will run in the same transaction as the target query.
   * If no records were deleted, the hook *won't* run.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterDelete<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Run the function after transaction for a `delete` kind of query will be committed.
   * If the query wasn't wrapped in a transaction, will run after the query.
   * If no records were deleted, the hook *won't* run.
   *
   * @param select - list of columns to select for the hook
   * @param cb - function to call, first argument is the query result with selected columns, second argument is a query object
   */
  afterDeleteCommit<T extends PickQueryShape$1, S extends HookSelectArg<T>>(this: T, select: S, cb: AfterHook$1<S, T['shape']>): T;
  /**
   * Add `catchAfterCommitError` to the query to catch possible errors that are coming from after commit hooks.
   *
   * When it is used, the transaction will return its result disregarding of a failed hook.
   *
   * Without `catchAfterCommitError`, the transaction function throws and won't return result.
   * Result is still accessible from the error object [AfterCommitError](#AfterCommitError).
   *
   * ```ts
   * const result = await db
   *   .$transaction(async () => {
   *     return db.table.create(data);
   *   })
   *   .catchAfterCommitError((err) => {
   *     // err is instance of AfterCommitError (see below)
   *   })
   *   // can be added multiple times, all catchers will be executed
   *   .catchAfterCommitError((err) => {});
   *
   * // result is available even if an after commit hook has failed
   * result.id;
   * ```
   */
  catchAfterCommitError<T>(this: T, fn: AfterCommitErrorHandler): T;
}
interface MergeQueryArg extends PickQueryTable, PickQuerySelectable, PickQueryResult, PickQueryReturnType, PickQueryWithData, PickQueryWindows, PickQueryThen, PickQueryHasSelect, PickQueryHasWhere {}
type MergeQuery$1<T extends MergeQueryArg, Q extends MergeQueryArg> = { [K in keyof T]: K extends '__hasWhere' | '__hasSelect' ? T[K] & Q[K] : K extends '__selectable' | 'windows' | 'withData' ? Q[K] & Omit<T[K], keyof Q[K]> : K extends 'result' ? MergeQueryResult<T, Q> : K extends 'returnType' ? Q['returnType'] extends undefined ? T['returnType'] : Q['returnType'] : K extends 'then' ? Q['returnType'] extends undefined ? QueryThenByQuery<T, MergeQueryResult<T, Q>> : Q['returnType'] extends 'all' | 'one' | 'oneOrThrow' | 'rows' ? QueryThenByQuery<Q, MergeQueryResult<T, Q>> : Q['__hasSelect'] extends true ? Q['then'] : T['__hasSelect'] extends true ? T['then'] : Q['then'] : T[K]; };
type MergeQueryResult<T extends PickQueryHasSelectResult, Q extends PickQueryHasSelectResult> = T['__hasSelect'] extends true ? Q['__hasSelect'] extends true ? Omit<T['result'], keyof Q['result']> & Q['result'] : T['result'] : Q['result'];
declare class MergeQueryMethods {
  merge<T extends MergeQueryArg, Q extends MergeQueryArg>(this: T, q: Q): MergeQuery$1<T, Q>;
}
interface ColumnDataSelectSqlProp {
  selectSql?: Expression$1;
  selectSqlFn?: SelectSqlCallback;
}
interface SelectSqlCallback {
  (column: ColumnRefExpression$1<Column$1.Pick.QueryColumn>): Expression$1;
}
type SelectSqlColumn$1<T extends Column$1.Pick.DataAndDataType, Expr extends Expression$1> = unknown extends Expr['result']['value']['__outputType'] ? T : { [K in keyof T]: K extends '__outputType' ? Expr['result']['value']['__outputType'] : T[K]; };
/**
 * Function to turn the operator expression into SQL.
 *
 * @param key - SQL of the target to apply operator for, can be a quoted column name or an SQL expression wrapped with parens.
 * @param args - arguments of operator function.
 * @param ctx - context object for SQL conversions, for collecting query variables.
 * @param quotedAs - quoted table name.
 */
interface OperatorToSQL {
  (key: string, args: [unknown], ctx: unknown, quotedAs?: string): string;
}
interface Operator<Value, Column extends Column.Pick.OutputTypeAndOperators = Column.Pick.OutputTypeAndOperators> {
  <T extends PickQueryResult>(this: T, arg: Value): { [K in Exclude<keyof T, keyof T['result']['value']['operators']>]: K extends 'result' ? {
    value: Column;
  } : K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<Column['__outputType']> : T[K]; } & Column['operators'];
  _opType: Value;
}
interface Base$1<Value> {
  __hasSelect: true;
  equals: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  not: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  isDistinctFrom: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  isNotDistinctFrom: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  in: Operator<Value[] | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  notIn: Operator<Value[] | IsQuery$1 | Expression$1, BooleanQueryColumn>;
}
interface OperatorsBooleanSelf extends OperatorsBoolean {
  result: {
    value: BooleanQueryColumn;
  };
}
interface Ord$1<Value> extends Base$1<Value> {
  lt: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  lte: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  gt: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  gte: Operator<Value | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  between: Operator<[Value | IsQuery$1 | Expression$1, Value | IsQuery$1 | Expression$1], BooleanQueryColumn>;
}
type OperatorsNumber$1 = Ord$1<number>;
interface OperatorsBoolean extends Ord$1<boolean> {
  and: Operator<OperatorsBooleanSelf, BooleanQueryColumn>;
  or: Operator<OperatorsBooleanSelf, BooleanQueryColumn>;
}
interface OperatorsText$1 extends Base$1<string> {
  contains: Operator<string | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  containsSensitive: Operator<string | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  startsWith: Operator<string | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  startsWithSensitive: Operator<string | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  endsWith: Operator<string | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  endsWithSensitive: Operator<string | IsQuery$1 | Expression$1, BooleanQueryColumn>;
}
interface OperatorsOrdinalText$1 extends Ord$1<string>, OperatorsText$1 {}
interface JsonPathQueryOptions {
  vars?: RecordUnknown$1;
  silent?: boolean;
}
interface JsonPathQueryTypeOptions<T extends PickQueryColumTypes, C extends Column$1.Pick.QueryColumn> extends JsonPathQueryOptions {
  type?: (types: T['columnTypes']) => C;
}
interface JsonPathQuery {
  /**
   * Selects a value from JSON data using a JSON path.
   *
   * Calls the [jsonb_path_query_first](https://www.postgresql.org/docs/current/functions-json.html) Postgres function.
   *
   * Type can be provided via `{ type: (t) => t.columnType() }` options, by default the type is `unknown`.
   *
   * Optionally takes `vars` and `silent` parameters, see [Postgres docs](https://www.postgresql.org/docs/current/functions-json.html) for details.
   *
   * The `type` option sets the output type when selecting a value,
   * also it makes specific operators available in `where`, so that you can apply `contains` if the type is text, and `gt` if the type is numeric.
   *
   * ```ts
   * // query a single value from a JSON data,
   * // because of the provided type, string JSON value will be parsed to a Date object.
   * const value = await db.table
   *   .get('data')
   *   .jsonPathQueryFirst('$.path.to.date', { type: (t) => t.date().asDate() });
   *
   * // using it in a select
   * const records = await db.table.select({
   *   date: (q) =>
   *     q.get('data').jsonPathQueryFirst('$[*] ? (@ = key)', {
   *       type: (t) => t.integer(),
   *       // defining `vars` and `silent`
   *       vars: { key: 'key' },
   *       silent: true,
   *     }),
   * });
   *
   * // using it in `where`
   * const filtered = await db.table.where((q) =>
   *   // filtering records by the `name` property from the `data` JSON column
   *   q.get('data').jsonPathQueryFirst('$.name').equals('name'),
   * );
   *
   * // using it in update
   * await db.table.find(id).update({
   *   // using data property to set the `name` column
   *   name: (q) =>
   *     q.get('data').jsonPathQueryFirst('$.name', { type: (t) => t.string() }),
   * });
   *
   * // filtering records to contain 'word' in the json property "name"
   * await db.table.where((q) =>
   *   q
   *     .get('data')
   *     .jsonPathQueryFirst('$.name', { type: (t) => t.string() })
   *     .contains('word'),
   * );
   * ```
   *
   * @param path - JSON path
   * @param options - can have type, vars, silent
   */
  <T extends PickQueryResultColumnTypes, C extends Column$1.Pick.QueryColumn = Column$1.Pick.QueryColumnOfTypeAndOps<string, unknown, OperatorsAny>>(this: T, path: string, options?: JsonPathQueryTypeOptions<T, C>): Omit<SetQueryReturnsColumnOrThrow<T, C>, keyof T['result']['value']['operators']> & C['operators'];
  _opType: never;
}
interface OperatorsJson$1 extends Ord$1<unknown> {
  jsonPathQueryFirst: JsonPathQuery;
  jsonSupersetOf: Operator<unknown | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  jsonSubsetOf: Operator<unknown | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  jsonSet: {
    /**
     * Returns a JSON value/object/array where a given value is set at the given path.
     * The path is a key or an array of keys to access the value.
     *
     * Calls the [jsonb_set](https://www.postgresql.org/docs/current/functions-json.html) Postgres function.
     *
     * It can be used in all contexts on a single JSON value.
     *
     * ```ts
     * await db.table.find(id).update({
     *   data: (q) => q.get('data').jsonSet(['path', 'to', 'value'], 'new value'),
     *   // supports sql for the value
     *   data: (q) => q.get('data').jsonSet(['path', 'to', 'value'], sql`'new value'`),
     * });
     * ```
     *
     * @param path - key or array of keys
     * @param value - value to set
     */
    <T extends PickQueryResult>(this: T, path: MaybeArray$1<string | number>, value: unknown): T;
    _opType: never;
  };
  jsonReplace: {
    /**
     * The same as {@link jsonSet}, but sets the last argument of `jsonb_set` to false,
     * so this function only has effect when the value already existed in the JSON.
     *
     * ```ts
     * await db.table.find(id).update({
     *   // data.path.to.value will be updated only if it already was defined
     *   data: (q) => q.get('data').jsonReplace(['path', 'to', 'value'], 'new value'),
     *   // supports sql for the value
     *   data: (q) =>
     *     q.get('data').jsonReplace(['path', 'to', 'value'], sql`'new value'`),
     * });
     * ```
     *
     * @param path - key or array of keys
     * @param value - value to set
     */
    <T extends PickQueryResult>(this: T, path: MaybeArray$1<string | number>, value: unknown): T;
    _opType: never;
  };
  jsonInsert: {
    /**
     * Inserts a value into a given position of JSON array and returns the whole array.
     * The path is a key or an array of keys to access the value.
     *
     * If a value exists at the given path, the value is not replaced.
     *
     * Provide `{ after: true }` option to insert a value after a given position.
     *
     * Calls the [jsonb_insert](https://www.postgresql.org/docs/current/functions-json.html) Postgres function.
     *
     * It can be used in all contexts on a single JSON value.
     *
     * ```ts
     * // update the record with data { tags: ['two'] } to have data { tags: ['one', 'two'] }
     * await db.table.find(id).update({
     *   data: (q) => q.get('data').jsonInsert(['tags', 0], 'one'),
     *   // supports sql for the value
     *   data: (q) => q.get('data').jsonInsert(['tags', 0], sql`'one'`),
     * });
     *
     * // add 'three' after 'two'
     * await db.table.find(id).update({
     *   data: (q) => q.get('data').jsonInsert(['tags', 1], 'three', { after: true }),
     * });
     * ```
     *
     * @param path - key or array of keys
     * @param value - value to insert
     * @param options - can have `after: true`
     */
    <T extends PickQueryResult>(this: T, path: MaybeArray$1<string | number>, value: unknown, options?: {
      after?: boolean;
    }): T;
    _opType: never;
  };
  jsonRemove: {
    /**
     * Remove a value from a JSON object or array at a given path.
     * The path is a key or an array of keys to access the value.
     *
     * Uses the [#-](https://www.postgresql.org/docs/current/functions-json.html) Postgres operator.
     *
     * It can be used in all contexts on a single JSON value.
     *
     * ```ts
     * // the record has data { tags: ['one', 'two'] }
     * // removing the first tag, the data will be { tags: ['two'] }
     * const result = await db.table.find(id).update({
     *   data: (q) => q.get('data').jsonRemove(['tags', 0]),
     * });
     * ```
     *
     * @param path - key or array of keys
     */
    <T extends PickQueryResult>(this: T, path: MaybeArray$1<string | number>): T;
    _opType: never;
  };
}
type OperatorsAny = Base$1<any>;
type OperatorsDate$1 = Ord$1<Date | string>;
type OperatorsTime = Ord$1<string>;
interface OperatorsArray$1<T> extends Ord$1<T[]> {
  has: Operator<T | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  hasEvery: Operator<T[] | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  hasSome: Operator<T[] | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  containedIn: Operator<T[] | IsQuery$1 | Expression$1, BooleanQueryColumn>;
  length: {
    _opType: number | { [K in Exclude<keyof OperatorsNumber$1, '__hasSelect'>]?: OperatorsNumber$1[K]['_opType']; };
  };
}
type TextColumnData = StringData$1;
declare abstract class TextBaseColumn<Schema extends ColumnSchemaConfig$1, Ops = OperatorsText$1> extends Column$1 {
  __schema: Schema;
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  data: TextColumnData;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: Ops;
  constructor(schema: Schema, schemaType?: ReturnType<Schema['stringSchema']>);
}
declare abstract class LimitedTextBaseColumn<Schema extends ColumnSchemaConfig$1> extends TextBaseColumn<Schema, OperatorsOrdinalText$1> {
  data: TextColumnData & {
    maxChars?: number;
  };
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema, limit?: number);
  toSQL(): string;
}
declare class VarCharColumn$1<Schema extends ColumnSchemaConfig$1> extends LimitedTextBaseColumn<Schema> {
  dataType: 'varchar';
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class StringColumn$1<Schema extends ColumnSchemaConfig$1> extends VarCharColumn$1<Schema> {
  constructor(schema: Schema, limit?: number);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class TextColumn$1<Schema extends ColumnSchemaConfig$1> extends TextBaseColumn<Schema, OperatorsOrdinalText$1> {
  dataType: 'text';
  data: TextColumnData & {
    minArg?: number;
    maxArg?: number;
  };
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  private static _instance;
  static get instance(): TextColumn$1<DefaultSchemaConfig$1>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class ByteaColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'bytea';
  operators: OperatorsOrdinalText$1;
  __type: string;
  __inputType: Buffer;
  inputSchema: ReturnType<Schema['buffer']>;
  __outputType: Buffer;
  outputSchema: ReturnType<Schema['buffer']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class PointColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'point';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class LineColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'line';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class LsegColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'lseg';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class BoxColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'box';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class PathColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'path';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class PolygonColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'polygon';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class CircleColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'circle';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class MoneyColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'money';
  __type: string;
  data: NumberColumnData$1;
  __inputType: string | number;
  inputSchema: ReturnType<Schema['number']>;
  __outputType: number;
  outputSchema: ReturnType<Schema['number']>;
  __queryType: string | number;
  querySchema: ReturnType<Schema['number']>;
  operators: OperatorsNumber$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class CidrColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'cidr';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class InetColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'inet';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class MacAddrColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'macaddr';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class MacAddr8Column$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'macaddr8';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class BitColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'bit';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['bit']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['bit']>;
  __queryType: string;
  querySchema: ReturnType<Schema['bit']>;
  operators: OperatorsOrdinalText$1;
  data: Column$1.Data & {
    length: number;
  };
  constructor(schema: Schema, length: number);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  toSQL(): string;
}
declare class BitVaryingColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'varbit';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['bit']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['bit']>;
  __queryType: string;
  querySchema: ReturnType<Schema['bit']>;
  operators: OperatorsOrdinalText$1;
  data: Column$1.Data & {
    length?: number;
  };
  constructor(schema: Schema, length?: number);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  toSQL(): string;
}
type TsVectorGeneratedColumns = string[] | SearchWeightRecord;
declare class TsVectorColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  defaultLanguage: string;
  __schema: Schema;
  dataType: 'tsvector';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema, defaultLanguage?: string);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  /**
   * For `tsvector` column type, it can also accept language (optional) and columns:
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('post', (t) => ({
   *     id: t.id(),
   *     title: t.text(),
   *     body: t.text(),
   *     // join title and body into a single ts_vector
   *     generatedTsVector: t.tsvector().generated(['title', 'body']).searchIndex(),
   *     // with language:
   *     spanishTsVector: t
   *       .tsvector()
   *       .generated('spanish', ['title', 'body'])
   *       .searchIndex(),
   *   }));
   * });
   * ```
   *
   * @param args
   */
  generated<T extends Column$1.Pick.Data>(this: T, ...args: StaticSQLArgs$1 | [language: string, columns: TsVectorGeneratedColumns] | [columns: TsVectorGeneratedColumns]): Column$1.Generated<T>;
}
declare class TsQueryColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'tsquery';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class UUIDColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'uuid';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['uuid']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['uuid']>;
  __queryType: string;
  querySchema: ReturnType<Schema['uuid']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema);
  /**
   * see {@link Column.primaryKey}
   */
  primaryKey<T extends Column$1.Pick.Data, Name extends string>(this: T, name?: Name):
  // using & bc otherwise the return type doesn't match `primaryKey` in ColumnType and TS complains
  T & {
    data: {
      primaryKey: Name;
    };
  } & Column$1.Data.Default;
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class XMLColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'xml';
  __type: string;
  __inputType: string;
  inputSchema: ReturnType<Schema['stringSchema']>;
  __outputType: string;
  outputSchema: ReturnType<Schema['stringSchema']>;
  __queryType: string;
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsText$1;
  private static _instance;
  static get instance(): XMLColumn$1<DefaultSchemaConfig$1>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class CitextColumn$1<Schema extends ColumnSchemaConfig$1> extends TextBaseColumn<Schema, OperatorsOrdinalText$1> {
  __schema: Schema;
  dataType: 'citext';
  data: TextColumnData & {
    minArg?: number;
    maxArg?: number;
  };
  querySchema: ReturnType<Schema['stringSchema']>;
  operators: OperatorsOrdinalText$1;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
declare class BooleanColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: 'bool';
  operators: OperatorsBoolean;
  __type: boolean;
  __inputType: boolean;
  inputSchema: ReturnType<Schema['boolean']>;
  __outputType: boolean;
  outputSchema: ReturnType<Schema['boolean']>;
  __queryType: boolean;
  querySchema: ReturnType<Schema['boolean']>;
  private static _instance;
  static get instance(): BooleanColumn$1<DefaultSchemaConfig$1>;
  private static _instanceSkipValueToArray;
  static get instanceSkipValueToArray(): BooleanColumn$1<DefaultSchemaConfig$1>;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
interface Timestamps$1<T extends Column$1.Pick.Data> {
  createdAt: Column$1.HasDefault<T>;
  updatedAt: Column$1.HasDefault<T>;
}
interface TimestampHelpers {
  /**
   * Add `createdAt` and `updatedAt` timestamps. Both have `now()` as a default, `updatedAt` is automatically updated during update.
   */
  timestamps<T extends Column$1.Pick.Data>(this: {
    timestamp(): T;
  }): Timestamps$1<T>;
  /**
   * The same as {@link timestamps}, for the timestamp without time zone time.
   */
  timestampsNoTZ<T extends Column$1.Pick.Data>(this: {
    timestampNoTZ(): T;
  }): Timestamps$1<T>;
}
declare class CustomTypeColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  typeName: string;
  typeSchema?: string | undefined;
  __schema: Schema;
  operators: OperatorsAny;
  __type: unknown;
  __inputType: unknown;
  inputSchema: ReturnType<Schema['unknown']>;
  __outputType: unknown;
  outputSchema: ReturnType<Schema['unknown']>;
  __queryType: unknown;
  querySchema: ReturnType<Schema['unknown']>;
  data: Column$1.Data;
  dataType: string;
  constructor(schema: Schema, typeName: string, typeSchema?: string | undefined, extension?: string);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  as<T extends {
    __inputType: unknown;
    __outputType: unknown;
    data: Column$1.Data;
  }, C extends {
    __inputType: T['__inputType'];
    __outputType: T['__outputType'];
  }>(this: T, column: C): C;
}
declare class DomainColumn$1<Schema extends ColumnSchemaConfig$1> extends CustomTypeColumn$1<Schema> {
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
interface PostgisPoint {
  lon: number;
  lat: number;
  srid?: number;
}
declare const encode: ({ srid, lon, lat }: PostgisPoint) => string;
declare class PostgisGeographyPointColumn$1<Schema extends ColumnSchemaConfig$1> extends Column$1 {
  __schema: Schema;
  dataType: string;
  __type: PostgisPoint;
  __inputType: PostgisPoint;
  inputSchema: ReturnType<Schema['geographyPointSchema']>;
  __outputType: PostgisPoint;
  outputSchema: ReturnType<Schema['geographyPointSchema']>;
  __queryType: PostgisPoint;
  querySchema: ReturnType<Schema['geographyPointSchema']>;
  operators: OperatorsAny;
  static encode: typeof encode;
  static isDefaultPoint(typmod: number): boolean;
  constructor(schema: Schema);
  toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
}
interface DefaultColumnTypes$1<SchemaConfig extends ColumnSchemaConfig$1> extends TimestampHelpers {
  schema: SchemaConfig;
  enum: SchemaConfig['enum'];
  array: SchemaConfig['array'];
  name<T>(this: T, name: string): T;
  sql: SqlFn$1;
  smallint: SchemaConfig['smallint'];
  integer: SchemaConfig['integer'];
  bigint: SchemaConfig['bigint'];
  numeric: SchemaConfig['decimal'];
  decimal: SchemaConfig['decimal'];
  real: SchemaConfig['real'];
  doublePrecision: SchemaConfig['doublePrecision'];
  identity(options?: TableData$1.Identity): Column$1.HasDefault<ReturnType<SchemaConfig['integer']>>;
  smallSerial: SchemaConfig['smallSerial'];
  serial: SchemaConfig['serial'];
  bigSerial: SchemaConfig['bigSerial'];
  money: SchemaConfig['money'];
  varchar: SchemaConfig['varchar'];
  text: SchemaConfig['text'];
  string: SchemaConfig['string'];
  citext: SchemaConfig['citext'];
  bytea(): ByteaColumn$1<SchemaConfig>;
  date: SchemaConfig['date'];
  timestampNoTZ: SchemaConfig['timestampNoTZ'];
  timestamp: SchemaConfig['timestamp'];
  time(precision?: number): TimeColumn$1<SchemaConfig>;
  interval(fields?: string, precision?: number): IntervalColumn$1<SchemaConfig>;
  boolean(): BooleanColumn$1<SchemaConfig>;
  point(): PointColumn$1<SchemaConfig>;
  line(): LineColumn$1<SchemaConfig>;
  lseg(): LsegColumn$1<SchemaConfig>;
  box(): BoxColumn$1<SchemaConfig>;
  path(): PathColumn$1<SchemaConfig>;
  polygon(): PolygonColumn$1<SchemaConfig>;
  circle(): CircleColumn$1<SchemaConfig>;
  cidr(): CidrColumn$1<SchemaConfig>;
  inet(): InetColumn$1<SchemaConfig>;
  macaddr(): MacAddrColumn$1<SchemaConfig>;
  macaddr8(): MacAddr8Column$1<SchemaConfig>;
  bit(length: number): BitColumn$1<SchemaConfig>;
  bitVarying(length?: number): BitVaryingColumn$1<SchemaConfig>;
  tsvector(): TsVectorColumn$1<SchemaConfig>;
  tsquery(): TsQueryColumn$1<SchemaConfig>;
  uuid(): UUIDColumn$1<SchemaConfig>;
  xml(): XMLColumn$1<SchemaConfig>;
  json: SchemaConfig['json'];
  jsonText: SchemaConfig['jsonText'];
  type(dataType: string): CustomTypeColumn$1<SchemaConfig>;
  domain(dataType: string): DomainColumn$1<SchemaConfig>;
  geography: {
    point(): PostgisGeographyPointColumn$1<SchemaConfig>;
  };
}
interface ColumnDataComputedProp extends ColumnDataSelectSqlProp {
  computed?: Expression$1;
}
declare class ComputedColumn {
  kind: 'one' | 'many';
  deps: string[];
  fn: FnUnknownToUnknown;
  constructor(kind: 'one' | 'many', deps: string[], fn: FnUnknownToUnknown);
}
interface ComputedColumns {
  [K: string]: ComputedColumn;
}
interface RecordOfColumnsShapeBase {
  [K: string]: Column$1.Shape.QueryInit;
}
interface WithConfigs {
  [K: string]: WithConfig;
}
interface WithConfig {
  shape: Column$1.Shape.QueryInit;
  computeds?: ComputedColumns;
}
type JoinedShapes$1 = RecordOfColumnsShapeBase;
interface JoinedParsers {
  [K: string]: ColumnsParsers | undefined;
}
type QueryBeforeHook$1 = (query: Query) => void | Promise<void>;
type QueryBeforeActionHook$1 = (utils: QueryHookUtils$1<PickQueryInputType$1>) => void | Promise<void>;
type QueryAfterHook$1<Data = unknown> = (data: Data, query: Query) => unknown | Promise<unknown>;
type QueryScopeData = (q: Query) => {
  and?: WhereItem[];
  or?: WhereItem[][];
};
type QueryDataFromItem = string | SubQueryForSql | Expression$1;
interface QueryDataJoinTo extends PickQueryTable, PickQueryQ$1 {}
interface HandleResult {
  (q: Query, returnType: QueryReturnType$1, result: QueryResult$1, sql: Sql$1, isSubQuery?: true): unknown;
}
type WithItems = CteItem[];
interface JoinValueDedupItem {
  q: Query;
  a: string;
}
type QueryType = undefined | null | 'upsert' | 'insert' | 'update' | 'delete';
interface AsFn {
  (as: string): void;
}
interface SelectAllColumnExpression {
  (ctx: ToSQLCtx$1, quotedAs?: string): string;
}
type SelectAllColumn = string | SelectAllColumnExpression;
interface QueryData$1 extends QueryDataAliases, PickQueryDataParsers, HasHookSelect, MutativeQueriesSelectRelationsQueryData {
  type: QueryType;
  adapter: Adapter$1;
  selectShape: ColumnsShape$1;
  fromShape?: ColumnsShape$1;
  nameInDb?: string;
  handleResult: HandleResult;
  catch?: boolean;
  returnType: QueryReturnType$1;
  returning?: boolean;
  returningMany?: boolean;
  wrapInTransaction?: boolean;
  throwOnNotFound?: boolean;
  cteThrowOnNotFound?: boolean;
  ensureCount?: {
    expected: number;
    message?: string;
  };
  with?: WithItems;
  withShapes?: WithConfigs;
  joinTo?: QueryDataJoinTo;
  joinedShapes?: JoinedShapes$1;
  joinedParsers?: JoinedParsers;
  joinedBatchParsers?: {
    [K: string]: BatchParsers;
  };
  joinedComputeds?: {
    [K: string]: ComputedColumns | undefined;
  };
  joined?: {
    [K: string]: Query;
  };
  joinedForSelect?: string;
  innerJoinLateral?: true;
  valuesJoinedAs?: RecordString$1;
  valuesJoinedUnderColumns?: {
    [K: string]: Column$1;
  };
  schema?: QuerySchema$1;
  select?: SelectItem[];
  selectCache?: {
    sql: string;
    aliases: string[];
  };
  selectAllColumns?: SelectAllColumn[];
  /**
   * Subset of the `shape` that only includes columns with no `data.explicitSelect`.
   */
  selectAllShape: RecordUnknown$1;
  /**
   * column type for query with 'value' or 'valueOrThrow' return type
   * Is needed in {@link getShapeFromSelect} to get shape of sub-select that returns a single value.
   */
  getColumn?: Column$1.Pick.QueryColumn;
  expr?: Expression$1;
  from?: MaybeArray$1<QueryDataFromItem>;
  updateFrom?: JoinItemArgs;
  sources?: QueryDataSources;
  and?: WhereItem[];
  or?: WhereItem[][];
  order?: OrderItem[];
  returnsOne?: true;
  useFromLimitOffset?: true;
  coalesceValue?: unknown | Expression$1;
  notFoundDefault?: unknown;
  defaults?: RecordUnknown$1;
  runtimeComputeds?: ComputedColumns;
  selectedComputeds?: ComputedColumns;
  beforeSet?: Set<QueryBeforeHook$1>;
  dynamicBefore?: HasBeforeAndBeforeSet[];
  before?: QueryBeforeHook$1[];
  after?: QueryAfterHook$1[];
  beforeCreate?: QueryBeforeHook$1[];
  afterCreate?: QueryAfterHook$1[];
  afterCreateCommit?: QueryAfterHook$1[];
  afterCreateSelect?: Set<string>;
  beforeUpdate?: QueryBeforeHook$1[];
  afterUpdate?: QueryAfterHook$1[];
  afterUpdateCommit?: QueryAfterHook$1[];
  afterUpdateSelect?: Set<string>;
  afterSave?: QueryAfterHook$1[];
  afterSaveCommit?: QueryAfterHook$1[];
  beforeDelete?: QueryBeforeHook$1[];
  afterDelete?: QueryAfterHook$1[];
  afterDeleteCommit?: QueryAfterHook$1[];
  afterDeleteSelect?: Set<string>;
  catchAfterCommitErrors?: AfterCommitErrorHandler[];
  log?: QueryLogObject$1;
  logger: QueryLogger$1;
  autoPreparedStatements?: boolean;
  transform?: QueryDataTransform[];
  language?: string;
  subQuery?: number;
  chainMultiple?: boolean;
  relChain?: {
    query: Query;
    rel: RelationConfigBase$1;
  }[];
  /**
   * Stores current operator functions available for the query.
   * Is needed to remove these operators from query object when changing the query type, see {@link setQueryOperators}.
   */
  operators?: RecordUnknown$1;
  scopes?: {
    [K: string]: QueryScopeData;
  };
  all?: true;
  chain?: ExpressionChain;
  outerQuery?: Query;
  hookCreateSet?: RecordUnknown$1[];
  hookUpdateSet?: RecordUnknown$1[];
  appendQueries?: SubQueryForSql[];
  asFns?: AsFn[];
  /** select and upsert **/
  distinct?: SelectableOrExpression[];
  only?: boolean;
  join?: JoinItem[];
  joinValueDedup?: Map<string, JoinValueDedupItem>;
  group?: (string | Expression$1)[];
  having?: HavingItem[];
  window?: WindowItem[];
  union?: QueryDataUnion;
  limit?: number;
  offset?: number;
  for?: {
    type: 'UPDATE' | 'NO KEY UPDATE' | 'SHARE' | 'KEY SHARE';
    tableNames?: string[] | Expression$1;
    mode?: 'NO WAIT' | 'SKIP LOCKED';
  };
  /** upsert **/
  upsertUpdate?: boolean;
  upsertSecond?: boolean;
  upsertUpdateAsFns?: AsFn[];
  upsertCreateWith?: WithItems;
  upsertCreateAppendQueries?: SubQueryForSql[];
  upsertCreateAsFns?: AsFn[];
  upsertInsert?(): unknown;
  /** insert **/
  columns: string[];
  insertFrom?: SubQueryForSql;
  insertValuesAs?: string;
  queryColumnsCount?: number;
  values: unknown[][];
  onConflict?: {
    target?: OnConflictTarget;
    set?: OnConflictSet;
    merge?: OnConflictMerge;
  };
  /** update **/
  updateData?: UpdateQueryDataItem[];
  updateMany?: UpdateManyQueryData;
}
interface UpdateManyQueryData {
  primaryKeys: string[];
  setColumns: string[];
  data: RecordUnknown$1[];
  strict?: boolean;
}
interface UpdateQueryDataObject {
  [K: string]: Expression$1 | {
    op: string;
    arg: unknown;
  } | unknown;
}
interface UpdatedAtDataInjector {
  (data: UpdateQueryDataItem[]): UpdateQueryDataObject | void;
}
type UpdateQueryDataItem = UpdateQueryDataObject | UpdatedAtDataInjector;
interface ToSqlOptionsInternal {
  hasNonSelect?: boolean;
  aliasValue?: true;
  skipBatchCheck?: true;
  selectedCount?: number;
  selectList?: string[];
}
interface ToSqlValues$1 {
  values: unknown[];
}
interface TopToSqlCtx extends ToSqlOptionsInternal, HasCteHooks, ToSqlValues$1 {
  topCtx: TopToSqlCtx;
  topCTE?: TopCTE;
  tableHook?: TableHook;
  mutativeQueriesSelectRelationsSqlState?: MutativeQueriesSelectRelationsSqlState;
  cteHookTopNullSelectAppended?: boolean;
}
interface ToSQLCtx$1 extends ToSqlOptionsInternal, ToSqlValues$1 {
  topCtx: TopToSqlCtx;
  qb: QueryBuilder;
  q: QueryData$1;
  sql: string[];
  selectedCount: number;
  cteName?: string;
  wrapAs?: string;
}
interface ToSQLQuery extends IsQuery$1 {
  __isQuery: Query['__isQuery'];
  q: Query['q'];
  qb: Query['qb'];
  table?: Query['table'];
  internal: QueryInternal$1;
  relations: Query['relations'];
  withData: Query['withData'];
  clone: Query['clone'];
  baseQuery: Query['baseQuery'];
  returnType: Query['returnType'];
  result: Query['result'];
  shape: Query['shape'];
}
type UnionArgs<T extends PickQueryResult> = ({
  result: { [K in keyof T['result']]: {
    __queryType: T['result'][K]['__queryType'];
  }; };
} | ((q: T) => Expression$1))[];
declare class Union {
  /**
   * Creates a union query, takes one or more queries or SQL expressions.
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // The first query of the union
   * db.one
   *   .select('id', 'name')
   *   // add two more queries to the union
   *   .union(
   *     db.two.select('id', 'name'),
   *     (q = sql`SELECT id, name FROM "thirdTable"`),
   *   )
   *   // sub-sequent `union` is equivalent to passing multiple queries into a single `union`
   *   .union(db.three.select('id', 'name'));
   * ```
   *
   * `order`, `limit`, `offset` are special, it matters if you place them **before** or **after** the `union`, it also have a meaning to place them before and after.
   *
   * ```ts
   * // order, limit, offset are applied ONLY to 'one'
   * db.one
   *   .order('x')
   *   .limit(1)
   *   .offset(1)
   *   // 'two' also has order, limit, and offset
   *   .unionAll(db.two.order('y').limit(2).offset(2))
   *   // sets order, limit, offset for all records
   *   .order('z')
   *   .limit(3)
   *   .offset(3);
   * ```
   *
   * Equivalent SQL:
   *
   * ```sql
   * -- both union parts have their own order, limit, offset
   * ( SELECT * FROM one ORDER x ASC LIMIT 1 OFFSET 1 )
   * UNION ALL
   * ( SELECT * FROM two ORDER y ASC LIMIT 2 OFFSET 2 )
   * -- order, limit, offset of the whole query
   * ORDER BY z ASC LIMIT 3 OFFSET 3
   * ```
   *
   * All the listed methods have the same signature, they are only different by SQL keyword:
   *
   * - `union` - union of all queries, performs deduplication
   * - `unionAll` - `union` that allows duplicated rows
   * - `intersect` - get only rows that are present in all queries
   * - `intersectAll` - `intersect` that allows duplicated rows
   * - `except` - get only rows that are in the first query but not in the second
   * - `exceptAll` - `except` that allows duplicated rows
   *
   * @param args - array of queries or SQL expressions
   */
  union<T extends PickQueryResult>(this: T, ...args: UnionArgs<T>): T;
  /**
   * Same as {@link union}, but allows duplicated rows.
   *
   * @param args - array of queries or SQL expressions
   */
  unionAll<T extends PickQueryResult>(this: T, ...args: UnionArgs<T>): T;
  /**
   * Same as {@link union}, but uses a `INTERSECT` SQL keyword instead
   *
   * @param args - array of queries or SQL expressions
   */
  intersect<T extends PickQueryResult>(this: T, ...args: UnionArgs<T>): T;
  /**
   * Same as {@link intersect}, but allows duplicated rows.
   *
   * @param args - array of queries or SQL expressions
   */
  intersectAll<T extends PickQueryResult>(this: T, ...args: UnionArgs<T>): T;
  /**
   * Same as {@link union}, but uses an `EXCEPT` SQL keyword instead
   *
   * @param args - array of queries or SQL expressions
   */
  except<T extends PickQueryResult>(this: T, ...args: UnionArgs<T>): T;
  /**
   * Same as {@link except}, but allows duplicated rows.
   *
   * @param args - array of queries or SQL expressions
   */
  exceptAll<T extends PickQueryResult>(this: T, ...args: UnionArgs<T>): T;
}
declare abstract class QueryJsonMethods {
  /**
   * Wraps the query in a way to select a single JSON string.
   * So that JSON encoding is done on a database side, and the application doesn't have to turn a response to a JSON.
   * It may be better for performance in some cases.
   *
   * ```ts
   * // json is a JSON string that you can directly send as a response.
   * const json = await db.table.select('id', 'name').json();
   * ```
   *
   * @param coalesce
   */
  json<T>(this: T, coalesce?: boolean): SetQueryReturnsColumnOptional<T, Column$1.Pick.QueryColumnOfType<string>>;
}
type ForQueryBuilder<Q> = Q & {
  noWait<T extends Q>(this: T): T;
  skipLocked<T extends Q>(this: T): T;
};
declare class For {
  forUpdate<T extends IsQuery$1>(this: T, tableNames?: string[] | Expression$1): ForQueryBuilder<T>;
  forNoKeyUpdate<T extends IsQuery$1>(this: T, tableNames?: string[] | Expression$1): ForQueryBuilder<T>;
  forShare<T extends IsQuery$1>(this: T, tableNames?: string[] | Expression$1): ForQueryBuilder<T>;
  forKeyShare<T extends IsQuery$1>(this: T, tableNames?: string[] | Expression$1): ForQueryBuilder<T>;
}
type ClearStatement = 'with' | 'select' | 'where' | 'union' | 'using' | 'join' | 'group' | 'order' | 'having' | 'limit' | 'offset' | 'counters';
declare class Clear {
  clear<T>(this: T, ...clears: ClearStatement[]): T;
}
type HavingArgFn<T> = (q: T) => {
  result: {
    value: {
      __outputType: boolean;
    };
  };
};
declare class Having {
  /**
   * Build a `HAVING` clause to the query to filter records by results of [aggregate functions](#aggregate-functions).
   *
   * The argument of `having` is a function where you call the aggregate function and compare it with some value by using [column operators](/guide/where.html#column-operators).
   *
   * ```ts
   * db.table.having((q) => q.count().gte(10));
   * // HAVING count(*) >= 10
   * ```
   *
   * Multiple having conditions will be combined with `AND`:
   *
   * ```ts
   * db.table.having(
   *   (q) => q.sum('column').gt(5),
   *   (q) => q.avg('column').lt(10),
   * );
   * // HAVING sum(column) > 5 AND avg(column) < 10
   * ```
   *
   * After applying a comparison, `or` and `and` methods become available:
   *
   * ```ts
   * db.table.having((q) =>
   *   q.sum('column').equals(5).or(q.min('column').gt(1), q.max('column').lt(10)),
   * );
   * // HAVING (sum(column) = 5) OR (min(column) > 1 AND max(column) < 10)
   * ```
   *
   * Aggregate functions are exactly the same functions described in [aggregate functions](#aggregate-functions), they can accept aggregation options:
   *
   * ```ts
   * db.table.having((q) =>
   *   q
   *     .count('id', {
   *       distinct: true,
   *       order: { createdAt: 'DESC', filter: { someColumn: { not: null } } },
   *     })
   *     .gte(10),
   * );
   * ```
   *
   * Arguments of the aggregate function and of the comparison can be raw SQL:
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * db.table.having((q) => q.count(sql('coalesce(one, two)')).gte(sql`2 + 2`));
   * ```
   *
   * @param args - raw SQL template string or one or multiple callbacks returning a boolean expression
   */
  having<T>(this: T, ...args: HavingArgFn<T>[]): T;
  /**
   * Provide SQL expression for the `HAVING` SQL statement:
   *
   * ```ts
   * db.table.havingSql`count(*) >= ${10}`;
   * ```
   *
   * @param args - SQL expression
   */
  havingSql<T>(this: T, ...args: SQLQueryArgs): T;
}
interface QueryPluckSelf extends PickQuerySelectable, PickQueryRelationsWithData {}
type PluckArg<T extends QueryPluckSelf> = SelectableOrExpression<T> | ((q: SelectAsFnArg<T>) => Expression$1 | Query.Pick.SingleValueResult);
type PluckResult<T extends QueryPluckSelf, S extends PluckArg<T>> = S extends ((q: never) => infer R) ? R extends Expression$1 ? SetQueryReturnsPluck<T, R> : R extends Query.Pick.SingleValueResult ? { [K in keyof T]: K extends '__hasSelect' ? true : K extends 'result' ? {
  pluck: R['result']['value'];
} : K extends 'returnType' ? 'pluck' : K extends 'then' ? QueryThen<R['result']['value']['__outputType'][]> : T[K]; } : never : S extends SelectableOrExpression<T> ? SetQueryReturnsPluck<T, S> : never;
declare class QueryPluck {
  /**
   * `.pluck` returns a single array of a single selected column values:
   *
   * ```ts
   * const ids = await db.table.select('id').pluck();
   * // ids are an array of all users' id like [1, 2, 3]
   * ```
   * @param select - column name or a raw SQL
   */
  pluck<T extends QueryPluckSelf, S extends PluckArg<T>>(this: T, select: S): PluckResult<T, S>;
}
declare class QueryMap {
  /**
   * Use `map` to transform individual records of a query result.
   *
   * Use `map` to transform individual records of a query result. If the query returns multiple, `map` function going to transform records one by one.
   *
   * For an optional query result (`findOptional`, `getOptional`, etc.), `map` is **not** called for empty results.
   *
   * For transforming the result of a query as a whole, consider using {@link Query.transform} instead.
   *
   * ```ts
   * // add a `titleLength` to every post
   * const posts = await db.post.limit(10).map((post, i) => ({
   *   ...post,
   *   titleLength: post.title.length,
   * }));
   *
   * posts[0].titleLength; // number
   *
   * // using the exact same `map` function to transform a single post
   * const singlePost = await db.post.find(id).map((post, i) => ({
   *   ...post,
   *   titleLength: post.title.length,
   * }));
   *
   * singlePost.titleLength; // number
   *
   * // can be used in sub-queries
   * const postsWithComments = await db.post.select('title', {
   *   comments: (q) =>
   *     q.comments.map((comment, i) => ({
   *       ...comment,
   *       truncatedContent: comment.content.slice(0, 100),
   *     })),
   * });
   *
   * postsWithComments[0].comments[0].truncatedContent; // string
   * ```
   *
   * @param fn - function to transform an individual record
   * @param thisArg - same as in the native array map
   */
  map<T extends PickQueryReturnType, Result>(this: T, fn: T extends {
    returnType: 'valueOrThrow';
    then: QueryThen<(infer Data) | null>;
  } ? (input: Data, index: number, value: Data) => Result : T['returnType'] extends QueryReturnTypeAll | 'pluck' ? T extends {
    then: QueryThen<(infer Data)[]>;
  } ? (input: Data, index: number, arr: Data[]) => Result : never : T extends {
    then: QueryThen<(infer Data) | undefined>;
  } ? (input: Data, index: number, value: Data) => Result : never, thisArg?: unknown): Result extends RecordUnknown$1 ? { [K in keyof T]: K extends 'result' ? { [K in keyof Result]: Column$1.Pick.QueryColumnOfType<Result[K]>; } : K extends 'then' ? QueryThen<T['returnType'] extends QueryReturnTypeAll | 'pluck' ? Result[] : T['returnType'] extends QueryReturnTypeOptional ? Result | undefined : Result> : T[K]; } : { [K in keyof T]: K extends 'returnType' ? T['returnType'] extends QueryReturnTypeAll | 'pluck' ? 'pluck' : T['returnType'] extends 'one' ? 'value' : 'valueOrThrow' : K extends 'result' ? T['returnType'] extends QueryReturnTypeAll | 'pluck' ? {
    pluck: Column$1.Pick.QueryColumnOfType<Result>;
  } : T['returnType'] extends QueryReturnTypeOptional ? {
    value: Column$1.Pick.QueryColumnOfType<Result | undefined>;
  } : {
    value: Column$1.Pick.QueryColumnOfType<T extends {
      returnType: 'valueOrThrow';
      then: QueryThen<unknown | null>;
    } ? Result | null : Result>;
  } : K extends 'then' ? QueryThen<T['returnType'] extends QueryReturnTypeAll | 'pluck' ? Result[] : T['returnType'] extends QueryReturnTypeOptional ? Result | undefined : T extends {
    returnType: 'valueOrThrow';
    then: QueryThen<unknown | null>;
  } ? Result | null : Result> : T[K]; };
}
declare class QueryDistinct {
  /**
   * Adds a `DISTINCT` keyword to `SELECT`:
   *
   * ```ts
   * db.table.distinct().select('name');
   * ```
   *
   * Can accept column names or raw SQL expressions to place it to `DISTINCT ON (...)`:
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * // Distinct on the name and raw SQL
   * db.table.distinct('name', sql`raw sql`).select('id', 'name');
   * ```
   *
   * @param columns - column names or a raw SQL
   */
  distinct<T extends PickQuerySelectable>(this: T, ...columns: SelectableOrExpressions<T>): T;
}
interface SubQueryReturningSingle extends IsSubQuery {
  returnType: 'one' | 'oneOrThrow';
}
declare class QueryLimitOffset {
  /**
   * Adds a limit clause to the query.
   *
   * ```ts
   * db.table.limit(10);
   * ```
   *
   * @param arg - limit number
   */
  limit<T>(this: T, arg: T extends SubQueryReturningSingle ? 'Cannot apply limit on the query returning a single record' : number | undefined): T;
  /**
   * Adds an offset clause to the query.
   *
   * ```ts
   * db.table.offset(10);
   * ```
   *
   * @param arg - offset number
   */
  offset<T extends IsQuery$1>(this: T, arg: number | undefined): T;
}
declare class QueryTruncate {
  /**
   * Truncates the specified table.
   *
   * ```ts
   * // simply truncate
   * await db.table.truncate();
   *
   * // restart autoincrementing columns:
   * await db.table.truncate({ restartIdentity: true });
   *
   * // truncate also dependant tables:
   * await db.table.truncate({ cascade: true });
   * ```
   *
   * @param options - truncate options, may have `cascade: true` and `restartIdentity: true`
   */
  truncate<T extends Query.Pick.IsNotReadOnly>(this: T, options?: {
    restartIdentity?: boolean;
    cascade?: boolean;
  }): SetQueryReturnsVoid<T>;
}
declare class QueryExistsMethods {
  /**
   * Use `exists()` to check if there is at least one record-matching condition.
   *
   * It will discard previous `select` statements if any. Returns a boolean.
   *
   * ```ts
   * const exists: boolean = await db.table.where(...conditions).exists();
   * ```
   */
  exists<T extends QueryGetSelf>(this: T): SetQueryReturnsColumnOrThrow<T, BooleanQueryColumn>;
  /**
   * Use `notExists()` to check if there are no matching records.
   *
   * It will discard previous `select` statements if any. Returns a boolean.
   *
   * ```ts
   * const exists: boolean = await db.table.where(...conditions).notExists();
   * ```
   */
  notExists<T extends QueryGetSelf>(this: T): SetQueryReturnsColumnOrThrow<T, BooleanQueryColumn>;
}
type GroupArgs<T extends PickQueryResult> = ({ [K in keyof T['result']]: T['result'][K]['dataType'] extends 'array' | 'object' | 'runtimeComputed' ? never : K; }[keyof T['result']] | Expression$1)[];
interface QueryHelperQuery<T extends PickQuerySelectableShapeAs> extends MergeQueryArg {
  returnType: QueryReturnType$1;
  __selectable: Omit<T['__selectable'], `${T['__as']}.${Extract<keyof T['shape'], string>}`>;
  result: Column$1.QueryColumns;
  windows: EmptyObject$1;
  withData: WithDataItems;
  then: unknown;
}
interface IsQueryHelper {
  isQueryHelper: true;
  table: string | undefined;
  __args: unknown[];
  __result: unknown;
}
interface IsQueryHelperForTable<Table extends string | undefined> extends IsQueryHelper {
  table: Table;
}
interface QueryHelper<T extends PickQueryTableMetaShapeTableAs, Args extends any[], Result> extends IsQueryHelper {
  <Q extends QueryHelperQuery<T>>(q: Q, ...args: Args): Result extends MergeQueryArg ? MergeQuery$1<Q, Result> : Result;
  __as: T['__as'];
  table: T['table'];
  __args: Args;
  __result: Result;
}
interface NarrowTypeSelf extends PickQueryResultReturnType {
  returnType: undefined | 'all' | 'one' | 'oneOrThrow' | 'value' | 'valueOrThrow' | 'pluck';
}
type NarrowInvalidKeys<T extends PickQueryResult, Narrow> = { [K in keyof Narrow]: K extends keyof T['result'] ? Narrow[K] extends T['result'][K]['__outputType'] ? never : K : K; }[keyof Narrow];
interface NarrowValueTypeResult<T extends PickQueryResultReturnType, Narrow> extends Column$1.QueryColumns {
  value: { [K in keyof T['result']['value']]: K extends '__outputType' ? Narrow : T['result']['value'][K]; };
}
interface NarrowPluckTypeResult<T extends PickQueryResultReturnType, Narrow> extends Column$1.QueryColumns {
  pluck: { [K in keyof T['result']['pluck']]: K extends '__outputType' ? Narrow extends unknown[] ? Narrow[number] : Narrow : T['result']['pluck'][K]; };
}
type QueryIfResult<T extends PickQueryResultReturnType, R extends PickQueryResult> = { [K in keyof T]: K extends 'result' ? { [K in keyof T['result'] | keyof R['result']]: K extends keyof T['result'] ? K extends keyof R['result'] ? R['result'][K] | T['result'][K] : T['result'][K] : Column$1.QueryColumnToOptional<R['result'][K]>; } : K extends 'then' ? QueryIfResultThen<T, R> : T[K]; };
type QueryIfResultThen<T extends PickQueryResultReturnType, R extends PickQueryResult> = T['returnType'] extends undefined | 'all' ? QueryThenShallowSimplifyArr<{ [K in keyof T['result']]: K extends keyof R['result'] ? T['result'][K]['__outputType'] | R['result'][K]['__outputType'] : T['result'][K]['__outputType']; } & { [K in keyof R['result'] as K extends keyof T['result'] ? never : K]?: R['result'][K]['__outputType']; }> : T['returnType'] extends 'one' ? QueryThenShallowSimplifyOptional<{ [K in keyof T['result']]: K extends keyof R['result'] ? T['result'][K]['__outputType'] | R['result'][K]['__outputType'] : T['result'][K]['__outputType']; } & { [K in keyof R['result'] as K extends keyof T['result'] ? never : K]?: R['result'][K]['__outputType']; }> : T['returnType'] extends 'oneOrThrow' ? QueryThenShallowSimplify$1<{ [K in keyof T['result']]: K extends keyof R['result'] ? T['result'][K]['__outputType'] | R['result'][K]['__outputType'] : T['result'][K]['__outputType']; } & { [K in keyof R['result'] as K extends keyof T['result'] ? never : K]?: R['result'][K]['__outputType']; }> : T['returnType'] extends 'value' ? QueryThen<T['result']['value']['__outputType'] | R['result']['value']['__outputType'] | undefined> : T['returnType'] extends 'valueOrThrow' ? QueryThen<T['result']['value']['__outputType'] | R['result']['value']['__outputType']> : T['returnType'] extends 'rows' ? QueryThen<(T['result'][keyof T['result']]['__outputType'] | R['result'][keyof R['result']]['__outputType'])[][]> : T['returnType'] extends 'pluck' ? QueryThen<(T['result']['pluck']['__outputType'] | R['result']['pluck']['__outputType'])[]> : QueryThen<void>;
interface QueryMethods<ColumnTypes> extends QueryClone, QueryAsMethods, AggregateMethods, QueryDistinct, Select, FromMethods, QueryJoin, QueryLimitOffset, CteQuery, Union, QueryJsonMethods, QueryCreate, QueryCreateFrom, QueryUpdate, QueryDelete, QueryStorage, QueryTransaction, QueryTruncate, For, Where, SearchMethods, Clear, Having, QueryCatchers, QueryLog, QueryOrder, QueryWithSchema, QueryHooks$1, QueryUpsert, QueryOrCreate, QueryGet, QueryPluck, MergeQueryMethods, QuerySql<ColumnTypes>, QueryTransform, QueryMap, QueryScope, SoftDeleteMethods, QueryExpressions, QueryWrap, QueryWindow, QueryExistsMethods {}
declare class QueryMethods<ColumnTypes> {
  /**
   * `.all` is a default behavior, that returns an array of objects:
   *
   * ```ts
   * const records = db.table
   *   .take() // .take() will be overridden by .all()
   *   .all();
   * ```
   */
  all<T extends PickQueryResult>(this: T): SetQueryReturnsAll<T>;
  /**
   * Use `take` to "take" a single record. It adds `LIMIT 1`, throws a `NotFoundError` when not found.
   *
   * ```ts
   * const taken: TableType = await db.table.where({ key: 'value' }).take();
   * ```
   *
   * Makes no effect if the query previously has `get`, `pluck`, `exec`.
   *
   * Changes `getOptional` to `get`.
   */
  take<T extends PickQueryResultReturnType>(this: T): QueryTake$1<T>;
  /**
   * Use `takeOptional` to "take" a single record. It adds `LIMIT 1`, returns `undefined` when not found.
   *
   * ```ts
   * const takenOptional: TableType | undefined = await db.table
   *   .where({ key: 'value' })
   *   .takeOptional();
   * ```
   *
   * Makes no effect if the query previously has `getOptional`, `pluck`, `exec`.
   *
   * Changes `get` to `getOptional`.
   */
  takeOptional<T extends PickQueryResultReturnType>(this: T): QueryTakeOptional<T>;
  /**
   * `.rows` returns an array of arrays without field names:
   *
   * ```ts
   * const rows: Array<Array<number | string>> = await db.table
   *   .select('id', 'name')
   *   .rows();
   *
   * rows.forEach((row) => {
   *   // row is array of column values
   *   row.forEach((value) => {
   *     // value is an id or a name
   *   });
   * });
   * ```
   */
  rows<T extends PickQueryResult>(this: T): SetQueryReturnsRows<T>;
  /**
   * `.exec` won't parse the response at all, and returns undefined:
   *
   * ```ts
   * const nothing = await db.table.take().exec();
   * ```
   */
  exec<T>(this: T): SetQueryReturnsVoid<T>;
  /**
   * For relation selects, `require` changes LEFT JOIN LATERAL to JOIN LATERAL.
   *
   * ```ts
   * // only the records that have `related` will be loaded:
   * await db.table.select({ related: (q) => q.related.required() });
   * ```
   */
  require<T extends PickQueryResultReturnType>(this: T): QueryRequire<T>;
  /**
   * Call `toSQL` on a query to get an object with a `text` SQL string and a `values` array of binding values:
   *
   * ```ts
   * const sql = db.table.select('id', 'name').where({ name: 'name' }).toSQL();
   *
   * expect(sql.text).toBe(
   *   'SELECT "table"."id", "table"."name" FROM "table" WHERE "table"."name" = $1',
   * );
   * expect(sql.values).toEqual(['name']);
   * ```
   *
   * `toSQL` is called internally when awaiting a query.
   *
   * It is caching the result. Not mutating query methods are resetting the cache, but need to be careful with mutating methods that start with `_` - they won't reset the cache, which may lead to unwanted results.
   *
   * `toSQL` optionally accepts such parameters:
   *
   * ```ts
   * type ToSqlOptions = {
   *   values?: [];
   * };
   * ```
   */
  toSQL(this: ToSQLQuery, callFromThen?: boolean): Sql$1;
  /**
   * Finds a single record by the primary key (id), throws [NotFoundError](/guide/error-handling.html) if not found.
   * Not available if the table has no or multiple primary keys.
   *
   * ```ts
   * const result: TableType = await db.table.find(1);
   * ```
   *
   * @param value - primary key value to find by
   */
  find<T extends PickQueryShapeResultReturnTypeSinglePrimaryKey>(this: T, value: T['internal']['singlePrimaryKey'] | Expression$1): QueryTake$1<T> & QueryHasWhere$1;
  /**
   * Finds a single record with a given SQL, throws {@link NotFoundError} if not found:
   *
   * ```ts
   * await db.user.findBySql`
   *   age = ${age} AND
   *   name = ${name}
   * `;
   * ```
   *
   * @param args - SQL expression
   */
  findBySql<T extends PickQueryResultReturnType>(this: T, ...args: SQLQueryArgs): QueryTake$1<T> & QueryHasWhere$1;
  /**
   * Finds a single record by the primary key (id), returns `undefined` when not found.
   * Not available if the table has no or multiple primary keys.
   *
   * ```ts
   * const result: TableType | undefined = await db.table.find(123);
   * ```
   *
   * @param value - primary key value to find by, or a raw SQL
   */
  findOptional<T extends PickQueryShapeResultReturnTypeSinglePrimaryKey>(this: T, value: T['internal']['singlePrimaryKey'] | Expression$1): QueryTakeOptional<T> & QueryHasWhere$1;
  /**
   * Finds a single record with a given SQL.
   * Returns `undefined` when not found.
   *
   * ```ts
   * await db.user.findBySqlOptional`
   *   age = ${age} AND
   *   name = ${name}
   * `;
   * ```
   *
   * @param args - SQL expression
   */
  findBySqlOptional<T extends PickQueryResultReturnType>(this: T, ...args: SQLQueryArgs): QueryTakeOptional<T> & QueryHasWhere$1;
  /**
   * Finds a single unique record, throws [NotFoundError](/guide/error-handling.html) if not found.
   * It accepts values of primary keys, unique columns, or compound unique constraints defined on the table.
   * `findBy`'s argument type is a union of all possible sets of unique conditions.
   *
   * You can use `where(...).take()` for non-unique conditions.
   *
   * ```ts
   * await db.table.findBy({ key: 'value' });
   * ```
   *
   * @param uniqueColumnValues - is derived from primary keys, unique columns, and compound unique constraints in the table
   */
  findBy<T extends PickQueryResultReturnTypeUniqueColumns>(this: T, uniqueColumnValues: T['internal']['uniqueColumns']): QueryTake$1<T> & QueryHasWhere$1;
  /**
   * Finds a single unique record, returns `undefined` if not found.
   * It accepts values of primary keys, unique columns, or compound unique constraints defined on the table.
   * `findBy`'s argument type is a union of all possible sets of unique conditions.
   *
   * You can use `where(...).takeOptional()` for non-unique conditions.
   *
   * ```ts
   * await db.table.findByOptional({ key: 'value' });
   * ```
   *
   * @param uniqueColumnValues - is derived from primary keys, unique columns, and compound unique constraints in the table
   */
  findByOptional<T extends PickQueryResultReturnTypeUniqueColumns>(this: T, uniqueColumnValues: T['internal']['uniqueColumns']): QueryTakeOptional<T> & QueryHasWhere$1;
  /**
   * For the `GROUP BY` SQL statement, it is accepting column names or raw expressions.
   *
   * `group` is useful when aggregating values.
   *
   * ```ts
   * // Select the category and sum of prices grouped by the category
   * const results = db.product
   *   .select('category')
   *   .selectSum('price', { as: 'sumPrice' })
   *   .group('category');
   * ```
   *
   * Also, it's possible to group by a selected value:
   *
   * ```ts
   * import { sql } from './baseTable';
   *
   * const results = db.product
   *   .select({
   *     month: sql`extract(month from "createdAt")`.type((t) =>
   *       // month is returned as string, parse it to int
   *       t.string().parse(parseInt),
   *     ),
   *   })
   *   .selectSum('price', { as: 'sumPrice' })
   *   // group by month extracted from "createdAt"
   *   .group('month');
   * ```
   *
   * Column aliases in `select` take precedence over table columns,
   * so if in the query above `db.product` had a column `month`,
   * the query would work in the exact same way, group by would reference the selected `month` expression.
   *
   * @param columns - column names or a raw SQL
   */
  group<T extends PickQueryHasSelectResult>(this: T, ...columns: T['__hasSelect'] extends true ? GroupArgs<T> : {
    error: 'select is required for group';
  }[]): T;
  /**
   * `none` will resolve the query into an empty result, without executing a database query.
   *
   * ```ts
   * await db.table.none(); // -> empty array
   * await db.table.findOptional(123).none(); // -> undefined
   * await db.table.find(123).none(); // throws NotFoundError
   * ```
   *
   * [insert](/guide/create.html#create), [update](/guide/update.html#update), and [delete](/guide/delete.html#delete) are returning a count of affected records.
   *
   * When they are called with `none`, query does not execute and 0 is returned.
   *
   * ```ts
   * await db.table.insert(data).none(); // -> 0
   * await db.table.all().update(data).none(); // -> 0
   * await db.table.all().delete().none(); // -> 0
   * ```
   *
   * Aggregates don't execute a query either: `count` returns `0`, other aggregates return `null`.
   *
   * ```ts
   * await db.table.none().count(); // -> 0
   * await db.table.none().sum('price'); // -> null
   * ```
   *
   * [orCreate](/guide/create.html#orcreate) and [upsert](/guide/create.html#upsert) called after `none` find nothing, so they create the record with a single query.
   * Called before `none`, they don't execute.
   *
   * ```ts
   * await db.table.none().find(1).orCreate(data); // creates the record
   * await db.table.find(1).orCreate(data).none(); // doesn't execute
   * ```
   *
   * When it's being used in sub-selects, it will return empty arrays, `undefined`'s, `0` for count, `null` for other aggregates,
   * or it will throw if the sub-query require a result:
   *
   * ```ts
   * await db.user.select({
   *   // returns empty array
   *   pets: (q) => q.pets.none(),
   *   // returns `undefined`
   *   firstPet: (q) => q.pets.none().takeOptional(),
   *   // throws NotFound error
   *   requriedFirstPet: (q) => q.pets.none().take(),
   *   // returns `undefined`
   *   firstPetName: (q) => q.pets.none().getOptional('name'),
   *   // throws NotFound error
   *   requiredFirstPetName: (q) => q.pets.none().get('name'),
   *   // returns empty array
   *   petsNames: (q) => q.pets.none().pluck('name'),
   *   // returns 0
   *   petsCount: (q) => q.pets.none().count(),
   *   // returns null
   *   petsAgeSum: (q) => q.pets.none().sum('age'),
   * });
   * ```
   *
   * When the `none` query is being used for joins that require match, the host query will return an empty result:
   *
   * ```ts
   * // all the following queries will resolve into empty arrays
   *
   * await db.user.select({
   *   pets: (q) => q.pets.require().none(),
   * });
   *
   * await db.user.join((q) => q.pets.none());
   *
   * await db.user.join('pets', (q) => q.none());
   * ```
   *
   * When it's being used in `leftJoin` or `fullJoin`, it implicitly adds `ON false` into the join's SQL.
   *
   * ```ts
   * // this query can return user records
   * await db.user.leftJoin('pets', (q) => q.none());
   *
   * // this query won't return user records, because of the added where condition
   * await db.user.leftJoin('pets', (q) => q.none()).where({ 'pets.name': 'Kitty' });
   * ```
   */
  none<T>(this: T): T;
  /**
   * Use `makeHelper` to make a query helper - a function where you can modify the query, and reuse this function across different places.
   *
   * The idea is similar to {@link modify}, the difference is that `modify` is per query, and `makeHelper` can be reused.
   *
   * ```ts
   * const defaultAuthorSelect = db.author.makeHelper((q) => {
   *   return q.select('firstName', 'lastName');
   * });
   *
   * // this will select id, firstName, lastName with a correct TS type
   * // and return a single record
   * const result = await defaultAuthorSelect(db.author.select('id').find(1));
   * ```
   *
   * Such helper is available for relation queries inside `select`:
   *
   * ```ts
   * await db.book.select({
   *   author: (book) => defaultAuthorSelect(book.author),
   * });
   * ```
   *
   * Helper can accept additional arguments:
   *
   * ```ts
   * const selectFollowing = db.user.makeHelper((q, currentUser: { id: number }) => {
   *   return q.select({
   *     following: (q) =>
   *       q.followers.where({ followerId: currentUser.id }).exists(),
   *   });
   * });
   *
   * // select some columns and the `following` boolean field from users
   * await selectFollowing(db.user.select('id', 'name'), currentUser);
   * ```
   *
   * To get the result type of query helper, use `QueryHelperResult` type:
   *
   * ```ts
   * import { QueryHelperResult } from 'orchid-orm';
   *
   * const selectHelper = db.table.makeHelper((q) => q.select('id', 'name'));
   *
   * // This type is identical to `db.table.select('id', 'name')`
   * type SelectQuery = QueryHelperResult<typeof selectHelper>;
   *
   * // Await to get result, the type is `{ id: number, name: string }[]`
   * type Result = Awaited<QueryHelperResult<typeof selectHelper>>;
   * ```
   *
   * @param fn - helper function
   */
  makeHelper<T extends PickQuerySelectableShapeAs, Args extends unknown[], Result extends MergeQueryArg | Expression$1>(this: T, fn: (q: T, ...args: Args) => Result): QueryHelper<T, Args, Result>;
  /**
   * `useHelper` allows to use {@link makeHelper} in different queries:
   *
   * ```ts
   * const helper = db.table.makeHelper((q) => {
   *   // all query methods are available
   *   return q.select('name').where({ active: true }).order({ createdAt: 'DESC' });
   * });
   *
   * const record = await db.table.select('id').useHelper(helper).find(1);
   *
   * record.id; // id was selected before `useHelper`
   * record.name; // name was selected by the function
   * ```
   *
   * When the helper result isn't certain, it will result in a union of all possibilities.
   * Use this sparingly as it complicates dealing with the result.
   *
   * ```ts
   * const helper = db.table.makeHelper((q) => {
   *   if (Math.random() > 0.5) {
   *     return q.select('one');
   *   } else {
   *     return q.select('two');
   *   }
   * });
   *
   * const record = await db.table.useHelper(helper).find(1);
   *
   * // TS error: we don't know for sure if the `one` was selected.
   * record.one;
   *
   * // use `in` operator to disambiguate the result type
   * if ('one' in record) {
   *   record.one;
   * } else {
   *   record.two;
   * }
   * ```
   *
   * You can define and pass parameters:
   *
   * ```ts
   * const helper = db.table.makeHelper((q, select: 'id' | 'name') => {
   *   return q.select(select);
   * });
   *
   * const record = await db.table.useHelper(helper, 'id').find(1);
   * // record has type { id: number } | { name: string }
   * if ('id' in record) {
   *   record.id;
   * }
   * ```
   *
   * @param fn - function to useHelper the query with. The result type will be merged with the main query as if the `merge` method was used.
   * @param args
   */
  useHelper<T extends MergeQueryArg, Fn extends IsQueryHelperForTable<T['table']>>(this: T, fn: Fn, ...args: Fn['__args']): Fn['__result'] extends MergeQueryArg ? MergeQuery$1<T, Fn['__result']> : Fn['__result'];
  /**
   * `modify` is useful when you'd like to modify the query based on some condition.
   *
   * ```ts
   * // parameters coming from outside
   * const selectOneOrAnother = true;
   * const filterBySomething = true;
   *
   * type ResultType =
   *   | { id: number; one: string }[]
   *   | { id: number; another: string }[];
   * const result = await db.table
   *   .select('id')
   *   // conditional select results in a union type
   *   .modify((q) => (includeName ? q.select('one') : q.select('another')))
   *   // can use any query methods in modify
   *   .modify((q) => (filterBySomething ? q.where({ something: true }) : q));
   * ```
   *
   * @param fn - accepts the current query as a parameters. Anything returned by the function will be the return type of the query.
   */
  modify<T, R>(this: T, fn: (q: T) => R): R;
  /**
   * Narrows a part of the query output type.
   * Use with caution, type-safety isn't guaranteed with it.
   * This is similar so using `as` keyword from TypeScript, except that it applies only to a part of the result.
   *
   * The syntax `()<{ ... }>()` is enforced by internal limitations.
   *
   * ```ts
   * const rows = db.table
   *   // filter out records where the `nullableColumn` is null
   *   .where({ nullableColumn: { not: null } });
   *   // narrows only a specified column, the rest of result is unchanged
   *   .narrowType()<{ nullableColumn: string }>()
   *
   * // the column had type `string | null`, now it is `string`
   * rows[0].nullableColumn
   *
   * // imagine that table has a enum column kind with variants 'first' | 'second'
   * // and a boolean `approved`
   * db.table
   *   .where({ kind: 'first', approved: true })
   *   // after applying such `where`, it's safe to narrow the type to receive the literal values
   *   .narrowType()<{ kind: 'first', approved: true }>();
   * ```
   */
  narrowType<T extends NarrowTypeSelf>(this: T): <Narrow>() => T['returnType'] extends undefined | 'all' | 'one' | 'oneOrThrow' ? [NarrowInvalidKeys<T, Narrow>] extends [never] ? { [K in keyof T]: K extends 'result' ? T['result'] & { [K in keyof Narrow]: {
    __outputType: Narrow[K];
  }; } : K extends 'then' ? QueryThenByQuery<T, T['result'] & { [K in keyof Narrow]: {
    __outputType: Narrow[K];
  }; }> : T[K]; } : `narrowType() error: provided type does not extend the '${NarrowInvalidKeys<T, Narrow> & string}' column type` : (T['returnType'] extends 'pluck' ? Narrow extends unknown[] ? Narrow[number] : Narrow : Narrow) extends (T['returnType'] extends 'pluck' ? T['result']['pluck']['__outputType'] : T['result']['value']['__outputType']) ? { [K in keyof T]: K extends 'result' ? T['returnType'] extends 'value' | 'valueOrThrow' ? NarrowValueTypeResult<T, Narrow> : NarrowPluckTypeResult<T, Narrow> : K extends 'then' ? QueryThenByQuery<T, T['returnType'] extends 'value' | 'valueOrThrow' ? NarrowValueTypeResult<T, Narrow> : NarrowPluckTypeResult<T, Narrow>> : T[K]; } : 'narrowType() error: provided type does not extend the returning column column type';
  if<T extends PickQueryResultReturnType, R extends PickQueryResult>(this: T, condition: boolean | null | undefined, fn: (q: T) => R & {
    returnType: T['returnType'];
  }): QueryIfResult<T, R>;
  queryRelated<T extends PickQueryRelations$1, RelName extends keyof T['relations']>(this: T, relName: RelName, params: T['relations'][RelName]['params']): RelationQueryMaybeSingle<T['relations'][RelName]>;
  chain<T extends PickQuerySelectableShapeRelationsReturnTypeIsSubQuery, RelName extends keyof T['relations']>(this: T, relName: RelName): T['__subQuery'] extends true | undefined ? [T['returnType'], T['relations'][RelName]['returnsOne']] extends ['one' | 'oneOrThrow', true] ? { [K in keyof RelationQueryMaybeSingle<T['relations'][RelName]>]: K extends '__selectable' ? RelationQueryMaybeSingle<T['relations'][RelName]>['__selectable'] & Omit<T['__selectable'], keyof T['shape']> : RelationQueryMaybeSingle<T['relations'][RelName]>[K]; } & IsSubQuery : JoinResultRequireMain<T['relations'][RelName]['query'], Omit<T['__selectable'], keyof T['shape']>> : T['relations'][RelName]['query'];
}
interface DbExtension$1 {
  name: string;
  version?: string;
}
interface GeneratorIgnore$1 {
  schemas?: string[];
  enums?: string[];
  domains?: string[];
  extensions?: string[];
  tables?: string[];
  /** Regular views to ignore during migration generation. */
  views?: (string | RegExp)[];
  grants?: Grant.Ignore;
}
interface DbDomainArg$1<ColumnTypes> {
  (columnTypes: ColumnTypes): Column$1;
}
interface DbDomainArgRecord {
  [K: string]: DbDomainArg$1<any>;
}
type SelectableFromShape$1<Shape extends Column$1.QueryColumns, Table extends string | undefined> = { [K in keyof Shape]: {
  as: K;
  column: Shape[K];
}; } & { [K in keyof Shape & string as `${Table}.${K}`]: {
  as: K;
  column: Shape[K];
}; };
type QueryReturnType$1 = QueryReturnTypeAll | 'one' | 'oneOrThrow' | 'rows' | 'pluck' | 'value' | 'valueOrThrow' | 'void';
type QueryReturnTypeAll = undefined | 'all';
type QueryReturnTypeOptional = 'one' | 'value';
interface QueryHasSelect {
  __hasSelect: true;
}
interface IsQuery$1 {
  __isQuery: true;
}
interface IsSubQuery {
  __subQuery: true;
}
interface IsQueries {
  [K: string]: IsQuery$1;
}
interface QueryOrExpression$1<T> {
  result: {
    value: Column$1.Pick.QueryColumnOfType<T>;
  };
}
interface QuerySelectable {
  [K: PropertyKey]: {
    as: string;
    column: Column$1.Pick.QueryColumn;
  };
}
interface Query extends IsQuery$1, PickQueryTable, PickQueryShape$1, PickQuerySelectable, QueryMethods<unknown> {
  __as: string;
  __hasSelect: boolean;
  __hasWhere: boolean;
  __defaults: EmptyObject$1;
  __scopes: EmptyObject$1;
  __defaultSelect: PropertyKey;
  result: Column$1.QueryColumns;
  withData: WithDataItems;
  baseQuery: Query;
  internal: QueryInternal$1;
  returnType: QueryReturnType$1;
  qb: QueryBuilder;
  columnTypes: unknown;
  __inputType: RecordUnknown$1;
  q: QueryData$1;
  then: QueryThen<unknown>;
  catch: QueryCatch$1;
  windows: EmptyObject$1;
  relations: RelationsBase$1;
  relationsDataForCreate: RelationsDataForCreateBase;
  relationsDataForCreateOptional: RelationsDataForCreateOptionalBase;
  relationQueries: IsQueries;
  error: new (message: string, length: number, name: QueryErrorName) => QueryError;
  __readOnly: true | undefined;
  __materialized: true | undefined;
}
declare namespace Query {
  interface NotReadOnlyQuery extends Query {
    __readOnly: undefined;
  }
  interface MaterializedQuery extends Query {
    __materialized: true;
  }
  namespace Order {
    type Arg<T extends Order.ArgThis> = Order.Arg<T>;
    type Args<T extends Order.ArgThis> = Order.Args<T>;
  }
  namespace Pick {
    interface ReturnType {
      returnType: QueryReturnType$1;
    }
    interface SingleValueResult {
      result: {
        value: Column$1.Pick.OutputType;
      };
      returnType: 'value' | 'valueOrThrow';
    }
    interface IsNotReadOnly {
      __readOnly: undefined;
    }
    interface IsMaterialized {
      __materialized: true;
    }
  }
}
type SelectableOfType<T extends PickQuerySelectable, Type> = { [K in keyof T['__selectable']]: T['__selectable'][K]['column']['__type'] extends Type | null ? K : never; }[keyof T['__selectable']];
type SelectableOrExpressionOfType<T extends PickQuerySelectable, C extends Column$1.Pick.Type> = SelectableOfType<T, C['__type']> | Expression$1<Column$1.Pick.QueryColumnOfType<C['__type'] | null>>;
type SetQueryReturnsAll<T extends PickQueryResult> = { [K in keyof T]: K extends 'returnType' ? 'all' : K extends 'then' ? QueryThenShallowSimplifyArr<ColumnsShape$1.Output<T['result']>> : T[K]; } & QueryHasWhere$1;
type SetQueryReturnsAllResult<T extends PickQueryResult, Result extends Column$1.QueryColumns> = { [K in keyof T]: K extends 'returnType' ? 'all' : K extends 'result' ? Result : K extends 'then' ? QueryThenShallowSimplifyArr<T['result']> : T[K]; } & QueryHasWhere$1;
type QueryTakeOptional<T extends PickQueryResultReturnType> = T['returnType'] extends 'value' | 'pluck' | 'void' ? T : T['returnType'] extends 'valueOrThrow' ? { [K in keyof T]: K extends 'returnType' ? 'value' : K extends 'then' ? QueryThen<T['result']['value']['__outputType'] | undefined> : T[K]; } : { [K in keyof T]: K extends 'returnType' ? 'one' : K extends 'then' ? QueryThenShallowSimplifyOptional<ColumnsShape$1.Output<T['result']>> : T[K]; };
type QueryManyTakeOptional$1<T extends PickQueryResultReturnType> = { [K in keyof T]: K extends 'returnType' ? 'one' : K extends 'then' ? QueryThenShallowSimplifyOptional<ColumnsShape$1.Output<T['result']>> : T[K]; };
type QueryRequire<T extends PickQueryResultReturnType> = T['returnType'] extends QueryReturnTypeAll | 'valueOrThrow' | 'pluck' | 'void' ? T : T['returnType'] extends 'value' ? { [K in keyof T]: K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<Exclude<T['result']['value']['__outputType'], undefined>> : T[K]; } : { [K in keyof T]: K extends 'returnType' ? 'oneOrThrow' : K extends 'then' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<T['result']>> : T[K]; };
type QueryTake$1<T extends PickQueryResultReturnType> = T['returnType'] extends 'valueOrThrow' | 'pluck' | 'void' ? T : T['returnType'] extends 'value' ? { [K in keyof T]: K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<Exclude<T['result']['value']['__outputType'], undefined>> : T[K]; } : { [K in keyof T]: K extends 'returnType' ? 'oneOrThrow' : K extends 'then' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<T['result']>> : T[K]; };
type QueryManyTake$1<T extends PickQueryResultReturnType> = { [K in keyof T]: K extends 'returnType' ? 'oneOrThrow' : K extends 'then' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<T['result']>> : T[K]; };
type SetQueryReturnsOne<T extends PickQueryResult> = { [K in keyof T]: K extends 'returnType' ? 'oneOrThrow' : K extends 'then' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<T['result']>> : T[K]; };
type SetQueryReturnsOneResult<T extends PickQueryResult, Result extends Column$1.QueryColumns> = { [K in keyof T]: K extends 'returnType' ? 'oneOrThrow' : K extends 'result' ? Result : K extends 'then' ? QueryThenShallowSimplify$1<ColumnsShape$1.Output<Result>> : T[K]; };
type SetQueryReturnsRows<T extends PickQueryResult> = { [K in keyof T]: K extends 'returnType' ? 'rows' : K extends 'then' ? QueryThen<ColumnsShape$1.Output<T['result']>[keyof T['result']][][]> : T[K]; };
type SetQueryReturnsPluck<T extends PickQuerySelectable, S extends keyof T['__selectable'] | Expression$1> = S extends keyof T['__selectable'] ? { [K in keyof T]: K extends '__hasSelect' ? true : K extends 'result' ? {
  pluck: T['__selectable'][S]['column'];
} : K extends 'returnType' ? 'pluck' : K extends 'then' ? QueryThen<T['__selectable'][S]['column']['__outputType'][]> : T[K]; } : { [K in keyof T]: K extends '__hasSelect' ? true : K extends 'result' ? {
  pluck: S extends Expression$1 ? S['result']['value'] : never;
} : K extends 'returnType' ? 'pluck' : K extends 'then' ? QueryThen<(S extends Expression$1 ? S['result']['value']['__outputType'] : never)[]> : T[K]; };
type SetValueQueryReturnsPluckColumn<T extends PickQueryResult> = { [K in keyof T]: K extends 'result' ? {
  pluck: T['result']['value'];
} : K extends 'returnType' ? 'pluck' : K extends 'then' ? QueryThen<T['result']['value']['__outputType'][]> : T[K]; } & QueryHasSelect;
type SetQueryReturnsPluckColumnResult<T extends PickQueryResult, Result extends Column$1.QueryColumns> = { [K in keyof T]: K extends 'result' ? {
  pluck: T['result']['value'];
} : K extends 'returnType' ? 'pluck' : K extends 'result' ? Result : K extends 'then' ? QueryThen<T['result']['value']['__outputType'][]> : T[K]; } & QueryHasSelect;
type SetQueryReturnsValueOrThrow<T extends PickQuerySelectable, Arg extends keyof T['__selectable']> = SetQueryReturnsColumnOrThrow<T, T['__selectable'][Arg]['column']> & T['__selectable'][Arg]['column']['operators'];
type SetValueQueryReturnsValueOrThrow<T extends PickQueryResult> = { [K in keyof T]: K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<T['result']['value']['__outputType']> : T[K]; };
type SetQueryReturnsValueOptional<T extends PickQuerySelectable, Arg extends GetStringArg<T>> = SetQueryReturnsColumnOptional<T, { [K in keyof T['__selectable'][Arg]['column']]: K extends '__outputType' ? T['__selectable'][Arg]['column'][K] | undefined : T['__selectable'][Arg]['column'][K]; }> & Omit<T['__selectable'][Arg]['column']['operators'], 'equals' | 'not'> & Column$1.OperatorsNullable<T['__selectable'][Arg]['column']>;
type SetQueryReturnsColumnOrThrow<T, Column extends Column.Pick.OutputType> = { [K in keyof T]: K extends 'result' ? {
  value: Column;
} : K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<Column['__outputType']> : T[K]; } & QueryHasSelect;
type SetQueryReturnsColumnOptional<T, Column extends Column.Pick.OutputType> = { [K in keyof T]: K extends 'result' ? {
  value: Column;
} : K extends 'returnType' ? 'value' : K extends 'then' ? QueryThen<Column['__outputType'] | undefined> : T[K]; } & QueryHasSelect;
type SetQueryReturnsColumn<T extends PickQueryResult> = { [K in keyof T]: K extends 'result' ? {
  value: T['result']['pluck'];
} : K extends 'returnType' ? 'valueOrThrow' : K extends 'then' ? QueryThen<T['result']['pluck']['__outputType']> : T[K]; } & QueryHasSelect;
type SetQueryReturnsColumnResult<T extends PickQueryResult, Result extends Column$1.QueryColumns> = { [K in keyof T]: K extends 'result' ? {
  value: T['result']['pluck'];
} : K extends 'returnType' ? 'valueOrThrow' : K extends 'result' ? Result : K extends 'then' ? QueryThen<Result['pluck']['__outputType']> : T[K]; } & QueryHasSelect;
type SetQueryReturnsRowCount<T extends PickQueryResult> = { [K in keyof T]: K extends 'returnType' ? 'valueOrThrow' : K extends 'result' ? {
  value: Column$1.Pick.QueryColumnOfType<number>;
} : K extends 'then' ? QueryThen<number> : T[K]; };
type SetQueryReturnsRowCountMany<T extends PickQueryResult> = { [K in keyof T]: K extends 'returnType' ? 'pluck' : K extends 'result' ? {
  pluck: Column$1.Pick.QueryColumnOfType<number>;
} : K extends 'then' ? QueryThen<number> : T[K]; };
type SetQueryReturnsVoid<T> = { [K in keyof T]: K extends 'returnType' ? 'void' : K extends 'then' ? QueryThen<void> : T[K]; };
type SetQueryResult<T extends PickQueryReturnType, Result extends Column$1.QueryColumns> = { [K in keyof T]: K extends 'result' ? Result : K extends 'then' ? QueryThenByQuery<T, Result> : T[K]; };
interface QueryOrExpressionBooleanOrNullResult {
  result: {
    value: Column$1.Pick.QueryColumnOfType<boolean | null>;
  };
}
declare namespace Column$1 {
  export interface IsPrimaryKey<Name extends string> {
    data: {
      primaryKey: Name;
    };
  }
  export type IsUnique<Name extends string> = {
    data: {
      unique: Name;
    };
  };
  export type Nullable<T extends Column.Pick.ForNullable> = { [K in keyof T]: K extends '__type' ? T['__type'] | null : K extends '__inputType' ? T['__inputType'] | null : K extends '__outputType' ? T['__outputType'] | (unknown extends T['__nullType'] ? null : T['__nullType']) : K extends '__queryType' ? T['__queryType'] | null : K extends 'data' ? T['data'] & DataNullable : K extends 'operators' ? { [K in keyof T['operators']]: K extends 'equals' | 'not' | 'isDistinctFrom' | 'isNotDistinctFrom' ? Operator<T['__queryType'] | null, T> : T['operators'][K]; } : T[K]; };
  export type NullableWithSchema<T extends Column.Pick.ForNullable, InputSchema, OutputSchema, QuerySchema> = { [K in keyof T]: K extends '__type' ? T['__type'] | null : K extends '__inputType' ? T['__inputType'] | null : K extends 'inputSchema' ? InputSchema : K extends '__outputType' ? T['__outputType'] | (unknown extends T['__nullType'] ? null : T['__nullType']) : K extends 'outputSchema' ? OutputSchema : K extends '__queryType' ? T['__queryType'] | null : K extends 'querySchema' ? QuerySchema : K extends 'data' ? T['data'] & DataNullable : K extends 'operators' ? { [K in keyof T['operators']]: K extends 'equals' | 'not' | 'isDistinctFrom' | 'isNotDistinctFrom' ? Operator<T['__queryType'] | null, T> : T['operators'][K]; } : T[K]; };
  export type QueryColumnToNullable<C> = { [K in keyof C]: K extends '__outputType' | '__queryType' ? C[K] | null : C[K]; };
  export type QueryColumnToOptional<C> = { [K in keyof C]: K extends '__outputType' ? C[K] | undefined : C[K]; };
  interface DataNullable {
    isNullable: true;
    optional: true;
  }
  export interface OperatorsNullable<Column extends Column.Pick.QueryColumn> {
    equals: Operator<Column['__queryType'] | null, Column>;
    not: Operator<Column['__queryType'] | null, Column>;
    isDistinctFrom: Operator<Column['__queryType'] | null, Column>;
    isNotDistinctFrom: Operator<Column['__queryType'] | null, Column>;
  }
  export type Encode<T, InputSchema, Input> = { [K in keyof T]: K extends '__inputType' ? Input : K extends 'inputSchema' ? InputSchema : T[K]; };
  export type Parse<T extends Pick.ForParse, OutputSchema, Output> = { [K in keyof T]: K extends '__outputType' ? null extends T['__type'] ? (Output extends null ? never : Output) | (unknown extends T['__nullType'] ? null : T['__nullType']) : Output : K extends 'outputSchema' ? null extends T['__type'] ? OutputSchema | T['nullSchema'] : OutputSchema : T[K]; };
  export type ParseNull<T extends Column.Pick.ForParseNull, NullSchema, NullType> = { [K in keyof T]: K extends '__outputType' ? null extends T['__type'] ? Exclude<T['__outputType'], null> | NullType : T['__outputType'] : K extends '__nullType' ? NullType : K extends 'outputSchema' ? null extends T['__type'] ? T['outputSchema'] | NullSchema : T['outputSchema'] : K extends 'nullSchema' ? NullSchema : T[K]; };
  export type HasDefault<T extends Column.Pick.Data> = T & Column.Data.Default;
  type DefaultSelectData<T extends Column.Data, Value> = { [K in keyof T]: K extends 'explicitSelect' ? Value extends true ? false : true : T[K]; };
  export type DefaultSelect<T extends Column.Pick.Data, Value extends boolean> = { [K in keyof T]: K extends 'data' ? DefaultSelectData<T['data'], Value> : T[K]; };
  export interface IsAppReadOnly {
    data: {
      appReadOnly: true;
    };
  }
  export type Generated<T extends Column.Pick.Data> = { [K in keyof T]: K extends 'data' ? { [K in keyof T['data']]: K extends 'default' ? true : T['data'][K]; } : K extends '__inputType' ? never : T[K]; };
  export interface Branded<Token extends true | string = true> {
    data: {
      branded: Token;
    };
  }
  export namespace Pick {
    interface Data {
      data: Column.Data;
    }
    interface Type {
      __type: unknown;
    }
    interface OutputType {
      __outputType: unknown;
    }
    interface InputType {
      __inputType: unknown;
    }
    interface DataAndInputType extends Data, InputType {}
    interface NullType {
      __nullType: unknown;
    }
    interface OutputTypeAndOperators extends OutputType {
      operators: unknown;
    }
    interface DataAndDataType extends Data {
      dataType: string;
    }
    interface QueryColumn extends OutputType {
      dataType: string;
      __type: unknown;
      __queryType: unknown;
      operators: any;
    }
    interface QueryColumnOfType<T> {
      dataType: string;
      __type: T;
      __outputType: T;
      __queryType: T;
      operators: any;
    }
    interface QueryColumnOfTypeAndOps<DataType, T, Ops> {
      dataType: DataType;
      __type: T;
      __outputType: T;
      __queryType: T;
      operators: Ops;
    }
    interface QueryColumnOfDataType<T extends string> extends QueryColumn {
      dataType: T;
    }
    interface QueryInit extends QueryColumn, InputType {
      data: Column.QueryData;
    }
    interface OutputSchema {
      outputSchema: any;
    }
    interface NullSchema {
      nullSchema: any;
    }
    interface TypeSchemas extends OutputSchema, NullSchema {
      inputSchema: any;
      querySchema: any;
    }
    interface ForNullable extends Data, Type, InputType, OutputType, TypeSchemas {
      __nullType: unknown;
      __queryType: unknown;
      operators: unknown;
    }
    interface ForParse extends Type, NullType, NullSchema {}
    interface ForParseNull extends Type, OutputType, OutputSchema {}
    interface ForValidation extends TypeSchemas, DataAndDataType {}
  }
  export namespace Shape {
    interface Data {
      [K: string]: Column.Pick.Data;
    }
    interface QueryInit {
      [K: string]: Column.Pick.QueryInit;
    }
    interface ForValidation {
      [K: string]: Column.Pick.ForValidation;
    }
  }
  export interface QueryColumns {
    [K: string]: Column.Pick.QueryColumn;
  }
  export interface QueryColumnsInit {
    [K: string]: Pick.QueryInit;
  }
  export namespace ForeignKey {
    interface TableParamInstance {
      schema?: string;
      table: string;
      nameInDb?: string;
      columns: {
        shape: unknown;
      };
    }
    interface TableParamInstanceInput {
      schema?: QuerySchema;
      table?: string;
      nameInDb?: string;
      columns: {
        shape: unknown;
      };
    }
    interface TableParamWithInstance {
      instance(): TableParamInstanceInput;
    }
    interface TableParamWithData {
      data: {
        columns: unknown;
      };
      instance(): TableParamInstanceInput;
    }
    type TableParam = (new () => TableParamInstance) | TableParamWithInstance | TableParamWithData;
    type ColumnNameOfTable<Table extends Column.ForeignKey.TableParam> = Table extends {
      data: {
        columns: infer R;
      };
    } ? keyof R : Table extends {
      instance(): {
        columns: {
          shape: infer R;
        };
      };
    } ? keyof R : Table extends (new () => {
      columns: {
        shape: infer R;
      };
    }) ? keyof R : never;
  }
  export namespace Error {
    interface Messages {
      required?: string;
      invalidType?: string;
    }
    interface Message {
      message?: string;
    }
    type StringOrMessage = string | Message;
  }
  export interface InputOutputQueryTypes {
    __inputType: unknown;
    __outputType: unknown;
    __queryType: unknown;
  }
  export interface InputOutputQueryTypesWithSchemas extends InputOutputQueryTypes {
    inputSchema: unknown;
    outputSchema: unknown;
    querySchema: unknown;
  }
  export interface QueryData {
    explicitSelect?: boolean;
    primaryKey?: string;
    unique?: string;
    optional?: true;
    isNullable?: true;
    default?: unknown;
    name?: string;
    readOnly?: boolean;
    appReadOnly: true | undefined;
    branded: true | string | undefined;
  }
  export interface Data extends ColumnDataComputedProp {
    key: string;
    name?: string;
    optional: true | undefined;
    isNullable?: true;
    primaryKey?: string;
    default: unknown;
    defaultDefault: unknown;
    runtimeDefault?(): unknown;
    explicitSelect?: boolean;
    as?: Column.Pick.Data;
    unique?: string;
    modifyQuery?(q: Query, column: Column.Pick.Data): void;
    checks?: Column.Data.Check[];
    isOfCustomType?: boolean;
    errors?: RecordString$1;
    defaultTimestamp?: 'createdAt' | 'updatedAt';
    alias?: string;
    extension?: string;
    encode?(input: any): unknown;
    parse?(input: any): unknown;
    parseItem?(input: string): unknown;
    parseNull?(): unknown;
    jsonCast?: string;
    readOnly?: boolean;
    appReadOnly: true | undefined;
    setOnCreate?(arg: QueryHookUtils$1<PickQueryInputType$1>): unknown;
    setOnUpdate?(arg: QueryHookUtils$1<PickQueryInputType$1>): unknown;
    setOnSave?(arg: QueryHookUtils$1<PickQueryInputType$1>): unknown;
    typmod?: number;
    virtual?: true;
    maxChars?: number;
    numericPrecision?: number;
    numericScale?: number;
    dateTimePrecision?: number;
    validationDefault?: unknown;
    indexes?: TableData$1.ColumnIndex[];
    excludes?: TableData$1.ColumnExclude[];
    comment?: string;
    collate?: string;
    compression?: string;
    foreignKeys?: TableData$1.ColumnReferences[];
    identity?: TableData$1.Identity;
    generated?: Data.Generated;
    readonly?: boolean;
    valueToArray?: boolean;
    skipValueToArray?: boolean;
    branded: true | string | undefined;
  }
  export namespace Data {
    interface Default {
      data: {
        default: true;
        optional: true;
      };
    }
    interface Check {
      sql: RawSqlBase$1;
      name?: string;
    }
    interface Generated {
      toSQL(ctx: {
        values: unknown[];
        snakeCase: boolean | undefined;
      }, quotedAs?: string): string;
      toCode(): string;
    }
  }
  interface AsTypeArgWithType<Schema> {
    type: Schema;
    input?: Schema;
    output?: Schema;
    query?: Schema;
  }
  interface AsTypeArgWithoutType<Schema> {
    input: Schema;
    output: Schema;
    query: Schema;
  }
  export type AsTypeArg<Schema> = AsTypeArgWithType<Schema> | AsTypeArgWithoutType<Schema>;
  export {};
}
declare const getForeignKeyTableInstance: (table: Column$1.ForeignKey.TableParam) => Column$1.ForeignKey.TableParamInstance;
declare abstract class Column$1 {
  abstract __schema: ColumnTypeSchemaArg$1;
  abstract dataType: string;
  abstract operators: any;
  abstract toCode(ctx: ColumnToCodeCtx$1, key: string): Code$1;
  abstract __type: unknown;
  abstract __inputType: unknown;
  abstract __outputType: unknown;
  abstract __queryType: unknown;
  __nullType: unknown;
  nullSchema: unknown;
  abstract inputSchema: unknown;
  abstract outputSchema: unknown;
  abstract querySchema: unknown;
  data: Column.Data;
  error: this['__schema']['error'];
  _parse?: (input: unknown) => unknown;
  constructor(schema: ColumnTypeSchemaArg$1, inputSchema: unknown, outputSchema?: unknown, querySchema?: unknown);
  /**
   * Set a default value to a column. Columns that have defaults become optional when creating a record.
   *
   * If you provide a value or a raw SQL, such default should be set on the column in migration to be applied on a database level.
   *
   * Or you can specify a callback that returns a value. This function will be called for each creating record. Such a default won't be applied to a database.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   // values as defaults:
   *   int: t.integer().default(123),
   *   text: t.text().default('text'),
   *
   *   // raw SQL default:
   *   timestamp: t.timestamp().default(t.sql`now()`),
   *
   *   // runtime default, each new records gets a new random value:
   *   random: t.numeric().default(() => Math.random()),
   * }));
   * ```
   *
   * @param value - default value or a function returning a value
   */
  default<T extends Column.Pick.DataAndInputType, Value extends T['__inputType'] | null | RawSqlBase$1 | (() => T['__inputType'])>(this: T, value: Value): Column.HasDefault<T>;
  /**
   * Use `hasDefault` to let the column be omitted when creating records.
   *
   * It's better to use {@link default} instead so the value is explicit and serves as a hint.
   */
  hasDefault<T extends Column.Pick.Data>(this: T): Column.HasDefault<T>;
  /**
   * Set a database-level validation check to a column. `check` accepts a raw SQL.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     // validate rank to be from 1 to 10
   *     rank: t.integer().check(t.sql`1 >= "rank" AND "rank" <= 10`),
   *     // constraint name can be passed as a second argument
   *     column: t.integer().check(t.sql`...`, 'check_name'),
   *     // a single column can have multiple checks
   *     multiChecksColumn: t
   *       .integer()
   *       .check(t.sql`...`)
   *       .check(t.sql`...`, 'optional_name'),
   *   }));
   * });
   * ```
   *
   * @param sql - raw SQL expression
   * @param name - to specify a constraint name
   */
  check<T extends Column.Pick.Data>(this: T, sql: RawSqlBase$1, name?: string): T;
  /**
   * Use `nullable` to mark the column as nullable. By default, all columns are required.
   *
   * Nullable columns are optional when creating records.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   name: t.integer().nullable(),
   * }));
   * ```
   */
  nullable: this['__schema']['nullable'];
  /**
   * Set a custom function to process value for the column when creating or updating a record.
   *
   * The type of `input` argument will be used as the type of the column when creating and updating.
   *
   * If you have a validation library [installed and configured](/guide/columns-validation-methods.html),
   * first argument is a schema to validate the input.
   *
   * ```ts
   * import { z } from 'zod';
   *
   * export const Table = defineTable('table', (t) => ({
   *   // encode boolean, number, or string to text before saving
   *   column: t
   *     .string()
   *     // when having validation library, the first argument is a validation schema
   *     .encode(
   *       z.boolean().or(z.number()).or(z.string()),
   *       (input: boolean | number | string) => String(input),
   *     )
   *     // no schema argument otherwise
   *     .encode((input: boolean | number | string) => String(input)),
   * }));
   *
   * // numbers and booleans will be converted to a string:
   * await db.table.create({ column: 123 });
   * await db.table.create({ column: true });
   * await db.table.where({ column: 'true' }).update({ column: false });
   * ```
   *
   * @param fn - function to encode value for a database, argument type is specified by you, return type must be compatible with a database
   */
  encode: this['__schema']['encode'];
  /**
   * Set a custom function to process value after loading it from a database.
   *
   * The type of input is the type of column before `.parse`, the resulting type will replace the type of column.
   *
   * If you have a validation library [installed and configured](/guide/columns-validation-methods.html),
   * first argument is a schema for validating the output.
   *
   * For handling `null` values use {@link parseNull} instead or in addition.
   *
   * ```ts
   * import { z } from 'zod';
   * import { number, integer } from 'valibot';
   *
   * export const Table = defineTable('table', (t) => ({
   *   columnZod: t
   *     .string()
   *     // when having validation library, the first argument is a schema
   *     .parse(z.number().int(), (input) => parseInt(input))
   *     // no schema argument otherwise
   *     .parse((input) => parseInt(input)),
   *
   *   columnValibot: t
   *     .string()
   *     .parse(number([integer()]), (input) => parseInt(input))
   *     .parse((input) => parseInt(input)),
   * }));
   *
   * // column will be parsed to a number
   * const value: number = await db.table.get('column');
   * ```
   *
   * @param fn - function to parse a value from the database, argument is the type of this column, return type is up to you
   */
  parse: this['__schema']['parse'];
  /**
   * Use `parseNull` to specify runtime defaults at selection time.
   *
   * The `parseNull` function is only triggered for `nullable` columns.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   column: t
   *     .integer()
   *     .parse(String) // parse non-nulls to string
   *     .parseNull(() => false), // replace nulls with false
   *     .nullable(),
   * }));
   *
   * const record = await db.table.take()
   * record.column // can be a string or boolean, not null
   * ```
   *
   * If you have a validation library [installed and configured](/guide/columns-validation-methods),
   * first argument is a schema for validating the output.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   column: t
   *     .integer()
   *     .parse(z.string(), String) // parse non-nulls to string
   *     .parseNull(z.literal(false), () => false) // replace nulls with false
   *     .nullable(),
   * }));
   *
   * const record = await db.table.take();
   * record.column; // can be a string or boolean, not null
   *
   * Table.outputSchema().parse({
   *   column: false, // the schema expects strings or `false` literals, not nulls
   * });
   * ```
   */
  parseNull: this['__schema']['parseNull'];
  /**
   * This method changes a column type without modifying its behavior.
   * This is needed when converting columns to a validation schema, the converter will pick a different type specified by `.as`.
   *
   * Before calling `.as` need to use `.encode` with the input of the same type as the input of the target column,
   * and `.parse` which returns the correct type.
   *
   * ```ts
   * // column has the same type as t.integer()
   * const column = t
   *   .string()
   *   .encode((input: number) => input)
   *   .parse((text) => parseInt(text))
   *   .as(t.integer());
   * ```
   *
   * @param column - other column type to inherit from
   */
  as<T extends {
    __inputType: unknown;
    __outputType: unknown;
    data: Column.Data;
  }, C extends {
    __inputType: T['__inputType'];
    __outputType: T['__outputType'];
  }>(this: T, column: C): C;
  /**
   * @deprecated use narrowType instead
   */
  asType: this['__schema']['asType'];
  /**
   * `narrowType` narrows TypeScript types of a column. It sets input, output, query type altogether.
   *
   * For example, to narrow a `string` type to a union of string literals.
   *
   * When _not_ integrating with [validation libraries](/guide/columns-validation-methods), `narrowType` has the following syntax:
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   size: t.string().narrowType((t) => t<'small' | 'medium' | 'large'>()),
   * }));
   *
   * // size will be typed as 'small' | 'medium' | 'large'
   * const size = await db.table.get('size');
   * ```
   *
   * - `input` is for `create`, `update` methods.
   * - `output` is for the data that is loaded from a database and parsed if the column has `parse`.
   * - `query` is used in `where` and other query methods, it should be compatible with the actual database column type.
   *
   * When integrating with a [validation library](/guide/columns-validation-methods), also provide validation schemas:
   *
   * ```ts
   * const sizeSchema = z.union([
   *   z.literal('small'),
   *   z.literal('medium'),
   *   z.literal('large'),
   * ]);
   *
   * export const Table = defineTable('table', (t) => ({
   *   size: t.text().narrowType(sizeSchema),
   * }));
   *
   * // size will be typed as 'small' | 'medium' | 'large'
   * const size = await db.table.get('size');
   * ```
   *
   */
  narrowType: this['__schema']['narrowType'];
  /**
   * Allows to narrow different TypeScript types of a column granularly.
   *
   * Use it when the column's input is different from output.
   *
   * When _not_ integrating with [validation libraries](/guide/columns-validation-methods), `narrowAllTypes` has the following syntax:
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   size: t.string().narrowAllTypes((t) =>
   *     t<{
   *       // what types are accepted when creating/updating
   *       input: 'small' | 'medium' | 'large';
   *       // how types are retured from a database
   *       output: 'small' | 'medium' | 'large';
   *       // what types the column accepts in `where` and similar
   *       query: 'small' | 'medium' | 'large';
   *     }>(),
   *   ),
   * }));
   *
   * // size will be typed as 'small' | 'medium' | 'large'
   * const size = await db.table.get('size');
   * ```
   *
   * - `input` is for `create`, `update` methods.
   * - `output` is for the data that is loaded from a database and parsed if the column has `parse`.
   * - `query` is used in `where` and other query methods, it should be compatible with the actual database column type.
   *
   * When integrating with a [validation library](/guide/columns-validation-methods), also provide validation schemas:
   *
   * ```ts
   * const sizeSchema = z.union([
   *   z.literal('small'),
   *   z.literal('medium'),
   *   z.literal('large'),
   * ]);
   *
   * export const Table = defineTable('table', (t) => ({
   *   size: t.text().narrowAllTypes({
   *     input: sizeSchema,
   *     output: sizeSchema,
   *     query: sizeSchema,
   *   }),
   * }));
   *
   * // size will be typed as 'small' | 'medium' | 'large'
   * const size = await db.table.get('size');
   * ```
   *
   * @deprecated use `type`, `inputType`, `outputType`, `queryType` instead
   */
  narrowAllTypes: this['__schema']['narrowAllTypes'];
  brand<T, Token extends true | string = true>(this: T, _token?: Token): T & Column.Branded<Token>;
  input<T extends {
    inputSchema: unknown;
  }, InputSchema extends this['__schema']['__schemaType']>(this: T, fn: (schema: T['inputSchema']) => InputSchema): { [K in keyof T]: K extends 'inputSchema' ? InputSchema : T[K]; };
  output<T extends {
    outputSchema: unknown;
  }, OutputSchema extends this['__schema']['__schemaType']>(this: T, fn: (schema: T['outputSchema']) => OutputSchema): { [K in keyof T]: K extends 'outputSchema' ? OutputSchema : T[K]; };
  query<T extends {
    querySchema: unknown;
  }, QuerySchema extends this['__schema']['__schemaType']>(this: T, fn: (schema: T['querySchema']) => QuerySchema): { [K in keyof T]: K extends 'querySchema' ? QuerySchema : T[K]; };
  /**
   * Set a database column name.
   *
   * @param name - name of the column in database.
   */
  name<T extends Column.Pick.Data>(this: T, name: string): T;
  /**
   * Append `select(false)` to a column to exclude it from the default selection.
   * It won't be selected with `selectAll` or `select('*')` as well.
   *
   * ```ts
   * export const UserTable = defineTable('user', (t) => ({
   *   id: t.identity().primaryKey(),
   *   name: t.string(),
   *   password: t.string().select(false),
   * }));
   *
   * // only id and name are selected, without password
   * const user = await db.user.find(123);
   *
   * // password is still omitted, even with the wildcard
   * const same = await db.user.find(123).select('*');
   *
   * const comment = await db.comment.find(123).select({
   *   // password is omitted in the sub-selects as well
   *   author: (q) => q.author,
   * });
   *
   * // password is omitted here as well
   * const created = await db.user.create(userData);
   * ```
   *
   * Such a column can only be selected explicitly.
   *
   * ```ts
   * const userWithPassword = await db.user.find(123).select('*', 'password');
   * ```
   */
  select<T extends Column.Pick.Data, Value extends boolean>(this: T, value: Value): Column.DefaultSelect<T, Value>;
  /**
   * Set SQL to use when selecting this column.
   *
   * The column remains a regular writable database column. Create, update,
   * filters, ordering, grouping, and migrations still use the physical column.
   */
  selectSql<T extends Column.Pick.DataAndDataType, Expr extends Expression$1>(this: T, fn: (column: ColumnRefExpression$1<T & Column.Pick.QueryColumn>) => Expr): SelectSqlColumn$1<T, Expr>;
  /**
   * Forbid the column to be used in [create](/guide/create-update-delete.html#create-insert) and [update](/guide/create-update-delete.html#update) methods.
   *
   * `readOnly` column is still can be set from a [hook](http://localhost:5173/guide/hooks.html#set-values-before-create-or-update).
   *
   * `readOnly` column can be used together with a `default`.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   id: t.identity().primaryKey(),
   *   column: t.string().default(() => 'default value'),
   *   another: t.string().nullable().readOnly(),
   * })).init((orm: typeof db, hooks) => {
   *   hooks.beforeSave(({ columns, set }) => {
   *     if (columns.include('column')) {
   *       set({ another: 'value' });
   *     }
   *   });
   * });
   *
   * // later in the code
   * db.table.create({ column: 'value' }); // TS error, runtime error
   * ```
   */
  readOnly<T>(this: T): T & Column.IsAppReadOnly;
  /**
   * Set a column value when creating a record.
   * This works for [readOnly](#readonly) columns as well.
   *
   * If no value or undefined is returned, the hook won't have any effect.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   id: t.identity().primaryKey(),
   *   some: t.number(),
   *   column: t
   *     .string()
   *     .setOnCreate(({ columns }) =>
   *       columns.include('some') ? 'value' : undefined,
   *     ),
   * }));
   * ```
   */
  setOnCreate<T extends Column.Pick.QueryInit>(this: T, fn: (arg: QueryHookUtils$1<PickQueryInputType$1>) => T['__inputType'] | void): T;
  /**
   * Set a column value when updating a record.
   * This works for [readOnly](#readonly) columns as well.
   *
   * If no value or undefined is returned, the hook won't have any effect.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   id: t.identity().primaryKey(),
   *   some: t.number(),
   *   column: t
   *     .string()
   *     .setOnUpdate(({ columns }) =>
   *       columns.include('some') ? 'value' : undefined,
   *     ),
   * }));
   * ```
   */
  setOnUpdate<T extends Column.Pick.QueryInit>(this: T, fn: (arg: QueryHookUtils$1<PickQueryInputType$1>) => T['__inputType'] | void): T;
  /**
   * Set a column value when creating or updating a record.
   * This works for [readOnly](#readonly) columns as well.
   *
   * If no value or undefined is returned, the hook won't have any effect.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   id: t.identity().primaryKey(),
   *   some: t.number(),
   *   column: t
   *     .string()
   *     .setOnSave(({ columns }) =>
   *       columns.include('some') ? 'value' : undefined,
   *     ),
   * }));
   * ```
   */
  setOnSave<T extends Column.Pick.QueryInit>(this: T, fn: (arg: QueryHookUtils$1<PickQueryInputType$1>) => T['__inputType'] | void): T;
  /**
   * Mark the column as a primary key.
   * This column type becomes an argument of the `.find` method.
   * So if the primary key is of `integer` type (`identity` or `serial`), `.find` will accept the number,
   * or if the primary key is of `UUID` type, `.find` will expect a string.
   *
   * Using `primaryKey` on a `uuid` column will automatically add a [gen_random_uuid](https://www.postgresql.org/docs/current/functions-uuid.html) default.
   *
   * ```ts
   * export const Table = defineTable('table', (t) => ({
   *   id: t.uuid().primaryKey(),
   *   // optionally, specify a database-level constraint name:
   *   id: t.uuid().primaryKey('primary_key_name'),
   * }));
   *
   * // primary key can be used by `find` later:
   * db.table.find('97ba9e78-7510-415a-9c03-23d440aec443');
   * ```
   *
   * @param name - to specify a constraint name
   */
  primaryKey<T extends Column.Pick.Data, Name extends string>(this: T, name?: Name): T & Column.IsPrimaryKey<Name>;
  /**
   * Defines a reference between different tables to enforce data integrity.
   *
   * In [snakeCase](/guide/orm-and-query-builder.html#snakecase-option) mode, columns of both tables are translated to a snake_case.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     otherId: t.integer().foreignKey('otherTableName', 'columnName'),
   *   }));
   * });
   * ```
   *
   * In the migration it's different from OrchidORM table code where a callback with a table is expected:
   *
   * ```ts
   * export const SomeTable = defineTable('someTable', (t) => ({
   *   otherTableId: t.integer().foreignKey(() => OtherTable, 'id'),
   * }));
   * ```
   *
   * Optionally you can pass the third argument to `foreignKey` with options:
   *
   * ```ts
   * type ForeignKeyOptions = {
   *   // name of the constraint
   *   name?: string;
   *   // see database docs for MATCH in FOREIGN KEY
   *   match?: 'FULL' | 'PARTIAL' | 'SIMPLE';
   *
   *   onUpdate?: 'NO ACTION' | 'RESTRICT' | 'CASCADE' | 'SET NULL' | 'SET DEFAULT';
   *   onDelete?: 'NO ACTION' | 'RESTRICT' | 'CASCADE' | 'SET NULL' | 'SET DEFAULT';
   * };
   * ```
   *
   * ## composite foreign key
   *
   * Set foreign key from multiple columns in the current table to corresponding columns in the other table.
   *
   * The first argument is an array of columns in the current table, the second argument is another table name, the third argument is an array of columns in another table, and the fourth argument is for options.
   *
   * Options are the same as in a single-column foreign key.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     id: t.integer(),
   *     name: t.string(), // string is varchar(255)
   *     ...t.foreignKey(
   *       ['id', 'name'],
   *       'otherTable',
   *       ['foreignId', 'foreignName'],
   *       {
   *         name: 'constraintName',
   *         match: 'FULL',
   *         onUpdate: 'RESTRICT',
   *         onDelete: 'CASCADE',
   *       },
   *     ),
   *   }));
   * });
   * ```
   *
   * @param fn - function returning a table class
   * @param column - column in the foreign table to connect with
   * @param options - {@link ForeignKeyOptions}
   */
  foreignKey<T, Table extends Column.ForeignKey.TableParam>(this: T, fn: () => Table, column: Column.ForeignKey.ColumnNameOfTable<Table>, options?: TableData$1.References.Options): T;
  foreignKey<T, Table extends string, Column extends string>(this: T, table: Table, column: Column, options?: TableData$1.References.Options): T;
  toSQL(): string;
  /**
   * Add an index to the column.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     // add an index to the name column with default settings:
   *     name: t.text().index(),
   *     // options are described below:
   *     name: t.text().index({ ...options }),
   *     // with a database-level name:
   *     name: t.text().index({ name: 'custom_index_name', ...indexOptions }),
   *   }));
   * });
   * ```
   *
   * Possible options are:
   *
   * ```ts
   * type IndexOptions = {
   *   name?: string,
   *   // NULLS NOT DISTINCT: availabe in Postgres 15+, makes sense only for unique index
   *   nullsNotDistinct?: true;
   *   // index algorithm to use such as GIST, GIN
   *   using?: string;
   *   // specify collation:
   *   collate?: string;
   *   // see `opclass` in the Postgres document for creating the index
   *   opclass?: string;
   *   // specify index order such as ASC NULLS FIRST, DESC NULLS LAST
   *   order?: string;
   *   // include columns to an index to optimize specific queries
   *   include?: MaybeArray<string>;
   *   // see "storage parameters" in the Postgres document for creating an index, for example, 'fillfactor = 70'
   *   with?: string;
   *   // The tablespace in which to create the index. If not specified, default_tablespace is consulted, or temp_tablespaces for indexes on temporary tables.
   *   tablespace?: string;
   *   // WHERE clause to filter records for the index
   *   where?: string;
   *   // mode is for dropping the index
   *   mode?: 'CASCADE' | 'RESTRICT';
   * };
   * ```
   *
   * @param args
   */
  index<T extends Column.Pick.Data>(this: T, ...args: [options?: TableData$1.Index.ColumnArg]): T;
  /**
   * `searchIndex` is designed for [full text search](/guide/text-search).
   *
   * It can accept the same options as a regular `index`, but it is `USING GIN` by default, and it is concatenating columns into a `tsvector` database type.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     id: t.identity().primaryKey(),
   *     title: t.text(),
   *     body: t.text(),
   *     ...t.searchIndex(['title', 'body']),
   *   }));
   * });
   * ```
   *
   * Produces the following index ('english' is a default language, see [full text search](/guide/text-search.html#language) for changing it):
   *
   * ```sql
   * CREATE INDEX "table_title_body_idx" ON "table" USING GIN (to_tsvector('english', "title" || ' ' || "body"))
   * ```
   *
   * You can set different search weights (`A` to `D`) on different columns inside the index:
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     id: t.identity().primaryKey(),
   *     title: t.text(),
   *     body: t.text(),
   *     ...t.searchIndex([
   *       { column: 'title', weight: 'A' },
   *       { column: 'body', weight: 'B' },
   *     ]),
   *   }));
   * });
   * ```
   *
   * When the table has localized columns,
   * you can define different indexes for different languages by setting the `language` parameter:
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     id: t.identity().primaryKey(),
   *     titleEn: t.text(),
   *     bodyEn: t.text(),
   *     titleFr: t.text(),
   *     bodyFr: t.text(),
   *     ...t.searchIndex(['titleEn', 'bodyEn'], { language: 'english' }),
   *     ...t.searchIndex(['titleFr', 'bodyFr'], { language: 'french' }),
   *   }));
   * });
   * ```
   *
   * Alternatively, different table records may correspond to a single language,
   * then you can define a search index that relies on a language column by using `languageColumn` parameter:
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     id: t.identity().primaryKey(),
   *     lang: t.type('regconfig'),
   *     title: t.text(),
   *     body: t.text(),
   *     ...t.searchIndex(['title', 'body'], { languageColumn: 'lang' }),
   *   }));
   * });
   * ```
   *
   * It can be more efficient to use a [generated](/guide/migration-column-methods.html#generated-column) column instead of indexing text column in the way described above,
   * and to set a `searchIndex` on it:
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     id: t.identity().primaryKey(),
   *     title: t.text(),
   *     body: t.text(),
   *     generatedTsVector: t.tsvector().generated(['title', 'body']).searchIndex(),
   *   }));
   * });
   * ```
   *
   * Produces the following index:
   *
   * ```sql
   * CREATE INDEX "table_generatedTsVector_idx" ON "table" USING GIN ("generatedTsVector")
   * ```
   *
   * @param options - index options
   */
  searchIndex<T extends {
    data: Column['data'];
    dataType: string;
  }>(this: T, ...args: [options?: TableData$1.Index.TsVectorColumnArg]): T;
  unique<T extends Column.Pick.Data, const Options extends TableData$1.Index.UniqueColumnArg>(this: T, ...args: [options?: Options]): T & Column.IsUnique<Options['name'] & string>;
  /**
   * Add [EXCLUDE constraint](https://www.postgresql.org/docs/current/sql-createtable.html#SQL-CREATETABLE-EXCLUDE) to the column.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     // exclude rows with overlapping time ranges, && is for the `WITH` operator
   *     timeRange: t.type('tstzrange').exclude('&&'),
   *     // with a database-level name:
   *     timeRange: t.type('tstzrange').exclude('&&', 'no_overlap'),
   *     // with options:
   *     timeRange: t.type('tstzrange').exclude('&&', { ...options }),
   *     // with name and options:
   *     name: t.type('tstzrange').exclude('&&', 'no_overlap', { ...options }),
   *   }));
   * });
   * ```
   *
   * Possible options are:
   *
   * ```ts
   * interface ExcludeColumnOptions {
   *   // specify collation:
   *   collate?: string;
   *   // see `opclass` in the Postgres document for creating the index
   *   opclass?: string;
   *   // specify index order such as ASC NULLS FIRST, DESC NULLS LAST
   *   order?: string;
   *   // algorithm to use such as GIST, GIN
   *   using?: string;
   *   // EXCLUDE creates an index under the hood, include columns to the index
   *   include?: MaybeArray<string>;
   *   // see "storage parameters" in the Postgres document for creating an index, for example, 'fillfactor = 70'
   *   with?: string;
   *   // The tablespace in which to create the constraint. If not specified, default_tablespace is consulted, or temp_tablespaces for indexes on temporary tables.
   *   tablespace?: string;
   *   // WHERE clause to filter records for the constraint
   *   where?: string;
   *   // for dropping the index at a down migration
   *   dropMode?: DropMode;
   * }
   * ```
   */
  exclude<T extends Column.Pick.Data>(this: T, op: string, ...args: [options?: TableData$1.Exclude.ColumnArg]): T;
  comment<T extends Column.Pick.Data>(this: T, comment: string): T;
  compression<T extends Column.Pick.Data>(this: T, compression: string): T;
  collate<T extends Column.Pick.Data>(this: T, collate: string): T;
  modifyQuery<T extends Column.Pick.Data>(this: T, cb: (q: Query) => void): T;
  /**
   * Define a generated column. `generated` accepts a raw SQL.
   *
   * ```ts
   * import { change } from '../dbScript';
   *
   * change(async (db) => {
   *   await db.createTable('table', (t) => ({
   *     two: t.integer().generated`1 + 1`,
   *   }));
   * });
   * ```
   *
   * @param args - raw SQL
   */
  generated<T extends Column.Pick.Data>(this: T, ...args: StaticSQLArgs$1): Column.Generated<T>;
}
export { type Adapter, AdapterClass, type AdapterConfigBase, type AdapterParams, type AdapterSchemaConfigOptions, type AfterCommitStandaloneHook, type AfterHook, ArrayColumn, type ArrayColumnValue, type ArrayData, type AsyncState, AsyncStateStorage, type BaseNumberData, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, type BrandColumn, type BrandColumnsShape, ByteaColumn, CannotMutateReadOnlyTableError, CidrColumn, CircleColumn, CitextColumn, type Code, type Codes, Column, type ColumnFromDbParams, type ColumnRefExpression, type ColumnSchemaConfig, type ColumnSchemaGetterColumns, type ColumnSchemaGetterTableClass, type ColumnToCodeCtx, type ColumnTypeSchemaArg, type ColumnsByType, type ColumnsShape, type ComputedColumnsFromOptions, type ComputedOptionsConfig, type ComputedOptionsFactory, type CreateCtx, type CreateData, type CreateManyMethodsNames, type CreateMethodsNames, type CreateSelf, CustomTypeColumn, DateColumn, type DateColumnData, type DateColumnInput, type DbDomainArg, type DbExtension, type DbOptions, type DbResult, type DbSharedOptions, type DbSqlMethod, type DbStructureDomainsMap, type DbTableOptionScopes, type DbTableOptions, DecimalColumn, type DecimalColumnData, type DefaultColumnTypes, type DefaultPrivileges, type DefaultSchemaConfig, type DeleteMethodsNames, DomainColumn, DoublePrecisionColumn, type DriverAdapter, DynamicRawSQL, type EmptyObject, type EmptyTuple, EnumColumn, Expression, type ExpressionData, type FromArg, type FromResult, type GeneratorIgnore, type Grant, type HookSelectValue, InetColumn, IntegerColumn, IntervalColumn, type IsQuery, type IsolationLevel, JSONColumn, JSONTextColumn, type JoinedShapes, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, type MapTableScopesOption, type MaybeArray, type MaybePromise, type MergeQuery, MoneyColumn, type NoPrimaryKeyOption, type NonUniqDataItem, type NumberColumnData, Operators, type OperatorsArray, type OperatorsDate, type OperatorsJson, type OperatorsNumber, type OperatorsOrdinalText, type OperatorsText, OrchidOrmError, type Ord, PathColumn, type PickQueryInputType, type PickQueryInternal, type PickQueryQ, type PickQueryRelations, type PickQuerySelectableRelations, type PickQueryShape, PointColumn, PolygonColumn, PostgisGeographyPointColumn, type QueryAfterHook, type QueryBeforeActionHook, type QueryBeforeHook, type QueryCatch, type QueryData, type QueryHasWhere, QueryHookUtils, QueryHooks, type QueryInternal, type QueryLogObject, type QueryLogOptions, type QueryLogger, type QueryManyTake, type QueryManyTakeOptional, type QueryOrExpression, type QueryResult, type QueryResultRow, type QueryReturnType, type QuerySchema, type QueryScopes, type QueryTake, type QueryThen, type QueryThenShallowSimplify, RawSql, type RawSqlBase, RealColumn, type RecordKeyTrue, type RecordOptionalString, type RecordString, type RecordStringOrNumber, type RecordUnknown, type RelationConfigBase, type RelationJoinQuery, type RelationsBase, type Rls, type RlsPolicy, type SchemaConfigFnWithOptions, type SearchWeight, type SelectAs, type SelectAsFnReturnType, type SelectResultObj, type SelectSqlColumn, type SelectableFromShape, SerialColumn, type SerialColumnData, type ShallowSimplify, type ShapeUniqueColumns, type SingleSql, type SingleSqlItem, SmallIntColumn, SmallSerialColumn, type Sql, type SqlFn, type SqlSessionState, type StaticSQLArgs, type StorageOptions, StringColumn, type StringData, type TableData, type TableDataFn, type TableDataInput, type TableDataItem, type TableDataItemsUniqueColumnTuples, type TableDataItemsUniqueColumns, type TableDataItemsUniqueConstraints, type TableDataMethods, type TemplateLiteralArgs, TextColumn, TimeColumn, TimestampColumn, TimestampTZColumn, type Timestamps, type ToSQLCtx, type ToSqlValues, type TransactionAdapter, TransactionAdapterClass, type TransactionOptions, TsQueryColumn, TsVectorColumn, UUIDColumn, type UniqueConstraints, type UniqueTableDataItem, UnknownColumn, type UpdateData, type UpdateSelf, type UpsertData, type UpsertThis, ValExpression, VarCharColumn, VirtualColumn, type WhereArg, XMLColumn, _appendQuery, _appendQueryOnUpsertCreate, _clone, _createDbSqlMethod, _hookSelectColumns, _initQueryBuilder, _onUpsertUpdate, _orCreate, _prependWith, _prependWithOnUpsertCreate, _queryCreate, _queryCreateMany, _queryCreateManyFrom, _queryDefaults, _queryDelete, _queryFindBy, _queryFindByOptional, _queryHookAfterCreate, _queryHookAfterUpdate, _queryInsert, _queryInsertForEachFrom, _queryInsertMany, _queryInsertManyFrom, _queryJoinOn, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUpdate, _queryUpdateOrThrow, _queryUpsert, _queryWhere, _queryWhereExists, _queryWhereIn, addCode, addTopCte, addTopCteSql, applyMixins, assignDbDataToColumn, backtickQuote, cloneQueryBaseUnscoped, codeToString, colors, columnsShapeToCode, constraintInnerToCode, constraintToCode, consumeColumnName, deepCompare, defaultSchemaConfig, emptyArray, emptyObject, escapeForMigration, escapeString, excludeInnerToCode, excludeToCode, exhaustive, getCallerFilePath, getClonedQueryData, getColumnBaseType, getColumnTypes, getDateAsDateFn, getDateAsNumberFn, getDriverErrorCode, getForeignKeyTableInstance, getFreeAlias, getFreeSetAlias, getImportPath, getPrimaryKeys, getQueryAs, getQuerySchema, getShapeFromSelect, getSqlText, getStackTrace, getSupportedDefaultPrivileges, indexInnerToCode, indexToCode, internalSchemaConfig, isExpression, isQueryReturnsAll, isRawSQL, isRelationCondition, logColors, logParamToLogObject, makeColumnNullable, makeColumnTypes, makeColumnsByType, makeConnectRetryConfig, markRelationConditions, noop, objectHasValues, omit, parseTableData, parseTableDataInput, pathToLog, pick, pluralize, prepareSubQueryForSql, primaryKeyInnerToCode, pushQueryOnForOuter, pushQueryValueImmutable, pushTableDataCode, queryToSql, quoteIdentifier, quoteObjectKey, quoteTableWithSchema, raw, rawSqlToCode, rawSqlToSql, referencesArgsToCode, returnArg, setColumnData, setColumnEncode, setColumnParse, setColumnParseNull, setCurrentColumnName, setDataValue, setDefaultLanguage, setFreeAlias, setQueryObjectValueImmutable, singleQuote, sqlToRawSql, tableDataMethods, toArray, toCamelCase, toPascalCase, toSnakeCase, wrapAdapterFnWithConnectRetry };