@opra/mongodb 1.0.0-alpha.2 → 1.0.0-alpha.21

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 lodash_omit_1 = tslib_1.__importDefault(require("lodash.omit"));
-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) {
-        const encode = this.getEncoder('create');
-        const doc = encode(input);
-        assert.ok(doc._id, 'You must provide the "_id" field');
+    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(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,92 +55,103 @@ 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.getDataType(), options?.projection),
+            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
             limit: undefined,
             skip: undefined,
             sort: undefined,
         };
-        const decode = this.getDecoder();
         const out = await this._dbFindOne(filter, mongoOptions);
-        return out ? decode(out) : undefined;
+        const outputCodec = this.getOutputCodec('find');
+        if (out)
+            return outputCodec(out);
     }
     /**
      * 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'),
             sort: options?.sort ? mongo_adapter_js_1.MongoAdapter.prepareSort(options.sort) : undefined,
-            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.getDataType(), options?.projection),
+            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
             limit: undefined,
         };
-        const decode = this.getDecoder();
         const out = await this._dbFindOne(filter, mongoOptions);
-        return out ? decode(out, { coerce: true }) : undefined;
+        const outputCodec = this.getOutputCodec('find');
+        if (out)
+            return outputCodec(out);
     }
     /**
      * 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']),
         };
@@ -151,16 +170,16 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
                 stages.push({ $sort: sort });
         }
         stages.push({ $limit: limit });
-        const dataType = this.getDataType();
+        const dataType = this.dataType;
         const projection = mongo_adapter_js_1.MongoAdapter.prepareProjection(dataType, options?.projection);
         if (projection)
             stages.push({ $project: projection });
-        const decode = this.getDecoder();
         const cursor = await this._dbAggregate(stages, mongoOptions);
         /** Execute db command */
         try {
             /** Fetch the cursor and decode the result objects */
-            return (await cursor.toArray()).map((r) => decode(r));
+            const outputCodec = this.getOutputCodec('find');
+            return (await cursor.toArray()).map((r) => outputCodec(r));
         }
         finally {
             if (!cursor.closed)
@@ -171,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']),
         };
@@ -205,11 +224,11 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
                 dataStages.push({ $sort: sort });
         }
         dataStages.push({ $limit: limit });
-        const dataType = this.getDataType();
+        const dataType = this.dataType;
         const projection = mongo_adapter_js_1.MongoAdapter.prepareProjection(dataType, options?.projection);
         if (projection)
             dataStages.push({ $project: projection });
-        const decode = this.getDecoder();
+        const outputCodec = this.getOutputCodec('find');
         /** Execute db command */
         const cursor = await this._dbAggregate(stages, mongoOptions);
         try {
@@ -217,7 +236,7 @@ class MongoEntityService extends mongo_service_js_1.MongoService {
             const facetResult = await cursor.toArray();
             return {
                 count: facetResult[0].count[0]?.totalMatches || 0,
-                items: facetResult[0].data?.map((r) => decode(r)),
+                items: facetResult[0].data?.map((r) => outputCodec(r)),
             };
         }
         finally {
@@ -228,68 +247,72 @@ 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) {
-            const encode = this.getEncoder('update');
-            const doc = encode(input, { coerce: true });
+        if (input) {
+            const inputCodec = this.getInputCodec('update');
+            const doc = inputCodec(input);
             delete doc._id;
             update = mongo_adapter_js_1.MongoAdapter.preparePatch(doc);
             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,
             upsert: undefined,
-            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.getDataType(), options?.projection),
+            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
         };
-        const decode = this.getDecoder();
         const out = await this._dbFindOneAndUpdate(filter, update, mongoOptions);
-        return out ? decode(out, { coerce: true }) : undefined;
+        const outputCodec = this.getOutputCodec('update');
+        if (out)
+            return outputCodec(out);
     }
     /**
      * 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) {
-            const encode = this.getEncoder('update');
-            const doc = encode(input, { coerce: true });
+        if (input) {
+            const inputCodec = this.getInputCodec('update');
+            const doc = inputCodec(input);
             delete doc._id;
             update = mongo_adapter_js_1.MongoAdapter.preparePatch(doc);
             if (!Object.keys(doc).length)
                 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,
             upsert: undefined,
-            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.getDataType(), options?.projection),
+            projection: mongo_adapter_js_1.MongoAdapter.prepareProjection(this.dataType, options?.projection),
         };
         const out = await this._dbUpdateOne(filter, update, mongoOptions);
         return out.matchedCount;
@@ -297,26 +320,26 @@ 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) {
-            const encode = this.getEncoder('update');
-            const doc = encode(input, { coerce: true });
+        if (input) {
+            const inputCodec = this.getInputCodec('update');
+            const doc = inputCodec(input);
             delete doc._id;
             update = mongo_adapter_js_1.MongoAdapter.preparePatch(doc);
             if (!Object.keys(doc).length)
                 return 0;
         }
         else
-            update = input;
+            update = inputRaw;
         const mongoOptions = {
             ...(0, lodash_omit_1.default)(options, 'filter'),
             upsert: undefined,