drizzle-orm 1.0.0-beta.1-7722e6a → 1.0.0-beta.2-e93475f

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mssql-core/query-builders/update.ts"],"sourcesContent":["import type { GetColumnData } from '~/column.ts';\nimport { entityKind } from '~/entity.ts';\nimport type { MsSqlDialect } from '~/mssql-core/dialect.ts';\nimport type {\n\tAnyQueryResultHKT,\n\tMsSqlSession,\n\tPreparedQueryConfig,\n\tPreparedQueryHKTBase,\n\tPreparedQueryKind,\n\tQueryResultHKT,\n\tQueryResultKind,\n} from '~/mssql-core/session.ts';\nimport type { MsSqlTable } from '~/mssql-core/table.ts';\nimport type { SelectResultFields } from '~/query-builders/select.types.ts';\nimport { QueryPromise } from '~/query-promise.ts';\nimport type { ExtractObjectValues } from '~/relations.ts';\nimport type { Query, SQL, SQLWrapper } from '~/sql/sql.ts';\nimport { type InferInsertModel, Table } from '~/table.ts';\nimport { mapUpdateSet, orderSelectedFields, type UpdateSet } from '~/utils.ts';\nimport type { MsSqlColumn } from '../columns/common.ts';\nimport type { SelectedFieldsFlatUpdate, SelectedFieldsOrdered } from './select.types.ts';\n\nexport interface MsSqlUpdateConfig {\n\twhere?: SQL | undefined;\n\tset: UpdateSet;\n\ttable: MsSqlTable;\n\toutput?: {\n\t\tinserted?: SelectedFieldsOrdered;\n\t\tdeleted?: SelectedFieldsOrdered;\n\t};\n}\n\nexport type MsSqlUpdateSetSource<TTable extends MsSqlTable> =\n\t& {\n\t\t[Key in keyof InferInsertModel<TTable>]?:\n\t\t\t| GetColumnData<TTable['_']['columns'][Key], 'query'>\n\t\t\t| SQL;\n\t}\n\t& {};\n\nexport type NonUndefinedKeysOnly<T> =\n\t& ExtractObjectValues<\n\t\t{\n\t\t\t[K in keyof T as T[K] extends undefined ? never : K]: K;\n\t\t}\n\t>\n\t& keyof T;\n\nexport type FormSelection<T, TTable extends MsSqlTable> = {\n\t[K in keyof T as T[K] extends undefined ? never : K]: T[K] extends true ? TTable['_']['columns'] : T[K];\n};\n\nexport type MsSqlUpdateReturning<\n\tT extends AnyMsSqlUpdateBase,\n\tTDynamic extends boolean,\n\tSelectedFields extends SelectedFieldsFlatUpdate,\n> = MsSqlUpdateWithout<\n\tMsSqlUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tSelectResultFields<FormSelection<SelectedFields, T['_']['table']>>,\n\t\tTDynamic,\n\t\tT['_']['excludedMethods']\n\t>,\n\tTDynamic,\n\t'output'\n>;\n\nexport type MsSqlUpdateReturningAll<T extends AnyMsSqlUpdateBase, TDynamic extends boolean> = MsSqlUpdateWithout<\n\tMsSqlUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tT['_']['table']['$inferSelect'],\n\t\tTDynamic,\n\t\tT['_']['excludedMethods']\n\t>,\n\tTDynamic,\n\t'output'\n>;\n\nexport class MsSqlUpdateBuilder<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n> {\n\tstatic readonly [entityKind]: string = 'MsSqlUpdateBuilder';\n\n\tdeclare readonly _: {\n\t\treadonly table: TTable;\n\t};\n\n\tconstructor(\n\t\tprivate table: TTable,\n\t\tprivate session: MsSqlSession,\n\t\tprivate dialect: MsSqlDialect,\n\t) {}\n\n\tset(values: MsSqlUpdateSetSource<TTable>): MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT> {\n\t\treturn new MsSqlUpdateBase(this.table, mapUpdateSet(this.table, values), this.session, this.dialect);\n\t}\n}\n\nexport type MsSqlUpdateWithout<\n\tT extends AnyMsSqlUpdateBase,\n\tTDynamic extends boolean,\n\tK extends keyof T & string,\n> = TDynamic extends true ? T : Omit<\n\tMsSqlUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tT['_']['output'],\n\t\tTDynamic,\n\t\tT['_']['excludedMethods'] | K\n\t>,\n\tT['_']['excludedMethods'] | K\n>;\n\nexport type MsSqlUpdatePrepare<T extends AnyMsSqlUpdateBase> = PreparedQueryKind<\n\tT['_']['preparedQueryHKT'],\n\tPreparedQueryConfig & {\n\t\texecute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];\n\t\titerator: never;\n\t}\n>;\n\nexport type MsSqlUpdateDynamic<T extends AnyMsSqlUpdateBase> = MsSqlUpdate<\n\tT['_']['table'],\n\tT['_']['queryResult'],\n\tT['_']['preparedQueryHKT'],\n\tT['_']['output']\n>;\n\nexport type MsSqlUpdate<\n\tTTable extends MsSqlTable = MsSqlTable,\n\tTQueryResult extends QueryResultHKT = AnyQueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase,\n\tTOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined,\n> = MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;\n\nexport type AnyMsSqlUpdateBase = MsSqlUpdateBase<any, any, any, any, any, any>;\n\nexport interface MsSqlUpdateBase<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n\tTOutput extends Record<string, unknown> | undefined = undefined,\n\tTDynamic extends boolean = false,\n\tTExcludedMethods extends string = never,\n> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>, SQLWrapper {\n\treadonly _: {\n\t\treadonly table: TTable;\n\t\treadonly queryResult: TQueryResult;\n\t\treadonly preparedQueryHKT: TPreparedQueryHKT;\n\t\treadonly output: TOutput;\n\t\treadonly dynamic: TDynamic;\n\t\treadonly excludedMethods: TExcludedMethods;\n\t};\n}\n\nexport class MsSqlUpdateBase<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTOutput extends Record<string, unknown> | undefined = undefined,\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<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>\n\timplements SQLWrapper\n{\n\tstatic override readonly [entityKind]: string = 'MsSqlUpdate';\n\n\tprivate config: MsSqlUpdateConfig;\n\n\tconstructor(\n\t\ttable: TTable,\n\t\tset: UpdateSet,\n\t\tprivate session: MsSqlSession,\n\t\tprivate dialect: MsSqlDialect,\n\t) {\n\t\tsuper();\n\t\tthis.config = { set, table };\n\t}\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 * db.update(cars).set({ color: 'red' })\n\t *   .where(eq(cars.color, 'green'));\n\t * // or\n\t * 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 * 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 * 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): MsSqlUpdateWithout<this, TDynamic, 'where'> {\n\t\tthis.config.where = where;\n\t\treturn this as any;\n\t}\n\n\t/**\n\t * Adds an `output` clause to the query.\n\t *\n\t * This method allows you to return values from the rows affected by the query.\n\t * MSSQL supports returning `inserted` (new row values) and `deleted` (old row values) values.\n\t *\n\t * If no fields are specified, all `inserted` values will be returned by default.\n\t *\n\t * @example\n\t * ```ts\n\t * // Update cars and return all new values\n\t * const updatedCars: Car[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .output()\n\t *   .where(eq(cars.color, 'green'));\n\t *\n\t * // Update cars and return all old values\n\t * const updatedCarsIds: { deleted: Car }[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .output({ deleted: true })\n\t *   .where(eq(cars.color, 'green'));\n\t *\n\t * // Update cars and return partial old and new values\n\t * const beforeAndAfter: { deleted: { oldColor: string }, inserted: { newColor: string } }[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .output({\n\t *     deleted: { oldColor: cars.color },\n\t *     inserted: { newColor: cars.color }\n\t *   })\n\t *   .where(eq(cars.color, 'green'));\n\t * ```\n\t */\n\toutput(): MsSqlUpdateReturningAll<this, TDynamic>;\n\toutput<TSelectedFields extends SelectedFieldsFlatUpdate>(\n\t\tfields: TSelectedFields,\n\t): MsSqlUpdateReturning<this, TDynamic, TSelectedFields>;\n\toutput(\n\t\tfields?: SelectedFieldsFlatUpdate,\n\t): MsSqlUpdateWithout<AnyMsSqlUpdateBase, TDynamic, 'output'> {\n\t\tconst columns = this.config.table[Table.Symbol.Columns];\n\n\t\tif (fields) {\n\t\t\tconst output: typeof this.config.output = {};\n\n\t\t\tif (fields.inserted) {\n\t\t\t\toutput.inserted = typeof fields.inserted === 'boolean'\n\t\t\t\t\t? orderSelectedFields<MsSqlColumn>(columns, ['inserted'])\n\t\t\t\t\t: orderSelectedFields<MsSqlColumn>(fields.inserted, ['inserted']);\n\t\t\t}\n\n\t\t\tif (fields.deleted) {\n\t\t\t\toutput.deleted = typeof fields.deleted === 'boolean'\n\t\t\t\t\t? orderSelectedFields<MsSqlColumn>(columns, ['deleted'])\n\t\t\t\t\t: orderSelectedFields<MsSqlColumn>(fields.deleted, ['deleted']);\n\t\t\t}\n\n\t\t\tthis.config.output = output;\n\t\t} else {\n\t\t\tthis.config.output = {\n\t\t\t\tinserted: orderSelectedFields<MsSqlColumn>(columns),\n\t\t\t};\n\t\t}\n\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\tconst { typings: _typings, ...rest } = this.dialect.sqlToQuery(this.getSQL());\n\t\treturn rest;\n\t}\n\n\tprepare(): MsSqlUpdatePrepare<this> {\n\t\tconst output = [...(this.config.output?.inserted ?? []), ...(this.config.output?.deleted ?? [])];\n\n\t\treturn this.session.prepareQuery(\n\t\t\tthis.dialect.sqlToQuery(this.getSQL()),\n\t\t\toutput.length ? output : undefined,\n\t\t) as MsSqlUpdatePrepare<this>;\n\t}\n\n\toverride execute(\n\t\tplaceholderValues?: Record<string, unknown>,\n\t): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]> {\n\t\treturn this.prepare().execute(placeholderValues) as any;\n\t}\n\n\tprivate createIterator = (): ReturnType<this['prepare']>['iterator'] => {\n\t\tconst self = this;\n\t\treturn async function*(placeholderValues) {\n\t\t\tyield* self.prepare().iterator(placeholderValues);\n\t\t};\n\t};\n\n\titerator = this.createIterator();\n\n\t$dynamic(): MsSqlUpdateDynamic<this> {\n\t\treturn this as any;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,oBAA2B;AAa3B,2BAA6B;AAG7B,mBAA6C;AAC7C,mBAAkE;AAgE3D,MAAM,mBAIX;AAAA,EAOD,YACS,OACA,SACA,SACP;AAHO;AACA;AACA;AAAA,EACN;AAAA,EAVH,QAAiB,wBAAU,IAAY;AAAA,EAYvC,IAAI,QAAgG;AACnG,WAAO,IAAI,gBAAgB,KAAK,WAAO,2BAAa,KAAK,OAAO,MAAM,GAAG,KAAK,SAAS,KAAK,OAAO;AAAA,EACpG;AACD;AA4DO,MAAM,wBAWH,kCAEV;AAAA,EAKC,YACC,OACA,KACQ,SACA,SACP;AACD,UAAM;AAHE;AACA;AAGR,SAAK,SAAS,EAAE,KAAK,MAAM;AAAA,EAC5B;AAAA,EAZA,QAA0B,wBAAU,IAAY;AAAA,EAExC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6CR,MAAM,OAAqE;AAC1E,SAAK,OAAO,QAAQ;AACpB,WAAO;AAAA,EACR;AAAA,EAsCA,OACC,QAC6D;AAC7D,UAAM,UAAU,KAAK,OAAO,MAAM,mBAAM,OAAO,OAAO;AAEtD,QAAI,QAAQ;AACX,YAAM,SAAoC,CAAC;AAE3C,UAAI,OAAO,UAAU;AACpB,eAAO,WAAW,OAAO,OAAO,aAAa,gBAC1C,kCAAiC,SAAS,CAAC,UAAU,CAAC,QACtD,kCAAiC,OAAO,UAAU,CAAC,UAAU,CAAC;AAAA,MAClE;AAEA,UAAI,OAAO,SAAS;AACnB,eAAO,UAAU,OAAO,OAAO,YAAY,gBACxC,kCAAiC,SAAS,CAAC,SAAS,CAAC,QACrD,kCAAiC,OAAO,SAAS,CAAC,SAAS,CAAC;AAAA,MAChE;AAEA,WAAK,OAAO,SAAS;AAAA,IACtB,OAAO;AACN,WAAK,OAAO,SAAS;AAAA,QACpB,cAAU,kCAAiC,OAAO;AAAA,MACnD;AAAA,IACD;AAEA,WAAO;AAAA,EACR;AAAA;AAAA,EAGA,SAAc;AACb,WAAO,KAAK,QAAQ,iBAAiB,KAAK,MAAM;AAAA,EACjD;AAAA,EAEA,QAAe;AACd,UAAM,EAAE,SAAS,UAAU,GAAG,KAAK,IAAI,KAAK,QAAQ,WAAW,KAAK,OAAO,CAAC;AAC5E,WAAO;AAAA,EACR;AAAA,EAEA,UAAoC;AACnC,UAAM,SAAS,CAAC,GAAI,KAAK,OAAO,QAAQ,YAAY,CAAC,GAAI,GAAI,KAAK,OAAO,QAAQ,WAAW,CAAC,CAAE;AAE/F,WAAO,KAAK,QAAQ;AAAA,MACnB,KAAK,QAAQ,WAAW,KAAK,OAAO,CAAC;AAAA,MACrC,OAAO,SAAS,SAAS;AAAA,IAC1B;AAAA,EACD;AAAA,EAES,QACR,mBACsF;AACtF,WAAO,KAAK,QAAQ,EAAE,QAAQ,iBAAiB;AAAA,EAChD;AAAA,EAEQ,iBAAiB,MAA+C;AACvE,UAAM,OAAO;AACb,WAAO,iBAAgB,mBAAmB;AACzC,aAAO,KAAK,QAAQ,EAAE,SAAS,iBAAiB;AAAA,IACjD;AAAA,EACD;AAAA,EAEA,WAAW,KAAK,eAAe;AAAA,EAE/B,WAAqC;AACpC,WAAO;AAAA,EACR;AACD;","names":[]}

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

@@ -0,0 +1,142 @@
+import type { GetColumnData } from "../../column.cjs";
+import { entityKind } from "../../entity.cjs";
+import type { MsSqlDialect } from "../dialect.cjs";
+import type { AnyQueryResultHKT, MsSqlSession, PreparedQueryConfig, PreparedQueryHKTBase, PreparedQueryKind, QueryResultHKT, QueryResultKind } from "../session.cjs";
+import type { MsSqlTable } from "../table.cjs";
+import type { SelectResultFields } from "../../query-builders/select.types.cjs";
+import { QueryPromise } from "../../query-promise.cjs";
+import type { ExtractObjectValues } from "../../relations.cjs";
+import type { Query, SQL, SQLWrapper } from "../../sql/sql.cjs";
+import { type InferInsertModel } from "../../table.cjs";
+import { type UpdateSet } from "../../utils.cjs";
+import type { SelectedFieldsFlatUpdate, SelectedFieldsOrdered } from "./select.types.cjs";
+export interface MsSqlUpdateConfig {
+    where?: SQL | undefined;
+    set: UpdateSet;
+    table: MsSqlTable;
+    output?: {
+        inserted?: SelectedFieldsOrdered;
+        deleted?: SelectedFieldsOrdered;
+    };
+}
+export type MsSqlUpdateSetSource<TTable extends MsSqlTable> = {
+    [Key in keyof InferInsertModel<TTable>]?: GetColumnData<TTable['_']['columns'][Key], 'query'> | SQL;
+} & {};
+export type NonUndefinedKeysOnly<T> = ExtractObjectValues<{
+    [K in keyof T as T[K] extends undefined ? never : K]: K;
+}> & keyof T;
+export type FormSelection<T, TTable extends MsSqlTable> = {
+    [K in keyof T as T[K] extends undefined ? never : K]: T[K] extends true ? TTable['_']['columns'] : T[K];
+};
+export type MsSqlUpdateReturning<T extends AnyMsSqlUpdateBase, TDynamic extends boolean, SelectedFields extends SelectedFieldsFlatUpdate> = MsSqlUpdateWithout<MsSqlUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], SelectResultFields<FormSelection<SelectedFields, T['_']['table']>>, TDynamic, T['_']['excludedMethods']>, TDynamic, 'output'>;
+export type MsSqlUpdateReturningAll<T extends AnyMsSqlUpdateBase, TDynamic extends boolean> = MsSqlUpdateWithout<MsSqlUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['table']['$inferSelect'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'output'>;
+export declare class MsSqlUpdateBuilder<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase> {
+    private table;
+    private session;
+    private dialect;
+    static readonly [entityKind]: string;
+    readonly _: {
+        readonly table: TTable;
+    };
+    constructor(table: TTable, session: MsSqlSession, dialect: MsSqlDialect);
+    set(values: MsSqlUpdateSetSource<TTable>): MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT>;
+}
+export type MsSqlUpdateWithout<T extends AnyMsSqlUpdateBase, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<MsSqlUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+export type MsSqlUpdatePrepare<T extends AnyMsSqlUpdateBase> = PreparedQueryKind<T['_']['preparedQueryHKT'], PreparedQueryConfig & {
+    execute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];
+    iterator: never;
+}>;
+export type MsSqlUpdateDynamic<T extends AnyMsSqlUpdateBase> = MsSqlUpdate<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output']>;
+export type MsSqlUpdate<TTable extends MsSqlTable = MsSqlTable, TQueryResult extends QueryResultHKT = AnyQueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> = MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;
+export type AnyMsSqlUpdateBase = MsSqlUpdateBase<any, any, any, any, any, any>;
+export interface MsSqlUpdateBase<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = undefined, TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>, SQLWrapper {
+    readonly _: {
+        readonly table: TTable;
+        readonly queryResult: TQueryResult;
+        readonly preparedQueryHKT: TPreparedQueryHKT;
+        readonly output: TOutput;
+        readonly dynamic: TDynamic;
+        readonly excludedMethods: TExcludedMethods;
+    };
+}
+export declare class MsSqlUpdateBase<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = undefined, TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]> implements SQLWrapper {
+    private session;
+    private dialect;
+    static readonly [entityKind]: string;
+    private config;
+    constructor(table: TTable, set: UpdateSet, session: MsSqlSession, dialect: MsSqlDialect);
+    /**
+     * 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
+     * db.update(cars).set({ color: 'red' })
+     *   .where(eq(cars.color, 'green'));
+     * // or
+     * 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
+     * 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
+     * db.update(cars).set({ color: 'red' })
+     *   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+     * ```
+     */
+    where(where: SQL | undefined): MsSqlUpdateWithout<this, TDynamic, 'where'>;
+    /**
+     * Adds an `output` clause to the query.
+     *
+     * This method allows you to return values from the rows affected by the query.
+     * MSSQL supports returning `inserted` (new row values) and `deleted` (old row values) values.
+     *
+     * If no fields are specified, all `inserted` values will be returned by default.
+     *
+     * @example
+     * ```ts
+     * // Update cars and return all new values
+     * const updatedCars: Car[] = await db.update(cars)
+     *   .set({ color: 'red' })
+     *   .output()
+     *   .where(eq(cars.color, 'green'));
+     *
+     * // Update cars and return all old values
+     * const updatedCarsIds: { deleted: Car }[] = await db.update(cars)
+     *   .set({ color: 'red' })
+     *   .output({ deleted: true })
+     *   .where(eq(cars.color, 'green'));
+     *
+     * // Update cars and return partial old and new values
+     * const beforeAndAfter: { deleted: { oldColor: string }, inserted: { newColor: string } }[] = await db.update(cars)
+     *   .set({ color: 'red' })
+     *   .output({
+     *     deleted: { oldColor: cars.color },
+     *     inserted: { newColor: cars.color }
+     *   })
+     *   .where(eq(cars.color, 'green'));
+     * ```
+     */
+    output(): MsSqlUpdateReturningAll<this, TDynamic>;
+    output<TSelectedFields extends SelectedFieldsFlatUpdate>(fields: TSelectedFields): MsSqlUpdateReturning<this, TDynamic, TSelectedFields>;
+    toSQL(): Query;
+    prepare(): MsSqlUpdatePrepare<this>;
+    execute(placeholderValues?: Record<string, unknown>): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>;
+    private createIterator;
+    iterator: ReturnType<this["prepare"]>["iterator"];
+    $dynamic(): MsSqlUpdateDynamic<this>;
+}

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

@@ -0,0 +1,142 @@
+import type { GetColumnData } from "../../column.js";
+import { entityKind } from "../../entity.js";
+import type { MsSqlDialect } from "../dialect.js";
+import type { AnyQueryResultHKT, MsSqlSession, PreparedQueryConfig, PreparedQueryHKTBase, PreparedQueryKind, QueryResultHKT, QueryResultKind } from "../session.js";
+import type { MsSqlTable } from "../table.js";
+import type { SelectResultFields } from "../../query-builders/select.types.js";
+import { QueryPromise } from "../../query-promise.js";
+import type { ExtractObjectValues } from "../../relations.js";
+import type { Query, SQL, SQLWrapper } from "../../sql/sql.js";
+import { type InferInsertModel } from "../../table.js";
+import { type UpdateSet } from "../../utils.js";
+import type { SelectedFieldsFlatUpdate, SelectedFieldsOrdered } from "./select.types.js";
+export interface MsSqlUpdateConfig {
+    where?: SQL | undefined;
+    set: UpdateSet;
+    table: MsSqlTable;
+    output?: {
+        inserted?: SelectedFieldsOrdered;
+        deleted?: SelectedFieldsOrdered;
+    };
+}
+export type MsSqlUpdateSetSource<TTable extends MsSqlTable> = {
+    [Key in keyof InferInsertModel<TTable>]?: GetColumnData<TTable['_']['columns'][Key], 'query'> | SQL;
+} & {};
+export type NonUndefinedKeysOnly<T> = ExtractObjectValues<{
+    [K in keyof T as T[K] extends undefined ? never : K]: K;
+}> & keyof T;
+export type FormSelection<T, TTable extends MsSqlTable> = {
+    [K in keyof T as T[K] extends undefined ? never : K]: T[K] extends true ? TTable['_']['columns'] : T[K];
+};
+export type MsSqlUpdateReturning<T extends AnyMsSqlUpdateBase, TDynamic extends boolean, SelectedFields extends SelectedFieldsFlatUpdate> = MsSqlUpdateWithout<MsSqlUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], SelectResultFields<FormSelection<SelectedFields, T['_']['table']>>, TDynamic, T['_']['excludedMethods']>, TDynamic, 'output'>;
+export type MsSqlUpdateReturningAll<T extends AnyMsSqlUpdateBase, TDynamic extends boolean> = MsSqlUpdateWithout<MsSqlUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['table']['$inferSelect'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'output'>;
+export declare class MsSqlUpdateBuilder<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase> {
+    private table;
+    private session;
+    private dialect;
+    static readonly [entityKind]: string;
+    readonly _: {
+        readonly table: TTable;
+    };
+    constructor(table: TTable, session: MsSqlSession, dialect: MsSqlDialect);
+    set(values: MsSqlUpdateSetSource<TTable>): MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT>;
+}
+export type MsSqlUpdateWithout<T extends AnyMsSqlUpdateBase, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<MsSqlUpdateBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+export type MsSqlUpdatePrepare<T extends AnyMsSqlUpdateBase> = PreparedQueryKind<T['_']['preparedQueryHKT'], PreparedQueryConfig & {
+    execute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];
+    iterator: never;
+}>;
+export type MsSqlUpdateDynamic<T extends AnyMsSqlUpdateBase> = MsSqlUpdate<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output']>;
+export type MsSqlUpdate<TTable extends MsSqlTable = MsSqlTable, TQueryResult extends QueryResultHKT = AnyQueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> = MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;
+export type AnyMsSqlUpdateBase = MsSqlUpdateBase<any, any, any, any, any, any>;
+export interface MsSqlUpdateBase<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = undefined, TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>, SQLWrapper {
+    readonly _: {
+        readonly table: TTable;
+        readonly queryResult: TQueryResult;
+        readonly preparedQueryHKT: TPreparedQueryHKT;
+        readonly output: TOutput;
+        readonly dynamic: TDynamic;
+        readonly excludedMethods: TExcludedMethods;
+    };
+}
+export declare class MsSqlUpdateBase<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = undefined, TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]> implements SQLWrapper {
+    private session;
+    private dialect;
+    static readonly [entityKind]: string;
+    private config;
+    constructor(table: TTable, set: UpdateSet, session: MsSqlSession, dialect: MsSqlDialect);
+    /**
+     * 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
+     * db.update(cars).set({ color: 'red' })
+     *   .where(eq(cars.color, 'green'));
+     * // or
+     * 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
+     * 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
+     * db.update(cars).set({ color: 'red' })
+     *   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+     * ```
+     */
+    where(where: SQL | undefined): MsSqlUpdateWithout<this, TDynamic, 'where'>;
+    /**
+     * Adds an `output` clause to the query.
+     *
+     * This method allows you to return values from the rows affected by the query.
+     * MSSQL supports returning `inserted` (new row values) and `deleted` (old row values) values.
+     *
+     * If no fields are specified, all `inserted` values will be returned by default.
+     *
+     * @example
+     * ```ts
+     * // Update cars and return all new values
+     * const updatedCars: Car[] = await db.update(cars)
+     *   .set({ color: 'red' })
+     *   .output()
+     *   .where(eq(cars.color, 'green'));
+     *
+     * // Update cars and return all old values
+     * const updatedCarsIds: { deleted: Car }[] = await db.update(cars)
+     *   .set({ color: 'red' })
+     *   .output({ deleted: true })
+     *   .where(eq(cars.color, 'green'));
+     *
+     * // Update cars and return partial old and new values
+     * const beforeAndAfter: { deleted: { oldColor: string }, inserted: { newColor: string } }[] = await db.update(cars)
+     *   .set({ color: 'red' })
+     *   .output({
+     *     deleted: { oldColor: cars.color },
+     *     inserted: { newColor: cars.color }
+     *   })
+     *   .where(eq(cars.color, 'green'));
+     * ```
+     */
+    output(): MsSqlUpdateReturningAll<this, TDynamic>;
+    output<TSelectedFields extends SelectedFieldsFlatUpdate>(fields: TSelectedFields): MsSqlUpdateReturning<this, TDynamic, TSelectedFields>;
+    toSQL(): Query;
+    prepare(): MsSqlUpdatePrepare<this>;
+    execute(placeholderValues?: Record<string, unknown>): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>;
+    private createIterator;
+    iterator: ReturnType<this["prepare"]>["iterator"];
+    $dynamic(): MsSqlUpdateDynamic<this>;
+}

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

@@ -0,0 +1,113 @@
+import { entityKind } from "../../entity.js";
+import { QueryPromise } from "../../query-promise.js";
+import { Table } from "../../table.js";
+import { mapUpdateSet, orderSelectedFields } from "../../utils.js";
+class MsSqlUpdateBuilder {
+  constructor(table, session, dialect) {
+    this.table = table;
+    this.session = session;
+    this.dialect = dialect;
+  }
+  static [entityKind] = "MsSqlUpdateBuilder";
+  set(values) {
+    return new MsSqlUpdateBase(this.table, mapUpdateSet(this.table, values), this.session, this.dialect);
+  }
+}
+class MsSqlUpdateBase extends QueryPromise {
+  constructor(table, set, session, dialect) {
+    super();
+    this.session = session;
+    this.dialect = dialect;
+    this.config = { set, table };
+  }
+  static [entityKind] = "MsSqlUpdate";
+  config;
+  /**
+   * 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
+   * db.update(cars).set({ color: 'red' })
+   *   .where(eq(cars.color, 'green'));
+   * // or
+   * 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
+   * 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
+   * db.update(cars).set({ color: 'red' })
+   *   .where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+   * ```
+   */
+  where(where) {
+    this.config.where = where;
+    return this;
+  }
+  output(fields) {
+    const columns = this.config.table[Table.Symbol.Columns];
+    if (fields) {
+      const output = {};
+      if (fields.inserted) {
+        output.inserted = typeof fields.inserted === "boolean" ? orderSelectedFields(columns, ["inserted"]) : orderSelectedFields(fields.inserted, ["inserted"]);
+      }
+      if (fields.deleted) {
+        output.deleted = typeof fields.deleted === "boolean" ? orderSelectedFields(columns, ["deleted"]) : orderSelectedFields(fields.deleted, ["deleted"]);
+      }
+      this.config.output = output;
+    } else {
+      this.config.output = {
+        inserted: orderSelectedFields(columns)
+      };
+    }
+    return this;
+  }
+  /** @internal */
+  getSQL() {
+    return this.dialect.buildUpdateQuery(this.config);
+  }
+  toSQL() {
+    const { typings: _typings, ...rest } = this.dialect.sqlToQuery(this.getSQL());
+    return rest;
+  }
+  prepare() {
+    const output = [...(this.config.output?.inserted ?? []), ...(this.config.output?.deleted ?? [])];
+    return this.session.prepareQuery(
+      this.dialect.sqlToQuery(this.getSQL()),
+      output.length ? output : void 0
+    );
+  }
+  execute(placeholderValues) {
+    return this.prepare().execute(placeholderValues);
+  }
+  createIterator = () => {
+    const self = this;
+    return async function* (placeholderValues) {
+      yield* self.prepare().iterator(placeholderValues);
+    };
+  };
+  iterator = this.createIterator();
+  $dynamic() {
+    return this;
+  }
+}
+export {
+  MsSqlUpdateBase,
+  MsSqlUpdateBuilder
+};
+//# sourceMappingURL=update.js.map

package/mssql-core/query-builders/update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mssql-core/query-builders/update.ts"],"sourcesContent":["import type { GetColumnData } from '~/column.ts';\nimport { entityKind } from '~/entity.ts';\nimport type { MsSqlDialect } from '~/mssql-core/dialect.ts';\nimport type {\n\tAnyQueryResultHKT,\n\tMsSqlSession,\n\tPreparedQueryConfig,\n\tPreparedQueryHKTBase,\n\tPreparedQueryKind,\n\tQueryResultHKT,\n\tQueryResultKind,\n} from '~/mssql-core/session.ts';\nimport type { MsSqlTable } from '~/mssql-core/table.ts';\nimport type { SelectResultFields } from '~/query-builders/select.types.ts';\nimport { QueryPromise } from '~/query-promise.ts';\nimport type { ExtractObjectValues } from '~/relations.ts';\nimport type { Query, SQL, SQLWrapper } from '~/sql/sql.ts';\nimport { type InferInsertModel, Table } from '~/table.ts';\nimport { mapUpdateSet, orderSelectedFields, type UpdateSet } from '~/utils.ts';\nimport type { MsSqlColumn } from '../columns/common.ts';\nimport type { SelectedFieldsFlatUpdate, SelectedFieldsOrdered } from './select.types.ts';\n\nexport interface MsSqlUpdateConfig {\n\twhere?: SQL | undefined;\n\tset: UpdateSet;\n\ttable: MsSqlTable;\n\toutput?: {\n\t\tinserted?: SelectedFieldsOrdered;\n\t\tdeleted?: SelectedFieldsOrdered;\n\t};\n}\n\nexport type MsSqlUpdateSetSource<TTable extends MsSqlTable> =\n\t& {\n\t\t[Key in keyof InferInsertModel<TTable>]?:\n\t\t\t| GetColumnData<TTable['_']['columns'][Key], 'query'>\n\t\t\t| SQL;\n\t}\n\t& {};\n\nexport type NonUndefinedKeysOnly<T> =\n\t& ExtractObjectValues<\n\t\t{\n\t\t\t[K in keyof T as T[K] extends undefined ? never : K]: K;\n\t\t}\n\t>\n\t& keyof T;\n\nexport type FormSelection<T, TTable extends MsSqlTable> = {\n\t[K in keyof T as T[K] extends undefined ? never : K]: T[K] extends true ? TTable['_']['columns'] : T[K];\n};\n\nexport type MsSqlUpdateReturning<\n\tT extends AnyMsSqlUpdateBase,\n\tTDynamic extends boolean,\n\tSelectedFields extends SelectedFieldsFlatUpdate,\n> = MsSqlUpdateWithout<\n\tMsSqlUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tSelectResultFields<FormSelection<SelectedFields, T['_']['table']>>,\n\t\tTDynamic,\n\t\tT['_']['excludedMethods']\n\t>,\n\tTDynamic,\n\t'output'\n>;\n\nexport type MsSqlUpdateReturningAll<T extends AnyMsSqlUpdateBase, TDynamic extends boolean> = MsSqlUpdateWithout<\n\tMsSqlUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tT['_']['table']['$inferSelect'],\n\t\tTDynamic,\n\t\tT['_']['excludedMethods']\n\t>,\n\tTDynamic,\n\t'output'\n>;\n\nexport class MsSqlUpdateBuilder<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n> {\n\tstatic readonly [entityKind]: string = 'MsSqlUpdateBuilder';\n\n\tdeclare readonly _: {\n\t\treadonly table: TTable;\n\t};\n\n\tconstructor(\n\t\tprivate table: TTable,\n\t\tprivate session: MsSqlSession,\n\t\tprivate dialect: MsSqlDialect,\n\t) {}\n\n\tset(values: MsSqlUpdateSetSource<TTable>): MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT> {\n\t\treturn new MsSqlUpdateBase(this.table, mapUpdateSet(this.table, values), this.session, this.dialect);\n\t}\n}\n\nexport type MsSqlUpdateWithout<\n\tT extends AnyMsSqlUpdateBase,\n\tTDynamic extends boolean,\n\tK extends keyof T & string,\n> = TDynamic extends true ? T : Omit<\n\tMsSqlUpdateBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tT['_']['output'],\n\t\tTDynamic,\n\t\tT['_']['excludedMethods'] | K\n\t>,\n\tT['_']['excludedMethods'] | K\n>;\n\nexport type MsSqlUpdatePrepare<T extends AnyMsSqlUpdateBase> = PreparedQueryKind<\n\tT['_']['preparedQueryHKT'],\n\tPreparedQueryConfig & {\n\t\texecute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];\n\t\titerator: never;\n\t}\n>;\n\nexport type MsSqlUpdateDynamic<T extends AnyMsSqlUpdateBase> = MsSqlUpdate<\n\tT['_']['table'],\n\tT['_']['queryResult'],\n\tT['_']['preparedQueryHKT'],\n\tT['_']['output']\n>;\n\nexport type MsSqlUpdate<\n\tTTable extends MsSqlTable = MsSqlTable,\n\tTQueryResult extends QueryResultHKT = AnyQueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase,\n\tTOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined,\n> = MsSqlUpdateBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;\n\nexport type AnyMsSqlUpdateBase = MsSqlUpdateBase<any, any, any, any, any, any>;\n\nexport interface MsSqlUpdateBase<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n\tTOutput extends Record<string, unknown> | undefined = undefined,\n\tTDynamic extends boolean = false,\n\tTExcludedMethods extends string = never,\n> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>, SQLWrapper {\n\treadonly _: {\n\t\treadonly table: TTable;\n\t\treadonly queryResult: TQueryResult;\n\t\treadonly preparedQueryHKT: TPreparedQueryHKT;\n\t\treadonly output: TOutput;\n\t\treadonly dynamic: TDynamic;\n\t\treadonly excludedMethods: TExcludedMethods;\n\t};\n}\n\nexport class MsSqlUpdateBase<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tTOutput extends Record<string, unknown> | undefined = undefined,\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<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>\n\timplements SQLWrapper\n{\n\tstatic override readonly [entityKind]: string = 'MsSqlUpdate';\n\n\tprivate config: MsSqlUpdateConfig;\n\n\tconstructor(\n\t\ttable: TTable,\n\t\tset: UpdateSet,\n\t\tprivate session: MsSqlSession,\n\t\tprivate dialect: MsSqlDialect,\n\t) {\n\t\tsuper();\n\t\tthis.config = { set, table };\n\t}\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 * db.update(cars).set({ color: 'red' })\n\t *   .where(eq(cars.color, 'green'));\n\t * // or\n\t * 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 * 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 * 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): MsSqlUpdateWithout<this, TDynamic, 'where'> {\n\t\tthis.config.where = where;\n\t\treturn this as any;\n\t}\n\n\t/**\n\t * Adds an `output` clause to the query.\n\t *\n\t * This method allows you to return values from the rows affected by the query.\n\t * MSSQL supports returning `inserted` (new row values) and `deleted` (old row values) values.\n\t *\n\t * If no fields are specified, all `inserted` values will be returned by default.\n\t *\n\t * @example\n\t * ```ts\n\t * // Update cars and return all new values\n\t * const updatedCars: Car[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .output()\n\t *   .where(eq(cars.color, 'green'));\n\t *\n\t * // Update cars and return all old values\n\t * const updatedCarsIds: { deleted: Car }[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .output({ deleted: true })\n\t *   .where(eq(cars.color, 'green'));\n\t *\n\t * // Update cars and return partial old and new values\n\t * const beforeAndAfter: { deleted: { oldColor: string }, inserted: { newColor: string } }[] = await db.update(cars)\n\t *   .set({ color: 'red' })\n\t *   .output({\n\t *     deleted: { oldColor: cars.color },\n\t *     inserted: { newColor: cars.color }\n\t *   })\n\t *   .where(eq(cars.color, 'green'));\n\t * ```\n\t */\n\toutput(): MsSqlUpdateReturningAll<this, TDynamic>;\n\toutput<TSelectedFields extends SelectedFieldsFlatUpdate>(\n\t\tfields: TSelectedFields,\n\t): MsSqlUpdateReturning<this, TDynamic, TSelectedFields>;\n\toutput(\n\t\tfields?: SelectedFieldsFlatUpdate,\n\t): MsSqlUpdateWithout<AnyMsSqlUpdateBase, TDynamic, 'output'> {\n\t\tconst columns = this.config.table[Table.Symbol.Columns];\n\n\t\tif (fields) {\n\t\t\tconst output: typeof this.config.output = {};\n\n\t\t\tif (fields.inserted) {\n\t\t\t\toutput.inserted = typeof fields.inserted === 'boolean'\n\t\t\t\t\t? orderSelectedFields<MsSqlColumn>(columns, ['inserted'])\n\t\t\t\t\t: orderSelectedFields<MsSqlColumn>(fields.inserted, ['inserted']);\n\t\t\t}\n\n\t\t\tif (fields.deleted) {\n\t\t\t\toutput.deleted = typeof fields.deleted === 'boolean'\n\t\t\t\t\t? orderSelectedFields<MsSqlColumn>(columns, ['deleted'])\n\t\t\t\t\t: orderSelectedFields<MsSqlColumn>(fields.deleted, ['deleted']);\n\t\t\t}\n\n\t\t\tthis.config.output = output;\n\t\t} else {\n\t\t\tthis.config.output = {\n\t\t\t\tinserted: orderSelectedFields<MsSqlColumn>(columns),\n\t\t\t};\n\t\t}\n\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\tconst { typings: _typings, ...rest } = this.dialect.sqlToQuery(this.getSQL());\n\t\treturn rest;\n\t}\n\n\tprepare(): MsSqlUpdatePrepare<this> {\n\t\tconst output = [...(this.config.output?.inserted ?? []), ...(this.config.output?.deleted ?? [])];\n\n\t\treturn this.session.prepareQuery(\n\t\t\tthis.dialect.sqlToQuery(this.getSQL()),\n\t\t\toutput.length ? output : undefined,\n\t\t) as MsSqlUpdatePrepare<this>;\n\t}\n\n\toverride execute(\n\t\tplaceholderValues?: Record<string, unknown>,\n\t): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]> {\n\t\treturn this.prepare().execute(placeholderValues) as any;\n\t}\n\n\tprivate createIterator = (): ReturnType<this['prepare']>['iterator'] => {\n\t\tconst self = this;\n\t\treturn async function*(placeholderValues) {\n\t\t\tyield* self.prepare().iterator(placeholderValues);\n\t\t};\n\t};\n\n\titerator = this.createIterator();\n\n\t$dynamic(): MsSqlUpdateDynamic<this> {\n\t\treturn this as any;\n\t}\n}\n"],"mappings":"AACA,SAAS,kBAAkB;AAa3B,SAAS,oBAAoB;AAG7B,SAAgC,aAAa;AAC7C,SAAS,cAAc,2BAA2C;AAgE3D,MAAM,mBAIX;AAAA,EAOD,YACS,OACA,SACA,SACP;AAHO;AACA;AACA;AAAA,EACN;AAAA,EAVH,QAAiB,UAAU,IAAY;AAAA,EAYvC,IAAI,QAAgG;AACnG,WAAO,IAAI,gBAAgB,KAAK,OAAO,aAAa,KAAK,OAAO,MAAM,GAAG,KAAK,SAAS,KAAK,OAAO;AAAA,EACpG;AACD;AA4DO,MAAM,wBAWH,aAEV;AAAA,EAKC,YACC,OACA,KACQ,SACA,SACP;AACD,UAAM;AAHE;AACA;AAGR,SAAK,SAAS,EAAE,KAAK,MAAM;AAAA,EAC5B;AAAA,EAZA,QAA0B,UAAU,IAAY;AAAA,EAExC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6CR,MAAM,OAAqE;AAC1E,SAAK,OAAO,QAAQ;AACpB,WAAO;AAAA,EACR;AAAA,EAsCA,OACC,QAC6D;AAC7D,UAAM,UAAU,KAAK,OAAO,MAAM,MAAM,OAAO,OAAO;AAEtD,QAAI,QAAQ;AACX,YAAM,SAAoC,CAAC;AAE3C,UAAI,OAAO,UAAU;AACpB,eAAO,WAAW,OAAO,OAAO,aAAa,YAC1C,oBAAiC,SAAS,CAAC,UAAU,CAAC,IACtD,oBAAiC,OAAO,UAAU,CAAC,UAAU,CAAC;AAAA,MAClE;AAEA,UAAI,OAAO,SAAS;AACnB,eAAO,UAAU,OAAO,OAAO,YAAY,YACxC,oBAAiC,SAAS,CAAC,SAAS,CAAC,IACrD,oBAAiC,OAAO,SAAS,CAAC,SAAS,CAAC;AAAA,MAChE;AAEA,WAAK,OAAO,SAAS;AAAA,IACtB,OAAO;AACN,WAAK,OAAO,SAAS;AAAA,QACpB,UAAU,oBAAiC,OAAO;AAAA,MACnD;AAAA,IACD;AAEA,WAAO;AAAA,EACR;AAAA;AAAA,EAGA,SAAc;AACb,WAAO,KAAK,QAAQ,iBAAiB,KAAK,MAAM;AAAA,EACjD;AAAA,EAEA,QAAe;AACd,UAAM,EAAE,SAAS,UAAU,GAAG,KAAK,IAAI,KAAK,QAAQ,WAAW,KAAK,OAAO,CAAC;AAC5E,WAAO;AAAA,EACR;AAAA,EAEA,UAAoC;AACnC,UAAM,SAAS,CAAC,GAAI,KAAK,OAAO,QAAQ,YAAY,CAAC,GAAI,GAAI,KAAK,OAAO,QAAQ,WAAW,CAAC,CAAE;AAE/F,WAAO,KAAK,QAAQ;AAAA,MACnB,KAAK,QAAQ,WAAW,KAAK,OAAO,CAAC;AAAA,MACrC,OAAO,SAAS,SAAS;AAAA,IAC1B;AAAA,EACD;AAAA,EAES,QACR,mBACsF;AACtF,WAAO,KAAK,QAAQ,EAAE,QAAQ,iBAAiB;AAAA,EAChD;AAAA,EAEQ,iBAAiB,MAA+C;AACvE,UAAM,OAAO;AACb,WAAO,iBAAgB,mBAAmB;AACzC,aAAO,KAAK,QAAQ,EAAE,SAAS,iBAAiB;AAAA,IACjD;AAAA,EACD;AAAA,EAEA,WAAW,KAAK,eAAe;AAAA,EAE/B,WAAqC;AACpC,WAAO;AAAA,EACR;AACD;","names":[]}

package/mssql-core/schema.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var schema_exports = {};
+__export(schema_exports, {
+  MsSqlSchema: () => MsSqlSchema,
+  mssqlSchema: () => mssqlSchema
+});
+module.exports = __toCommonJS(schema_exports);
+var import_entity = require("../entity.cjs");
+var import_table = require("./table.cjs");
+var import_view = require("./view.cjs");
+class MsSqlSchema {
+  constructor(schemaName) {
+    this.schemaName = schemaName;
+  }
+  static [import_entity.entityKind] = "MsSqlSchema";
+  isExisting = false;
+  table = (name, columns, extraConfig) => {
+    return (0, import_table.mssqlTableWithSchema)(name, columns, extraConfig, this.schemaName);
+  };
+  view = ((name, columns) => {
+    return (0, import_view.mssqlViewWithSchema)(name, columns, this.schemaName);
+  });
+  existing() {
+    this.isExisting = true;
+    return this;
+  }
+}
+function mssqlSchema(name) {
+  return new MsSqlSchema(name);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MsSqlSchema,
+  mssqlSchema
+});
+//# sourceMappingURL=schema.cjs.map

package/mssql-core/schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mssql-core/schema.ts"],"sourcesContent":["import { entityKind } from '~/entity.ts';\nimport { type MsSqlTableFn, mssqlTableWithSchema } from './table.ts';\nimport { type mssqlView, mssqlViewWithSchema } from './view.ts';\n\nexport class MsSqlSchema<TName extends string = string> {\n\tstatic readonly [entityKind]: string = 'MsSqlSchema';\n\n\tisExisting: boolean = false;\n\tconstructor(\n\t\tpublic readonly schemaName: TName,\n\t) {}\n\n\ttable: MsSqlTableFn<TName> = (name, columns, extraConfig) => {\n\t\treturn mssqlTableWithSchema(name, columns, extraConfig, this.schemaName);\n\t};\n\n\tview = ((name, columns) => {\n\t\treturn mssqlViewWithSchema(name, columns, this.schemaName);\n\t}) as typeof mssqlView;\n\n\texisting(): this {\n\t\tthis.isExisting = true;\n\t\treturn this;\n\t}\n}\n\nexport function mssqlSchema<TName extends string>(name: TName) {\n\treturn new MsSqlSchema(name);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA2B;AAC3B,mBAAwD;AACxD,kBAAoD;AAE7C,MAAM,YAA2C;AAAA,EAIvD,YACiB,YACf;AADe;AAAA,EACd;AAAA,EALH,QAAiB,wBAAU,IAAY;AAAA,EAEvC,aAAsB;AAAA,EAKtB,QAA6B,CAAC,MAAM,SAAS,gBAAgB;AAC5D,eAAO,mCAAqB,MAAM,SAAS,aAAa,KAAK,UAAU;AAAA,EACxE;AAAA,EAEA,QAAQ,CAAC,MAAM,YAAY;AAC1B,eAAO,iCAAoB,MAAM,SAAS,KAAK,UAAU;AAAA,EAC1D;AAAA,EAEA,WAAiB;AAChB,SAAK,aAAa;AAClB,WAAO;AAAA,EACR;AACD;AAEO,SAAS,YAAkC,MAAa;AAC9D,SAAO,IAAI,YAAY,IAAI;AAC5B;","names":[]}

package/mssql-core/schema.d.cts

@@ -0,0 +1,13 @@
+import { entityKind } from "../entity.cjs";
+import { type MsSqlTableFn } from "./table.cjs";
+import { type mssqlView } from "./view.cjs";
+export declare class MsSqlSchema<TName extends string = string> {
+    readonly schemaName: TName;
+    static readonly [entityKind]: string;
+    isExisting: boolean;
+    constructor(schemaName: TName);
+    table: MsSqlTableFn<TName>;
+    view: typeof mssqlView;
+    existing(): this;
+}
+export declare function mssqlSchema<TName extends string>(name: TName): MsSqlSchema<TName>;

package/mssql-core/schema.d.ts

@@ -0,0 +1,13 @@
+import { entityKind } from "../entity.js";
+import { type MsSqlTableFn } from "./table.js";
+import { type mssqlView } from "./view.js";
+export declare class MsSqlSchema<TName extends string = string> {
+    readonly schemaName: TName;
+    static readonly [entityKind]: string;
+    isExisting: boolean;
+    constructor(schemaName: TName);
+    table: MsSqlTableFn<TName>;
+    view: typeof mssqlView;
+    existing(): this;
+}
+export declare function mssqlSchema<TName extends string>(name: TName): MsSqlSchema<TName>;

package/mssql-core/schema.js

@@ -0,0 +1,28 @@
+import { entityKind } from "../entity.js";
+import { mssqlTableWithSchema } from "./table.js";
+import { mssqlViewWithSchema } from "./view.js";
+class MsSqlSchema {
+  constructor(schemaName) {
+    this.schemaName = schemaName;
+  }
+  static [entityKind] = "MsSqlSchema";
+  isExisting = false;
+  table = (name, columns, extraConfig) => {
+    return mssqlTableWithSchema(name, columns, extraConfig, this.schemaName);
+  };
+  view = ((name, columns) => {
+    return mssqlViewWithSchema(name, columns, this.schemaName);
+  });
+  existing() {
+    this.isExisting = true;
+    return this;
+  }
+}
+function mssqlSchema(name) {
+  return new MsSqlSchema(name);
+}
+export {
+  MsSqlSchema,
+  mssqlSchema
+};
+//# sourceMappingURL=schema.js.map

package/mssql-core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mssql-core/schema.ts"],"sourcesContent":["import { entityKind } from '~/entity.ts';\nimport { type MsSqlTableFn, mssqlTableWithSchema } from './table.ts';\nimport { type mssqlView, mssqlViewWithSchema } from './view.ts';\n\nexport class MsSqlSchema<TName extends string = string> {\n\tstatic readonly [entityKind]: string = 'MsSqlSchema';\n\n\tisExisting: boolean = false;\n\tconstructor(\n\t\tpublic readonly schemaName: TName,\n\t) {}\n\n\ttable: MsSqlTableFn<TName> = (name, columns, extraConfig) => {\n\t\treturn mssqlTableWithSchema(name, columns, extraConfig, this.schemaName);\n\t};\n\n\tview = ((name, columns) => {\n\t\treturn mssqlViewWithSchema(name, columns, this.schemaName);\n\t}) as typeof mssqlView;\n\n\texisting(): this {\n\t\tthis.isExisting = true;\n\t\treturn this;\n\t}\n}\n\nexport function mssqlSchema<TName extends string>(name: TName) {\n\treturn new MsSqlSchema(name);\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAC3B,SAA4B,4BAA4B;AACxD,SAAyB,2BAA2B;AAE7C,MAAM,YAA2C;AAAA,EAIvD,YACiB,YACf;AADe;AAAA,EACd;AAAA,EALH,QAAiB,UAAU,IAAY;AAAA,EAEvC,aAAsB;AAAA,EAKtB,QAA6B,CAAC,MAAM,SAAS,gBAAgB;AAC5D,WAAO,qBAAqB,MAAM,SAAS,aAAa,KAAK,UAAU;AAAA,EACxE;AAAA,EAEA,QAAQ,CAAC,MAAM,YAAY;AAC1B,WAAO,oBAAoB,MAAM,SAAS,KAAK,UAAU;AAAA,EAC1D;AAAA,EAEA,WAAiB;AAChB,SAAK,aAAa;AAClB,WAAO;AAAA,EACR;AACD;AAEO,SAAS,YAAkC,MAAa;AAC9D,SAAO,IAAI,YAAY,IAAI;AAC5B;","names":[]}