@opra/mongodb 1.0.0-alpha.17 → 1.0.0-alpha.19

package/cjs/mongo-entity-service.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MongoEntityService = void 0;
 const tslib_1 = require("tslib");
-const assert = tslib_1.__importStar(require("node:assert"));
 const common_1 = require("@opra/common");
 const lodash_omit_1 = tslib_1.__importDefault(require("lodash.omit"));
+const valgen_1 = require("valgen");
 const mongo_adapter_js_1 = require("./mongo-adapter.js");
 const mongo_service_js_1 = require("./mongo-service.js");
 /**
@@ -25,19 +25,27 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Creates a new document in the MongoDB collection.
      *
-     * @param {PartialDTO<T>} input
-     * @param {MongoEntityService.CreateOptions} options
+     * @param {MongoEntityService.CreateCommand} command
      * @protected
      */
-    async _create(input, options) {
+    async _create(command) {
+        (0, valgen_1.isNotNullish)(command.input, { label: 'input' });
+        (0, valgen_1.isNotNullish)(command.input._id, { label: 'input._id' });
         const inputCodec = this.getInputCodec('create');
-        const doc = inputCodec(input);
-        assert.ok(doc._id, 'You must provide the "_id" field');
+        const doc = inputCodec(command.input);
+        const { options } = command;
         const r = await this._dbInsertOne(doc, options);
         if (r.insertedId) {
-            if (!options)
+            if (!command.options)
                 return doc;
-            const out = await this._findById(doc._id, (0, lodash_omit_1.default)(options, 'filter'));
+            const findCommand = {
+                ...command,
+                crud: 'read',
+                byId: true,
+                documentId: doc._id,
+                options: (0, lodash_omit_1.default)(options, 'filter'),
+            };
+            const out = await this._findById(findCommand);
             if (out)
                 return out;
         }
@@ -47,56 +55,65 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Returns the count of documents in the collection based on the provided options.
      *
-     * @param {MongoEntityService.CountOptions<T>} options - The options for the count operation.
-     * @return {Promise<number>} - A promise that resolves to the count of documents in the collection.
+     * @param {MongoEntityService.CountCommand<T>} command
+     * @protected
      */
-    async _count(options) {
+    async _count(command) {
+        const { options } = command;
         const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter(options?.filter);
         return this._dbCountDocuments(filter, (0, lodash_omit_1.default)(options, 'filter'));
     }
     /**
      * Deletes a document from the collection.
      *
-     * @param {MongoAdapter.AnyId} id - The ID of the document to delete.
-     * @param {MongoEntityService.DeleteOptions<T>} [options] - Optional delete options.
-     * @return {Promise<number>} - A Promise that resolves to the number of documents deleted.
+     * @param {MongoEntityService.DeleteCommand<T>} command
+     * @protected
      */
-    async _delete(id, options) {
-        assert.ok(id, 'You must provide an id');
-        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([mongo_adapter_js_1.MongoAdapter.prepareKeyValues(id, ['_id']), options?.filter]);
+    async _delete(command) {
+        (0, valgen_1.isNotNullish)(command.documentId, { label: 'documentId' });
+        const { options } = command;
+        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([
+            mongo_adapter_js_1.MongoAdapter.prepareKeyValues(command.documentId, ['_id']),
+            options?.filter,
+        ]);
         const r = await this._dbDeleteOne(filter, options);
         return r.deletedCount;
     }
     /**
      * Deletes multiple documents from the collection that meet the specified filter criteria.
      *
-     * @param {MongoEntityService.DeleteManyOptions<T>} options - The options for the delete operation.
-     * @return {Promise<number>} - A promise that resolves to the number of documents deleted.
+     * @param {MongoEntityService.DeleteCommand<T>} command
+     * @protected
      */
-    async _deleteMany(options) {
+    async _deleteMany(command) {
+        const { options } = command;
         const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter(options?.filter);
         const r = await this._dbDeleteMany(filter, (0, lodash_omit_1.default)(options, 'filter'));
         return r.deletedCount;
     }
     /**
      * The distinct command returns a list of distinct values for the given key across a collection.
-     * @param {string} field
-     * @param {MongoEntityService.DistinctOptions<T>} options
+     *
+     * @param {MongoEntityService.DistinctCommand<T>} command
      * @protected
      */
-    async _distinct(field, options) {
+    async _distinct(command) {
+        const { options, field } = command;
         const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter(options?.filter);
         return await this._dbDistinct(field, filter, (0, lodash_omit_1.default)(options, 'filter'));
     }
     /**
      * Finds a document by its ID.
      *
-     * @param {MongoAdapter.AnyId} id - The ID of the document.
-     * @param {MongoEntityService.FindOneOptions<T>} [options] - The options for the find query.
-     * @return {Promise<PartialDTO<T | undefined>>} - A promise resolving to the found document, or undefined if not found.
+     * @param { MongoEntityService.FindOneCommand<T>} command
      */
-    async _findById(id, options) {
-        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([mongo_adapter_js_1.MongoAdapter.prepareKeyValues(id, ['_id']), options?.filter]);
+    async _findById(command) {
+        (0, valgen_1.isNotNullish)(command.documentId, { label: 'documentId' });
+        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([
+            mongo_adapter_js_1.MongoAdapter.prepareKeyValues(command.documentId, ['_id']),
+            command.options?.filter,
+        ]);
+        const { options } = command;
         const mongoOptions = {
             ...options,
             projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
@@ -112,10 +129,10 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Finds a document in the collection that matches the specified options.
      *
-     * @param {MongoEntityService.FindOneOptions} [options] - The options for the query.
-     * @return {Promise<PartialDTO<T> | undefined>} A promise that resolves with the found document or undefined if no document is found.
+     * @param {MongoEntityService.FindOneCommand<T>} command
      */
-    async _findOne(options) {
+    async _findOne(command) {
+        const { options } = command;
         const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter(options?.filter);
         const mongoOptions = {
             ...(0, lodash_omit_1.default)(options, 'filter'),
@@ -131,10 +148,10 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Finds multiple documents in the MongoDB collection.
      *
-     * @param {MongoEntityService.FindManyOptions<T>} [options] - The options for the find operation.
-     * @return A Promise that resolves to an array of partial outputs of type T.
+     * @param {MongoEntityService.FindManyCommand<T>} command
      */
-    async _findMany(options) {
+    async _findMany(command) {
+        const { options } = command;
         const mongoOptions = {
             ...(0, lodash_omit_1.default)(options, ['projection', 'sort', 'skip', 'limit', 'filter']),
         };
@@ -173,10 +190,10 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
      * Finds multiple documents in the collection and returns both records (max limit)
      * and total count that matched the given criteria
      *
-     * @param {MongoEntityService.FindManyOptions<T>} [options] - The options for the find operation.
-     * @return A Promise that resolves to an array of partial outputs of type T.
+     * @param {MongoEntityService.FindManyCommand<T>} command
      */
-    async _findManyWithCount(options) {
+    async _findManyWithCount(command) {
+        const { options } = command;
         const mongoOptions = {
             ...(0, lodash_omit_1.default)(options, ['projection', 'sort', 'skip', 'limit', 'filter']),
         };
@@ -230,20 +247,17 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Updates a document with the given id in the collection.
      *
-     * @param {AnyId} id - The id of the document to update.
-     * @param {PatchDTO<T>|UpdateFilter<T>} input - The partial input object containing the fields to update.
-     * @param {MongoEntityService.UpdateOptions<T>} [options] - The options for the update operation.
-     * @returns {Promise<PartialDTO<T> | undefined>} A promise that resolves to the updated document or
-     * undefined if the document was not found.
+     * @param {MongoEntityService.UpdateOneCommand<T>} command
      */
-    async _update(id, input, options) {
-        const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
-        const isDocument = !Array.isArray(input) && !!Object.keys(input).find(x => !x.startsWith('$'));
-        if (isUpdateFilter && isDocument) {
+    async _update(command) {
+        (0, valgen_1.isNotNullish)(command.documentId, { label: 'documentId' });
+        const { input, inputRaw, options } = command;
+        (0, valgen_1.isNotNullish)(input || inputRaw, { label: 'input' });
+        if (input && inputRaw) {
             throw new TypeError('You must pass one of MongoDB UpdateFilter or a partial document, not both');
         }
         let update;
-        if (isDocument) {
+        if (input) {
             const inputCodec = this.getInputCodec('update');
             const doc = inputCodec(input);
             delete doc._id;
@@ -251,8 +265,11 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
             update.$set = update.$set || {};
         }
         else
-            update = input;
-        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([mongo_adapter_js_1.MongoAdapter.prepareKeyValues(id, ['_id']), options?.filter]);
+            update = inputRaw;
+        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([
+            mongo_adapter_js_1.MongoAdapter.prepareKeyValues(command.documentId, ['_id']),
+            options?.filter,
+        ]);
         const mongoOptions = {
             ...options,
             includeResultMetadata: false,
@@ -267,19 +284,17 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Updates a document in the collection with the specified ID.
      *
-     * @param {MongoAdapter.AnyId} id - The ID of the document to update.
-     * @param {PatchDTO<T>|UpdateFilter<T>} input - The partial input data to update the document with.
-     * @param {MongoEntityService.UpdateOptions<T>} [options] - The options for updating the document.
-     * @returns {Promise<number>} - A promise that resolves to the number of documents modified.
+     * @param {MongoEntityService.UpdateOneCommand<T>} command
      */
-    async _updateOnly(id, input, options) {
-        const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
-        const isDocument = !Array.isArray(input) && !!Object.keys(input).find(x => !x.startsWith('$'));
-        if (isUpdateFilter && isDocument) {
+    async _updateOnly(command) {
+        (0, valgen_1.isNotNullish)(command.documentId, { label: 'documentId' });
+        const { input, inputRaw, options } = command;
+        (0, valgen_1.isNotNullish)(input || inputRaw, { label: 'input' });
+        if (input && inputRaw) {
             throw new TypeError('You must pass one of MongoDB UpdateFilter or a partial document, not both');
         }
         let update;
-        if (isDocument) {
+        if (input) {
             const inputCodec = this.getInputCodec('update');
             const doc = inputCodec(input);
             delete doc._id;
@@ -288,8 +303,11 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
                 return 0;
         }
         else
-            update = input;
-        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([mongo_adapter_js_1.MongoAdapter.prepareKeyValues(id, ['_id']), options?.filter]);
+            update = inputRaw;
+        const filter = mongo_adapter_js_1.MongoAdapter.prepareFilter([
+            mongo_adapter_js_1.MongoAdapter.prepareKeyValues(command.documentId, ['_id']),
+            options?.filter,
+        ]);
         const mongoOptions = {
             ...options,
             includeResultMetadata: false,
@@ -302,18 +320,17 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
     /**
      * Updates multiple documents in the collection based on the specified input and options.
      *
-     * @param {PatchDTO<T>|UpdateFilter<T>} input - The partial input to update the documents with.
-     * @param {MongoEntityService.UpdateManyOptions<T>} [options] - The options for updating the documents.
-     * @return {Promise<number>} - A promise that resolves to the number of documents matched and modified.
+     * @param {MongoEntityService.UpdateManyCommand<T>} command
      */
-    async _updateMany(input, options) {
-        const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
-        const isDocument = !Array.isArray(input) && !!Object.keys(input).find(x => !x.startsWith('$'));
-        if (isUpdateFilter && isDocument) {
+    async _updateMany(command) {
+        (0, valgen_1.isNotNullish)(command.input, { label: 'input' });
+        const { input, inputRaw, options } = command;
+        (0, valgen_1.isNotNullish)(input || inputRaw, { label: 'input' });
+        if (input && inputRaw) {
             throw new TypeError('You must pass one of MongoDB UpdateFilter or a partial document, not both');
         }
         let update;
-        if (isDocument) {
+        if (input) {
             const inputCodec = this.getInputCodec('update');
             const doc = inputCodec(input);
             delete doc._id;
@@ -322,7 +339,7 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
                 return 0;
         }
         else
-            update = input;
+            update = inputRaw;
         const mongoOptions = {
             ...(0, lodash_omit_1.default)(options, 'filter'),
             upsert: undefined,