@opra/mongodb 1.0.0-alpha.16 → 1.0.0-alpha.18

package/esm/mongo-nested-service.js

@@ -1,5 +1,6 @@
 import { ComplexType, NotAcceptableError, ResourceNotAvailableError } from '@opra/common';
 import omit from 'lodash.omit';
+import { isNotNullish } from 'valgen';
 import { MongoAdapter } from './mongo-adapter.js';
 import { MongoService } from './mongo-service.js';
 /**
@@ -21,7 +22,7 @@ export class MongoNestedService extends MongoService {
         this.fieldName = fieldName;
         this.nestedKey = options?.nestedKey || '_id';
         this.defaultLimit = options?.defaultLimit || 10;
-        this.$nestedFilter = options?.$nestedFilter;
+        this.nestedFilter = options?.nestedFilter;
     }
     /**
      * Retrieves the data type of the array field
@@ -60,24 +61,21 @@ export class MongoNestedService extends MongoService {
      * @throws {ResourceNotAvailableError} - If the parent document is not found.
      */
     async create(documentId, input, options) {
-        const id = input._id || this._generateId();
-        if (id != null)
-            input._id = id;
-        const info = {
+        const command = {
             crud: 'create',
             method: 'create',
             byId: false,
             documentId,
-            nestedId: id,
             input,
             options,
         };
-        return this._intercept(() => this._create(documentId, input, options), info);
+        return this._executeCommand(command, () => this._create(command));
     }
-    async _create(documentId, input, options) {
+    async _create(command) {
         const inputCodec = this.getInputCodec('create');
-        const doc = inputCodec(input);
-        doc._id = doc._id || this._generateId();
+        const { documentId, options } = command;
+        const doc = inputCodec(command.input);
+        doc._id = doc._id || this._generateId(command);
         const docFilter = MongoAdapter.prepareKeyValues(documentId, ['_id']);
         const r = await this._dbUpdateOne(docFilter, {
             $push: { [this.fieldName]: doc },
@@ -85,12 +83,20 @@ export class MongoNestedService extends MongoService {
         if (r.matchedCount) {
             if (!options)
                 return doc;
-            const id = doc[this.nestedKey];
-            const out = await this._findById(documentId, id, {
-                ...options,
-                filter: undefined,
-                skip: undefined,
-            });
+            const findCommand = {
+                crud: 'read',
+                method: 'findById',
+                byId: true,
+                documentId,
+                nestedId: doc[this.nestedKey],
+                options: {
+                    ...options,
+                    sort: undefined,
+                    filter: undefined,
+                    skip: undefined,
+                },
+            };
+            const out = await this._findById(findCommand);
             if (out)
                 return out;
         }
@@ -104,20 +110,22 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<number>} - A promise that resolves to the count of documents.
      */
     async count(documentId, options) {
-        const info = {
+        const command = {
             crud: 'read',
             method: 'count',
             byId: false,
             documentId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._count(documentId, { ...options, filter, documentFilter });
-        }, info);
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = { ...command.options, filter, documentFilter };
+            return this._count(command);
+        });
     }
-    async _count(documentId, options) {
+    async _count(command) {
+        const { documentId, options } = command;
         const matchFilter = MongoAdapter.prepareFilter([
             MongoAdapter.prepareKeyValues(documentId, ['_id']),
             options?.documentFilter,
@@ -150,7 +158,7 @@ export class MongoNestedService extends MongoService {
      * @return {Promise<number>} - A Promise that resolves to the number of elements deleted (1 if successful, 0 if not).
      */
     async delete(documentId, nestedId, options) {
-        const info = {
+        const command = {
             crud: 'delete',
             method: 'delete',
             byId: true,
@@ -158,13 +166,17 @@ export class MongoNestedService extends MongoService {
             nestedId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._delete(documentId, nestedId, { ...options, filter, documentFilter });
-        }, info);
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = { ...command.options, filter, documentFilter };
+            return this._delete(command);
+        });
     }
-    async _delete(documentId, nestedId, options) {
+    async _delete(command) {
+        const { documentId, nestedId, options } = command;
+        isNotNullish(documentId, { label: 'documentId' });
+        isNotNullish(documentId, { label: 'nestedId' });
         const matchFilter = MongoAdapter.prepareFilter([
             MongoAdapter.prepareKeyValues(documentId, ['_id']),
             options?.documentFilter,
@@ -183,20 +195,22 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<number>} - A Promise that resolves to the number of items deleted.
      */
     async deleteMany(documentId, options) {
-        const info = {
+        const command = {
             crud: 'delete',
             method: 'deleteMany',
             byId: false,
             documentId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._deleteMany(documentId, { ...options, filter, documentFilter });
-        }, info);
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = { ...command.options, filter, documentFilter };
+            return this._deleteMany(command);
+        });
     }
-    async _deleteMany(documentId, options) {
+    async _deleteMany(command) {
+        const { documentId, options } = command;
         const matchFilter = MongoAdapter.prepareFilter([
             MongoAdapter.prepareKeyValues(documentId, ['_id']),
             options?.documentFilter,
@@ -220,7 +234,24 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<boolean>} - A promise that resolves to a boolean indicating if the record exists or not.
      */
     async exists(documentId, nestedId, options) {
-        return !!(await this.findById(documentId, nestedId, { ...options, projection: ['_id'] }));
+        const command = {
+            crud: 'read',
+            method: 'exists',
+            byId: true,
+            documentId,
+            nestedId,
+            options,
+        };
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([
+                await this._getNestedFilter(command),
+                documentFilter,
+                command.options?.filter,
+            ]);
+            command.options = { ...command.options, filter };
+            return !!(await this._findById(command));
+        });
     }
     /**
      * Checks if an object with the given arguments exists.
@@ -230,7 +261,20 @@ export class MongoNestedService extends MongoService {
      * @return {Promise<boolean>} - A Promise that resolves to a boolean indicating whether the object exists or not.
      */
     async existsOne(documentId, options) {
-        return !!(await this.findOne(documentId, { ...options, projection: ['_id'] }));
+        const command = {
+            crud: 'read',
+            method: 'exists',
+            byId: false,
+            documentId,
+            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, documentFilter, projection: ['_id'] };
+            return !!(await this._findOne(findCommand));
+        });
     }
     /**
      * Finds an element in array field by its parent ID and ID.
@@ -241,7 +285,7 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
      */
     async findById(documentId, nestedId, options) {
-        const info = {
+        const command = {
             crud: 'read',
             method: 'findById',
             byId: true,
@@ -249,24 +293,32 @@ export class MongoNestedService extends MongoService {
             nestedId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._findById(documentId, nestedId, { ...options, filter, documentFilter });
-        }, info);
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = { ...command.options, filter, documentFilter };
+            return this._findById(command);
+        });
     }
-    async _findById(documentId, nestedId, options) {
+    async _findById(command) {
+        const { documentId, nestedId, options } = command;
+        isNotNullish(documentId, { label: 'documentId' });
+        isNotNullish(nestedId, { label: 'nestedId' });
         const filter = MongoAdapter.prepareFilter([
             MongoAdapter.prepareKeyValues(nestedId, [this.nestedKey]),
             options?.filter,
         ]);
-        const rows = await this._findMany(documentId, {
-            ...options,
-            filter,
-            limit: 1,
-            skip: undefined,
-            sort: undefined,
-        });
+        const findManyCommand = {
+            ...command,
+            options: {
+                ...options,
+                filter,
+                limit: 1,
+                skip: undefined,
+                sort: undefined,
+            },
+        };
+        const rows = await this._findMany(findManyCommand);
         return rows?.[0];
     }
     /**
@@ -277,24 +329,31 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<PartialDTO<T> | undefined>} A promise that resolves to the first matching document, or `undefined` if no match is found.
      */
     async findOne(documentId, options) {
-        const info = {
+        const command = {
             crud: 'read',
             method: 'findOne',
             byId: false,
             documentId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._findOne(documentId, { ...options, filter, documentFilter });
-        }, info);
-    }
-    async _findOne(documentId, options) {
-        const rows = await this._findMany(documentId, {
-            ...options,
-            limit: 1,
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = { ...command.options, filter, documentFilter };
+            return this._findOne(command);
         });
+    }
+    async _findOne(command) {
+        const { documentId, options } = command;
+        isNotNullish(documentId, { label: 'documentId' });
+        const findManyCommand = {
+            ...command,
+            options: {
+                ...options,
+                limit: 1,
+            },
+        };
+        const rows = await this._findMany(findManyCommand);
         return rows?.[0];
     }
     /**
@@ -305,28 +364,31 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<PartialDTO<T>[]>} - The found documents.
      */
     async findMany(documentId, options) {
-        const args = {
+        const command = {
             crud: 'read',
             method: 'findMany',
             byId: false,
             documentId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = await this._getDocumentFilter(args);
-            const nestedFilter = await this._getNestedFilter(args);
-            return this._findMany(documentId, {
-                ...options,
-                documentFilter,
+        return this._executeCommand(command, async () => {
+            const documentFilter = await this._getDocumentFilter(command);
+            const nestedFilter = await this._getNestedFilter(command);
+            command.options = {
+                ...command.options,
                 nestedFilter,
-                limit: options?.limit || this.defaultLimit,
-            });
-        }, args);
+                documentFilter,
+                limit: command.options?.limit || this.defaultLimit,
+            };
+            return this._findMany(command);
+        });
     }
-    async _findMany(documentId, options) {
+    async _findMany(command) {
+        const { documentId, options } = command;
+        isNotNullish(documentId, { label: 'documentId' });
         const matchFilter = MongoAdapter.prepareFilter([
             MongoAdapter.prepareKeyValues(documentId, ['_id']),
-            options.documentFilter,
+            options?.documentFilter,
         ]);
         const mongoOptions = {
             ...omit(options, ['documentFilter', 'nestedFilter', 'projection', 'sort', 'skip', 'limit', 'filter', 'count']),
@@ -337,7 +399,7 @@ export class MongoNestedService extends MongoService {
             { $unwind: { path: '$' + this.fieldName } },
             { $replaceRoot: { newRoot: '$' + this.fieldName } },
         ];
-        if (options?.filter || options.nestedFilter) {
+        if (options?.filter || options?.nestedFilter) {
             const optionsFilter = MongoAdapter.prepareFilter([options?.filter, options.nestedFilter]);
             stages.push({ $match: optionsFilter });
         }
@@ -372,28 +434,31 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<PartialDTO<T>[]>} - The found documents.
      */
     async findManyWithCount(documentId, options) {
-        const args = {
+        const command = {
             crud: 'read',
             method: 'findMany',
             byId: false,
             documentId,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = await this._getDocumentFilter(args);
-            const nestedFilter = await this._getNestedFilter(args);
-            return this._findManyWithCount(documentId, {
-                ...options,
-                documentFilter,
+        return this._executeCommand(command, async () => {
+            const documentFilter = await this._getDocumentFilter(command);
+            const nestedFilter = await this._getNestedFilter(command);
+            command.options = {
+                ...command.options,
                 nestedFilter,
-                limit: options?.limit || this.defaultLimit,
-            });
-        }, args);
+                documentFilter,
+                limit: command.options?.limit || this.defaultLimit,
+            };
+            return this._findManyWithCount(command);
+        });
     }
-    async _findManyWithCount(documentId, options) {
+    async _findManyWithCount(command) {
+        const { documentId, options } = command;
+        isNotNullish(documentId, { label: 'documentId' });
         const matchFilter = MongoAdapter.prepareFilter([
             MongoAdapter.prepareKeyValues(documentId, ['_id']),
-            options.documentFilter,
+            options?.documentFilter,
         ]);
         const mongoOptions = {
             ...omit(options, ['pick', 'include', 'omit', 'sort', 'skip', 'limit', 'filter', 'count']),
@@ -411,8 +476,8 @@ export class MongoNestedService extends MongoService {
                 },
             },
         ];
-        if (options?.filter || options.nestedFilter) {
-            const optionsFilter = MongoAdapter.prepareFilter([options?.filter, options.nestedFilter]);
+        if (options?.filter || options?.nestedFilter) {
+            const optionsFilter = MongoAdapter.prepareFilter([options?.filter, options?.nestedFilter]);
             dataStages.push({ $match: optionsFilter });
         }
         if (options?.skip)
@@ -465,21 +530,44 @@ export class MongoNestedService extends MongoService {
      * @param {AnyId} documentId - The ID of the document to update.
      * @param {AnyId} nestedId - The ID of the item to update within the document.
      * @param {PatchDTO<T>} input - The new data to update the item with.
-     * @param {MongoNestedService.UpdateOptions<T>} [options] - Additional update options.
+     * @param {MongoNestedService.UpdateOneOptions<T>} [options] - Additional update options.
      * @returns {Promise<PartialDTO<T> | undefined>} The updated item or undefined if it does not exist.
      * @throws {Error} If an error occurs while updating the item.
      */
     async update(documentId, nestedId, input, options) {
-        const r = await this.updateOnly(documentId, nestedId, input, options);
-        if (!r)
-            return;
-        const out = await this._findById(documentId, nestedId, {
-            ...options,
-            sort: undefined,
+        const command = {
+            crud: 'update',
+            method: 'update',
+            byId: true,
+            documentId,
+            nestedId,
+            input,
+            options,
+        };
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = {
+                ...command.options,
+                filter,
+                documentFilter,
+            };
+            const r = await this._updateOnly(command);
+            if (r) {
+                const findCommand = {
+                    crud: 'read',
+                    method: 'findById',
+                    byId: true,
+                    documentId,
+                    nestedId,
+                    options: { ...options, sort: undefined },
+                };
+                const out = this._findById(findCommand);
+                if (out)
+                    return out;
+            }
+            throw new ResourceNotAvailableError(this.getResourceName() + '.' + this.nestedKey, documentId + '/' + nestedId);
         });
-        if (out)
-            return out;
-        throw new ResourceNotAvailableError(this.getResourceName() + '.' + this.nestedKey, documentId + '/' + nestedId);
     }
     /**
      * Update an array element with new data. Returns 1 if document updated 0 otherwise.
@@ -487,29 +575,45 @@ export class MongoNestedService extends MongoService {
      * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
      * @param {MongoAdapter.AnyId} nestedId - The ID of the document to update.
      * @param {PatchDTO<T>} input - The partial input object containing the fields to update.
-     * @param {MongoNestedService.UpdateOptions<T>} [options] - Optional update options.
+     * @param {MongoNestedService.UpdateOneOptions<T>} [options] - Optional update options.
      * @returns {Promise<number>} - A promise that resolves to the number of elements updated.
      */
     async updateOnly(documentId, nestedId, input, options) {
-        const info = {
+        const command = {
             crud: 'update',
             method: 'update',
             byId: true,
             documentId,
             nestedId,
+            input,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._updateOnly(documentId, nestedId, input, { ...options, filter, documentFilter });
-        }, info);
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = {
+                ...command.options,
+                filter,
+                documentFilter,
+            };
+            return await this._updateOnly(command);
+        });
     }
-    async _updateOnly(documentId, nestedId, input, options) {
+    async _updateOnly(command) {
+        const { documentId, nestedId, options } = command;
+        isNotNullish(documentId, { label: 'documentId' });
+        isNotNullish(nestedId, { label: 'nestedId' });
         let filter = MongoAdapter.prepareKeyValues(nestedId, [this.nestedKey]);
         if (options?.filter)
             filter = MongoAdapter.prepareFilter([filter, options?.filter]);
-        return await this._updateMany(documentId, input, { ...options, filter });
+        const updateManyCommand = {
+            ...command,
+            options: {
+                ...command.options,
+                filter,
+            },
+        };
+        return await this._updateMany(updateManyCommand);
     }
     /**
      * Updates multiple array elements in document
@@ -520,7 +624,7 @@ export class MongoNestedService extends MongoService {
      * @returns {Promise<number>} - A promise that resolves to the number of documents updated.
      */
     async updateMany(documentId, input, options) {
-        const info = {
+        const command = {
             crud: 'update',
             method: 'updateMany',
             documentId,
@@ -528,13 +632,17 @@ export class MongoNestedService extends MongoService {
             input,
             options,
         };
-        return this._intercept(async () => {
-            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(info)]);
-            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(info), options?.filter]);
-            return this._updateMany(documentId, input, { ...options, filter, documentFilter });
-        }, info);
+        return this._executeCommand(command, async () => {
+            const documentFilter = MongoAdapter.prepareFilter([await this._getDocumentFilter(command)]);
+            const filter = MongoAdapter.prepareFilter([await this._getNestedFilter(command), command.options?.filter]);
+            command.options = { ...command.options, filter, documentFilter };
+            return this._updateMany(command);
+        });
     }
-    async _updateMany(documentId, input, options) {
+    async _updateMany(command) {
+        const { documentId, input } = command;
+        isNotNullish(documentId, { label: 'documentId' });
+        let options = command.options;
         const inputCodec = this.getInputCodec('update');
         const doc = inputCodec(input);
         if (!Object.keys(doc).length)
@@ -553,8 +661,16 @@ export class MongoNestedService extends MongoService {
             fieldPrefix: this.fieldName + (options?.filter ? '.$[elem].' : '.$[].'),
         });
         const r = await this._dbUpdateOne(matchFilter, update, options);
-        if (options?.count)
-            return await this._count(documentId, options);
+        if (options?.count) {
+            const countCommand = {
+                crud: 'read',
+                method: 'count',
+                byId: false,
+                documentId,
+                options,
+            };
+            return await this._count(countCommand);
+        }
         return r.modifiedCount || 0;
     }
     /**
@@ -566,6 +682,6 @@ export class MongoNestedService extends MongoService {
      * that resolves to the common filter, or undefined if not available.
      */
     _getNestedFilter(args) {
-        return typeof this.$nestedFilter === 'function' ? this.$nestedFilter(args, this) : this.$nestedFilter;
+        return typeof this.nestedFilter === 'function' ? this.nestedFilter(args, this) : this.nestedFilter;
     }
 }