pqb 0.56.3 → 0.56.5

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { ExpressionTypeMethod, Expression, RawSQLBase, emptyObject, isTemplateLiteralArgs, ColumnTypeBase, setColumnData, pushColumnData, templateLiteralSQLToCode, quoteObjectKey, toArray, emptyArray, singleQuote, addCode, singleQuoteArray, objectHasValues, toSnakeCase, columnDefaultArgumentToCode, columnErrorMessagesToCode, setObjectValueImmutable, getValueKey, addValue, isExpression, dateDataToCode, joinTruthy, arrayDataToCode, numberDataToCode, noop, stringDataToCode, getDefaultLanguage, setDefaultNowFn, setDefaultLanguage, setCurrentColumnName, timestampHelpers, _getQueryAliasOrName, _getQueryOuterAliases, returnArg, pushQueryValueImmutable, NotFoundError, OrchidOrmInternalError, _setSubQueryAliases, _applyRelationAliases, isRelationQuery, _checkIfAliased, logColors, OrchidOrmError, applyTransforms, callWithThis, requirePrimaryKeys, pick, getFreeAlias, _setQueryAs, _copyQueryAliasToQuery, setParserToQuery, newDelayedRelationSelect, pushOrNewArray, getPrimaryKeys, setDelayedRelation, UnhandledTypeError, isRawSQL, pushOrNewArrayToObjectImmutable, QueryHookUtils, MoreThanOneRowError, isObjectEmpty, ValExpression, applyMixins, _getQueryAs, _setQueryAlias, QueryError, snakeCaseKey } from 'orchid-core';
+import { ExpressionTypeMethod, Expression, RawSQLBase, emptyObject, isTemplateLiteralArgs, ColumnTypeBase, setColumnData, pushColumnData, templateLiteralSQLToCode, quoteObjectKey, toArray, emptyArray, singleQuote, addCode, singleQuoteArray, objectHasValues, toSnakeCase, columnDefaultArgumentToCode, columnErrorMessagesToCode, setObjectValueImmutable, getValueKey, addValue, isExpression, dateDataToCode, joinTruthy, arrayDataToCode, numberDataToCode, noop, stringDataToCode, getDefaultLanguage, setDefaultNowFn, setDefaultLanguage, setCurrentColumnName, timestampHelpers, _getQueryAliasOrName, _getQueryOuterAliases, returnArg, pushQueryValueImmutable, NotFoundError, OrchidOrmInternalError, _setSubQueryAliases, _applyRelationAliases, isRelationQuery, getFreeAlias, _checkIfAliased, logColors, OrchidOrmError, applyTransforms, callWithThis, requirePrimaryKeys, pick, _setQueryAs, _copyQueryAliasToQuery, setParserToQuery, newDelayedRelationSelect, pushOrNewArray, getPrimaryKeys, setDelayedRelation, UnhandledTypeError, isRawSQL, pushOrNewArrayToObjectImmutable, _getQueryFreeAlias, _setQueryAlias, QueryHookUtils, MoreThanOneRowError, isObjectEmpty, ValExpression, applyMixins, _getQueryAs, QueryError, snakeCaseKey } from 'orchid-core';
 import { inspect } from 'node:util';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { templateLiteralToSQL as templateLiteralToSQL$1 } from 'pqb';
@@ -4233,14 +4233,7 @@ const throwIfJoinLateral = (q, method) => {
 };
 const saveAliasedShape = (q, as, key) => {
   const shapes = q.q[key];
-  if (shapes?.[as]) {
-    let suffix = 2;
-    let name;
-    while (shapes[name = `${as}${suffix}`]) {
-      suffix++;
-    }
-    as = name;
-  }
+  as = getFreeAlias(shapes, as);
   setQueryObjectValueImmutable(q, key, as, emptyObject);
   return as;
 };
@@ -6352,15 +6345,26 @@ const pushWithSql = (ctx, items) => {
   const sql = withToSql(ctx, items);
   if (sql) ctx.sql.push("WITH", sql);
 };
+const pushOrAppendWithSql = (ctx, query, items) => {
+  const sql = withToSql(ctx, items);
+  if (sql) {
+    if (query.with) {
+      ctx.sql[ctx.sql.length - 1] += ",";
+    } else {
+      ctx.sql.push("WITH");
+    }
+    ctx.sql.push(sql);
+  }
+};
 
 const makeInsertSql = (ctx, q, query, quotedAs) => {
   let { columns } = query;
   const { shape, inCTE, hookCreateSet } = query;
   const QueryClass = ctx.qb.constructor;
-  let values = query.values;
+  let { insertFrom, queryColumnsCount, values } = query;
   let hookSetSql;
   if (hookCreateSet) {
-    ({ hookSetSql, columns, values } = processHookSet(
+    ({ hookSetSql, columns, insertFrom, queryColumnsCount, values } = processHookSet(
       ctx,
       q,
       values,
@@ -6379,6 +6383,7 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
     for (const key of q.internal.runtimeDefaultColumns) {
       if (!columns.includes(key)) {
         const column = shape[key];
+        columns.push(key);
         quotedColumns.push(`"${column.data.name || key}"`);
         runtimeDefaults.push(column.data.runtimeDefault);
       }
@@ -6396,8 +6401,22 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
   }
   const insertSql = `INSERT INTO ${quotedAs}${quotedColumns.length ? "(" + quotedColumns.join(", ") + ")" : ""}`;
   const hasNonSelect = ctx.hasNonSelect;
-  if ("from" in values && query.insertWith) {
-    pushWithSql(ctx, Object.values(query.insertWith).flat());
+  let hasWith = !!query.with;
+  if (insertFrom) {
+    if (values.length < 2) {
+      if (query.insertWith) {
+        hasWith = true;
+        pushOrAppendWithSql(ctx, query, Object.values(query.insertWith).flat());
+      }
+    } else {
+      hasWith = true;
+      pushOrAppendWithSql(ctx, query, [
+        {
+          n: getQueryAs(insertFrom),
+          q: insertFrom
+        }
+      ]);
+    }
   }
   const valuesPos = ctx.sql.length + 1;
   ctx.sql.push(insertSql, null);
@@ -6473,28 +6492,38 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
     );
   }
   if (returning.select) ctx.sql.push("RETURNING", returning.select);
-  if ("from" in values) {
-    const { from, values: v } = values;
-    const q2 = from.clone();
-    if (v) {
-      pushQueryValueImmutable(
-        q2,
-        "select",
-        new RawSQL(
-          encodeRow(
-            ctx,
-            ctx.values,
-            q2,
-            QueryClass,
-            v,
-            runtimeDefaults,
-            quotedAs
+  let insertManyFromValuesAs;
+  if (insertFrom) {
+    if (values.length < 2) {
+      const q2 = insertFrom.clone();
+      if (values[0]?.length) {
+        pushQueryValueImmutable(
+          q2,
+          "select",
+          new RawSQL(
+            encodeRow(
+              ctx,
+              ctx.values,
+              q2,
+              QueryClass,
+              values[0],
+              runtimeDefaults,
+              quotedAs
+            )
           )
-        )
-      );
+        );
+      }
+      ctx.sql[valuesPos] = getSqlText(toSQL(q2, ctx));
+    } else {
+      insertManyFromValuesAs = query.insertValuesAs;
+      const queryAs = getQueryAs(insertFrom);
+      ctx.sql[valuesPos - 1] += ` SELECT "${queryAs}".*, ${columns.slice(queryColumnsCount || 0).map((key) => {
+        const column = shape[key];
+        return column ? `${insertManyFromValuesAs}."${column.data.name || key}"::${column.dataType}` : `${insertManyFromValuesAs}."${key}"`;
+      }).join(", ")} FROM "${queryAs}",`;
     }
-    ctx.sql[valuesPos] = getSqlText(toSQL(q2, ctx));
-  } else {
+  }
+  if (!insertFrom || insertManyFromValuesAs) {
     const valuesSql = [];
     let ctxValues = ctx.values;
     const restValuesLen = ctxValues.length;
@@ -6503,6 +6532,8 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
     const { insertWith } = query;
     const { skipBatchCheck } = ctx;
     const withSqls = [];
+    const startingKeyword = (insertManyFromValuesAs ? "(" : "") + (inCTE ? "SELECT " : "VALUES ");
+    const valuesAppend = insertManyFromValuesAs ? `) ${insertManyFromValuesAs}(${quotedColumns.slice(queryColumnsCount || 0).join(", ")})` : "";
     for (let i = 0; i < values.length; i++) {
       const withes = insertWith?.[i];
       ctx.skipBatchCheck = true;
@@ -6526,11 +6557,8 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
           );
         }
         if (!skipBatchCheck) {
-          if (withSqls.length) {
-            ctx.sql[valuesPos - 1] = "WITH " + withSqls.join(", ") + " " + insertSql;
-            withSqls.length = 0;
-          }
-          ctx.sql[valuesPos] = (inCTE ? "SELECT " : "VALUES ") + valuesSql.join(", ");
+          addWithSqls(ctx, hasWith, withSqls, valuesPos, insertSql);
+          ctx.sql[valuesPos] = startingKeyword + valuesSql.join(", ") + valuesAppend;
           ctxValues.length = currentValuesLen;
           batch = pushOrNewArray(batch, {
             text: ctx.sql.join(" "),
@@ -6546,9 +6574,7 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
       if (withSql) withSqls.push(withSql);
       valuesSql.push(encodedRow);
     }
-    if (withSqls.length) {
-      ctx.sql[valuesPos - 1] = "WITH " + withSqls.join(", ") + " " + insertSql;
-    }
+    addWithSqls(ctx, hasWith, withSqls, valuesPos, insertSql);
     if (batch) {
       if (hasNonSelect) {
         throw new OrchidOrmInternalError(
@@ -6556,7 +6582,7 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
           `Cannot insert many records when having a non-select sub-query`
         );
       }
-      ctx.sql[valuesPos] = (inCTE ? "SELECT " : "VALUES ") + valuesSql.join(", ");
+      ctx.sql[valuesPos] = startingKeyword + valuesSql.join(", ") + valuesAppend;
       batch.push({
         text: ctx.sql.join(" "),
         values: ctxValues
@@ -6567,7 +6593,7 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
         batch
       };
     } else {
-      ctx.sql[valuesPos] = (inCTE ? "SELECT " : "VALUES ") + valuesSql.join(", ");
+      ctx.sql[valuesPos] = startingKeyword + valuesSql.join(", ") + valuesAppend;
     }
     if (inCTE) {
       ctx.sql[valuesPos] += ' WHERE NOT EXISTS (SELECT 1 FROM "f")';
@@ -6580,6 +6606,15 @@ const makeInsertSql = (ctx, q, query, quotedAs) => {
     values: ctx.values
   };
 };
+const addWithSqls = (ctx, hasWith, withSqls, valuesPos, insertSql) => {
+  if (withSqls.length) {
+    if (hasWith) {
+      ctx.sql[valuesPos - 2] += ",";
+    }
+    ctx.sql[valuesPos - 1] = (hasWith ? "" : "WITH ") + withSqls.join(", ") + " " + insertSql;
+    withSqls.length = 0;
+  }
+};
 const processHookSet = (ctx, q, values, hookCreateSet, columns, QueryClass, quotedAs) => {
   const hookSet = {};
   for (const item of hookCreateSet) {
@@ -6588,48 +6623,54 @@ const processHookSet = (ctx, q, values, hookCreateSet, columns, QueryClass, quot
   const addHookSetColumns = Object.keys(hookSet).filter(
     (key) => !columns.includes(key)
   );
-  if ("from" in values) {
-    const v = { ...values };
-    const newColumns = [];
-    const originalSelect = v.from.q.select;
+  let insertFrom = q.q.insertFrom;
+  if (insertFrom) {
+    const newColumns = /* @__PURE__ */ new Set();
+    const originalSelect = insertFrom.q.select;
     if (originalSelect) {
-      v.from = _clone(v.from);
+      insertFrom = _clone(insertFrom);
       const select = [];
       for (const s of originalSelect) {
         if (typeof s === "string" && !hookSet[s]) {
           select.push(s);
-          newColumns.push(s);
+          newColumns.add(s);
         } else if (typeof s === "object" && "selectAs" in s) {
           const filtered = {};
           for (const key in s.selectAs) {
             if (!hookSet[key]) {
               filtered[key] = s.selectAs[key];
-              newColumns.push(key);
+              newColumns.add(key);
             }
           }
           select.push({ selectAs: filtered });
         }
       }
-      v.from.q.select = select;
-    }
-    let row;
-    if (v.values) {
-      const originalRow = v.values;
-      const valuesColumns = columns.slice(-originalRow.length);
-      row = [];
-      valuesColumns.forEach((c, i) => {
-        if (!hookSet[c]) {
-          newColumns.push(c);
-          row.push(originalRow[i]);
-        }
+      insertFrom.q.select = select;
+    }
+    if (values.length) {
+      const newValues = [];
+      const valuesColumnsSet = /* @__PURE__ */ new Set();
+      values.forEach((originalRow, i) => {
+        const valuesColumns = columns.slice(-originalRow.length);
+        const row = [];
+        newValues[i] = row;
+        valuesColumns.forEach((c, i2) => {
+          if (!hookSet[c] && !newColumns.has(c)) {
+            valuesColumnsSet.add(c);
+            row.push(originalRow[i2]);
+          }
+        });
       });
+      for (const valueColumn of valuesColumnsSet) {
+        newColumns.add(valueColumn);
+      }
+      values = newValues;
     } else {
-      row = [];
+      values = [[]];
     }
-    v.values = row;
     columns.forEach((column) => {
       if (column in hookSet) {
-        newColumns.push(column);
+        newColumns.add(column);
         const fromHook = {
           fromHook: encodeValue(
             ctx,
@@ -6640,28 +6681,35 @@ const processHookSet = (ctx, q, values, hookCreateSet, columns, QueryClass, quot
             quotedAs
           )
         };
-        row.push(fromHook);
+        for (const row of values) {
+          row.push(fromHook);
+        }
       }
     });
+    const queryColumnsCount = insertFrom.q.select?.length;
     if (addHookSetColumns) {
       for (const key of addHookSetColumns) {
-        row.push({
-          fromHook: encodeValue(
-            ctx,
-            ctx.values,
-            q,
-            QueryClass,
-            hookSet[key],
-            quotedAs
-          )
-        });
+        for (const row of values) {
+          row.push({
+            fromHook: encodeValue(
+              ctx,
+              ctx.values,
+              q,
+              QueryClass,
+              hookSet[key],
+              quotedAs
+            )
+          });
+        }
       }
       return {
         columns: [...newColumns, ...addHookSetColumns],
-        values: v
+        insertFrom,
+        queryColumnsCount,
+        values
       };
     }
-    return { columns: newColumns, values: v };
+    return { columns: [...newColumns], insertFrom, queryColumnsCount, values };
   }
   columns.forEach((column, i) => {
     if (column in hookSet) {
@@ -6977,8 +7025,7 @@ const selectToSql = (ctx, table, query, quotedAs, hookSelect = query.hookSelect,
           hookSelect.delete(column);
           continue;
         }
-        let i = 2;
-        while (selected[name = `${column}${i}`]) i++;
+        name = getFreeAlias(selected, column);
         item.as = name;
         item.temp = name;
         sql += ` "${name}"`;
@@ -8621,7 +8668,7 @@ class Union {
   }
 }
 
-const addWith = (q, withStore, item, key = "with") => {
+const _addWith = (query, withStore, item, key = "with") => {
   if (item.q) {
     item.q.q.with?.forEach((item2, i, arr) => {
       if (item2?.q?.q.type) {
@@ -8632,7 +8679,8 @@ const addWith = (q, withStore, item, key = "with") => {
     if (item.q.q.insertWith) {
       const values = Object.values(item.q.q.insertWith).flat();
       item.q.q.insertWith = void 0;
-      q.q.with = q.q.with ? [...q.q.with, ...values] : values;
+      const { q } = query;
+      q.with = q.with ? [...q.with, ...values] : values;
     }
   }
   pushOrNewArrayToObjectImmutable(withStore, key, item);
@@ -8640,7 +8688,7 @@ const addWith = (q, withStore, item, key = "with") => {
 const moveQueryValueToWith = (q, withStore, value, withKey, set, key) => {
   if (value.q.type) {
     const as = saveAliasedShape(q, "q", "withShapes");
-    addWith(
+    _addWith(
       q,
       withStore,
       {
@@ -8674,7 +8722,7 @@ class WithMethods {
         columns: Object.keys(query.shape)
       };
     }
-    addWith(q, q.q, { n: name, o: options, q: query });
+    _addWith(q, q.q, { n: name, o: options, q: query });
     const shape = getShapeFromSelect(query, true);
     return setQueryObjectValueImmutable(q, "withShapes", name, {
       shape,
@@ -8700,7 +8748,7 @@ class WithMethods {
         columns: Object.keys(shape)
       };
     }
-    addWith(q, q.q, { n: name, o: options, q: query });
+    _addWith(q, q.q, { n: name, o: options, q: query });
     return setQueryObjectValueImmutable(q, "withShapes", name, withConfig);
   }
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -8718,6 +8766,248 @@ class WithMethods {
   }
 }
 
+const insertFrom = (query, from, many, queryMany, data) => {
+  const ctx = createCtx();
+  const obj = data && (Array.isArray(data) ? handleManyData(query, data, ctx) : handleOneData(query, data, ctx));
+  return insert(
+    query,
+    {
+      insertFrom: from,
+      columns: obj?.columns || [],
+      values: obj?.values || []
+    },
+    many,
+    queryMany
+  );
+};
+const getFromSelectColumns = (q, from, obj, many) => {
+  if (!many && !queryTypeWithLimitOne[from.q.returnType]) {
+    throw new Error(
+      "Cannot create based on a query which returns multiple records"
+    );
+  }
+  const queryColumns = /* @__PURE__ */ new Set();
+  from.q.select?.forEach((item) => {
+    if (typeof item === "string") {
+      const index = item.indexOf(".");
+      queryColumns.add(index === -1 ? item : item.slice(index + 1));
+    } else if (item && "selectAs" in item) {
+      for (const column in item.selectAs) {
+        queryColumns.add(column);
+      }
+    }
+  });
+  const allColumns = new Set(queryColumns);
+  const queryColumnsCount = queryColumns.size;
+  const allValues = [];
+  if (obj?.columns) {
+    for (const objectValues of obj.values) {
+      const values = [];
+      allValues.push(values);
+      obj.columns.forEach((column, i) => {
+        if (!queryColumns.has(column)) {
+          allColumns.add(column);
+          values.push(objectValues[i]);
+        }
+      });
+    }
+  }
+  for (const key of queryColumns) {
+    const column = q.shape[key];
+    if (column) throwOnReadOnly$1(from, column, key);
+  }
+  return {
+    columns: [...allColumns],
+    queryColumnsCount,
+    values: allValues
+  };
+};
+const _queryCreateOneFrom = (q, query, data) => {
+  createSelect(q);
+  return insertFrom(q, query, false, false, data);
+};
+const _queryInsertOneFrom = (q, query, data) => {
+  return insertFrom(q, query, false, false, data);
+};
+const _queryCreateManyFrom = (q, query, data) => {
+  createSelect(q);
+  return insertFrom(q, query, true, false, data);
+};
+const _queryInsertManyFrom = (q, query, data) => {
+  return insertFrom(q, query, true, false, data);
+};
+const _queryCreateForEachFrom = (q, query) => {
+  createSelect(q);
+  return insertFrom(q, query, true, true);
+};
+const _queryInsertForEachFrom = (q, query) => {
+  return insertFrom(q, query, true, true);
+};
+class QueryCreateFrom {
+  /**
+   * Inserts a single record based on a query that selects a single record.
+   *
+   * Performs a single SQL query based on `INSERT ... SELECT ... FROM`.
+   *
+   * See {@link createManyFrom} to insert multiple records based on a single record query,
+   * and {@link createForEachFrom} to insert a record per every one found by the query.
+   *
+   * The first argument is a query of a **single** record, it should have `find`, `take`, or similar.
+   *
+   * The second optional argument is a data which will be merged with columns returned by the query.
+   *
+   * The data for the second argument is the same as in {@link create}.
+   *
+   * Columns with runtime defaults (defined with a callback) are supported here.
+   * The value for such a column will be injected unless selected from a related table or provided in a data object.
+   *
+   * ```ts
+   * const oneRecord = await db.table.createOneFrom(
+   *   db.relatedTable
+   *     // use select to map columns from one table to another
+   *     .select({
+   *       // relatedTable's id will be inserted as "relatedId"
+   *       relatedId: 'id',
+   *     })
+   *     .findBy({ key: 'value' }),
+   *   // optional argument:
+   *   {
+   *     key: 'value',
+   *     // supports sql, nested select, create, update, delete queries
+   *     fromSql: () => sql`custom sql`,
+   *     fromQuery: () => db.otherTable.find(id).update(data).get('column'),
+   *     fromRelated: (q) => q.relatedTable.create(data).get('column'),
+   *   },
+   * );
+   * ```
+   *
+   * The query above will produce such a SQL (omitting `from*` values):
+   *
+   * ```sql
+   * INSERT INTO "table"("relatedId", "key")
+   * SELECT "relatedTable"."id" AS "relatedId", 'value'
+   * FROM "relatedTable"
+   * WHERE "relatedTable"."key" = 'value'
+   * LIMIT 1
+   * RETURNING *
+   * ```
+   *
+   * @param query - query to create new records from
+   * @param data - additionally you can set some columns
+   */
+  createOneFrom(query, data) {
+    return _queryCreateOneFrom(_clone(this), query, data);
+  }
+  /**
+   * Works exactly as {@link createOneFrom}, except that it returns inserted row count by default.
+   *
+   * @param query - query to create new records from
+   * @param data - additionally you can set some columns
+   */
+  insertOneFrom(query, data) {
+    return _queryInsertOneFrom(_clone(this), query, data);
+  }
+  /**
+   * Inserts multiple records based on a query that selects a single record.
+   *
+   * Performs a single SQL query based on `INSERT ... SELECT ... FROM`.
+   *
+   * See {@link createOneFrom} to insert a single record based on a single record query,
+   * and {@link createForEachFrom} to insert a record per every one found by the query.
+   *
+   * The first argument is a query of a **single** record, it should have `find`, `take`, or similar.
+   *
+   * The second argument is array of objects to be merged with columns returned by the query.
+   *
+   * The data for the second argument is the same as in {@link createMany}.
+   *
+   * Columns with runtime defaults (defined with a callback) are supported here.
+   * The value for such a column will be injected unless selected from a related table or provided in a data object.
+   *
+   * ```ts
+   * const twoRecords = await db.table.createManyFrom(
+   *   db.relatedTable
+   *     // use select to map columns from one table to another
+   *     .select({
+   *       // relatedTable's id will be inserted as "relatedId"
+   *       relatedId: 'id',
+   *     })
+   *     .findBy({ key: 'value' }),
+   *   [
+   *     {
+   *       key: 'value 1',
+   *       // supports sql, nested select, create, update, delete queries
+   *       fromSql: () => sql`custom sql`,
+   *       fromQuery: () => db.otherTable.find(id).update(data).get('column'),
+   *       fromRelated: (q) => q.relatedTable.create(data).get('column'),
+   *     },
+   *     {
+   *       key: 'value 2',
+   *     },
+   *   ],
+   * );
+   * ```
+   *
+   * The query above will produce such a SQL (omitting `from*` values):
+   *
+   * ```sql
+   * WITH "relatedTable" AS (
+   *   SELECT "relatedTable"."id" AS "relatedId", 'value'
+   *   FROM "relatedTable"
+   *   WHERE "relatedTable"."key" = 'value'
+   *   LIMIT 1
+   * )
+   * INSERT INTO "table"("relatedId", "key")
+   * SELECT "relatedTable".*, v."key"::text
+   * FROM "relatedTable", (VALUES ('value1'), ('value2')) v("key")
+   * RETURNING *
+   * ```
+   *
+   * @param query - query to create new records from
+   * @param data - array of records to create
+   */
+  createManyFrom(query, data) {
+    return _queryCreateManyFrom(_clone(this), query, data);
+  }
+  /**
+   * Works exactly as {@link createManyFrom}, except that it returns inserted row count by default.
+   *
+   * @param query - query to create new records from
+   * @param data - array of records to create
+   */
+  insertManyFrom(query, data) {
+    return _queryInsertManyFrom(_clone(this), query, data);
+  }
+  /**
+   * Inserts a single record per every record found in a given query.
+   *
+   * Performs a single SQL query based on `INSERT ... SELECT ... FROM`.
+   *
+   * Unlike {@link createOneFrom}, it doesn't accept second argument with data.
+   *
+   * Runtime defaults cannot work with it.
+   *
+   * ```ts
+   * const manyRecords = await db.table.createForEachFrom(
+   *   RelatedTable.select({ relatedId: 'id' }).where({ key: 'value' }),
+   * );
+   * ```
+   *
+   * @param query - query to create new records from
+   */
+  createForEachFrom(query) {
+    return _queryCreateForEachFrom(_clone(this), query);
+  }
+  /**
+   * Works exactly as {@link createForEachFrom}, except that it returns inserted row count by default.
+   *
+   * @param query - query to create new records from
+   */
+  insertForEachFrom(query) {
+    return _queryInsertForEachFrom(_clone(this), query);
+  }
+}
+
 const createSelect = (q) => {
   if (q.q.returnType === "void" || isSelectingCount(q)) {
     q.q.select = void 0;
@@ -8816,8 +9106,9 @@ const handleManyData = (q, data, ctx) => {
 };
 const insert = (self, {
   columns,
+  insertFrom,
   values
-}, many) => {
+}, many, queryMany) => {
   const { q } = self;
   if (!q.select?.length) {
     q.returning = true;
@@ -8826,6 +9117,28 @@ const insert = (self, {
   delete q.or;
   delete q.scopes;
   q.type = "insert";
+  insertFrom = insertFrom ? q.insertFrom = insertFrom : q.insertFrom;
+  if (insertFrom) {
+    if (q.insertFrom) {
+      const obj = getFromSelectColumns(
+        self,
+        q.insertFrom,
+        {
+          columns,
+          values
+        },
+        queryMany
+      );
+      columns = obj.columns;
+      values = obj.values;
+      q.queryColumnsCount = obj.queryColumnsCount;
+    }
+    if (values.length > 1) {
+      const insertValuesAs = _getQueryFreeAlias(q, "v");
+      _setQueryAlias(self, "v", insertValuesAs);
+      q.insertValuesAs = insertValuesAs;
+    }
+  }
   q.columns = columns;
   q.values = values;
   const { select, returnType } = q;
@@ -8841,63 +9154,20 @@ const insert = (self, {
       q.returnType = "pluck";
     }
   } else if (!returnType || returnType === "all") {
-    q.returnType = "from" in values ? values.from.q.returnType : "one";
+    q.returnType = insertFrom ? insertFrom.q.returnType : "one";
   } else if (returnType === "pluck") {
     q.returnType = "valueOrThrow";
   }
   return self;
 };
-const getFromSelectColumns = (q, from, obj, many) => {
-  if (!many && !queryTypeWithLimitOne[from.q.returnType]) {
-    throw new Error(
-      "Cannot create based on a query which returns multiple records"
-    );
-  }
-  const queryColumns = [];
-  from.q.select?.forEach((item) => {
-    if (typeof item === "string") {
-      const index = item.indexOf(".");
-      queryColumns.push(index === -1 ? item : item.slice(index + 1));
-    } else if (item && "selectAs" in item) {
-      queryColumns.push(...Object.keys(item.selectAs));
-    }
-  });
-  if (obj?.columns) {
-    queryColumns.push(...obj.columns);
-  }
-  for (const key of queryColumns) {
-    const column = q.shape[key];
-    if (column) throwOnReadOnly$1(from, column, key);
-  }
-  return queryColumns;
-};
-const insertFromQuery = (q, from, many, data) => {
-  const ctx = createCtx();
-  const obj = data && handleOneData(q, data, ctx);
-  const columns = getFromSelectColumns(q, from, obj, many);
-  return insert(
-    q,
-    {
-      columns,
-      values: { from, values: obj?.values[0] }
-    },
-    many
-  );
-};
 const _queryCreate = (q, data) => {
   createSelect(q);
   return _queryInsert(q, data);
 };
-const _queryInsert = (q, data) => {
+const _queryInsert = (query, data) => {
   const ctx = createCtx();
-  const obj = handleOneData(q, data, ctx);
-  const values = q.q.values;
-  if (values && "from" in values) {
-    obj.columns = getFromSelectColumns(q, values.from, obj);
-    values.values = obj.values[0];
-    obj.values = values;
-  }
-  return insert(q, obj);
+  const obj = handleOneData(query, data, ctx);
+  return insert(query, obj);
 };
 const _queryCreateMany = (q, data) => {
   createSelect(q);
@@ -8909,20 +9179,6 @@ const _queryInsertMany = (q, data) => {
   if (!data.length) result = result.none();
   return result;
 };
-const _queryCreateFrom = (q, query, data) => {
-  createSelect(q);
-  return insertFromQuery(q, query, false, data);
-};
-const _queryInsertFrom = (q, query, data) => {
-  return insertFromQuery(q, query, false, data);
-};
-const _queryCreateManyFrom = (q, query) => {
-  createSelect(q);
-  return insertFromQuery(q, query, true);
-};
-const _queryInsertManyFrom = (q, query) => {
-  return insertFromQuery(q, query, true);
-};
 const _queryDefaults = (q, data) => {
   q.q.defaults = data;
   return q;
@@ -9040,85 +9296,6 @@ class QueryCreate {
   insertMany(data) {
     return _queryInsertMany(_clone(this), data);
   }
-  /**
-   * These methods are for creating a single record, for batch creating see {@link createManyFrom}.
-   *
-   * `createFrom` is to perform the `INSERT ... SELECT ...` SQL statement, it does select and insert by performing a single query.
-   *
-   * The first argument is a query for a **single** record, it should have `find`, `take`, or similar.
-   *
-   * The second optional argument is a data which will be merged with columns returned from the select query.
-   *
-   * The data for the second argument is the same as in {@link create}.
-   *
-   * Columns with runtime defaults (defined with a callback) are supported here.
-   * The value for such a column will be injected unless selected from a related table or provided in a data object.
-   *
-   * ```ts
-   * const oneRecord = await db.table.createFrom(
-   *   // In the select, key is a related table column, value is a column to insert as
-   *   RelatedTable.select({ relatedId: 'id' }).findBy({ key: 'value' }),
-   *   // optional argument:
-   *   {
-   *     key: 'value',
-   *     // supports sql, nested select, create, update, delete queries
-   *     fromSql: () => sql`custom sql`,
-   *     fromQuery: () => db.otherTable.find(id).update(data).get('column'),
-   *     fromRelated: (q) => q.relatedTable.create(data).get('column'),
-   *   },
-   * );
-   * ```
-   *
-   * The query above will produce such SQL:
-   *
-   * ```sql
-   * INSERT INTO "table"("relatedId", "key")
-   * SELECT "relatedTable"."id" AS "relatedId", 'value'
-   * FROM "relatedTable"
-   * WHERE "relatedTable"."key" = 'value'
-   * LIMIT 1
-   * RETURNING *
-   * ```
-   *
-   * @param query - query to create new records from
-   * @param data - additionally you can set some columns
-   */
-  createFrom(query, data) {
-    return _queryCreateFrom(_clone(this), query, data);
-  }
-  /**
-   * Works exactly as {@link createFrom}, except that it returns inserted row count by default.
-   *
-   * @param query - query to create new records from
-   * @param data - additionally you can set some columns
-   */
-  insertFrom(query, data) {
-    return _queryInsertFrom(_clone(this), query, data);
-  }
-  /**
-   * Similar to `createFrom`, but intended to create many records.
-   *
-   * Unlike `createFrom`, it doesn't accept second argument with data, and runtime defaults cannot work with it.
-   *
-   * ```ts
-   * const manyRecords = await db.table.createManyFrom(
-   *   RelatedTable.select({ relatedId: 'id' }).where({ key: 'value' }),
-   * );
-   * ```
-   *
-   * @param query - query to create new records from
-   */
-  createManyFrom(query) {
-    return _queryCreateManyFrom(_clone(this), query);
-  }
-  /**
-   * Works exactly as {@link createManyFrom}, except that it returns inserted row count by default.
-   *
-   * @param query - query to create new records from
-   */
-  insertManyFrom(query) {
-    return _queryInsertManyFrom(_clone(this), query);
-  }
   /**
    * `defaults` allows setting values that will be used later in `create`.
    *
@@ -10503,9 +10680,9 @@ class Join {
   }
   /**
    * This method may be useful
-   * for combining with [createManyFrom](/guide/create-update-delete.html#createmanyfrom-insertmanyfrom).
+   * for combining with [createForEachFrom](/guide/create-update-delete.html#createForEachFrom-insertForEachFrom).
    *
-   * `createManyFrom` creates multiple record based on a selecting query:
+   * `createForEachFrom` creates multiple record based on a selecting query:
    *
    * ```sql
    * INSERT INTO t1(c1, c2)
@@ -10519,7 +10696,7 @@ class Join {
    * ```ts
    * const data = [{ column2: 'one' }, { column2: 'two' }, { column2: 'three' }];
    *
-   * await db.table.createManyFrom(
+   * await db.table.createForEachFrom(
    *   db.otherTable
    *     .joinData('data', (t) => ({ column2: t.text() }), data)
    *     .select('otherTable.column1', 'data.column2'),
@@ -12616,6 +12793,7 @@ applyMixins(QueryMethods, [
   Union,
   JsonMethods,
   QueryCreate,
+  QueryCreateFrom,
   Update,
   Delete,
   Transaction,
@@ -13254,5 +13432,5 @@ function copyTableData(query, arg) {
   return q;
 }
 
-export { AfterCommitError, AggregateMethods, ArrayColumn, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, ByteaColumn, CidrColumn, CircleColumn, CitextColumn, Clear, ColumnRefExpression, ColumnType, ComputedColumn, CustomTypeColumn, DateBaseColumn, DateColumn, DateTimeBaseClass, DateTimeTzBaseClass, Db, DecimalColumn, Delete, DomainColumn, DoublePrecisionColumn, DynamicRawSQL, EnumColumn, ExpressionMethods, FnExpression, For, FromMethods, Having, InetColumn, IntegerBaseColumn, IntegerColumn, IntervalColumn, JSONColumn, JSONTextColumn, Join, JsonMethods, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQueryMethods, MoneyColumn, NumberAsStringBaseColumn, NumberBaseColumn, OnConflictQueryBuilder, OnMethods, Operators, OrExpression, PathColumn, PointColumn, PolygonColumn, PostgisGeographyPointColumn, QueryAsMethods, QueryCreate, QueryGet, QueryHooks, QueryLog, QueryMethods, QueryUpsert, RawSQL, RealColumn, RefExpression, SearchMethods, Select, SerialColumn, SmallIntColumn, SmallSerialColumn, SqlMethod, StringColumn, TextBaseColumn, TextColumn, Then, TimeColumn, TimestampColumn, TimestampTZColumn, Transaction, TransformMethods, TsQueryColumn, TsVectorColumn, UUIDColumn, Union, UnknownColumn, Update, VarCharColumn, VirtualColumn, Where, WithMethods, XMLColumn, _clone, _getSelectableColumn, _initQueryBuilder, _queryAfterSaveCommit, _queryAll, _queryChangeCounter, _queryCreate, _queryCreateFrom, _queryCreateMany, _queryCreateManyFrom, _queryDefaults, _queryDelete, _queryExec, _queryFindBy, _queryFindByOptional, _queryGet, _queryGetOptional, _queryHookAfterCreate, _queryHookAfterCreateCommit, _queryHookAfterDelete, _queryHookAfterDeleteCommit, _queryHookAfterQuery, _queryHookAfterSave, _queryHookAfterUpdate, _queryHookAfterUpdateCommit, _queryHookBeforeCreate, _queryHookBeforeDelete, _queryHookBeforeQuery, _queryHookBeforeSave, _queryHookBeforeUpdate, _queryInsert, _queryInsertFrom, _queryInsertMany, _queryInsertManyFrom, _queryJoinOn, _queryJoinOnJsonPathEquals, _queryJoinOrOn, _queryOr, _queryOrNot, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUnion, _queryUpdate, _queryUpdateOrThrow, _queryWhere, _queryWhereExists, _queryWhereIn, _queryWhereNot, _queryWhereNotOneOf, _queryWhereNotSql, _queryWhereOneOf, _queryWhereSql, _runAfterCommitHooks, addColumnParserToQuery, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, applyComputedColumns, assignDbDataToColumn, checkIfASimpleQuery, cloneQueryBaseUnscoped, columnCheckToCode, columnCode, columnExcludesToCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, commitSql, constraintInnerToCode, constraintToCode, copyTableData, countSelect, createDbWithAdapter, defaultSchemaConfig, escapeForLog, escapeForMigration, escapeString, excludeInnerToCode, excludeToCode, extendQuery, filterResult, foreignKeyArgumentToCode, getClonedQueryData, getColumnBaseType, getColumnInfo, getColumnTypes, getFullColumnTable, getQueryAs, getShapeFromSelect, getSqlText, handleResult, identityToCode, indexInnerToCode, indexToCode, isDefaultTimeStamp, isInUserTransaction, isQueryReturnsAll, isSelectingCount, joinSubQuery, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeFnExpression, moveQueryValueToWith, parseRecord, parseTableData, parseTableDataInput, postgisTypmodToSql, primaryKeyInnerToCode, processComputedBatches, processComputedResult, processSelectArg, pushLimitSQL, pushQueryArrayImmutable, pushQueryOn, pushQueryOnForOuter, pushQueryOrOn, pushTableDataCode, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, raw, referencesArgsToCode, resolveSubQueryCallbackV2, rollbackSql, saveAliasedShape, setColumnDefaultParse, setColumnEncode, setColumnParse, setColumnParseNull, setParserForSelectedString, setQueryObjectValueImmutable, setQueryOperators, simplifyColumnDefault, sqlFn, sqlQueryArgsToExpression, tableDataMethods, templateLiteralToSQL, testTransaction, throwIfJoinLateral, throwIfNoWhere, toSQL };
+export { AfterCommitError, AggregateMethods, ArrayColumn, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, ByteaColumn, CidrColumn, CircleColumn, CitextColumn, Clear, ColumnRefExpression, ColumnType, ComputedColumn, CustomTypeColumn, DateBaseColumn, DateColumn, DateTimeBaseClass, DateTimeTzBaseClass, Db, DecimalColumn, Delete, DomainColumn, DoublePrecisionColumn, DynamicRawSQL, EnumColumn, ExpressionMethods, FnExpression, For, FromMethods, Having, InetColumn, IntegerBaseColumn, IntegerColumn, IntervalColumn, JSONColumn, JSONTextColumn, Join, JsonMethods, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQueryMethods, MoneyColumn, NumberAsStringBaseColumn, NumberBaseColumn, OnMethods, Operators, OrExpression, PathColumn, PointColumn, PolygonColumn, PostgisGeographyPointColumn, QueryAsMethods, QueryGet, QueryHooks, QueryLog, QueryMethods, QueryUpsert, RawSQL, RealColumn, RefExpression, SearchMethods, Select, SerialColumn, SmallIntColumn, SmallSerialColumn, SqlMethod, StringColumn, TextBaseColumn, TextColumn, Then, TimeColumn, TimestampColumn, TimestampTZColumn, Transaction, TransformMethods, TsQueryColumn, TsVectorColumn, UUIDColumn, Union, UnknownColumn, Update, VarCharColumn, VirtualColumn, Where, WithMethods, XMLColumn, _addWith, _clone, _getSelectableColumn, _initQueryBuilder, _queryAfterSaveCommit, _queryAll, _queryChangeCounter, _queryCreate, _queryCreateForEachFrom, _queryCreateMany, _queryCreateManyFrom, _queryCreateOneFrom, _queryDefaults, _queryDelete, _queryExec, _queryFindBy, _queryFindByOptional, _queryGet, _queryGetOptional, _queryHookAfterCreate, _queryHookAfterCreateCommit, _queryHookAfterDelete, _queryHookAfterDeleteCommit, _queryHookAfterQuery, _queryHookAfterSave, _queryHookAfterUpdate, _queryHookAfterUpdateCommit, _queryHookBeforeCreate, _queryHookBeforeDelete, _queryHookBeforeQuery, _queryHookBeforeSave, _queryHookBeforeUpdate, _queryInsert, _queryInsertForEachFrom, _queryInsertMany, _queryInsertManyFrom, _queryInsertOneFrom, _queryJoinOn, _queryJoinOnJsonPathEquals, _queryJoinOrOn, _queryOr, _queryOrNot, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUnion, _queryUpdate, _queryUpdateOrThrow, _queryWhere, _queryWhereExists, _queryWhereIn, _queryWhereNot, _queryWhereNotOneOf, _queryWhereNotSql, _queryWhereOneOf, _queryWhereSql, _runAfterCommitHooks, addColumnParserToQuery, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, applyComputedColumns, assignDbDataToColumn, checkIfASimpleQuery, cloneQueryBaseUnscoped, columnCheckToCode, columnCode, columnExcludesToCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, commitSql, constraintInnerToCode, constraintToCode, copyTableData, countSelect, createDbWithAdapter, defaultSchemaConfig, escapeForLog, escapeForMigration, escapeString, excludeInnerToCode, excludeToCode, extendQuery, filterResult, foreignKeyArgumentToCode, getClonedQueryData, getColumnBaseType, getColumnInfo, getColumnTypes, getFullColumnTable, getQueryAs, getShapeFromSelect, getSqlText, handleResult, identityToCode, indexInnerToCode, indexToCode, isDefaultTimeStamp, isInUserTransaction, isQueryReturnsAll, isSelectingCount, joinSubQuery, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeFnExpression, moveQueryValueToWith, parseRecord, parseTableData, parseTableDataInput, postgisTypmodToSql, primaryKeyInnerToCode, processComputedBatches, processComputedResult, processSelectArg, pushLimitSQL, pushQueryArrayImmutable, pushQueryOn, pushQueryOnForOuter, pushQueryOrOn, pushTableDataCode, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, raw, referencesArgsToCode, resolveSubQueryCallbackV2, rollbackSql, saveAliasedShape, setColumnDefaultParse, setColumnEncode, setColumnParse, setColumnParseNull, setParserForSelectedString, setQueryObjectValueImmutable, setQueryOperators, simplifyColumnDefault, sqlFn, sqlQueryArgsToExpression, tableDataMethods, templateLiteralToSQL, testTransaction, throwIfJoinLateral, throwIfNoWhere, toSQL };
 //# sourceMappingURL=index.mjs.map