@opra/mongodb 1.0.0-alpha.31 → 1.0.0-alpha.32

package/cjs/mongo-collection-service.js

@@ -33,15 +33,6 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
         if (!(await this.exists(id, options)))
             throw new common_1.ResourceNotAvailableError(this.getResourceName(), id);
     }
-    /**
-     * Creates a new document in the MongoDB collection.
-     * Interceptors will be called before performing db operation
-     *
-     * @param {PartialDTO<T>} input - The input data for creating the document.
-     * @param {MongoEntityService.CreateOptions} [options] - The options for creating the document.
-     * @returns {Promise<PartialDTO<T>>} A promise that resolves to the created document.
-     * @throws {Error} if an unknown error occurs while creating the document.
-     */
     async create(input, options) {
         const command = {
             crud: 'create',
@@ -163,13 +154,6 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
     async existsOne(options) {
         return !!(await this.findOne({ ...options, projection: ['_id'] }));
     }
-    /**
-     * 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.
-     */
     async findById(id, options) {
         const command = {
             crud: 'read',
@@ -185,12 +169,6 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             return this._findById(command);
         });
     }
-    /**
-     * Finds a document in the collection that matches the specified options.
-     *
-     * @param {MongoEntityService.FindOneOptions<T>} [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.
-     */
     async findOne(options) {
         const command = {
             crud: 'read',
@@ -204,12 +182,6 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             return this._findOne(command);
         });
     }
-    /**
-     * 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.
-     */
     async findMany(options) {
         const command = {
             crud: 'read',
@@ -224,13 +196,6 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             return this._findMany(command);
         });
     }
-    /**
-     * 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.
-     */
     async findManyWithCount(options) {
         const command = {
             crud: 'read',
@@ -244,30 +209,12 @@ class MongoCollectionService extends mongo_entity_service_js_1.MongoEntityServic
             return this._findManyWithCount(command);
         });
     }
-    /**
-     * Retrieves a document from the collection by its ID. Throws error if not found.
-     *
-     * @param {MongoAdapter.AnyId} id - The ID of the document to retrieve.
-     * @param {MongoEntityService.FindOneOptions<T>} [options] - Optional options for the findOne operation.
-     * @returns {Promise<PartialDTO<T>>} - A promise that resolves to the retrieved document,
-     *    or rejects with a ResourceNotFoundError if the document does not exist.
-     * @throws {ResourceNotAvailableError} - If the document with the specified ID does not exist.
-     */
     async get(id, options) {
         const out = await this.findById(id, options);
         if (!out)
             throw new common_1.ResourceNotAvailableError(this.getResourceName(), id);
         return out;
     }
-    /**
-     * Updates a document with the given id in the collection.
-     *
-     * @param {MongoAdapter.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.UpdateOneOptions<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.
-     */
     async update(id, input, options) {
         const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
         const command = {

package/cjs/mongo-nested-service.js

@@ -55,15 +55,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
             throw new common_1.ResourceNotAvailableError(this.getResourceName() + '.' + this.nestedKey, documentId + '/' + id);
         }
     }
-    /**
-     * Adds a single item into the array field.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {T} input - The item to be added to the array field.
-     * @param {MongoNestedService.CreateOptions} [options] - Optional options for the create operation.
-     * @return {Promise<PartialDTO<T>>} - A promise that resolves with the partial output of the created item.
-     * @throws {ResourceNotAvailableError} - If the parent document is not found.
-     */
     async create(documentId, input, options) {
         const command = {
             crud: 'create',
@@ -280,14 +271,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
             return !!(await this._findOne(findCommand));
         });
     }
-    /**
-     * Finds an element in array field by its parent ID and ID.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the document.
-     * @param {MongoAdapter.AnyId} nestedId - The ID of the document.
-     * @param {MongoNestedService.FindOneOptions<T>} [options] - The optional options for the operation.
-     * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
-     */
     async findById(documentId, nestedId, options) {
         const command = {
             crud: 'read',
@@ -325,13 +308,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
         const rows = await this._findMany(findManyCommand);
         return rows?.[0];
     }
-    /**
-     * Finds the first array element that matches the given parentId.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the document.
-     * @param {MongoNestedService.FindOneOptions<T>} [options] - Optional options to customize the query.
-     * @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 command = {
             crud: 'read',
@@ -360,13 +336,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
         const rows = await this._findMany(findManyCommand);
         return rows?.[0];
     }
-    /**
-     * Finds multiple elements in an array field.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {MongoNestedService.FindManyOptions<T>} [options] - The options for finding the documents.
-     * @returns {Promise<PartialDTO<T>[]>} - The found documents.
-     */
     async findMany(documentId, options) {
         const command = {
             crud: 'read',
@@ -430,13 +399,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
                 await cursor.close();
         }
     }
-    /**
-     * Finds multiple elements in an array field.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {MongoNestedService.FindManyOptions<T>} [options] - The options for finding the documents.
-     * @returns {Promise<PartialDTO<T>[]>} - The found documents.
-     */
     async findManyWithCount(documentId, options) {
         const command = {
             crud: 'read',
@@ -512,15 +474,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
                 await cursor.close();
         }
     }
-    /**
-     * Retrieves a specific item from the array of a document.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the document.
-     * @param {MongoAdapter.AnyId} nestedId - The ID of the item.
-     * @param {MongoNestedService.FindOneOptions<T>} [options] - The options for finding the item.
-     * @returns {Promise<PartialDTO<T>>} - The item found.
-     * @throws {ResourceNotAvailableError} - If the item is not found.
-     */
     async get(documentId, nestedId, options) {
         const out = await this.findById(documentId, nestedId, options);
         if (!out) {
@@ -528,16 +481,6 @@ class MongoNestedService extends mongo_service_js_1.MongoService {
         }
         return out;
     }
-    /**
-     * Updates an array element with new data and returns the updated element
-     *
-     * @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.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 command = {
             crud: 'update',

package/cjs/mongo-singleton-service.js

@@ -34,14 +34,6 @@ class MongoSingletonService extends mongo_entity_service_js_1.MongoEntityService
         if (!(await this.exists(options)))
             throw new common_1.ResourceNotAvailableError(this.getResourceName());
     }
-    /**
-     * Creates the document in the database.
-     *
-     * @param {PartialDTO<T>} input - The partial input to create the document with.
-     * @param {MongoEntityService.CreateOptions} [options] - The options for creating the document.
-     * @return {Promise<PartialDTO<T>>} A promise that resolves to the partial output of the created document.
-     * @throws {Error} Throws an error if an unknown error occurs while creating the document.
-     */
     async create(input, options) {
         const command = {
             crud: 'create',
@@ -95,12 +87,6 @@ class MongoSingletonService extends mongo_entity_service_js_1.MongoEntityService
             return !!(await this._findById(findCommand));
         });
     }
-    /**
-     * Fetches the document if it exists. Returns undefined if not found.
-     *
-     * @param {MongoEntityService.FindOneOptions<T>} [options] - The options for finding the document.
-     * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
-     */
     async find(options) {
         const command = {
             crud: 'read',
@@ -116,27 +102,12 @@ class MongoSingletonService extends mongo_entity_service_js_1.MongoEntityService
             return this._findById(command);
         });
     }
-    /**
-     * Fetches the document from the Mongo collection service. Throws error if not found.
-     *
-     * @param {MongoEntityService.FindOneOptions<T>} options - The options to customize the query.
-     * @return {Promise<PartialDTO<T>>} - A promise that resolves to the fetched document.
-     * @throws {ResourceNotAvailableError} - If the document is not found in the collection.
-     */
     async get(options) {
         const out = await this.find(options);
         if (!out)
             throw new common_1.ResourceNotAvailableError(this.getResourceName());
         return out;
     }
-    /**
-     * Updates a document in the MongoDB collection.
-     *
-     * @param {PatchDTO<T>} input - The partial input to update the document.
-     * @param {MongoEntityService.UpdateOneOptions<T>} [options] - The update options.
-     *
-     * @return {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the updated document or undefined if not found.
-     */
     async update(input, options) {
         const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
         const command = {

package/esm/mongo-collection-service.js

@@ -30,15 +30,6 @@ export class MongoCollectionService extends MongoEntityService {
         if (!(await this.exists(id, options)))
             throw new ResourceNotAvailableError(this.getResourceName(), id);
     }
-    /**
-     * Creates a new document in the MongoDB collection.
-     * Interceptors will be called before performing db operation
-     *
-     * @param {PartialDTO<T>} input - The input data for creating the document.
-     * @param {MongoEntityService.CreateOptions} [options] - The options for creating the document.
-     * @returns {Promise<PartialDTO<T>>} A promise that resolves to the created document.
-     * @throws {Error} if an unknown error occurs while creating the document.
-     */
     async create(input, options) {
         const command = {
             crud: 'create',
@@ -160,13 +151,6 @@ export class MongoCollectionService extends MongoEntityService {
     async existsOne(options) {
         return !!(await this.findOne({ ...options, projection: ['_id'] }));
     }
-    /**
-     * 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.
-     */
     async findById(id, options) {
         const command = {
             crud: 'read',
@@ -182,12 +166,6 @@ export class MongoCollectionService extends MongoEntityService {
             return this._findById(command);
         });
     }
-    /**
-     * Finds a document in the collection that matches the specified options.
-     *
-     * @param {MongoEntityService.FindOneOptions<T>} [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.
-     */
     async findOne(options) {
         const command = {
             crud: 'read',
@@ -201,12 +179,6 @@ export class MongoCollectionService extends MongoEntityService {
             return this._findOne(command);
         });
     }
-    /**
-     * 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.
-     */
     async findMany(options) {
         const command = {
             crud: 'read',
@@ -221,13 +193,6 @@ export class MongoCollectionService extends MongoEntityService {
             return this._findMany(command);
         });
     }
-    /**
-     * 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.
-     */
     async findManyWithCount(options) {
         const command = {
             crud: 'read',
@@ -241,30 +206,12 @@ export class MongoCollectionService extends MongoEntityService {
             return this._findManyWithCount(command);
         });
     }
-    /**
-     * Retrieves a document from the collection by its ID. Throws error if not found.
-     *
-     * @param {MongoAdapter.AnyId} id - The ID of the document to retrieve.
-     * @param {MongoEntityService.FindOneOptions<T>} [options] - Optional options for the findOne operation.
-     * @returns {Promise<PartialDTO<T>>} - A promise that resolves to the retrieved document,
-     *    or rejects with a ResourceNotFoundError if the document does not exist.
-     * @throws {ResourceNotAvailableError} - If the document with the specified ID does not exist.
-     */
     async get(id, options) {
         const out = await this.findById(id, options);
         if (!out)
             throw new ResourceNotAvailableError(this.getResourceName(), id);
         return out;
     }
-    /**
-     * Updates a document with the given id in the collection.
-     *
-     * @param {MongoAdapter.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.UpdateOneOptions<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.
-     */
     async update(id, input, options) {
         const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
         const command = {

package/esm/mongo-nested-service.js

@@ -51,15 +51,6 @@ export class MongoNestedService extends MongoService {
             throw new ResourceNotAvailableError(this.getResourceName() + '.' + this.nestedKey, documentId + '/' + id);
         }
     }
-    /**
-     * Adds a single item into the array field.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {T} input - The item to be added to the array field.
-     * @param {MongoNestedService.CreateOptions} [options] - Optional options for the create operation.
-     * @return {Promise<PartialDTO<T>>} - A promise that resolves with the partial output of the created item.
-     * @throws {ResourceNotAvailableError} - If the parent document is not found.
-     */
     async create(documentId, input, options) {
         const command = {
             crud: 'create',
@@ -276,14 +267,6 @@ export class MongoNestedService extends MongoService {
             return !!(await this._findOne(findCommand));
         });
     }
-    /**
-     * Finds an element in array field by its parent ID and ID.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the document.
-     * @param {MongoAdapter.AnyId} nestedId - The ID of the document.
-     * @param {MongoNestedService.FindOneOptions<T>} [options] - The optional options for the operation.
-     * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
-     */
     async findById(documentId, nestedId, options) {
         const command = {
             crud: 'read',
@@ -321,13 +304,6 @@ export class MongoNestedService extends MongoService {
         const rows = await this._findMany(findManyCommand);
         return rows?.[0];
     }
-    /**
-     * Finds the first array element that matches the given parentId.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the document.
-     * @param {MongoNestedService.FindOneOptions<T>} [options] - Optional options to customize the query.
-     * @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 command = {
             crud: 'read',
@@ -356,13 +332,6 @@ export class MongoNestedService extends MongoService {
         const rows = await this._findMany(findManyCommand);
         return rows?.[0];
     }
-    /**
-     * Finds multiple elements in an array field.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {MongoNestedService.FindManyOptions<T>} [options] - The options for finding the documents.
-     * @returns {Promise<PartialDTO<T>[]>} - The found documents.
-     */
     async findMany(documentId, options) {
         const command = {
             crud: 'read',
@@ -426,13 +395,6 @@ export class MongoNestedService extends MongoService {
                 await cursor.close();
         }
     }
-    /**
-     * Finds multiple elements in an array field.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {MongoNestedService.FindManyOptions<T>} [options] - The options for finding the documents.
-     * @returns {Promise<PartialDTO<T>[]>} - The found documents.
-     */
     async findManyWithCount(documentId, options) {
         const command = {
             crud: 'read',
@@ -508,15 +470,6 @@ export class MongoNestedService extends MongoService {
                 await cursor.close();
         }
     }
-    /**
-     * Retrieves a specific item from the array of a document.
-     *
-     * @param {MongoAdapter.AnyId} documentId - The ID of the document.
-     * @param {MongoAdapter.AnyId} nestedId - The ID of the item.
-     * @param {MongoNestedService.FindOneOptions<T>} [options] - The options for finding the item.
-     * @returns {Promise<PartialDTO<T>>} - The item found.
-     * @throws {ResourceNotAvailableError} - If the item is not found.
-     */
     async get(documentId, nestedId, options) {
         const out = await this.findById(documentId, nestedId, options);
         if (!out) {
@@ -524,16 +477,6 @@ export class MongoNestedService extends MongoService {
         }
         return out;
     }
-    /**
-     * Updates an array element with new data and returns the updated element
-     *
-     * @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.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 command = {
             crud: 'update',

package/esm/mongo-singleton-service.js

@@ -31,14 +31,6 @@ export class MongoSingletonService extends MongoEntityService {
         if (!(await this.exists(options)))
             throw new ResourceNotAvailableError(this.getResourceName());
     }
-    /**
-     * Creates the document in the database.
-     *
-     * @param {PartialDTO<T>} input - The partial input to create the document with.
-     * @param {MongoEntityService.CreateOptions} [options] - The options for creating the document.
-     * @return {Promise<PartialDTO<T>>} A promise that resolves to the partial output of the created document.
-     * @throws {Error} Throws an error if an unknown error occurs while creating the document.
-     */
     async create(input, options) {
         const command = {
             crud: 'create',
@@ -92,12 +84,6 @@ export class MongoSingletonService extends MongoEntityService {
             return !!(await this._findById(findCommand));
         });
     }
-    /**
-     * Fetches the document if it exists. Returns undefined if not found.
-     *
-     * @param {MongoEntityService.FindOneOptions<T>} [options] - The options for finding the document.
-     * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
-     */
     async find(options) {
         const command = {
             crud: 'read',
@@ -113,27 +99,12 @@ export class MongoSingletonService extends MongoEntityService {
             return this._findById(command);
         });
     }
-    /**
-     * Fetches the document from the Mongo collection service. Throws error if not found.
-     *
-     * @param {MongoEntityService.FindOneOptions<T>} options - The options to customize the query.
-     * @return {Promise<PartialDTO<T>>} - A promise that resolves to the fetched document.
-     * @throws {ResourceNotAvailableError} - If the document is not found in the collection.
-     */
     async get(options) {
         const out = await this.find(options);
         if (!out)
             throw new ResourceNotAvailableError(this.getResourceName());
         return out;
     }
-    /**
-     * Updates a document in the MongoDB collection.
-     *
-     * @param {PatchDTO<T>} input - The partial input to update the document.
-     * @param {MongoEntityService.UpdateOneOptions<T>} [options] - The update options.
-     *
-     * @return {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the updated document or undefined if not found.
-     */
     async update(input, options) {
         const isUpdateFilter = Array.isArray(input) || !!Object.keys(input).find(x => x.startsWith('$'));
         const command = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opra/mongodb",
-  "version": "1.0.0-alpha.31",
+  "version": "1.0.0-alpha.32",
   "description": "Opra MongoDB adapter package",
   "author": "Panates",
   "license": "MIT",
@@ -38,8 +38,8 @@
     "ts-gems": "^3.4.0"
   },
   "peerDependencies": {
-    "@opra/common": "^1.0.0-alpha.31",
-    "@opra/core": "^1.0.0-alpha.31",
+    "@opra/common": "^1.0.0-alpha.32",
+    "@opra/core": "^1.0.0-alpha.32",
     "mongodb": ">= 6.0.0"
   },
   "type": "module",

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

@@ -1,5 +1,5 @@
 import mongodb, { UpdateFilter } from 'mongodb';
-import { PartialDTO, PatchDTO, Type } from 'ts-gems';
+import { PartialDTO, PatchDTO, RequiredSome, Type } from 'ts-gems';
 import { MongoAdapter } from './mongo-adapter.js';
 import { MongoEntityService } from './mongo-entity-service.js';
 /**
@@ -55,7 +55,8 @@ export declare class MongoCollectionService<T extends mongodb.Document> extends
      * @returns {Promise<PartialDTO<T>>} A promise that resolves to the created document.
      * @throws {Error} if an unknown error occurs while creating the document.
      */
-    create(input: PartialDTO<T>, options?: MongoEntityService.CreateOptions): Promise<PartialDTO<T>>;
+    create(input: PartialDTO<T>, options: RequiredSome<MongoEntityService.CreateOptions, 'projection'>): Promise<PartialDTO<T>>;
+    create(input: PartialDTO<T>, options?: MongoEntityService.CreateOptions): Promise<T>;
     /**
      * Returns the count of documents in the collection based on the provided options.
      *
@@ -107,21 +108,24 @@ export declare class MongoCollectionService<T extends mongodb.Document> extends
      * @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.
      */
-    findById(id: MongoAdapter.AnyId, options?: MongoEntityService.FindOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    findById(id: MongoAdapter.AnyId, options: RequiredSome<MongoEntityService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    findById(id: MongoAdapter.AnyId, options?: MongoEntityService.FindOneOptions<T>): Promise<T | undefined>;
     /**
      * Finds a document in the collection that matches the specified options.
      *
      * @param {MongoEntityService.FindOneOptions<T>} [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.
      */
-    findOne(options?: MongoEntityService.FindOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    findOne(options: RequiredSome<MongoEntityService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    findOne(options?: MongoEntityService.FindOneOptions<T>): Promise<T | undefined>;
     /**
      * 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.
      */
-    findMany(options?: MongoEntityService.FindManyOptions<T>): Promise<PartialDTO<T>[]>;
+    findMany(options: RequiredSome<MongoEntityService.FindManyOptions<T>, 'projection'>): Promise<PartialDTO<T>[]>;
+    findMany(options?: MongoEntityService.FindManyOptions<T>): Promise<T[]>;
     /**
      * Finds multiple documents in the collection and returns both records (max limit)
      * and total count that matched the given criteria
@@ -129,10 +133,14 @@ export declare class MongoCollectionService<T extends mongodb.Document> extends
      * @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.
      */
-    findManyWithCount(options?: MongoEntityService.FindManyOptions<T>): Promise<{
+    findManyWithCount(options: RequiredSome<MongoEntityService.FindManyOptions<T>, 'projection'>): Promise<{
         count: number;
         items: PartialDTO<T>[];
     }>;
+    findManyWithCount(options?: MongoEntityService.FindManyOptions<T>): Promise<{
+        count: number;
+        items: T[];
+    }>;
     /**
      * Retrieves a document from the collection by its ID. Throws error if not found.
      *
@@ -142,7 +150,8 @@ export declare class MongoCollectionService<T extends mongodb.Document> extends
      *    or rejects with a ResourceNotFoundError if the document does not exist.
      * @throws {ResourceNotAvailableError} - If the document with the specified ID does not exist.
      */
-    get(id: MongoAdapter.AnyId, options?: MongoEntityService.FindOneOptions<T>): Promise<PartialDTO<T>>;
+    get(id: MongoAdapter.AnyId, options: RequiredSome<MongoEntityService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T>>;
+    get(id: MongoAdapter.AnyId, options?: MongoEntityService.FindOneOptions<T>): Promise<T>;
     /**
      * Updates a document with the given id in the collection.
      *
@@ -152,7 +161,8 @@ export declare class MongoCollectionService<T extends mongodb.Document> extends
      * @returns {Promise<PartialDTO<T> | undefined>} A promise that resolves to the updated document or
      * undefined if the document was not found.
      */
-    update(id: MongoAdapter.AnyId, input: PatchDTO<T> | UpdateFilter<T>, options?: MongoEntityService.UpdateOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    update(id: MongoAdapter.AnyId, input: PatchDTO<T> | UpdateFilter<T>, options: RequiredSome<MongoEntityService.UpdateOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    update(id: MongoAdapter.AnyId, input: PatchDTO<T> | UpdateFilter<T>, options?: MongoEntityService.UpdateOneOptions<T>): Promise<T | undefined>;
     /**
      * Updates a document in the collection with the specified ID.
      *

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

@@ -149,7 +149,8 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @return {Promise<PartialDTO<T>>} - A promise that resolves with the partial output of the created item.
      * @throws {ResourceNotAvailableError} - If the parent document is not found.
      */
-    create(documentId: MongoAdapter.AnyId, input: PartialDTO<T>, options?: MongoNestedService.CreateOptions): Promise<PartialDTO<T>>;
+    create(documentId: MongoAdapter.AnyId, input: PartialDTO<T>, options: RequiredSome<MongoNestedService.CreateOptions, 'projection'>): Promise<PartialDTO<T>>;
+    create(documentId: MongoAdapter.AnyId, input: PartialDTO<T>, options?: MongoNestedService.CreateOptions): Promise<T>;
     protected _create(command: MongoNestedService.CreateCommand): Promise<PartialDTO<T>>;
     /**
      * Counts the number of documents in the collection that match the specified parentId and options.
@@ -204,7 +205,8 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @param {MongoNestedService.FindOneOptions<T>} [options] - The optional options for the operation.
      * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
      */
-    findById(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options?: MongoNestedService.FindOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    findById(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options: RequiredSome<MongoNestedService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    findById(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options?: MongoNestedService.FindOneOptions<T>): Promise<T | undefined>;
     protected _findById(command: MongoNestedService.FindOneCommand<T>): Promise<PartialDTO<T> | undefined>;
     /**
      * Finds the first array element that matches the given parentId.
@@ -213,7 +215,8 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @param {MongoNestedService.FindOneOptions<T>} [options] - Optional options to customize the query.
      * @returns {Promise<PartialDTO<T> | undefined>} A promise that resolves to the first matching document, or `undefined` if no match is found.
      */
-    findOne(documentId: MongoAdapter.AnyId, options?: MongoNestedService.FindOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    findOne(documentId: MongoAdapter.AnyId, options: RequiredSome<MongoNestedService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    findOne(documentId: MongoAdapter.AnyId, options?: MongoNestedService.FindOneOptions<T>): Promise<T | undefined>;
     protected _findOne(command: MongoNestedService.FindOneCommand<T>): Promise<PartialDTO<T> | undefined>;
     /**
      * Finds multiple elements in an array field.
@@ -222,7 +225,8 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @param {MongoNestedService.FindManyOptions<T>} [options] - The options for finding the documents.
      * @returns {Promise<PartialDTO<T>[]>} - The found documents.
      */
-    findMany(documentId: MongoAdapter.AnyId, options?: MongoNestedService.FindManyOptions<T>): Promise<PartialDTO<T>[]>;
+    findMany(documentId: MongoAdapter.AnyId, options: RequiredSome<MongoNestedService.FindManyOptions<T>, 'projection'>): Promise<PartialDTO<T>[]>;
+    findMany(documentId: MongoAdapter.AnyId, options?: MongoNestedService.FindManyOptions<T>): Promise<T[]>;
     protected _findMany(command: MongoNestedService.FindManyCommand<T>): Promise<PartialDTO<T>[]>;
     /**
      * Finds multiple elements in an array field.
@@ -231,10 +235,14 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @param {MongoNestedService.FindManyOptions<T>} [options] - The options for finding the documents.
      * @returns {Promise<PartialDTO<T>[]>} - The found documents.
      */
-    findManyWithCount(documentId: MongoAdapter.AnyId, options?: MongoNestedService.FindManyOptions<T>): Promise<{
+    findManyWithCount(documentId: MongoAdapter.AnyId, options: RequiredSome<MongoNestedService.FindManyOptions<T>, 'projection'>): Promise<{
         count: number;
         items: PartialDTO<T>[];
     }>;
+    findManyWithCount(documentId: MongoAdapter.AnyId, options?: MongoNestedService.FindManyOptions<T>): Promise<{
+        count: number;
+        items: T[];
+    }>;
     protected _findManyWithCount(command: MongoNestedService.FindManyCommand<T>): Promise<{
         count: number;
         items: PartialDTO<T>[];
@@ -248,7 +256,8 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @returns {Promise<PartialDTO<T>>} - The item found.
      * @throws {ResourceNotAvailableError} - If the item is not found.
      */
-    get(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options?: MongoNestedService.FindOneOptions<T>): Promise<PartialDTO<T>>;
+    get(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options: RequiredSome<MongoNestedService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T>>;
+    get(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options?: MongoNestedService.FindOneOptions<T>): Promise<T>;
     /**
      * Updates an array element with new data and returns the updated element
      *
@@ -259,7 +268,8 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @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.
      */
-    update(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    update(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options: RequiredSome<MongoNestedService.UpdateOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    update(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateOneOptions<T>): Promise<T | undefined>;
     /**
      * Update an array element with new data. Returns 1 if document updated 0 otherwise.
      *

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

@@ -1,5 +1,5 @@
 import mongodb, { UpdateFilter } from 'mongodb';
-import { PartialDTO, PatchDTO, Type } from 'ts-gems';
+import { PartialDTO, PatchDTO, RequiredSome, Type } from 'ts-gems';
 import { MongoAdapter } from './mongo-adapter.js';
 import { MongoEntityService } from './mongo-entity-service.js';
 /**
@@ -53,7 +53,8 @@ export declare class MongoSingletonService<T extends mongodb.Document> extends M
      * @return {Promise<PartialDTO<T>>} A promise that resolves to the partial output of the created document.
      * @throws {Error} Throws an error if an unknown error occurs while creating the document.
      */
-    create(input: PartialDTO<T>, options?: MongoEntityService.CreateOptions): Promise<PartialDTO<T>>;
+    create(input: PartialDTO<T>, options: RequiredSome<MongoEntityService.CreateOptions, 'projection'>): Promise<PartialDTO<T>>;
+    create(input: PartialDTO<T>, options?: MongoEntityService.CreateOptions): Promise<T>;
     /**
      * Deletes a record from the database
      *
@@ -74,7 +75,8 @@ export declare class MongoSingletonService<T extends mongodb.Document> extends M
      * @param {MongoEntityService.FindOneOptions<T>} [options] - The options for finding the document.
      * @returns {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the found document or undefined if not found.
      */
-    find(options?: MongoEntityService.FindOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    find(options: RequiredSome<MongoEntityService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    find(options?: MongoEntityService.FindOneOptions<T>): Promise<T | undefined>;
     /**
      * Fetches the document from the Mongo collection service. Throws error if not found.
      *
@@ -82,7 +84,8 @@ export declare class MongoSingletonService<T extends mongodb.Document> extends M
      * @return {Promise<PartialDTO<T>>} - A promise that resolves to the fetched document.
      * @throws {ResourceNotAvailableError} - If the document is not found in the collection.
      */
-    get(options?: MongoEntityService.FindOneOptions<T>): Promise<PartialDTO<T>>;
+    get(options: RequiredSome<MongoEntityService.FindOneOptions<T>, 'projection'>): Promise<PartialDTO<T>>;
+    get(options?: MongoEntityService.FindOneOptions<T>): Promise<T>;
     /**
      * Updates a document in the MongoDB collection.
      *
@@ -91,7 +94,8 @@ export declare class MongoSingletonService<T extends mongodb.Document> extends M
      *
      * @return {Promise<PartialDTO<T> | undefined>} - A promise that resolves to the updated document or undefined if not found.
      */
-    update(input: PatchDTO<T> | UpdateFilter<T>, options?: MongoEntityService.UpdateOneOptions<T>): Promise<PartialDTO<T> | undefined>;
+    update(input: PatchDTO<T> | UpdateFilter<T>, options: RequiredSome<MongoEntityService.UpdateOneOptions<T>, 'projection'>): Promise<PartialDTO<T> | undefined>;
+    update(input: PatchDTO<T> | UpdateFilter<T>, options?: MongoEntityService.UpdateOneOptions<T>): Promise<T | undefined>;
     /**
      * Updates a document in the MongoDB collection.
      *