@opra/mongodb 1.0.10 → 1.1.1

package/cjs/adapter-utils/prepare-projection.js

@@ -4,6 +4,8 @@ exports.default = prepareProjection;
 exports.prepare = prepare;
 const common_1 = require("@opra/common");
 function prepareProjection(dataType, projection) {
+    if (projection === '*')
+        return undefined;
     if (projection && typeof projection === 'object' && !Array.isArray(projection))
         return projection;
     const out = {};

package/cjs/mongo-adapter.js

@@ -64,6 +64,16 @@ var MongoAdapter;
                     };
                     return { method: 'get', key, options };
                 }
+                case 'Entity.Replace': {
+                    const data = await ctx.getBody();
+                    const keyParam = operation.parameters.find(p => p.keyParam) || controller.parameters.find(p => p.keyParam);
+                    const key = keyParam && ctx.pathParams[String(keyParam.name)];
+                    const options = {
+                        projection: ctx.queryParams.projection,
+                        filter: ctx.queryParams.filter,
+                    };
+                    return { method: 'replace', key, data, options };
+                }
                 case 'Entity.Update': {
                     const data = await ctx.getBody();
                     const keyParam = operation.parameters.find(p => p.keyParam) || controller.parameters.find(p => p.keyParam);

package/cjs/mongo-collection-service.js

@@ -74,8 +74,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._count(command);
         });
     }
@@ -95,8 +98,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._delete(command);
         });
     }
@@ -114,8 +120,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._deleteMany(command);
         });
     }
@@ -134,8 +143,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._distinct(command);
         });
     }
@@ -155,10 +167,12 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const documentFilter = await this._getDocumentFilter(command);
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
             const findCommand = command;
-            findCommand.options = { ...command.options, filter, projection: ['_id'] };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                findCommand.options = { ...command.options, filter, projection: ['_id'] };
+            }
             return !!(await this._findById(findCommand));
         });
     }
@@ -181,8 +195,10 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
         };
         return this._executeCommand(command, async () => {
             const documentFilter = await this._getDocumentFilter(command);
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
-            command.options = { ...command.options, filter };
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._findById(command);
         });
     }
@@ -194,8 +210,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._findOne(command);
         });
     }
@@ -207,9 +226,14 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
+            const documentFilter = await this._getDocumentFilter(command);
+            command.options = command.options || {};
+            if (documentFilter) {
+                command.options.filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+            }
             const limit = command.options?.limit || this.defaultLimit;
-            command.options = { ...command.options, filter, limit };
+            if (limit)
+                command.options.limit = limit;
             return this._findMany(command);
         });
     }
@@ -221,8 +245,14 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter, limit: command.options?.limit || this.defaultLimit };
+            const documentFilter = await this._getDocumentFilter(command);
+            command.options = command.options || {};
+            if (documentFilter) {
+                command.options.filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+            }
+            const limit = command.options?.limit || this.defaultLimit;
+            if (limit)
+                command.options.limit = limit;
             return this._findManyWithCount(command);
         });
     }
@@ -232,6 +262,25 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             throw new common_1.ResourceNotAvailableError(this.getResourceName(), id);
         return out;
     }
+    async replace(id, input, options) {
+        const command = {
+            crud: 'replace',
+            method: 'replace',
+            documentId: id,
+            byId: true,
+            input,
+            options,
+        };
+        input._id = id;
+        return this._executeCommand(command, async () => {
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
+            return await this._replace(command);
+        });
+    }
     async update(id, input, options) {
         const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
         const command = {
@@ -244,8 +293,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._update(command);
         });
     }
@@ -269,8 +321,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._updateOnly(command);
         });
     }
@@ -292,8 +347,11 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._updateMany(command);
         });
     }

package/cjs/mongo-entity-service.js

@@ -131,10 +131,11 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
         const { options } = command;
         const db = this.getDatabase();
         const collection = await this.getCollection(db);
+        const projection = mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection);
         const out = await collection.findOne(filter || {}, {
             ...(0, lodash_omit_1.default)(options, 'filter'),
             session: options?.session ?? this.getSession(),
-            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
+            projection,
             limit: undefined,
             skip: undefined,
             sort: undefined,
@@ -309,6 +310,36 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
         if (out)
             return outputCodec(out);
     }
+    /**
+     * Replaces a document with the given id in the collection
+     *
+     * @param {MongoEntityService.ReplaceCommand<T>} command
+     */
+    async _replace(command) {
+        const input = command.input;
+        (0, valgen_1.isNotNullish)(input, { label: 'input' });
+        (0, valgen_1.isNotNullish)(input._id, { label: 'input._id' });
+        const inputCodec = this._getInputCodec('replace');
+        const document = inputCodec(input);
+        const { options } = command;
+        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([
+            mongo_adapter_js_1.MongoAdapter.prepareKeyValues(command.documentId, ['_id']),
+            options?.filter,
+        ]);
+        const db = this.getDatabase();
+        const collection = await this.getCollection(db);
+        const out = await collection.findOneAndReplace(filter || {}, document, {
+            upsert: undefined,
+            ...options,
+            returnDocument: 'after',
+            includeResultMetadata: false,
+            session: options?.session ?? this.getSession(),
+            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
+        });
+        const outputCodec = this._getOutputCodec('replace');
+        if (out)
+            return outputCodec(out);
+    }
     /**
      * Updates a document in the collection with the specified ID.
      *
@@ -382,36 +413,42 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
                 /** Call before[X] hooks */
                 if (command.crud === 'create')
                     await this._beforeCreate(command);
-                else if (command.crud === 'update' && command.byId) {
-                    await this._beforeUpdate(command);
-                }
-                else if (command.crud === 'update' && !command.byId) {
-                    await this._beforeUpdateMany(command);
-                }
                 else if (command.crud === 'delete' && command.byId) {
                     await this._beforeDelete(command);
                 }
                 else if (command.crud === 'delete' && !command.byId) {
                     await this._beforeDeleteMany(command);
                 }
+                else if (command.crud === 'replace') {
+                    await this._beforeReplace(command);
+                }
+                else if (command.crud === 'update' && command.byId) {
+                    await this._beforeUpdate(command);
+                }
+                else if (command.crud === 'update' && !command.byId) {
+                    await this._beforeUpdateMany(command);
+                }
                 /** Call command function */
                 return commandFn();
             });
             /** Call after[X] hooks */
             if (command.crud === 'create')
                 await this._afterCreate(command, result);
-            else if (command.crud === 'update' && command.byId) {
-                await this._afterUpdate(command, result);
-            }
-            else if (command.crud === 'update' && !command.byId) {
-                await this._afterUpdateMany(command, result);
-            }
             else if (command.crud === 'delete' && command.byId) {
                 await this._afterDelete(command, result);
             }
             else if (command.crud === 'delete' && !command.byId) {
                 await this._afterDeleteMany(command, result);
             }
+            else if (command.crud === 'replace') {
+                await this._afterReplace(command, result);
+            }
+            else if (command.crud === 'update' && command.byId) {
+                await this._afterUpdate(command, result);
+            }
+            else if (command.crud === 'update' && !command.byId) {
+                await this._afterUpdateMany(command, result);
+            }
             return result;
         }
         catch (e) {
@@ -425,31 +462,31 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeUpdate(command) {
+    async _beforeDelete(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeUpdateMany(command) {
+    async _beforeDeleteMany(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeDelete(command) {
+    async _beforeReplace(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeDeleteMany(command) {
+    async _beforeUpdate(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _afterCreate(command, result) {
+    async _beforeUpdateMany(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _afterUpdate(command, result) {
+    async _afterCreate(command, result) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _afterUpdateMany(command, affected) {
+    async _afterReplace(command, result) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -460,5 +497,13 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     async _afterDeleteMany(command, affected) {
         // Do nothing
     }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async _afterUpdate(command, result) {
+        // Do nothing
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async _afterUpdateMany(command, affected) {
+        // Do nothing
+    }
 }
 exports.MongoEntityService = MongoEntityService;

package/esm/adapter-utils/prepare-projection.js

@@ -1,5 +1,7 @@
 import { ComplexType, parseFieldsProjection } from '@opra/common';
 export default function prepareProjection(dataType, projection) {
+    if (projection === '*')
+        return undefined;
     if (projection && typeof projection === 'object' && !Array.isArray(projection))
         return projection;
     const out = {};

package/esm/mongo-adapter.js

@@ -60,6 +60,16 @@ export var MongoAdapter;
                     };
                     return { method: 'get', key, options };
                 }
+                case 'Entity.Replace': {
+                    const data = await ctx.getBody();
+                    const keyParam = operation.parameters.find(p => p.keyParam) || controller.parameters.find(p => p.keyParam);
+                    const key = keyParam && ctx.pathParams[String(keyParam.name)];
+                    const options = {
+                        projection: ctx.queryParams.projection,
+                        filter: ctx.queryParams.filter,
+                    };
+                    return { method: 'replace', key, data, options };
+                }
                 case 'Entity.Update': {
                     const data = await ctx.getBody();
                     const keyParam = operation.parameters.find(p => p.keyParam) || controller.parameters.find(p => p.keyParam);

package/esm/mongo-collection-service.js

@@ -70,8 +70,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._count(command);
         });
     }
@@ -91,8 +94,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._delete(command);
         });
     }
@@ -110,8 +116,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._deleteMany(command);
         });
     }
@@ -130,8 +139,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._distinct(command);
         });
     }
@@ -151,10 +163,12 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const documentFilter = await this._getDocumentFilter(command);
-            const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
             const findCommand = command;
-            findCommand.options = { ...command.options, filter, projection: ['_id'] };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                findCommand.options = { ...command.options, filter, projection: ['_id'] };
+            }
             return !!(await this._findById(findCommand));
         });
     }
@@ -177,8 +191,10 @@ export class MongoCollectionService extends MongoEntityService {
         };
         return this._executeCommand(command, async () => {
             const documentFilter = await this._getDocumentFilter(command);
-            const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
-            command.options = { ...command.options, filter };
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._findById(command);
         });
     }
@@ -190,8 +206,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._findOne(command);
         });
     }
@@ -203,9 +222,14 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
+            const documentFilter = await this._getDocumentFilter(command);
+            command.options = command.options || {};
+            if (documentFilter) {
+                command.options.filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+            }
             const limit = command.options?.limit || this.defaultLimit;
-            command.options = { ...command.options, filter, limit };
+            if (limit)
+                command.options.limit = limit;
             return this._findMany(command);
         });
     }
@@ -217,8 +241,14 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter, limit: command.options?.limit || this.defaultLimit };
+            const documentFilter = await this._getDocumentFilter(command);
+            command.options = command.options || {};
+            if (documentFilter) {
+                command.options.filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+            }
+            const limit = command.options?.limit || this.defaultLimit;
+            if (limit)
+                command.options.limit = limit;
             return this._findManyWithCount(command);
         });
     }
@@ -228,6 +258,25 @@ export class MongoCollectionService extends MongoEntityService {
             throw new ResourceNotAvailableError(this.getResourceName(), id);
         return out;
     }
+    async replace(id, input, options) {
+        const command = {
+            crud: 'replace',
+            method: 'replace',
+            documentId: id,
+            byId: true,
+            input,
+            options,
+        };
+        input._id = id;
+        return this._executeCommand(command, async () => {
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
+            return await this._replace(command);
+        });
+    }
     async update(id, input, options) {
         const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
         const command = {
@@ -240,8 +289,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._update(command);
         });
     }
@@ -265,8 +317,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._updateOnly(command);
         });
     }
@@ -288,8 +343,11 @@ export class MongoCollectionService extends MongoEntityService {
             options,
         };
         return this._executeCommand(command, async () => {
-            const filter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command), command.options?.filter]);
-            command.options = { ...command.options, filter };
+            const documentFilter = await this._getDocumentFilter(command);
+            if (documentFilter) {
+                const filter = MongoAdapter.prepareFilter([documentFilter, command.options?.filter]);
+                command.options = { ...command.options, filter };
+            }
             return this._updateMany(command);
         });
     }

package/esm/mongo-entity-service.js

@@ -127,10 +127,11 @@ export class MongoEntityService extends MongoService {
         const { options } = command;
         const db = this.getDatabase();
         const collection = await this.getCollection(db);
+        const projection = MongoAdapter.prepareProjection(this.dataType, options?.projection);
         const out = await collection.findOne(filter || {}, {
             ...omit(options, 'filter'),
             session: options?.session ?? this.getSession(),
-            projection: MongoAdapter.prepareProjection(this.dataType, options?.projection),
+            projection,
             limit: undefined,
             skip: undefined,
             sort: undefined,
@@ -305,6 +306,36 @@ export class MongoEntityService extends MongoService {
         if (out)
             return outputCodec(out);
     }
+    /**
+     * Replaces a document with the given id in the collection
+     *
+     * @param {MongoEntityService.ReplaceCommand<T>} command
+     */
+    async _replace(command) {
+        const input = command.input;
+        isNotNullish(input, { label: 'input' });
+        isNotNullish(input._id, { label: 'input._id' });
+        const inputCodec = this._getInputCodec('replace');
+        const document = inputCodec(input);
+        const { options } = command;
+        const filter = MongoAdapter.prepareFilter([
+            MongoAdapter.prepareKeyValues(command.documentId, ['_id']),
+            options?.filter,
+        ]);
+        const db = this.getDatabase();
+        const collection = await this.getCollection(db);
+        const out = await collection.findOneAndReplace(filter || {}, document, {
+            upsert: undefined,
+            ...options,
+            returnDocument: 'after',
+            includeResultMetadata: false,
+            session: options?.session ?? this.getSession(),
+            projection: MongoAdapter.prepareProjection(this.dataType, options?.projection),
+        });
+        const outputCodec = this._getOutputCodec('replace');
+        if (out)
+            return outputCodec(out);
+    }
     /**
      * Updates a document in the collection with the specified ID.
      *
@@ -378,36 +409,42 @@ export class MongoEntityService extends MongoService {
                 /** Call before[X] hooks */
                 if (command.crud === 'create')
                     await this._beforeCreate(command);
-                else if (command.crud === 'update' && command.byId) {
-                    await this._beforeUpdate(command);
-                }
-                else if (command.crud === 'update' && !command.byId) {
-                    await this._beforeUpdateMany(command);
-                }
                 else if (command.crud === 'delete' && command.byId) {
                     await this._beforeDelete(command);
                 }
                 else if (command.crud === 'delete' && !command.byId) {
                     await this._beforeDeleteMany(command);
                 }
+                else if (command.crud === 'replace') {
+                    await this._beforeReplace(command);
+                }
+                else if (command.crud === 'update' && command.byId) {
+                    await this._beforeUpdate(command);
+                }
+                else if (command.crud === 'update' && !command.byId) {
+                    await this._beforeUpdateMany(command);
+                }
                 /** Call command function */
                 return commandFn();
             });
             /** Call after[X] hooks */
             if (command.crud === 'create')
                 await this._afterCreate(command, result);
-            else if (command.crud === 'update' && command.byId) {
-                await this._afterUpdate(command, result);
-            }
-            else if (command.crud === 'update' && !command.byId) {
-                await this._afterUpdateMany(command, result);
-            }
             else if (command.crud === 'delete' && command.byId) {
                 await this._afterDelete(command, result);
             }
             else if (command.crud === 'delete' && !command.byId) {
                 await this._afterDeleteMany(command, result);
             }
+            else if (command.crud === 'replace') {
+                await this._afterReplace(command, result);
+            }
+            else if (command.crud === 'update' && command.byId) {
+                await this._afterUpdate(command, result);
+            }
+            else if (command.crud === 'update' && !command.byId) {
+                await this._afterUpdateMany(command, result);
+            }
             return result;
         }
         catch (e) {
@@ -421,31 +458,31 @@ export class MongoEntityService extends MongoService {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeUpdate(command) {
+    async _beforeDelete(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeUpdateMany(command) {
+    async _beforeDeleteMany(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeDelete(command) {
+    async _beforeReplace(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _beforeDeleteMany(command) {
+    async _beforeUpdate(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _afterCreate(command, result) {
+    async _beforeUpdateMany(command) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _afterUpdate(command, result) {
+    async _afterCreate(command, result) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async _afterUpdateMany(command, affected) {
+    async _afterReplace(command, result) {
         // Do nothing
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -456,4 +493,12 @@ export class MongoEntityService extends MongoService {
     async _afterDeleteMany(command, affected) {
         // Do nothing
     }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async _afterUpdate(command, result) {
+        // Do nothing
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async _afterUpdateMany(command, affected) {
+        // Do nothing
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opra/mongodb",
-  "version": "1.0.10",
+  "version": "1.1.1",
   "description": "Opra MongoDB adapter package",
   "author": "Panates",
   "license": "MIT",
@@ -11,9 +11,9 @@
     "valgen": "^5.12.0"
   },
   "peerDependencies": {
-    "@opra/common": "^1.0.10",
-    "@opra/core": "^1.0.10",
-    "@opra/http": "^1.0.10",
+    "@opra/common": "^1.1.1",
+    "@opra/core": "^1.1.1",
+    "@opra/http": "^1.1.1",
     "mongodb": ">= 6.0.0"
   },
   "type": "module",

package/types/adapter-utils/prepare-projection.d.ts

@@ -1,4 +1,4 @@
 import { ComplexType, FieldsProjection } from '@opra/common';
 import mongodb, { type Document } from 'mongodb';
-export default function prepareProjection(dataType: ComplexType, projection?: string | string[] | Document): mongodb.Document | undefined;
+export default function prepareProjection(dataType: ComplexType, projection?: string | string[] | Document | '*'): mongodb.Document | undefined;
 export declare function prepare(dataType: ComplexType, target: mongodb.Document, projection?: FieldsProjection): void;

package/types/mongo-adapter.d.ts

@@ -15,7 +15,7 @@ export declare namespace MongoAdapter {
     const prepareProjection: typeof _prepareProjection;
     const prepareSort: typeof _prepareSort;
     interface TransformedRequest {
-        method: 'create' | 'delete' | 'deleteMany' | 'get' | 'findMany' | 'update' | 'updateMany';
+        method: 'create' | 'delete' | 'deleteMany' | 'get' | 'findMany' | 'replace' | 'update' | 'updateMany';
         key?: any;
         data?: any;
         options: any;

package/types/mongo-collection-service.d.ts

@@ -152,6 +152,18 @@ export declare class MongoCollectionService<T extends mongodb.Document> extends
      */
     get(id: MongoAdapter.AnyId, options: RequiredSome<MongoEntityService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T>>;
     get(id: MongoAdapter.AnyId, options?: MongoEntityService.FindOneOptions<T>): Promise<T>;
+    /**
+     * Replace a document in the MongoDB collection.
+     * Interceptors will be called before performing db operation
+     *
+     * @param {MongoAdapter.AnyId} id - The id of the document to replace.
+     * @param {PartialDTO<T>} input - The input data
+     * @param {MongoEntityService.ReplaceOptions} [options] - The options for replacing the document.
+     * @returns {Promise<PartialDTO<T>>} A promise that resolves to the replaced document.
+     * @throws {Error} if an unknown error occurs while replacing the document.
+     */
+    replace(id: MongoAdapter.AnyId, input: PartialDTO<T>, options: RequiredSome<MongoEntityService.ReplaceOptions<T>, 'projection'>): Promise<PartialDTO<T>>;
+    replace(id: MongoAdapter.AnyId, input: PartialDTO<T>, options?: MongoEntityService.CreateOptions): Promise<T>;
     /**
      * Updates a document with the given id in the collection.
      *

package/types/mongo-entity-service.d.ts

@@ -32,6 +32,8 @@ export declare namespace MongoEntityService {
     }
     interface FindManyOptions<T> extends MongoService.FindManyOptions<T> {
     }
+    interface ReplaceOptions<T> extends MongoService.ReplaceOptions<T> {
+    }
     interface UpdateOneOptions<T> extends MongoService.UpdateOneOptions<T> {
     }
     interface UpdateManyOptions<T> extends MongoService.UpdateManyOptions<T> {
@@ -78,6 +80,11 @@ export declare namespace MongoEntityService {
         inputRaw?: mongodb.UpdateFilter<T>;
         options?: UpdateManyOptions<T>;
     }
+    interface ReplaceCommand<T> extends StrictOmit<CommandInfo, 'nestedId'> {
+        crud: 'replace';
+        input: PartialDTO<T>;
+        options?: ReplaceOptions<T>;
+    }
 }
 /**
  * @class MongoEntityService
@@ -161,6 +168,12 @@ export declare class MongoEntityService<T extends mongodb.Document> extends Mong
      * @param {MongoEntityService.UpdateOneCommand<T>} command
      */
     protected _update(command: MongoEntityService.UpdateOneCommand<T>): Promise<PartialDTO<T> | undefined>;
+    /**
+     * Replaces a document with the given id in the collection
+     *
+     * @param {MongoEntityService.ReplaceCommand<T>} command
+     */
+    protected _replace(command: MongoEntityService.ReplaceCommand<T>): Promise<PartialDTO<T> | undefined>;
     /**
      * Updates a document in the collection with the specified ID.
      *
@@ -175,13 +188,15 @@ export declare class MongoEntityService<T extends mongodb.Document> extends Mong
     protected _updateMany(command: MongoEntityService.UpdateManyCommand<T>): Promise<number>;
     protected _executeCommand(command: MongoEntityService.CommandInfo, commandFn: () => any): Promise<any>;
     protected _beforeCreate(command: MongoEntityService.CreateCommand<T>): Promise<void>;
-    protected _beforeUpdate(command: MongoEntityService.UpdateOneCommand<T>): Promise<void>;
-    protected _beforeUpdateMany(command: MongoEntityService.UpdateManyCommand<T>): Promise<void>;
     protected _beforeDelete(command: MongoEntityService.DeleteCommand<T>): Promise<void>;
     protected _beforeDeleteMany(command: MongoEntityService.DeleteCommand<T>): Promise<void>;
+    protected _beforeReplace(command: MongoEntityService.ReplaceCommand<T>): Promise<void>;
+    protected _beforeUpdate(command: MongoEntityService.UpdateOneCommand<T>): Promise<void>;
+    protected _beforeUpdateMany(command: MongoEntityService.UpdateManyCommand<T>): Promise<void>;
     protected _afterCreate(command: MongoEntityService.CreateCommand<T>, result: PartialDTO<T>): Promise<void>;
-    protected _afterUpdate(command: MongoEntityService.UpdateOneCommand<T>, result?: PartialDTO<T>): Promise<void>;
-    protected _afterUpdateMany(command: MongoEntityService.UpdateManyCommand<T>, affected: number): Promise<void>;
+    protected _afterReplace(command: MongoEntityService.ReplaceCommand<T>, result: PartialDTO<T>): Promise<void>;
     protected _afterDelete(command: MongoEntityService.DeleteCommand<T>, affected: number): Promise<void>;
     protected _afterDeleteMany(command: MongoEntityService.DeleteCommand<T>, affected: number): Promise<void>;
+    protected _afterUpdate(command: MongoEntityService.UpdateOneCommand<T>, result?: PartialDTO<T>): Promise<void>;
+    protected _afterUpdateMany(command: MongoEntityService.UpdateManyCommand<T>, affected: number): Promise<void>;
 }

package/types/mongo-service.d.ts

@@ -20,7 +20,7 @@ export declare namespace MongoService {
         idGenerator?: MongoService<any>['idGenerator'];
         onError?: MongoService<any>['onError'];
     }
-    type CrudOp = 'create' | 'read' | 'update' | 'delete';
+    type CrudOp = 'create' | 'read' | 'replace' | 'update' | 'delete';
     interface CommandInfo {
         crud: CrudOp;
         method: string;
@@ -37,7 +37,7 @@ export declare namespace MongoService {
      * @interface
      */
     interface CreateOptions extends mongodb.InsertOneOptions {
-        projection?: string[];
+        projection?: string | string[] | Document | '*';
     }
     /**
      * Represents options for "count" operation
@@ -99,11 +99,20 @@ export declare namespace MongoService {
      */
     interface FindManyOptions<T> extends mongodb.AggregateOptions {
         filter?: MongoAdapter.FilterInput<T>;
-        projection?: string | string[] | Document;
+        projection?: string | string[] | Document | '*';
         sort?: string[];
         limit?: number;
         skip?: number;
     }
+    /**
+     * Represents options for "replace" operation
+     *
+     * @interface
+     */
+    interface ReplaceOptions<T> extends StrictOmit<mongodb.FindOneAndReplaceOptions, 'projection'> {
+        projection?: string | string[] | Document | '*';
+        filter?: MongoAdapter.FilterInput<T>;
+    }
     /**
      * Represents options for "update" operation
      *
@@ -111,7 +120,7 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface UpdateOneOptions<T> extends StrictOmit<mongodb.FindOneAndUpdateOptions, 'projection' | 'returnDocument' | 'includeResultMetadata'> {
-        projection?: string | string[] | Document;
+        projection?: string | string[] | Document | '*';
         filter?: MongoAdapter.FilterInput<T>;
     }
     /**