pqb 0.32.0 → 0.33.1

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { ExpressionTypeMethod, Expression, RawSQLBase, emptyObject, isTemplateLiteralArgs, ColumnTypeBase, setColumnData, pushColumnData, quoteObjectKey, toArray, singleQuote, addCode, singleQuoteArray, objectHasValues, columnDefaultArgumentToCode, columnErrorMessagesToCode, getValueKey, addValue, isExpression, joinTruthy, numberDataToCode, stringDataToCode, getDefaultLanguage, dateDataToCode, pushOrNewArrayToObject, returnArg as returnArg$1, noop, arrayDataToCode, emptyArray, callWithThis, setParserToQuery, applyTransforms, isRawSQL, pushOrNewArray, setDefaultNowFn, setDefaultLanguage, makeTimestampsHelpers, setCurrentColumnName, setAdapterConnectRetry, isObjectEmpty, ValExpression, applyMixins, toSnakeCase, snakeCaseKey } from 'orchid-core';
+import { ExpressionTypeMethod, Expression, RawSQLBase, emptyObject, isTemplateLiteralArgs, ColumnTypeBase, setColumnData, pushColumnData, quoteObjectKey, toArray, singleQuote, addCode, singleQuoteArray, objectHasValues, columnDefaultArgumentToCode, columnErrorMessagesToCode, getValueKey, addValue, isExpression, joinTruthy, numberDataToCode, stringDataToCode, getDefaultLanguage, dateDataToCode, pushOrNewArrayToObject, returnArg as returnArg$1, noop, arrayDataToCode, emptyArray, callWithThis, applyTransforms, setParserToQuery, isRawSQL, pushOrNewArray, setDefaultNowFn, setDefaultLanguage, makeTimestampsHelpers, setCurrentColumnName, setAdapterConnectRetry, isObjectEmpty, ValExpression, applyMixins, toSnakeCase, snakeCaseKey } from 'orchid-core';
 import pg from 'pg';
 import { inspect } from 'node:util';
 import { AsyncLocalStorage } from 'node:async_hooks';
@@ -879,6 +879,25 @@ const make = (_op) => {
       return setQueryOperators(this, boolean);
     },
     {
+      // function to turn the operator expression into SQL
+      _op
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  );
+};
+const makeVarArg = (_op) => {
+  return Object.assign(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function(...args) {
+      var _a, _b, _c;
+      ((_b = (_a = this.q).chain) != null ? _b : _a.chain = []).push(_op, args);
+      if ((_c = this.q.parsers) == null ? void 0 : _c[getValueKey]) {
+        this.q.parsers[getValueKey] = void 0;
+      }
+      return setQueryOperators(this, boolean);
+    },
+    {
+      // function to turn the operator expression into SQL
       _op
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -961,15 +980,51 @@ const text = __spreadProps$7(__spreadValues$f({}, base), {
     (key, value, ctx, quotedAs) => `${key} LIKE '%' || ${quoteValue$1(value, ctx, quotedAs)}`
   )
 });
+const encodeJsonPath = (ctx, path) => addValue(ctx.values, `{${Array.isArray(path) ? path.join(", ") : path}}`);
+const jsonPathQueryOp = (key, [path, options], ctx) => `jsonb_path_query_first(${key}, ${addValue(ctx.values, path)}${(options == null ? void 0 : options.vars) ? `, ${addValue(ctx.values, JSON.stringify(options.vars))}${options.silent ? ", true" : ""}` : (options == null ? void 0 : options.silent) ? ", NULL, true" : ""})`;
 const json = __spreadProps$7(__spreadValues$f({}, base), {
-  jsonPath: make(
-    (key, [path, op, value], ctx, quotedAs) => `jsonb_path_query_first(${key}, '${path}') #>> '{}' ${op} ${value === null ? "null" : quoteValue$1(value, ctx, quotedAs, true)}`
+  jsonPathQueryFirst: Object.assign(
+    function(path, options) {
+      var _a, _b, _c, _d, _e;
+      ((_b = (_a = this.q).chain) != null ? _b : _a.chain = []).push(jsonPathQueryOp, [path, options]);
+      if ((_c = this.q.parsers) == null ? void 0 : _c[getValueKey]) {
+        this.q.parsers[getValueKey] = void 0;
+      }
+      if (options == null ? void 0 : options.type) {
+        const parse = options.type(this.columnTypes).parseFn;
+        if (parse)
+          ((_e = (_d = this.q).parsers) != null ? _e : _d.parsers = {})[getValueKey] = parse;
+      }
+      return this;
+    },
+    { _op: jsonPathQueryOp }
   ),
   jsonSupersetOf: make(
     (key, value, ctx, quotedAs) => `${key} @> ${quoteValue$1(value, ctx, quotedAs, true)}`
   ),
   jsonSubsetOf: make(
     (key, value, ctx, quotedAs) => `${key} <@ ${quoteValue$1(value, ctx, quotedAs, true)}`
+  ),
+  jsonSet: makeVarArg(
+    (key, [path, value], ctx) => `jsonb_set(${key}, ${encodeJsonPath(ctx, path)}, ${addValue(
+      ctx.values,
+      JSON.stringify(value)
+    )})`
+  ),
+  jsonReplace: makeVarArg(
+    (key, [path, value], ctx) => `jsonb_set(${key}, ${encodeJsonPath(ctx, path)}, ${addValue(
+      ctx.values,
+      JSON.stringify(value)
+    )}, false)`
+  ),
+  jsonInsert: makeVarArg(
+    (key, [path, value, options], ctx) => `jsonb_insert(${key}, ${encodeJsonPath(ctx, path)}, ${addValue(
+      ctx.values,
+      JSON.stringify(value)
+    )}${(options == null ? void 0 : options.after) ? ", true" : ""})`
+  ),
+  jsonRemove: makeVarArg(
+    (key, [path], ctx) => `(${key} #- ${encodeJsonPath(ctx, path)})`
   )
 });
 const Operators = {
@@ -2075,9 +2130,13 @@ const processWhere = (ands, ctx, table, query, data, quotedAs) => {
   if ("prototype" in data || "baseQuery" in data) {
     const query2 = data;
     if (query2.q.expr) {
-      const q = joinSubQuery(table, query2);
-      q.q.select = [query2.q.expr];
-      ands.push(`(${getSqlText(makeSQL(q, ctx))})`);
+      if (query2.q.subQuery === 1) {
+        ands.push(selectToSql(ctx, table, query2.q, quotedAs));
+      } else {
+        const q = joinSubQuery(table, query2);
+        q.q.select = [query2.q.expr];
+        ands.push(`(${getSqlText(makeSQL(q, ctx))})`);
+      }
     } else {
       pushWhereToSql(
         ands,
@@ -3304,9 +3363,7 @@ const then = async (q, adapter, trx, beforeHooks, afterHooks, afterCommitHooks,
         result = filterResult(q, returnType, queryResult, hookSelect, result);
     }
     if (query.transform) {
-      for (const fn of query.transform) {
-        result = fn(result);
-      }
+      result = applyTransforms(returnType, query.transform, result);
     }
     return resolve == null ? void 0 : resolve(result);
   } catch (err) {
@@ -3524,10 +3581,8 @@ const addParserForSelectItem = (q, as, key, arg) => {
         setParserToQuery(q.q, key, (item) => {
           const t = query.returnType || "all";
           subQueryResult.rows = t === "value" || t === "valueOrThrow" ? [[item]] : t === "one" || t === "oneOrThrow" ? [item] : item;
-          return applyTransforms(
-            query.transform,
-            query.handleResult(arg, t, subQueryResult, true)
-          );
+          const result = query.handleResult(arg, t, subQueryResult, true);
+          return query.transform ? applyTransforms(t, query.transform, result) : result;
         });
       }
       if (query.returnType === "valueOrThrow" || query.returnType === "oneOrThrow") {
@@ -3608,7 +3663,7 @@ const processSelectArg = (q, as, arg, columnAs) => {
           (q2) => q2,
           key
         );
-      } else if (((_d = value.q) == null ? void 0 : _d.isSubQuery) && value.q.expr) {
+      } else if (((_d = value.q) == null ? void 0 : _d.subQuery) && value.q.expr) {
         value = value.q.expr;
       }
     }
@@ -3783,7 +3838,7 @@ class SelectItemExpression extends Expression {
   // except that it will use non-aliasing `columnToSql` when `ctx.aliasValue` is true,
   // it is needed for relation sub-queries that returns a single column.
   makeSQL(ctx, quotedAs) {
-    return typeof this.item === "string" ? this.item === "*" ? selectAllSql(this.query, this.q, quotedAs) : ctx.aliasValue ? columnToSql(ctx, this.q, this.q.shape, this.item, quotedAs, true) : columnToSqlWithAs(ctx, this.q, this.item, quotedAs, true) : selectedObjectToSQL(ctx, this.query, quotedAs, this.item);
+    return typeof this.item === "string" ? this.item === "*" ? selectAllSql(this.query, this.q, quotedAs) : ctx.aliasValue ? columnToSql(ctx, this.q, this.q.shape, this.item, quotedAs, true) : columnToSqlWithAs(ctx, this.q, this.item, quotedAs, true) : selectedObjectToSQL(ctx, quotedAs, this.item);
   }
 }
 
@@ -3991,50 +4046,6 @@ function queryJson(self, coalesce) {
   return q;
 }
 
-const jsonColumnOrMethodToSql = (ctx, table, column, values, quotedAs) => {
-  return typeof column === "string" ? columnToSql(ctx, table.q, table.q.shape, column, quotedAs) : jsonToSql(ctx, table, column, values, quotedAs);
-};
-const jsonToSql = (ctx, table, item, values, quotedAs) => {
-  const json = item.__json;
-  if (json[0] === "pathQuery") {
-    const [, , , column, path, options] = json;
-    return `jsonb_path_query(${jsonColumnOrMethodToSql(
-      ctx,
-      table,
-      column,
-      values,
-      quotedAs
-    )}, ${addValue(values, path)}${(options == null ? void 0 : options.vars) ? `, ${addValue(values, options.vars)}` : ""}${(options == null ? void 0 : options.silent) ? ", true" : ""})`;
-  } else if (json[0] === "set") {
-    const [, , , column, path, value, options] = json;
-    return `jsonb_set(${jsonColumnOrMethodToSql(
-      ctx,
-      table,
-      column,
-      values,
-      quotedAs
-    )}, '{${path.join(", ")}}', ${addValue(values, JSON.stringify(value))}${(options == null ? void 0 : options.createIfMissing) ? ", true" : ""})`;
-  } else if (json[0] === "insert") {
-    const [, , , column, path, value, options] = json;
-    return `jsonb_insert(${jsonColumnOrMethodToSql(
-      ctx,
-      table,
-      column,
-      values,
-      quotedAs
-    )}, '{${path.join(", ")}}', ${addValue(values, JSON.stringify(value))}${(options == null ? void 0 : options.insertAfter) ? ", true" : ""})`;
-  } else if (json[0] === "remove") {
-    const [, , , column, path] = json;
-    return `${jsonColumnOrMethodToSql(
-      ctx,
-      table,
-      column,
-      values,
-      quotedAs
-    )} #- '{${path.join(", ")}}'`;
-  }
-  return "";
-};
 const pushSelectSql = (ctx, table, query, quotedAs) => {
   ctx.sql.push(selectToSql(ctx, table, query, quotedAs));
 };
@@ -4068,7 +4079,7 @@ const selectToSql = (ctx, table, query, quotedAs) => {
           }
         }
       } else {
-        list.push(selectedObjectToSQL(ctx, table, quotedAs, item));
+        list.push(selectedObjectToSQL(ctx, quotedAs, item));
       }
     }
     return list.join(", ");
@@ -4076,10 +4087,7 @@ const selectToSql = (ctx, table, query, quotedAs) => {
   return selectAllSql(table, query, quotedAs);
 };
 const selectedStringToSQL = (ctx, table, query, quotedAs, item) => item === "*" ? selectAllSql(table, query, quotedAs) : columnToSqlWithAs(ctx, table.q, item, quotedAs, true);
-function selectedObjectToSQL(ctx, table, quotedAs, item) {
-  if ("__json" in item) {
-    return `${jsonToSql(ctx, table, item, ctx.values, quotedAs)} "${item.__json[1]}"`;
-  }
+function selectedObjectToSQL(ctx, quotedAs, item) {
   const sql = item.toSQL(ctx, quotedAs);
   return ctx.aliasValue ? `${sql} r` : sql;
 }
@@ -4769,11 +4777,12 @@ const processData = (ctx, table, set, data, quotedAs) => {
 };
 const processValue = (ctx, table, QueryClass, key, value, quotedAs) => {
   if (value && typeof value === "object") {
-    if (value.__json) {
-      return jsonToSql(ctx, table, value, ctx.values, quotedAs);
-    } else if (isExpression(value)) {
+    if (isExpression(value)) {
       return value.toSQL(ctx, quotedAs);
     } else if (value instanceof QueryClass) {
+      if (value.q.subQuery === 1) {
+        return selectToSql(ctx, table, value.q, quotedAs);
+      }
       return `(${getSqlText(
         joinSubQuery(table, value).toSQL(ctx)
       )})`;
@@ -5199,11 +5208,11 @@ const makeRegexToFindInSql = (value) => {
   return new RegExp(`${value}(?=(?:[^']*'[^']*')*[^']*$)`, "g");
 };
 const resolveSubQueryCallback = (q, cb) => {
-  const { isSubQuery, relChain } = q.q;
-  q.q.isSubQuery = true;
+  const { subQuery, relChain } = q.q;
+  q.q.subQuery = 1;
   q.q.relChain = void 0;
   const result = cb(q);
-  q.q.isSubQuery = isSubQuery;
+  q.q.subQuery = subQuery;
   q.q.relChain = relChain;
   return result;
 };
@@ -6653,7 +6662,7 @@ class Create {
    * const createdCount = await db.table.insertMany([data, data, data]);
    * ```
    *
-   * Because of a limitation of Postgres protocol, queries having more than **65536** are going to fail in runtime.
+   * Because of a limitation of Postgres protocol, queries having more than **65535** of values are going to fail in runtime.
    * To solve this seamlessly, OrchidORM will automatically batch such queries, and wrap them into a transaction, unless they are already in a transaction.
    *
    * ```ts
@@ -6698,7 +6707,10 @@ class Create {
    * @param args - object with columns list and raw SQL for values
    */
   createRaw(...args) {
-    return _queryCreateRaw(this.clone(), args);
+    return _queryCreateRaw(
+      this.clone(),
+      args
+    );
   }
   /**
    * Works exactly as {@link createRaw}, except that it returns inserted row count by default.
@@ -6706,7 +6718,10 @@ class Create {
    * @param args - object with columns list and raw SQL for values
    */
   insertRaw(...args) {
-    return _queryInsertRaw(this.clone(), args);
+    return _queryInsertRaw(
+      this.clone(),
+      args
+    );
   }
   /**
    * `createManyRaw` and `insertManyRaw` are for creating many record with raw SQL expressions.
@@ -6727,7 +6742,10 @@ class Create {
    * @param args - object with columns list and array of raw SQL for values
    */
   createManyRaw(...args) {
-    return _queryCreateManyRaw(this.clone(), args);
+    return _queryCreateManyRaw(
+      this.clone(),
+      args
+    );
   }
   /**
    * Works exactly as {@link createManyRaw}, except that it returns inserted row count by default.
@@ -6735,7 +6753,10 @@ class Create {
    * @param args - object with columns list and array of raw SQL for values
    */
   insertManyRaw(...args) {
-    return _queryInsertManyRaw(this.clone(), args);
+    return _queryInsertManyRaw(
+      this.clone(),
+      args
+    );
   }
   /**
    * These methods are for creating a single record, for batch creating see {@link createManyFrom}.
@@ -6777,7 +6798,11 @@ class Create {
    * @param data - additionally you can set some columns
    */
   createFrom(query, data) {
-    return _queryCreateFrom(this.clone(), query, data);
+    return _queryCreateFrom(
+      this.clone(),
+      query,
+      data
+    );
   }
   /**
    * Works exactly as {@link createFrom}, except that it returns inserted row count by default.
@@ -6786,7 +6811,11 @@ class Create {
    * @param data - additionally you can set some columns
    */
   insertFrom(query, data) {
-    return _queryInsertFrom(this.clone(), query, data);
+    return _queryInsertFrom(
+      this.clone(),
+      query,
+      data
+    );
   }
   /**
    * Similar to `createFrom`, but intended to create many records.
@@ -6802,7 +6831,10 @@ class Create {
    * @param query - query to create new records from
    */
   createManyFrom(query) {
-    return _queryCreateManyFrom(this.clone(), query);
+    return _queryCreateManyFrom(
+      this.clone(),
+      query
+    );
   }
   /**
    * Works exactly as {@link createManyFrom}, except that it returns inserted row count by default.
@@ -6810,7 +6842,10 @@ class Create {
    * @param query - query to create new records from
    */
   insertManyFrom(query) {
-    return _queryInsertManyFrom(this.clone(), query);
+    return _queryInsertManyFrom(
+      this.clone(),
+      query
+    );
   }
   /**
    * `defaults` allows setting values that will be used later in `create`.
@@ -6835,7 +6870,10 @@ class Create {
    * @param data - default values for `create` and `createMany` which will follow `defaults`
    */
   defaults(data) {
-    return _queryDefaults(this.clone(), data);
+    return _queryDefaults(
+      this.clone(),
+      data
+    );
   }
   /**
    * By default, violating unique constraint will cause the creative query to throw,
@@ -7297,9 +7335,7 @@ class Having {
     return pushQueryValue(
       q,
       "having",
-      args.map(
-        (arg) => arg(q).q.expr
-      )
+      args.map((arg) => arg(q).q.expr)
     );
   }
   /**
@@ -8275,183 +8311,6 @@ class OnMethods {
   }
 }
 
-class JsonModifiers {
-  /**
-   * Return a JSON value/object/array where a given value is set at the given path.
-   * The path is an array of keys to access the value.
-   *
-   * Can be used in `update` callback.
-   *
-   * ```ts
-   * const result = await db.table.jsonSet('data', ['name'], 'new value').take();
-   *
-   * expect(result.data).toEqual({ name: 'new value' });
-   * ```
-   *
-   * Optionally takes parameters of type `{ as?: string, createIfMissing?: boolean }`
-   *
-   * ```ts
-   * await db.table.jsonSet('data', ['name'], 'new value', {
-   *   as: 'alias', // select data as `alias`
-   *   createIfMissing: true, // ignored if missing by default
-   * });
-   * ```
-   *
-   * @param column - name of JSON column, or a result of a nested json method
-   * @param path - path to value inside the json
-   * @param value - value to set into the json
-   * @param options - `as` to alias the json value when selecting, `createIfMissing: true` will create a new JSON property if it didn't exist before
-   */
-  jsonSet(column, path, value, options) {
-    var _a;
-    const q = this.clone();
-    const json = {
-      __json: [
-        "set",
-        (_a = options == null ? void 0 : options.as) != null ? _a : typeof column === "string" ? column : column.__json[1],
-        typeof column === "string" ? q.q.shape[column] : column.__json[2],
-        column,
-        path,
-        value,
-        options
-      ]
-    };
-    return Object.assign(pushQueryValue(q, "select", json), json);
-  }
-  /**
-   * Return a JSON value/object/array where a given value is inserted at the given JSON path. Value can be a single value or JSON object. If a value exists at the given path, the value is not replaced.
-   *
-   * Can be used in `update` callback.
-   *
-   * ```ts
-   * // imagine user has data = { tags: ['two'] }
-   * const result = await db.table.jsonInsert('data', ['tags', 0], 'one').take();
-   *
-   * // 'one' is inserted to 0 position
-   * expect(result.data).toEqual({ tags: ['one', 'two'] });
-   * ```
-   *
-   * Optionally takes parameters of type `{ as?: string, insertAfter?: boolean }`
-   *
-   * ```ts
-   * // imagine user has data = { tags: ['one'] }
-   * const result = await db.table
-   *   .jsonInsert('data', ['tags', 0], 'two', {
-   *     as: 'alias', // select as an alias
-   *     insertAfter: true, // insert after the specified position
-   *   })
-   *   .take();
-   *
-   * // 'one' is inserted to 0 position
-   * expect(result.alias).toEqual({ tags: ['one', 'two'] });
-   * ```
-   * @param column - name of JSON column, or a result of a nested json method
-   * @param path - path to the array inside the json, last path element is index to insert into
-   * @param value - value to insert into the json array
-   * @param options - `as` to alias the json value when selecting, `insertAfter: true` to insert after the specified position
-   */
-  jsonInsert(column, path, value, options) {
-    var _a;
-    const q = this.clone();
-    const json = {
-      __json: [
-        "insert",
-        (_a = options == null ? void 0 : options.as) != null ? _a : typeof column === "string" ? column : column.__json[1],
-        typeof column === "string" ? q.q.shape[column] : column.__json[2],
-        column,
-        path,
-        value,
-        options
-      ]
-    };
-    return Object.assign(pushQueryValue(q, "select", json), json);
-  }
-  /**
-   * Return a JSON value/object/array where a given value is removed at the given JSON path.
-   *
-   * Can be used in `update` callback.
-   *
-   * ```ts
-   * // imagine a user has data = { tags: ['one', 'two'] }
-   * const result = await db.table
-   *   .jsonRemove(
-   *     'data',
-   *     ['tags', 0],
-   *     // optional parameters:
-   *     {
-   *       as: 'alias', // select as an alias
-   *     },
-   *   )
-   *   .take();
-   *
-   * expect(result.alias).toEqual({ tags: ['two'] });
-   * ```
-   *
-   * @param column - name of JSON column, or a result of a nested json method
-   * @param path - path to the array inside the json, last path element is index to remove this element
-   * @param options - `as` to alias the json value when selecting
-   */
-  jsonRemove(column, path, options) {
-    var _a;
-    const q = this.clone();
-    const json = {
-      __json: [
-        "remove",
-        (_a = options == null ? void 0 : options.as) != null ? _a : typeof column === "string" ? column : column.__json[1],
-        typeof column === "string" ? q.q.shape[column] : column.__json[2],
-        column,
-        path
-      ]
-    };
-    return Object.assign(pushQueryValue(q, "select", json), json);
-  }
-  /**
-   * Selects a value from JSON data using a JSON path.
-   *
-   * ```ts
-   * import { columnTypes } from 'orchid-orm';
-   *
-   * db.table.jsonPathQuery(
-   *   columnTypes.text(3, 100), // type of the value
-   *   'data', // name of the JSON column
-   *   '$.name', // JSON path
-   *   'name', // select value as name
-   *
-   *   // Optionally supports `vars` and `silent` options
-   *   // check Postgres docs for jsonb_path_query for details
-   *   {
-   *     vars: 'vars',
-   *     silent: true,
-   *   },
-   * );
-   * ```
-   *
-   * Nested JSON operations can be used in place of JSON column name:
-   *
-   * ```ts
-   * db.table.jsonPathQuery(
-   *   columnTypes.text(3, 100),
-   *   // Available: .jsonSet, .jsonInsert, .jsonRemove
-   *   db.table.jsonSet('data', ['key'], 'value'),
-   *   '$.name',
-   *   'name',
-   * );
-   * ```
-   *
-   * @param type - provide a column type to have a correct result type
-   * @param column - name of JSON column, or a result of a nested json method
-   * @param path - special JSON path string to reference a JSON value
-   * @param as - optional alias for the selected value
-   * @param options - supports `vars` and `silent`, check Postgres docs of `json_path_query` for these
-   */
-  jsonPathQuery(type, column, path, as, options) {
-    const q = this.clone();
-    const json = {
-      __json: ["pathQuery", as, type, column, path, options]
-    };
-    return Object.assign(pushQueryValue(q, "select", json), json);
-  }
-}
 class JsonMethods {
   /**
    * Wraps the query in a way to select a single JSON string.
@@ -8827,7 +8686,7 @@ const resolveCallbacksInArgs = (q, args) => {
       const qb = Object.create(q);
       qb.q = getClonedQueryData(q.q);
       qb.q.and = qb.q.or = qb.q.scopes = void 0;
-      qb.q.isSubQuery = true;
+      qb.q.subQuery = 1;
       args[i] = resolveSubQueryCallback(qb, arg);
     }
   }
@@ -10526,6 +10385,8 @@ class TransformMethods {
    *
    * `transform` method should be called in the last order, other methods can't be chained after calling it.
    *
+   * It is meant to transform the whole result of a query, for transforming individual records consider using {@link QueryMap.map}.
+   *
    * The [hooks](/guide/hooks.html) that are going to run after the query will receive the query result **before** transferring.
    *
    * Consider the following example of a cursor-based pagination by `id`:
@@ -10577,6 +10438,52 @@ class TransformMethods {
   }
 }
 
+class QueryMap {
+  /**
+   * Use `map` to transform individual records of a query result.
+   *
+   * It accepts a single record and should return a single transformed record.
+   *
+   * For transforming the whole result of a query, consider using [transform](#transform) instead.
+   *
+   * The [hooks](/guide/hooks) that are going to run after the query will receive the query result **before** transformation.
+   *
+   * ```ts
+   * // add a `titleLength` to every post
+   * const posts = await db.post.limit(10).map((post) => ({
+   *   ...post,
+   *   titleLength: post.title.length,
+   * }));
+   *
+   * posts[0].titleLength; // number
+   *
+   * // using the exact same `map` function to transform a single post
+   * const singlePost = await db.post.find(id).map((post) => ({
+   *   ...post,
+   *   titleLength: post.title.length,
+   * }));
+   *
+   * singlePost.titleLength; // number
+   *
+   * // can be used in sub-queries
+   * const postsWithComments = await db.post.select('title', {
+   *   comments: (q) =>
+   *     q.comments.map((comment) => ({
+   *       ...comment,
+   *       truncatedContent: comment.content.slice(0, 100),
+   *     })),
+   * });
+   *
+   * postsWithComments[0].comments[0].truncatedContent; // string
+   * ```
+   *
+   * @param fn - function to transform an individual record
+   */
+  map(fn) {
+    return pushQueryValue(this.clone(), "transform", { map: fn });
+  }
+}
+
 class ScopeMethods {
   /**
    * See {@link ScopeMethods}
@@ -11540,7 +11447,6 @@ applyMixins(QueryMethods, [
   OnMethods,
   WithMethods,
   Union,
-  JsonModifiers,
   JsonMethods,
   Create,
   Update,
@@ -11559,6 +11465,7 @@ applyMixins(QueryMethods, [
   MergeQueryMethods,
   SqlMethod,
   TransformMethods,
+  QueryMap,
   ScopeMethods,
   SoftDeleteMethods,
   ExpressionMethods
@@ -12135,5 +12042,5 @@ function copyTableData(query, arg) {
   return q;
 }
 
-export { Adapter, AggregateMethods, ArrayColumn, AsMethods, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, ByteaColumn, CharColumn, CidrColumn, CircleColumn, CitextColumn, Clear, ColumnRefExpression, ColumnType, Create, 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, JsonModifiers, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, OnConflictQueryBuilder, OnMethods, Operators, OrExpression, OrchidOrmError, OrchidOrmInternalError, PathColumn, PointColumn, PolygonColumn, QueryBase, QueryError, QueryGet, QueryHooks, QueryLog, QueryMethods, QueryUpsertOrCreate, RawSQL, RealColumn, RefExpression, SearchMethods, Select, SerialColumn, SmallIntColumn, SmallSerialColumn, SqlMethod, StringColumn, TextBaseColumn, TextColumn, Then, TimeColumn, TimestampColumn, TimestampTZColumn, Transaction, TransactionAdapter, TransformMethods, TsQueryColumn, TsVectorColumn, UUIDColumn, UnhandledTypeError, Union, UnknownColumn, Update, VarCharColumn, VirtualColumn, Where, WithMethods, XMLColumn, _initQueryBuilder, _queryAfterSaveCommit, _queryAll, _queryAs, _queryChangeCounter, _queryCreate, _queryCreateFrom, _queryCreateMany, _queryCreateManyFrom, _queryCreateManyRaw, _queryCreateRaw, _queryDefaults, _queryDelete, _queryExec, _queryFindBy, _queryFindByOptional, _queryGet, _queryGetOptional, _queryHookAfterCreate, _queryHookAfterCreateCommit, _queryHookAfterDelete, _queryHookAfterDeleteCommit, _queryHookAfterQuery, _queryHookAfterSave, _queryHookAfterUpdate, _queryHookAfterUpdateCommit, _queryHookBeforeCreate, _queryHookBeforeDelete, _queryHookBeforeQuery, _queryHookBeforeSave, _queryHookBeforeUpdate, _queryInsert, _queryInsertFrom, _queryInsertMany, _queryInsertManyFrom, _queryInsertManyRaw, _queryInsertRaw, _queryJoinOn, _queryJoinOnJsonPathEquals, _queryJoinOrOn, _queryOr, _queryOrNot, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUnion, _queryUpdate, _queryUpdateOrThrow, _queryUpdateRaw, _queryWhere, _queryWhereExists, _queryWhereIn, _queryWhereNot, _queryWhereNotSql, _queryWhereSql, addComputedColumns, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, checkIfASimpleQuery, cloneQuery, cloneQueryBaseUnscoped, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, commitSql$1 as commitSql, constraintInnerToCode, constraintToCode, copyTableData, countSelect, createDb, defaultSchemaConfig, extendQuery, foreignKeyArgumentToCode, getClonedQueryData, getColumnInfo, getColumnTypes, getPrimaryKeys, getQueryAs, getShapeFromSelect, getSqlText, handleResult, identityToCode, indexInnerToCode, indexToCode, instantiateColumn, isDefaultTimeStamp, isQueryReturnsAll, isSelectingCount, joinSubQuery, logColors, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeFnExpression, makeRegexToFindInSql, makeSQL, parseRecord, parseResult, parseTableData, parseTableDataInput, primaryKeyInnerToCode, processSelectArg, pushLimitSQL, pushQueryArray, pushQueryOn, pushQueryOrOn, pushQueryValue, pushTableDataCode, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, quote, quoteString, raw, referencesArgsToCode, resolveSubQueryCallback, rollbackSql$1 as rollbackSql, saveSearchAlias, setParserForSelectedString, setQueryObjectValue, setQueryOperators, simplifyColumnDefault, sqlFn, sqlQueryArgsToExpression, tableDataMethods, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };
+export { Adapter, AggregateMethods, ArrayColumn, AsMethods, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, ByteaColumn, CharColumn, CidrColumn, CircleColumn, CitextColumn, Clear, ColumnRefExpression, ColumnType, Create, 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, MoreThanOneRowError, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, OnConflictQueryBuilder, OnMethods, Operators, OrExpression, OrchidOrmError, OrchidOrmInternalError, PathColumn, PointColumn, PolygonColumn, QueryBase, QueryError, QueryGet, QueryHooks, QueryLog, QueryMethods, QueryUpsertOrCreate, RawSQL, RealColumn, RefExpression, SearchMethods, Select, SerialColumn, SmallIntColumn, SmallSerialColumn, SqlMethod, StringColumn, TextBaseColumn, TextColumn, Then, TimeColumn, TimestampColumn, TimestampTZColumn, Transaction, TransactionAdapter, TransformMethods, TsQueryColumn, TsVectorColumn, UUIDColumn, UnhandledTypeError, Union, UnknownColumn, Update, VarCharColumn, VirtualColumn, Where, WithMethods, XMLColumn, _initQueryBuilder, _queryAfterSaveCommit, _queryAll, _queryAs, _queryChangeCounter, _queryCreate, _queryCreateFrom, _queryCreateMany, _queryCreateManyFrom, _queryCreateManyRaw, _queryCreateRaw, _queryDefaults, _queryDelete, _queryExec, _queryFindBy, _queryFindByOptional, _queryGet, _queryGetOptional, _queryHookAfterCreate, _queryHookAfterCreateCommit, _queryHookAfterDelete, _queryHookAfterDeleteCommit, _queryHookAfterQuery, _queryHookAfterSave, _queryHookAfterUpdate, _queryHookAfterUpdateCommit, _queryHookBeforeCreate, _queryHookBeforeDelete, _queryHookBeforeQuery, _queryHookBeforeSave, _queryHookBeforeUpdate, _queryInsert, _queryInsertFrom, _queryInsertMany, _queryInsertManyFrom, _queryInsertManyRaw, _queryInsertRaw, _queryJoinOn, _queryJoinOnJsonPathEquals, _queryJoinOrOn, _queryOr, _queryOrNot, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUnion, _queryUpdate, _queryUpdateOrThrow, _queryUpdateRaw, _queryWhere, _queryWhereExists, _queryWhereIn, _queryWhereNot, _queryWhereNotSql, _queryWhereSql, addComputedColumns, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, checkIfASimpleQuery, cloneQuery, cloneQueryBaseUnscoped, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, commitSql$1 as commitSql, constraintInnerToCode, constraintToCode, copyTableData, countSelect, createDb, defaultSchemaConfig, extendQuery, foreignKeyArgumentToCode, getClonedQueryData, getColumnInfo, getColumnTypes, getPrimaryKeys, getQueryAs, getShapeFromSelect, getSqlText, handleResult, identityToCode, indexInnerToCode, indexToCode, instantiateColumn, isDefaultTimeStamp, isQueryReturnsAll, isSelectingCount, joinSubQuery, logColors, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeFnExpression, makeRegexToFindInSql, makeSQL, parseRecord, parseResult, parseTableData, parseTableDataInput, primaryKeyInnerToCode, processSelectArg, pushLimitSQL, pushQueryArray, pushQueryOn, pushQueryOrOn, pushQueryValue, pushTableDataCode, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, quote, quoteString, raw, referencesArgsToCode, resolveSubQueryCallback, rollbackSql$1 as rollbackSql, saveSearchAlias, setParserForSelectedString, setQueryObjectValue, setQueryOperators, simplifyColumnDefault, sqlFn, sqlQueryArgsToExpression, tableDataMethods, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };
 //# sourceMappingURL=index.mjs.map