pqb 0.40.2 → 0.40.3

package/dist/index.mjs

@@ -11157,7 +11157,7 @@ class QueryUpsertOrCreate {
    *
    * ```ts
    * await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     data: {
    *       // update record's name
@@ -11171,7 +11171,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',
@@ -11188,7 +11188,7 @@ class QueryUpsertOrCreate {
    *
    * ```ts
    * await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     update: {
    *       name: 'updated user',
@@ -11201,7 +11201,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',
@@ -11218,7 +11218,7 @@ class QueryUpsertOrCreate {
    *
    * ```ts
    * const user = await User.selectAll()
-   *   .find({ email: 'some@email.com' })
+   *   .findBy({ email: 'some@email.com' })
    *   .upsert({
    *     data: {
    *       name: 'updated user',
@@ -11258,17 +11258,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',
@@ -11369,11 +11371,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