Method merge

packages/sql/src/query/QueryBuilder.ts:1945–1958

(data?: EntityData<Entity> | readonly string[])

  merge<const P extends string>(data: readonly NestedAutoPath<Entity, RootAlias, Context, P>[]): this;
  merge<F extends Field<Entity, RootAlias, Context>>(data?: EntityData<Entity> | F[]): this;
  merge(data?: EntityData<Entity> | readonly string[]): this {
    if (!this.#state.onConflict) {
      throw new Error('You need to call `qb.onConflict()` first to use `qb.merge()`');
    }

    if (Array.isArray(data) && data.length === 0) {
      return this.ignore();
    }

    this.#state.onConflict[this.#state.onConflict.length - 1].merge = data as
      | EntityData<Entity>
      | InternalField<Entity>[];
    return this;
  }

  returning<F extends Field<Entity, RootAlias, Context>>(fields?: F | F[]): this {
    this.#state.returning = Utils.asArray(fields as string);