bigal 15.4.0 → 15.5.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [15.5.0](https://github.com/bigalorm/bigal/compare/v15.4.0...v15.5.0) (2026-01-13)
+
+### Features
+
+- Add toJSON() method for returning plain objects instead of class instances ([#271](https://github.com/bigalorm/bigal/issues/271)) ([3e2ee5d](https://github.com/bigalorm/bigal/commit/3e2ee5d803d705bc54bc8b08044f5848088563bb))
+
 # [15.4.0](https://github.com/bigalorm/bigal/compare/v15.3.0...v15.4.0) (2026-01-08)
 
 ### Features

package/README.md

@@ -183,8 +183,8 @@ export function startup({
   });
 
   let categoryRepository: Repository<Category>;
-  let productRepository: Repository<Category>;
-  let storeRepository: Repository<Category>;
+  let productRepository: Repository<Product>;
+  let storeRepository: Repository<Store>;
   for (const [modelName, repository] = Object.entries(repositoriesByName)) {
     switch (modelName) {
       case 'Category':

package/dist/index.cjs

@@ -1961,6 +1961,7 @@ class ReadonlyRepository {
     const manuallySetFields = [];
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2050,6 +2051,10 @@ class ReadonlyRepository {
         });
         return this;
       },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2069,9 +2074,10 @@ class ReadonlyRepository {
           const results = await pool.query(query, params);
           const firstResult = results.rows[0];
           if (firstResult) {
-            const result = modelInstance._buildInstance(firstResult);
+            const result = returnAsPlainObjects ? modelInstance._buildPlainObject(firstResult) : modelInstance._buildInstance(firstResult);
             if (populates.length) {
-              await modelInstance.populateFields([result], populates);
+              const populatesWithFlag = populates.map((pop) => ({ ...pop, asPlainObjects: returnAsPlainObjects }));
+              await modelInstance.populateFields([result], populatesWithFlag);
             }
             for (const manuallySetField of manuallySetFields) {
               result[manuallySetField.propertyName] = manuallySetField.value;
@@ -2150,6 +2156,7 @@ ${stack ?? ""}`;
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
     let includeCount = false;
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2264,6 +2271,10 @@ ${stack ?? ""}`;
         includeCount = true;
         return this;
       },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2290,9 +2301,10 @@ ${stack ?? ""}`;
             const { __total_count__, ...rest } = row;
             return rest;
           }) : results.rows;
-          const entities = modelInstance._buildInstances(rows);
+          const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(rows) : modelInstance._buildInstances(rows);
           if (populates.length) {
-            await modelInstance.populateFields(entities, populates);
+            const populatesWithFlag = populates.map((pop) => ({ ...pop, asPlainObjects: returnAsPlainObjects }));
+            await modelInstance.populateFields(entities, populatesWithFlag);
           }
           if (includeCount) {
             return await resolve({
@@ -2414,6 +2426,40 @@ ${stack ?? ""}`;
   _buildInstances(rows) {
     return rows.map((row) => this._buildInstance(row));
   }
+  _buildPlainObject(row) {
+    const plainObject = { ...row };
+    for (const name of this._floatProperties) {
+      const originalValue = plainObject[name];
+      if (originalValue != null && typeof originalValue === "string") {
+        try {
+          const value = Number(originalValue);
+          if (Number.isFinite(value) && value.toString() === originalValue) {
+            plainObject[name] = value;
+          }
+        } catch {
+        }
+      }
+    }
+    for (const name of this._intProperties) {
+      const originalValue = plainObject[name];
+      if (originalValue != null && typeof originalValue === "string") {
+        try {
+          const value = Number(originalValue);
+          if (Number.isFinite(value) && value.toString() === originalValue) {
+            const valueAsInt = Math.trunc(value);
+            if (Number.isSafeInteger(valueAsInt)) {
+              plainObject[name] = valueAsInt;
+            }
+          }
+        } catch {
+        }
+      }
+    }
+    return plainObject;
+  }
+  _buildPlainObjects(rows) {
+    return rows.map((row) => this._buildPlainObject(row));
+  }
   _convertSortsToOrderBy(sorts) {
     const result = [];
     if (sorts) {
@@ -2530,12 +2576,13 @@ ${stack ?? ""}`;
       [populateRepository.model.primaryKeyColumn.propertyName]: Array.from(populateIds),
       ...populate.where
     };
-    const populateResults = await populateRepository.find({
+    const findQuery = populateRepository.find({
       select: populate.select,
       where: populateWhere,
       sort: populate.sort,
       pool: populate.pool
     });
+    const populateResults = populate.asPlainObjects ? await findQuery.toJSON() : await findQuery;
     const populateResultsById = keyBy(populateResults, populateRepository.model.primaryKeyColumn.propertyName);
     for (const entity of entities) {
       entity[propertyName] = populateResultsById[entity[propertyName]];
@@ -2549,7 +2596,7 @@ ${stack ?? ""}`;
       [column.via]: entityIds,
       ...populate.where
     };
-    const populateResults = await populateRepository.find({
+    const findQuery = populateRepository.find({
       select: populate.select,
       where: populateWhere,
       sort: populate.sort,
@@ -2557,6 +2604,7 @@ ${stack ?? ""}`;
       limit: populate.limit,
       pool: populate.pool
     });
+    const populateResults = populate.asPlainObjects ? await findQuery.toJSON() : await findQuery;
     if (entities.length === 1) {
       for (const entity of entities) {
         entity[populate.propertyName] = populateResults;
@@ -2609,7 +2657,7 @@ ${stack ?? ""}`;
       [populateModelPrimaryKeyPropertyName]: Array.from(populateIds),
       ...populate.where
     };
-    const populateResults = await populateRepository.find({
+    const findQuery = populateRepository.find({
       select: populate.select,
       where: populateWhere,
       sort: populate.sort,
@@ -2617,6 +2665,7 @@ ${stack ?? ""}`;
       limit: populate.limit,
       pool: populate.pool
     });
+    const populateResults = populate.asPlainObjects ? await findQuery.toJSON() : await findQuery;
     const populateResultsById = keyBy(populateResults, populateModelPrimaryKeyPropertyName);
     for (const entity of entities) {
       const populatedItems = [];

package/dist/index.d.cts

@@ -85,6 +85,15 @@ type PickFunctions<T> = {
     [K in keyof T as IncludeFunctions<T[K], K>]: T[K];
 };
 
+/**
+ * Recursively converts entity types to plain object types.
+ * This is primarily for documentation/intent - at runtime, this strips the prototype chain.
+ * Preserves Date objects as-is since they're serializable by most frameworks.
+ */
+type PlainObject<T> = T extends Date ? Date : T extends (infer U)[] ? PlainObject<U>[] : T extends object ? {
+    [K in keyof T]: PlainObject<T[K]>;
+} : T;
+
 /**
  * Changes all properties with Entity values to Primitive (string|number). Removes any properties that with values
  * of Entity arrays
@@ -553,6 +562,16 @@ interface PopulateArgs<T extends Entity, K extends keyof T> {
     pool?: PoolLike;
 }
 
+interface FindOneResultJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<PlainObject<TReturn> | null> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindOneResultJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindOneResultJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindOneResultJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindOneResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindOneResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindOneResultJSON<T, TReturn, TJoins>;
+    UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindOneResultJSON<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+    UNSAFE_withFieldValue<TProperty extends string & keyof T, TValue extends T[TProperty]>(propertyName: TProperty, value: TValue): FindOneResultJSON<T, Omit<TReturn, TProperty> & PickAsType<T, TProperty, TValue>, TJoins>;
+}
 interface FindOneResult<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<TReturn | null> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindOneResult<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindOneResult<T, TReturn, TJoins>;
@@ -562,6 +581,11 @@ interface FindOneResult<T extends Entity, TReturn, TJoins extends JoinInfo = nev
     sort(value?: JoinedSort<T, TJoins>): FindOneResult<T, TReturn, TJoins>;
     UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindOneResult<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
     UNSAFE_withFieldValue<TProperty extends string & keyof T, TValue extends T[TProperty]>(propertyName: TProperty, value: TValue): FindOneResult<T, Omit<TReturn, TProperty> & PickAsType<T, TProperty, TValue>, TJoins>;
+    /**
+     * Returns result as a plain object instead of an entity class instance.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindOneResultJSON<T, TReturn, TJoins>;
 }
 
 interface PaginateOptions {
@@ -573,6 +597,17 @@ interface FindWithCountResult<TReturn> {
     results: TReturn[];
     totalCount: number;
 }
+interface FindQueryWithCountJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<FindWithCountResult<PlainObject<TReturn>>> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindQueryWithCountJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindQueryWithCountJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindQueryWithCountJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindQueryWithCountJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    limit(value: number): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    skip(value: number): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    paginate(options: PaginateOptions): FindQueryWithCountJSON<T, TReturn, TJoins>;
+}
 interface FindQueryWithCount<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<FindWithCountResult<TReturn>> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindQueryWithCount<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindQueryWithCount<T, TReturn, TJoins>;
@@ -583,8 +618,26 @@ interface FindQueryWithCount<T extends Entity, TReturn, TJoins extends JoinInfo
     limit(value: number): FindQueryWithCount<T, TReturn, TJoins>;
     skip(value: number): FindQueryWithCount<T, TReturn, TJoins>;
     paginate(options: PaginateOptions): FindQueryWithCount<T, TReturn, TJoins>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindQueryWithCountJSON<T, TReturn, TJoins>;
 }
 
+interface FindResultJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<PlainObject<TReturn>[]> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindResultJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindResultJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindResultJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindResultJSON<T, TReturn, TJoins>;
+    limit(value: number): FindResultJSON<T, TReturn, TJoins>;
+    skip(value: number): FindResultJSON<T, TReturn, TJoins>;
+    paginate(options: PaginateOptions): FindResultJSON<T, TReturn, TJoins>;
+    withCount(): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindResultJSON<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+}
 interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<TReturn[]> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindResult<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindResult<T, TReturn, TJoins>;
@@ -597,6 +650,11 @@ interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never>
     paginate(options: PaginateOptions): FindResult<T, TReturn, TJoins>;
     withCount(): FindQueryWithCount<T, TReturn, TJoins>;
     UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindResult<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindResultJSON<T, TReturn, TJoins>;
 }
 
 interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
@@ -808,6 +866,7 @@ interface Populate {
     skip?: number;
     limit?: number;
     pool?: PoolLike;
+    asPlainObjects?: boolean;
 }
 declare class ReadonlyRepository<T extends Entity> implements IReadonlyRepository<T> {
     private readonly _modelMetadata;
@@ -849,6 +908,8 @@ declare class ReadonlyRepository<T extends Entity> implements IReadonlyRepositor
     count(args?: CountArgs<T> | WhereQuery<T>): CountResult<T>;
     protected _buildInstance(row: Partial<QueryResult<T>>): QueryResult<T>;
     protected _buildInstances(rows: Partial<QueryResult<T>>[]): QueryResult<T>[];
+    protected _buildPlainObject(row: Partial<QueryResult<T>>): QueryResult<T>;
+    protected _buildPlainObjects(rows: Partial<QueryResult<T>>[]): QueryResult<T>[];
     protected _convertSortsToOrderBy(sorts: SortObject<T> | string): OrderBy<T>[];
     protected populateFields(entities: QueryResult<T>[], populates: Populate[]): Promise<void>;
     private populateSingleAssociation;
@@ -1046,4 +1107,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, SubqueryBuilder, column, createDateColumn, getMetadataStorage, initialize, primaryColumn, subquery, table, updateDateColumn, versionColumn };
-export type { ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindQueryWithCount, FindResult, FindWithCountResult, GetValueType, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, LiteralValues, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, WhereClauseValue, WhereQuery, WhereQueryStatement };
+export type { 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, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, LiteralValues, 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, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, WhereClauseValue, WhereQuery, WhereQueryStatement };

package/dist/index.d.mts

@@ -85,6 +85,15 @@ type PickFunctions<T> = {
     [K in keyof T as IncludeFunctions<T[K], K>]: T[K];
 };
 
+/**
+ * Recursively converts entity types to plain object types.
+ * This is primarily for documentation/intent - at runtime, this strips the prototype chain.
+ * Preserves Date objects as-is since they're serializable by most frameworks.
+ */
+type PlainObject<T> = T extends Date ? Date : T extends (infer U)[] ? PlainObject<U>[] : T extends object ? {
+    [K in keyof T]: PlainObject<T[K]>;
+} : T;
+
 /**
  * Changes all properties with Entity values to Primitive (string|number). Removes any properties that with values
  * of Entity arrays
@@ -553,6 +562,16 @@ interface PopulateArgs<T extends Entity, K extends keyof T> {
     pool?: PoolLike;
 }
 
+interface FindOneResultJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<PlainObject<TReturn> | null> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindOneResultJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindOneResultJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindOneResultJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindOneResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindOneResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindOneResultJSON<T, TReturn, TJoins>;
+    UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindOneResultJSON<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+    UNSAFE_withFieldValue<TProperty extends string & keyof T, TValue extends T[TProperty]>(propertyName: TProperty, value: TValue): FindOneResultJSON<T, Omit<TReturn, TProperty> & PickAsType<T, TProperty, TValue>, TJoins>;
+}
 interface FindOneResult<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<TReturn | null> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindOneResult<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindOneResult<T, TReturn, TJoins>;
@@ -562,6 +581,11 @@ interface FindOneResult<T extends Entity, TReturn, TJoins extends JoinInfo = nev
     sort(value?: JoinedSort<T, TJoins>): FindOneResult<T, TReturn, TJoins>;
     UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindOneResult<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
     UNSAFE_withFieldValue<TProperty extends string & keyof T, TValue extends T[TProperty]>(propertyName: TProperty, value: TValue): FindOneResult<T, Omit<TReturn, TProperty> & PickAsType<T, TProperty, TValue>, TJoins>;
+    /**
+     * Returns result as a plain object instead of an entity class instance.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindOneResultJSON<T, TReturn, TJoins>;
 }
 
 interface PaginateOptions {
@@ -573,6 +597,17 @@ interface FindWithCountResult<TReturn> {
     results: TReturn[];
     totalCount: number;
 }
+interface FindQueryWithCountJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<FindWithCountResult<PlainObject<TReturn>>> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindQueryWithCountJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindQueryWithCountJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindQueryWithCountJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindQueryWithCountJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    limit(value: number): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    skip(value: number): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    paginate(options: PaginateOptions): FindQueryWithCountJSON<T, TReturn, TJoins>;
+}
 interface FindQueryWithCount<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<FindWithCountResult<TReturn>> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindQueryWithCount<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindQueryWithCount<T, TReturn, TJoins>;
@@ -583,8 +618,26 @@ interface FindQueryWithCount<T extends Entity, TReturn, TJoins extends JoinInfo
     limit(value: number): FindQueryWithCount<T, TReturn, TJoins>;
     skip(value: number): FindQueryWithCount<T, TReturn, TJoins>;
     paginate(options: PaginateOptions): FindQueryWithCount<T, TReturn, TJoins>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindQueryWithCountJSON<T, TReturn, TJoins>;
 }
 
+interface FindResultJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<PlainObject<TReturn>[]> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindResultJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindResultJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindResultJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindResultJSON<T, TReturn, TJoins>;
+    limit(value: number): FindResultJSON<T, TReturn, TJoins>;
+    skip(value: number): FindResultJSON<T, TReturn, TJoins>;
+    paginate(options: PaginateOptions): FindResultJSON<T, TReturn, TJoins>;
+    withCount(): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindResultJSON<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+}
 interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<TReturn[]> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindResult<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindResult<T, TReturn, TJoins>;
@@ -597,6 +650,11 @@ interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never>
     paginate(options: PaginateOptions): FindResult<T, TReturn, TJoins>;
     withCount(): FindQueryWithCount<T, TReturn, TJoins>;
     UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindResult<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindResultJSON<T, TReturn, TJoins>;
 }
 
 interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
@@ -808,6 +866,7 @@ interface Populate {
     skip?: number;
     limit?: number;
     pool?: PoolLike;
+    asPlainObjects?: boolean;
 }
 declare class ReadonlyRepository<T extends Entity> implements IReadonlyRepository<T> {
     private readonly _modelMetadata;
@@ -849,6 +908,8 @@ declare class ReadonlyRepository<T extends Entity> implements IReadonlyRepositor
     count(args?: CountArgs<T> | WhereQuery<T>): CountResult<T>;
     protected _buildInstance(row: Partial<QueryResult<T>>): QueryResult<T>;
     protected _buildInstances(rows: Partial<QueryResult<T>>[]): QueryResult<T>[];
+    protected _buildPlainObject(row: Partial<QueryResult<T>>): QueryResult<T>;
+    protected _buildPlainObjects(rows: Partial<QueryResult<T>>[]): QueryResult<T>[];
     protected _convertSortsToOrderBy(sorts: SortObject<T> | string): OrderBy<T>[];
     protected populateFields(entities: QueryResult<T>[], populates: Populate[]): Promise<void>;
     private populateSingleAssociation;
@@ -1046,4 +1107,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, SubqueryBuilder, column, createDateColumn, getMetadataStorage, initialize, primaryColumn, subquery, table, updateDateColumn, versionColumn };
-export type { ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindQueryWithCount, FindResult, FindWithCountResult, GetValueType, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, LiteralValues, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, WhereClauseValue, WhereQuery, WhereQueryStatement };
+export type { 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, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, LiteralValues, 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, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, WhereClauseValue, WhereQuery, WhereQueryStatement };

package/dist/index.d.ts

@@ -85,6 +85,15 @@ type PickFunctions<T> = {
     [K in keyof T as IncludeFunctions<T[K], K>]: T[K];
 };
 
+/**
+ * Recursively converts entity types to plain object types.
+ * This is primarily for documentation/intent - at runtime, this strips the prototype chain.
+ * Preserves Date objects as-is since they're serializable by most frameworks.
+ */
+type PlainObject<T> = T extends Date ? Date : T extends (infer U)[] ? PlainObject<U>[] : T extends object ? {
+    [K in keyof T]: PlainObject<T[K]>;
+} : T;
+
 /**
  * Changes all properties with Entity values to Primitive (string|number). Removes any properties that with values
  * of Entity arrays
@@ -553,6 +562,16 @@ interface PopulateArgs<T extends Entity, K extends keyof T> {
     pool?: PoolLike;
 }
 
+interface FindOneResultJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<PlainObject<TReturn> | null> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindOneResultJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindOneResultJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindOneResultJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindOneResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindOneResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindOneResultJSON<T, TReturn, TJoins>;
+    UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindOneResultJSON<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+    UNSAFE_withFieldValue<TProperty extends string & keyof T, TValue extends T[TProperty]>(propertyName: TProperty, value: TValue): FindOneResultJSON<T, Omit<TReturn, TProperty> & PickAsType<T, TProperty, TValue>, TJoins>;
+}
 interface FindOneResult<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<TReturn | null> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindOneResult<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindOneResult<T, TReturn, TJoins>;
@@ -562,6 +581,11 @@ interface FindOneResult<T extends Entity, TReturn, TJoins extends JoinInfo = nev
     sort(value?: JoinedSort<T, TJoins>): FindOneResult<T, TReturn, TJoins>;
     UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindOneResult<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
     UNSAFE_withFieldValue<TProperty extends string & keyof T, TValue extends T[TProperty]>(propertyName: TProperty, value: TValue): FindOneResult<T, Omit<TReturn, TProperty> & PickAsType<T, TProperty, TValue>, TJoins>;
+    /**
+     * Returns result as a plain object instead of an entity class instance.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindOneResultJSON<T, TReturn, TJoins>;
 }
 
 interface PaginateOptions {
@@ -573,6 +597,17 @@ interface FindWithCountResult<TReturn> {
     results: TReturn[];
     totalCount: number;
 }
+interface FindQueryWithCountJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<FindWithCountResult<PlainObject<TReturn>>> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindQueryWithCountJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindQueryWithCountJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindQueryWithCountJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindQueryWithCountJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    limit(value: number): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    skip(value: number): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    paginate(options: PaginateOptions): FindQueryWithCountJSON<T, TReturn, TJoins>;
+}
 interface FindQueryWithCount<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<FindWithCountResult<TReturn>> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindQueryWithCount<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindQueryWithCount<T, TReturn, TJoins>;
@@ -583,8 +618,26 @@ interface FindQueryWithCount<T extends Entity, TReturn, TJoins extends JoinInfo
     limit(value: number): FindQueryWithCount<T, TReturn, TJoins>;
     skip(value: number): FindQueryWithCount<T, TReturn, TJoins>;
     paginate(options: PaginateOptions): FindQueryWithCount<T, TReturn, TJoins>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindQueryWithCountJSON<T, TReturn, TJoins>;
 }
 
+interface FindResultJSON<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<PlainObject<TReturn>[]> {
+    select<TKeys extends string & keyof T>(keys: TKeys[]): FindResultJSON<T, Pick<T, TKeys>, TJoins>;
+    where(args: JoinedWhereQuery<T, TJoins>): FindResultJSON<T, TReturn, TJoins>;
+    populate<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T, TPopulateType extends GetValueType<T[TProperty], Entity>, TPopulateSelectKeys extends string & keyof TPopulateType>(propertyName: TProperty, options?: PopulateArgs<TPopulateType, TPopulateSelectKeys>): FindResultJSON<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    leftJoin<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias, on?: WhereQuery<GetValueType<T[TProperty], Entity>>): FindResultJSON<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindResultJSON<T, TReturn, TJoins>;
+    limit(value: number): FindResultJSON<T, TReturn, TJoins>;
+    skip(value: number): FindResultJSON<T, TReturn, TJoins>;
+    paginate(options: PaginateOptions): FindResultJSON<T, TReturn, TJoins>;
+    withCount(): FindQueryWithCountJSON<T, TReturn, TJoins>;
+    UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindResultJSON<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+}
 interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never> extends PromiseLike<TReturn[]> {
     select<TKeys extends string & keyof T>(keys: TKeys[]): FindResult<T, Pick<T, TKeys>, TJoins>;
     where(args: JoinedWhereQuery<T, TJoins>): FindResult<T, TReturn, TJoins>;
@@ -597,6 +650,11 @@ interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never>
     paginate(options: PaginateOptions): FindResult<T, TReturn, TJoins>;
     withCount(): FindQueryWithCount<T, TReturn, TJoins>;
     UNSAFE_withOriginalFieldType<TProperty extends string & keyof PickByValueType<T, Entity> & keyof T>(propertyName: TProperty): FindResult<T, Omit<TReturn, TProperty> & Pick<T, TProperty>, TJoins>;
+    /**
+     * Returns results as plain objects instead of entity class instances.
+     * Useful for when data must be serializable.
+     */
+    toJSON(): FindResultJSON<T, TReturn, TJoins>;
 }
 
 interface IRepository<T extends Entity> extends IReadonlyRepository<T> {
@@ -808,6 +866,7 @@ interface Populate {
     skip?: number;
     limit?: number;
     pool?: PoolLike;
+    asPlainObjects?: boolean;
 }
 declare class ReadonlyRepository<T extends Entity> implements IReadonlyRepository<T> {
     private readonly _modelMetadata;
@@ -849,6 +908,8 @@ declare class ReadonlyRepository<T extends Entity> implements IReadonlyRepositor
     count(args?: CountArgs<T> | WhereQuery<T>): CountResult<T>;
     protected _buildInstance(row: Partial<QueryResult<T>>): QueryResult<T>;
     protected _buildInstances(rows: Partial<QueryResult<T>>[]): QueryResult<T>[];
+    protected _buildPlainObject(row: Partial<QueryResult<T>>): QueryResult<T>;
+    protected _buildPlainObjects(rows: Partial<QueryResult<T>>[]): QueryResult<T>[];
     protected _convertSortsToOrderBy(sorts: SortObject<T> | string): OrderBy<T>[];
     protected populateFields(entities: QueryResult<T>[], populates: Populate[]): Promise<void>;
     private populateSingleAssociation;
@@ -1046,4 +1107,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, SubqueryBuilder, column, createDateColumn, getMetadataStorage, initialize, primaryColumn, subquery, table, updateDateColumn, versionColumn };
-export type { ClassLike, ColumnBaseMetadataOptions, ColumnCollectionMetadataOptions, ColumnMetadata, ColumnModelMetadataOptions, ColumnModifierMetadata, ColumnTypeMetadataOptions, Comparer, CountResult, CreateUpdateOptions, CreateUpdateParams, DeleteOptions, DestroyResult, DoNotReturnRecords, EntityFieldValue, EntityPrimitiveOrId, EntityStatic, ExcludeEntityCollections, ExcludeFunctions, FindArgs, FindOneArgs, FindOneResult, FindQueryWithCount, FindResult, FindWithCountResult, GetValueType, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, LiteralValues, ModelMetadataOptions, ModelRelationshipKeys, MultipleSortString, NegatableConstraint, NotEntity, NotEntityBrand, NumberOrDateConstraint, NumberOrDateConstraintWithSubquery, OmitEntityCollections, OmitFunctions, OrderBy, PaginateOptions, PickAsType, PickByValueType, PickFunctions, PoolLike, PoolQueryResult, PopulateArgs, Populated, QueryResult, QueryResultOptionalPopulated, QueryResultPopulated, QueryResultRow, ReturnSelect$1 as ReturnSelect, ScalarSubqueryConstraint, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, WhereClauseValue, WhereQuery, WhereQueryStatement };
+export type { 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, IConnection, IReadonlyRepository, IRepository, IRepositoryOptions, IncludeFunctions, InitializeOptions, IsValueOfType, JoinDefinition, JoinInfo, JoinType, JoinedSort, JoinedWhereQuery, LiteralValues, 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, Sort, SortObject, SortObjectValue, SortString, StringConstraint, SubqueryBuilderLike, SubqueryInConstraint, WhereClauseValue, WhereQuery, WhereQueryStatement };

package/dist/index.mjs

@@ -1959,6 +1959,7 @@ class ReadonlyRepository {
     const manuallySetFields = [];
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2048,6 +2049,10 @@ class ReadonlyRepository {
         });
         return this;
       },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2067,9 +2072,10 @@ class ReadonlyRepository {
           const results = await pool.query(query, params);
           const firstResult = results.rows[0];
           if (firstResult) {
-            const result = modelInstance._buildInstance(firstResult);
+            const result = returnAsPlainObjects ? modelInstance._buildPlainObject(firstResult) : modelInstance._buildInstance(firstResult);
             if (populates.length) {
-              await modelInstance.populateFields([result], populates);
+              const populatesWithFlag = populates.map((pop) => ({ ...pop, asPlainObjects: returnAsPlainObjects }));
+              await modelInstance.populateFields([result], populatesWithFlag);
             }
             for (const manuallySetField of manuallySetFields) {
               result[manuallySetField.propertyName] = manuallySetField.value;
@@ -2148,6 +2154,7 @@ ${stack ?? ""}`;
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
     let includeCount = false;
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2262,6 +2269,10 @@ ${stack ?? ""}`;
         includeCount = true;
         return this;
       },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2288,9 +2299,10 @@ ${stack ?? ""}`;
             const { __total_count__, ...rest } = row;
             return rest;
           }) : results.rows;
-          const entities = modelInstance._buildInstances(rows);
+          const entities = returnAsPlainObjects ? modelInstance._buildPlainObjects(rows) : modelInstance._buildInstances(rows);
           if (populates.length) {
-            await modelInstance.populateFields(entities, populates);
+            const populatesWithFlag = populates.map((pop) => ({ ...pop, asPlainObjects: returnAsPlainObjects }));
+            await modelInstance.populateFields(entities, populatesWithFlag);
           }
           if (includeCount) {
             return await resolve({
@@ -2412,6 +2424,40 @@ ${stack ?? ""}`;
   _buildInstances(rows) {
     return rows.map((row) => this._buildInstance(row));
   }
+  _buildPlainObject(row) {
+    const plainObject = { ...row };
+    for (const name of this._floatProperties) {
+      const originalValue = plainObject[name];
+      if (originalValue != null && typeof originalValue === "string") {
+        try {
+          const value = Number(originalValue);
+          if (Number.isFinite(value) && value.toString() === originalValue) {
+            plainObject[name] = value;
+          }
+        } catch {
+        }
+      }
+    }
+    for (const name of this._intProperties) {
+      const originalValue = plainObject[name];
+      if (originalValue != null && typeof originalValue === "string") {
+        try {
+          const value = Number(originalValue);
+          if (Number.isFinite(value) && value.toString() === originalValue) {
+            const valueAsInt = Math.trunc(value);
+            if (Number.isSafeInteger(valueAsInt)) {
+              plainObject[name] = valueAsInt;
+            }
+          }
+        } catch {
+        }
+      }
+    }
+    return plainObject;
+  }
+  _buildPlainObjects(rows) {
+    return rows.map((row) => this._buildPlainObject(row));
+  }
   _convertSortsToOrderBy(sorts) {
     const result = [];
     if (sorts) {
@@ -2528,12 +2574,13 @@ ${stack ?? ""}`;
       [populateRepository.model.primaryKeyColumn.propertyName]: Array.from(populateIds),
       ...populate.where
     };
-    const populateResults = await populateRepository.find({
+    const findQuery = populateRepository.find({
       select: populate.select,
       where: populateWhere,
       sort: populate.sort,
       pool: populate.pool
     });
+    const populateResults = populate.asPlainObjects ? await findQuery.toJSON() : await findQuery;
     const populateResultsById = keyBy(populateResults, populateRepository.model.primaryKeyColumn.propertyName);
     for (const entity of entities) {
       entity[propertyName] = populateResultsById[entity[propertyName]];
@@ -2547,7 +2594,7 @@ ${stack ?? ""}`;
       [column.via]: entityIds,
       ...populate.where
     };
-    const populateResults = await populateRepository.find({
+    const findQuery = populateRepository.find({
       select: populate.select,
       where: populateWhere,
       sort: populate.sort,
@@ -2555,6 +2602,7 @@ ${stack ?? ""}`;
       limit: populate.limit,
       pool: populate.pool
     });
+    const populateResults = populate.asPlainObjects ? await findQuery.toJSON() : await findQuery;
     if (entities.length === 1) {
       for (const entity of entities) {
         entity[populate.propertyName] = populateResults;
@@ -2607,7 +2655,7 @@ ${stack ?? ""}`;
       [populateModelPrimaryKeyPropertyName]: Array.from(populateIds),
       ...populate.where
     };
-    const populateResults = await populateRepository.find({
+    const findQuery = populateRepository.find({
       select: populate.select,
       where: populateWhere,
       sort: populate.sort,
@@ -2615,6 +2663,7 @@ ${stack ?? ""}`;
       limit: populate.limit,
       pool: populate.pool
     });
+    const populateResults = populate.asPlainObjects ? await findQuery.toJSON() : await findQuery;
     const populateResultsById = keyBy(populateResults, populateModelPrimaryKeyPropertyName);
     for (const entity of entities) {
       const populatedItems = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigal",
-  "version": "15.4.0",
+  "version": "15.5.0",
   "description": "A fast and lightweight orm for postgres and node.js, written in typescript.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -46,7 +46,7 @@
     "@types/node": ">=20",
     "chai": "6.2.2",
     "eslint": "9.39.2",
-    "eslint-config-decent": "3.1.90",
+    "eslint-config-decent": "3.1.93",
     "husky": "9.1.7",
     "lint-staged": "16.2.7",
     "markdownlint-cli": "0.47.0",
@@ -56,7 +56,7 @@
     "prettier": "3.7.4",
     "semantic-release": "25.0.2",
     "strict-event-emitter-types": "2.0.0",
-    "postgres-pool": "11.0.1",
+    "postgres-pool": "11.0.2",
     "ts-mockito": "2.6.1",
     "ts-node": "10.9.2",
     "typescript": "5.9.3",