@abejarano/ts-mongodb-criteria 1.10.0 → 1.11.0

package/README.md

@@ -182,8 +182,9 @@ Use the `collection` argument inside `ensureIndexes` to avoid recursion.
 MongoRepository provides ready-to-use public methods for repositories that extend it:
 
 - `list(criteria, fieldsToExclude?)` for paginated queries
-- `one(filter)` to fetch a single entity
-- `upsert(entity)` to persist an aggregate
+- `many(filter, transaction?)` to fetch multiple entities matching a filter
+- `one(filter, transaction?)` to fetch a single entity
+- `upsert(entity, transaction?)` to persist an aggregate
   Internal helpers are private, so repositories should call these public methods
   directly.
 
@@ -217,6 +218,7 @@ await MongoTransaction.run(async (tx) => {
 
   // Reads can observe writes made earlier in this transaction.
   const persistedUser = await userRepository.one({ id: user.getId() }, tx)
+  const activeUsers = await userRepository.many({ status: "active" }, tx)
 })
 ```
 
@@ -236,7 +238,7 @@ async deactivateUser(id: string, tx: MongoTransaction): Promise<void> {
 MongoDB transactions require a replica set or a sharded cluster; standalone
 MongoDB instances do not support them. This initial API applies the transaction
 context to `upsert`, `delete`, protected `updateOne`, `one`, and `list`.
-Pass `tx` as the third argument to `list` after `fieldsToExclude`.
+Pass `tx` as the third argument to `list` after `fieldsToExclude`, and as the second argument to `many`.
 
 **Your First Query in 30 Seconds:**
 

package/dist/cjs/mongo/MongoRepository.js

@@ -25,6 +25,17 @@ class MongoRepository {
             id: result._id.toString(),
         });
     }
+    async many(filter, transaction) {
+        const collection = await this.collection();
+        const session = MongoTransaction_1.MongoTransaction.sessionFor(transaction);
+        const documents = await collection
+            .find(filter, session === undefined ? undefined : { session })
+            .toArray();
+        return documents.map((document) => this.aggregateRootClass.fromPrimitives({
+            ...document,
+            id: document._id.toString(),
+        }));
+    }
     /** Upserts an aggregate by delegating to persist with its id. */
     async upsert(entity, transaction) {
         await this.persist(entity.getId(), entity, transaction);

package/dist/esm/mongo/MongoRepository.js

@@ -22,6 +22,17 @@ export class MongoRepository {
             id: result._id.toString(),
         });
     }
+    async many(filter, transaction) {
+        const collection = await this.collection();
+        const session = MongoTransaction.sessionFor(transaction);
+        const documents = await collection
+            .find(filter, session === undefined ? undefined : { session })
+            .toArray();
+        return documents.map((document) => this.aggregateRootClass.fromPrimitives({
+            ...document,
+            id: document._id.toString(),
+        }));
+    }
     /** Upserts an aggregate by delegating to persist with its id. */
     async upsert(entity, transaction) {
         await this.persist(entity.getId(), entity, transaction);

package/dist/types/mongo/IRepository.d.ts

@@ -3,6 +3,7 @@ import { AggregateRoot } from "../AggregateRoot";
 import { DeleteOptions } from "mongodb";
 import { MongoTransaction } from "./MongoTransaction";
 export interface IRepository<T extends AggregateRoot> {
+    many(filter: object, transaction?: MongoTransaction): Promise<T[]>;
     one(filter: object, transaction?: MongoTransaction): Promise<T | null>;
     list<D>(criteria: Criteria, fieldsToExclude?: string[], transaction?: MongoTransaction): Promise<Paginate<D>>;
     upsert(entity: T, transaction?: MongoTransaction): Promise<void>;

package/dist/types/mongo/MongoRepository.d.ts

@@ -12,6 +12,7 @@ export declare abstract class MongoRepository<T extends AggregateRoot> {
     abstract collectionName(): string;
     /** Finds a single entity and hydrates it via the aggregate's fromPrimitives. */
     one(filter: object, transaction?: MongoTransaction): Promise<T | null>;
+    many(filter: object, transaction?: MongoTransaction): Promise<T[]>;
     /** Upserts an aggregate by delegating to persist with its id. */
     upsert(entity: T, transaction?: MongoTransaction): Promise<void>;
     /** Lists entities by criteria and returns a paginated response. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@abejarano/ts-mongodb-criteria",
   "author": "angel bejarano / angel.bejarano@jaspesoft.com",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Patrón Criteria para consultas MongoDB en TypeScript",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",