@opra/mongodb 1.0.0-alpha.9 → 1.0.0-beta.1

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

@@ -1,10 +1,9 @@
 import { ComplexType } from '@opra/common';
 import mongodb from 'mongodb';
-import { PartialDTO, PatchDTO, Type } from 'ts-gems';
+import type { DTO, PartialDTO, PatchDTO, RequiredSome, StrictOmit, Type } from 'ts-gems';
 import { MongoAdapter } from './mongo-adapter.js';
-import { MongoCollectionService } from './mongo-collection-service.js';
+import type { MongoEntityService } from './mongo-entity-service';
 import { MongoService } from './mongo-service.js';
-import FilterInput = MongoAdapter.FilterInput;
 /**
  *
  * @namespace MongoNestedService
@@ -16,36 +15,70 @@ export declare namespace MongoNestedService {
     interface Options extends MongoService.Options {
         defaultLimit?: number;
         nestedKey?: string;
-        $nestedFilter?: FilterInput | ((args: MongoService.CommandInfo, _this: this) => FilterInput | Promise<FilterInput> | undefined);
+        nestedFilter?: MongoAdapter.FilterInput | ((args: MongoService.CommandInfo, _this: this) => MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined);
+    }
+    interface CommandInfo extends MongoService.CommandInfo {
     }
     interface CreateOptions extends MongoService.CreateOptions {
     }
     interface CountOptions<T> extends MongoService.CountOptions<T> {
-        documentFilter?: FilterInput;
+        documentFilter?: MongoAdapter.FilterInput;
     }
     interface DeleteOptions<T> extends MongoService.DeleteOptions<T> {
-        documentFilter?: FilterInput;
+        documentFilter?: MongoAdapter.FilterInput;
     }
     interface DeleteManyOptions<T> extends MongoService.DeleteManyOptions<T> {
-        documentFilter?: FilterInput;
+        documentFilter?: MongoAdapter.FilterInput;
     }
     interface ExistsOptions<T> extends MongoService.ExistsOptions<T> {
     }
-    interface ExistsOneOptions<T> extends MongoService.ExistsOneOptions<T> {
-    }
     interface FindOneOptions<T> extends MongoService.FindOneOptions<T> {
-        documentFilter?: FilterInput;
+        documentFilter?: MongoAdapter.FilterInput;
     }
     interface FindManyOptions<T> extends MongoService.FindManyOptions<T> {
-        documentFilter?: FilterInput;
-        nestedFilter?: FilterInput;
+        documentFilter?: MongoAdapter.FilterInput;
+        nestedFilter?: MongoAdapter.FilterInput;
     }
-    interface UpdateOptions<T> extends MongoService.UpdateOptions<T> {
-        documentFilter?: FilterInput;
+    interface UpdateOneOptions<T> extends MongoService.UpdateOneOptions<T> {
+        documentFilter?: MongoAdapter.FilterInput;
     }
     interface UpdateManyOptions<T> extends MongoService.UpdateManyOptions<T> {
-        documentFilter?: FilterInput;
-        count?: boolean;
+        documentFilter?: MongoAdapter.FilterInput;
+    }
+    interface CreateCommand<T> extends RequiredSome<CommandInfo, 'documentId' | 'input'> {
+        crud: 'create';
+        input: DTO<T>;
+        options?: CreateOptions;
+    }
+    interface CountCommand<T> extends StrictOmit<RequiredSome<CommandInfo, 'documentId'>, 'nestedId' | 'input'> {
+        crud: 'read';
+        options?: CountOptions<T>;
+    }
+    interface DeleteCommand<T> extends StrictOmit<RequiredSome<CommandInfo, 'documentId'>, 'input'> {
+        crud: 'delete';
+        options?: DeleteOptions<T>;
+    }
+    interface ExistsCommand<T> extends StrictOmit<RequiredSome<CommandInfo, 'documentId'>, 'input'> {
+        crud: 'read';
+        options?: ExistsOptions<T>;
+    }
+    interface FindOneCommand<T> extends StrictOmit<RequiredSome<CommandInfo, 'documentId'>, 'input'> {
+        crud: 'read';
+        options?: FindOneOptions<T>;
+    }
+    interface FindManyCommand<T> extends StrictOmit<RequiredSome<CommandInfo, 'documentId'>, 'input'> {
+        crud: 'read';
+        options?: FindManyOptions<T>;
+    }
+    interface UpdateOneCommand<T> extends RequiredSome<CommandInfo, 'documentId'> {
+        crud: 'update';
+        input: PatchDTO<T> | mongodb.UpdateFilter<T>;
+        options?: MongoNestedService.UpdateOneOptions<T>;
+    }
+    interface UpdateManyCommand<T> extends RequiredSome<CommandInfo, 'documentId'> {
+        crud: 'update';
+        input: PatchDTO<T> | mongodb.UpdateFilter<T>;
+        options?: MongoNestedService.UpdateManyOptions<T>;
     }
 }
 /**
@@ -77,7 +110,7 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      *
      * @type {FilterInput | Function}
      */
-    $nestedFilter?: FilterInput | ((args: MongoService.CommandInfo, _this: this) => FilterInput | Promise<FilterInput> | undefined);
+    nestedFilter?: MongoAdapter.FilterInput | ((args: MongoService.CommandInfo, _this: this) => MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined);
     /**
      * Constructs a new instance
      *
@@ -109,13 +142,24 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * 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.
+     * @param {DTO<T>} input - The item to be added to the array field.
+     * @param {MongoNestedService.CreateOptions<T>} [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.
      */
-    create(documentId: MongoAdapter.AnyId, input: PartialDTO<T>, options?: MongoNestedService.CreateOptions): Promise<PartialDTO<T>>;
-    protected _create(documentId: MongoAdapter.AnyId, input: PartialDTO<T>, options?: MongoNestedService.CreateOptions): Promise<PartialDTO<T>>;
+    create(documentId: MongoAdapter.AnyId, input: DTO<T>, options: RequiredSome<MongoNestedService.CreateOptions, 'projection'>): Promise<PartialDTO<T>>;
+    create(documentId: MongoAdapter.AnyId, input: DTO<T>, options?: MongoNestedService.CreateOptions): Promise<T>;
+    /**
+     * Adds a single item into the array field.
+     *
+     * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
+     * @param {DTO<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 create operation result
+     * @throws {ResourceNotAvailableError} - If the parent document is not found.
+     */
+    createOnly(documentId: MongoAdapter.AnyId, input: DTO<T>, options?: MongoNestedService.CreateOptions): Promise<PartialDTO<T>>;
+    protected _create(command: MongoNestedService.CreateCommand<T>): Promise<T>;
     /**
      * Counts the number of documents in the collection that match the specified parentId and options.
      *
@@ -124,7 +168,7 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @returns {Promise<number>} - A promise that resolves to the count of documents.
      */
     count(documentId: MongoAdapter.AnyId, options?: MongoNestedService.CountOptions<T>): Promise<number>;
-    protected _count(documentId: MongoAdapter.AnyId, options?: MongoNestedService.CountOptions<T>): Promise<number>;
+    protected _count(command: MongoNestedService.CountCommand<T>): Promise<number>;
     /**
      * Deletes an element from an array within a document in the MongoDB collection.
      *
@@ -134,7 +178,7 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @return {Promise<number>} - A Promise that resolves to the number of elements deleted (1 if successful, 0 if not).
      */
     delete(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options?: MongoNestedService.DeleteOptions<T>): Promise<number>;
-    protected _delete(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, options?: MongoNestedService.DeleteOptions<T>): Promise<number>;
+    protected _delete(command: MongoNestedService.DeleteCommand<T>): Promise<number>;
     /**
      * Deletes multiple items from a collection based on the parent ID and optional filter.
      *
@@ -143,7 +187,7 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @returns {Promise<number>} - A Promise that resolves to the number of items deleted.
      */
     deleteMany(documentId: MongoAdapter.AnyId, options?: MongoNestedService.DeleteManyOptions<T>): Promise<number>;
-    protected _deleteMany(documentId: MongoAdapter.AnyId, options?: MongoNestedService.DeleteManyOptions<T>): Promise<number>;
+    protected _deleteMany(command: MongoNestedService.DeleteCommand<T>): Promise<number>;
     /**
      * Checks if an array element with the given parentId and id exists.
      *
@@ -157,10 +201,10 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * Checks if an object with the given arguments exists.
      *
      * @param {MongoAdapter.AnyId} documentId - The ID of the parent document.
-     * @param {MongoNestedService.ExistsOneOptions} [options] - The options for the query (optional).
+     * @param {MongoNestedService.ExistsOptions} [options] - The options for the query (optional).
      * @return {Promise<boolean>} - A Promise that resolves to a boolean indicating whether the object exists or not.
      */
-    existsOne(documentId: MongoAdapter.AnyId, options?: MongoCollectionService.ExistsOneOptions<T>): Promise<boolean>;
+    existsOne(documentId: MongoAdapter.AnyId, options?: MongoNestedService.ExistsOptions<T>): Promise<boolean>;
     /**
      * Finds an element in array field by its parent ID and ID.
      *
@@ -169,8 +213,9 @@ 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>;
-    protected _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.
      *
@@ -178,8 +223,9 @@ 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>;
-    protected _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.
      *
@@ -187,8 +233,9 @@ 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>[]>;
-    protected _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.
      *
@@ -196,11 +243,15 @@ 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>[];
     }>;
-    protected _findManyWithCount(documentId: MongoAdapter.AnyId, options: MongoNestedService.FindManyOptions<T>): Promise<{
+    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>[];
     }>;
@@ -213,29 +264,31 @@ 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
      *
      * @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.
      */
-    update(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateOptions<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.
      *
      * @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.
      */
-    updateOnly(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateOptions<T>): Promise<number>;
-    protected _updateOnly(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateOptions<T>): Promise<number>;
+    updateOnly(documentId: MongoAdapter.AnyId, nestedId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateOneOptions<T>): Promise<number>;
+    protected _updateOnly(command: MongoNestedService.UpdateOneCommand<T>): Promise<number>;
     /**
      * Updates multiple array elements in document
      *
@@ -245,14 +298,25 @@ export declare class MongoNestedService<T extends mongodb.Document> extends Mong
      * @returns {Promise<number>} - A promise that resolves to the number of documents updated.
      */
     updateMany(documentId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateManyOptions<T>): Promise<number>;
-    protected _updateMany(documentId: MongoAdapter.AnyId, input: PatchDTO<T>, options?: MongoNestedService.UpdateManyOptions<T>): Promise<number>;
+    protected _updateMany(command: MongoNestedService.UpdateManyCommand<T>): Promise<number>;
     /**
      * Retrieves the common filter used for querying array elements.
      * This method is mostly used for security issues like securing multi-tenant applications.
      *
      * @protected
-     * @returns {FilterInput | Promise<FilterInput> | undefined} The common filter or a Promise
+     * @returns {MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined} The common filter or a Promise
      * that resolves to the common filter, or undefined if not available.
      */
-    protected _getNestedFilter(args: MongoService.CommandInfo): FilterInput | Promise<FilterInput> | undefined;
+    protected _getNestedFilter(args: MongoService.CommandInfo): MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined;
+    protected _executeCommand(command: MongoEntityService.CommandInfo, commandFn: () => any): Promise<any>;
+    protected _beforeCreate(command: MongoNestedService.CreateCommand<T>): Promise<void>;
+    protected _beforeUpdate(command: MongoNestedService.UpdateOneCommand<T>): Promise<void>;
+    protected _beforeUpdateMany(command: MongoNestedService.UpdateManyCommand<T>): Promise<void>;
+    protected _beforeDelete(command: MongoNestedService.DeleteCommand<T>): Promise<void>;
+    protected _beforeDeleteMany(command: MongoNestedService.DeleteCommand<T>): Promise<void>;
+    protected _afterCreate(command: MongoNestedService.CreateCommand<T>, result: PartialDTO<T>): Promise<void>;
+    protected _afterUpdate(command: MongoNestedService.UpdateOneCommand<T>, result?: PartialDTO<T>): Promise<void>;
+    protected _afterUpdateMany(command: MongoNestedService.UpdateManyCommand<T>, affected: number): Promise<void>;
+    protected _afterDelete(command: MongoNestedService.DeleteCommand<T>, affected: number): Promise<void>;
+    protected _afterDeleteMany(command: MongoNestedService.DeleteCommand<T>, affected: number): Promise<void>;
 }

package/types/mongo-service.d.ts

@@ -1,9 +1,8 @@
-import * as OpraCommon from '@opra/common';
 import { ComplexType } from '@opra/common';
-import { ServiceBase } from '@opra/core';
-import mongodb, { Document, TransactionOptions } from 'mongodb';
-import { PartialDTO, StrictOmit, Type } from 'ts-gems';
-import { IsObject } from 'valgen';
+import { HttpContext, ServiceBase } from '@opra/core';
+import mongodb, { type Document, type TransactionOptions } from 'mongodb';
+import type { Nullish, StrictOmit, Type } from 'ts-gems';
+import type { IsObject } from 'valgen';
 import { MongoAdapter } from './mongo-adapter.js';
 /**
  * The namespace for the MongoService.
@@ -14,12 +13,12 @@ export declare namespace MongoService {
     interface Options {
         db?: MongoService<any>['db'];
         session?: MongoService<any>['session'];
-        collectionName?: MongoService<any>['$collectionName'];
-        resourceName?: MongoService<any>['$resourceName'];
-        documentFilter?: MongoService<any>['$documentFilter'];
-        interceptor?: MongoService<any>['$interceptor'];
-        idGenerator?: MongoService<any>['$idGenerator'];
-        onError?: MongoService<any>['$onError'];
+        collectionName?: MongoService<any>['collectionName'];
+        resourceName?: MongoService<any>['resourceName'];
+        documentFilter?: MongoService<any>['documentFilter'];
+        interceptor?: MongoService<any>['interceptor'];
+        idGenerator?: MongoService<any>['idGenerator'];
+        onError?: MongoService<any>['onError'];
     }
     type CrudOp = 'create' | 'read' | 'update' | 'delete';
     interface CommandInfo {
@@ -28,9 +27,10 @@ export declare namespace MongoService {
         byId: boolean;
         documentId?: MongoAdapter.AnyId;
         nestedId?: MongoAdapter.AnyId;
-        input?: Record<string, any>;
-        options?: Record<string, any>;
+        input?: any;
+        options?: any;
     }
+    type DocumentFilter = MongoAdapter.FilterInput | ((args: CommandInfo, _this: MongoService<any>) => MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined);
     /**
      * Represents options for "create" operation
      *
@@ -46,7 +46,7 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface CountOptions<T> extends mongodb.CountOptions {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
     /**
      * Represents options for "delete" operation
@@ -55,7 +55,7 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface DeleteOptions<T> extends mongodb.DeleteOptions {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
     /**
      * Represents options for "deleteMany" operation
@@ -64,7 +64,7 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface DeleteManyOptions<T> extends mongodb.DeleteOptions {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
     /**
      * Represents options for "distinct" operation
@@ -73,7 +73,7 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface DistinctOptions<T> extends mongodb.DistinctOptions {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
     /**
      * Represents options for "exists" operation
@@ -81,15 +81,7 @@ export declare namespace MongoService {
      * @interface
      */
     interface ExistsOptions<T> extends Omit<mongodb.CommandOperationOptions, 'writeConcern'> {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
-    }
-    /**
-     * Represents options for checking the document exists
-     *
-     * @interface
-     */
-    interface ExistsOneOptions<T> extends Omit<mongodb.CommandOperationOptions, 'writeConcern'> {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
     /**
      * Represents options for "findOne" operation
@@ -106,7 +98,7 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface FindManyOptions<T> extends mongodb.AggregateOptions {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
         projection?: string | string[] | Document;
         sort?: string[];
         limit?: number;
@@ -118,9 +110,9 @@ export declare namespace MongoService {
      * @interface
      * @template T - The type of the document.
      */
-    interface UpdateOptions<T> extends StrictOmit<mongodb.FindOneAndUpdateOptions, 'projection' | 'returnDocument' | 'includeResultMetadata'> {
+    interface UpdateOneOptions<T> extends StrictOmit<mongodb.FindOneAndUpdateOptions, 'projection' | 'returnDocument' | 'includeResultMetadata'> {
         projection?: string | string[] | Document;
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
     /**
      * Represents options for "updateMany" operation
@@ -129,9 +121,20 @@ export declare namespace MongoService {
      * @template T - The type of the document.
      */
     interface UpdateManyOptions<T> extends StrictOmit<mongodb.UpdateOptions, 'upsert'> {
-        filter?: mongodb.Filter<T> | OpraCommon.OpraFilter.Ast | string;
+        filter?: MongoAdapter.FilterInput<T>;
     }
 }
+export interface MongoService {
+    /**
+     * Interceptor function for handling callback execution with provided arguments.
+     * @type Function
+     * @param next - The callback function to be intercepted.
+     * @param {MongoService.CommandInfo} command - The arguments object containing the following properties:
+     * @param _this - The reference to the current object.
+     * @returns - The promise that resolves to the result of the callback execution.
+     */
+    interceptor?(next: () => any, command: MongoService.CommandInfo, _this: any): Promise<any>;
+}
 /**
  * Class representing a MongoDB service for interacting with a collection.
  * @extends ServiceBase
@@ -139,18 +142,18 @@ export declare namespace MongoService {
  */
 export declare class MongoService<T extends mongodb.Document = mongodb.Document> extends ServiceBase {
     protected _dataType_: Type | string;
-    protected _dataType: ComplexType;
+    protected _dataType?: ComplexType;
     protected _inputCodecs: Record<string, IsObject.Validator<T>>;
     protected _outputCodecs: Record<string, IsObject.Validator<T>>;
     /**
      * Represents the name of a collection in MongoDB
      */
-    $collectionName?: string | ((_this: any) => string);
+    collectionName?: string | ((_this: any) => string);
     /**
      * Represents the name of a resource.
      * @type {string}
      */
-    $resourceName?: string | ((_this: any) => string);
+    resourceName?: string | ((_this: any) => string);
     /**
      * Represents a MongoDB database object.
      */
@@ -163,29 +166,20 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      * Generates a new id for new inserting Document.
      *
      */
-    $idGenerator?: (_this: any) => MongoAdapter.AnyId;
+    idGenerator?: (command: MongoService.CommandInfo, _this: any) => MongoAdapter.AnyId;
     /**
      * Callback function for handling errors.
      *
      * @param {unknown} error - The error object.
      * @param _this - The context object.
      */
-    $onError?: (error: unknown, _this: any) => void | Promise<void>;
+    onError?: (error: unknown, _this: any) => void | Promise<void>;
     /**
-     * Represents a common filter function for a MongoEntityService.
+     * Represents a common filter function for a MongoService.
      *
      * @type {FilterInput | Function}
      */
-    $documentFilter?: MongoAdapter.FilterInput | ((args: MongoService.CommandInfo, _this: this) => MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined);
-    /**
-     * Interceptor function for handling callback execution with provided arguments.
-     *
-     * @param callback - The callback function to be intercepted.
-     * @param {MongoService.CommandInfo} info - The arguments object containing the following properties:
-     * @param _this - The reference to the current object.
-     * @returns - The promise that resolves to the result of the callback execution.
-     */
-    $interceptor?: (callback: () => any, info: MongoService.CommandInfo, _this: any) => Promise<any>;
+    documentFilter?: MongoService.DocumentFilter | MongoService.DocumentFilter[];
     /**
      * Constructs a new instance
      *
@@ -194,6 +188,7 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      * @constructor
      */
     constructor(dataType: Type | string, options?: MongoService.Options);
+    for<C extends HttpContext, P extends Partial<this>>(context: C, overwriteProperties?: Nullish<P>, overwriteContext?: Partial<C>): this & Required<P>;
     /**
      * Retrieves the collection name.
      *
@@ -207,7 +202,7 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      *
      * @protected
      * @returns {string} The resource name.
-     * @throws {Error} If the collection name is not defined.
+     * @throws {Error} If the resource name is not defined.
      */
     getResourceName(): string;
     /**
@@ -216,16 +211,6 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      * @throws {NotAcceptableError} If the data type is not a ComplexType.
      */
     get dataType(): ComplexType;
-    /**
-     * Retrieves the codec for the specified operation.
-     *
-     * @param operation - The operation to retrieve the encoder for. Valid values are 'create' and 'update'.
-     */
-    getInputCodec(operation: string): IsObject.Validator<T>;
-    /**
-     * Retrieves the codec.
-     */
-    getOutputCodec(operation: string): IsObject.Validator<T>;
     /**
      * Executes the provided function within a transaction.
      *
@@ -233,99 +218,6 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      * @param [options] - Optional options for the transaction.
      */
     withTransaction(callback: MongoAdapter.WithTransactionCallback, options?: TransactionOptions): Promise<any>;
-    /**
-     * Gets the number of documents matching the filter.
-     *
-     * @param filter - The filter used to match documents.
-     * @param options - The options for counting documents.
-     * @protected
-     */
-    protected _dbCountDocuments(filter?: mongodb.Filter<T>, options?: mongodb.CountOptions): Promise<number>;
-    /**
-     * Acquires a connection and performs Collection.deleteOne operation
-     *
-     * @param filter - The filter used to select the document to remove
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbDeleteOne(filter?: mongodb.Filter<T>, options?: mongodb.DeleteOptions): Promise<mongodb.DeleteResult>;
-    /**
-     * Acquires a connection and performs Collection.deleteMany operation
-     *
-     * @param filter - The filter used to select the documents to remove
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbDeleteMany(filter?: mongodb.Filter<T>, options?: mongodb.DeleteOptions): Promise<mongodb.DeleteResult>;
-    /**
-     * Acquires a connection and performs Collection.distinct operation
-     *
-     * @param field - Field of the document to find distinct values for
-     * @param filter - The filter for filtering the set of documents to which we apply the distinct filter.
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbDistinct(field: string, filter?: mongodb.Filter<T>, options?: mongodb.DistinctOptions): Promise<any[]>;
-    /**
-     * Acquires a connection and performs Collection.aggregate operation
-     *
-     * @param pipeline - An array of aggregation pipelines to execute
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbAggregate(pipeline?: mongodb.Document[], options?: mongodb.AggregateOptions): Promise<mongodb.AggregationCursor<T>>;
-    /**
-     * Acquires a connection and performs Collection.findOne operation
-     *
-     * @param filter - Query for find Operation
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbFindOne(filter: mongodb.Filter<T>, options?: mongodb.FindOptions): Promise<PartialDTO<T> | undefined>;
-    /**
-     * Acquires a connection and performs Collection.find operation
-     *
-     * @param filter - The filter predicate. If unspecified,
-     * then all documents in the collection will match the predicate
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbFind(filter: mongodb.Filter<T>, options?: mongodb.FindOptions): Promise<mongodb.FindCursor<T>>;
-    /**
-     * Acquires a connection and performs Collection.insertOne operation
-     *
-     * @param doc - The document to insert
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbInsertOne(doc: mongodb.OptionalUnlessRequiredId<T>, options?: mongodb.InsertOneOptions): Promise<mongodb.InsertOneResult<T>>;
-    /**
-     * Acquires a connection and performs Collection.updateOne operation
-     *
-     * @param filter - The filter used to select the document to update
-     * @param update - The update operations to be applied to the document
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbUpdateOne(filter: mongodb.Filter<T>, update: mongodb.UpdateFilter<T>, options?: mongodb.UpdateOptions): Promise<mongodb.UpdateResult<T>>;
-    /**
-     * Acquires a connection and performs Collection.findOneAndUpdate operation
-     *
-     * @param filter - The filter used to select the document to update
-     * @param update - Update operations to be performed on the document
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbFindOneAndUpdate(filter: mongodb.Filter<T>, update: mongodb.UpdateFilter<T>, options?: mongodb.FindOneAndUpdateOptions): Promise<mongodb.WithId<T> | null>;
-    /**
-     * Acquires a connection and performs Collection.updateMany operation
-     *
-     * @param filter - The filter used to select the documents to update
-     * @param update - The update operations to be applied to the documents
-     * @param options - Optional settings for the command
-     * @protected
-     */
-    protected _dbUpdateMany(filter: mongodb.Filter<T>, update: mongodb.UpdateFilter<T> | Partial<T>, options?: StrictOmit<mongodb.UpdateOptions, 'upsert'>): Promise<mongodb.UpdateResult<T>>;
     /**
      * Retrieves the database connection.
      *
@@ -355,7 +247,7 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      * @protected
      * @returns {MongoAdapter.AnyId} The generated ID.
      */
-    protected _generateId(): MongoAdapter.AnyId;
+    protected _generateId(command: MongoService.CommandInfo): MongoAdapter.AnyId;
     /**
      * Retrieves the common filter used for querying documents.
      * This method is mostly used for security issues like securing multi-tenant applications.
@@ -364,6 +256,16 @@ export declare class MongoService<T extends mongodb.Document = mongodb.Document>
      * @returns {FilterInput | Promise<FilterInput> | undefined} The common filter or a Promise
      * that resolves to the common filter, or undefined if not available.
      */
-    protected _getDocumentFilter(info: MongoService.CommandInfo): MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined;
-    protected _intercept(callback: (...args: any[]) => any, info: MongoService.CommandInfo): Promise<any>;
+    protected _getDocumentFilter(command: MongoService.CommandInfo): MongoAdapter.FilterInput | Promise<MongoAdapter.FilterInput> | undefined;
+    protected _executeCommand(command: MongoService.CommandInfo, commandFn: () => any): Promise<any>;
+    /**
+     * Retrieves the codec for the specified operation.
+     *
+     * @param operation - The operation to retrieve the encoder for. Valid values are 'create' and 'update'.
+     */
+    protected _getInputCodec(operation: string): IsObject.Validator<T>;
+    /**
+     * Retrieves the codec.
+     */
+    protected _getOutputCodec(operation: string): IsObject.Validator<T>;
 }