bigal 15.7.0 → 15.8.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [15.8.0](https://github.com/bigalorm/bigal/compare/v15.7.0...v15.8.0) (2026-01-24)
+
+### Features
+
+- Support .toJSON for create, update, and delete calls ([#284](https://github.com/bigalorm/bigal/issues/284)) ([d74c6f0](https://github.com/bigalorm/bigal/commit/d74c6f07a036b44cf43cdcce9224c3b256dbb3dc))
+
 # [15.7.0](https://github.com/bigalorm/bigal/compare/v15.6.0...v15.7.0) (2026-01-19)
 
 ### Features

package/dist/index.cjs

@@ -3108,21 +3108,12 @@ class Repository extends ReadonlyRepository {
    * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
    * @returns {object|object[]|void} Return value from the db
    */
-  async create(values, options) {
+  create(values, options) {
     if (this.model.readonly) {
       throw new Error(`${this.model.name} is readonly.`);
     }
-    if (Array.isArray(values) && !values.length) {
-      return [];
-    }
-    const beforeCreate = this._type.beforeCreate;
-    if (beforeCreate) {
-      if (Array.isArray(values)) {
-        values = await Promise.all(values.map(async (value) => beforeCreate(value)));
-      } else {
-        values = await beforeCreate(values);
-      }
-    }
+    const modelInstance = this;
+    const isArray = Array.isArray(values);
     let returnRecords = true;
     let returnSelect;
     if (options) {
@@ -3132,26 +3123,56 @@ class Repository extends ReadonlyRepository {
         returnSelect = options.returnSelect;
       }
     }
-    const { query, params } = getInsertQueryAndParams({
-      repositoriesByModelNameLowered: this._repositoriesByModelNameLowered,
-      model: this.model,
-      values,
-      returnRecords,
-      returnSelect,
-      onConflict: options?.onConflict
-    });
-    const results = await this._pool.query(query, params);
-    if (returnRecords) {
-      if (Array.isArray(values)) {
-        return this._buildInstances(results.rows);
-      }
-      const firstResult = results.rows[0];
-      if (firstResult) {
-        return this._buildInstance(firstResult);
+    let returnAsPlainObjects = false;
+    const result = {
+      toJSON() {
+        returnAsPlainObjects = true;
+        return result;
+      },
+      async then(resolve, reject) {
+        try {
+          if (isArray && !values.length) {
+            return resolve ? await resolve([]) : [];
+          }
+          const beforeCreate = modelInstance._type.beforeCreate;
+          if (beforeCreate) {
+            if (isArray) {
+              values = await Promise.all(values.map(async (value) => beforeCreate(value)));
+            } else {
+              values = await beforeCreate(values);
+            }
+          }
+          const { query, params } = getInsertQueryAndParams({
+            repositoriesByModelNameLowered: modelInstance._repositoriesByModelNameLowered,
+            model: modelInstance.model,
+            values,
+            returnRecords,
+            returnSelect,
+            onConflict: options?.onConflict
+          });
+          const results = await modelInstance._pool.query(query, params);
+          if (returnRecords) {
+            if (isArray) {
+              const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(results.rows) : modelInstance._buildInstances(results.rows);
+              return resolve ? await resolve(entities) : entities;
+            }
+            const firstResult = results.rows[0];
+            if (firstResult) {
+              const entity = returnAsPlainObjects ? modelInstance._buildPlainObject(firstResult) : modelInstance._buildInstance(firstResult);
+              return resolve ? await resolve(entity) : entity;
+            }
+            throw new Error("Unknown error getting created rows back from the database");
+          }
+          return resolve ? await resolve(void 0) : void 0;
+        } catch (ex) {
+          if (reject) {
+            return reject(ex);
+          }
+          throw ex;
+        }
       }
-      throw new Error("Unknown error getting created rows back from the database");
-    }
-    return void 0;
+    };
+    return result;
   }
   /**
    * Updates object(s) matching the where query, with the specified values
@@ -3162,16 +3183,14 @@ class Repository extends ReadonlyRepository {
    * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
    * @returns {object[]|void} Return values from the db or `true` if returnRecords=false
    */
-  async update(where, values, options) {
+  update(where, values, options) {
     if (this.model.readonly) {
       throw new Error(`${this.model.name} is readonly.`);
     }
     if (typeof where === "string") {
       throw new Error("The query cannot be a string, it must be an object");
     }
-    if (this._type.beforeUpdate) {
-      values = await this._type.beforeUpdate(values);
-    }
+    const modelInstance = this;
     let returnRecords = true;
     let returnSelect;
     if (options) {
@@ -3181,19 +3200,40 @@ class Repository extends ReadonlyRepository {
         returnSelect = options.returnSelect;
       }
     }
-    const { query, params } = getUpdateQueryAndParams({
-      repositoriesByModelNameLowered: this._repositoriesByModelNameLowered,
-      model: this.model,
-      where,
-      values,
-      returnRecords,
-      returnSelect
-    });
-    const results = await this._pool.query(query, params);
-    if (returnRecords) {
-      return this._buildInstances(results.rows);
-    }
-    return void 0;
+    let returnAsPlainObjects = false;
+    const result = {
+      toJSON() {
+        returnAsPlainObjects = true;
+        return result;
+      },
+      async then(resolve, reject) {
+        try {
+          if (modelInstance._type.beforeUpdate) {
+            values = await modelInstance._type.beforeUpdate(values);
+          }
+          const { query, params } = getUpdateQueryAndParams({
+            repositoriesByModelNameLowered: modelInstance._repositoriesByModelNameLowered,
+            model: modelInstance.model,
+            where,
+            values,
+            returnRecords,
+            returnSelect
+          });
+          const results = await modelInstance._pool.query(query, params);
+          if (returnRecords) {
+            const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(results.rows) : modelInstance._buildInstances(results.rows);
+            return resolve ? await resolve(entities) : entities;
+          }
+          return resolve ? await resolve(void 0) : void 0;
+        } catch (ex) {
+          if (reject) {
+            return reject(ex);
+          }
+          throw ex;
+        }
+      }
+    };
+    return result;
   }
   /**
    * Destroys object(s) matching the where query
@@ -3211,15 +3251,15 @@ class Repository extends ReadonlyRepository {
     const modelInstance = this;
     const returnSelect = options?.returnSelect;
     const returnRecords = options?.returnRecords ?? !!returnSelect;
-    return {
-      /**
-       * Filters the query
-       * @param {object} value - Object representing the where query
-       * @returns Query instance
-       */
+    let returnAsPlainObjects = false;
+    const result = {
       where(value) {
         where = value;
-        return this;
+        return result;
+      },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return result;
       },
       async then(resolve, reject) {
         if (typeof where === "string") {
@@ -3233,9 +3273,10 @@ class Repository extends ReadonlyRepository {
             returnRecords,
             returnSelect
           });
-          const result = await modelInstance._pool.query(query, params);
+          const queryResult = await modelInstance._pool.query(query, params);
           if (returnRecords) {
-            return await resolve(modelInstance._buildInstances(result.rows));
+            const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(queryResult.rows) : modelInstance._buildInstances(queryResult.rows);
+            return await resolve(entities);
           }
           return await resolve();
         } catch (ex) {
@@ -3251,6 +3292,7 @@ ${stack}`;
         }
       }
     };
+    return result;
   }
 }
 

package/dist/index.d.cts

@@ -466,6 +466,47 @@ interface CountResult<TEntity extends Entity> extends PromiseLike<number> {
     where(args: WhereQuery<TEntity>): CountResult<TEntity> | number;
 }
 
+/**
+ * Result of a create operation that returns a plain object (after calling toJSON())
+ */
+interface CreateResultJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultJSON<T>;
+}
+/**
+ * Result of a create operation that returns multiple plain objects (after calling toJSON())
+ */
+interface CreateResultArrayJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultArrayJSON<T>;
+}
+/**
+ * Result of a create operation that returns a single record
+ */
+interface CreateResult<T extends Entity> extends PromiseLike<QueryResult<T>> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultJSON<T>;
+}
+/**
+ * Result of a create operation that returns multiple records
+ */
+interface CreateResultArray<T extends Entity> extends PromiseLike<QueryResult<T>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultArrayJSON<T>;
+}
+
 declare class ScalarSubquery<TValue> {
     private readonly _resultType;
     readonly _aggregate: 'avg' | 'count' | 'max' | 'min' | 'sum';
@@ -654,9 +695,50 @@ interface ReturnRecords<T extends Entity, K extends keyof T> {
 }
 type DeleteOptions<T extends Entity, K extends keyof T = keyof T> = ReturnRecords<T, K> | ReturnSelect<T, K>;
 
+/**
+ * Result of a destroy operation that returns plain objects (after calling toJSON())
+ */
+interface DestroyResultJSON<TEntity extends Entity, TReturn> extends PromiseLike<PlainObject<TReturn>[]> {
+    where(args: WhereQuery<TEntity>): DestroyResultJSON<TEntity, TReturn>;
+}
+/**
+ * Result of a destroy operation that does not return records
+ */
 interface DestroyResult<TEntity extends Entity, TReturn> extends PromiseLike<TReturn> {
     where(args: WhereQuery<TEntity>): DestroyResult<TEntity, TReturn>;
 }
+/**
+ * Result of a destroy operation that returns records (includes toJSON method)
+ */
+interface DestroyResultWithRecords<TEntity extends Entity, TReturn> extends PromiseLike<TReturn[]> {
+    where(args: WhereQuery<TEntity>): DestroyResultWithRecords<TEntity, TReturn>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): DestroyResultJSON<TEntity, TReturn>;
+}
+
+/**
+ * Result of an update operation that returns plain objects (after calling toJSON())
+ */
+interface UpdateResultJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): UpdateResultJSON<T>;
+}
+/**
+ * Result of an update operation that returns records
+ */
+interface UpdateResult<T extends Entity> extends PromiseLike<QueryResult<T>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): UpdateResultJSON<T>;
+}
 
 interface FindOneArgs<T extends Entity, K extends keyof T = string & keyof OmitFunctions<OmitEntityCollections<T>> & keyof T> {
     select?: (K & string & keyof OmitFunctions<OmitEntityCollections<T>>)[];
@@ -795,7 +877,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object}
      */
-    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>>;
+    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResult<T>;
     /**
      * Creates an object or objects using the specified values
      * @param {object|object[]} values - Values to insert as multiple new objects.
@@ -813,7 +895,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>[]>;
+    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResultArray<T>;
     /**
      * Creates an object using the specified values
      * @param {object|object[]} values - Values to insert as a new object. If an array is specified, multiple rows will be inserted
@@ -823,7 +905,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object|object[]|void} Return value from the db
      */
-    create(values: CreateUpdateParams<T> | CreateUpdateParams<T>[], options?: CreateOptions<T>): Promise<QueryResult<T>[]> | Promise<QueryResult<T>> | Promise<void>;
+    create(values: CreateUpdateParams<T> | CreateUpdateParams<T>[], options?: CreateOptions<T>): CreateResult<T> | CreateResultArray<T> | Promise<void>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -842,7 +924,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): Promise<QueryResult<T>[]>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): UpdateResult<T>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -852,7 +934,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]|void} Return values from the db or `true` if returnRecords=false
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: CreateUpdateOptions<T>): Promise<QueryResult<T>[]> | Promise<void>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: CreateUpdateOptions<T>): Promise<void> | UpdateResult<T>;
     /**
      * Destroys object(s) matching the where query
      * @param {object} [where] - Object representing the where query
@@ -867,16 +949,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResult<T, QueryResult<T>[]>;
-    /**
-     * Destroys object(s) matching the where query
-     * @param {object} where - Object representing the where query
-     * @param {object} [options]
-     * @param {boolean} [options.returnRecords=false] - Determines if inserted records should be returned
-     * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
-     * @returns {object[]|void} `void` or records affected if returnRecords=true
-     */
-    destroy<TOptions extends DeleteOptions<T> = DeleteOptions<T>>(where: WhereQuery<T>, options?: TOptions): TOptions extends DeleteOptions<T> ? Promise<void> : DestroyResult<T, QueryResult<T>[]>;
+    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResultWithRecords<T, QueryResult<T>>;
 }
 
 declare function subquery<T extends Entity>(repository: IReadonlyRepository<T> | IRepository<T>): SubqueryBuilder<T>;
@@ -1017,7 +1090,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object}
      */
-    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>>;
+    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResult<T>;
     /**
      * Creates an object or objects using the specified values
      * @param {object|object[]} values - Values to insert as multiple new objects.
@@ -1035,7 +1108,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>[]>;
+    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResultArray<T>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -1053,7 +1126,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): Promise<QueryResult<T>[]>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): UpdateResult<T>;
     /**
      * Destroys object(s) matching the where query
      * @param {object} [where] - Object representing the where query
@@ -1068,7 +1141,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResult<T, QueryResult<T>[]>;
+    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResultWithRecords<T, QueryResult<T>>;
 }
 
 interface ColumnBaseOptions {
@@ -1198,4 +1271,4 @@ interface InitializeOptions extends IConnection {
 declare function initialize({ models, pool, readonlyPool, connections, expose }: InitializeOptions): Record<string, IReadonlyRepository<Entity> | IRepository<Entity>>;
 
 export { ColumnBaseMetadata, ColumnCollectionMetadata, ColumnModelMetadata, ColumnTypeMetadata, Entity, ModelMetadata, QueryError, ReadonlyRepository, Repository, ScalarSubquery, SelectBuilder, SubqueryBuilder, column, createDateColumn, getMetadataStorage, initialize, isSubqueryJoin, primaryColumn, subquery, table, updateDateColumn, versionColumn };
-export type { AggregateBuilder, ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindOneResultJSON, FindQueryWithCount, FindQueryWithCountJSON, FindResult, FindResultJSON, FindWithCountResult, GetValueType, HavingComparer, HavingCondition, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, JsonConstraint, LiteralValues, ModelJoinDefinition, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PlainObject, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, SelectAggregateExpression, SelectItem, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, SubqueryJoinDefinition, SubqueryJoinOnCondition, WhereClauseValue, WhereQuery, WhereQueryStatement };
+export type { AggregateBuilder, ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateResult, CreateResultArray, CreateResultArrayJSON, CreateResultJSON, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DestroyResultJSON, DestroyResultWithRecords, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindOneResultJSON, FindQueryWithCount, FindQueryWithCountJSON, FindResult, FindResultJSON, FindWithCountResult, GetValueType, HavingComparer, HavingCondition, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, JsonConstraint, LiteralValues, ModelJoinDefinition, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PlainObject, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, SelectAggregateExpression, SelectItem, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, SubqueryJoinDefinition, SubqueryJoinOnCondition, UpdateResult, UpdateResultJSON, WhereClauseValue, WhereQuery, WhereQueryStatement };

package/dist/index.d.mts

@@ -466,6 +466,47 @@ interface CountResult<TEntity extends Entity> extends PromiseLike<number> {
     where(args: WhereQuery<TEntity>): CountResult<TEntity> | number;
 }
 
+/**
+ * Result of a create operation that returns a plain object (after calling toJSON())
+ */
+interface CreateResultJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultJSON<T>;
+}
+/**
+ * Result of a create operation that returns multiple plain objects (after calling toJSON())
+ */
+interface CreateResultArrayJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultArrayJSON<T>;
+}
+/**
+ * Result of a create operation that returns a single record
+ */
+interface CreateResult<T extends Entity> extends PromiseLike<QueryResult<T>> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultJSON<T>;
+}
+/**
+ * Result of a create operation that returns multiple records
+ */
+interface CreateResultArray<T extends Entity> extends PromiseLike<QueryResult<T>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultArrayJSON<T>;
+}
+
 declare class ScalarSubquery<TValue> {
     private readonly _resultType;
     readonly _aggregate: 'avg' | 'count' | 'max' | 'min' | 'sum';
@@ -654,9 +695,50 @@ interface ReturnRecords<T extends Entity, K extends keyof T> {
 }
 type DeleteOptions<T extends Entity, K extends keyof T = keyof T> = ReturnRecords<T, K> | ReturnSelect<T, K>;
 
+/**
+ * Result of a destroy operation that returns plain objects (after calling toJSON())
+ */
+interface DestroyResultJSON<TEntity extends Entity, TReturn> extends PromiseLike<PlainObject<TReturn>[]> {
+    where(args: WhereQuery<TEntity>): DestroyResultJSON<TEntity, TReturn>;
+}
+/**
+ * Result of a destroy operation that does not return records
+ */
 interface DestroyResult<TEntity extends Entity, TReturn> extends PromiseLike<TReturn> {
     where(args: WhereQuery<TEntity>): DestroyResult<TEntity, TReturn>;
 }
+/**
+ * Result of a destroy operation that returns records (includes toJSON method)
+ */
+interface DestroyResultWithRecords<TEntity extends Entity, TReturn> extends PromiseLike<TReturn[]> {
+    where(args: WhereQuery<TEntity>): DestroyResultWithRecords<TEntity, TReturn>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): DestroyResultJSON<TEntity, TReturn>;
+}
+
+/**
+ * Result of an update operation that returns plain objects (after calling toJSON())
+ */
+interface UpdateResultJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): UpdateResultJSON<T>;
+}
+/**
+ * Result of an update operation that returns records
+ */
+interface UpdateResult<T extends Entity> extends PromiseLike<QueryResult<T>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): UpdateResultJSON<T>;
+}
 
 interface FindOneArgs<T extends Entity, K extends keyof T = string & keyof OmitFunctions<OmitEntityCollections<T>> & keyof T> {
     select?: (K & string & keyof OmitFunctions<OmitEntityCollections<T>>)[];
@@ -795,7 +877,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object}
      */
-    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>>;
+    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResult<T>;
     /**
      * Creates an object or objects using the specified values
      * @param {object|object[]} values - Values to insert as multiple new objects.
@@ -813,7 +895,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>[]>;
+    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResultArray<T>;
     /**
      * Creates an object using the specified values
      * @param {object|object[]} values - Values to insert as a new object. If an array is specified, multiple rows will be inserted
@@ -823,7 +905,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object|object[]|void} Return value from the db
      */
-    create(values: CreateUpdateParams<T> | CreateUpdateParams<T>[], options?: CreateOptions<T>): Promise<QueryResult<T>[]> | Promise<QueryResult<T>> | Promise<void>;
+    create(values: CreateUpdateParams<T> | CreateUpdateParams<T>[], options?: CreateOptions<T>): CreateResult<T> | CreateResultArray<T> | Promise<void>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -842,7 +924,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): Promise<QueryResult<T>[]>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): UpdateResult<T>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -852,7 +934,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]|void} Return values from the db or `true` if returnRecords=false
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: CreateUpdateOptions<T>): Promise<QueryResult<T>[]> | Promise<void>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: CreateUpdateOptions<T>): Promise<void> | UpdateResult<T>;
     /**
      * Destroys object(s) matching the where query
      * @param {object} [where] - Object representing the where query
@@ -867,16 +949,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResult<T, QueryResult<T>[]>;
-    /**
-     * Destroys object(s) matching the where query
-     * @param {object} where - Object representing the where query
-     * @param {object} [options]
-     * @param {boolean} [options.returnRecords=false] - Determines if inserted records should be returned
-     * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
-     * @returns {object[]|void} `void` or records affected if returnRecords=true
-     */
-    destroy<TOptions extends DeleteOptions<T> = DeleteOptions<T>>(where: WhereQuery<T>, options?: TOptions): TOptions extends DeleteOptions<T> ? Promise<void> : DestroyResult<T, QueryResult<T>[]>;
+    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResultWithRecords<T, QueryResult<T>>;
 }
 
 declare function subquery<T extends Entity>(repository: IReadonlyRepository<T> | IRepository<T>): SubqueryBuilder<T>;
@@ -1017,7 +1090,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object}
      */
-    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>>;
+    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResult<T>;
     /**
      * Creates an object or objects using the specified values
      * @param {object|object[]} values - Values to insert as multiple new objects.
@@ -1035,7 +1108,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>[]>;
+    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResultArray<T>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -1053,7 +1126,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): Promise<QueryResult<T>[]>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): UpdateResult<T>;
     /**
      * Destroys object(s) matching the where query
      * @param {object} [where] - Object representing the where query
@@ -1068,7 +1141,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResult<T, QueryResult<T>[]>;
+    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResultWithRecords<T, QueryResult<T>>;
 }
 
 interface ColumnBaseOptions {
@@ -1198,4 +1271,4 @@ interface InitializeOptions extends IConnection {
 declare function initialize({ models, pool, readonlyPool, connections, expose }: InitializeOptions): Record<string, IReadonlyRepository<Entity> | IRepository<Entity>>;
 
 export { ColumnBaseMetadata, ColumnCollectionMetadata, ColumnModelMetadata, ColumnTypeMetadata, Entity, ModelMetadata, QueryError, ReadonlyRepository, Repository, ScalarSubquery, SelectBuilder, SubqueryBuilder, column, createDateColumn, getMetadataStorage, initialize, isSubqueryJoin, primaryColumn, subquery, table, updateDateColumn, versionColumn };
-export type { AggregateBuilder, ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindOneResultJSON, FindQueryWithCount, FindQueryWithCountJSON, FindResult, FindResultJSON, FindWithCountResult, GetValueType, HavingComparer, HavingCondition, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, JsonConstraint, LiteralValues, ModelJoinDefinition, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PlainObject, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, SelectAggregateExpression, SelectItem, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, SubqueryJoinDefinition, SubqueryJoinOnCondition, WhereClauseValue, WhereQuery, WhereQueryStatement };
+export type { AggregateBuilder, ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateResult, CreateResultArray, CreateResultArrayJSON, CreateResultJSON, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DestroyResultJSON, DestroyResultWithRecords, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindOneResultJSON, FindQueryWithCount, FindQueryWithCountJSON, FindResult, FindResultJSON, FindWithCountResult, GetValueType, HavingComparer, HavingCondition, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, JsonConstraint, LiteralValues, ModelJoinDefinition, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PlainObject, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, SelectAggregateExpression, SelectItem, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, SubqueryJoinDefinition, SubqueryJoinOnCondition, UpdateResult, UpdateResultJSON, WhereClauseValue, WhereQuery, WhereQueryStatement };

package/dist/index.d.ts

@@ -466,6 +466,47 @@ interface CountResult<TEntity extends Entity> extends PromiseLike<number> {
     where(args: WhereQuery<TEntity>): CountResult<TEntity> | number;
 }
 
+/**
+ * Result of a create operation that returns a plain object (after calling toJSON())
+ */
+interface CreateResultJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultJSON<T>;
+}
+/**
+ * Result of a create operation that returns multiple plain objects (after calling toJSON())
+ */
+interface CreateResultArrayJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultArrayJSON<T>;
+}
+/**
+ * Result of a create operation that returns a single record
+ */
+interface CreateResult<T extends Entity> extends PromiseLike<QueryResult<T>> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultJSON<T>;
+}
+/**
+ * Result of a create operation that returns multiple records
+ */
+interface CreateResultArray<T extends Entity> extends PromiseLike<QueryResult<T>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): CreateResultArrayJSON<T>;
+}
+
 declare class ScalarSubquery<TValue> {
     private readonly _resultType;
     readonly _aggregate: 'avg' | 'count' | 'max' | 'min' | 'sum';
@@ -654,9 +695,50 @@ interface ReturnRecords<T extends Entity, K extends keyof T> {
 }
 type DeleteOptions<T extends Entity, K extends keyof T = keyof T> = ReturnRecords<T, K> | ReturnSelect<T, K>;
 
+/**
+ * Result of a destroy operation that returns plain objects (after calling toJSON())
+ */
+interface DestroyResultJSON<TEntity extends Entity, TReturn> extends PromiseLike<PlainObject<TReturn>[]> {
+    where(args: WhereQuery<TEntity>): DestroyResultJSON<TEntity, TReturn>;
+}
+/**
+ * Result of a destroy operation that does not return records
+ */
 interface DestroyResult<TEntity extends Entity, TReturn> extends PromiseLike<TReturn> {
     where(args: WhereQuery<TEntity>): DestroyResult<TEntity, TReturn>;
 }
+/**
+ * Result of a destroy operation that returns records (includes toJSON method)
+ */
+interface DestroyResultWithRecords<TEntity extends Entity, TReturn> extends PromiseLike<TReturn[]> {
+    where(args: WhereQuery<TEntity>): DestroyResultWithRecords<TEntity, TReturn>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): DestroyResultJSON<TEntity, TReturn>;
+}
+
+/**
+ * Result of an update operation that returns plain objects (after calling toJSON())
+ */
+interface UpdateResultJSON<T extends Entity> extends PromiseLike<PlainObject<QueryResult<T>>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): UpdateResultJSON<T>;
+}
+/**
+ * Result of an update operation that returns records
+ */
+interface UpdateResult<T extends Entity> extends PromiseLike<QueryResult<T>[]> {
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): UpdateResultJSON<T>;
+}
 
 interface FindOneArgs<T extends Entity, K extends keyof T = string & keyof OmitFunctions<OmitEntityCollections<T>> & keyof T> {
     select?: (K & string & keyof OmitFunctions<OmitEntityCollections<T>>)[];
@@ -795,7 +877,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object}
      */
-    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>>;
+    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResult<T>;
     /**
      * Creates an object or objects using the specified values
      * @param {object|object[]} values - Values to insert as multiple new objects.
@@ -813,7 +895,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>[]>;
+    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResultArray<T>;
     /**
      * Creates an object using the specified values
      * @param {object|object[]} values - Values to insert as a new object. If an array is specified, multiple rows will be inserted
@@ -823,7 +905,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object|object[]|void} Return value from the db
      */
-    create(values: CreateUpdateParams<T> | CreateUpdateParams<T>[], options?: CreateOptions<T>): Promise<QueryResult<T>[]> | Promise<QueryResult<T>> | Promise<void>;
+    create(values: CreateUpdateParams<T> | CreateUpdateParams<T>[], options?: CreateOptions<T>): CreateResult<T> | CreateResultArray<T> | Promise<void>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -842,7 +924,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): Promise<QueryResult<T>[]>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): UpdateResult<T>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -852,7 +934,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]|void} Return values from the db or `true` if returnRecords=false
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: CreateUpdateOptions<T>): Promise<QueryResult<T>[]> | Promise<void>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: CreateUpdateOptions<T>): Promise<void> | UpdateResult<T>;
     /**
      * Destroys object(s) matching the where query
      * @param {object} [where] - Object representing the where query
@@ -867,16 +949,7 @@ interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResult<T, QueryResult<T>[]>;
-    /**
-     * Destroys object(s) matching the where query
-     * @param {object} where - Object representing the where query
-     * @param {object} [options]
-     * @param {boolean} [options.returnRecords=false] - Determines if inserted records should be returned
-     * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
-     * @returns {object[]|void} `void` or records affected if returnRecords=true
-     */
-    destroy<TOptions extends DeleteOptions<T> = DeleteOptions<T>>(where: WhereQuery<T>, options?: TOptions): TOptions extends DeleteOptions<T> ? Promise<void> : DestroyResult<T, QueryResult<T>[]>;
+    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResultWithRecords<T, QueryResult<T>>;
 }
 
 declare function subquery<T extends Entity>(repository: IReadonlyRepository<T> | IRepository<T>): SubqueryBuilder<T>;
@@ -1017,7 +1090,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
      * @returns {object}
      */
-    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>>;
+    create(values: CreateUpdateParams<T>, options?: OnConflictOptions<T> | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResult<T>;
     /**
      * Creates an object or objects using the specified values
      * @param {object|object[]} values - Values to insert as multiple new objects.
@@ -1035,7 +1108,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): Promise<QueryResult<T>[]>;
+    create(values: CreateUpdateParams<T>[], options?: (OnConflictOptions<T> & Partial<ReturnSelect$1<T>>) | (Partial<OnConflictOptions<T>> & ReturnSelect$1<T>)): CreateResultArray<T>;
     /**
      * Updates object(s) matching the where query, with the specified values
      * @param {object} where - Object representing the where query
@@ -1053,7 +1126,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): Promise<QueryResult<T>[]>;
+    update(where: WhereQuery<T>, values: CreateUpdateParams<T>, options?: ReturnSelect$1<T>): UpdateResult<T>;
     /**
      * Destroys object(s) matching the where query
      * @param {object} [where] - Object representing the where query
@@ -1068,7 +1141,7 @@ declare class Repository<T extends Entity> extends ReadonlyRepository<T> impleme
      * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
      * @returns {object[]}
      */
-    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResult<T, QueryResult<T>[]>;
+    destroy(where: WhereQuery<T>, options: DeleteOptions<T>): DestroyResultWithRecords<T, QueryResult<T>>;
 }
 
 interface ColumnBaseOptions {
@@ -1198,4 +1271,4 @@ interface InitializeOptions extends IConnection {
 declare function initialize({ models, pool, readonlyPool, connections, expose }: InitializeOptions): Record<string, IReadonlyRepository<Entity> | IRepository<Entity>>;
 
 export { ColumnBaseMetadata, ColumnCollectionMetadata, ColumnModelMetadata, ColumnTypeMetadata, Entity, ModelMetadata, QueryError, ReadonlyRepository, Repository, ScalarSubquery, SelectBuilder, SubqueryBuilder, column, createDateColumn, getMetadataStorage, initialize, isSubqueryJoin, primaryColumn, subquery, table, updateDateColumn, versionColumn };
-export type { AggregateBuilder, ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindOneResultJSON, FindQueryWithCount, FindQueryWithCountJSON, FindResult, FindResultJSON, FindWithCountResult, GetValueType, HavingComparer, HavingCondition, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, JsonConstraint, LiteralValues, ModelJoinDefinition, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PlainObject, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, SelectAggregateExpression, SelectItem, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, SubqueryJoinDefinition, SubqueryJoinOnCondition, WhereClauseValue, WhereQuery, WhereQueryStatement };
+export type { AggregateBuilder, ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateResult, CreateResultArray, CreateResultArrayJSON, CreateResultJSON, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DestroyResultJSON, DestroyResultWithRecords, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindOneResultJSON, FindQueryWithCount, FindQueryWithCountJSON, FindResult, FindResultJSON, FindWithCountResult, GetValueType, HavingComparer, HavingCondition, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, JsonConstraint, LiteralValues, ModelJoinDefinition, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PlainObject, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, SelectAggregateExpression, SelectItem, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, SubqueryJoinDefinition, SubqueryJoinOnCondition, UpdateResult, UpdateResultJSON, WhereClauseValue, WhereQuery, WhereQueryStatement };

package/dist/index.mjs

@@ -3106,21 +3106,12 @@ class Repository extends ReadonlyRepository {
    * @param {object} [options.onConflict] - Options to handle conflicts due to a unique constraint or exclusion constraint error during insert
    * @returns {object|object[]|void} Return value from the db
    */
-  async create(values, options) {
+  create(values, options) {
     if (this.model.readonly) {
       throw new Error(`${this.model.name} is readonly.`);
     }
-    if (Array.isArray(values) && !values.length) {
-      return [];
-    }
-    const beforeCreate = this._type.beforeCreate;
-    if (beforeCreate) {
-      if (Array.isArray(values)) {
-        values = await Promise.all(values.map(async (value) => beforeCreate(value)));
-      } else {
-        values = await beforeCreate(values);
-      }
-    }
+    const modelInstance = this;
+    const isArray = Array.isArray(values);
     let returnRecords = true;
     let returnSelect;
     if (options) {
@@ -3130,26 +3121,56 @@ class Repository extends ReadonlyRepository {
         returnSelect = options.returnSelect;
       }
     }
-    const { query, params } = getInsertQueryAndParams({
-      repositoriesByModelNameLowered: this._repositoriesByModelNameLowered,
-      model: this.model,
-      values,
-      returnRecords,
-      returnSelect,
-      onConflict: options?.onConflict
-    });
-    const results = await this._pool.query(query, params);
-    if (returnRecords) {
-      if (Array.isArray(values)) {
-        return this._buildInstances(results.rows);
-      }
-      const firstResult = results.rows[0];
-      if (firstResult) {
-        return this._buildInstance(firstResult);
+    let returnAsPlainObjects = false;
+    const result = {
+      toJSON() {
+        returnAsPlainObjects = true;
+        return result;
+      },
+      async then(resolve, reject) {
+        try {
+          if (isArray && !values.length) {
+            return resolve ? await resolve([]) : [];
+          }
+          const beforeCreate = modelInstance._type.beforeCreate;
+          if (beforeCreate) {
+            if (isArray) {
+              values = await Promise.all(values.map(async (value) => beforeCreate(value)));
+            } else {
+              values = await beforeCreate(values);
+            }
+          }
+          const { query, params } = getInsertQueryAndParams({
+            repositoriesByModelNameLowered: modelInstance._repositoriesByModelNameLowered,
+            model: modelInstance.model,
+            values,
+            returnRecords,
+            returnSelect,
+            onConflict: options?.onConflict
+          });
+          const results = await modelInstance._pool.query(query, params);
+          if (returnRecords) {
+            if (isArray) {
+              const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(results.rows) : modelInstance._buildInstances(results.rows);
+              return resolve ? await resolve(entities) : entities;
+            }
+            const firstResult = results.rows[0];
+            if (firstResult) {
+              const entity = returnAsPlainObjects ? modelInstance._buildPlainObject(firstResult) : modelInstance._buildInstance(firstResult);
+              return resolve ? await resolve(entity) : entity;
+            }
+            throw new Error("Unknown error getting created rows back from the database");
+          }
+          return resolve ? await resolve(void 0) : void 0;
+        } catch (ex) {
+          if (reject) {
+            return reject(ex);
+          }
+          throw ex;
+        }
       }
-      throw new Error("Unknown error getting created rows back from the database");
-    }
-    return void 0;
+    };
+    return result;
   }
   /**
    * Updates object(s) matching the where query, with the specified values
@@ -3160,16 +3181,14 @@ class Repository extends ReadonlyRepository {
    * @param {string[]} [options.returnSelect] - Array of model property names to return from the query.
    * @returns {object[]|void} Return values from the db or `true` if returnRecords=false
    */
-  async update(where, values, options) {
+  update(where, values, options) {
     if (this.model.readonly) {
       throw new Error(`${this.model.name} is readonly.`);
     }
     if (typeof where === "string") {
       throw new Error("The query cannot be a string, it must be an object");
     }
-    if (this._type.beforeUpdate) {
-      values = await this._type.beforeUpdate(values);
-    }
+    const modelInstance = this;
     let returnRecords = true;
     let returnSelect;
     if (options) {
@@ -3179,19 +3198,40 @@ class Repository extends ReadonlyRepository {
         returnSelect = options.returnSelect;
       }
     }
-    const { query, params } = getUpdateQueryAndParams({
-      repositoriesByModelNameLowered: this._repositoriesByModelNameLowered,
-      model: this.model,
-      where,
-      values,
-      returnRecords,
-      returnSelect
-    });
-    const results = await this._pool.query(query, params);
-    if (returnRecords) {
-      return this._buildInstances(results.rows);
-    }
-    return void 0;
+    let returnAsPlainObjects = false;
+    const result = {
+      toJSON() {
+        returnAsPlainObjects = true;
+        return result;
+      },
+      async then(resolve, reject) {
+        try {
+          if (modelInstance._type.beforeUpdate) {
+            values = await modelInstance._type.beforeUpdate(values);
+          }
+          const { query, params } = getUpdateQueryAndParams({
+            repositoriesByModelNameLowered: modelInstance._repositoriesByModelNameLowered,
+            model: modelInstance.model,
+            where,
+            values,
+            returnRecords,
+            returnSelect
+          });
+          const results = await modelInstance._pool.query(query, params);
+          if (returnRecords) {
+            const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(results.rows) : modelInstance._buildInstances(results.rows);
+            return resolve ? await resolve(entities) : entities;
+          }
+          return resolve ? await resolve(void 0) : void 0;
+        } catch (ex) {
+          if (reject) {
+            return reject(ex);
+          }
+          throw ex;
+        }
+      }
+    };
+    return result;
   }
   /**
    * Destroys object(s) matching the where query
@@ -3209,15 +3249,15 @@ class Repository extends ReadonlyRepository {
     const modelInstance = this;
     const returnSelect = options?.returnSelect;
     const returnRecords = options?.returnRecords ?? !!returnSelect;
-    return {
-      /**
-       * Filters the query
-       * @param {object} value - Object representing the where query
-       * @returns Query instance
-       */
+    let returnAsPlainObjects = false;
+    const result = {
       where(value) {
         where = value;
-        return this;
+        return result;
+      },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return result;
       },
       async then(resolve, reject) {
         if (typeof where === "string") {
@@ -3231,9 +3271,10 @@ class Repository extends ReadonlyRepository {
             returnRecords,
             returnSelect
           });
-          const result = await modelInstance._pool.query(query, params);
+          const queryResult = await modelInstance._pool.query(query, params);
           if (returnRecords) {
-            return await resolve(modelInstance._buildInstances(result.rows));
+            const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(queryResult.rows) : modelInstance._buildInstances(queryResult.rows);
+            return await resolve(entities);
           }
           return await resolve();
         } catch (ex) {
@@ -3249,6 +3290,7 @@ ${stack}`;
         }
       }
     };
+    return result;
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigal",
-  "version": "15.7.0",
+  "version": "15.8.0",
   "description": "A fast and lightweight orm for postgres and node.js, written in typescript.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -46,14 +46,14 @@
     "@types/node": ">=20",
     "chai": "6.2.2",
     "eslint": "9.39.2",
-    "eslint-config-decent": "3.1.99",
+    "eslint-config-decent": "3.1.104",
     "husky": "9.1.7",
     "lint-staged": "16.2.7",
     "markdownlint-cli": "0.47.0",
     "mocha": "11.7.5",
     "npm-run-all2": "8.0.4",
     "pinst": "3.0.0",
-    "prettier": "3.8.0",
+    "prettier": "3.8.1",
     "semantic-release": "25.0.2",
     "strict-event-emitter-types": "2.0.0",
     "postgres-pool": "11.0.2",