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

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

@@ -0,0 +1,98 @@
+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 { Query, SQL, SQLWrapper } from "../../sql/sql.js";
+import type { SelectedFieldsFlat, SelectedFieldsOrdered } from "./select.types.js";
+export type MsSqlDeleteWithout<T extends AnyMsSqlDeleteBase, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<MsSqlDeleteBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+export type MsSqlDeleteReturningAll<T extends AnyMsSqlDeleteBase, TDynamic extends boolean> = MsSqlDeleteWithout<MsSqlDeleteBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['table']['$inferSelect'], TDynamic, T['_']['excludedMethods']>, TDynamic, 'output'>;
+export type MsSqlDeleteReturning<T extends AnyMsSqlDeleteBase, TDynamic extends boolean, TSelectedFields extends SelectedFieldsFlat> = MsSqlDeleteWithout<MsSqlDeleteBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], SelectResultFields<TSelectedFields>, TDynamic, T['_']['excludedMethods']>, TDynamic, 'output'>;
+export type MsSqlDelete<TTable extends MsSqlTable = MsSqlTable, TQueryResult extends QueryResultHKT = AnyQueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> = MsSqlDeleteBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;
+export interface MsSqlDeleteConfig {
+    where?: SQL | undefined;
+    table: MsSqlTable;
+    output?: SelectedFieldsOrdered;
+}
+export type MsSqlDeletePrepare<T extends AnyMsSqlDeleteBase> = PreparedQueryKind<T['_']['preparedQueryHKT'], PreparedQueryConfig & {
+    execute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];
+    iterator: never;
+}>;
+type MsSqlDeleteDynamic<T extends AnyMsSqlDeleteBase> = MsSqlDelete<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output']>;
+type AnyMsSqlDeleteBase = MsSqlDeleteBase<any, any, any, any, any, any>;
+export interface MsSqlDeleteBase<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[]> {
+    readonly _: {
+        readonly table: TTable;
+        readonly queryResult: TQueryResult;
+        readonly preparedQueryHKT: TPreparedQueryHKT;
+        readonly dynamic: TDynamic;
+        readonly output: TOutput;
+        readonly excludedMethods: TExcludedMethods;
+    };
+}
+export declare class MsSqlDeleteBase<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined, TDynamic extends boolean = false, TExcludedMethods extends string = never> extends QueryPromise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]> implements SQLWrapper {
+    private table;
+    private session;
+    private dialect;
+    static readonly [entityKind]: string;
+    private config;
+    constructor(table: TTable, session: MsSqlSession, dialect: MsSqlDialect);
+    /**
+     * Adds a `where` clause to the query.
+     *
+     * Calling this method will delete only those rows that fulfill a specified condition.
+     *
+     * See docs: {@link https://orm.drizzle.team/docs/delete}
+     *
+     * @param where the `where` clause.
+     *
+     * @example
+     * You can use conditional operators and `sql function` to filter the rows to be deleted.
+     *
+     * ```ts
+     * // Delete all cars with green color
+     * db.delete(cars).where(eq(cars.color, 'green'));
+     * // or
+     * db.delete(cars).where(sql`${cars.color} = 'green'`)
+     * ```
+     *
+     * You can logically combine conditional operators with `and()` and `or()` operators:
+     *
+     * ```ts
+     * // Delete all BMW cars with a green color
+     * db.delete(cars).where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));
+     *
+     * // Delete all cars with the green or blue color
+     * db.delete(cars).where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+     * ```
+     */
+    where(where: SQL | undefined): MsSqlDeleteWithout<this, TDynamic, 'where'>;
+    /**
+     * Adds an `output` clause to the query.
+     *
+     * Calling this method will return the specified fields of the deleted rows. If no fields are specified, all fields will be returned.
+     *
+     * @example
+     * ```ts
+     * // Delete all cars with the green color and return all fields
+     * const deletedCars: Car[] = await db.delete(cars)
+     *   .output();
+     *   .where(eq(cars.color, 'green'))
+     *
+     * // Delete all cars with the green color and return only their id and brand fields
+     * const deletedCarsIdsAndBrands: { id: number, brand: string }[] = await db.delete(cars)
+     *   .output({ id: cars.id, brand: cars.brand });
+     *   .where(eq(cars.color, 'green'))
+     * ```
+     */
+    output(): MsSqlDeleteReturningAll<this, TDynamic>;
+    output<TSelectedFields extends SelectedFieldsFlat>(fields: TSelectedFields): MsSqlDeleteReturning<this, TDynamic, TSelectedFields>;
+    toSQL(): Query;
+    prepare(): MsSqlDeletePrepare<this>;
+    execute(placeholderValues?: Record<string, unknown>): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>;
+    private createIterator;
+    iterator: ReturnType<this["prepare"]>["iterator"];
+    $dynamic(): MsSqlDeleteDynamic<this>;
+}
+export {};

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

@@ -0,0 +1,83 @@
+import { entityKind } from "../../entity.js";
+import { QueryPromise } from "../../query-promise.js";
+import { Table } from "../../table.js";
+import { orderSelectedFields } from "../../utils.js";
+class MsSqlDeleteBase extends QueryPromise {
+  constructor(table, session, dialect) {
+    super();
+    this.table = table;
+    this.session = session;
+    this.dialect = dialect;
+    this.config = { table };
+  }
+  static [entityKind] = "MsSqlDelete";
+  config;
+  /**
+   * Adds a `where` clause to the query.
+   *
+   * Calling this method will delete only those rows that fulfill a specified condition.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/delete}
+   *
+   * @param where the `where` clause.
+   *
+   * @example
+   * You can use conditional operators and `sql function` to filter the rows to be deleted.
+   *
+   * ```ts
+   * // Delete all cars with green color
+   * db.delete(cars).where(eq(cars.color, 'green'));
+   * // or
+   * db.delete(cars).where(sql`${cars.color} = 'green'`)
+   * ```
+   *
+   * You can logically combine conditional operators with `and()` and `or()` operators:
+   *
+   * ```ts
+   * // Delete all BMW cars with a green color
+   * db.delete(cars).where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));
+   *
+   * // Delete all cars with the green or blue color
+   * db.delete(cars).where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));
+   * ```
+   */
+  where(where) {
+    this.config.where = where;
+    return this;
+  }
+  output(fields = this.config.table[Table.Symbol.Columns]) {
+    this.config.output = orderSelectedFields(fields);
+    return this;
+  }
+  /** @internal */
+  getSQL() {
+    return this.dialect.buildDeleteQuery(this.config);
+  }
+  toSQL() {
+    const { typings: _typings, ...rest } = this.dialect.sqlToQuery(this.getSQL());
+    return rest;
+  }
+  prepare() {
+    return this.session.prepareQuery(
+      this.dialect.sqlToQuery(this.getSQL()),
+      this.config.output
+    );
+  }
+  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 {
+  MsSqlDeleteBase
+};
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mssql-core/query-builders/delete.ts"],"sourcesContent":["import { 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 { Query, SQL, SQLWrapper } from '~/sql/sql.ts';\nimport { Table } from '~/table.ts';\nimport { orderSelectedFields } from '~/utils.ts';\nimport type { MsSqlColumn } from '../columns/common.ts';\nimport type { SelectedFieldsFlat, SelectedFieldsOrdered } from './select.types.ts';\n\nexport type MsSqlDeleteWithout<\n\tT extends AnyMsSqlDeleteBase,\n\tTDynamic extends boolean,\n\tK extends keyof T & string,\n> = TDynamic extends true ? T\n\t: Omit<\n\t\tMsSqlDeleteBase<\n\t\t\tT['_']['table'],\n\t\t\tT['_']['queryResult'],\n\t\t\tT['_']['preparedQueryHKT'],\n\t\t\tT['_']['output'],\n\t\t\tTDynamic,\n\t\t\tT['_']['excludedMethods'] | K\n\t\t>,\n\t\tT['_']['excludedMethods'] | K\n\t>;\n\nexport type MsSqlDeleteReturningAll<\n\tT extends AnyMsSqlDeleteBase,\n\tTDynamic extends boolean,\n> = MsSqlDeleteWithout<\n\tMsSqlDeleteBase<\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 type MsSqlDeleteReturning<\n\tT extends AnyMsSqlDeleteBase,\n\tTDynamic extends boolean,\n\tTSelectedFields extends SelectedFieldsFlat,\n> = MsSqlDeleteWithout<\n\tMsSqlDeleteBase<\n\t\tT['_']['table'],\n\t\tT['_']['queryResult'],\n\t\tT['_']['preparedQueryHKT'],\n\t\tSelectResultFields<TSelectedFields>,\n\t\tTDynamic,\n\t\tT['_']['excludedMethods']\n\t>,\n\tTDynamic,\n\t'output'\n>;\n\nexport type MsSqlDelete<\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> = MsSqlDeleteBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;\n\nexport interface MsSqlDeleteConfig {\n\twhere?: SQL | undefined;\n\ttable: MsSqlTable;\n\toutput?: SelectedFieldsOrdered;\n}\n\nexport type MsSqlDeletePrepare<T extends AnyMsSqlDeleteBase> = 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\ntype MsSqlDeleteDynamic<T extends AnyMsSqlDeleteBase> = MsSqlDelete<\n\tT['_']['table'],\n\tT['_']['queryResult'],\n\tT['_']['preparedQueryHKT'],\n\tT['_']['output']\n>;\n\ntype AnyMsSqlDeleteBase = MsSqlDeleteBase<any, any, any, any, any, any>;\n\nexport interface MsSqlDeleteBase<\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[]> {\n\treadonly _: {\n\t\treadonly table: TTable;\n\t\treadonly queryResult: TQueryResult;\n\t\treadonly preparedQueryHKT: TPreparedQueryHKT;\n\t\treadonly dynamic: TDynamic;\n\t\treadonly output: TOutput;\n\t\treadonly excludedMethods: TExcludedMethods;\n\t};\n}\n\nexport class MsSqlDeleteBase<\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,\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 = 'MsSqlDelete';\n\n\tprivate config: MsSqlDeleteConfig;\n\n\tconstructor(\n\t\tprivate table: TTable,\n\t\tprivate session: MsSqlSession,\n\t\tprivate dialect: MsSqlDialect,\n\t) {\n\t\tsuper();\n\t\tthis.config = { table };\n\t}\n\n\t/**\n\t * Adds a `where` clause to the query.\n\t *\n\t * Calling this method will delete only those rows that fulfill a specified condition.\n\t *\n\t * See docs: {@link https://orm.drizzle.team/docs/delete}\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 deleted.\n\t *\n\t * ```ts\n\t * // Delete all cars with green color\n\t * db.delete(cars).where(eq(cars.color, 'green'));\n\t * // or\n\t * db.delete(cars).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 * // Delete all BMW cars with a green color\n\t * db.delete(cars).where(and(eq(cars.color, 'green'), eq(cars.brand, 'BMW')));\n\t *\n\t * // Delete all cars with the green or blue color\n\t * db.delete(cars).where(or(eq(cars.color, 'green'), eq(cars.color, 'blue')));\n\t * ```\n\t */\n\twhere(where: SQL | undefined): MsSqlDeleteWithout<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 * Calling this method will return the specified fields of the deleted rows. If no fields are specified, all fields will be returned.\n\t *\n\t * @example\n\t * ```ts\n\t * // Delete all cars with the green color and return all fields\n\t * const deletedCars: Car[] = await db.delete(cars)\n\t *   .output();\n\t *   .where(eq(cars.color, 'green'))\n\t *\n\t * // Delete all cars with the green color and return only their id and brand fields\n\t * const deletedCarsIdsAndBrands: { id: number, brand: string }[] = await db.delete(cars)\n\t *   .output({ id: cars.id, brand: cars.brand });\n\t *   .where(eq(cars.color, 'green'))\n\t * ```\n\t */\n\toutput(): MsSqlDeleteReturningAll<this, TDynamic>;\n\toutput<TSelectedFields extends SelectedFieldsFlat>(\n\t\tfields: TSelectedFields,\n\t): MsSqlDeleteReturning<this, TDynamic, TSelectedFields>;\n\toutput(\n\t\tfields: SelectedFieldsFlat = this.config.table[Table.Symbol.Columns],\n\t): MsSqlDeleteWithout<AnyMsSqlDeleteBase, TDynamic, 'output'> {\n\t\tthis.config.output = orderSelectedFields<MsSqlColumn>(fields);\n\t\treturn this as any;\n\t}\n\n\t/** @internal */\n\tgetSQL(): SQL {\n\t\treturn this.dialect.buildDeleteQuery(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(): MsSqlDeletePrepare<this> {\n\t\treturn this.session.prepareQuery(\n\t\t\tthis.dialect.sqlToQuery(this.getSQL()),\n\t\t\tthis.config.output,\n\t\t) as MsSqlDeletePrepare<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(): MsSqlDeleteDynamic<this> {\n\t\treturn this as any;\n\t}\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAa3B,SAAS,oBAAoB;AAE7B,SAAS,aAAa;AACtB,SAAS,2BAA2B;AAsG7B,MAAM,wBAUH,aAEV;AAAA,EAKC,YACS,OACA,SACA,SACP;AACD,UAAM;AAJE;AACA;AACA;AAGR,SAAK,SAAS,EAAE,MAAM;AAAA,EACvB;AAAA,EAXA,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,EAwCR,MAAM,OAAqE;AAC1E,SAAK,OAAO,QAAQ;AACpB,WAAO;AAAA,EACR;AAAA,EAwBA,OACC,SAA6B,KAAK,OAAO,MAAM,MAAM,OAAO,OAAO,GACN;AAC7D,SAAK,OAAO,SAAS,oBAAiC,MAAM;AAC5D,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,WAAO,KAAK,QAAQ;AAAA,MACnB,KAAK,QAAQ,WAAW,KAAK,OAAO,CAAC;AAAA,MACrC,KAAK,OAAO;AAAA,IACb;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/index.cjs

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var query_builders_exports = {};
+module.exports = __toCommonJS(query_builders_exports);
+__reExport(query_builders_exports, require("./delete.cjs"), module.exports);
+__reExport(query_builders_exports, require("./insert.cjs"), module.exports);
+__reExport(query_builders_exports, require("./query-builder.cjs"), module.exports);
+__reExport(query_builders_exports, require("./select.cjs"), module.exports);
+__reExport(query_builders_exports, require("./select.types.cjs"), module.exports);
+__reExport(query_builders_exports, require("./update.cjs"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./delete.cjs"),
+  ...require("./insert.cjs"),
+  ...require("./query-builder.cjs"),
+  ...require("./select.cjs"),
+  ...require("./select.types.cjs"),
+  ...require("./update.cjs")
+});
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mssql-core/query-builders/index.ts"],"sourcesContent":["export * from './delete.ts';\nexport * from './insert.ts';\nexport * from './query-builder.ts';\nexport * from './select.ts';\nexport * from './select.types.ts';\nexport * from './update.ts';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,mCAAc,wBAAd;AACA,mCAAc,wBADd;AAEA,mCAAc,+BAFd;AAGA,mCAAc,wBAHd;AAIA,mCAAc,8BAJd;AAKA,mCAAc,wBALd;","names":[]}

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

@@ -0,0 +1,6 @@
+export * from "./delete.cjs";
+export * from "./insert.cjs";
+export * from "./query-builder.cjs";
+export * from "./select.cjs";
+export * from "./select.types.cjs";
+export * from "./update.cjs";

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

@@ -0,0 +1,6 @@
+export * from "./delete.js";
+export * from "./insert.js";
+export * from "./query-builder.js";
+export * from "./select.js";
+export * from "./select.types.js";
+export * from "./update.js";

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

@@ -0,0 +1,7 @@
+export * from "./delete.js";
+export * from "./insert.js";
+export * from "./query-builder.js";
+export * from "./select.js";
+export * from "./select.types.js";
+export * from "./update.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mssql-core/query-builders/index.ts"],"sourcesContent":["export * from './delete.ts';\nexport * from './insert.ts';\nexport * from './query-builder.ts';\nexport * from './select.ts';\nexport * from './select.types.ts';\nexport * from './update.ts';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/mssql-core/query-builders/insert.cjs

@@ -0,0 +1,105 @@
+"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 insert_exports = {};
+__export(insert_exports, {
+  MsSqlInsertBase: () => MsSqlInsertBase,
+  MsSqlInsertBuilder: () => MsSqlInsertBuilder
+});
+module.exports = __toCommonJS(insert_exports);
+var import_entity = require("../../entity.cjs");
+var import_query_promise = require("../../query-promise.cjs");
+var import_sql = require("../../sql/sql.cjs");
+var import_table = require("../../table.cjs");
+var import_utils = require("../../utils.cjs");
+class MsSqlInsertBuilder {
+  static [import_entity.entityKind] = "MsSqlInsertBuilder";
+  config;
+  table;
+  session;
+  dialect;
+  constructor(table, session, dialect, output) {
+    this.table = table;
+    this.session = session;
+    this.dialect = dialect;
+    this.config = { table, output };
+  }
+  values(values) {
+    values = Array.isArray(values) ? values : [values];
+    if (values.length === 0) {
+      throw new Error("values() must be called with at least one value");
+    }
+    const mappedValues = values.map((entry) => {
+      const result = {};
+      const cols = this.table[import_table.Table.Symbol.Columns];
+      for (const colKey of Object.keys(entry)) {
+        const colValue = entry[colKey];
+        result[colKey] = (0, import_entity.is)(colValue, import_sql.SQL) ? colValue : new import_sql.Param(colValue, cols[colKey]);
+      }
+      return result;
+    });
+    return new MsSqlInsertBase(this.table, mappedValues, this.session, this.dialect, this.config.output);
+  }
+  output(fields = this.table[import_table.Table.Symbol.Columns]) {
+    this.config.output = (0, import_utils.orderSelectedFields)(fields);
+    return this;
+  }
+}
+class MsSqlInsertBase extends import_query_promise.QueryPromise {
+  constructor(table, values, session, dialect, output) {
+    super();
+    this.session = session;
+    this.dialect = dialect;
+    this.config = { table, values, output };
+  }
+  static [import_entity.entityKind] = "MsSqlInsert";
+  config;
+  /** @internal */
+  getSQL() {
+    return this.dialect.buildInsertQuery(this.config);
+  }
+  toSQL() {
+    const { typings: _typings, ...rest } = this.dialect.sqlToQuery(this.getSQL());
+    return rest;
+  }
+  prepare() {
+    return this.session.prepareQuery(
+      this.dialect.sqlToQuery(this.getSQL()),
+      this.config.output
+    );
+  }
+  execute(placeholderValues) {
+    return this.prepare().execute(placeholderValues);
+  }
+  createIterator = () => {
+    const self = this;
+    return async function* (placeholderValues) {
+      yield* self.prepare().iterator(placeholderValues);
+    };
+  };
+  iterator = this.createIterator();
+  // $dynamic(): MsSqlInsertDynamic<this> {
+  // 	return this as any;
+  // }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MsSqlInsertBase,
+  MsSqlInsertBuilder
+});
+//# sourceMappingURL=insert.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mssql-core/query-builders/insert.ts"],"sourcesContent":["import { entityKind, is } 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 { Placeholder, Query, SQLWrapper } from '~/sql/sql.ts';\nimport { Param, SQL } from '~/sql/sql.ts';\nimport { type InferInsertModel, type InferSelectModel, Table } from '~/table.ts';\nimport { orderSelectedFields } from '~/utils.ts';\nimport type { MsSqlColumn } from '../columns/common.ts';\nimport type { SelectedFieldsFlat, SelectedFieldsOrdered } from './select.types.ts';\n\nexport interface MsSqlInsertConfig<TTable extends MsSqlTable = MsSqlTable> {\n\ttable: TTable;\n\tvalues: Record<string, Param | SQL>[];\n\toutput?: SelectedFieldsOrdered;\n}\n\nexport type MsSqlInsertValue<\n\tTTable extends MsSqlTable,\n\tTModel extends Record<string, any> = InferInsertModel<TTable>,\n> =\n\t& {\n\t\t[Key in keyof TModel]: TModel[Key] | SQL | Placeholder;\n\t}\n\t& {};\n\nexport class MsSqlInsertBuilder<\n\tTTable extends MsSqlTable,\n\tTQueryResult extends QueryResultHKT,\n\tTPreparedQueryHKT extends PreparedQueryHKTBase,\n\tTOutput extends Record<string, unknown> | undefined = undefined,\n> {\n\tstatic readonly [entityKind]: string = 'MsSqlInsertBuilder';\n\n\tprivate config: {\n\t\toutput?: SelectedFieldsOrdered;\n\t\ttable: TTable;\n\t};\n\n\tprotected table: TTable;\n\tprotected session: MsSqlSession;\n\tprotected dialect: MsSqlDialect;\n\n\tconstructor(\n\t\ttable: TTable,\n\t\tsession: MsSqlSession,\n\t\tdialect: MsSqlDialect,\n\t\toutput?: SelectedFieldsOrdered,\n\t) {\n\t\tthis.table = table;\n\t\tthis.session = session;\n\t\tthis.dialect = dialect;\n\n\t\tthis.config = { table, output };\n\t}\n\n\tvalues(\n\t\tvalue: MsSqlInsertValue<TTable>,\n\t): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput>;\n\tvalues(values: MsSqlInsertValue<TTable>[]): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput>;\n\tvalues(\n\t\tvalues: MsSqlInsertValue<TTable> | MsSqlInsertValue<TTable>[],\n\t): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput> {\n\t\tvalues = Array.isArray(values) ? values : [values];\n\t\tif (values.length === 0) {\n\t\t\tthrow new Error('values() must be called with at least one value');\n\t\t}\n\t\tconst mappedValues = values.map((entry) => {\n\t\t\tconst result: Record<string, Param | SQL> = {};\n\t\t\tconst cols = this.table[Table.Symbol.Columns];\n\t\t\tfor (const colKey of Object.keys(entry)) {\n\t\t\t\tconst colValue = entry[colKey as keyof typeof entry];\n\t\t\t\tresult[colKey] = is(colValue, SQL) ? colValue : new Param(colValue, cols[colKey]);\n\t\t\t}\n\t\t\treturn result;\n\t\t});\n\n\t\treturn new MsSqlInsertBase(this.table, mappedValues, this.session, this.dialect, this.config.output);\n\t}\n\n\t/**\n\t * Adds an `output` clause to the query.\n\t *\n\t * Calling this method will return the specified fields of the inserted rows. If no fields are specified, all fields will be returned.\n\t *\n\t * @example\n\t * ```ts\n\t * // Insert one row and return all fields\n\t * const insertedCar: Car[] = await db.insert(cars)\n\t *   .output();\n\t *   .values({ brand: 'BMW' })\n\t *\n\t * // Insert one row and return only the id\n\t * const insertedCarId: { id: number }[] = await db.insert(cars)\n\t *   .output({ id: cars.id });\n\t *   .values({ brand: 'BMW' })\n\t * ```\n\t */\n\toutput(): Omit<MsSqlInsertBuilder<TTable, TQueryResult, TPreparedQueryHKT, InferSelectModel<TTable>>, 'output'>;\n\toutput<SelectedFields extends SelectedFieldsFlat>(\n\t\tfields: SelectedFields,\n\t): Omit<MsSqlInsertBuilder<TTable, TQueryResult, TPreparedQueryHKT, SelectResultFields<SelectedFields>>, 'output'>;\n\toutput(\n\t\tfields: SelectedFieldsFlat = this.table[Table.Symbol.Columns],\n\t) {\n\t\tthis.config.output = orderSelectedFields<MsSqlColumn>(fields);\n\t\treturn this as any;\n\t}\n}\n\nexport type MsSqlInsertWithout<T extends AnyMsSqlInsert, TDynamic extends boolean, K extends keyof T & string> =\n\tTDynamic extends true ? T\n\t\t: Omit<\n\t\t\tMsSqlInsertBase<\n\t\t\t\tT['_']['table'],\n\t\t\t\tT['_']['queryResult'],\n\t\t\t\tT['_']['preparedQueryHKT'],\n\t\t\t\tT['_']['output'],\n\t\t\t\tTDynamic,\n\t\t\t\tT['_']['excludedMethods'] | K\n\t\t\t>,\n\t\t\tT['_']['excludedMethods'] | K\n\t\t>;\n\nexport type MsSqlInsertDynamic<T extends AnyMsSqlInsert> = MsSqlInsert<\n\tT['_']['table'],\n\tT['_']['queryResult'],\n\tT['_']['preparedQueryHKT'],\n\tT['_']['output']\n>;\n\nexport type MsSqlInsertPrepare<T extends AnyMsSqlInsert> = 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 MsSqlInsert<\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> = MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;\n\nexport type AnyMsSqlInsert = MsSqlInsertBase<any, any, any, any, any, any>;\n\nexport interface MsSqlInsertBase<\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 MsSqlInsertBase<\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 = 'MsSqlInsert';\n\n\tdeclare protected $table: TTable;\n\n\tprivate config: MsSqlInsertConfig<TTable>;\n\n\tconstructor(\n\t\ttable: TTable,\n\t\tvalues: MsSqlInsertConfig['values'],\n\t\tprivate session: MsSqlSession,\n\t\tprivate dialect: MsSqlDialect,\n\t\toutput?: SelectedFieldsOrdered,\n\t) {\n\t\tsuper();\n\t\tthis.config = { table, values, output };\n\t}\n\n\t/** @internal */\n\tgetSQL(): SQL {\n\t\treturn this.dialect.buildInsertQuery(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(): MsSqlInsertPrepare<this> {\n\t\treturn this.session.prepareQuery(\n\t\t\tthis.dialect.sqlToQuery(this.getSQL()),\n\t\t\tthis.config.output,\n\t\t) as MsSqlInsertPrepare<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(): MsSqlInsertDynamic<this> {\n\t// \treturn this as any;\n\t// }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA+B;AAa/B,2BAA6B;AAE7B,iBAA2B;AAC3B,mBAAoE;AACpE,mBAAoC;AAmB7B,MAAM,mBAKX;AAAA,EACD,QAAiB,wBAAU,IAAY;AAAA,EAE/B;AAAA,EAKE;AAAA,EACA;AAAA,EACA;AAAA,EAEV,YACC,OACA,SACA,SACA,QACC;AACD,SAAK,QAAQ;AACb,SAAK,UAAU;AACf,SAAK,UAAU;AAEf,SAAK,SAAS,EAAE,OAAO,OAAO;AAAA,EAC/B;AAAA,EAMA,OACC,QACoE;AACpE,aAAS,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM;AACjD,QAAI,OAAO,WAAW,GAAG;AACxB,YAAM,IAAI,MAAM,iDAAiD;AAAA,IAClE;AACA,UAAM,eAAe,OAAO,IAAI,CAAC,UAAU;AAC1C,YAAM,SAAsC,CAAC;AAC7C,YAAM,OAAO,KAAK,MAAM,mBAAM,OAAO,OAAO;AAC5C,iBAAW,UAAU,OAAO,KAAK,KAAK,GAAG;AACxC,cAAM,WAAW,MAAM,MAA4B;AACnD,eAAO,MAAM,QAAI,kBAAG,UAAU,cAAG,IAAI,WAAW,IAAI,iBAAM,UAAU,KAAK,MAAM,CAAC;AAAA,MACjF;AACA,aAAO;AAAA,IACR,CAAC;AAED,WAAO,IAAI,gBAAgB,KAAK,OAAO,cAAc,KAAK,SAAS,KAAK,SAAS,KAAK,OAAO,MAAM;AAAA,EACpG;AAAA,EAwBA,OACC,SAA6B,KAAK,MAAM,mBAAM,OAAO,OAAO,GAC3D;AACD,SAAK,OAAO,aAAS,kCAAiC,MAAM;AAC5D,WAAO;AAAA,EACR;AACD;AA0DO,MAAM,wBAWH,kCAEV;AAAA,EAOC,YACC,OACA,QACQ,SACA,SACR,QACC;AACD,UAAM;AAJE;AACA;AAIR,SAAK,SAAS,EAAE,OAAO,QAAQ,OAAO;AAAA,EACvC;AAAA,EAfA,QAA0B,wBAAU,IAAY;AAAA,EAIxC;AAAA;AAAA,EAcR,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,WAAO,KAAK,QAAQ;AAAA,MACnB,KAAK,QAAQ,WAAW,KAAK,OAAO,CAAC;AAAA,MACrC,KAAK,OAAO;AAAA,IACb;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;AAAA;AAAA;AAKhC;","names":[]}

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

@@ -0,0 +1,79 @@
+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 { Placeholder, Query, SQLWrapper } from "../../sql/sql.cjs";
+import { Param, SQL } from "../../sql/sql.cjs";
+import { type InferInsertModel, type InferSelectModel } from "../../table.cjs";
+import type { SelectedFieldsFlat, SelectedFieldsOrdered } from "./select.types.cjs";
+export interface MsSqlInsertConfig<TTable extends MsSqlTable = MsSqlTable> {
+    table: TTable;
+    values: Record<string, Param | SQL>[];
+    output?: SelectedFieldsOrdered;
+}
+export type MsSqlInsertValue<TTable extends MsSqlTable, TModel extends Record<string, any> = InferInsertModel<TTable>> = {
+    [Key in keyof TModel]: TModel[Key] | SQL | Placeholder;
+} & {};
+export declare class MsSqlInsertBuilder<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = undefined> {
+    static readonly [entityKind]: string;
+    private config;
+    protected table: TTable;
+    protected session: MsSqlSession;
+    protected dialect: MsSqlDialect;
+    constructor(table: TTable, session: MsSqlSession, dialect: MsSqlDialect, output?: SelectedFieldsOrdered);
+    values(value: MsSqlInsertValue<TTable>): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput>;
+    values(values: MsSqlInsertValue<TTable>[]): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput>;
+    /**
+     * Adds an `output` clause to the query.
+     *
+     * Calling this method will return the specified fields of the inserted rows. If no fields are specified, all fields will be returned.
+     *
+     * @example
+     * ```ts
+     * // Insert one row and return all fields
+     * const insertedCar: Car[] = await db.insert(cars)
+     *   .output();
+     *   .values({ brand: 'BMW' })
+     *
+     * // Insert one row and return only the id
+     * const insertedCarId: { id: number }[] = await db.insert(cars)
+     *   .output({ id: cars.id });
+     *   .values({ brand: 'BMW' })
+     * ```
+     */
+    output(): Omit<MsSqlInsertBuilder<TTable, TQueryResult, TPreparedQueryHKT, InferSelectModel<TTable>>, 'output'>;
+    output<SelectedFields extends SelectedFieldsFlat>(fields: SelectedFields): Omit<MsSqlInsertBuilder<TTable, TQueryResult, TPreparedQueryHKT, SelectResultFields<SelectedFields>>, 'output'>;
+}
+export type MsSqlInsertWithout<T extends AnyMsSqlInsert, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<MsSqlInsertBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+export type MsSqlInsertDynamic<T extends AnyMsSqlInsert> = MsSqlInsert<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output']>;
+export type MsSqlInsertPrepare<T extends AnyMsSqlInsert> = PreparedQueryKind<T['_']['preparedQueryHKT'], PreparedQueryConfig & {
+    execute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];
+    iterator: never;
+}>;
+export type MsSqlInsert<TTable extends MsSqlTable = MsSqlTable, TQueryResult extends QueryResultHKT = AnyQueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> = MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;
+export type AnyMsSqlInsert = MsSqlInsertBase<any, any, any, any, any, any>;
+export interface MsSqlInsertBase<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 MsSqlInsertBase<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;
+    protected $table: TTable;
+    private config;
+    constructor(table: TTable, values: MsSqlInsertConfig['values'], session: MsSqlSession, dialect: MsSqlDialect, output?: SelectedFieldsOrdered);
+    toSQL(): Query;
+    prepare(): MsSqlInsertPrepare<this>;
+    execute(placeholderValues?: Record<string, unknown>): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>;
+    private createIterator;
+    iterator: ReturnType<this["prepare"]>["iterator"];
+}

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

@@ -0,0 +1,79 @@
+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 { Placeholder, Query, SQLWrapper } from "../../sql/sql.js";
+import { Param, SQL } from "../../sql/sql.js";
+import { type InferInsertModel, type InferSelectModel } from "../../table.js";
+import type { SelectedFieldsFlat, SelectedFieldsOrdered } from "./select.types.js";
+export interface MsSqlInsertConfig<TTable extends MsSqlTable = MsSqlTable> {
+    table: TTable;
+    values: Record<string, Param | SQL>[];
+    output?: SelectedFieldsOrdered;
+}
+export type MsSqlInsertValue<TTable extends MsSqlTable, TModel extends Record<string, any> = InferInsertModel<TTable>> = {
+    [Key in keyof TModel]: TModel[Key] | SQL | Placeholder;
+} & {};
+export declare class MsSqlInsertBuilder<TTable extends MsSqlTable, TQueryResult extends QueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = undefined> {
+    static readonly [entityKind]: string;
+    private config;
+    protected table: TTable;
+    protected session: MsSqlSession;
+    protected dialect: MsSqlDialect;
+    constructor(table: TTable, session: MsSqlSession, dialect: MsSqlDialect, output?: SelectedFieldsOrdered);
+    values(value: MsSqlInsertValue<TTable>): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput>;
+    values(values: MsSqlInsertValue<TTable>[]): MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput>;
+    /**
+     * Adds an `output` clause to the query.
+     *
+     * Calling this method will return the specified fields of the inserted rows. If no fields are specified, all fields will be returned.
+     *
+     * @example
+     * ```ts
+     * // Insert one row and return all fields
+     * const insertedCar: Car[] = await db.insert(cars)
+     *   .output();
+     *   .values({ brand: 'BMW' })
+     *
+     * // Insert one row and return only the id
+     * const insertedCarId: { id: number }[] = await db.insert(cars)
+     *   .output({ id: cars.id });
+     *   .values({ brand: 'BMW' })
+     * ```
+     */
+    output(): Omit<MsSqlInsertBuilder<TTable, TQueryResult, TPreparedQueryHKT, InferSelectModel<TTable>>, 'output'>;
+    output<SelectedFields extends SelectedFieldsFlat>(fields: SelectedFields): Omit<MsSqlInsertBuilder<TTable, TQueryResult, TPreparedQueryHKT, SelectResultFields<SelectedFields>>, 'output'>;
+}
+export type MsSqlInsertWithout<T extends AnyMsSqlInsert, TDynamic extends boolean, K extends keyof T & string> = TDynamic extends true ? T : Omit<MsSqlInsertBase<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output'], TDynamic, T['_']['excludedMethods'] | K>, T['_']['excludedMethods'] | K>;
+export type MsSqlInsertDynamic<T extends AnyMsSqlInsert> = MsSqlInsert<T['_']['table'], T['_']['queryResult'], T['_']['preparedQueryHKT'], T['_']['output']>;
+export type MsSqlInsertPrepare<T extends AnyMsSqlInsert> = PreparedQueryKind<T['_']['preparedQueryHKT'], PreparedQueryConfig & {
+    execute: T['_']['output'] extends undefined ? QueryResultKind<T['_']['queryResult'], any> : T['_']['output'][];
+    iterator: never;
+}>;
+export type MsSqlInsert<TTable extends MsSqlTable = MsSqlTable, TQueryResult extends QueryResultHKT = AnyQueryResultHKT, TPreparedQueryHKT extends PreparedQueryHKTBase = PreparedQueryHKTBase, TOutput extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> = MsSqlInsertBase<TTable, TQueryResult, TPreparedQueryHKT, TOutput, true, never>;
+export type AnyMsSqlInsert = MsSqlInsertBase<any, any, any, any, any, any>;
+export interface MsSqlInsertBase<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 MsSqlInsertBase<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;
+    protected $table: TTable;
+    private config;
+    constructor(table: TTable, values: MsSqlInsertConfig['values'], session: MsSqlSession, dialect: MsSqlDialect, output?: SelectedFieldsOrdered);
+    toSQL(): Query;
+    prepare(): MsSqlInsertPrepare<this>;
+    execute(placeholderValues?: Record<string, unknown>): Promise<TOutput extends undefined ? QueryResultKind<TQueryResult, any> : TOutput[]>;
+    private createIterator;
+    iterator: ReturnType<this["prepare"]>["iterator"];
+}

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

@@ -0,0 +1,80 @@
+import { entityKind, is } from "../../entity.js";
+import { QueryPromise } from "../../query-promise.js";
+import { Param, SQL } from "../../sql/sql.js";
+import { Table } from "../../table.js";
+import { orderSelectedFields } from "../../utils.js";
+class MsSqlInsertBuilder {
+  static [entityKind] = "MsSqlInsertBuilder";
+  config;
+  table;
+  session;
+  dialect;
+  constructor(table, session, dialect, output) {
+    this.table = table;
+    this.session = session;
+    this.dialect = dialect;
+    this.config = { table, output };
+  }
+  values(values) {
+    values = Array.isArray(values) ? values : [values];
+    if (values.length === 0) {
+      throw new Error("values() must be called with at least one value");
+    }
+    const mappedValues = values.map((entry) => {
+      const result = {};
+      const cols = this.table[Table.Symbol.Columns];
+      for (const colKey of Object.keys(entry)) {
+        const colValue = entry[colKey];
+        result[colKey] = is(colValue, SQL) ? colValue : new Param(colValue, cols[colKey]);
+      }
+      return result;
+    });
+    return new MsSqlInsertBase(this.table, mappedValues, this.session, this.dialect, this.config.output);
+  }
+  output(fields = this.table[Table.Symbol.Columns]) {
+    this.config.output = orderSelectedFields(fields);
+    return this;
+  }
+}
+class MsSqlInsertBase extends QueryPromise {
+  constructor(table, values, session, dialect, output) {
+    super();
+    this.session = session;
+    this.dialect = dialect;
+    this.config = { table, values, output };
+  }
+  static [entityKind] = "MsSqlInsert";
+  config;
+  /** @internal */
+  getSQL() {
+    return this.dialect.buildInsertQuery(this.config);
+  }
+  toSQL() {
+    const { typings: _typings, ...rest } = this.dialect.sqlToQuery(this.getSQL());
+    return rest;
+  }
+  prepare() {
+    return this.session.prepareQuery(
+      this.dialect.sqlToQuery(this.getSQL()),
+      this.config.output
+    );
+  }
+  execute(placeholderValues) {
+    return this.prepare().execute(placeholderValues);
+  }
+  createIterator = () => {
+    const self = this;
+    return async function* (placeholderValues) {
+      yield* self.prepare().iterator(placeholderValues);
+    };
+  };
+  iterator = this.createIterator();
+  // $dynamic(): MsSqlInsertDynamic<this> {
+  // 	return this as any;
+  // }
+}
+export {
+  MsSqlInsertBase,
+  MsSqlInsertBuilder
+};
+//# sourceMappingURL=insert.js.map