@erfanium/drizzle-orm 0.1.0 → 1.0.0

package/cockroach-core/query-builders/update.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.cjs","names":["entityKind","QueryPromise","CockroachTable","Table","Subquery","ViewBaseConfig","SQL","SelectionProxyHandler"],"sources":["../../../src/cockroach-core/query-builders/update.ts"],"sourcesContent":["import type { CockroachDialect } from '~/cockroach-core/dialect.ts';\nimport type {\n\tCockroachPreparedQuery,\n\tCockroachQueryResultHKT,\n\tCockroachQueryResultKind,\n\tCockroachSession,\n\tPreparedQueryConfig,\n} from '~/cockroach-core/session.ts';\nimport { CockroachTable } from '~/cockroach-core/table.ts';\nimport type { GetColumnData } from '~/column.ts';\nimport { entityKind, is } from '~/entity.ts';\nimport type { TypedQueryBuilder } from '~/query-builders/query-builder.ts';\nimport type {\n\tAppendToNullabilityMap,\n\tAppendToResult,\n\tGetSelectTableName,\n\tGetSelectTableSelection,\n\tJoinNullability,\n\tJoinType,\n\tSelectMode,\n\tSelectResult,\n} from '~/query-builders/select.types.ts';\nimport { preparedStatementName } from '~/query-name-generator.ts';\nimport { QueryPromise } from '~/query-promise.ts';\nimport type { RunnableQuery } from '~/runnable-query.ts';\nimport { SelectionProxyHandler } from '~/selection-proxy.ts';\nimport { type ColumnsSelection, type Placeholder, type Query, SQL, type SQLWrapper } from '~/sql/sql.ts';\nimport { Subquery } from '~/subquery.ts';\nimport { getTableName, type InferInsertModel, Table } from '~/table.ts';\nimport {\n\ttype Assume,\n\ttype DrizzleTypeError,\n\ttype Equal,\n\tgetTableLikeName,\n\tmapUpdateSet,\n\torderSelectedFields,\n\ttype Simplify,\n\ttype UpdateSet,\n} from '~/utils.ts';\nimport { ViewBaseConfig } from '~/view-common.ts';\nimport type { CockroachColumn } from '../columns/common.ts';\nimport type { CockroachViewBase } from '../view-base.ts';\nimport type {\n\tCockroachSelectJoinConfig,\n\tSelectedFields,\n\tSelectedFieldsOrdered,\n\tTableLikeHasEmptySelection,\n} from './select.types.ts';\n\nexport interface CockroachUpdateConfig {\n\twhere?: SQL | undefined;\n\tset: UpdateSet;\n\ttable: CockroachTable;\n\tfrom?: CockroachTable | Subquery | CockroachViewBase | SQL;\n\tjoins: CockroachSelectJoinConfig[];\n\treturningFields?: SelectedFields;\n\treturning?: SelectedFieldsOrdered;\n\twithList?: Subquery[];\n}\n\nexport type CockroachUpdateSetSource<TTable extends CockroachTable> =\n\t& {\n\t\t[Key in keyof InferInsertModel<TTable>]?:\n\t\t\t| GetColumnData<TTable['_']['columns'][Key]>\n\t\t\t| SQL\n\t\t\t| CockroachColumn\n\t\t\t| Placeholder\n\t\t\t| undefined;\n\t}\n\t& {};\n\nexport class CockroachUpdateBuilder<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT> {\n\tstatic readonly [entityKind]: string = 'CockroachUpdateBuilder';\n\n\tdeclare readonly _: {\n\t\treadonly table: TTable;\n\t};\n\n\tconstructor(\n\t\tprivate table: TTable,\n\t\tprivate session: CockroachSession,\n\t\tprivate dialect: CockroachDialect,\n\t\tprivate withList?: Subquery[],\n\t) {}\n\n\tset(\n\t\tvalues: CockroachUpdateSetSource<TTable>,\n\t): CockroachUpdateWithout<\n\t\tCockroachUpdateBase<TTable, TQueryResult>,\n\t\tfalse,\n\t\t'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'\n\t> {\n\t\treturn new CockroachUpdateBase<TTable, TQueryResult>(\n\t\t\tthis.table,\n\t\t\tmapUpdateSet(this.table, values),\n\t\t\tthis.session,\n\t\t\tthis.dialect,\n\t\t\tthis.withList,\n\t\t);\n\t}\n}\n\nexport type CockroachUpdateWithout<\n\tT extends AnyCockroachUpdate,\n\tTDynamic extends boolean,\n\tK extends keyof T & string,\n> = TDynamic extends true ? T : Omit<\n\tCockroachUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['from'],\n\t\tT['_']['selectedFields'],\n\t\tT['_']['returning'],\n\t\tT['_']['nullabilityMap'],\n\t\tT['_']['joins'],\n\t\tTDynamic,\n\t\tT['_']['excludedMethods'] | K\n\t>,\n\tT['_']['excludedMethods'] | K\n>;\n\nexport type CockroachUpdateWithJoins<\n\tT extends AnyCockroachUpdate,\n\tTDynamic extends boolean,\n\tTFrom extends CockroachTable | Subquery | CockroachViewBase | SQL,\n> = TDynamic extends true ? T : Omit<\n\tCockroachUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tTFrom,\n\t\tT['_']['selectedFields'],\n\t\tT['_']['returning'],\n\t\tAppendToNullabilityMap<T['_']['nullabilityMap'], GetSelectTableName<TFrom>, 'inner'>,\n\t\t[...T['_']['joins'], {\n\t\t\tname: GetSelectTableName<TFrom>;\n\t\t\tjoinType: 'inner';\n\t\t\ttable: TFrom;\n\t\t}],\n\t\tTDynamic,\n\t\tExclude<T['_']['excludedMethods'] | 'from', 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>\n\t>,\n\tExclude<T['_']['excludedMethods'] | 'from', 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>\n>;\n\nexport type CockroachUpdateJoinFn<\n\tT extends AnyCockroachUpdate,\n\tTDynamic extends boolean,\n\tTJoinType extends JoinType,\n> = <\n\tTJoinedTable extends CockroachTable | Subquery | CockroachViewBase | SQL,\n>(\n\ttable: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<\n\t\t\t\"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause\"\n\t\t>\n\t\t: TJoinedTable,\n\ton:\n\t\t| (\n\t\t\t(\n\t\t\t\tupdateTable: T['_']['table']['_']['columns'],\n\t\t\t\tfrom: T['_']['from'] extends CockroachTable ? T['_']['from']['_']['columns']\n\t\t\t\t\t: T['_']['from'] extends Subquery | CockroachViewBase ? T['_']['from']['_']['selectedFields']\n\t\t\t\t\t: never,\n\t\t\t) => SQL | undefined\n\t\t)\n\t\t| SQL\n\t\t| undefined,\n) => CockroachUpdateJoin<T, TDynamic, TJoinType, TJoinedTable>;\n\nexport type CockroachUpdateJoin<\n\tT extends AnyCockroachUpdate,\n\tTDynamic extends boolean,\n\tTJoinType extends JoinType,\n\tTJoinedTable extends CockroachTable | Subquery | CockroachViewBase | SQL,\n> = TDynamic extends true ? T : CockroachUpdateBase<\n\tT['_']['table'],\n\tT['_']['queryResult'],\n\tT['_']['from'],\n\tT['_']['selectedFields'],\n\tT['_']['returning'],\n\tAppendToNullabilityMap<T['_']['nullabilityMap'], GetSelectTableName<TJoinedTable>, TJoinType>,\n\t[...T['_']['joins'], {\n\t\tname: GetSelectTableName<TJoinedTable>;\n\t\tjoinType: TJoinType;\n\t\ttable: TJoinedTable;\n\t}],\n\tTDynamic,\n\tT['_']['excludedMethods']\n>;\n\ntype Join = {\n\tname: string | undefined;\n\tjoinType: JoinType;\n\ttable: CockroachTable | Subquery | CockroachViewBase | SQL;\n};\n\ntype AccumulateToResult<\n\tT extends AnyCockroachUpdate,\n\tTSelectMode extends SelectMode,\n\tTJoins extends Join[],\n\tTSelectedFields extends ColumnsSelection,\n> = TJoins extends [infer TJoin extends Join, ...infer TRest extends Join[]] ? AccumulateToResult<\n\t\tT,\n\t\tTSelectMode extends 'partial' ? TSelectMode : 'multiple',\n\t\tTRest,\n\t\tAppendToResult<\n\t\t\tT['_']['table']['_']['name'],\n\t\t\tTSelectedFields,\n\t\t\tTJoin['name'],\n\t\t\tTJoin['table'] extends Table ? TJoin['table']['_']['columns']\n\t\t\t\t: TJoin['table'] extends Subquery ? Assume<TJoin['table']['_']['selectedFields'], SelectedFields>\n\t\t\t\t: never,\n\t\t\tTSelectMode extends 'partial' ? TSelectMode : 'multiple'\n\t\t>\n\t>\n\t: TSelectedFields;\n\nexport type CockroachUpdateReturningAll<T extends AnyCockroachUpdate, TDynamic extends boolean> =\n\tCockroachUpdateWithout<\n\t\tCockroachUpdateBase<\n\t\t\tT['_']['table'],\n\t\t\tT['_']['queryResult'],\n\t\t\tT['_']['from'],\n\t\t\tEqual<T['_']['joins'], []> extends true ? T['_']['table']['_']['columns'] : Simplify<\n\t\t\t\t& Record<T['_']['table']['_']['name'], T['_']['table']['_']['columns']>\n\t\t\t\t& {\n\t\t\t\t\t[K in keyof T['_']['joins'] as T['_']['joins'][K]['table']['_']['name']]:\n\t\t\t\t\t\tT['_']['joins'][K]['table']['_']['columns'];\n\t\t\t\t}\n\t\t\t>,\n\t\t\tSelectResult<\n\t\t\t\tAccumulateToResult<\n\t\t\t\t\tT,\n\t\t\t\t\t'single',\n\t\t\t\t\tT['_']['joins'],\n\t\t\t\t\tGetSelectTableSelection<T['_']['table']>\n\t\t\t\t>,\n\t\t\t\t'partial',\n\t\t\t\tT['_']['nullabilityMap']\n\t\t\t>,\n\t\t\tT['_']['nullabilityMap'],\n\t\t\tT['_']['joins'],\n\t\t\tTDynamic,\n\t\t\tT['_']['excludedMethods']\n\t\t>,\n\t\tTDynamic,\n\t\t'returning'\n\t>;\n\nexport type CockroachUpdateReturning<\n\tT extends AnyCockroachUpdate,\n\tTDynamic extends boolean,\n\tTSelectedFields extends SelectedFields,\n> = CockroachUpdateWithout<\n\tCockroachUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['from'],\n\t\tTSelectedFields,\n\t\tSelectResult<\n\t\t\tAccumulateToResult<\n\t\t\t\tT,\n\t\t\t\t'partial',\n\t\t\t\tT['_']['joins'],\n\t\t\t\tTSelectedFields\n\t\t\t>,\n\t\t\t'partial',\n\t\t\tT['_']['nullabilityMap']\n\t\t>,\n\t\tT['_']['nullabilityMap'],\n\t\tT['_']['joins'],\n\t\tTDynamic,\n\t\tT['_']['excludedMethods']\n\t>,\n\tTDynamic,\n\t'returning'\n>;\n\nexport type CockroachUpdatePrepare<T extends AnyCockroachUpdate> = CockroachPreparedQuery<\n\tPreparedQueryConfig & {\n\t\texecute: T['_']['returning'] extends undefined ? CockroachQueryResultKind<T['_']['queryResult'], never>\n\t\t\t: T['_']['returning'][];\n\t}\n>;\n\nexport type CockroachUpdateDynamic<T extends AnyCockroachUpdate> = CockroachUpdate<\n\tT['_']['table'],\n\tT['_']['queryResult'],\n\tT['_']['from'],\n\tT['_']['returning'],\n\tT['_']['nullabilityMap']\n>;\n\nexport type CockroachUpdate<\n\tTTable extends CockroachTable = CockroachTable,\n\tTQueryResult extends CockroachQueryResultHKT = CockroachQueryResultHKT,\n\tTFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined,\n\tTSelectedFields extends ColumnsSelection | undefined = undefined,\n\tTReturning extends Record<string, unknown> | undefined = Record<string, unknown> | undefined,\n\tTNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>,\n\tTJoins extends Join[] = [],\n> = CockroachUpdateBase<\n\tTTable,\n\tTQueryResult,\n\tTFrom,\n\tTSelectedFields,\n\tTReturning,\n\tTNullabilityMap,\n\tTJoins,\n\ttrue,\n\tnever\n>;\n\nexport type AnyCockroachUpdate = CockroachUpdateBase<any, any, any, any, any, any, any, any, any>;\n\nexport interface CockroachUpdateBase<\n\tTTable extends CockroachTable,\n\tTQueryResult extends CockroachQueryResultHKT,\n\tTFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined,\n\tTSelectedFields extends ColumnsSelection | undefined = undefined,\n\tTReturning extends Record<string, unknown> | undefined = undefined,\n\tTNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>,\n\tTJoins extends Join[] = [],\n\tTDynamic extends boolean = false,\n\tTExcludedMethods extends string = never,\n> extends\n\tTypedQueryBuilder<\n\t\tTSelectedFields,\n\t\tTReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]\n\t>,\n\tQueryPromise<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]>,\n\tRunnableQuery<\n\t\tTReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[],\n\t\t'cockroach'\n\t>,\n\tSQLWrapper\n{\n\treadonly _: {\n\t\treadonly dialect: 'cockroach';\n\t\treadonly table: TTable;\n\t\treadonly joins: TJoins;\n\t\treadonly nullabilityMap: TNullabilityMap;\n\t\treadonly queryResult: TQueryResult;\n\t\treadonly from: TFrom;\n\t\treadonly selectedFields: TSelectedFields;\n\t\treadonly returning: TReturning;\n\t\treadonly dynamic: TDynamic;\n\t\treadonly excludedMethods: TExcludedMethods;\n\t\treadonly result: TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[];\n\t};\n}\n\nexport class CockroachUpdateBase<\n\tTTable extends CockroachTable,\n\tTQueryResult extends CockroachQueryResultHKT,\n\tTFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTSelectedFields extends ColumnsSelection | undefined = undefined,\n\tTReturning extends Record<string, unknown> | undefined = undefined,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTJoins extends Join[] = [],\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTDynamic extends boolean = false,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTExcludedMethods extends string = never,\n> extends QueryPromise<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]>\n\timplements\n\t\tRunnableQuery<\n\t\t\tTReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[],\n\t\t\t'cockroach'\n\t\t>,\n\t\tSQLWrapper\n{\n\tstatic override readonly [entityKind]: string = 'CockroachUpdate';\n\n\tprivate config: CockroachUpdateConfig;\n\tprivate tableName: string | undefined;\n\tprivate joinsNotNullableMap: Record<string, boolean>;\n\n\tconstructor(\n\t\ttable: TTable,\n\t\tset: UpdateSet,\n\t\tprivate session: CockroachSession,\n\t\tprivate dialect: CockroachDialect,\n\t\twithList?: Subquery[],\n\t) {\n\t\tsuper();\n\t\tthis.config = { set, table, withList, joins: [] };\n\t\tthis.tableName = getTableLikeName(table);\n\t\tthis.joinsNotNullableMap = typeof this.tableName === 'string' ? { [this.tableName]: true } : {};\n\t}\n\n\tfrom<TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL>(\n\t\tsource: TableLikeHasEmptySelection<TFrom> extends true ? DrizzleTypeError<\n\t\t\t\t\"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause\"\n\t\t\t>\n\t\t\t: TFrom,\n\t): CockroachUpdateWithJoins<this, TDynamic, TFrom> {\n\t\tconst src = source as TFrom;\n\t\tconst tableName = getTableLikeName(src);\n\t\tif (typeof tableName === 'string') {\n\t\t\tthis.joinsNotNullableMap[tableName] = true;\n\t\t}\n\t\tthis.config.from = src;\n\t\treturn this as any;\n\t}\n\n\tprivate getTableLikeFields(table: CockroachTable | Subquery | CockroachViewBase): Record<string, unknown> {\n\t\tif (is(table, CockroachTable)) {\n\t\t\treturn table[Table.Symbol.Columns];\n\t\t} else if (is(table, Subquery)) {\n\t\t\treturn table._.selectedFields;\n\t\t}\n\t\treturn table[ViewBaseConfig].selectedFields;\n\t}\n\n\tprivate createJoin<TJoinType extends JoinType>(\n\t\tjoinType: TJoinType,\n\t): CockroachUpdateJoinFn<this, TDynamic, TJoinType> {\n\t\treturn ((\n\t\t\ttable: CockroachTable | Subquery | CockroachViewBase | SQL,\n\t\t\ton: ((updateTable: TTable, from: TFrom) => SQL | undefined) | SQL | undefined,\n\t\t) => {\n\t\t\tconst tableName = getTableLikeName(table);\n\n\t\t\tif (typeof tableName === 'string' && this.config.joins.some((join) => join.alias === tableName)) {\n\t\t\t\tthrow new Error(`Alias \"${tableName}\" is already used in this query`);\n\t\t\t}\n\n\t\t\tif (typeof on === 'function') {\n\t\t\t\tconst from = this.config.from && !is(this.config.from, SQL)\n\t\t\t\t\t? this.getTableLikeFields(this.config.from)\n\t\t\t\t\t: undefined;\n\t\t\t\ton = on(\n\t\t\t\t\tnew Proxy(\n\t\t\t\t\t\tthis.config.table[Table.Symbol.Columns],\n\t\t\t\t\t\tnew SelectionProxyHandler({ sqlAliasedBehavior: 'sql', sqlBehavior: 'sql' }),\n\t\t\t\t\t) as any,\n\t\t\t\t\tfrom && new Proxy(\n\t\t\t\t\t\tfrom,\n\t\t\t\t\t\tnew SelectionProxyHandler({ sqlAliasedBehavior: 'sql', sqlBehavior: 'sql' }),\n\t\t\t\t\t) as any,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tthis.config.joins.push({ on, table, joinType, alias: tableName });\n\n\t\t\tif (typeof tableName === 'string') {\n\t\t\t\tswitch (joinType) {\n\t\t\t\t\tcase 'left': {\n\t\t\t\t\t\tthis.joinsNotNullableMap[tableName] = false;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tcase 'right': {\n\t\t\t\t\t\tthis.joinsNotNullableMap = Object.fromEntries(\n\t\t\t\t\t\t\tObject.entries(this.joinsNotNullableMap).map(([key]) => [key, false]),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tthis.joinsNotNullableMap[tableName] = true;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tcase 'inner': {\n\t\t\t\t\t\tthis.joinsNotNullableMap[tableName] = true;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t\tcase 'full': {\n\t\t\t\t\t\tthis.joinsNotNullableMap = Object.fromEntries(\n\t\t\t\t\t\t\tObject.entries(this.joinsNotNullableMap).map(([key]) => [key, false]),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tthis.joinsNotNullableMap[tableName] = false;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn this as any;\n\t\t}) as any;\n\t}\n\n\tleftJoin = this.createJoin('left');\n\n\trightJoin = this.createJoin('right');\n\n\tinnerJoin = this.createJoin('inner');\n\n\tfullJoin = this.createJoin('full');\n\n\t/**\n\t * Adds a 'where' clause to the query.\n\t *\n\t * Calling this method will update only those rows that fulfill a specified condition.\n\t *\n\t * See docs: {@link https://orm.drizzle.team/docs/update}\n\t *\n\t * @param where the 'where' clause.\n\t *\n\t * @example\n\t * You can use conditional operators and `sql function` to filter the rows to be updated.\n\t *\n\t * ```ts\n\t * // Update all cars with green color\n\t * await db.update(cars).set({ color: 'red' })\n\t *   .where(eq(cars.color, 'green'));\n\t * // or\n\t * await db.update(cars).set({ color: 'red' })\n\t *   .where(sql`${cars.color} = 'green'`)\n\t * ```\n\t *\n\t * You can logically combine conditional operators with `and()` and `or()` operators:\n\t *\n\t * ```ts\n\t * // Update all BMW cars with a green color\n\t * await db.update(cars).set({ color: 'red' })\n\t *   .where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));\n\t *\n\t * // Update all cars with the green or blue color\n\t * await db.update(cars).set({ color: 'red' })\n\t *   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));\n\t * ```\n\t */\n\twhere(where: SQL | undefined): CockroachUpdateWithout<this, TDynamic, 'where'> {\n\t\tthis.config.where = where;\n\t\treturn this as any;\n\t}\n\n\t/**\n\t * Adds a `returning` clause to the query.\n\t *\n\t * Calling this method will return the specified fields of the updated rows. If no fields are specified, all fields will be returned.\n\t *\n\t * See docs: {@link https://orm.drizzle.team/docs/update#update-with-returning}\n\t *\n\t * @example\n\t * ```ts\n\t * // Update all cars with the green color and return all fields\n\t * const updatedCars: Car[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .where(eq(cars.color, 'green'))\n\t *   .returning();\n\t *\n\t * // Update all cars with the green color and return only their id and brand fields\n\t * const updatedCarsIdsAndBrands: { id: number, brand: string }[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .where(eq(cars.color, 'green'))\n\t *   .returning({ id: cars.id, brand: cars.brand });\n\t * ```\n\t */\n\treturning(): CockroachUpdateReturningAll<this, TDynamic>;\n\treturning<TSelectedFields extends SelectedFields>(\n\t\tfields: TSelectedFields,\n\t): CockroachUpdateReturning<this, TDynamic, TSelectedFields>;\n\treturning(\n\t\tfields?: SelectedFields,\n\t): CockroachUpdateWithout<AnyCockroachUpdate, TDynamic, 'returning'> {\n\t\tif (!fields) {\n\t\t\tfields = Object.assign({}, this.config.table[Table.Symbol.Columns]);\n\n\t\t\tif (this.config.from) {\n\t\t\t\tconst tableName = getTableLikeName(this.config.from);\n\n\t\t\t\tif (typeof tableName === 'string' && this.config.from && !is(this.config.from, SQL)) {\n\t\t\t\t\tconst fromFields = this.getTableLikeFields(this.config.from);\n\t\t\t\t\tfields[tableName] = fromFields as any;\n\t\t\t\t}\n\n\t\t\t\tfor (const join of this.config.joins) {\n\t\t\t\t\tconst tableName = getTableLikeName(join.table);\n\n\t\t\t\t\tif (typeof tableName === 'string' && !is(join.table, SQL)) {\n\t\t\t\t\t\tconst fromFields = this.getTableLikeFields(join.table);\n\t\t\t\t\t\tfields[tableName] = fromFields as any;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthis.config.returningFields = fields;\n\t\tthis.config.returning = orderSelectedFields<CockroachColumn>(fields);\n\t\treturn this as any;\n\t}\n\n\t/** @internal */\n\tgetSQL(): SQL {\n\t\treturn this.dialect.buildUpdateQuery(this.config);\n\t}\n\n\ttoSQL(): Query {\n\t\treturn this.dialect.sqlToQuery(this.getSQL());\n\t}\n\n\t/** @internal */\n\t_prepare(name?: string, generateName = false): CockroachUpdatePrepare<this> {\n\t\tconst query = this.dialect.sqlToQuery(this.getSQL());\n\t\tconst preparedQuery = this.session.prepareQuery<\n\t\t\tPreparedQueryConfig & { execute: TReturning[] }\n\t\t>(\n\t\t\tquery,\n\t\t\tthis.config.returning,\n\t\t\tname ?? (generateName ? preparedStatementName(query.sql, query.params) : name),\n\t\t);\n\t\tpreparedQuery.joinsNotNullableMap = this.joinsNotNullableMap;\n\t\treturn preparedQuery;\n\t}\n\n\tprepare(name?: string): CockroachUpdatePrepare<this> {\n\t\treturn this._prepare(name, true);\n\t}\n\n\toverride execute: ReturnType<this['prepare']>['execute'] = (placeholderValues) => {\n\t\treturn this._prepare().execute(placeholderValues);\n\t};\n\n\t/** @internal */\n\tgetSelectedFields(): this['_']['selectedFields'] {\n\t\treturn (\n\t\t\tthis.config.returningFields\n\t\t\t\t? new Proxy(\n\t\t\t\t\tthis.config.returningFields,\n\t\t\t\t\tnew SelectionProxyHandler({\n\t\t\t\t\t\talias: getTableName(this.config.table),\n\t\t\t\t\t\tsqlAliasedBehavior: 'alias',\n\t\t\t\t\t\tsqlBehavior: 'error',\n\t\t\t\t\t}),\n\t\t\t\t)\n\t\t\t\t: undefined\n\t\t) as this['_']['selectedFields'];\n\t}\n\n\t/** @internal */\n\twithoutSelectionCastCodecs(): this {\n\t\treturn this;\n\t}\n\n\t$dynamic(): CockroachUpdateDynamic<this> {\n\t\treturn this as any;\n\t}\n}\n"],"mappings":"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"}

package/cockroach-core/query-builders/update.d.cts

@@ -0,0 +1,163 @@
+import { CockroachColumn } from "../columns/common.cjs";
+import { CockroachViewBase } from "../view-base.cjs";
+import { CockroachSelectJoinConfig, SelectedFields, SelectedFieldsOrdered, TableLikeHasEmptySelection } from "./select.types.cjs";
+import { entityKind } from "../../entity.cjs";
+import { CockroachTable } from "../table.cjs";
+import { TypedQueryBuilder } from "../../query-builders/query-builder.cjs";
+import { AppendToNullabilityMap, AppendToResult, GetSelectTableName, GetSelectTableSelection, JoinNullability, JoinType, SelectMode, SelectResult } from "../../query-builders/select.types.cjs";
+import { ColumnsSelection, Placeholder, Query, SQL, SQLWrapper } from "../../sql/sql.cjs";
+import { Subquery } from "../../subquery.cjs";
+import { InferInsertModel, Table } from "../../table.cjs";
+import { Assume, DrizzleTypeError, Equal, Simplify, UpdateSet } from "../../utils.cjs";
+import { CockroachDialect } from "../dialect.cjs";
+import { CockroachPreparedQuery, CockroachQueryResultHKT, CockroachQueryResultKind, CockroachSession, PreparedQueryConfig } from "../session.cjs";
+import { GetColumnData } from "../../column.cjs";
+import { QueryPromise } from "../../query-promise.cjs";
+import { RunnableQuery } from "../../runnable-query.cjs";
+
+//#region src/cockroach-core/query-builders/update.d.ts
+interface CockroachUpdateConfig {
+  where?: SQL | undefined;
+  set: UpdateSet;
+  table: CockroachTable;
+  from?: CockroachTable | Subquery | CockroachViewBase | SQL;
+  joins: CockroachSelectJoinConfig[];
+  returningFields?: SelectedFields;
+  returning?: SelectedFieldsOrdered;
+  withList?: Subquery[];
+}
+type CockroachUpdateSetSource<TTable extends CockroachTable> = { [Key in keyof InferInsertModel<TTable>]?: GetColumnData<TTable['_']['columns'][Key]> | SQL | CockroachColumn | Placeholder | undefined } & {};
+declare class CockroachUpdateBuilder<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT> {
+  private table;
+  private session;
+  private dialect;
+  private withList?;
+  static readonly [entityKind]: string;
+  readonly _: {
+    readonly table: TTable;
+  };
+  constructor(table: TTable, session: CockroachSession, dialect: CockroachDialect, withList?: Subquery[] | undefined);
+  set(values: CockroachUpdateSetSource<TTable>): CockroachUpdateWithout<CockroachUpdateBase<TTable, TQueryResult>, false, 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>;
+}
+type CockroachUpdateWithout<T extends AnyCockroachUpdate, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], T['_']['selectedFields'], T['_']['returning'], T['_']['nullabilityMap'], T['_']['joins'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+type CockroachUpdateWithJoins<T extends AnyCockroachUpdate, TDynamic extends boolean, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL> = TDynamic extends true ? T : Omit<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], TFrom, T['_']['selectedFields'], T['_']['returning'], AppendToNullabilityMap<T['_']['nullabilityMap'], GetSelectTableName<TFrom>, 'inner'>, [...T['_']['joins'], {
+  name: GetSelectTableName<TFrom>;
+  joinType: 'inner';
+  table: TFrom;
+}], TDynamic, Exclude<T['_']['excludedMethods'] | 'from', 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>>, Exclude<T['_']['excludedMethods'] | 'from', 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>>;
+type CockroachUpdateJoinFn<T extends AnyCockroachUpdate, TDynamic extends boolean, TJoinType extends JoinType> = <TJoinedTable extends CockroachTable | Subquery | CockroachViewBase | SQL>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: ((updateTable: T['_']['table']['_']['columns'], from: T['_']['from'] extends CockroachTable ? T['_']['from']['_']['columns'] : T['_']['from'] extends Subquery | CockroachViewBase ? T['_']['from']['_']['selectedFields'] : never) => SQL | undefined) | SQL | undefined) => CockroachUpdateJoin<T, TDynamic, TJoinType, TJoinedTable>;
+type CockroachUpdateJoin<T extends AnyCockroachUpdate, TDynamic extends boolean, TJoinType extends JoinType, TJoinedTable extends CockroachTable | Subquery | CockroachViewBase | SQL> = TDynamic extends true ? T : CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], T['_']['selectedFields'], T['_']['returning'], AppendToNullabilityMap<T['_']['nullabilityMap'], GetSelectTableName<TJoinedTable>, TJoinType>, [...T['_']['joins'], {
+  name: GetSelectTableName<TJoinedTable>;
+  joinType: TJoinType;
+  table: TJoinedTable;
+}], TDynamic, T['_']['excludedMethods']>;
+type Join = {
+  name: string | undefined;
+  joinType: JoinType;
+  table: CockroachTable | Subquery | CockroachViewBase | SQL;
+};
+type AccumulateToResult<T extends AnyCockroachUpdate, TSelectMode extends SelectMode, TJoins extends Join[], TSelectedFields extends ColumnsSelection> = TJoins extends [infer TJoin extends Join, ...infer TRest extends Join[]] ? AccumulateToResult<T, TSelectMode extends 'partial' ? TSelectMode : 'multiple', TRest, AppendToResult<T['_']['table']['_']['name'], TSelectedFields, TJoin['name'], TJoin['table'] extends Table ? TJoin['table']['_']['columns'] : TJoin['table'] extends Subquery ? Assume<TJoin['table']['_']['selectedFields'], SelectedFields> : never, TSelectMode extends 'partial' ? TSelectMode : 'multiple'>> : TSelectedFields;
+type CockroachUpdateReturningAll<T extends AnyCockroachUpdate, TDynamic extends boolean> = CockroachUpdateWithout<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], Equal<T['_']['joins'], []> extends true ? T['_']['table']['_']['columns'] : Simplify<Record<T['_']['table']['_']['name'], T['_']['table']['_']['columns']> & { [K in keyof T['_']['joins'] as T['_']['joins'][K]['table']['_']['name']]: T['_']['joins'][K]['table']['_']['columns'] }>, SelectResult<AccumulateToResult<T, 'single', T['_']['joins'], GetSelectTableSelection<T['_']['table']>>, 'partial', T['_']['nullabilityMap']>, T['_']['nullabilityMap'], T['_']['joins'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'returning'>;
+type CockroachUpdateReturning<T extends AnyCockroachUpdate, TDynamic extends boolean, TSelectedFields extends SelectedFields> = CockroachUpdateWithout<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], TSelectedFields, SelectResult<AccumulateToResult<T, 'partial', T['_']['joins'], TSelectedFields>, 'partial', T['_']['nullabilityMap']>, T['_']['nullabilityMap'], T['_']['joins'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'returning'>;
+type CockroachUpdatePrepare<T extends AnyCockroachUpdate> = CockroachPreparedQuery<PreparedQueryConfig & {
+  execute: T['_']['returning'] extends undefined ? CockroachQueryResultKind<T['_']['queryResult'], never> : T['_']['returning'][];
+}>;
+type CockroachUpdateDynamic<T extends AnyCockroachUpdate> = CockroachUpdate<T['_']['table'], T['_']['queryResult'], T['_']['from'], T['_']['returning'], T['_']['nullabilityMap']>;
+type CockroachUpdate<TTable extends CockroachTable = CockroachTable, TQueryResult extends CockroachQueryResultHKT = CockroachQueryResultHKT, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined, TSelectedFields extends ColumnsSelection | undefined = undefined, TReturning extends Record<string, unknown> | undefined = Record<string, unknown> | undefined, TNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>, TJoins extends Join[] = []> = CockroachUpdateBase<TTable, TQueryResult, TFrom, TSelectedFields, TReturning, TNullabilityMap, TJoins, true, never>;
+type AnyCockroachUpdate = CockroachUpdateBase<any, any, any, any, any, any, any, any, any>;
+interface CockroachUpdateBase<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined, TSelectedFields extends ColumnsSelection | undefined = undefined, TReturning extends Record<string, unknown> | undefined = undefined, TNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>, TJoins extends Join[] = [], TDynamic extends boolean = false, TExcludedMethods extends string = never> extends TypedQueryBuilder<TSelectedFields, TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]>, QueryPromise<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]>, RunnableQuery<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[], 'cockroach'>, SQLWrapper {
+  readonly _: {
+    readonly dialect: 'cockroach';
+    readonly table: TTable;
+    readonly joins: TJoins;
+    readonly nullabilityMap: TNullabilityMap;
+    readonly queryResult: TQueryResult;
+    readonly from: TFrom;
+    readonly selectedFields: TSelectedFields;
+    readonly returning: TReturning;
+    readonly dynamic: TDynamic;
+    readonly excludedMethods: TExcludedMethods;
+    readonly result: TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[];
+  };
+}
+declare class CockroachUpdateBase<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined, TSelectedFields extends ColumnsSelection | undefined = undefined, TReturning extends Record<string, unknown> | undefined = undefined, TNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>, TJoins extends Join[] = [], TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]> implements RunnableQuery<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[], 'cockroach'>, SQLWrapper {
+  private session;
+  private dialect;
+  static readonly [entityKind]: string;
+  private config;
+  private tableName;
+  private joinsNotNullableMap;
+  constructor(table: TTable, set: UpdateSet, session: CockroachSession, dialect: CockroachDialect, withList?: Subquery[]);
+  from<TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL>(source: TableLikeHasEmptySelection<TFrom> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TFrom): CockroachUpdateWithJoins<this, TDynamic, TFrom>;
+  private getTableLikeFields;
+  private createJoin;
+  leftJoin: CockroachUpdateJoinFn<this, TDynamic, "left">;
+  rightJoin: CockroachUpdateJoinFn<this, TDynamic, "right">;
+  innerJoin: CockroachUpdateJoinFn<this, TDynamic, "inner">;
+  fullJoin: CockroachUpdateJoinFn<this, TDynamic, "full">;
+  /**
+   * Adds a 'where' clause to the query.
+   *
+   * Calling this method will update only those rows that fulfill a specified condition.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/update}
+   *
+   * @param where the 'where' clause.
+   *
+   * @example
+   * You can use conditional operators and `sql function` to filter the rows to be updated.
+   *
+   * ```ts
+   * // Update all cars with green color
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'));
+   * // or
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(sql`${cars.color} = 'green'`)
+   * ```
+   *
+   * You can logically combine conditional operators with `and()` and `or()` operators:
+   *
+   * ```ts
+   * // Update all BMW cars with a green color
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));
+   *
+   * // Update all cars with the green or blue color
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+   * ```
+   */
+  where(where: SQL | undefined): CockroachUpdateWithout<this, TDynamic, 'where'>;
+  /**
+   * Adds a `returning` clause to the query.
+   *
+   * Calling this method will return the specified fields of the updated rows. If no fields are specified, all fields will be returned.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/update#update-with-returning}
+   *
+   * @example
+   * ```ts
+   * // Update all cars with the green color and return all fields
+   * const updatedCars: Car[] = await db.update(cars)
+   *   .set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'))
+   *   .returning();
+   *
+   * // Update all cars with the green color and return only their id and brand fields
+   * const updatedCarsIdsAndBrands: { id: number, brand: string }[] = await db.update(cars)
+   *   .set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'))
+   *   .returning({ id: cars.id, brand: cars.brand });
+   * ```
+   */
+  returning(): CockroachUpdateReturningAll<this, TDynamic>;
+  returning<TSelectedFields extends SelectedFields>(fields: TSelectedFields): CockroachUpdateReturning<this, TDynamic, TSelectedFields>;
+  toSQL(): Query;
+  prepare(name?: string): CockroachUpdatePrepare<this>;
+  execute: ReturnType<this['prepare']>['execute'];
+  $dynamic(): CockroachUpdateDynamic<this>;
+}
+//#endregion
+export { AnyCockroachUpdate, CockroachUpdate, CockroachUpdateBase, CockroachUpdateBuilder, CockroachUpdateConfig, CockroachUpdateDynamic, CockroachUpdateJoin, CockroachUpdateJoinFn, CockroachUpdatePrepare, CockroachUpdateReturning, CockroachUpdateReturningAll, CockroachUpdateSetSource, CockroachUpdateWithJoins, CockroachUpdateWithout };
+//# sourceMappingURL=update.d.cts.map

package/cockroach-core/query-builders/update.d.ts

@@ -0,0 +1,163 @@
+import { CockroachColumn } from "../columns/common.js";
+import { CockroachViewBase } from "../view-base.js";
+import { CockroachSelectJoinConfig, SelectedFields, SelectedFieldsOrdered, TableLikeHasEmptySelection } from "./select.types.js";
+import { entityKind } from "../../entity.js";
+import { InferInsertModel, Table } from "../../table.js";
+import { Assume, DrizzleTypeError, Equal, Simplify, UpdateSet } from "../../utils.js";
+import { GetColumnData } from "../../column.js";
+import { ColumnsSelection, Placeholder, Query, SQL, SQLWrapper } from "../../sql/sql.js";
+import { Subquery } from "../../subquery.js";
+import { TypedQueryBuilder } from "../../query-builders/query-builder.js";
+import { QueryPromise } from "../../query-promise.js";
+import { CockroachDialect } from "../dialect.js";
+import { CockroachTable } from "../table.js";
+import { CockroachPreparedQuery, CockroachQueryResultHKT, CockroachQueryResultKind, CockroachSession, PreparedQueryConfig } from "../session.js";
+import { AppendToNullabilityMap, AppendToResult, GetSelectTableName, GetSelectTableSelection, JoinNullability, JoinType, SelectMode, SelectResult } from "../../query-builders/select.types.js";
+import { RunnableQuery } from "../../runnable-query.js";
+
+//#region src/cockroach-core/query-builders/update.d.ts
+interface CockroachUpdateConfig {
+  where?: SQL | undefined;
+  set: UpdateSet;
+  table: CockroachTable;
+  from?: CockroachTable | Subquery | CockroachViewBase | SQL;
+  joins: CockroachSelectJoinConfig[];
+  returningFields?: SelectedFields;
+  returning?: SelectedFieldsOrdered;
+  withList?: Subquery[];
+}
+type CockroachUpdateSetSource<TTable extends CockroachTable> = { [Key in keyof InferInsertModel<TTable>]?: GetColumnData<TTable['_']['columns'][Key]> | SQL | CockroachColumn | Placeholder | undefined } & {};
+declare class CockroachUpdateBuilder<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT> {
+  private table;
+  private session;
+  private dialect;
+  private withList?;
+  static readonly [entityKind]: string;
+  readonly _: {
+    readonly table: TTable;
+  };
+  constructor(table: TTable, session: CockroachSession, dialect: CockroachDialect, withList?: Subquery[] | undefined);
+  set(values: CockroachUpdateSetSource<TTable>): CockroachUpdateWithout<CockroachUpdateBase<TTable, TQueryResult>, false, 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>;
+}
+type CockroachUpdateWithout<T extends AnyCockroachUpdate, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], T['_']['selectedFields'], T['_']['returning'], T['_']['nullabilityMap'], T['_']['joins'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+type CockroachUpdateWithJoins<T extends AnyCockroachUpdate, TDynamic extends boolean, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL> = TDynamic extends true ? T : Omit<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], TFrom, T['_']['selectedFields'], T['_']['returning'], AppendToNullabilityMap<T['_']['nullabilityMap'], GetSelectTableName<TFrom>, 'inner'>, [...T['_']['joins'], {
+  name: GetSelectTableName<TFrom>;
+  joinType: 'inner';
+  table: TFrom;
+}], TDynamic, Exclude<T['_']['excludedMethods'] | 'from', 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>>, Exclude<T['_']['excludedMethods'] | 'from', 'leftJoin' | 'rightJoin' | 'innerJoin' | 'fullJoin'>>;
+type CockroachUpdateJoinFn<T extends AnyCockroachUpdate, TDynamic extends boolean, TJoinType extends JoinType> = <TJoinedTable extends CockroachTable | Subquery | CockroachViewBase | SQL>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: ((updateTable: T['_']['table']['_']['columns'], from: T['_']['from'] extends CockroachTable ? T['_']['from']['_']['columns'] : T['_']['from'] extends Subquery | CockroachViewBase ? T['_']['from']['_']['selectedFields'] : never) => SQL | undefined) | SQL | undefined) => CockroachUpdateJoin<T, TDynamic, TJoinType, TJoinedTable>;
+type CockroachUpdateJoin<T extends AnyCockroachUpdate, TDynamic extends boolean, TJoinType extends JoinType, TJoinedTable extends CockroachTable | Subquery | CockroachViewBase | SQL> = TDynamic extends true ? T : CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], T['_']['selectedFields'], T['_']['returning'], AppendToNullabilityMap<T['_']['nullabilityMap'], GetSelectTableName<TJoinedTable>, TJoinType>, [...T['_']['joins'], {
+  name: GetSelectTableName<TJoinedTable>;
+  joinType: TJoinType;
+  table: TJoinedTable;
+}], TDynamic, T['_']['excludedMethods']>;
+type Join = {
+  name: string | undefined;
+  joinType: JoinType;
+  table: CockroachTable | Subquery | CockroachViewBase | SQL;
+};
+type AccumulateToResult<T extends AnyCockroachUpdate, TSelectMode extends SelectMode, TJoins extends Join[], TSelectedFields extends ColumnsSelection> = TJoins extends [infer TJoin extends Join, ...infer TRest extends Join[]] ? AccumulateToResult<T, TSelectMode extends 'partial' ? TSelectMode : 'multiple', TRest, AppendToResult<T['_']['table']['_']['name'], TSelectedFields, TJoin['name'], TJoin['table'] extends Table ? TJoin['table']['_']['columns'] : TJoin['table'] extends Subquery ? Assume<TJoin['table']['_']['selectedFields'], SelectedFields> : never, TSelectMode extends 'partial' ? TSelectMode : 'multiple'>> : TSelectedFields;
+type CockroachUpdateReturningAll<T extends AnyCockroachUpdate, TDynamic extends boolean> = CockroachUpdateWithout<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], Equal<T['_']['joins'], []> extends true ? T['_']['table']['_']['columns'] : Simplify<Record<T['_']['table']['_']['name'], T['_']['table']['_']['columns']> & { [K in keyof T['_']['joins'] as T['_']['joins'][K]['table']['_']['name']]: T['_']['joins'][K]['table']['_']['columns'] }>, SelectResult<AccumulateToResult<T, 'single', T['_']['joins'], GetSelectTableSelection<T['_']['table']>>, 'partial', T['_']['nullabilityMap']>, T['_']['nullabilityMap'], T['_']['joins'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'returning'>;
+type CockroachUpdateReturning<T extends AnyCockroachUpdate, TDynamic extends boolean, TSelectedFields extends SelectedFields> = CockroachUpdateWithout<CockroachUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['from'], TSelectedFields, SelectResult<AccumulateToResult<T, 'partial', T['_']['joins'], TSelectedFields>, 'partial', T['_']['nullabilityMap']>, T['_']['nullabilityMap'], T['_']['joins'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'returning'>;
+type CockroachUpdatePrepare<T extends AnyCockroachUpdate> = CockroachPreparedQuery<PreparedQueryConfig & {
+  execute: T['_']['returning'] extends undefined ? CockroachQueryResultKind<T['_']['queryResult'], never> : T['_']['returning'][];
+}>;
+type CockroachUpdateDynamic<T extends AnyCockroachUpdate> = CockroachUpdate<T['_']['table'], T['_']['queryResult'], T['_']['from'], T['_']['returning'], T['_']['nullabilityMap']>;
+type CockroachUpdate<TTable extends CockroachTable = CockroachTable, TQueryResult extends CockroachQueryResultHKT = CockroachQueryResultHKT, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined, TSelectedFields extends ColumnsSelection | undefined = undefined, TReturning extends Record<string, unknown> | undefined = Record<string, unknown> | undefined, TNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>, TJoins extends Join[] = []> = CockroachUpdateBase<TTable, TQueryResult, TFrom, TSelectedFields, TReturning, TNullabilityMap, TJoins, true, never>;
+type AnyCockroachUpdate = CockroachUpdateBase<any, any, any, any, any, any, any, any, any>;
+interface CockroachUpdateBase<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined, TSelectedFields extends ColumnsSelection | undefined = undefined, TReturning extends Record<string, unknown> | undefined = undefined, TNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>, TJoins extends Join[] = [], TDynamic extends boolean = false, TExcludedMethods extends string = never> extends TypedQueryBuilder<TSelectedFields, TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]>, QueryPromise<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]>, RunnableQuery<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[], 'cockroach'>, SQLWrapper {
+  readonly _: {
+    readonly dialect: 'cockroach';
+    readonly table: TTable;
+    readonly joins: TJoins;
+    readonly nullabilityMap: TNullabilityMap;
+    readonly queryResult: TQueryResult;
+    readonly from: TFrom;
+    readonly selectedFields: TSelectedFields;
+    readonly returning: TReturning;
+    readonly dynamic: TDynamic;
+    readonly excludedMethods: TExcludedMethods;
+    readonly result: TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[];
+  };
+}
+declare class CockroachUpdateBase<TTable extends CockroachTable, TQueryResult extends CockroachQueryResultHKT, TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL | undefined = undefined, TSelectedFields extends ColumnsSelection | undefined = undefined, TReturning extends Record<string, unknown> | undefined = undefined, TNullabilityMap extends Record<string, JoinNullability> = Record<TTable['_']['name'], 'not-null'>, TJoins extends Join[] = [], TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[]> implements RunnableQuery<TReturning extends undefined ? CockroachQueryResultKind<TQueryResult, never> : TReturning[], 'cockroach'>, SQLWrapper {
+  private session;
+  private dialect;
+  static readonly [entityKind]: string;
+  private config;
+  private tableName;
+  private joinsNotNullableMap;
+  constructor(table: TTable, set: UpdateSet, session: CockroachSession, dialect: CockroachDialect, withList?: Subquery[]);
+  from<TFrom extends CockroachTable | Subquery | CockroachViewBase | SQL>(source: TableLikeHasEmptySelection<TFrom> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TFrom): CockroachUpdateWithJoins<this, TDynamic, TFrom>;
+  private getTableLikeFields;
+  private createJoin;
+  leftJoin: CockroachUpdateJoinFn<this, TDynamic, "left">;
+  rightJoin: CockroachUpdateJoinFn<this, TDynamic, "right">;
+  innerJoin: CockroachUpdateJoinFn<this, TDynamic, "inner">;
+  fullJoin: CockroachUpdateJoinFn<this, TDynamic, "full">;
+  /**
+   * Adds a 'where' clause to the query.
+   *
+   * Calling this method will update only those rows that fulfill a specified condition.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/update}
+   *
+   * @param where the 'where' clause.
+   *
+   * @example
+   * You can use conditional operators and `sql function` to filter the rows to be updated.
+   *
+   * ```ts
+   * // Update all cars with green color
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'));
+   * // or
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(sql`${cars.color} = 'green'`)
+   * ```
+   *
+   * You can logically combine conditional operators with `and()` and `or()` operators:
+   *
+   * ```ts
+   * // Update all BMW cars with a green color
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));
+   *
+   * // Update all cars with the green or blue color
+   * await db.update(cars).set({ color: 'red' })
+   *   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+   * ```
+   */
+  where(where: SQL | undefined): CockroachUpdateWithout<this, TDynamic, 'where'>;
+  /**
+   * Adds a `returning` clause to the query.
+   *
+   * Calling this method will return the specified fields of the updated rows. If no fields are specified, all fields will be returned.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/update#update-with-returning}
+   *
+   * @example
+   * ```ts
+   * // Update all cars with the green color and return all fields
+   * const updatedCars: Car[] = await db.update(cars)
+   *   .set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'))
+   *   .returning();
+   *
+   * // Update all cars with the green color and return only their id and brand fields
+   * const updatedCarsIdsAndBrands: { id: number, brand: string }[] = await db.update(cars)
+   *   .set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'))
+   *   .returning({ id: cars.id, brand: cars.brand });
+   * ```
+   */
+  returning(): CockroachUpdateReturningAll<this, TDynamic>;
+  returning<TSelectedFields extends SelectedFields>(fields: TSelectedFields): CockroachUpdateReturning<this, TDynamic, TSelectedFields>;
+  toSQL(): Query;
+  prepare(name?: string): CockroachUpdatePrepare<this>;
+  execute: ReturnType<this['prepare']>['execute'];
+  $dynamic(): CockroachUpdateDynamic<this>;
+}
+//#endregion
+export { AnyCockroachUpdate, CockroachUpdate, CockroachUpdateBase, CockroachUpdateBuilder, CockroachUpdateConfig, CockroachUpdateDynamic, CockroachUpdateJoin, CockroachUpdateJoinFn, CockroachUpdatePrepare, CockroachUpdateReturning, CockroachUpdateReturningAll, CockroachUpdateSetSource, CockroachUpdateWithJoins, CockroachUpdateWithout };
+//# sourceMappingURL=update.d.ts.map

package/cockroach-core/query-builders/update.js

@@ -0,0 +1,196 @@
+import { entityKind, is } from "../../entity.js";
+import { Table, getTableName } from "../../table.js";
+import { getTableLikeName, mapUpdateSet, orderSelectedFields } from "../../utils.js";
+import { SQL } from "../../sql/sql.js";
+import { Subquery } from "../../subquery.js";
+import { ViewBaseConfig } from "../../view-common.js";
+import { preparedStatementName } from "../../query-name-generator.js";
+import { SelectionProxyHandler } from "../../selection-proxy.js";
+import { QueryPromise } from "../../query-promise.js";
+import { CockroachTable } from "../table.js";
+
+//#region src/cockroach-core/query-builders/update.ts
+var CockroachUpdateBuilder = class {
+	static [entityKind] = "CockroachUpdateBuilder";
+	constructor(table, session, dialect, withList) {
+		this.table = table;
+		this.session = session;
+		this.dialect = dialect;
+		this.withList = withList;
+	}
+	set(values) {
+		return new CockroachUpdateBase(this.table, mapUpdateSet(this.table, values), this.session, this.dialect, this.withList);
+	}
+};
+var CockroachUpdateBase = class extends QueryPromise {
+	static [entityKind] = "CockroachUpdate";
+	config;
+	tableName;
+	joinsNotNullableMap;
+	constructor(table, set, session, dialect, withList) {
+		super();
+		this.session = session;
+		this.dialect = dialect;
+		this.config = {
+			set,
+			table,
+			withList,
+			joins: []
+		};
+		this.tableName = getTableLikeName(table);
+		this.joinsNotNullableMap = typeof this.tableName === "string" ? { [this.tableName]: true } : {};
+	}
+	from(source) {
+		const src = source;
+		const tableName = getTableLikeName(src);
+		if (typeof tableName === "string") this.joinsNotNullableMap[tableName] = true;
+		this.config.from = src;
+		return this;
+	}
+	getTableLikeFields(table) {
+		if (is(table, CockroachTable)) return table[Table.Symbol.Columns];
+		else if (is(table, Subquery)) return table._.selectedFields;
+		return table[ViewBaseConfig].selectedFields;
+	}
+	createJoin(joinType) {
+		return ((table, on) => {
+			const tableName = getTableLikeName(table);
+			if (typeof tableName === "string" && this.config.joins.some((join) => join.alias === tableName)) throw new Error(`Alias "${tableName}" is already used in this query`);
+			if (typeof on === "function") {
+				const from = this.config.from && !is(this.config.from, SQL) ? this.getTableLikeFields(this.config.from) : void 0;
+				on = on(new Proxy(this.config.table[Table.Symbol.Columns], new SelectionProxyHandler({
+					sqlAliasedBehavior: "sql",
+					sqlBehavior: "sql"
+				})), from && new Proxy(from, new SelectionProxyHandler({
+					sqlAliasedBehavior: "sql",
+					sqlBehavior: "sql"
+				})));
+			}
+			this.config.joins.push({
+				on,
+				table,
+				joinType,
+				alias: tableName
+			});
+			if (typeof tableName === "string") switch (joinType) {
+				case "left":
+					this.joinsNotNullableMap[tableName] = false;
+					break;
+				case "right":
+					this.joinsNotNullableMap = Object.fromEntries(Object.entries(this.joinsNotNullableMap).map(([key]) => [key, false]));
+					this.joinsNotNullableMap[tableName] = true;
+					break;
+				case "inner":
+					this.joinsNotNullableMap[tableName] = true;
+					break;
+				case "full":
+					this.joinsNotNullableMap = Object.fromEntries(Object.entries(this.joinsNotNullableMap).map(([key]) => [key, false]));
+					this.joinsNotNullableMap[tableName] = false;
+					break;
+			}
+			return this;
+		});
+	}
+	leftJoin = this.createJoin("left");
+	rightJoin = this.createJoin("right");
+	innerJoin = this.createJoin("inner");
+	fullJoin = this.createJoin("full");
+	/**
+	* Adds a 'where' clause to the query.
+	*
+	* Calling this method will update only those rows that fulfill a specified condition.
+	*
+	* See docs: {@link https://orm.drizzle.team/docs/update}
+	*
+	* @param where the 'where' clause.
+	*
+	* @example
+	* You can use conditional operators and `sql function` to filter the rows to be updated.
+	*
+	* ```ts
+	* // Update all cars with green color
+	* await db.update(cars).set({ color: 'red' })
+	*   .where(eq(cars.color, 'green'));
+	* // or
+	* await db.update(cars).set({ color: 'red' })
+	*   .where(sql`${cars.color} = 'green'`)
+	* ```
+	*
+	* You can logically combine conditional operators with `and()` and `or()` operators:
+	*
+	* ```ts
+	* // Update all BMW cars with a green color
+	* await db.update(cars).set({ color: 'red' })
+	*   .where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));
+	*
+	* // Update all cars with the green or blue color
+	* await db.update(cars).set({ color: 'red' })
+	*   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+	* ```
+	*/
+	where(where) {
+		this.config.where = where;
+		return this;
+	}
+	returning(fields) {
+		if (!fields) {
+			fields = Object.assign({}, this.config.table[Table.Symbol.Columns]);
+			if (this.config.from) {
+				const tableName = getTableLikeName(this.config.from);
+				if (typeof tableName === "string" && this.config.from && !is(this.config.from, SQL)) {
+					const fromFields = this.getTableLikeFields(this.config.from);
+					fields[tableName] = fromFields;
+				}
+				for (const join of this.config.joins) {
+					const tableName = getTableLikeName(join.table);
+					if (typeof tableName === "string" && !is(join.table, SQL)) {
+						const fromFields = this.getTableLikeFields(join.table);
+						fields[tableName] = fromFields;
+					}
+				}
+			}
+		}
+		this.config.returningFields = fields;
+		this.config.returning = orderSelectedFields(fields);
+		return this;
+	}
+	/** @internal */
+	getSQL() {
+		return this.dialect.buildUpdateQuery(this.config);
+	}
+	toSQL() {
+		return this.dialect.sqlToQuery(this.getSQL());
+	}
+	/** @internal */
+	_prepare(name, generateName = false) {
+		const query = this.dialect.sqlToQuery(this.getSQL());
+		const preparedQuery = this.session.prepareQuery(query, this.config.returning, name ?? (generateName ? preparedStatementName(query.sql, query.params) : name));
+		preparedQuery.joinsNotNullableMap = this.joinsNotNullableMap;
+		return preparedQuery;
+	}
+	prepare(name) {
+		return this._prepare(name, true);
+	}
+	execute = (placeholderValues) => {
+		return this._prepare().execute(placeholderValues);
+	};
+	/** @internal */
+	getSelectedFields() {
+		return this.config.returningFields ? new Proxy(this.config.returningFields, new SelectionProxyHandler({
+			alias: getTableName(this.config.table),
+			sqlAliasedBehavior: "alias",
+			sqlBehavior: "error"
+		})) : void 0;
+	}
+	/** @internal */
+	withoutSelectionCastCodecs() {
+		return this;
+	}
+	$dynamic() {
+		return this;
+	}
+};
+
+//#endregion
+export { CockroachUpdateBase, CockroachUpdateBuilder };
+//# sourceMappingURL=update.js.map