@cyberskill/shared 2.20.0 → 2.25.0

package/dist/node/mongo/mongo.util.d.ts

@@ -1,7 +1,15 @@
 import { default as mongooseRaw } from 'mongoose';
 import { default as migrate } from 'migrate-mongo';
-import { I_Return } from '../../typescript/index.js';
-import { C_Db, C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DeleteOptionsExtended, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_MongooseModelMiddleware, I_PaginateOptionsWithPopulate, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Filter, T_FilterQuery, T_Input_Populate, T_InsertManyOptions, T_MongoosePlugin, T_MongooseShema, T_PaginateResult, T_PipelineStage, T_ProjectionType, T_QueryOptions, T_UpdateQuery, T_UpdateResult, T_VirtualOptions, T_WithId } from './mongo.type.js';
+import { MongoController } from './mongo.controller.js';
+import { C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DynamicVirtualConfig, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_MongooseModelMiddleware, T_Input_Populate, T_MongoosePlugin, T_MongooseShema, T_QueryFilter, T_VirtualOptions, T_WithId } from './mongo.type.js';
+/**
+ * Converts enum values to proper model names.
+ * Handles common naming conventions like converting 'USER' to 'User'.
+ *
+ * @param enumValue - The enum value to convert
+ * @returns The converted model name
+ */
+export declare function convertEnumToModelName(enumValue: string): string;
 /**
  * MongoDB utility object providing comprehensive database operations and utilities.
  * This object contains methods for creating generic fields, applying plugins and middlewares,
@@ -150,6 +158,8 @@ export declare const mongo: {
                 _id: mongooseRaw.Types.ObjectId;
             } & {
                 __v: number;
+            } & {
+                id: string;
             }, any, unknown>>(name: string): ModelType;
             <ModelType = mongooseRaw.Model<any, {}, {}, {}, any, any, any>>(): ModelType;
         } | undefined, I_GenericDocument, mongooseRaw.Document<unknown, {}, I_GenericDocument, {}, mongooseRaw.ResolveSchemaOptions<mongooseRaw.DefaultSchemaOptions>> & I_GenericDocument & Required<{
@@ -157,7 +167,7 @@ export declare const mongo: {
         }> & {
             __v: number;
         }> | undefined;
-        $op?: mongooseRaw.SchemaDefinitionProperty<"remove" | "save" | "validate" | null | undefined, I_GenericDocument, mongooseRaw.Document<unknown, {}, I_GenericDocument, {}, mongooseRaw.ResolveSchemaOptions<mongooseRaw.DefaultSchemaOptions>> & I_GenericDocument & Required<{
+        $op?: mongooseRaw.SchemaDefinitionProperty<"save" | "validate" | "remove" | null | undefined, I_GenericDocument, mongooseRaw.Document<unknown, {}, I_GenericDocument, {}, mongooseRaw.ResolveSchemaOptions<mongooseRaw.DefaultSchemaOptions>> & I_GenericDocument & Required<{
             _id: mongooseRaw.Types.ObjectId;
         }> & {
             __v: number;
@@ -319,6 +329,8 @@ export declare const mongo: {
                 _id: mongooseRaw.Types.ObjectId;
             } & {
                 __v: number;
+            } & {
+                id: string;
             }, any, unknown>>(name: string): ModelType;
             <ModelType = mongooseRaw.Model<any, {}, {}, {}, any, any, any>>(): ModelType;
         } | undefined, I_GenericDocument, mongooseRaw.Document<unknown, {}, I_GenericDocument, {}, mongooseRaw.ResolveSchemaOptions<mongooseRaw.DefaultSchemaOptions>> & I_GenericDocument & Required<{
@@ -406,7 +418,11 @@ export declare const mongo: {
             }, "id"> & {
                 id: string;
             }> | undefined;
-        }, {} & Required<{
+        }, {
+            [x: number]: {};
+            [x: symbol]: {};
+            [x: string]: {};
+        } & Required<{
             _id: unknown;
         }> & {
             __v: number;
@@ -984,7 +1000,7 @@ export declare const mongo: {
      * @param fields - An array of field names to convert to regex patterns.
      * @returns A new filter object with string values converted to regex patterns.
      */
-    regexify<T>(filter?: T_FilterQuery<T>, fields?: (keyof T | string)[]): T_FilterQuery<T>;
+    regexify<T>(filter?: T_QueryFilter<T>, fields?: (keyof T | string)[]): T_QueryFilter<T>;
     /**
      * Checks if a virtual options object has a dynamic ref function.
      *
@@ -1010,514 +1026,15 @@ export declare const mongo: {
     getExistingRecords<T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean): Promise<T_WithId<T>[]>;
 };
 /**
- * MongoDB native driver controller for direct database operations.
- * This class provides a simplified interface for MongoDB operations using the native driver,
- * with automatic generic field generation and standardized response formatting.
+ * Recursively applies nested populate options to populated documents.
+ * This function handles cases where a populated field needs further population.
+ *
+ * @template T - The document type
+ * @param mongoose - The Mongoose instance
+ * @param documents - The documents to apply nested populations to
+ * @param populateOptions - The populate options to apply
+ * @param virtualConfigs - Optional virtual configurations for model inference
+ * @param currentModel - The current model context (which model's schema to search for virtuals)
+ * @returns Promise with documents that have nested populations applied
  */
-export declare class MongoController<D extends Partial<C_Document>> {
-    private collection;
-    /**
-     * Creates a new MongoDB controller instance.
-     *
-     * @param db - The MongoDB database instance.
-     * @param collectionName - The name of the collection to operate on.
-     */
-    constructor(db: C_Db, collectionName: string);
-    /**
-     * Creates a single document in the collection.
-     * This method adds generic fields (id, isDel, timestamps) to the document before insertion.
-     *
-     * @param document - The document to create, with or without generic fields.
-     * @returns A promise that resolves to a standardized response with the created document.
-     */
-    createOne(document: D | Partial<D>): Promise<I_Return<D | Partial<D>>>;
-    /**
-     * Creates multiple documents in the collection.
-     * This method adds generic fields to each document before bulk insertion.
-     *
-     * @param documents - An array of documents to create.
-     * @returns A promise that resolves to a standardized response with the created documents.
-     */
-    createMany(documents: (D | Partial<D>)[]): Promise<I_Return<(D | Partial<D>)[]>>;
-    /**
-     * Finds a single document by filter criteria.
-     *
-     * @param filter - The filter criteria to find the document.
-     * @returns A promise that resolves to a standardized response with the found document.
-     */
-    findOne(filter: T_Filter<D>): Promise<I_Return<T_WithId<D>>>;
-    /**
-     * Finds all documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find documents (defaults to empty object for all documents).
-     * @returns A promise that resolves to a standardized response with the found documents.
-     */
-    findAll(filter?: T_Filter<D>): Promise<I_Return<T_WithId<D>[]>>;
-    /**
-     * Counts documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to count documents (defaults to empty object for all documents).
-     * @returns A promise that resolves to a standardized response with the document count.
-     */
-    count(filter?: T_Filter<D>): Promise<I_Return<number>>;
-    /**
-     * Updates a single document matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find the document to update.
-     * @param update - The update data to apply to the document.
-     * @returns A promise that resolves to a standardized response with the update result.
-     */
-    updateOne(filter: T_Filter<D>, update: Partial<D>): Promise<I_Return<T_UpdateResult>>;
-    /**
-     * Updates multiple documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find documents to update.
-     * @param update - The update data to apply to the documents.
-     * @returns A promise that resolves to a standardized response with the update result.
-     */
-    updateMany(filter: T_Filter<D>, update: Partial<D>): Promise<I_Return<T_UpdateResult>>;
-    /**
-     * Deletes a single document matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find the document to delete.
-     * @returns A promise that resolves to a standardized response with the delete result.
-     */
-    deleteOne(filter: T_Filter<D>): Promise<I_Return<T_DeleteResult>>;
-    /**
-     * Deletes multiple documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find documents to delete.
-     * @returns A promise that resolves to a standardized response with the delete result.
-     */
-    deleteMany(filter: T_Filter<D>): Promise<I_Return<T_DeleteResult>>;
-}
-/**
- * Mongoose controller for database operations with advanced features.
- * This class provides a comprehensive interface for Mongoose operations including
- * pagination, aggregation, slug generation, and short ID creation.
- */
-export declare class MongooseController<T extends Partial<C_Document>> {
-    private model;
-    /**
-     * Creates a new Mongoose controller instance.
-     *
-     * @param model - The Mongoose model to operate on.
-     */
-    constructor(model: I_ExtendedModel<T>);
-    /**
-     * Gets the model name for logging and error messages.
-     *
-     * @returns The name of the model.
-     */
-    private getModelName;
-    /**
-     * Gets the dynamic virtuals configuration from the model instance.
-     *
-     * @returns Array of dynamic virtual configurations or undefined if none exist.
-     */
-    private getDynamicVirtuals;
-    /**
-     * Populates dynamic virtuals for a single document.
-     *
-     * @param result - The document to populate dynamic virtuals for.
-     * @param populate - The populate options to determine which virtuals to populate.
-     * @returns The document with dynamic virtuals populated.
-     */
-    private populateDynamicVirtualsForDocument;
-    /**
-     * Populates dynamic virtuals for an array of documents.
-     *
-     * @param results - The documents to populate dynamic virtuals for.
-     * @param populate - The populate options to determine which virtuals to populate.
-     * @returns The documents with dynamic virtuals populated.
-     */
-    private populateDynamicVirtualsForDocuments;
-    /**
-     * Finds a single document with optional population and projection.
-     * Automatically handles dynamic virtual population if configured.
-     *
-     * @param filter - The filter criteria to find the document.
-     * @param projection - The fields to include/exclude in the result.
-     * @param options - Query options for the operation.
-     * @param populate - Population configuration for related documents.
-     * @returns A promise that resolves to a standardized response with the found document.
-     */
-    findOne(filter?: T_FilterQuery<T>, projection?: T_ProjectionType<T>, options?: T_QueryOptions<T>, populate?: T_Input_Populate): Promise<I_Return<T>>;
-    /**
-     * Finds all documents with optional population and projection.
-     * Automatically handles dynamic virtual population if configured.
-     *
-     * @param filter - The filter criteria to find documents.
-     * @param projection - The fields to include/exclude in the result.
-     * @param options - Query options for the operation.
-     * @param populate - Population configuration for related documents.
-     * @returns A promise that resolves to a standardized response with the found documents.
-     */
-    findAll(filter?: T_FilterQuery<T>, projection?: T_ProjectionType<T>, options?: T_QueryOptions<T>, populate?: T_Input_Populate): Promise<I_Return<T[]>>;
-    /**
-     * Finds documents with pagination support.
-     * Automatically handles dynamic virtual population if configured.
-     *
-     * @param filter - The filter criteria to find documents.
-     * @param options - Pagination options including page, limit, and population.
-     * @returns A promise that resolves to a standardized response with paginated results.
-     */
-    findPaging(filter?: T_FilterQuery<T>, options?: I_PaginateOptionsWithPopulate): Promise<I_Return<T_PaginateResult<T>>>;
-    /**
-     * Performs aggregation with pagination support.
-     *
-     * @param pipeline - The aggregation pipeline stages.
-     * @param options - Pagination options for the aggregation result.
-     * @returns A promise that resolves to a standardized response with paginated aggregation results.
-     */
-    findPagingAggregate(pipeline: T_PipelineStage[], options?: I_PaginateOptionsWithPopulate): Promise<I_Return<T_AggregatePaginateResult<T>>>;
-    /**
-     * Counts documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to count documents.
-     * @returns A promise that resolves to a standardized response with the document count.
-     */
-    count(filter?: T_FilterQuery<T>): Promise<I_Return<number>>;
-    /**
-     * Creates a single document.
-     *
-     * @param doc - The document to create.
-     * @returns A promise that resolves to a standardized response with the created document.
-     */
-    createOne(doc: T | Partial<T>): Promise<I_Return<T>>;
-    /**
-     * Creates multiple documents with bulk insertion.
-     *
-     * @param docs - An array of documents to create.
-     * @param options - Options for the bulk insertion operation.
-     * @returns A promise that resolves to a standardized response with the created documents.
-     */
-    createMany(docs: (T | Partial<T>)[], options?: T_InsertManyOptions): Promise<I_Return<T[]>>;
-    /**
-     * Updates a single document and returns the updated version.
-     *
-     * @param filter - The filter criteria to find the document to update.
-     * @param update - The update data to apply.
-     * @param options - Options for the update operation.
-     * @returns A promise that resolves to a standardized response with the updated document.
-     */
-    updateOne(filter?: T_FilterQuery<T>, update?: T_UpdateQuery<T>, options?: I_UpdateOptionsExtended): Promise<I_Return<T>>;
-    /**
-     * Updates multiple documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find documents to update.
-     * @param update - The update data to apply.
-     * @param options - Options for the update operation.
-     * @returns A promise that resolves to a standardized response with the update result.
-     */
-    updateMany(filter?: T_FilterQuery<T>, update?: T_UpdateQuery<T>, options?: I_UpdateOptionsExtended): Promise<I_Return<T_UpdateResult>>;
-    /**
-     * Deletes a single document and returns the deleted version.
-     *
-     * @param filter - The filter criteria to find the document to delete.
-     * @param options - Options for the delete operation.
-     * @returns A promise that resolves to a standardized response with the deleted document.
-     */
-    deleteOne(filter?: T_FilterQuery<T>, options?: I_DeleteOptionsExtended): Promise<I_Return<T>>;
-    /**
-     * Deletes multiple documents matching the filter criteria.
-     *
-     * @param filter - The filter criteria to find documents to delete.
-     * @param options - Options for the delete operation.
-     * @returns A promise that resolves to a standardized response with the delete result.
-     */
-    deleteMany(filter?: T_FilterQuery<T>, options?: I_DeleteOptionsExtended): Promise<I_Return<T_DeleteResult>>;
-    /**
-     * Creates a unique short ID based on a given ID.
-     * This method generates multiple short IDs with increasing lengths and finds the first available one.
-     *
-     * @param id - The base ID to generate short IDs from.
-     * @param length - The initial length for short ID generation (default: 4).
-     * @returns A promise that resolves to a standardized response with the unique short ID.
-     */
-    createShortId(id: string, length?: number): Promise<I_Return<string>>;
-    /**
-     * Creates a query for slug existence checking.
-     * This method generates a query that checks for slug existence in both current and historical slug fields.
-     *
-     * @param options - Configuration for slug query generation including slug, field, and filter.
-     * @param options.slug - The slug string to check for existence.
-     * @param options.field - The field name for object-based slug checking.
-     * @param options.isObject - Whether the slug is stored as an object with nested fields.
-     * @param options.haveHistory - Whether to check historical slug fields for existence.
-     * @param options.filter - Additional filter conditions to apply to the query.
-     * @returns A MongoDB query object for checking slug existence.
-     */
-    createSlugQuery({ slug, field, isObject, haveHistory, filter }: I_Input_GenerateSlug<T>): {
-        $or: ({
-            [x: string]: string;
-            slugHistory?: undefined;
-        } | {
-            slugHistory: {
-                $elemMatch: {
-                    [x: string]: string;
-                };
-            };
-        })[];
-        _mongooseOptions?: any;
-        exec?: any;
-        $where?: string | (mongooseRaw.mongo.Condition<mongooseRaw.ApplyBasicQueryCasting<mongooseRaw.WithLevel1NestedPaths<T, keyof T>["$where"]>> & (string | ((this: mongooseRaw.WithLevel1NestedPaths<T, keyof T> extends infer T_1 ? { [P in keyof T_1]?: mongooseRaw.ApplyBasicQueryCasting<T_1[P]> | undefined; } : never) => boolean))) | ((argument: string | Function) => mongooseRaw.Query<any[], any, {}, unknown, "find", Record<string, never>>) | ((this: {
-            [x: string]: any;
-        }) => boolean) | undefined;
-        all?: any;
-        allowDiskUse?: any;
-        and?: any;
-        batchSize?: any;
-        box?: any;
-        cast?: any;
-        catch?: any;
-        finally?: any;
-        circle?: any;
-        clone?: any;
-        collation?: any;
-        comment?: any;
-        countDocuments?: any;
-        cursor?: any;
-        deleteMany?: any;
-        deleteOne?: any;
-        distinct?: any;
-        elemMatch?: any;
-        error?: any;
-        equals?: any;
-        estimatedDocumentCount?: any;
-        exists?: any;
-        explain?: any;
-        find?: any;
-        findOne?: any;
-        findOneAndDelete?: any;
-        findOneAndUpdate?: any;
-        findById?: any;
-        findByIdAndDelete?: any;
-        findByIdAndUpdate?: any;
-        geometry?: any;
-        get?: any;
-        getFilter?: any;
-        getOptions?: any;
-        getPopulatedPaths?: any;
-        getQuery?: any;
-        getUpdate?: any;
-        gt?: any;
-        gte?: any;
-        hint?: any;
-        in?: any;
-        intersects?: any;
-        j?: any;
-        lean?: any;
-        limit?: any;
-        lt?: any;
-        lte?: any;
-        transform?: any;
-        maxDistance?: any;
-        maxTimeMS?: any;
-        merge?: any;
-        mod?: any;
-        model?: any;
-        mongooseOptions?: any;
-        ne?: any;
-        near?: any;
-        nin?: any;
-        nor?: any;
-        or?: any;
-        orFail?: any;
-        polygon?: any;
-        populate?: any;
-        pre?: any;
-        post?: any;
-        projection?: any;
-        read?: any;
-        readConcern?: any;
-        regex?: any;
-        replaceOne?: any;
-        sanitizeProjection?: any;
-        schemaLevelProjections?: any;
-        select?: any;
-        selected?: any;
-        selectedExclusively?: any;
-        selectedInclusively?: any;
-        session?: any;
-        set?: any;
-        setOptions?: any;
-        setQuery?: any;
-        setUpdate?: any;
-        size?: any;
-        skip?: any;
-        slice?: any;
-        sort?: any;
-        tailable?: any;
-        then?: any;
-        toConstructor?: any;
-        updateMany?: any;
-        updateOne?: any;
-        w?: any;
-        where?: any;
-        within?: any;
-        wtimeout?: any;
-        paginate?: any;
-    } | {
-        $or: ({
-            slug: string;
-            slugHistory?: undefined;
-        } | {
-            slugHistory: string;
-            slug?: undefined;
-        })[];
-        _mongooseOptions?: any;
-        exec?: any;
-        $where?: string | (mongooseRaw.mongo.Condition<mongooseRaw.ApplyBasicQueryCasting<mongooseRaw.WithLevel1NestedPaths<T, keyof T>["$where"]>> & (string | ((this: mongooseRaw.WithLevel1NestedPaths<T, keyof T> extends infer T_1 ? { [P in keyof T_1]?: mongooseRaw.ApplyBasicQueryCasting<T_1[P]> | undefined; } : never) => boolean))) | ((argument: string | Function) => mongooseRaw.Query<any[], any, {}, unknown, "find", Record<string, never>>) | ((this: {
-            [x: string]: any;
-        }) => boolean) | undefined;
-        all?: any;
-        allowDiskUse?: any;
-        and?: any;
-        batchSize?: any;
-        box?: any;
-        cast?: any;
-        catch?: any;
-        finally?: any;
-        circle?: any;
-        clone?: any;
-        collation?: any;
-        comment?: any;
-        countDocuments?: any;
-        cursor?: any;
-        deleteMany?: any;
-        deleteOne?: any;
-        distinct?: any;
-        elemMatch?: any;
-        error?: any;
-        equals?: any;
-        estimatedDocumentCount?: any;
-        exists?: any;
-        explain?: any;
-        find?: any;
-        findOne?: any;
-        findOneAndDelete?: any;
-        findOneAndUpdate?: any;
-        findById?: any;
-        findByIdAndDelete?: any;
-        findByIdAndUpdate?: any;
-        geometry?: any;
-        get?: any;
-        getFilter?: any;
-        getOptions?: any;
-        getPopulatedPaths?: any;
-        getQuery?: any;
-        getUpdate?: any;
-        gt?: any;
-        gte?: any;
-        hint?: any;
-        in?: any;
-        intersects?: any;
-        j?: any;
-        lean?: any;
-        limit?: any;
-        lt?: any;
-        lte?: any;
-        transform?: any;
-        maxDistance?: any;
-        maxTimeMS?: any;
-        merge?: any;
-        mod?: any;
-        model?: any;
-        mongooseOptions?: any;
-        ne?: any;
-        near?: any;
-        nin?: any;
-        nor?: any;
-        or?: any;
-        orFail?: any;
-        polygon?: any;
-        populate?: any;
-        pre?: any;
-        post?: any;
-        projection?: any;
-        read?: any;
-        readConcern?: any;
-        regex?: any;
-        replaceOne?: any;
-        sanitizeProjection?: any;
-        schemaLevelProjections?: any;
-        select?: any;
-        selected?: any;
-        selectedExclusively?: any;
-        selectedInclusively?: any;
-        session?: any;
-        set?: any;
-        setOptions?: any;
-        setQuery?: any;
-        setUpdate?: any;
-        size?: any;
-        skip?: any;
-        slice?: any;
-        sort?: any;
-        tailable?: any;
-        then?: any;
-        toConstructor?: any;
-        updateMany?: any;
-        updateOne?: any;
-        w?: any;
-        where?: any;
-        within?: any;
-        wtimeout?: any;
-        paginate?: any;
-    };
-    /**
-     * Creates a unique slug based on a given string.
-     * This method generates multiple slug variations and finds the first available one.
-     *
-     * @param options - Configuration for slug generation including slug, field, and filter.
-     * @param options.slug - The base slug string to make unique.
-     * @param options.field - The field name for object-based slug checking.
-     * @param options.isObject - Whether the slug is stored as an object with nested fields.
-     * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
-     * @param options.filter - Additional filter conditions to apply when checking slug existence.
-     * @returns A promise that resolves to a unique slug string.
-     */
-    createUniqueSlug({ slug, field, isObject, haveHistory, filter }: I_Input_GenerateSlug<T>): Promise<string>;
-    /**
-     * Creates a slug for a document field.
-     * This method handles both simple string fields and object fields with nested slug generation.
-     *
-     * @param options - Configuration for slug creation including field, source document, and filter.
-     * @param options.field - The field name to create a slug for.
-     * @param options.from - The source document containing the field value.
-     * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
-     * @param options.filter - Additional filter conditions to apply when checking slug existence.
-     * @returns A promise that resolves to a standardized response with the created slug(s).
-     */
-    createSlug<R = string>({ field, from, filter, haveHistory }: I_Input_CreateSlug<T>): Promise<I_Return<R>>;
-    /**
-     * Checks if a slug already exists in the collection.
-     * This method verifies slug existence in both current and historical slug fields.
-     *
-     * @param options - Configuration for slug checking including slug, field, source document, and filter.
-     * @param options.slug - The slug string to check for existence.
-     * @param options.field - The field name for object-based slug checking.
-     * @param options.from - The source document containing the field value.
-     * @param options.haveHistory - Whether to check historical slug fields for existence.
-     * @param options.filter - Additional filter conditions to apply to the query.
-     * @returns A promise that resolves to a standardized response indicating whether the slug exists.
-     */
-    checkSlug({ slug, field, from, filter, haveHistory }: I_Input_CheckSlug<T>): Promise<I_Return<boolean>>;
-    /**
-     * Performs aggregation operations on the collection.
-     *
-     * @param pipeline - The aggregation pipeline stages to execute.
-     * @returns A promise that resolves to a standardized response with the aggregation results.
-     */
-    aggregate(pipeline: T_PipelineStage[]): Promise<I_Return<T[]>>;
-    /**
-     * Retrieves distinct values for the specified key from the collection.
-     *
-     * @param key - The field for which to return distinct values.
-     * @param filter - The filter query to apply (optional).
-     * @param options - Additional options for the distinct operation (optional).
-     * @returns A promise that resolves to a standardized response with the array of distinct values.
-     */
-    distinct(key: string, filter?: T_FilterQuery<T>, options?: T_QueryOptions<T>): Promise<I_Return<unknown[]>>;
-}
+export declare function applyNestedPopulate<T extends object>(mongoose: typeof mongooseRaw, documents: T[], populateOptions: T_Input_Populate, virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[], currentModel?: any): Promise<T[]>;