bigal 15.3.0 → 15.5.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [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
+
+- Add withCount() for efficient pagination with total count ([#266](https://github.com/bigalorm/bigal/issues/266)) ([233221e](https://github.com/bigalorm/bigal/commit/233221e7902af8ca3a4b24d1f60f0857bcd7803f))
+
 # [15.3.0](https://github.com/bigalorm/bigal/compare/v15.2.0...v15.3.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':
@@ -325,14 +325,109 @@ const item = await ProductRepository.find({
 });
 ```
 
-#### Example of an OR statement
+#### String matching operators
+
+BigAl provides four string matching operators. All use case-insensitive matching (PostgreSQL `ILIKE`) and accept arrays for OR matching.
+
+| Operator     | Description                                   | SQL Pattern |
+| ------------ | --------------------------------------------- | ----------- |
+| `like`       | Raw ILIKE pattern with your own `%` wildcards | As provided |
+| `contains`   | Substring match anywhere in the string        | `%value%`   |
+| `startsWith` | Matches strings starting with the value       | `value%`    |
+| `endsWith`   | Matches strings ending with the value         | `%value`    |
 
 ```ts
+const items = await ProductRepository.find().where({
+  name: { contains: 'widget' },
+});
+// SQL: SELECT ... FROM product WHERE name ILIKE '%widget%'
+
+const items = await ProductRepository.find().where({
+  name: { startsWith: 'Pro' },
+});
+// SQL: SELECT ... FROM product WHERE name ILIKE 'Pro%'
+
+const items = await ProductRepository.find().where({
+  name: { endsWith: 'ter' },
+});
+// SQL: SELECT ... FROM product WHERE name ILIKE '%ter'
+
+const items = await ProductRepository.find().where({
+  name: { like: 'Pro%Widget%' },
+});
+// SQL: SELECT ... FROM product WHERE name ILIKE 'Pro%Widget%'
+
+// Arrays create OR conditions
 const items = await PersonRepository.find().where({
-  firstName: {
-    like: ['walter', 'Jess%'],
-  },
+  firstName: { like: ['walter', 'Jess%'] },
+});
+// SQL: SELECT ... FROM person WHERE (first_name ILIKE 'walter' OR first_name ILIKE 'Jess%')
+```
+
+#### Comparison operators
+
+For number and date fields, use comparison operators:
+
+| Operator | Description              |
+| -------- | ------------------------ |
+| `<`      | Less than                |
+| `<=`     | Less than or equal to    |
+| `>`      | Greater than             |
+| `>=`     | Greater than or equal to |
+
+```ts
+const items = await ProductRepository.find().where({
+  price: { '>=': 100 },
+});
+// SQL: SELECT ... FROM product WHERE price >= $1
+
+// Multiple operators on same field create AND
+const items = await ProductRepository.find().where({
+  createdAt: { '>=': startDate, '<': endDate },
+});
+// SQL: SELECT ... FROM product WHERE created_at >= $1 AND created_at < $2
+```
+
+#### Array values (OR conditions)
+
+When you pass an array of values, BigAl creates an OR condition:
+
+```ts
+const items = await PersonRepository.find().where({
+  age: [22, 23, 24],
+});
+// SQL: SELECT ... FROM person WHERE age IN ($1, $2, $3)
+
+const items = await ProductRepository.find().where({
+  name: { startsWith: ['Pro', 'Pre'] },
+});
+// SQL: SELECT ... FROM product WHERE (name ILIKE 'Pro%' OR name ILIKE 'Pre%')
+```
+
+#### Negation operator (`!`)
+
+Use `!` to negate any condition:
+
+```ts
+const items = await ProductRepository.find().where({
+  status: { '!': 'discontinued' },
+});
+// SQL: SELECT ... FROM product WHERE status <> $1
+
+const items = await ProductRepository.find().where({
+  status: { '!': ['discontinued', 'archived'] },
+});
+// SQL: SELECT ... FROM product WHERE status NOT IN ($1, $2)
+
+const items = await ProductRepository.find().where({
+  name: { '!': { startsWith: 'Test' } },
 });
+// SQL: SELECT ... FROM product WHERE name NOT ILIKE 'Test%'
+
+const items = await ProductRepository.find().where({
+  deletedAt: { '!': null },
+});
+// SQL: SELECT ... FROM product WHERE deleted_at IS NOT NULL
 ```
 
 #### Example of an AND statement
@@ -392,22 +487,28 @@ Equivalent to:
 select * from person where ((first_name = $1) OR (last_name = $2)) AND ((first_name = $3) OR (last_name = $4))
 ```
 
-#### Fetch multiple objects and perform a db sort before returning result
+#### Sorting results
+
+Use `.sort()` to order results. Two syntax options are available:
+
+**String syntax** - Use `asc` or `desc` (comma-separated for multiple columns):
 
 ```ts
-const items = await PersonRepository.find()
-  .where({
-    firstName: {
-      like: 'walter',
-    },
-    lastName: {
-      like: 'white',
-    },
-  })
-  .sort({
-    age: 1,
-    occupation: -1,
-  });
+const items = await PersonRepository.find().where({ lastName: 'Smith' }).sort('age asc');
+// SQL: SELECT ... FROM person WHERE last_name = $1 ORDER BY age ASC
+
+const items = await PersonRepository.find().where({ lastName: 'Smith' }).sort('age asc, createdAt desc');
+// SQL: SELECT ... FROM person WHERE last_name = $1 ORDER BY age ASC, created_at DESC
+```
+
+**Object syntax** - Use `1` for ascending, `-1` for descending:
+
+```ts
+const items = await PersonRepository.find().where({ lastName: 'Smith' }).sort({ age: 1 });
+// SQL: SELECT ... FROM person WHERE last_name = $1 ORDER BY age ASC
+
+const items = await PersonRepository.find().where({ lastName: 'Smith' }).sort({ age: 1, createdAt: -1 });
+// SQL: SELECT ... FROM person WHERE last_name = $1 ORDER BY age ASC, created_at DESC
 ```
 
 #### Limit number results returned
@@ -460,6 +561,34 @@ const items = await FooRepository.find()
   .paginate(page, pageSize);
 ```
 
+#### Page results with total count using `withCount`
+
+Use `.withCount()` to get both paginated results and the total count of matching records in a single query. This uses PostgreSQL's `COUNT(*) OVER()` window function for efficient execution.
+
+```ts
+const { results, totalCount } = await ProductRepository.find()
+  .where({
+    store: storeId,
+  })
+  .sort('name')
+  .limit(10)
+  .skip(20)
+  .withCount();
+
+// results: Product[] (10 items from offset 20)
+// totalCount: number (total matching products, ignoring LIMIT/OFFSET)
+```
+
+This is useful for building paginated UIs where you need to display total pages:
+
+```ts
+const page = 3;
+const pageSize = 25;
+const { results, totalCount } = await ProductRepository.find().where({ isActive: true }).paginate({ page, limit: pageSize }).withCount();
+
+const totalPages = Math.ceil(totalCount / pageSize);
+```
+
 #### Join related tables
 
 Use `join()` for INNER JOIN or `leftJoin()` for LEFT JOIN to filter or sort by related table columns in a single query.

package/dist/index.cjs

@@ -445,13 +445,17 @@ function getSelectQueryAndParams({
   sorts,
   skip,
   limit,
-  joins
+  joins,
+  includeCount
 }) {
   let query = "SELECT ";
   query += getColumnsToSelect({
     model,
     select
   });
+  if (includeCount) {
+    query += ',count(*) OVER() AS "__total_count__"';
+  }
   query += ` FROM ${model.qualifiedTableName}`;
   const params = [];
   if (joins?.length) {
@@ -901,7 +905,7 @@ function buildJoinClauses({
     if (alias !== relatedModel.tableName) {
       joinSql += ` AS "${alias}"`;
     }
-    joinSql += ` ON ${model.qualifiedTableName}."${column.name}" = "${alias}"."${relatedPrimaryKey.name}"`;
+    joinSql += ` ON ${model.qualifiedTableName}."${column.name}"="${alias}"."${relatedPrimaryKey.name}"`;
     if (join.on) {
       for (const [propertyName, value] of Object.entries(join.on)) {
         const onColumn = relatedModel.columnsByPropertyName[propertyName];
@@ -1957,6 +1961,7 @@ class ReadonlyRepository {
     const manuallySetFields = [];
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2046,6 +2051,10 @@ class ReadonlyRepository {
         });
         return this;
       },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2065,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;
@@ -2145,6 +2155,8 @@ ${stack ?? ""}`;
     const populates = [];
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
+    let includeCount = false;
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2255,6 +2267,14 @@ ${stack ?? ""}`;
         const safePage = Math.max(page, 1);
         return this.skip(safePage * paginateLimit - paginateLimit).limit(paginateLimit);
       },
+      withCount() {
+        includeCount = true;
+        return this;
+      },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2268,13 +2288,29 @@ ${stack ?? ""}`;
             sorts,
             skip: skip ?? 0,
             limit: limit ?? 0,
-            joins
+            joins,
+            includeCount
           });
           const pool = poolOverride ?? modelInstance._readonlyPool;
           const results = await pool.query(query, params);
-          const entities = modelInstance._buildInstances(results.rows);
+          let totalCount = 0;
+          if (includeCount && results.rows.length > 0 && results.rows[0]?.__total_count__ !== void 0) {
+            totalCount = Number(results.rows[0].__total_count__);
+          }
+          const rows = includeCount ? results.rows.map((row) => {
+            const { __total_count__, ...rest } = row;
+            return rest;
+          }) : results.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({
+              results: entities,
+              totalCount
+            });
           }
           return await resolve(entities);
         } catch (ex) {
@@ -2390,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) {
@@ -2506,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]];
@@ -2525,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,
@@ -2533,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;
@@ -2585,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,
@@ -2593,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 {
@@ -569,6 +593,51 @@ interface PaginateOptions {
     page: number;
 }
 
+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>;
+    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>): FindQueryWithCount<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindQueryWithCount<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>>): FindQueryWithCount<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindQueryWithCount<T, TReturn, TJoins>;
+    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>;
@@ -579,7 +648,13 @@ interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never>
     limit(value: number): FindResult<T, TReturn, TJoins>;
     skip(value: number): FindResult<T, TReturn, TJoins>;
     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> {
@@ -791,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;
@@ -832,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;
@@ -1029,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, FindResult, 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 {
@@ -569,6 +593,51 @@ interface PaginateOptions {
     page: number;
 }
 
+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>;
+    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>): FindQueryWithCount<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindQueryWithCount<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>>): FindQueryWithCount<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindQueryWithCount<T, TReturn, TJoins>;
+    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>;
@@ -579,7 +648,13 @@ interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never>
     limit(value: number): FindResult<T, TReturn, TJoins>;
     skip(value: number): FindResult<T, TReturn, TJoins>;
     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> {
@@ -791,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;
@@ -832,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;
@@ -1029,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, FindResult, 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 {
@@ -569,6 +593,51 @@ interface PaginateOptions {
     page: number;
 }
 
+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>;
+    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>): FindQueryWithCount<T, Omit<TReturn, TProperty> & Populated<T, TProperty, TPopulateType, TPopulateSelectKeys>, TJoins>;
+    join<TProperty extends ModelRelationshipKeys<T>, TAlias extends string = TProperty>(propertyName: TProperty, alias?: TAlias): FindQueryWithCount<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>>): FindQueryWithCount<T, TReturn, JoinInfo<TProperty, TAlias, GetValueType<T[TProperty], Entity>> | TJoins>;
+    sort(value?: JoinedSort<T, TJoins>): FindQueryWithCount<T, TReturn, TJoins>;
+    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>;
@@ -579,7 +648,13 @@ interface FindResult<T extends Entity, TReturn, TJoins extends JoinInfo = never>
     limit(value: number): FindResult<T, TReturn, TJoins>;
     skip(value: number): FindResult<T, TReturn, TJoins>;
     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> {
@@ -791,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;
@@ -832,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;
@@ -1029,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, FindResult, 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

@@ -443,13 +443,17 @@ function getSelectQueryAndParams({
   sorts,
   skip,
   limit,
-  joins
+  joins,
+  includeCount
 }) {
   let query = "SELECT ";
   query += getColumnsToSelect({
     model,
     select
   });
+  if (includeCount) {
+    query += ',count(*) OVER() AS "__total_count__"';
+  }
   query += ` FROM ${model.qualifiedTableName}`;
   const params = [];
   if (joins?.length) {
@@ -899,7 +903,7 @@ function buildJoinClauses({
     if (alias !== relatedModel.tableName) {
       joinSql += ` AS "${alias}"`;
     }
-    joinSql += ` ON ${model.qualifiedTableName}."${column.name}" = "${alias}"."${relatedPrimaryKey.name}"`;
+    joinSql += ` ON ${model.qualifiedTableName}."${column.name}"="${alias}"."${relatedPrimaryKey.name}"`;
     if (join.on) {
       for (const [propertyName, value] of Object.entries(join.on)) {
         const onColumn = relatedModel.columnsByPropertyName[propertyName];
@@ -1955,6 +1959,7 @@ class ReadonlyRepository {
     const manuallySetFields = [];
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2044,6 +2049,10 @@ class ReadonlyRepository {
         });
         return this;
       },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2063,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;
@@ -2143,6 +2153,8 @@ ${stack ?? ""}`;
     const populates = [];
     const sorts = sort ? this._convertSortsToOrderBy(sort) : [];
     const joins = [];
+    let includeCount = false;
+    let returnAsPlainObjects = false;
     const modelInstance = this;
     return {
       /**
@@ -2253,6 +2265,14 @@ ${stack ?? ""}`;
         const safePage = Math.max(page, 1);
         return this.skip(safePage * paginateLimit - paginateLimit).limit(paginateLimit);
       },
+      withCount() {
+        includeCount = true;
+        return this;
+      },
+      toJSON() {
+        returnAsPlainObjects = true;
+        return this;
+      },
       async then(resolve, reject) {
         try {
           if (typeof where === "string") {
@@ -2266,13 +2286,29 @@ ${stack ?? ""}`;
             sorts,
             skip: skip ?? 0,
             limit: limit ?? 0,
-            joins
+            joins,
+            includeCount
           });
           const pool = poolOverride ?? modelInstance._readonlyPool;
           const results = await pool.query(query, params);
-          const entities = modelInstance._buildInstances(results.rows);
+          let totalCount = 0;
+          if (includeCount && results.rows.length > 0 && results.rows[0]?.__total_count__ !== void 0) {
+            totalCount = Number(results.rows[0].__total_count__);
+          }
+          const rows = includeCount ? results.rows.map((row) => {
+            const { __total_count__, ...rest } = row;
+            return rest;
+          }) : results.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({
+              results: entities,
+              totalCount
+            });
           }
           return await resolve(entities);
         } catch (ex) {
@@ -2388,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) {
@@ -2504,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]];
@@ -2523,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,
@@ -2531,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;
@@ -2583,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,
@@ -2591,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.3.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",