pqb 0.17.3 → 0.17.4

package/dist/index.d.ts

@@ -1826,13 +1826,9 @@ type ForQueryBuilder<Q extends Query> = Q & {
 };
 declare class For {
     forUpdate<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
-    _forUpdate<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
     forNoKeyUpdate<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
-    _forNoKeyUpdate<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
     forShare<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
-    _forShare<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
     forKeyShare<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
-    _forKeyShare<T extends Query>(this: T, tableNames?: string[] | Expression): ForQueryBuilder<T>;
 }
 
 type FromArgs<T extends Query> = [
@@ -3591,10 +3587,46 @@ declare class OnQueryBuilder<S extends QueryBase = QueryBase, J extends QueryBas
     withData: {};
     internal: QueryInternal;
     constructor(q: QueryBase, { shape, joinedShapes }: Pick<QueryData, 'shape' | 'joinedShapes'>, joinTo: QueryBase);
+    /**
+     * Use `on` to specify columns to join records.
+     *
+     * ```ts
+     * q
+     *   // left column is the db.message column, right column is the db.user column
+     *   .on('userId', 'id')
+     *   // table names can be provided:
+     *   .on('message.userId', 'user.id')
+     *   // operator can be specified:
+     *   .on('userId', '!=', 'id')
+     *   // operator can be specified with table names as well:
+     *   .on('message.userId', '!=', 'user.id')
+     *   // `.orOn` takes the same arguments as `.on` and acts like `.or`:
+     *   .on('userId', 'id') // where message.userId = user.id
+     * ```
+     *
+     * @param args - columns to join with
+     */
     on<T extends OnQueryBuilder>(this: T, ...args: OnArgs<T>): T;
     _on<T extends OnQueryBuilder>(this: T, ...args: OnArgs<T>): T;
+    /**
+     * Works as {@link on}, but the added conditions will be separated from previous with `OR`.
+     *
+     * @param args - columns to join with
+     */
     orOn<T extends OnQueryBuilder>(this: T, ...args: OnArgs<T>): T;
     _orOn<T extends OnQueryBuilder>(this: T, ...args: OnArgs<T>): T;
+    /**
+     * Use `onJsonPathEquals` to join record based on a field of their JSON column:
+     *
+     * ```ts
+     * db.table.join(db.otherTable, (q) =>
+     *   // '$.key' is a JSON path
+     *   q.onJsonPathEquals('otherTable.data', '$.key', 'table.data', '$.key'),
+     * );
+     * ```
+     *
+     * @param args - columns and JSON paths to join with.
+     */
     onJsonPathEquals<T extends OnQueryBuilder>(this: T, ...args: OnJsonPathEqualsArgs<T>): T;
     _onJsonPathEquals<T extends OnQueryBuilder>(this: T, ...args: OnJsonPathEqualsArgs<T>): T;
 }
@@ -3821,6 +3853,7 @@ type Resolve = (result: any) => any;
 type Reject = (error: any) => any;
 declare class Then {
     get then(): typeof maybeWrappedThen;
+    set then(value: typeof maybeWrappedThen);
     catch(this: Query, fn: (reason: any) => unknown): Promise<unknown>;
 }
 declare const handleResult: CommonQueryData['handleResult'];
@@ -5501,6 +5534,26 @@ declare class QueryMethods<CT extends ColumnTypesBase> {
         restartIdentity?: boolean;
         cascade?: boolean;
     }): TruncateResult<T>;
+    /**
+     * `none` will resolve the query into an empty result, without executing a database query.
+     *
+     * ```ts
+     * await db.table.none(); // -> empty array
+     * await db.table.findOptional(123).none(); // -> undefined
+     * await db.table.find(123).none(); // throws NotFoundError
+     * ```
+     *
+     * [create](/guide/create-update-delete.html#create) chained with `count`, [update](/guide/create-update-delete.html#update), and [delete](/guide/create-update-delete.html#del-delete) are returning a count of affected records.
+     *
+     * When they are called with `none`, query does not execute and 0 is returned.
+     *
+     * ```ts
+     * await db.table.count().create(data); // -> 0
+     * await db.table.all().update(data); // -> 0
+     * await db.table.all().delete(); // -> 0
+     * ```
+     */
+    none<T extends Query>(this: T): T;
     /**
      * `modify` allows modifying the query with your function:
      *
@@ -7069,6 +7122,14 @@ declare const setQueryObjectValue: <T extends {
  */
 declare const throwIfNoWhere: (q: Query, method: string) => void;
 declare const saveSearchAlias: (q: QueryBase, as: string, key: 'joinedShapes' | 'withShapes') => string;
+/**
+ * Extend query prototype with new methods.
+ * The query and its data are cloned (with Object.create).
+ *
+ * @param q - query object to extend from
+ * @param methods - methods to add
+ */
+declare const extendQuery: <T extends Query, Methods extends Record<string, unknown>>(q: T, methods: Methods) => T & Methods;
 
 type Arg = {
     $queryBuilder: Query;
@@ -7079,4 +7140,4 @@ declare const testTransaction: {
     close(arg: Arg): Promise<void>;
 };
 
-export { Adapter, AdapterConfig, AdapterOptions, AddQuerySelect, AddQueryWith, AfterHook, AggregateMethods, AggregateOptions, AliasOrTable, ArrayColumn, ArrayData, ArrayOfColumnsObjects, AsMethods, BaseOperators, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BooleanNullable, BoxColumn, ByteaColumn, CharColumn, CidrColumn, CircleColumn, CitextColumn, Clear, ClearStatement, ColumnData, ColumnExpression, ColumnFromDbParams, ColumnInfo, ColumnInfoMethods, ColumnInfoQueryData, ColumnOperators, ColumnType, ColumnTypes, ColumnsObject, ColumnsShape, CommonQueryData, CopyMethods, CopyOptions, CopyQueryData, Create, CreateCtx, CreateData, CreateKind, CreateMethodsNames, CustomTypeColumn, DateBaseColumn, DateColumn, DateTimeBaseClass, DateTimeTzBaseClass, Db, DbOptions, DbResult, DbTableOptions, DecimalBaseColumn, DecimalColumn, DefaultColumnTypes, Delete, DeleteMethodsNames, DeleteQueryData, DomainColumn, DoublePrecisionColumn, DropMode, EnumColumn, ExpressionOutput, FnExpression, FnExpressionArg, For, ForeignKey, ForeignKeyAction, ForeignKeyMatch, ForeignKeyOptions, From, FromArgs, FromResult, GetArg, GetQueryResult, GetStringArg, Having, HavingItem, HookAction, HookSelect, IdentityColumn, IndexColumnOptions, IndexOptions, InetColumn, InsertQueryData, IntegerBaseColumn, IntegerColumn, IntervalColumn, IsolationLevel, JSONColumn, JSONTextColumn, Join, JoinArgs, JoinCallback, JoinFirstArg, JoinItem, JoinLateralCallback, JoinLateralItem, JoinLateralResult, JoinOverrides, JoinResult, JoinedParsers, JoinedShapes, JsonItem, JsonMethods, JsonModifiers, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQuery, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NoPrimaryKeyOption, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, NumberColumn, NumberColumnData, OnConflictItem, OnConflictMergeUpdate, OnConflictQueryBuilder, OnQueryBuilder, Operator, Operators, OrchidOrmError, OrchidOrmInternalError, OrderArg, OrderArgs, OrderItem, OrderTsQueryConfig, Over, PathColumn, PluckResultColumnType, PointColumn, PolygonColumn, Query, QueryAfterHook, QueryArraysResult, QueryBase, QueryBeforeHook, QueryData, QueryError, QueryErrorName, QueryGet, QueryHookSelect, QueryHooks, QueryLog, QueryLogObject, QueryLogOptions, QueryLogger, QueryMethods, QueryResult, QueryReturnType, QueryReturnsAll, QuerySourceItem, QueryTransform, QueryTransformFn, QueryUpsertOrCreate, QueryWithTable, RawSQL, RawSqlMethods, RealColumn, RelationConfigBase, RelationQuery, RelationQueryBase, RelationSubQueries, RelationsBase, SearchArg, SearchMethods, SearchWeight, Select, SelectAggMethods, SelectArg, SelectItem, SelectQueryBuilder, SelectQueryData, Selectable, SelectableBase, SelectableFromShape, SelectableOfType, SelectableOrExpression, SelectableOrExpressionOfType, SerialColumn, SerialColumnData, SetQueryKind, SetQueryReturns, SetQueryReturnsAll, SetQueryReturnsColumn, SetQueryReturnsColumnInfo, SetQueryReturnsColumnOptional, SetQueryReturnsOne, SetQueryReturnsOneOptional, SetQueryReturnsPluck, SetQueryReturnsRowCount, SetQueryReturnsRows, SetQueryReturnsValue, SetQueryReturnsValueOptional, SetQueryReturnsVoid, SetQueryTableAlias, SetQueryWith, SimpleJoinItem, SingleColumnIndexOptions, SmallIntColumn, SmallSerialColumn, SortDir, StringColumn, SubQueryBuilder, TableData, TextBaseColumn, TextColumn, TextColumnData, Then, TimeColumn, TimeInterval, TimestampColumn, TimestampTZColumn, ToSQLCtx, ToSQLOptions, Transaction, TransactionAdapter, TransactionOptions, TransformMethods, TruncateQueryData, TsQueryColumn, TsVectorColumn, TypeParsers, UUIDColumn, UnhandledTypeError, Union, UnionArg, UnionItem, UnionKind, UnknownColumn, Update, UpdateCtx, UpdateData, UpdateQueryData, UpdateQueryDataItem, UpdateQueryDataObject, UpdatedAtDataInjector, UpsertCreateArg, UpsertData, UpsertResult, UpsertThis, VarCharColumn, VirtualColumn, Where, WhereArg, WhereArgs, WhereInArg, WhereInColumn, WhereInItem, WhereInValues, WhereItem, WhereJsonPathEqualsItem, WhereOnItem, WhereOnJoinItem, WhereQueryBase, WhereQueryBuilder, WhereResult, WhereSearchItem, WhereSearchResult, WindowArg, WindowArgDeclaration, WindowDeclaration, WindowItem, With, WithDataBase, WithDataItem, WithItem, WithOptions, XMLColumn, addOr, addOrNot, addParserForRawExpression, addParserForSelectItem, addQueryOn, addWhere, addWhereIn, addWhereNot, anyShape, checkIfASimpleQuery, cloneQueryArrays, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnTypes, columnsByType, columnsShapeToCode, constraintPropsToCode, constraintToCode, createDb, createOperator, foreignKeyArgumentToCode, getClonedQueryData, getColumnTypes, getConstraintKind, getQueryAs, getShapeFromSelect, getSubQueryBuilder, getTableData, handleResult, identityToCode, indexToCode, instantiateColumn, isQueryReturnsAll, isSelectingCount, joinSubQuery, logColors, logParamToLogObject, makeColumnFn, makeColumnFnClass, makeRegexToFindInSql, makeSQL, newTableData, parseRecord, parseResult, primaryKeyToCode, processSelectArg, pushQueryArray, pushQueryOn, pushQueryOrOn, pushQueryValue, queryMethodByReturnType, queryTypeWithLimitOne, quote, quoteString, raw, referencesArgsToCode, resetTableData, resolveSubQueryCallback, saveSearchAlias, setQueryObjectValue, simplifyColumnDefault, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };
+export { Adapter, AdapterConfig, AdapterOptions, AddQuerySelect, AddQueryWith, AfterHook, AggregateMethods, AggregateOptions, AliasOrTable, ArrayColumn, ArrayData, ArrayOfColumnsObjects, AsMethods, BaseOperators, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BooleanNullable, BoxColumn, ByteaColumn, CharColumn, CidrColumn, CircleColumn, CitextColumn, Clear, ClearStatement, ColumnData, ColumnExpression, ColumnFromDbParams, ColumnInfo, ColumnInfoMethods, ColumnInfoQueryData, ColumnOperators, ColumnType, ColumnTypes, ColumnsObject, ColumnsShape, CommonQueryData, CopyMethods, CopyOptions, CopyQueryData, Create, CreateCtx, CreateData, CreateKind, CreateMethodsNames, CustomTypeColumn, DateBaseColumn, DateColumn, DateTimeBaseClass, DateTimeTzBaseClass, Db, DbOptions, DbResult, DbTableOptions, DecimalBaseColumn, DecimalColumn, DefaultColumnTypes, Delete, DeleteMethodsNames, DeleteQueryData, DomainColumn, DoublePrecisionColumn, DropMode, EnumColumn, ExpressionOutput, FnExpression, FnExpressionArg, For, ForeignKey, ForeignKeyAction, ForeignKeyMatch, ForeignKeyOptions, From, FromArgs, FromResult, GetArg, GetQueryResult, GetStringArg, Having, HavingItem, HookAction, HookSelect, IdentityColumn, IndexColumnOptions, IndexOptions, InetColumn, InsertQueryData, IntegerBaseColumn, IntegerColumn, IntervalColumn, IsolationLevel, JSONColumn, JSONTextColumn, Join, JoinArgs, JoinCallback, JoinFirstArg, JoinItem, JoinLateralCallback, JoinLateralItem, JoinLateralResult, JoinOverrides, JoinResult, JoinedParsers, JoinedShapes, JsonItem, JsonMethods, JsonModifiers, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQuery, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NoPrimaryKeyOption, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, NumberColumn, NumberColumnData, OnConflictItem, OnConflictMergeUpdate, OnConflictQueryBuilder, OnQueryBuilder, Operator, Operators, OrchidOrmError, OrchidOrmInternalError, OrderArg, OrderArgs, OrderItem, OrderTsQueryConfig, Over, PathColumn, PluckResultColumnType, PointColumn, PolygonColumn, Query, QueryAfterHook, QueryArraysResult, QueryBase, QueryBeforeHook, QueryData, QueryError, QueryErrorName, QueryGet, QueryHookSelect, QueryHooks, QueryLog, QueryLogObject, QueryLogOptions, QueryLogger, QueryMethods, QueryResult, QueryReturnType, QueryReturnsAll, QuerySourceItem, QueryTransform, QueryTransformFn, QueryUpsertOrCreate, QueryWithTable, RawSQL, RawSqlMethods, RealColumn, RelationConfigBase, RelationQuery, RelationQueryBase, RelationSubQueries, RelationsBase, SearchArg, SearchMethods, SearchWeight, Select, SelectAggMethods, SelectArg, SelectItem, SelectQueryBuilder, SelectQueryData, Selectable, SelectableBase, SelectableFromShape, SelectableOfType, SelectableOrExpression, SelectableOrExpressionOfType, SerialColumn, SerialColumnData, SetQueryKind, SetQueryReturns, SetQueryReturnsAll, SetQueryReturnsColumn, SetQueryReturnsColumnInfo, SetQueryReturnsColumnOptional, SetQueryReturnsOne, SetQueryReturnsOneOptional, SetQueryReturnsPluck, SetQueryReturnsRowCount, SetQueryReturnsRows, SetQueryReturnsValue, SetQueryReturnsValueOptional, SetQueryReturnsVoid, SetQueryTableAlias, SetQueryWith, SimpleJoinItem, SingleColumnIndexOptions, SmallIntColumn, SmallSerialColumn, SortDir, StringColumn, SubQueryBuilder, TableData, TextBaseColumn, TextColumn, TextColumnData, Then, TimeColumn, TimeInterval, TimestampColumn, TimestampTZColumn, ToSQLCtx, ToSQLOptions, Transaction, TransactionAdapter, TransactionOptions, TransformMethods, TruncateQueryData, TsQueryColumn, TsVectorColumn, TypeParsers, UUIDColumn, UnhandledTypeError, Union, UnionArg, UnionItem, UnionKind, UnknownColumn, Update, UpdateCtx, UpdateData, UpdateQueryData, UpdateQueryDataItem, UpdateQueryDataObject, UpdatedAtDataInjector, UpsertCreateArg, UpsertData, UpsertResult, UpsertThis, VarCharColumn, VirtualColumn, Where, WhereArg, WhereArgs, WhereInArg, WhereInColumn, WhereInItem, WhereInValues, WhereItem, WhereJsonPathEqualsItem, WhereOnItem, WhereOnJoinItem, WhereQueryBase, WhereQueryBuilder, WhereResult, WhereSearchItem, WhereSearchResult, WindowArg, WindowArgDeclaration, WindowDeclaration, WindowItem, With, WithDataBase, WithDataItem, WithItem, WithOptions, XMLColumn, addOr, addOrNot, addParserForRawExpression, addParserForSelectItem, addQueryOn, addWhere, addWhereIn, addWhereNot, anyShape, checkIfASimpleQuery, cloneQueryArrays, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnTypes, columnsByType, columnsShapeToCode, constraintPropsToCode, constraintToCode, createDb, createOperator, extendQuery, foreignKeyArgumentToCode, getClonedQueryData, getColumnTypes, getConstraintKind, getQueryAs, getShapeFromSelect, getSubQueryBuilder, getTableData, handleResult, identityToCode, indexToCode, instantiateColumn, isQueryReturnsAll, isSelectingCount, joinSubQuery, logColors, logParamToLogObject, makeColumnFn, makeColumnFnClass, makeRegexToFindInSql, makeSQL, newTableData, parseRecord, parseResult, primaryKeyToCode, processSelectArg, pushQueryArray, pushQueryOn, pushQueryOrOn, pushQueryValue, queryMethodByReturnType, queryTypeWithLimitOne, quote, quoteString, raw, referencesArgsToCode, resetTableData, resolveSubQueryCallback, saveSearchAlias, setQueryObjectValue, simplifyColumnDefault, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };

package/dist/index.js

@@ -2204,6 +2204,14 @@ const saveSearchAlias = (q, as, key) => {
   setQueryObjectValue(q, key, as, orchidCore.emptyObject);
   return as;
 };
+const extendQuery = (q, methods) => {
+  const base = Object.create(q.baseQuery);
+  base.baseQuery = base;
+  Object.assign(base, methods);
+  const cloned = Object.create(base);
+  cloned.q = getClonedQueryData(q.q);
+  return cloned;
+};
 
 var __defProp$b = Object.defineProperty;
 var __defProps$6 = Object.defineProperties;
@@ -5531,55 +5539,45 @@ class Delete {
   }
 }
 
+const forMethods = {
+  noWait() {
+    return this.clone()._noWait();
+  },
+  _noWait() {
+    const q = this.q;
+    if (q == null ? void 0 : q.for)
+      q.for.mode = "NO WAIT";
+    return this;
+  },
+  skipLocked() {
+    return this.clone()._skipLocked();
+  },
+  _skipLocked() {
+    const q = this.q;
+    if (q == null ? void 0 : q.for)
+      q.for.mode = "SKIP LOCKED";
+    return this;
+  }
+};
 const forQueryBuilder = (q, type, tableNames) => {
-  q.q.for = { type, tableNames };
-  q.baseQuery = Object.create(q.baseQuery);
-  q.baseQuery.baseQuery = q.baseQuery;
-  Object.assign(q.baseQuery, {
-    noWait() {
-      return this.clone()._noWait();
-    },
-    _noWait() {
-      const q2 = this.q;
-      if (q2 == null ? void 0 : q2.for)
-        q2.for.mode = "NO WAIT";
-      return this;
-    },
-    skipLocked() {
-      return this.clone()._skipLocked();
-    },
-    _skipLocked() {
-      const q2 = this.q;
-      if (q2 == null ? void 0 : q2.for)
-        q2.for.mode = "SKIP LOCKED";
-      return this;
-    }
-  });
-  return q.clone();
+  q = extendQuery(q, forMethods);
+  q.q.for = {
+    type,
+    tableNames
+  };
+  return q;
 };
 class For {
   forUpdate(tableNames) {
-    return this.clone()._forUpdate(tableNames);
-  }
-  _forUpdate(tableNames) {
     return forQueryBuilder(this, "UPDATE", tableNames);
   }
   forNoKeyUpdate(tableNames) {
-    return this.clone()._forNoKeyUpdate(tableNames);
-  }
-  _forNoKeyUpdate(tableNames) {
     return forQueryBuilder(this, "NO KEY UPDATE", tableNames);
   }
   forShare(tableNames) {
-    return this.clone()._forShare(tableNames);
-  }
-  _forShare(tableNames) {
     return forQueryBuilder(this, "SHARE", tableNames);
   }
   forKeyShare(tableNames) {
-    return this.clone()._forKeyShare(tableNames);
-  }
-  _forKeyShare(tableNames) {
     return forQueryBuilder(this, "KEY SHARE", tableNames);
   }
 }
@@ -7211,18 +7209,54 @@ class OnQueryBuilder extends WhereQueryBase {
     }
     this.q.joinTo = joinTo;
   }
+  /**
+   * Use `on` to specify columns to join records.
+   *
+   * ```ts
+   * q
+   *   // left column is the db.message column, right column is the db.user column
+   *   .on('userId', 'id')
+   *   // table names can be provided:
+   *   .on('message.userId', 'user.id')
+   *   // operator can be specified:
+   *   .on('userId', '!=', 'id')
+   *   // operator can be specified with table names as well:
+   *   .on('message.userId', '!=', 'user.id')
+   *   // `.orOn` takes the same arguments as `.on` and acts like `.or`:
+   *   .on('userId', 'id') // where message.userId = user.id
+   * ```
+   *
+   * @param args - columns to join with
+   */
   on(...args) {
     return this.clone()._on(...args);
   }
   _on(...args) {
     return pushQueryOn(this, this.q.joinTo, this, ...args);
   }
+  /**
+   * Works as {@link on}, but the added conditions will be separated from previous with `OR`.
+   *
+   * @param args - columns to join with
+   */
   orOn(...args) {
     return this.clone()._orOn(...args);
   }
   _orOn(...args) {
     return pushQueryOrOn(this, this.q.joinTo, this, ...args);
   }
+  /**
+   * Use `onJsonPathEquals` to join record based on a field of their JSON column:
+   *
+   * ```ts
+   * db.table.join(db.otherTable, (q) =>
+   *   // '$.key' is a JSON path
+   *   q.onJsonPathEquals('otherTable.data', '$.key', 'table.data', '$.key'),
+   * );
+   * ```
+   *
+   * @param args - columns and JSON paths to join with.
+   */
   onJsonPathEquals(...args) {
     return this.clone()._onJsonPathEquals(...args);
   }
@@ -7603,6 +7637,11 @@ class Then {
     queryError = new Error();
     return maybeWrappedThen;
   }
+  set then(value) {
+    Object.defineProperty(this, "then", {
+      value
+    });
+  }
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   catch(fn) {
     return this.then(void 0, fn);
@@ -9211,6 +9250,24 @@ class TransformMethods {
   }
 }
 
+const noneMethods = {
+  // `then` resolves or rejects based on return type of the query.
+  // It is `async` so it returns a chainable Promise.
+  async then(resolve, reject) {
+    const type = this.q.returnType;
+    if (!type || type === "all" || type === "rows" || type === "pluck")
+      resolve == null ? void 0 : resolve([]);
+    else if (type === "one" || type === "value" || type === "void")
+      resolve == null ? void 0 : resolve();
+    else if (type === "rowCount")
+      resolve == null ? void 0 : resolve(0);
+    else
+      reject == null ? void 0 : reject(new NotFoundError(this));
+  },
+  // `catch` returns a Promise, so it is chainable with then/catch.
+  catch: () => new Promise(orchidCore.noop)
+};
+
 class QueryMethods {
   /**
    * `.all` is a default behavior, that returns an array of objects:
@@ -9672,6 +9729,28 @@ class QueryMethods {
     }
     return this._exec();
   }
+  /**
+   * `none` will resolve the query into an empty result, without executing a database query.
+   *
+   * ```ts
+   * await db.table.none(); // -> empty array
+   * await db.table.findOptional(123).none(); // -> undefined
+   * await db.table.find(123).none(); // throws NotFoundError
+   * ```
+   *
+   * [create](/guide/create-update-delete.html#create) chained with `count`, [update](/guide/create-update-delete.html#update), and [delete](/guide/create-update-delete.html#del-delete) are returning a count of affected records.
+   *
+   * When they are called with `none`, query does not execute and 0 is returned.
+   *
+   * ```ts
+   * await db.table.count().create(data); // -> 0
+   * await db.table.all().update(data); // -> 0
+   * await db.table.all().delete(); // -> 0
+   * ```
+   */
+  none() {
+    return extendQuery(this, noneMethods);
+  }
   /**
    * `modify` allows modifying the query with your function:
    *
@@ -10301,6 +10380,7 @@ exports.constraintPropsToCode = constraintPropsToCode;
 exports.constraintToCode = constraintToCode;
 exports.createDb = createDb;
 exports.createOperator = createOperator;
+exports.extendQuery = extendQuery;
 exports.foreignKeyArgumentToCode = foreignKeyArgumentToCode;
 exports.getClonedQueryData = getClonedQueryData;
 exports.getColumnTypes = getColumnTypes;