pqb 0.25.0 → 0.25.1

package/dist/index.mjs

@@ -96,6 +96,9 @@ function raw(...args) {
   return isTemplateLiteralArgs(args) ? new RawSQL(args) : typeof args[0] === "function" ? new DynamicRawSQL(args[0]) : new RawSQL(args[0].raw, args[0].values);
 }
 const countSelect = [new RawSQL("count(*)")];
+function sqlQueryArgsToExpression(args) {
+  return Array.isArray(args[0]) ? new RawSQL(args) : args[0];
+}
 
 var __defProp$g = Object.defineProperty;
 var __defProps$a = Object.defineProperties;
@@ -2108,31 +2111,28 @@ class AsMethods {
   }
 }
 
-function queryFrom(self, args) {
-  if (Array.isArray(args[0])) {
-    return queryFrom(self, [
-      new RawSQL(args)
-    ]);
-  }
+function queryFrom(self, arg, options) {
   const data = self.q;
-  if (typeof args[0] === "string") {
-    data.as || (data.as = args[0]);
-  } else if (!isExpression(args[0])) {
-    const q = args[0];
+  if (typeof arg === "string") {
+    data.as || (data.as = arg);
+  } else if (!isExpression(arg)) {
+    const q = arg;
     data.as || (data.as = q.q.as || q.table || "t");
-    data.shape = getShapeFromSelect(
-      args[0],
-      true
-    );
+    data.shape = getShapeFromSelect(arg, true);
     data.parsers = q.q.parsers;
   } else {
     data.as || (data.as = "t");
   }
-  const options = args[1];
   if (options == null ? void 0 : options.only) {
     data.fromOnly = options.only;
   }
-  data.from = args[0];
+  data.from = arg;
+  return self;
+}
+function queryFromSql(self, args) {
+  const data = self.q;
+  data.as || (data.as = "t");
+  data.from = sqlQueryArgsToExpression(args);
   return self;
 }
 class From {
@@ -2143,13 +2143,6 @@ class From {
    * // accepts sub-query:
    * db.table.from(Otherdb.table.select('foo', 'bar'));
    *
-   * // accepts raw sql by template literal:
-   * const value = 123;
-   * db.table.from`value = ${value}`;
-   *
-   * // accepts raw sql:
-   * db.table.from(db.table.sql`value = ${value}`);
-   *
    * // accepts alias of `WITH` expression:
    * q.with('foo', Otherdb.table.select('id', 'name')).from('foo');
    * ```
@@ -2162,10 +2155,29 @@ class From {
    * });
    * ```
    *
-   * @param args - query, raw SQL, name of CTE table, or a template string
+   * @param arg - query or name of CTE table
+   * @param options - { only: true } for SQL `ONLY` keyword
    */
-  from(...args) {
+  from(arg, options) {
     return queryFrom(
+      this.clone(),
+      arg,
+      options
+    );
+  }
+  /**
+   * Set the `FROM` value with custom SQL:
+   *
+   * ```ts
+   * const value = 123;
+   * db.table.from`value = ${value}`;
+   * db.table.from(db.table.sql`value = ${value}`);
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  fromSql(...args) {
+    return queryFromSql(
       this.clone(),
       args
     );
@@ -2173,7 +2185,7 @@ class From {
 }
 
 function queryWrap(self, query, as = "t") {
-  return _queryAs(queryFrom(query, [self]), as);
+  return _queryAs(queryFrom(query, self), as);
 }
 
 function queryJson(self, coalesce) {
@@ -6165,12 +6177,6 @@ class Having {
    * // HAVING count(*) >= 10
    * ```
    *
-   * Alternatively, it accepts a raw SQL template:
-   *
-   * ```ts
-   * db.table.having`count(*) >= ${10}`;
-   * ```
-   *
    * Multiple having conditions will be combined with `AND`:
    *
    * ```ts
@@ -6216,11 +6222,23 @@ class Having {
     return pushQueryValue(
       q,
       "having",
-      "raw" in args[0] ? args : args.map(
+      args.map(
         (arg) => arg(q).q.expr
       )
     );
   }
+  /**
+   * Provide SQL expression for the `HAVING` SQL statement:
+   *
+   * ```ts
+   * db.table.having`count(*) >= ${10}`;
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  havingSql(...args) {
+    return pushQueryValue(this.clone(), "having", args);
+  }
 }
 
 const before = (q, key, cb) => pushQueryValue(q, `before${key}`, cb);
@@ -6473,29 +6491,29 @@ class QueryBase {
 }
 
 const _queryWhere = (q, args) => {
-  if (Array.isArray(args[0])) {
-    return pushQueryValue(
-      q,
-      "and",
-      new RawSQL(args)
-    );
-  }
   return pushQueryArray(
     q,
     "and",
     args
   );
 };
+const _queryWhereSql = (q, args) => {
+  return pushQueryValue(
+    q,
+    "and",
+    sqlQueryArgsToExpression(args)
+  );
+};
 const _queryWhereNot = (q, args) => {
-  if (Array.isArray(args[0])) {
-    return pushQueryValue(q, "and", {
-      NOT: new RawSQL(args)
-    });
-  }
   return pushQueryValue(q, "and", {
     NOT: args
   });
 };
+const _queryWhereNotSql = (q, args) => {
+  return pushQueryValue(q, "and", {
+    NOT: sqlQueryArgsToExpression(args)
+  });
+};
 const _queryOr = (q, args) => {
   return pushQueryArray(
     q,
@@ -6578,7 +6596,7 @@ class Where {
    *   },
    *
    *   // where column equals to raw SQL
-   *   column: db.table.sql`raw expression`,
+   *   column: db.table.sql`sql expression`,
    * });
    * ```
    *
@@ -6627,9 +6645,6 @@ class Where {
    * `where` supports raw SQL:
    *
    * ```ts
-   * db.table.where`a = b`;
-   *
-   * // or
    * db.table.where(db.table.sql`a = b`);
    *
    * // or
@@ -6954,6 +6969,29 @@ class Where {
       args
     );
   }
+  /**
+   * Use a custom SQL expression in `WHERE` statement:
+   *
+   * ```ts
+   * db.table.where`a = b`;
+   *
+   * // or
+   * db.table.where(db.table.sql`a = b`);
+   *
+   * // or
+   * import { raw } from 'orchid-orm';
+   *
+   * db.table.where(raw`a = b`);
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  whereSql(...args) {
+    return _queryWhereSql(
+      this.clone(),
+      args
+    );
+  }
   /**
    * `whereNot` takes the same argument as `where`,
    * multiple conditions are combined with `AND`,
@@ -6975,6 +7013,18 @@ class Where {
       args
     );
   }
+  /**
+   * `whereNot` version accepting SQL expression:
+   *
+   * ```ts
+   * db.table.whereNot`sql expression`
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  whereNotSql(...args) {
+    return _queryWhereNotSql(this.clone(), args);
+  }
   /**
    * `orWhere` is accepting the same arguments as {@link where}, joining arguments with `OR`.
    *
@@ -9012,12 +9062,10 @@ class Update {
    * @param args - raw SQL via a template string or by using a `sql` method
    */
   updateRaw(...args) {
-    const q = this.clone();
-    if (Array.isArray(args[0])) {
-      const sql = new RawSQL(args);
-      return _queryUpdateRaw(q, sql);
-    }
-    return _queryUpdateRaw(q, args[0]);
+    return _queryUpdateRaw(
+      this.clone(),
+      sqlQueryArgsToExpression(args)
+    );
   }
   /**
    * To make sure that at least one row was updated use `updateOrThrow`:
@@ -10059,7 +10107,7 @@ class QueryMethods {
    * The `find` method is available only for tables which has exactly one primary key.
    * And also it can accept raw SQL template literal, then the primary key is not required.
    *
-   * Find record by id, throw [NotFoundError](/guide/error-handling.html) if not found:
+   * Finds a record by id, throws {@link NotFoundError} if not found:
    *
    * ```ts
    * await db.table.find(1);
@@ -10072,13 +10120,9 @@ class QueryMethods {
    * `;
    * ```
    *
-   * @param args - primary key value to find by, or a raw SQL
+   * @param value - primary key value to find by
    */
-  find(...args) {
-    let [value] = args;
-    if (Array.isArray(value)) {
-      value = new RawSQL(args);
-    }
+  find(value) {
     const q = this.clone();
     if (value === null || value === void 0) {
       throw new OrchidOrmInternalError(
@@ -10095,22 +10139,54 @@ class QueryMethods {
     );
   }
   /**
-   * Find a single record by the primary key (id), adds `LIMIT 1`, can accept a raw SQL.
+   * Finds a single record with a given SQL, throws {@link NotFoundError} if not found:
+   *
+   * ```ts
+   * await db.user.find`
+   *   age = ${age} AND
+   *   name = ${name}
+   * `;
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  findBySql(...args) {
+    const q = this.clone();
+    return _queryTake(_queryWhereSql(q, args));
+  }
+  /**
+   * Find a single record by the primary key (id), adds `LIMIT 1`.
    * Returns `undefined` when not found.
    *
    * ```ts
    * const result: TableType | undefined = await db.table.find(123);
    * ```
    *
-   * @param args - primary key value to find by, or a raw SQL
+   * @param value - primary key value to find by, or a raw SQL
    */
-  findOptional(...args) {
+  findOptional(value) {
+    return _queryTakeOptional(this.find(value));
+  }
+  /**
+   * Finds a single record with a given SQL.
+   * Returns `undefined` when not found.
+   *
+   * ```ts
+   * await db.user.find`
+   *   age = ${age} AND
+   *   name = ${name}
+   * `;
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  findBySqlOptional(...args) {
     return _queryTakeOptional(
-      this.find(...args)
+      this.findBySql(...args)
     );
   }
   /**
-   * The same as `where(conditions).take()`, it will filter records and add a `LIMIT 1`.
+   * The same as `where(conditions).take()`, takes the same arguments as {@link Where.where}, it will filter records and add a `LIMIT 1`.
    * Throws `NotFoundError` if not found.
    *
    * ```ts
@@ -10244,7 +10320,7 @@ class QueryMethods {
   /**
    * Adds an order by clause to the query.
    *
-   * Takes one or more arguments, each argument can be a column name, an object, or a raw expression.
+   * Takes one or more arguments, each argument can be a column name or an object.
    *
    * ```ts
    * db.table.order('id', 'name'); // ASC by default
@@ -10256,11 +10332,6 @@ class QueryMethods {
    *   name: 'ASC NULLS FIRST',
    *   age: 'DESC NULLS LAST',
    * });
-   *
-   * // order by raw SQL expression:
-   * db.table.order`raw sql`;
-   * // or
-   * db.table.order(db.table.sql`raw sql`);
    * ```
    *
    * `order` can refer to the values returned from `select` sub-queries (unlike `where` which cannot).
@@ -10279,22 +10350,35 @@ class QueryMethods {
    *   });
    * ```
    *
-   * @param args - column name(s), raw SQL, or an object with column names and sort directions.
+   * @param args - column name(s) or an object with column names and sort directions.
    */
   order(...args) {
-    if (Array.isArray(args[0])) {
-      return pushQueryValue(
-        this.clone(),
-        "order",
-        new RawSQL(args)
-      );
-    }
     return pushQueryArray(
       this.clone(),
       "order",
       args
     );
   }
+  /**
+   * Order by SQL expression
+   *
+   * Order by raw SQL expression.
+   *
+   * ```ts
+   * db.table.order`raw sql`;
+   * // or
+   * db.table.order(db.table.sql`raw sql`);
+   * ```
+   *
+   * @param args - SQL expression
+   */
+  orderSql(...args) {
+    return pushQueryValue(
+      this.clone(),
+      "order",
+      sqlQueryArgsToExpression(args)
+    );
+  }
   /**
    * Adds a limit clause to the query.
    *
@@ -10990,5 +11074,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, FnExpression, For, From, Having, InetColumn, IntegerBaseColumn, IntegerColumn, IntervalColumn, JSONColumn, JSONTextColumn, Join, JsonMethods, JsonModifiers, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, OnConflictQueryBuilder, OnQueryBuilder, Operators, OrchidOrmError, OrchidOrmInternalError, PathColumn, PointColumn, PolygonColumn, QueryBase, QueryError, QueryGet, QueryHooks, QueryLog, QueryMethods, QueryUpsertOrCreate, RawSQL, RawSqlMethods, RealColumn, SearchMethods, Select, SerialColumn, SmallIntColumn, SmallSerialColumn, StringColumn, TextBaseColumn, TextColumn, Then, TimeColumn, TimestampColumn, TimestampTZColumn, Transaction, TransactionAdapter, TransformMethods, TsQueryColumn, TsVectorColumn, UUIDColumn, UnhandledTypeError, Union, UnknownColumn, Update, VarCharColumn, VirtualColumn, Where, WhereQueryBase, With, XMLColumn, _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, _queryUpdate, _queryUpdateOrThrow, _queryUpdateRaw, _queryWhere, _queryWhereIn, _queryWhereNot, addComputedColumns, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, checkIfASimpleQuery, cloneQuery, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, constraintPropsToCode, constraintToCode, copyTableData, countSelect, createDb, defaultSchemaConfig, extendQuery, foreignKeyArgumentToCode, getClonedQueryData, getColumnInfo, getColumnTypes, getConstraintKind, getQueryAs, getShapeFromSelect, getTableData, handleResult, identityToCode, indexToCode, instantiateColumn, isQueryReturnsAll, isSelectingCount, joinSubQuery, logColors, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeExpression, makeFnExpression, makeRegexToFindInSql, makeSQL, newTableData, parseRecord, parseResult, primaryKeyToCode, processSelectArg, pushLimitSQL, pushQueryArray, pushQueryOn, pushQueryOrOn, pushQueryValue, queryFrom, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, quote, quoteString, raw, referencesArgsToCode, resetTableData, resolveSubQueryCallback, saveSearchAlias, setParserForSelectedString, setQueryObjectValue, setQueryOperators, simplifyColumnDefault, 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, FnExpression, For, From, Having, InetColumn, IntegerBaseColumn, IntegerColumn, IntervalColumn, JSONColumn, JSONTextColumn, Join, JsonMethods, JsonModifiers, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, MergeQueryMethods, MoneyColumn, MoreThanOneRowError, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, OnConflictQueryBuilder, OnQueryBuilder, Operators, OrchidOrmError, OrchidOrmInternalError, PathColumn, PointColumn, PolygonColumn, QueryBase, QueryError, QueryGet, QueryHooks, QueryLog, QueryMethods, QueryUpsertOrCreate, RawSQL, RawSqlMethods, RealColumn, SearchMethods, Select, SerialColumn, SmallIntColumn, SmallSerialColumn, StringColumn, TextBaseColumn, TextColumn, Then, TimeColumn, TimestampColumn, TimestampTZColumn, Transaction, TransactionAdapter, TransformMethods, TsQueryColumn, TsVectorColumn, UUIDColumn, UnhandledTypeError, Union, UnknownColumn, Update, VarCharColumn, VirtualColumn, Where, WhereQueryBase, With, XMLColumn, _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, _queryUpdate, _queryUpdateOrThrow, _queryUpdateRaw, _queryWhere, _queryWhereIn, _queryWhereNot, _queryWhereNotSql, _queryWhereSql, addComputedColumns, addParserForRawExpression, addParserForSelectItem, addQueryOn, anyShape, checkIfASimpleQuery, cloneQuery, columnCheckToCode, columnCode, columnForeignKeysToCode, columnIndexesToCode, columnsShapeToCode, constraintPropsToCode, constraintToCode, copyTableData, countSelect, createDb, defaultSchemaConfig, extendQuery, foreignKeyArgumentToCode, getClonedQueryData, getColumnInfo, getColumnTypes, getConstraintKind, getQueryAs, getShapeFromSelect, getTableData, handleResult, identityToCode, indexToCode, instantiateColumn, isQueryReturnsAll, isSelectingCount, joinSubQuery, logColors, logParamToLogObject, makeColumnTypes, makeColumnsByType, makeExpression, makeFnExpression, makeRegexToFindInSql, makeSQL, newTableData, parseRecord, parseResult, primaryKeyToCode, processSelectArg, pushLimitSQL, pushQueryArray, pushQueryOn, pushQueryOrOn, pushQueryValue, queryFrom, queryFromSql, queryJson, queryMethodByReturnType, queryTypeWithLimitOne, queryWrap, quote, quoteString, raw, referencesArgsToCode, resetTableData, resolveSubQueryCallback, saveSearchAlias, setParserForSelectedString, setQueryObjectValue, setQueryOperators, simplifyColumnDefault, sqlQueryArgsToExpression, templateLiteralToSQL, testTransaction, throwIfNoWhere, toSQL, toSQLCacheKey };
 //# sourceMappingURL=index.mjs.map