@cyberskill/shared 3.0.0 → 3.2.0

package/dist/node/mongo/mongo.controller.native.js

@@ -0,0 +1,214 @@
+import { mongo as n } from "./mongo.util.js";
+import { RESPONSE_STATUS as r } from "../../constant/response-status.js";
+import { catchError as c } from "../log/log.util.js";
+class d {
+  collection;
+  /**
+   * Creates a new MongoDB controller instance.
+   *
+   * @param db - The MongoDB database instance.
+   * @param collectionName - The name of the collection to operate on.
+   */
+  constructor(t, e) {
+    this.collection = t.collection(e);
+  }
+  /**
+   * 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.
+   */
+  async createOne(t) {
+    try {
+      const e = {
+        ...n.createGenericFields(),
+        ...t
+      };
+      return (await this.collection.insertOne(e)).acknowledged ? {
+        success: !0,
+        message: "Document created successfully",
+        result: e
+      } : {
+        success: !1,
+        message: "Document creation failed",
+        code: r.INTERNAL_SERVER_ERROR.CODE
+      };
+    } catch (e) {
+      return c(e);
+    }
+  }
+  /**
+   * 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.
+   */
+  async createMany(t) {
+    try {
+      const e = t.map((u) => ({
+        ...n.createGenericFields(),
+        ...u
+      })), s = await this.collection.insertMany(e);
+      return s.insertedCount === 0 ? {
+        success: !1,
+        message: "No documents were inserted",
+        code: r.INTERNAL_SERVER_ERROR.CODE
+      } : {
+        success: !0,
+        message: `${s.insertedCount} documents created successfully`,
+        result: e
+      };
+    } catch (e) {
+      return c(e);
+    }
+  }
+  /**
+   * 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.
+   */
+  async findOne(t) {
+    try {
+      const e = await this.collection.findOne(t, { maxTimeMS: 3e4 });
+      return e ? { success: !0, message: "Document found", result: e } : { success: !1, message: "Document not found", code: r.NOT_FOUND.CODE };
+    } catch (e) {
+      return c(e);
+    }
+  }
+  /**
+   * 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.
+   */
+  async findAll(t = {}) {
+    try {
+      return {
+        success: !0,
+        message: "Documents retrieved successfully",
+        result: await this.collection.find(t).limit(1e4).maxTimeMS(3e4).toArray()
+      };
+    } catch (e) {
+      return c(e);
+    }
+  }
+  /**
+   * 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.
+   */
+  async count(t = {}) {
+    try {
+      const e = await this.collection.countDocuments(t);
+      return {
+        success: !0,
+        message: `${e} documents counted successfully`,
+        result: e
+      };
+    } catch (e) {
+      return c(e);
+    }
+  }
+  /**
+   * 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.
+   */
+  async updateOne(t, e) {
+    try {
+      const s = await this.collection.updateOne(t, {
+        $set: e
+      });
+      return s.matchedCount === 0 ? {
+        success: !1,
+        message: "No documents matched the filter",
+        code: r.INTERNAL_SERVER_ERROR.CODE
+      } : {
+        success: !0,
+        message: "Document updated successfully",
+        result: s
+      };
+    } catch (s) {
+      return c(s);
+    }
+  }
+  /**
+   * 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.
+   */
+  async updateMany(t, e) {
+    try {
+      const s = await this.collection.updateMany(t, {
+        $set: e
+      });
+      return s.matchedCount === 0 ? {
+        success: !1,
+        message: "No documents matched the filter",
+        code: r.INTERNAL_SERVER_ERROR.CODE
+      } : {
+        success: !0,
+        message: "Documents updated successfully",
+        result: s
+      };
+    } catch (s) {
+      return c(s);
+    }
+  }
+  /**
+   * 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.
+   */
+  async deleteOne(t) {
+    try {
+      const e = await this.collection.deleteOne(t);
+      return e.deletedCount === 0 ? {
+        success: !1,
+        message: "No documents matched the filter",
+        code: r.INTERNAL_SERVER_ERROR.CODE
+      } : {
+        success: !0,
+        message: "Document deleted successfully",
+        result: e
+      };
+    } catch (e) {
+      return c(e);
+    }
+  }
+  /**
+   * 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.
+   */
+  async deleteMany(t) {
+    try {
+      const e = await this.collection.deleteMany(t);
+      return e.deletedCount === 0 ? {
+        success: !1,
+        message: "No documents matched the filter",
+        code: r.INTERNAL_SERVER_ERROR.CODE
+      } : {
+        success: !0,
+        message: "Documents deleted successfully",
+        result: e
+      };
+    } catch (e) {
+      return c(e);
+    }
+  }
+}
+export {
+  d as MongoController
+};
+//# sourceMappingURL=mongo.controller.native.js.map

package/dist/node/mongo/mongo.controller.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.controller.native.js","sources":["../../../src/node/mongo/mongo.controller.native.ts"],"sourcesContent":["import type { I_Return } from '#typescript/index.js';\n\nimport { RESPONSE_STATUS } from '#constant/index.js';\n\nimport type { C_Collection, C_Db, C_Document, T_DeleteResult, T_Filter, T_OptionalUnlessRequiredId, T_UpdateResult, T_WithId } from './mongo.type.js';\n\nimport { catchError } from '../log/index.js';\nimport { mongo } from './mongo.util.js';\n\n/**\n * MongoDB native driver controller for direct database operations.\n * This class provides a simplified interface for MongoDB operations using the native driver,\n * with automatic generic field generation and standardized response formatting.\n */\nexport class MongoController<D extends Partial<C_Document>> {\n    private collection: C_Collection<D>;\n\n    /**\n     * Creates a new MongoDB controller instance.\n     *\n     * @param db - The MongoDB database instance.\n     * @param collectionName - The name of the collection to operate on.\n     */\n    constructor(db: C_Db, collectionName: string) {\n        this.collection = db.collection<D>(collectionName);\n    }\n\n    /**\n     * Creates a single document in the collection.\n     * This method adds generic fields (id, isDel, timestamps) to the document before insertion.\n     *\n     * @param document - The document to create, with or without generic fields.\n     * @returns A promise that resolves to a standardized response with the created document.\n     */\n    async createOne(document: D | Partial<D>): Promise<I_Return<D | Partial<D>>> {\n        try {\n            const finalDocument = {\n                ...mongo.createGenericFields(),\n                ...document,\n            };\n\n            const result = await this.collection.insertOne(finalDocument as unknown as T_OptionalUnlessRequiredId<D>);\n\n            if (!result.acknowledged) {\n                return {\n                    success: false,\n                    message: 'Document creation failed',\n                    code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n                };\n            }\n\n            return {\n                success: true,\n                message: 'Document created successfully',\n                result: finalDocument,\n            };\n        }\n        catch (error) {\n            return catchError<(D | Partial<D>)>(error);\n        }\n    }\n\n    /**\n     * Creates multiple documents in the collection.\n     * This method adds generic fields to each document before bulk insertion.\n     *\n     * @param documents - An array of documents to create.\n     * @returns A promise that resolves to a standardized response with the created documents.\n     */\n    async createMany(documents: (D | Partial<D>)[]): Promise<I_Return<(D | Partial<D>)[]>> {\n        try {\n            const finalDocuments = documents.map(document => ({\n                ...mongo.createGenericFields(),\n                ...document,\n            }));\n\n            const result = await this.collection.insertMany(finalDocuments as unknown as T_OptionalUnlessRequiredId<D>[]);\n\n            if (result.insertedCount === 0) {\n                return {\n                    success: false,\n                    message: 'No documents were inserted',\n                    code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n                };\n            }\n\n            return {\n                success: true,\n                message: `${result.insertedCount} documents created successfully`,\n                result: finalDocuments,\n            };\n        }\n        catch (error) {\n            return catchError<(D | Partial<D>)[]>(error);\n        }\n    }\n\n    /**\n     * Finds a single document by filter criteria.\n     *\n     * @param filter - The filter criteria to find the document.\n     * @returns A promise that resolves to a standardized response with the found document.\n     */\n    async findOne(filter: T_Filter<D>): Promise<I_Return<T_WithId<D>>> {\n        try {\n            const result = await this.collection.findOne(filter, { maxTimeMS: 30_000 });\n\n            if (!result) {\n                return { success: false, message: 'Document not found', code: RESPONSE_STATUS.NOT_FOUND.CODE };\n            }\n\n            return { success: true, message: 'Document found', result };\n        }\n        catch (error) {\n            return catchError<T_WithId<D>>(error);\n        }\n    }\n\n    /**\n     * Finds all documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find documents (defaults to empty object for all documents).\n     * @returns A promise that resolves to a standardized response with the found documents.\n     */\n    async findAll(\n        filter: T_Filter<D> = {},\n    ): Promise<I_Return<T_WithId<D>[]>> {\n        try {\n            const result = await this.collection.find(filter).limit(10_000).maxTimeMS(30_000).toArray();\n\n            return {\n                success: true,\n                message: 'Documents retrieved successfully',\n                result,\n            };\n        }\n        catch (error) {\n            return catchError<T_WithId<D>[]>(error);\n        }\n    }\n\n    /**\n     * Counts documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to count documents (defaults to empty object for all documents).\n     * @returns A promise that resolves to a standardized response with the document count.\n     */\n    async count(\n        filter: T_Filter<D> = {},\n    ): Promise<I_Return<number>> {\n        try {\n            const result = await this.collection.countDocuments(filter);\n\n            return {\n                success: true,\n                message: `${result} documents counted successfully`,\n                result,\n            };\n        }\n        catch (error) {\n            return catchError<number>(error);\n        }\n    }\n\n    /**\n     * Updates a single document matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find the document to update.\n     * @param update - The update data to apply to the document.\n     * @returns A promise that resolves to a standardized response with the update result.\n     */\n    async updateOne(\n        filter: T_Filter<D>,\n        update: Partial<D>,\n    ): Promise<I_Return<T_UpdateResult>> {\n        try {\n            const result = await this.collection.updateOne(filter, {\n                $set: update,\n            });\n\n            if (result.matchedCount === 0) {\n                return {\n                    success: false,\n                    message: 'No documents matched the filter',\n                    code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n                };\n            }\n            return {\n                success: true,\n                message: 'Document updated successfully',\n                result,\n            };\n        }\n        catch (error) {\n            return catchError<T_UpdateResult>(error);\n        }\n    }\n\n    /**\n     * Updates multiple documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find documents to update.\n     * @param update - The update data to apply to the documents.\n     * @returns A promise that resolves to a standardized response with the update result.\n     */\n    async updateMany(\n        filter: T_Filter<D>,\n        update: Partial<D>,\n    ): Promise<I_Return<T_UpdateResult>> {\n        try {\n            const result = await this.collection.updateMany(filter, {\n                $set: update,\n            });\n\n            if (result.matchedCount === 0) {\n                return {\n                    success: false,\n                    message: 'No documents matched the filter',\n                    code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n                };\n            }\n\n            return {\n                success: true,\n                message: 'Documents updated successfully',\n                result,\n            };\n        }\n        catch (error) {\n            return catchError<T_UpdateResult>(error);\n        }\n    }\n\n    /**\n     * Deletes a single document matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find the document to delete.\n     * @returns A promise that resolves to a standardized response with the delete result.\n     */\n    async deleteOne(\n        filter: T_Filter<D>,\n    ): Promise<I_Return<T_DeleteResult>> {\n        try {\n            const result = await this.collection.deleteOne(filter);\n\n            if (result.deletedCount === 0) {\n                return {\n                    success: false,\n                    message: 'No documents matched the filter',\n                    code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n                };\n            }\n            return {\n                success: true,\n                message: 'Document deleted successfully',\n                result,\n            };\n        }\n        catch (error) {\n            return catchError<T_DeleteResult>(error);\n        }\n    }\n\n    /**\n     * Deletes multiple documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find documents to delete.\n     * @returns A promise that resolves to a standardized response with the delete result.\n     */\n    async deleteMany(\n        filter: T_Filter<D>,\n    ): Promise<I_Return<T_DeleteResult>> {\n        try {\n            const result = await this.collection.deleteMany(filter);\n\n            if (result.deletedCount === 0) {\n                return {\n                    success: false,\n                    message: 'No documents matched the filter',\n                    code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n                };\n            }\n\n            return {\n                success: true,\n                message: 'Documents deleted successfully',\n                result,\n            };\n        }\n        catch (error) {\n            return catchError<T_DeleteResult>(error);\n        }\n    }\n}\n"],"names":["mongo","RESPONSE_STATUS","catchError","MongoController","db","collectionName","document","finalDocument","error","documents","finalDocuments","result","filter","update"],"mappings":"AAcO,SAAA,SAAAA,SAAA;AAAA,SAAA,mBAAAC,SAAA;AAAA,SAAA,cAAAC,SAAA;AAAA,MAAMC,EAA+C;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQR,YAAYC,GAAUC,GAAwB;AAC1C,SAAK,aAAaD,EAAG,WAAcC,CAAc;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,UAAUC,GAA6D;AACzE,QAAI;AACA,YAAMC,IAAgB;AAAA,QAClB,GAAGP,EAAM,oBAAA;AAAA,QACT,GAAGM;AAAA,MAAA;AAKP,cAFe,MAAM,KAAK,WAAW,UAAUC,CAAyD,GAE5F,eAQL;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAQA;AAAA,MAAA,IAVD;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAMN,EAAgB,sBAAsB;AAAA,MAAA;AAAA,IASxD,SACOO,GAAO;AACV,aAAON,EAA6BM,CAAK;AAAA,IAC7C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAWC,GAAsE;AACnF,QAAI;AACA,YAAMC,IAAiBD,EAAU,IAAI,CAAAH,OAAa;AAAA,QAC9C,GAAGN,EAAM,oBAAA;AAAA,QACT,GAAGM;AAAA,MAAA,EACL,GAEIK,IAAS,MAAM,KAAK,WAAW,WAAWD,CAA4D;AAE5G,aAAIC,EAAO,kBAAkB,IAClB;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAMV,EAAgB,sBAAsB;AAAA,MAAA,IAI7C;AAAA,QACH,SAAS;AAAA,QACT,SAAS,GAAGU,EAAO,aAAa;AAAA,QAChC,QAAQD;AAAA,MAAA;AAAA,IAEhB,SACOF,GAAO;AACV,aAAON,EAA+BM,CAAK;AAAA,IAC/C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,QAAQI,GAAqD;AAC/D,QAAI;AACA,YAAMD,IAAS,MAAM,KAAK,WAAW,QAAQC,GAAQ,EAAE,WAAW,KAAQ;AAE1E,aAAKD,IAIE,EAAE,SAAS,IAAM,SAAS,kBAAkB,QAAAA,EAAA,IAHxC,EAAE,SAAS,IAAO,SAAS,sBAAsB,MAAMV,EAAgB,UAAU,KAAA;AAAA,IAIhG,SACOO,GAAO;AACV,aAAON,EAAwBM,CAAK;AAAA,IACxC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,QACFI,IAAsB,IACU;AAChC,QAAI;AAGA,aAAO;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QALW,MAAM,KAAK,WAAW,KAAKA,CAAM,EAAE,MAAM,GAAM,EAAE,UAAU,GAAM,EAAE,QAAA;AAAA,MAK9E;AAAA,IAER,SACOJ,GAAO;AACV,aAAON,EAA0BM,CAAK;AAAA,IAC1C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,MACFI,IAAsB,IACG;AACzB,QAAI;AACA,YAAMD,IAAS,MAAM,KAAK,WAAW,eAAeC,CAAM;AAE1D,aAAO;AAAA,QACH,SAAS;AAAA,QACT,SAAS,GAAGD,CAAM;AAAA,QAClB,QAAAA;AAAA,MAAA;AAAA,IAER,SACOH,GAAO;AACV,aAAON,EAAmBM,CAAK;AAAA,IACnC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,UACFI,GACAC,GACiC;AACjC,QAAI;AACA,YAAMF,IAAS,MAAM,KAAK,WAAW,UAAUC,GAAQ;AAAA,QACnD,MAAMC;AAAA,MAAA,CACT;AAED,aAAIF,EAAO,iBAAiB,IACjB;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAMV,EAAgB,sBAAsB;AAAA,MAAA,IAG7C;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAAU;AAAA,MAAA;AAAA,IAER,SACOH,GAAO;AACV,aAAON,EAA2BM,CAAK;AAAA,IAC3C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WACFI,GACAC,GACiC;AACjC,QAAI;AACA,YAAMF,IAAS,MAAM,KAAK,WAAW,WAAWC,GAAQ;AAAA,QACpD,MAAMC;AAAA,MAAA,CACT;AAED,aAAIF,EAAO,iBAAiB,IACjB;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAMV,EAAgB,sBAAsB;AAAA,MAAA,IAI7C;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAAU;AAAA,MAAA;AAAA,IAER,SACOH,GAAO;AACV,aAAON,EAA2BM,CAAK;AAAA,IAC3C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,UACFI,GACiC;AACjC,QAAI;AACA,YAAMD,IAAS,MAAM,KAAK,WAAW,UAAUC,CAAM;AAErD,aAAID,EAAO,iBAAiB,IACjB;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAMV,EAAgB,sBAAsB;AAAA,MAAA,IAG7C;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAAU;AAAA,MAAA;AAAA,IAER,SACOH,GAAO;AACV,aAAON,EAA2BM,CAAK;AAAA,IAC3C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WACFI,GACiC;AACjC,QAAI;AACA,YAAMD,IAAS,MAAM,KAAK,WAAW,WAAWC,CAAM;AAEtD,aAAID,EAAO,iBAAiB,IACjB;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,MAAMV,EAAgB,sBAAsB;AAAA,MAAA,IAI7C;AAAA,QACH,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAAU;AAAA,MAAA;AAAA,IAER,SACOH,GAAO;AACV,aAAON,EAA2BM,CAAK;AAAA,IAC3C;AAAA,EACJ;AACJ;"}

package/dist/node/mongo/mongo.dynamic-populate.d.ts

@@ -0,0 +1,61 @@
+import { default as mongooseRaw } from 'mongoose';
+import { I_DynamicVirtualConfig, I_DynamicVirtualOptions, T_Input_Populate } from './mongo.type.js';
+/**
+ * Checks if value is object-like (e.g., objects, arrays, etc.), not null.
+ */
+export declare function isObject(value: unknown): value is object;
+/**
+ * Filters out dynamic virtuals from populate options to prevent Mongoose from trying to populate them.
+ * This function creates a new populate configuration that only includes regular virtuals.
+ *
+ * @template T - The document type
+ * @param populate - The original populate options
+ * @param dynamicVirtuals - Array of dynamic virtual configurations
+ * @returns Filtered populate options excluding dynamic virtuals
+ */
+export declare function filterDynamicVirtualsFromPopulate<T>(populate: T_Input_Populate | undefined, dynamicVirtuals: I_DynamicVirtualConfig<T>[] | undefined): T_Input_Populate | undefined;
+/**
+ * Groups documents by the resolved model name for a dynamic virtual field.
+ * Used to batch population queries for dynamic virtuals.
+ *
+ * @template T - The document type
+ * @template R - The model name type (usually string or enum)
+ * @param {T[]} documents - The array of documents to process
+ * @param {string} virtualName - The name of the dynamic virtual field
+ * @param {I_DynamicVirtualOptions<T, R>} virtualOptions - The dynamic virtual options (must include a ref function)
+ * @returns {Array<{ model: string; docs: T[] }>} An array of groups, each with a model name and the docs for that model
+ */
+export declare function remapDynamicPopulate<T, R extends string = string>(documents: T[], virtualName: string, virtualOptions: I_DynamicVirtualOptions<T, R>): Array<{
+    model: string;
+    docs: T[];
+}>;
+/**
+ * Type guard to check if an object is a Mongoose Document (has toObject method).
+ * @param obj - The object to check
+ * @returns True if obj has a toObject function
+ */
+export declare function isMongooseDoc(obj: unknown): obj is {
+    toObject: () => {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Optimized batch population for dynamic virtuals.
+ *
+ * - Groups documents by model and batches queries for each model.
+ * - Populates all dynamic virtuals in parallel for maximum performance.
+ * - Uses direct assignment for plain objects and skips already populated fields.
+ * - Supports optional projection for population queries.
+ * - Only populates virtuals that are explicitly requested in populate options.
+ * - Reminder: Ensure indexes exist on foreignField in referenced collections for best performance.
+ *
+ * @template T - The document type (must be an object)
+ * @template R - The model name type (usually string or enum)
+ * @param {typeof mongooseRaw} mongoose - The Mongoose instance
+ * @param {T[]} documents - The array of documents to populate
+ * @param {I_DynamicVirtualConfig<T, R>[]} virtualConfigs - The dynamic virtual configurations to process
+ * @param {T_Input_Populate} [populate] - Population options to determine which virtuals to populate
+ * @param {Record<string, 0 | 1>} [projection] - Optional projection for population queries
+ * @returns {Promise<object[]>} The array of documents with dynamic virtuals populated
+ */
+export declare function populateDynamicVirtuals<T extends object, R extends string = string>(mongoose: typeof mongooseRaw, documents: T[], virtualConfigs: I_DynamicVirtualConfig<T, R>[], populate?: T_Input_Populate, projection?: Record<string, 0 | 1>, startModel?: any): Promise<T[]>;

package/dist/node/mongo/mongo.dynamic-populate.js

@@ -0,0 +1,197 @@
+import { applyNestedPopulate as A } from "./mongo.populate.js";
+import { convertEnumToModelName as O } from "./mongo.util.js";
+import { deepClone as P } from "../../util/object/object.util.js";
+import { catchError as D } from "../log/log.util.js";
+function T(e) {
+  return e != null && typeof e == "object";
+}
+function _(e, p) {
+  if (!e || !p || p.length === 0)
+    return e;
+  const S = new Set(p.map((t) => t.name));
+  if (Array.isArray(e)) {
+    const t = e.filter((u) => {
+      if (typeof u == "string")
+        return ![...S].some(
+          (s) => u === s || u.startsWith(`${s}.`)
+        );
+      if (typeof u == "object" && u !== null) {
+        const s = u, V = s.path || s.populate || "";
+        return ![...S].some(
+          (h) => V === h || V.startsWith(`${h}.`)
+        );
+      }
+      return !0;
+    });
+    return t.length > 0 ? t : void 0;
+  }
+  if (typeof e == "string")
+    return [...S].some(
+      (t) => e === t || e.startsWith(`${t}.`)
+    ) ? void 0 : e;
+  if (typeof e == "object" && e !== null) {
+    const t = e, u = t.path || t.populate || "";
+    return [...S].some(
+      (s) => u === s || u.startsWith(`${s}.`)
+    ) ? void 0 : e;
+  }
+  return e;
+}
+function F(e, p, S) {
+  if (!e.length || !p || !S?.ref)
+    return [];
+  const t = /* @__PURE__ */ new Map();
+  return e.forEach((u) => {
+    try {
+      const s = S.ref(u);
+      if (s == null)
+        return;
+      const V = typeof s == "string" ? s : String(s);
+      if (V && V.trim() !== "") {
+        const h = O(V);
+        t.has(h) || t.set(h, []), t.get(h).push(u);
+      }
+    } catch (s) {
+      D(new Error(`Dynamic ref function failed for virtual "${p}": ${s instanceof Error ? s.message : String(s)}`));
+    }
+  }), Array.from(t.entries(), ([u, s]) => ({ model: u, docs: s }));
+}
+function L(e) {
+  return e !== null && typeof e == "object" && "toObject" in e && typeof e.toObject == "function";
+}
+async function k(e, p, S, t, u, s) {
+  if (!p.length || !S.length || !t)
+    return p;
+  const V = S.filter((a) => {
+    if (Array.isArray(t))
+      return t.length > 0 && t.some((n) => {
+        if (typeof n == "string")
+          return n === a.name || n.startsWith(`${a.name}.`);
+        if (n && typeof n == "object") {
+          const c = n, j = c.path || c.populate || "";
+          return j === a.name || j.startsWith(`${a.name}.`);
+        }
+        return !1;
+      });
+    if (typeof t == "string")
+      return t === a.name || t.startsWith(`${a.name}.`);
+    if (typeof t == "object" && t !== null) {
+      const n = t, c = n.path || n.populate || "";
+      return c === a.name || c.startsWith(`${a.name}.`);
+    }
+    return !1;
+  });
+  if (V.length === 0)
+    return p;
+  const h = P(p.map((a) => L(a) ? a.toObject() : a));
+  h.forEach((a) => {
+    V.forEach(({ name: n, options: c }) => {
+      n in a || (a[n] = c.count ? 0 : c.justOne ? null : []);
+    });
+  });
+  const b = /* @__PURE__ */ new Map();
+  for (const a of V) {
+    const { name: n, options: c } = a, j = F(h, n, c);
+    for (const l of j) {
+      b.has(l.model) || b.set(l.model, {
+        virtuals: [],
+        localValueSets: /* @__PURE__ */ new Map(),
+        docsByLocalValue: /* @__PURE__ */ new Map()
+      });
+      const y = b.get(l.model);
+      y.virtuals.some((f) => f.name === n) || (y.virtuals.push(a), y.localValueSets.set(n, /* @__PURE__ */ new Set()));
+      const w = y.localValueSets.get(n);
+      l.docs.forEach((f) => {
+        const i = f[c.localField];
+        if (i != null) {
+          const o = String(i);
+          w.add(o);
+          let r = -1;
+          const E = f;
+          E.id !== void 0 ? r = h.findIndex((m) => m.id === E.id) : E._id !== void 0 && (r = h.findIndex((m) => m._id?.toString?.() === E._id?.toString?.())), r !== -1 && (y.docsByLocalValue.has(o) || y.docsByLocalValue.set(o, []), y.docsByLocalValue.get(o).push(r));
+        }
+      });
+    }
+  }
+  if (await Promise.all(Array.from(b.entries(), async ([a, n]) => {
+    const c = e.models[a];
+    if (!c)
+      return;
+    const j = /* @__PURE__ */ new Set();
+    if (n.localValueSets.forEach((i) => {
+      i.forEach((o) => j.add(o));
+    }), j.size === 0)
+      return;
+    const l = [...new Set(n.virtuals.map((i) => i.options.foreignField))], y = [...j];
+    let w;
+    l.length === 1 ? w = { [String(l[0])]: { $in: y } } : w = { $or: l.map((i) => ({ [i]: { $in: y } })) };
+    const f = await c.find(w, u).lean();
+    for (const i of n.virtuals) {
+      const { name: o, options: r } = i, E = f.filter((m) => {
+        const d = m[r.foreignField];
+        return d != null && j.has(String(d));
+      });
+      if (r.count) {
+        const m = /* @__PURE__ */ new Map();
+        E.forEach((d) => {
+          const g = d[r.foreignField]?.toString();
+          g && m.set(g, (m.get(g) || 0) + 1);
+        }), n.localValueSets.get(o).forEach((d) => {
+          const g = n.docsByLocalValue.get(d) || [], M = m.get(d) || 0;
+          g.forEach(($) => {
+            const W = h[$];
+            W[o] === void 0 && (W[o] = M);
+          });
+        });
+      } else {
+        const m = /* @__PURE__ */ new Map();
+        E.forEach((d) => {
+          const g = d[r.foreignField]?.toString();
+          g && (m.has(g) || m.set(g, []), m.get(g).push(d));
+        }), n.localValueSets.get(o).forEach((d) => {
+          const g = n.docsByLocalValue.get(d) || [], M = m.get(d) || [], $ = r.justOne ? M[0] || null : M;
+          g.forEach((W) => {
+            const v = h[W];
+            v[o] = $;
+          });
+        });
+      }
+    }
+  })), t) {
+    const n = ((c) => {
+      const j = Array.isArray(c) ? c : [c], l = /* @__PURE__ */ new Map(), y = [];
+      for (const f of j)
+        if (typeof f == "string")
+          if (f.includes(".")) {
+            const i = f.split("."), o = i[0] || "", r = i.slice(1).join(".");
+            o && (l.has(o) || l.set(o, []), r && l.get(o).push(r));
+          } else
+            y.push(f);
+        else if (f && typeof f == "object") {
+          const i = f;
+          if (i.path && i.path.includes(".")) {
+            const o = i.path.split("."), r = o[0] || "", E = o.slice(1).join(".");
+            r && (l.has(r) || l.set(r, []), E && l.get(r).push(E), i.populate && l.get(r).push(i.populate));
+          } else
+            y.push(f);
+        }
+      const w = [...y];
+      return l.forEach((f, i) => {
+        const o = [];
+        for (const r of f)
+          (typeof r == "string" || r && typeof r == "object") && o.push(r);
+        o.length > 0 ? w.push({ path: i, populate: o }) : w.push(i);
+      }), w;
+    })(t);
+    await A(e, h, n, S, s);
+  }
+  return h;
+}
+export {
+  _ as filterDynamicVirtualsFromPopulate,
+  L as isMongooseDoc,
+  T as isObject,
+  k as populateDynamicVirtuals,
+  F as remapDynamicPopulate
+};
+//# sourceMappingURL=mongo.dynamic-populate.js.map

package/dist/node/mongo/mongo.dynamic-populate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.dynamic-populate.js","sources":["../../../src/node/mongo/mongo.dynamic-populate.ts"],"sourcesContent":["import type mongooseRaw from 'mongoose';\n\nimport { deepClone } from '#util/index.js';\n\nimport type { I_DynamicVirtualConfig, I_DynamicVirtualOptions, T_Input_Populate } from './mongo.type.js';\n\nimport { catchError } from '../log/index.js';\nimport { applyNestedPopulate } from './mongo.populate.js';\nimport { convertEnumToModelName } from './mongo.util.js';\n\n/**\n * Checks if value is object-like (e.g., objects, arrays, etc.), not null.\n */\nexport function isObject(value: unknown): value is object {\n    return value != null && typeof value === 'object';\n}\n\n/**\n * Filters out dynamic virtuals from populate options to prevent Mongoose from trying to populate them.\n * This function creates a new populate configuration that only includes regular virtuals.\n *\n * @template T - The document type\n * @param populate - The original populate options\n * @param dynamicVirtuals - Array of dynamic virtual configurations\n * @returns Filtered populate options excluding dynamic virtuals\n */\nexport function filterDynamicVirtualsFromPopulate<T>(\n    populate: T_Input_Populate | undefined,\n    dynamicVirtuals: I_DynamicVirtualConfig<T>[] | undefined,\n): T_Input_Populate | undefined {\n    if (!populate || !dynamicVirtuals || dynamicVirtuals.length === 0) {\n        return populate;\n    }\n\n    const dynamicVirtualNames = new Set(dynamicVirtuals.map(v => v.name));\n\n    if (Array.isArray(populate)) {\n        const filtered = populate.filter((p) => {\n            if (typeof p === 'string') {\n                return ![...dynamicVirtualNames].some(virtualName =>\n                    p === virtualName || p.startsWith(`${virtualName}.`),\n                );\n            }\n\n            if (typeof p === 'object' && p !== null) {\n                const popObj = p as { path?: string; populate?: string };\n                const path = popObj.path || popObj.populate || '';\n\n                return ![...dynamicVirtualNames].some(virtualName =>\n                    path === virtualName || path.startsWith(`${virtualName}.`),\n                );\n            }\n\n            return true;\n        });\n\n        return filtered.length > 0 ? (filtered as T_Input_Populate) : undefined;\n    }\n\n    if (typeof populate === 'string') {\n        return [...dynamicVirtualNames].some(virtualName =>\n            populate === virtualName || populate.startsWith(`${virtualName}.`),\n        )\n            ? undefined\n            : populate;\n    }\n\n    if (typeof populate === 'object' && populate !== null) {\n        const popObj = populate as { path?: string; populate?: string };\n        const path = popObj.path || popObj.populate || '';\n\n        return [...dynamicVirtualNames].some(virtualName =>\n            path === virtualName || path.startsWith(`${virtualName}.`),\n        )\n            ? undefined\n            : populate;\n    }\n\n    return populate;\n}\n\n/**\n * Groups documents by the resolved model name for a dynamic virtual field.\n * Used to batch population queries for dynamic virtuals.\n *\n * @template T - The document type\n * @template R - The model name type (usually string or enum)\n * @param {T[]} documents - The array of documents to process\n * @param {string} virtualName - The name of the dynamic virtual field\n * @param {I_DynamicVirtualOptions<T, R>} virtualOptions - The dynamic virtual options (must include a ref function)\n * @returns {Array<{ model: string; docs: T[] }>} An array of groups, each with a model name and the docs for that model\n */\nexport function remapDynamicPopulate<T, R extends string = string>(\n    documents: T[],\n    virtualName: string,\n    virtualOptions: I_DynamicVirtualOptions<T, R>,\n): Array<{ model: string; docs: T[] }> {\n    if (!documents.length || !virtualName || !virtualOptions?.ref) {\n        return [];\n    }\n\n    const modelGroups = new Map<string, T[]>();\n    documents.forEach((doc) => {\n        try {\n            const modelName = virtualOptions.ref(doc);\n\n            if (modelName === undefined || modelName === null) {\n                return;\n            }\n\n            const modelNameString = typeof modelName === 'string' ? modelName : String(modelName);\n\n            if (modelNameString && modelNameString.trim() !== '') {\n                const convertedModelName = convertEnumToModelName(modelNameString);\n\n                if (!modelGroups.has(convertedModelName)) {\n                    modelGroups.set(convertedModelName, []);\n                }\n\n                modelGroups.get(convertedModelName)!.push(doc);\n            }\n        }\n        catch (error) {\n            catchError(new Error(`Dynamic ref function failed for virtual \"${virtualName}\": ${error instanceof Error ? error.message : String(error)}`));\n        }\n    });\n\n    return Array.from(modelGroups.entries(), ([model, docs]) => ({ model, docs }));\n}\n\n/**\n * Type guard to check if an object is a Mongoose Document (has toObject method).\n * @param obj - The object to check\n * @returns True if obj has a toObject function\n */\nexport function isMongooseDoc(obj: unknown): obj is { toObject: () => { [key: string]: unknown } } {\n    return obj !== null && typeof obj === 'object' && 'toObject' in obj && typeof (obj as { toObject: unknown }).toObject === 'function';\n}\n\n/**\n * Optimized batch population for dynamic virtuals.\n *\n * - Groups documents by model and batches queries for each model.\n * - Populates all dynamic virtuals in parallel for maximum performance.\n * - Uses direct assignment for plain objects and skips already populated fields.\n * - Supports optional projection for population queries.\n * - Only populates virtuals that are explicitly requested in populate options.\n * - Reminder: Ensure indexes exist on foreignField in referenced collections for best performance.\n *\n * @template T - The document type (must be an object)\n * @template R - The model name type (usually string or enum)\n * @param {typeof mongooseRaw} mongoose - The Mongoose instance\n * @param {T[]} documents - The array of documents to populate\n * @param {I_DynamicVirtualConfig<T, R>[]} virtualConfigs - The dynamic virtual configurations to process\n * @param {T_Input_Populate} [populate] - Population options to determine which virtuals to populate\n * @param {Record<string, 0 | 1>} [projection] - Optional projection for population queries\n * @returns {Promise<object[]>} The array of documents with dynamic virtuals populated\n */\nexport async function populateDynamicVirtuals<T extends object, R extends string = string>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    virtualConfigs: I_DynamicVirtualConfig<T, R>[],\n    populate?: T_Input_Populate,\n    projection?: Record<string, 0 | 1>,\n    startModel?: any,\n): Promise<T[]> {\n    if (!documents.length || !virtualConfigs.length) {\n        return documents;\n    }\n\n    if (!populate) {\n        return documents;\n    }\n\n    const requestedVirtuals = virtualConfigs.filter((config) => {\n        if (Array.isArray(populate)) {\n            return populate.length > 0 && populate.some((p) => {\n                if (typeof p === 'string') {\n                    return p === config.name || p.startsWith(`${config.name}.`);\n                }\n                if (p && typeof p === 'object') {\n                    const popObj = p as { path?: string; populate?: string };\n                    const path = popObj.path || popObj.populate || '';\n\n                    return path === config.name || path.startsWith(`${config.name}.`);\n                }\n\n                return false;\n            });\n        }\n\n        if (typeof populate === 'string') {\n            return populate === config.name || populate.startsWith(`${config.name}.`);\n        }\n\n        if (typeof populate === 'object' && populate !== null) {\n            const popObj = populate as { path?: string; populate?: string };\n            const path = popObj.path || popObj.populate || '';\n\n            return (path === config.name) || path.startsWith(`${config.name}.`);\n        }\n\n        return false;\n    });\n\n    if (requestedVirtuals.length === 0) {\n        return documents;\n    }\n\n    const clonedDocuments = deepClone(documents.map(doc => isMongooseDoc(doc) ? doc.toObject() : doc)) as T[];\n\n    clonedDocuments.forEach((doc) => {\n        requestedVirtuals.forEach(({ name, options }) => {\n            if (!(name in doc)) {\n                (doc as { [key: string]: unknown })[name as string] = options.count ? 0 : (options.justOne ? null : []);\n            }\n        });\n    });\n\n    const modelProcessingMap = new Map<string, {\n        virtuals: I_DynamicVirtualConfig<T, R>[];\n        localValueSets: Map<string, Set<string>>;\n        docsByLocalValue: Map<string, number[]>;\n    }>();\n\n    for (const virtualConfig of requestedVirtuals) {\n        const { name, options } = virtualConfig;\n        const populateGroups = remapDynamicPopulate(clonedDocuments, name, options);\n\n        for (const group of populateGroups) {\n            if (!modelProcessingMap.has(group.model)) {\n                modelProcessingMap.set(group.model, {\n                    virtuals: [],\n                    localValueSets: new Map(),\n                    docsByLocalValue: new Map(),\n                });\n            }\n\n            const processing = modelProcessingMap.get(group.model)!;\n\n            if (!processing.virtuals.some(v => v.name === name)) {\n                processing.virtuals.push(virtualConfig);\n                processing.localValueSets.set(name as string, new Set());\n            }\n\n            const localValueSet = processing.localValueSets.get(name as string)!;\n            group.docs.forEach((doc) => {\n                const localVal = (doc as { [key: string]: unknown })[options.localField];\n\n                if (localVal != null) {\n                    const strVal = String(localVal);\n                    localValueSet.add(strVal);\n\n                    let idx = -1;\n\n                    const docWithKeys = doc as { [key: string]: unknown };\n\n                    if (docWithKeys['id'] !== undefined) {\n                        idx = clonedDocuments.findIndex((d) => {\n                            const dWithKeys = d as { [key: string]: unknown };\n\n                            return dWithKeys['id'] === docWithKeys['id'];\n                        });\n                    }\n                    else if (docWithKeys['_id'] !== undefined) {\n                        idx = clonedDocuments.findIndex((d) => {\n                            const dWithKeys = d as { [key: string]: unknown };\n\n                            return dWithKeys['_id']?.toString?.() === docWithKeys['_id']?.toString?.();\n                        });\n                    }\n\n                    if (idx !== -1) {\n                        if (!processing.docsByLocalValue.has(strVal)) {\n                            processing.docsByLocalValue.set(strVal, []);\n                        }\n                        processing.docsByLocalValue.get(strVal)!.push(idx);\n                    }\n                }\n            });\n        }\n    }\n\n    await Promise.all(Array.from(modelProcessingMap.entries(), async ([modelName, processing]) => {\n        const Model = mongoose.models[modelName];\n\n        if (!Model) {\n            return;\n        }\n\n        const allLocalValues = new Set<string>();\n        processing.localValueSets.forEach((localValueSet) => {\n            localValueSet.forEach(val => allLocalValues.add(val));\n        });\n\n        if (allLocalValues.size === 0) {\n            return;\n        }\n\n        const foreignFields = [...new Set(processing.virtuals.map(v => v.options.foreignField))];\n        const localValuesArray = [...allLocalValues];\n        let query;\n\n        if (foreignFields.length === 1) {\n            query = { [String(foreignFields[0])]: { $in: localValuesArray } };\n        }\n        else {\n            query = { $or: foreignFields.map(field => ({ [field]: { $in: localValuesArray } })) };\n        }\n\n        const allPopulatedData = await Model.find(query, projection).lean();\n\n        for (const virtualConfig of processing.virtuals) {\n            const { name, options } = virtualConfig;\n            const relevantData = allPopulatedData.filter((item) => {\n                const foreignVal = (item)[options.foreignField];\n\n                return foreignVal != null && allLocalValues.has(String(foreignVal));\n            });\n\n            if (options.count) {\n                const countMap = new Map<string, number>();\n\n                relevantData.forEach((item) => {\n                    const key = (item)[options.foreignField]?.toString();\n\n                    if (key) {\n                        countMap.set(key, (countMap.get(key) || 0) + 1);\n                    }\n                });\n\n                processing.localValueSets.get(name as string)!.forEach((localValue) => {\n                    const docs = processing.docsByLocalValue.get(localValue) || [];\n                    const count = countMap.get(localValue) || 0;\n\n                    docs.forEach((idx) => {\n                        const docToUpdate = clonedDocuments[idx] as { [key: string]: unknown };\n\n                        if (docToUpdate[name] === undefined) {\n                            docToUpdate[name] = count;\n                        }\n                    });\n                });\n            }\n            else {\n                const resultMap = new Map<string, T[]>();\n\n                relevantData.forEach((item) => {\n                    const key = (item)[options.foreignField]?.toString();\n\n                    if (key) {\n                        if (!resultMap.has(key)) {\n                            resultMap.set(key, []);\n                        }\n                        resultMap.get(key)!.push(item);\n                    }\n                });\n\n                processing.localValueSets.get(name as string)!.forEach((localVal) => {\n                    const docs = processing.docsByLocalValue.get(localVal) || [];\n                    const results = resultMap.get(localVal) || [];\n                    const value = options.justOne ? (results[0] || null) : results;\n\n                    docs.forEach((idx) => {\n                        const docToUpdate = clonedDocuments[idx] as { [key: string]: unknown };\n                        docToUpdate[name] = value;\n                    });\n                });\n            }\n        }\n    }));\n\n    if (populate) {\n        const normalizePopulate = (pop: T_Input_Populate): T_Input_Populate => {\n            const asArray = Array.isArray(pop) ? pop : [pop];\n            const grouped = new Map<string, any[]>();\n            const passthrough: any[] = [];\n\n            for (const entry of asArray) {\n                if (typeof entry === 'string') {\n                    if (entry.includes('.')) {\n                        const parts = entry.split('.');\n                        const first = parts[0] || '';\n                        const rest = parts.slice(1).join('.');\n\n                        if (first) {\n                            if (!grouped.has(first)) {\n                                grouped.set(first, []);\n                            }\n                            if (rest) {\n                                grouped.get(first)!.push(rest);\n                            }\n                        }\n                    }\n                    else {\n                        passthrough.push(entry);\n                    }\n                }\n                else if (entry && typeof entry === 'object') {\n                    const obj = entry as { path?: string; populate?: T_Input_Populate };\n\n                    if (obj.path && obj.path.includes('.')) {\n                        const parts = obj.path.split('.');\n                        const first = parts[0] || '';\n                        const rest = parts.slice(1).join('.');\n\n                        if (first) {\n                            if (!grouped.has(first)) {\n                                grouped.set(first, []);\n                            }\n                            if (rest) {\n                                grouped.get(first)!.push(rest);\n                            }\n                            if (obj.populate) {\n                                grouped.get(first)!.push(obj.populate as unknown as any);\n                            }\n                        }\n                    }\n                    else {\n                        passthrough.push(entry as any);\n                    }\n                }\n            }\n\n            const normalized: any[] = [...passthrough];\n            grouped.forEach((nested, root) => {\n                const flat: any[] = [];\n\n                for (const n of nested) {\n                    if (typeof n === 'string') {\n                        flat.push(n);\n                    }\n                    else if (n && typeof n === 'object') {\n                        flat.push(n);\n                    }\n                }\n                if (flat.length > 0) {\n                    normalized.push({ path: root as string, populate: flat as unknown as T_Input_Populate });\n                }\n                else {\n                    normalized.push(root);\n                }\n            });\n\n            return normalized as unknown as T_Input_Populate;\n        };\n\n        const normalizedPopulate = normalizePopulate(populate);\n\n        await applyNestedPopulate(mongoose, clonedDocuments, normalizedPopulate, virtualConfigs as I_DynamicVirtualConfig<unknown, string>[], startModel);\n    }\n\n    return clonedDocuments;\n}\n"],"names":["isObject","value","filterDynamicVirtualsFromPopulate","populate","dynamicVirtuals","dynamicVirtualNames","v","filtered","p","virtualName","popObj","path","remapDynamicPopulate","documents","virtualOptions","modelGroups","doc","modelName","modelNameString","convertedModelName","convertEnumToModelName","error","catchError","model","docs","isMongooseDoc","obj","populateDynamicVirtuals","mongoose","virtualConfigs","projection","startModel","requestedVirtuals","config","clonedDocuments","deepClone","name","options","modelProcessingMap","virtualConfig","populateGroups","group","processing","localValueSet","localVal","strVal","idx","docWithKeys","d","Model","allLocalValues","val","foreignFields","localValuesArray","query","field","allPopulatedData","relevantData","item","foreignVal","countMap","key","localValue","count","docToUpdate","resultMap","results","normalizedPopulate","pop","asArray","grouped","passthrough","entry","parts","first","rest","normalized","nested","root","flat","n","applyNestedPopulate"],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+import { default as mongooseRaw } from 'mongoose';
+import { I_DynamicVirtualConfig, T_Input_Populate } from './mongo.type.js';
+/**
+ * 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 function applyNestedPopulate<T extends object>(mongoose: typeof mongooseRaw, documents: T[], populateOptions: T_Input_Populate, virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[], currentModel?: any): Promise<T[]>;