pqb 0.40.1 → 0.40.3

package/dist/index.d.ts

@@ -4990,7 +4990,7 @@ type AfterCommitErrorResult = AfterCommitErrorFulfilledResult | AfterCommitError
  * }
  * ```
  *
- * Use `functoin name() {}` function syntax for hooks to give them names,
+ * Use `function name() {}` function syntax for hooks to give them names,
  * so later they can be identified when handling after commit errors.
  *
  * ```ts
@@ -5395,6 +5395,8 @@ declare class Select {
 
 declare class SqlMethod<ColumnTypes> {
     /**
+     * @deprecated: use `sql` exported from the `createBaseTable` (see "define a base table" in the docs)
+     *
      * When there is a need to use a piece of raw SQL, use the `sql` exported from the `BaseTable` file, it is also attached to query objects for convenience.
      *
      * When selecting a custom SQL, specify a resulting type with `<generic>` syntax:
@@ -5530,7 +5532,6 @@ declare class SqlMethod<ColumnTypes> {
      * sql`($one + $two) / $one`.type((t) => t.numeric()).values({ one: 1, two: 2 });
      * ```
      *
-     * @deprecated use `sql` exported from the `createBaseTable` (see "define a base table" in the docs)
      * @param args - template literal or an object { raw: string }
      * @return object that has `type` and `values` methods
      */
@@ -6566,7 +6567,7 @@ declare class QueryUpsertOrCreate {
      *
      * ```ts
      * await User.selectAll()
-     *   .find({ email: 'some@email.com' })
+     *   .findBy({ email: 'some@email.com' })
      *   .upsert({
      *     data: {
      *       // update record's name
@@ -6580,7 +6581,7 @@ declare class QueryUpsertOrCreate {
      *
      * // the same as above but using `update` and `create`
      * await User.selectAll()
-     *   .find({ email: 'some@email.com' })
+     *   .findBy({ email: 'some@email.com' })
      *   .upsert({
      *     update: {
      *       name: 'updated user',
@@ -6597,7 +6598,7 @@ declare class QueryUpsertOrCreate {
      *
      * ```ts
      * await User.selectAll()
-     *   .find({ email: 'some@email.com' })
+     *   .findBy({ email: 'some@email.com' })
      *   .upsert({
      *     update: {
      *       name: 'updated user',
@@ -6610,7 +6611,7 @@ declare class QueryUpsertOrCreate {
      *
      * // the same as above using `data`
      * await User.selectAll()
-     *   .find({ email: 'some@email.com' })
+     *   .findBy({ email: 'some@email.com' })
      *   .upsert({
      *     data: {
      *       name: 'updated user',
@@ -6627,7 +6628,7 @@ declare class QueryUpsertOrCreate {
      *
      * ```ts
      * const user = await User.selectAll()
-     *   .find({ email: 'some@email.com' })
+     *   .findBy({ email: 'some@email.com' })
      *   .upsert({
      *     data: {
      *       name: 'updated user',
@@ -6660,17 +6661,19 @@ declare class QueryUpsertOrCreate {
      * By default, it is not returning columns, place `get`, `select`, or `selectAll` before `orCreate` to specify returning columns.
      *
      * ```ts
-     * const user = await User.selectAll().find({ email: 'some@email.com' }).orCreate({
-     *   email: 'some@email.com',
-     *   name: 'created user',
-     * });
+     * const user = await User.selectAll()
+     *   .findBy({ email: 'some@email.com' })
+     *   .orCreate({
+     *     email: 'some@email.com',
+     *     name: 'created user',
+     *   });
      * ```
      *
      * The data may be returned from a function, it won't be called if the record was found:
      *
      * ```ts
      * const user = await User.selectAll()
-     *   .find({ email: 'some@email.com' })
+     *   .findBy({ email: 'some@email.com' })
      *   .orCreate(() => ({
      *     email: 'some@email.com',
      *     name: 'created user',
@@ -6747,11 +6750,11 @@ declare class QueryMap {
     /**
      * Use `map` to transform individual records of a query result.
      *
-     * It accepts a single record and should return a single transformed record.
+     * Use `map` to transform individual records of a query result. If the query returns multiple, `map` function going to transform records one by one.
      *
-     * For transforming the whole result of a query, consider using [transform](#transform) instead.
+     * For an optional query result (`findOptional`, `getOptional`, etc.), `map` is **not** called for empty results.
      *
-     * The [hooks](/guide/hooks) that are going to run after the query will receive the query result **before** transformation.
+     * For transforming the result of a query as a whole, consider using {@link Query.transform} instead.
      *
      * ```ts
      * // add a `titleLength` to every post
@@ -6784,10 +6787,18 @@ declare class QueryMap {
      *
      * @param fn - function to transform an individual record
      */
-    map<T extends Query, Result extends RecordUnknown>(this: T, fn: (input: T['returnType'] extends undefined | 'all' ? T['then'] extends QueryThen<(infer Data)[]> ? Data : never : T['then'] extends QueryThen<infer Data> ? Data : never) => Result): {
+    map<T extends Query, Result>(this: T, fn: (input: T['returnType'] extends undefined | 'all' | 'pluck' ? T['then'] extends QueryThen<(infer Data)[]> ? Data : never : T['then'] extends QueryThen<infer Data | undefined> ? Data : never) => Result): Result extends RecordUnknown ? {
         [K in keyof T]: K extends 'result' ? {
             [K in keyof Result]: QueryColumn<Result[K]>;
         } : K extends 'then' ? QueryThen<T['returnType'] extends undefined | 'all' ? Result[] : Result> : T[K];
+    } : {
+        [K in keyof T]: K extends 'returnType' ? T['returnType'] extends undefined | 'all' | 'pluck' ? 'pluck' : T['returnType'] extends 'one' ? 'value' : 'valueOrThrow' : K extends 'result' ? T['returnType'] extends undefined | 'all' | 'pluck' ? {
+            pluck: QueryColumn<Result>;
+        } : T['returnType'] extends 'one' | 'value' ? {
+            value: QueryColumn<Result | undefined>;
+        } : {
+            value: QueryColumn<Result>;
+        } : K extends 'then' ? QueryThen<T['returnType'] extends undefined | 'all' | 'pluck' ? Result[] : Result> : T[K];
     };
 }
 
@@ -8149,8 +8160,9 @@ interface ColumnsByType {
 declare const makeColumnsByType: (schema: ColumnSchemaConfig) => ColumnsByType;
 
 type Value = any;
-declare const quote: (value: Value) => string;
-declare const quoteString: (value: string) => string;
+declare const escapeForLog: (value: Value) => string;
+declare const escapeForMigration: (value: Value) => string;
+declare const escapeString: (value: string) => string;
 
 /**
  * Push all elements of given array into the array in the query data,
@@ -8322,4 +8334,4 @@ type CopyResult<T extends PickQueryMeta> = SetQueryKind<T, 'copy'>;
  */
 declare function copyTableData<T extends PickQueryMetaShape>(query: T, arg: CopyArg<T>): CopyResult<T>;
 
-export { Adapter, AdapterConfig, AdapterOptions, AddQueryDefaults, AfterCommitError, AfterCommitErrorFulfilledResult, AfterCommitErrorRejectedResult, AfterCommitErrorResult, AfterHook, AggregateArgTypes, AggregateMethods, AggregateOptions, AliasOrTable, ArrayColumn, ArrayColumnValue, ArrayData, AsMethods, AsQueryArg, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BooleanQueryColumn, BoxColumn, ByteaColumn, ChangeCountArg, CidrColumn, CircleColumn, CitextColumn, Clear, ClearStatement, ColumnData, ColumnFromDbParams, ColumnInfoQueryData, ColumnRefExpression, ColumnType, ColumnsByType, ColumnsShape, ColumnsShapeToNullableObject, ColumnsShapeToObject, ColumnsShapeToObjectArray, ColumnsShapeToPluck, CommonQueryData, ComputedColumn, ComputedColumns, ComputedColumnsFromOptions, ComputedMethods, ComputedOptionsFactory, CopyOptions, CopyQueryData, Create, CreateBelongsToData, CreateColumn, CreateCtx, CreateData, CreateKind, CreateMethodsNames, CreateRelationsData, CreateRelationsDataOmittingFKeys, CreateResult, CreateSelf, CustomTypeColumn, DateBaseColumn, DateColumn, DateColumnInput, DateTimeBaseClass, DateTimeTzBaseClass, Db, DbDomainArg, DbDomainArgRecord, DbExtension, DbOptions, DbResult, DbSharedOptions, DbTableConstructor, DbTableOptionScopes, DbTableOptions, DecimalColumn, DecimalColumnData, DefaultColumnTypes, DefaultSchemaConfig, Delete, DeleteArgs, DeleteMethodsNames, DeleteQueryData, DeleteResult, DomainColumn, DoublePrecisionColumn, DynamicRawSQL, EnumColumn, ExpressionMethods, ExpressionOutput, FnExpression, FnExpressionArgs, FnExpressionArgsPairs, FnExpressionArgsValue, For, FromArg, FromMethods, FromQuerySelf, FromResult, GetArg, GetColumnInfo, GetQueryResult, GetResult, GetResultOptional, GetStringArg, GroupArgs, HandleResult, Having, HavingItem, HookAction, HookSelectArg, IdentityColumn, InetColumn, InsertQueryData, IntegerBaseColumn, IntegerColumn, IntervalColumn, IsolationLevel, JSONColumn, JSONTextColumn, Join, JoinArgToQuery, JoinArgs, JoinCallback, JoinFirstArg, JoinItem, JoinItemArgs, JoinLateralItem, JoinLateralResult, JoinOverrides, JoinQueryBuilder, JoinQueryMethod, JoinResult, JoinedParsers, JoinedShapes, JsonMethods, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MapTableScopesOption, MergeQuery, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NoPrimaryKeyOption, NonUniqDataItem, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, NumberColumnData, NumericColumns, OnConflictMerge, OnConflictQueryBuilder, OnConflictSet, OnConflictTarget, OnMethods, Operator, Operators, OperatorsAny, OperatorsArray, OperatorsBoolean, OperatorsDate, OperatorsJson, OperatorsNumber, OperatorsText, OperatorsTime, OrCreateArg, OrExpression, OrchidOrmError, OrchidOrmInternalError, OrderArg, OrderArgSelf, OrderArgs, OrderItem, OrderTsQueryConfig, Over, PathColumn, PickColumnData, PickQueryBaseQuery, PickQueryColumnTypes, PickQueryDataShapeAndJoinedShapes, PickQueryInternal, PickQueryMetaRelations, PickQueryMetaResultRelations, PickQueryMetaResultRelationsWindows, PickQueryMetaResultRelationsWindowsColumnTypes, PickQueryMetaResultRelationsWithDataReturnType, PickQueryMetaResultRelationsWithDataReturnTypeShape, PickQueryMetaResultReturnTypeWithDataWindows, PickQueryMetaResultReturnTypeWithDataWindowsTable, PickQueryMetaShapeRelationsWithData, PickQueryMetaTable, PickQueryMetaTableShape, PickQueryMetaTableShapeReturnTypeWithData, PickQueryMetaWithData, PickQueryMetaWithDataColumnTypes, PickQueryQ, PickQueryQAndBaseQuery, PickQueryQAndInternal, PickQueryRelations, PickQueryRelationsWithData, PickQueryResultColumnTypes, PickQueryShapeResultSinglePrimaryKey, PickQueryShapeSinglePrimaryKey, PickQuerySinglePrimaryKey, PickQueryWindows, PickQueryWithData, PickQueryWithDataColumnTypes, PointColumn, PolygonColumn, Query, QueryAfterHook, QueryArraysResult, QueryBase, QueryBaseThen, QueryBatchResult, QueryBeforeHook, QueryComputedArg, QueryData, QueryDataFromItem, QueryDataJoinTo, QueryDefaultReturnData, QueryError, QueryErrorName, QueryGet, QueryGetSelf, QueryHelperResult, QueryHooks, QueryInternal, QueryLog, QueryMetaHasSelect, QueryMetaHasWhere, QueryMethods, QueryOrExpression, QueryOrExpressionBooleanOrNullResult, QueryResult, QueryScopeData, QueryScopes, QuerySourceItem, QueryUpsertOrCreate, QueryWithTable, RawSQL, RealColumn, RecordOfColumnsShapeBase, RefExpression, RelationConfigBase, RelationConfigDataForCreate, RelationJoinQuery, RelationQuery, RelationQueryBase, RelationsBase, RuntimeComputedQueryColumn, SearchArg, SearchMethods, SearchWeight, SearchWeightRecord, Select, SelectArg, SelectArgs, SelectAs, SelectAsValue, SelectItem, SelectQueryData, SelectSubQueryResult, SelectableFromShape, SelectableOfType, SelectableOrExpression, SelectableOrExpressionOfType, SelectableOrExpressions, SerialColumn, SerialColumnData, SetQueryKind, SetQueryKindResult, SetQueryReturnsAll, SetQueryReturnsAllKind, SetQueryReturnsAllKindResult, SetQueryReturnsColumnInfo, SetQueryReturnsColumnKind, SetQueryReturnsColumnKindResult, SetQueryReturnsColumnOptional, SetQueryReturnsColumnOrThrow, SetQueryReturnsOne, SetQueryReturnsOneKind, SetQueryReturnsOneKindResult, SetQueryReturnsOneOptional, SetQueryReturnsPluck, SetQueryReturnsPluckColumn, SetQueryReturnsPluckColumnKind, SetQueryReturnsPluckColumnKindResult, SetQueryReturnsRowCount, SetQueryReturnsRows, SetQueryReturnsValueOptional, SetQueryReturnsValueOrThrow, SetQueryReturnsVoid, SetQueryReturnsVoidKind, SetQueryTableAlias, ShapeColumnPrimaryKeys, ShapeUniqueColumns, SimpleJoinItem, SimpleJoinItemNonSubQueryArgs, SmallIntColumn, SmallSerialColumn, SortDir, SqlFn, SqlMethod, StringColumn$1 as StringColumn, TableData, TableDataFn, TableDataInput, TableDataItem, TableDataItemsUniqueColumnTuples, TableDataItemsUniqueColumns, TableDataItemsUniqueConstraints, TableDataMethods, TextBaseColumn, TextColumn, TextColumnData, Then, TimeColumn, TimestampColumn, TimestampTZColumn, ToSQLCtx, ToSQLOptions, ToSQLQuery, Transaction, TransactionAdapter, TransactionOptions, TransformMethods, TruncateQueryData, TsQueryColumn, TsVectorColumn, TypeParsers, UUIDColumn, UnhandledTypeError, Union, UnionArgs, UnionItem, UnionKind, UnionSet, UniqueConstraints, UniqueQueryTypeOrExpression, UniqueTableDataItem, UnknownColumn, Update, UpdateArg, UpdateCtx, UpdateCtxCollect, UpdateData, UpdateQueryData, UpdateQueryDataItem, UpdateQueryDataObject, UpdateSelf, UpdatedAtDataInjector, UpsertResult, UpsertThis, VarCharColumn, VirtualColumn, Where, WhereArg, WhereArgs, WhereInArg, WhereInColumn, WhereInItem, WhereInValues, WhereItem, WhereJsonPathEqualsItem, WhereNotArgs, WhereOnItem, WhereOnJoinItem, WhereQueryBuilder, WhereResult, WhereSearchItem, WhereSearchResult, WindowArg, WindowArgDeclaration, WindowDeclaration, WindowItem, WithArgsOptions, WithConfigs, WithDataItem, WithDataItems, WithItem, WithMethods, WithOptions, WithQueryBuilder, WithRecursiveOptions, WithResult, WithSqlResult, WrapQueryArg, XMLColumn, _afterCommitError, _getSelectableColumn, _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, _queryWhereNotOneOf, _queryWhereNotSql, _queryWhereOneOf, _queryWhereSql, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, applyComputedColumns, checkIfASimpleQuery, cloneQuery, cloneQueryBaseUnscoped, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, commitSql, constraintInnerToCode, constraintToCode, copyTableData, countSelect, createDb, defaultSchemaConfig, extendQuery, filterResult, foreignKeyArgumentToCode, getClonedQueryData, getColumnInfo, getColumnTypes, getPrimaryKeys, getQueryAs, getShapeFromSelect, getSqlText, handleResult, identityToCode, indexInnerToCode, indexToCode, instantiateColumn, isDefaultTimeStamp, isQueryReturnsAll, isSelectingCount, joinSubQuery, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeFnExpression, makeRegexToFindInSql, makeSQL, parseRecord, parseTableData, parseTableDataInput, primaryKeyInnerToCode, processComputedBatches, processComputedResult, processSelectArg, pushLimitSQL, pushQueryArray, pushQueryOn, pushQueryOnForOuter, pushQueryOrOn, pushQueryValue, pushTableDataCode, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, quote, quoteString, raw, referencesArgsToCode, resolveSubQueryCallback, rollbackSql, saveSearchAlias, setParserForSelectedString, setQueryObjectValue, setQueryOperators, simplifyColumnDefault, sqlFn, sqlQueryArgsToExpression, tableDataMethods, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };
+export { Adapter, AdapterConfig, AdapterOptions, AddQueryDefaults, AfterCommitError, AfterCommitErrorFulfilledResult, AfterCommitErrorRejectedResult, AfterCommitErrorResult, AfterHook, AggregateArgTypes, AggregateMethods, AggregateOptions, AliasOrTable, ArrayColumn, ArrayColumnValue, ArrayData, AsMethods, AsQueryArg, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BooleanQueryColumn, BoxColumn, ByteaColumn, ChangeCountArg, CidrColumn, CircleColumn, CitextColumn, Clear, ClearStatement, ColumnData, ColumnFromDbParams, ColumnInfoQueryData, ColumnRefExpression, ColumnType, ColumnsByType, ColumnsShape, ColumnsShapeToNullableObject, ColumnsShapeToObject, ColumnsShapeToObjectArray, ColumnsShapeToPluck, CommonQueryData, ComputedColumn, ComputedColumns, ComputedColumnsFromOptions, ComputedMethods, ComputedOptionsFactory, CopyOptions, CopyQueryData, Create, CreateBelongsToData, CreateColumn, CreateCtx, CreateData, CreateKind, CreateMethodsNames, CreateRelationsData, CreateRelationsDataOmittingFKeys, CreateResult, CreateSelf, CustomTypeColumn, DateBaseColumn, DateColumn, DateColumnInput, DateTimeBaseClass, DateTimeTzBaseClass, Db, DbDomainArg, DbDomainArgRecord, DbExtension, DbOptions, DbResult, DbSharedOptions, DbTableConstructor, DbTableOptionScopes, DbTableOptions, DecimalColumn, DecimalColumnData, DefaultColumnTypes, DefaultSchemaConfig, Delete, DeleteArgs, DeleteMethodsNames, DeleteQueryData, DeleteResult, DomainColumn, DoublePrecisionColumn, DynamicRawSQL, EnumColumn, ExpressionMethods, ExpressionOutput, FnExpression, FnExpressionArgs, FnExpressionArgsPairs, FnExpressionArgsValue, For, FromArg, FromMethods, FromQuerySelf, FromResult, GetArg, GetColumnInfo, GetQueryResult, GetResult, GetResultOptional, GetStringArg, GroupArgs, HandleResult, Having, HavingItem, HookAction, HookSelectArg, IdentityColumn, InetColumn, InsertQueryData, IntegerBaseColumn, IntegerColumn, IntervalColumn, IsolationLevel, JSONColumn, JSONTextColumn, Join, JoinArgToQuery, JoinArgs, JoinCallback, JoinFirstArg, JoinItem, JoinItemArgs, JoinLateralItem, JoinLateralResult, JoinOverrides, JoinQueryBuilder, JoinQueryMethod, JoinResult, JoinedParsers, JoinedShapes, JsonMethods, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MapTableScopesOption, MergeQuery, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NoPrimaryKeyOption, NonUniqDataItem, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, NumberColumnData, NumericColumns, OnConflictMerge, OnConflictQueryBuilder, OnConflictSet, OnConflictTarget, OnMethods, Operator, Operators, OperatorsAny, OperatorsArray, OperatorsBoolean, OperatorsDate, OperatorsJson, OperatorsNumber, OperatorsText, OperatorsTime, OrCreateArg, OrExpression, OrchidOrmError, OrchidOrmInternalError, OrderArg, OrderArgSelf, OrderArgs, OrderItem, OrderTsQueryConfig, Over, PathColumn, PickColumnData, PickQueryBaseQuery, PickQueryColumnTypes, PickQueryDataShapeAndJoinedShapes, PickQueryInternal, PickQueryMetaRelations, PickQueryMetaResultRelations, PickQueryMetaResultRelationsWindows, PickQueryMetaResultRelationsWindowsColumnTypes, PickQueryMetaResultRelationsWithDataReturnType, PickQueryMetaResultRelationsWithDataReturnTypeShape, PickQueryMetaResultReturnTypeWithDataWindows, PickQueryMetaResultReturnTypeWithDataWindowsTable, PickQueryMetaShapeRelationsWithData, PickQueryMetaTable, PickQueryMetaTableShape, PickQueryMetaTableShapeReturnTypeWithData, PickQueryMetaWithData, PickQueryMetaWithDataColumnTypes, PickQueryQ, PickQueryQAndBaseQuery, PickQueryQAndInternal, PickQueryRelations, PickQueryRelationsWithData, PickQueryResultColumnTypes, PickQueryShapeResultSinglePrimaryKey, PickQueryShapeSinglePrimaryKey, PickQuerySinglePrimaryKey, PickQueryWindows, PickQueryWithData, PickQueryWithDataColumnTypes, PointColumn, PolygonColumn, Query, QueryAfterHook, QueryArraysResult, QueryBase, QueryBaseThen, QueryBatchResult, QueryBeforeHook, QueryComputedArg, QueryData, QueryDataFromItem, QueryDataJoinTo, QueryDefaultReturnData, QueryError, QueryErrorName, QueryGet, QueryGetSelf, QueryHelperResult, QueryHooks, QueryInternal, QueryLog, QueryMetaHasSelect, QueryMetaHasWhere, QueryMethods, QueryOrExpression, QueryOrExpressionBooleanOrNullResult, QueryResult, QueryScopeData, QueryScopes, QuerySourceItem, QueryUpsertOrCreate, QueryWithTable, RawSQL, RealColumn, RecordOfColumnsShapeBase, RefExpression, RelationConfigBase, RelationConfigDataForCreate, RelationJoinQuery, RelationQuery, RelationQueryBase, RelationsBase, RuntimeComputedQueryColumn, SearchArg, SearchMethods, SearchWeight, SearchWeightRecord, Select, SelectArg, SelectArgs, SelectAs, SelectAsValue, SelectItem, SelectQueryData, SelectSubQueryResult, SelectableFromShape, SelectableOfType, SelectableOrExpression, SelectableOrExpressionOfType, SelectableOrExpressions, SerialColumn, SerialColumnData, SetQueryKind, SetQueryKindResult, SetQueryReturnsAll, SetQueryReturnsAllKind, SetQueryReturnsAllKindResult, SetQueryReturnsColumnInfo, SetQueryReturnsColumnKind, SetQueryReturnsColumnKindResult, SetQueryReturnsColumnOptional, SetQueryReturnsColumnOrThrow, SetQueryReturnsOne, SetQueryReturnsOneKind, SetQueryReturnsOneKindResult, SetQueryReturnsOneOptional, SetQueryReturnsPluck, SetQueryReturnsPluckColumn, SetQueryReturnsPluckColumnKind, SetQueryReturnsPluckColumnKindResult, SetQueryReturnsRowCount, SetQueryReturnsRows, SetQueryReturnsValueOptional, SetQueryReturnsValueOrThrow, SetQueryReturnsVoid, SetQueryReturnsVoidKind, SetQueryTableAlias, ShapeColumnPrimaryKeys, ShapeUniqueColumns, SimpleJoinItem, SimpleJoinItemNonSubQueryArgs, SmallIntColumn, SmallSerialColumn, SortDir, SqlFn, SqlMethod, StringColumn$1 as StringColumn, TableData, TableDataFn, TableDataInput, TableDataItem, TableDataItemsUniqueColumnTuples, TableDataItemsUniqueColumns, TableDataItemsUniqueConstraints, TableDataMethods, TextBaseColumn, TextColumn, TextColumnData, Then, TimeColumn, TimestampColumn, TimestampTZColumn, ToSQLCtx, ToSQLOptions, ToSQLQuery, Transaction, TransactionAdapter, TransactionOptions, TransformMethods, TruncateQueryData, TsQueryColumn, TsVectorColumn, TypeParsers, UUIDColumn, UnhandledTypeError, Union, UnionArgs, UnionItem, UnionKind, UnionSet, UniqueConstraints, UniqueQueryTypeOrExpression, UniqueTableDataItem, UnknownColumn, Update, UpdateArg, UpdateCtx, UpdateCtxCollect, UpdateData, UpdateQueryData, UpdateQueryDataItem, UpdateQueryDataObject, UpdateSelf, UpdatedAtDataInjector, UpsertResult, UpsertThis, VarCharColumn, VirtualColumn, Where, WhereArg, WhereArgs, WhereInArg, WhereInColumn, WhereInItem, WhereInValues, WhereItem, WhereJsonPathEqualsItem, WhereNotArgs, WhereOnItem, WhereOnJoinItem, WhereQueryBuilder, WhereResult, WhereSearchItem, WhereSearchResult, WindowArg, WindowArgDeclaration, WindowDeclaration, WindowItem, WithArgsOptions, WithConfigs, WithDataItem, WithDataItems, WithItem, WithMethods, WithOptions, WithQueryBuilder, WithRecursiveOptions, WithResult, WithSqlResult, WrapQueryArg, XMLColumn, _afterCommitError, _getSelectableColumn, _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, _queryWhereNotOneOf, _queryWhereNotSql, _queryWhereOneOf, _queryWhereSql, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, applyComputedColumns, checkIfASimpleQuery, cloneQuery, cloneQueryBaseUnscoped, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, commitSql, constraintInnerToCode, constraintToCode, copyTableData, countSelect, createDb, defaultSchemaConfig, escapeForLog, escapeForMigration, escapeString, extendQuery, filterResult, foreignKeyArgumentToCode, getClonedQueryData, getColumnInfo, getColumnTypes, getPrimaryKeys, getQueryAs, getShapeFromSelect, getSqlText, handleResult, identityToCode, indexInnerToCode, indexToCode, instantiateColumn, isDefaultTimeStamp, isQueryReturnsAll, isSelectingCount, joinSubQuery, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeFnExpression, makeRegexToFindInSql, makeSQL, parseRecord, parseTableData, parseTableDataInput, primaryKeyInnerToCode, processComputedBatches, processComputedResult, processSelectArg, pushLimitSQL, pushQueryArray, pushQueryOn, pushQueryOnForOuter, pushQueryOrOn, pushQueryValue, pushTableDataCode, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, raw, referencesArgsToCode, resolveSubQueryCallback, rollbackSql, saveSearchAlias, setParserForSelectedString, setQueryObjectValue, setQueryOperators, simplifyColumnDefault, sqlFn, sqlQueryArgsToExpression, tableDataMethods, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };

package/dist/index.js

@@ -921,7 +921,7 @@ const makeVarArg = (_op) => {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
   );
 };
-const quoteValue$1 = (arg, ctx, quotedAs, jsonArray) => {
+const quoteValue = (arg, ctx, quotedAs, jsonArray) => {
   if (arg && typeof arg === "object") {
     if (!jsonArray && Array.isArray(arg)) {
       return `(${arg.map((value) => orchidCore.addValue(ctx.values, value)).join(", ")})`;
@@ -953,16 +953,16 @@ const quoteLikeValue = (arg, ctx, quotedAs, jsonArray) => {
 };
 const base = {
   equals: make(
-    (key, value, ctx, quotedAs) => value === null ? `${key} IS NULL` : `${key} = ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => value === null ? `${key} IS NULL` : `${key} = ${quoteValue(value, ctx, quotedAs)}`
   ),
   not: make(
-    (key, value, ctx, quotedAs) => value === null ? `${key} IS NOT NULL` : `${key} <> ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => value === null ? `${key} IS NOT NULL` : `${key} <> ${quoteValue(value, ctx, quotedAs)}`
   ),
   in: make(
-    (key, value, ctx, quotedAs) => `${key} IN ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => `${key} IN ${quoteValue(value, ctx, quotedAs)}`
   ),
   notIn: make(
-    (key, value, ctx, quotedAs) => `NOT ${key} IN ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => `NOT ${key} IN ${quoteValue(value, ctx, quotedAs)}`
   )
 };
 const boolean = __spreadProps$b(__spreadValues$k({}, base), {
@@ -975,19 +975,19 @@ const boolean = __spreadProps$b(__spreadValues$k({}, base), {
 });
 const numeric = __spreadProps$b(__spreadValues$k({}, base), {
   lt: make(
-    (key, value, ctx, quotedAs) => `${key} < ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => `${key} < ${quoteValue(value, ctx, quotedAs)}`
   ),
   lte: make(
-    (key, value, ctx, quotedAs) => `${key} <= ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => `${key} <= ${quoteValue(value, ctx, quotedAs)}`
   ),
   gt: make(
-    (key, value, ctx, quotedAs) => `${key} > ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => `${key} > ${quoteValue(value, ctx, quotedAs)}`
   ),
   gte: make(
-    (key, value, ctx, quotedAs) => `${key} >= ${quoteValue$1(value, ctx, quotedAs)}`
+    (key, value, ctx, quotedAs) => `${key} >= ${quoteValue(value, ctx, quotedAs)}`
   ),
   between: make(
-    (key, [from, to], ctx, quotedAs) => `${key} BETWEEN ${quoteValue$1(from, ctx, quotedAs)} AND ${quoteValue$1(
+    (key, [from, to], ctx, quotedAs) => `${key} BETWEEN ${quoteValue(from, ctx, quotedAs)} AND ${quoteValue(
       to,
       ctx,
       quotedAs
@@ -1041,10 +1041,10 @@ const json = __spreadProps$b(__spreadValues$k({}, base), {
     { _op: jsonPathQueryOp }
   ),
   jsonSupersetOf: make(
-    (key, value, ctx, quotedAs) => `${key} @> ${quoteValue$1(value, ctx, quotedAs, true)}`
+    (key, value, ctx, quotedAs) => `${key} @> ${quoteValue(value, ctx, quotedAs, true)}`
   ),
   jsonSubsetOf: make(
-    (key, value, ctx, quotedAs) => `${key} <@ ${quoteValue$1(value, ctx, quotedAs, true)}`
+    (key, value, ctx, quotedAs) => `${key} <@ ${quoteValue(value, ctx, quotedAs, true)}`
   ),
   jsonSet: makeVarArg(
     (key, [path, value], ctx) => `jsonb_set(${key}, ${encodeJsonPath(ctx, path)}, ${orchidCore.addValue(
@@ -3182,25 +3182,26 @@ const defaultSchemaConfig = {
   timestamp: (precision) => new TimestampTZColumn(defaultSchemaConfig, precision)
 };
 
-const quoteValue = (value, nested = false) => {
+const escape = (value, migration, nested) => {
   const type = typeof value;
   if (type === "number" || type === "bigint")
     return String(value);
   else if (type === "string")
-    return quoteString(value);
+    return escapeString(value);
   else if (type === "boolean")
     return value ? "true" : "false";
   else if (value instanceof Date)
     return `'${value.toISOString()}'`;
   else if (Array.isArray(value))
-    return `${nested ? "" : "ARRAY"}[${value.map((el) => quoteValue(el, true)).join(",")}]`;
+    return migration && nested && !value.length ? "" : (migration ? "{" : nested ? "[" : "ARRAY[") + value.map((el) => escape(el, migration, true)).join(",") + (migration ? "}" : "]");
   else if (value === null || value === void 0)
     return "NULL";
   else
-    return quoteString(JSON.stringify(value));
+    return escapeString(JSON.stringify(value));
 };
-const quote = (value) => quoteValue(value);
-const quoteString = (value) => `'${value.replaceAll("'", "''")}'`;
+const escapeForLog = (value) => escape(value);
+const escapeForMigration = (value) => escape(value, true);
+const escapeString = (value) => `'${value.replaceAll("'", "''")}'`;
 
 const makeMessage = (colors, timeColor, time, sqlColor, sql, valuesColor, values) => {
   const elapsed = process.hrtime(time);
@@ -3209,7 +3210,7 @@ const makeMessage = (colors, timeColor, time, sqlColor, sql, valuesColor, values
   if (!(values == null ? void 0 : values.length)) {
     return result;
   }
-  const formattedValues = `[${values.map(quote).join(", ")}]`;
+  const formattedValues = `[${values.map(escapeForLog).join(", ")}]`;
   return `${result} ${colors ? valuesColor(formattedValues) : formattedValues}`;
 };
 const logParamToLogObject = (logger, log) => {
@@ -4242,7 +4243,7 @@ const addParserForSelectItem = (q, as, key, arg) => {
             let returnType = originalReturnType;
             const { hookSelect } = query;
             const batches = [];
-            let last = path.length;
+            const last = path.length;
             if (returnType === "value" || returnType === "valueOrThrow") {
               if (hookSelect) {
                 batches.push = (item) => {
@@ -4252,8 +4253,6 @@ const addParserForSelectItem = (q, as, key, arg) => {
                   batches.push = Array.prototype.push;
                   return batches.push(item);
                 };
-              } else {
-                last--;
               }
             }
             collectNestedSelectBatches(batches, rows, path, last);
@@ -4314,19 +4313,19 @@ const addParserForSelectItem = (q, as, key, arg) => {
                 const parse = (_b2 = query.parsers) == null ? void 0 : _b2[orchidCore.getValueKey];
                 if (parse) {
                   if (returnType === "value") {
-                    for (const { data } of batches) {
-                      data[key] = data[key] === void 0 ? arg.q.notFoundDefault : parse(data[key]);
+                    for (const item of batches) {
+                      item.parent[item.key] = item.data = item.data === void 0 ? arg.q.notFoundDefault : parse(item.data);
                     }
                   } else {
-                    for (const { data } of batches) {
-                      if (data[key] === void 0)
+                    for (const item of batches) {
+                      if (item.data === void 0)
                         throw new NotFoundError(arg);
-                      data[key] = parse(data[key]);
+                      item.parent[item.key] = item.data = parse(item.data);
                     }
                   }
                 } else if (returnType !== "value") {
                   for (const { data } of batches) {
-                    if (data[key] === void 0)
+                    if (data === void 0)
                       throw new NotFoundError(arg);
                   }
                 }
@@ -4395,7 +4394,9 @@ const collectNestedSelectBatches = (batches, rows, path, last) => {
   const stack = rows.map(
     (row) => ({
       data: row,
-      i: 0
+      parent: row,
+      i: 0,
+      key: path[0]
     })
   );
   while (stack.length > 0) {
@@ -5827,7 +5828,7 @@ const pushCopySql = (ctx, table, query, quotedAs) => {
   }).join(", ")})` : "";
   const target = "from" in copy ? copy.from : copy.to;
   sql.push(
-    `COPY "${table.table}"${columns} ${"from" in copy ? "FROM" : "TO"} ${typeof target === "string" ? quoteString(target) : `PROGRAM ${quoteString(target.program)}`}`
+    `COPY "${table.table}"${columns} ${"from" in copy ? "FROM" : "TO"} ${typeof target === "string" ? escapeString(target) : `PROGRAM ${escapeString(target.program)}`}`
   );
   if (Object.keys(copy).length > (copy.columns ? 2 : 1)) {
     const options = [];
@@ -5836,15 +5837,15 @@ const pushCopySql = (ctx, table, query, quotedAs) => {
     if (copy.freeze)
       options.push(`FREEZE ${copy.freeze}`);
     if (copy.delimiter)
-      options.push(`DELIMITER ${quoteString(copy.delimiter)}`);
+      options.push(`DELIMITER ${escapeString(copy.delimiter)}`);
     if (copy.null)
-      options.push(`NULL ${quoteString(copy.null)}`);
+      options.push(`NULL ${escapeString(copy.null)}`);
     if (copy.header)
       options.push(`HEADER ${copy.header}`);
     if (copy.quote)
-      options.push(`QUOTE ${quoteString(copy.quote)}`);
+      options.push(`QUOTE ${escapeString(copy.quote)}`);
     if (copy.escape)
-      options.push(`ESCAPE ${quoteString(copy.escape)}`);
+      options.push(`ESCAPE ${escapeString(copy.escape)}`);
     if (copy.forceQuote)
       options.push(
         `FORCE_QUOTE ${copy.forceQuote === "*" ? "*" : `(${copy.forceQuote.map((x) => `"${x}"`).join(", ")})`}`
@@ -5858,7 +5859,7 @@ const pushCopySql = (ctx, table, query, quotedAs) => {
         `FORCE_NULL (${copy.forceNull.map((x) => `"${x}"`).join(", ")})`
       );
     if (copy.encoding)
-      options.push(`ENCODING ${quoteString(copy.encoding)}`);
+      options.push(`ENCODING ${escapeString(copy.encoding)}`);
     sql.push(`WITH (${options.join(", ")})`);
   }
   pushWhereStatementSql(ctx, table, query, quotedAs);
@@ -11158,7 +11159,7 @@ class QueryUpsertOrCreate {
    *
    * ```ts
    * await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     data: {
    *       // update record's name
@@ -11172,7 +11173,7 @@ class QueryUpsertOrCreate {
    *
    * // the same as above but using `update` and `create`
    * await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     update: {
    *       name: 'updated user',
@@ -11189,7 +11190,7 @@ class QueryUpsertOrCreate {
    *
    * ```ts
    * await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     update: {
    *       name: 'updated user',
@@ -11202,7 +11203,7 @@ class QueryUpsertOrCreate {
    *
    * // the same as above using `data`
    * await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     data: {
    *       name: 'updated user',
@@ -11219,7 +11220,7 @@ class QueryUpsertOrCreate {
    *
    * ```ts
    * const user = await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     data: {
    *       name: 'updated user',
@@ -11259,17 +11260,19 @@ class QueryUpsertOrCreate {
    * By default, it is not returning columns, place `get`, `select`, or `selectAll` before `orCreate` to specify returning columns.
    *
    * ```ts
-   * const user = await User.selectAll().find({ email: 'some@email.com' }).orCreate({
-   *   email: 'some@email.com',
-   *   name: 'created user',
-   * });
+   * const user = await User.selectAll()
+   *   .findBy({ email: 'some@email.com' })
+   *   .orCreate({
+   *     email: 'some@email.com',
+   *     name: 'created user',
+   *   });
    * ```
    *
    * The data may be returned from a function, it won't be called if the record was found:
    *
    * ```ts
    * const user = await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .orCreate(() => ({
    *     email: 'some@email.com',
    *     name: 'created user',
@@ -11370,11 +11373,11 @@ class QueryMap {
   /**
    * Use `map` to transform individual records of a query result.
    *
-   * It accepts a single record and should return a single transformed record.
+   * Use `map` to transform individual records of a query result. If the query returns multiple, `map` function going to transform records one by one.
    *
-   * For transforming the whole result of a query, consider using [transform](#transform) instead.
+   * For an optional query result (`findOptional`, `getOptional`, etc.), `map` is **not** called for empty results.
    *
-   * The [hooks](/guide/hooks) that are going to run after the query will receive the query result **before** transformation.
+   * For transforming the result of a query as a whole, consider using {@link Query.transform} instead.
    *
    * ```ts
    * // add a `titleLength` to every post
@@ -13171,6 +13174,9 @@ exports.copyTableData = copyTableData;
 exports.countSelect = countSelect;
 exports.createDb = createDb;
 exports.defaultSchemaConfig = defaultSchemaConfig;
+exports.escapeForLog = escapeForLog;
+exports.escapeForMigration = escapeForMigration;
+exports.escapeString = escapeString;
 exports.extendQuery = extendQuery;
 exports.filterResult = filterResult;
 exports.foreignKeyArgumentToCode = foreignKeyArgumentToCode;
@@ -13216,8 +13222,6 @@ exports.queryJson = queryJson;
 exports.queryMethodByReturnType = queryMethodByReturnType;
 exports.queryTypeWithLimitOne = queryTypeWithLimitOne;
 exports.queryWrap = queryWrap;
-exports.quote = quote;
-exports.quoteString = quoteString;
 exports.raw = raw;
 exports.referencesArgsToCode = referencesArgsToCode;
 exports.resolveSubQueryCallback = resolveSubQueryCallback;