@abejarano/ts-mongodb-criteria 1.4.0 → 1.5.1

package/README.md

@@ -147,19 +147,39 @@ const criteria = new Criteria(
 
 // 3. Use with your MongoDB repository
 class UserRepository extends MongoRepository<User> {
+  constructor() {
+    super(User)
+  }
+
   collectionName(): string {
     return "users"
   }
 }
 
 const userRepo = new UserRepository()
-const users = await userRepo.searchByCriteria(criteria)
+const { results } = await userRepo.list(criteria)
 ```
 
 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
+Internal helpers are private, so repositories should call these public methods
+directly.
+
+If you need a repository interface in your app, extend `IRepository<T>` so your
+custom interfaces stay aligned with the library return types:
+
+```typescript
+import { IRepository } from "@abejarano/ts-mongodb-criteria"
+
+export interface IUserRepository extends IRepository<User> {
+  // Add domain-specific methods here
+}
+```
+
+The goal of `IRepository` is to prevent signature drift (e.g. `upsert` returning
+`void` in your app while the base repository returns `ObjectId | null`).
 
 **Your First Query in 30 Seconds:**
 

package/dist/cjs/mongo/IRepository.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/mongo/MongoRepository.js

@@ -21,7 +21,7 @@ class MongoRepository {
     }
     /** Upserts an aggregate by delegating to persist with its id. */
     async upsert(entity) {
-        return this.persist(entity.getId(), entity);
+        await this.persist(entity.getId(), entity);
     }
     /** Lists entities by criteria and returns a paginated response. */
     async list(criteria, fieldsToExclude = []) {
@@ -35,10 +35,9 @@ class MongoRepository {
     }
     async updateOne(filter, update) {
         const collection = await this.collection();
-        const result = await collection.updateOne(filter, update, {
+        await collection.updateOne(filter, update, {
             upsert: true,
         });
-        return result.upsertedId;
     }
     async persist(id, aggregateRoot) {
         let primitives;
@@ -48,7 +47,7 @@ class MongoRepository {
         else {
             primitives = aggregateRoot.toPrimitives();
         }
-        return await this.updateOne({ _id: new mongodb_1.ObjectId(id) }, {
+        await this.updateOne({ _id: new mongodb_1.ObjectId(id) }, {
             $set: {
                 ...primitives,
                 id: id,

package/dist/cjs/mongo/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./MongoCriteriaConverter"), exports);
 __exportStar(require("./MongoRepository"), exports);
+__exportStar(require("./IRepository"), exports);
 __exportStar(require("./MongoClientFactory"), exports);

package/dist/esm/mongo/IRepository.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/mongo/MongoRepository.js

@@ -18,7 +18,7 @@ export class MongoRepository {
     }
     /** Upserts an aggregate by delegating to persist with its id. */
     async upsert(entity) {
-        return this.persist(entity.getId(), entity);
+        await this.persist(entity.getId(), entity);
     }
     /** Lists entities by criteria and returns a paginated response. */
     async list(criteria, fieldsToExclude = []) {
@@ -32,10 +32,9 @@ export class MongoRepository {
     }
     async updateOne(filter, update) {
         const collection = await this.collection();
-        const result = await collection.updateOne(filter, update, {
+        await collection.updateOne(filter, update, {
             upsert: true,
         });
-        return result.upsertedId;
     }
     async persist(id, aggregateRoot) {
         let primitives;
@@ -45,7 +44,7 @@ export class MongoRepository {
         else {
             primitives = aggregateRoot.toPrimitives();
         }
-        return await this.updateOne({ _id: new ObjectId(id) }, {
+        await this.updateOne({ _id: new ObjectId(id) }, {
             $set: {
                 ...primitives,
                 id: id,

package/dist/esm/mongo/index.js

@@ -1,3 +1,4 @@
 export * from "./MongoCriteriaConverter";
 export * from "./MongoRepository";
+export * from "./IRepository";
 export * from "./MongoClientFactory";

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

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

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

@@ -1,6 +1,6 @@
 import { Criteria, Paginate } from "../criteria";
 import { AggregateRoot, AggregateRootClass } from "../AggregateRoot";
-import { Collection, ObjectId, UpdateFilter } from "mongodb";
+import { Collection, UpdateFilter } from "mongodb";
 export declare abstract class MongoRepository<T extends AggregateRoot> {
     private readonly aggregateRootClass;
     private criteriaConverter;
@@ -11,11 +11,11 @@ export declare abstract class MongoRepository<T extends AggregateRoot> {
     /** Finds a single entity and hydrates it via the aggregate's fromPrimitives. */
     one(filter: object): Promise<T | null>;
     /** Upserts an aggregate by delegating to persist with its id. */
-    upsert(entity: T): Promise<ObjectId | null>;
+    upsert(entity: T): Promise<void>;
     /** Lists entities by criteria and returns a paginated response. */
     list<D>(criteria: Criteria, fieldsToExclude?: string[]): Promise<Paginate<D>>;
     protected collection<T extends Document>(): Promise<Collection<T>>;
-    protected updateOne(filter: object, update: Document[] | UpdateFilter<any>): Promise<ObjectId | null>;
+    protected updateOne(filter: object, update: Document[] | UpdateFilter<any>): Promise<void>;
     private persist;
     private searchByCriteria;
     private paginate;

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

@@ -1,3 +1,4 @@
 export * from "./MongoCriteriaConverter";
 export * from "./MongoRepository";
+export * from "./IRepository";
 export * from "./MongoClientFactory";

package/package.json

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