@cyberskill/shared 3.4.0 → 3.5.0

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

@@ -1,236 +1,195 @@
-import { convertEnumToModelName as e } from "./mongo.util.js";
+import { getDynamicVirtualConfigs as e, resolveRef as t, searchVirtualsInSchema as n } from "./mongo.internal-types.js";
+import { convertEnumToModelName as r } from "./mongo.util.js";
 //#region src/node/mongo/mongo.populate.ts
-async function t(e, t, i, a, o) {
-	if (!t.length || !i) return t;
-	let s = Array.isArray(i) ? i : [i];
-	for (let i of s) typeof i == "string" ? await n(e, t, i, a, o) : i && typeof i == "object" && await r(e, t, i, a, o);
+async function i(e, t, n, r, i) {
+	if (!t.length || !n) return t;
+	let a = Array.isArray(n) ? n : [n];
+	for (let n of a) typeof n == "string" ? await o(e, t, n, r, i) : n && typeof n == "object" && await s(e, t, n, r, i);
 	return t;
 }
-async function n(t, n, r, i, a) {
-	let o = r.split(".");
+function a(n, i, a, o) {
+	if (!i) return;
+	if (i.schema?.virtuals) {
+		let e = i.schema.virtuals[a];
+		if (e?.options?.ref) {
+			let i = t(e.options.ref, o);
+			if (i) {
+				let e = r(i);
+				if (n.models[e]) return n.models[e];
+			}
+		}
+	}
+	let s = e(i).find((e) => e.name === a);
+	if (s?.options?.ref) {
+		let e = t(s.options.ref, o);
+		if (e) {
+			let t = r(e);
+			if (n.models[t]) return n.models[t];
+		}
+	}
+	return i;
+}
+async function o(e, t, n, r, i) {
+	let o = n.split(".");
 	if (o.length < 2) {
-		for (let e of n) await s(t, e, r, i, void 0, a);
+		for (let a of t) await d(e, a, n, r, void 0, i);
 		return;
 	}
-	let c = o[0];
-	if (!c || c.trim() === "") return;
-	let l = o.slice(1).join(".");
-	for (let r of n) {
-		let n = r, o = n[c];
+	let s = o[0];
+	if (!s || s.trim() === "") return;
+	let c = o.slice(1).join(".");
+	for (let n of t) {
+		let t = n, o = t[s];
 		if (o && typeof o == "object") {
-			let r = a, u = r;
-			if (a && a.schema && a.schema.virtuals) {
-				let i = a.schema.virtuals[c];
-				if (i && i.options && i.options.ref) {
-					let a;
-					if (typeof i.options.ref == "function" ? a = i.options.ref(n) : typeof i.options.ref == "string" && (a = i.options.ref), a) {
-						let n = e(a);
-						t.models[n] && (r = t.models[n]);
-					}
-				}
-			}
-			if (!r) {
-				let i = (a?._virtualConfigs || (a?.schema?.statics ?? {})._dynamicVirtuals || []).find((e) => e.name === c);
-				if (i && i.options && i.options.ref) {
-					let a;
-					if (typeof i.options.ref == "function" ? a = i.options.ref(n) : typeof i.options.ref == "string" && (a = i.options.ref), a) {
-						let n = e(a);
-						t.models[n] && (r = t.models[n]);
-					}
-				}
-			}
-			if (r === u) {
-				let i = (a?._virtualConfigs || (a?.schema?.statics ?? {})._dynamicVirtuals || []).find((e) => e.name === c);
-				if (i && i.options && i.options.ref) {
-					let a;
-					if (typeof i.options.ref == "function" ? a = i.options.ref(n) : typeof i.options.ref == "string" && (a = i.options.ref), a) {
-						let n = e(a);
-						t.models[n] && (r = t.models[n]);
-					}
-				}
-			}
-			if (Array.isArray(o)) for (let e of o) e && typeof e == "object" && await s(t, e, l, i, c, r);
-			else o && typeof o == "object" && await s(t, o, l, i, c, r);
+			let n = a(e, i, s, t);
+			if (Array.isArray(o)) for (let t of o) t && typeof t == "object" && await d(e, t, c, r, s, n);
+			else o && typeof o == "object" && await d(e, o, c, r, s, n);
 		}
 	}
 }
-async function r(r, i, a, o, s) {
-	let { path: c, populate: l } = a;
-	if (!c) return;
-	if (!l) {
-		await n(r, i, c, o, s);
+async function s(e, n, a, s, c) {
+	let { path: l, populate: u } = a;
+	if (!l) return;
+	if (!u) {
+		await o(e, n, l, s, c);
 		return;
 	}
-	let u = c;
-	for (let n of i) {
-		let i = n, a = i[u], c = s;
-		if (s && s.schema && s.schema.virtuals) {
-			let t = s.schema.virtuals[u];
-			if (t && t.options && t.options.ref) {
-				let n;
-				if (typeof t.options.ref == "function" ? n = t.options.ref(i) : typeof t.options.ref == "string" && (n = t.options.ref), n) {
-					let t = e(n);
-					r.models[t] && (c = r.models[t]);
+	let d = l;
+	for (let a of n) {
+		let n = a, o = n[d], l = c;
+		if (c?.schema?.virtuals) {
+			let i = c.schema.virtuals[d];
+			if (i?.options?.ref) {
+				let a = t(i.options.ref, n);
+				if (a) {
+					let t = r(a);
+					e.models[t] && (l = e.models[t]);
 				}
 			}
 		}
-		if (!c && typeof a == "object" && a && "entityType" in a) {
-			let t = e(String(a.entityType));
-			r.models[t] && (c = r.models[t]);
+		if (!l && typeof o == "object" && o && "entityType" in o) {
+			let t = r(String(o.entityType));
+			e.models[t] && (l = e.models[t]);
 		}
-		if (a && typeof a == "object") if (Array.isArray(a)) for (let e of a) e && typeof e == "object" && await t(r, [e], l, o, c);
-		else a && typeof a == "object" && await t(r, [a], l, o, c);
+		if (o && typeof o == "object") if (Array.isArray(o)) for (let t of o) t && typeof t == "object" && await i(e, [t], u, s, l);
+		else o && typeof o == "object" && await i(e, [o], u, s, l);
 	}
 }
-function i(e, t, n, r) {
-	if (!n || !t || !t.schema) return;
-	let i = n.split("."), a = t.schema;
-	for (let t = 0; t < i.length; t++) {
-		let n = i[t];
-		if (a && a.virtuals && n) {
-			let o = a.virtuals[n];
-			if (o && o.options && o.options.ref) {
-				let n;
-				if (typeof o.options.ref == "function" ? n = o.options.ref(r) : typeof o.options.ref == "string" && (n = o.options.ref), n && typeof n == "string") {
-					if (t === i.length - 1) return n;
-					let r = e.models[n];
-					if (r && r.schema) {
-						a = r.schema;
+function c(e, n, r, i) {
+	if (!r || !n || !n.schema) return;
+	let a = r.split("."), o = n.schema;
+	for (let n = 0; n < a.length; n++) {
+		let r = a[n];
+		if (o?.virtuals && r) {
+			let s = o.virtuals[r];
+			if (s?.options?.ref) {
+				let r = t(s.options.ref, i);
+				if (r && typeof r == "string") {
+					if (n === a.length - 1) return r;
+					let t = e.models[r];
+					if (t && t.schema) {
+						o = t.schema;
 						continue;
 					}
 				}
 			}
 		}
-		if (a && a.paths && n) {
-			let e = a.paths[n];
-			if (e && e.schema) {
-				a = e.schema;
+		if (o?.paths && r) {
+			let e = o.paths[r];
+			if (e?.schema) {
+				o = e.schema;
 				continue;
 			}
 		}
 		return;
 	}
 }
-function a(e, t) {
+function l(e, t) {
 	if (t) for (let n of Object.keys(e.models)) {
 		let r = e.models[n], i = r?.schema;
 		if (i && (i.paths && i.paths[t] || i.virtuals && i.virtuals[t])) return r;
 	}
 }
-function o(e, t) {
+function u(e, t) {
 	let n = (t || "").split(".")[0] || "";
 	if (n) for (let t of Object.keys(e.models)) {
 		let r = e.models[t], i = r?.schema;
 		if (i && (i.paths && i.paths[n] || i.virtuals && i.virtuals[n])) return r;
 	}
 }
-async function s(e, t, n, r, s, c) {
-	let l = t.__t;
-	if (!l) {
-		if (c) {
-			let r = s ? `${s}.${n}` : n, u = (r || "").split(".")[0] || "", d = c;
-			if (!(d?.schema?.paths && d.schema.paths[u] || d?.schema?.virtuals && d.schema.virtuals[u])) {
-				let t = o(e, r);
-				t && (d = t);
+async function d(e, r, i, a, o, s) {
+	let d = r.__t;
+	if (!d) {
+		if (s) {
+			let t = o ? `${o}.${i}` : i, n = (t || "").split(".")[0] || "", a = s;
+			if (!(a?.schema?.paths && a.schema.paths[n] || a?.schema?.virtuals && a.schema.virtuals[n])) {
+				let n = u(e, t);
+				n && (a = n);
 			}
-			let f = i(e, d, r, t);
-			if (f) l = f;
+			let f = c(e, a, t, r);
+			if (f) d = f;
 			else {
-				let n = (r.includes(".") ? r.split(".").pop() : r) || "";
+				let n = (t.includes(".") ? t.split(".").pop() : t) || "";
 				if (n) {
-					let o = a(e, n);
-					if (o) {
-						let n = i(e, o, r, t);
-						n && (l = n);
+					let i = l(e, n);
+					if (i) {
+						let n = c(e, i, t, r);
+						n && (d = n);
 					}
 				}
 			}
 		}
-		if (r && r.length > 0) {
-			let e = n.split(".").pop() || "", i = r.find((t) => t.name === e);
-			if (i && i.options.ref) {
-				let e;
-				typeof i.options.ref == "function" ? e = i.options.ref(t) : typeof i.options.ref == "string" && (e = i.options.ref), e && typeof e == "string" && (l = e);
+		if (a && a.length > 0) {
+			let e = i.split(".").pop() || "", n = a.find((t) => t.name === e);
+			if (n?.options.ref) {
+				let e = t(n.options.ref, r);
+				e && typeof e == "string" && (d = e);
 			}
 		}
-		if (!l) {
-			for (let [e, n] of Object.entries(t)) if (e === "entityType" && typeof n == "string") {
-				l = n;
+		if (!d) {
+			for (let [e, t] of Object.entries(r)) if (e === "entityType" && typeof t == "string") {
+				d = t;
 				break;
 			}
-			if (l && e.models[l]) {
-				let r = e.models[l];
-				if (r && r.schema) {
-					let e = r.schema, i = n.split(".").pop() || "", a = (e, n = "root") => {
-						if (!e || !e.virtuals) return;
-						let r = e.virtuals;
-						for (let e of Object.keys(r)) if (e === i) {
-							let n = r[e];
-							if (n && n.options && n.options.ref) {
-								let e;
-								if (typeof n.options.ref == "function" ? e = n.options.ref(t) : typeof n.options.ref == "string" && (e = n.options.ref), e && typeof e == "string") return e;
-							}
-						}
-						if (e.paths) for (let t of Object.keys(e.paths)) {
-							let r = e.paths[t];
-							if (r && r.schema) {
-								let e = a(r.schema, `${n}.${t}`);
-								if (e) return e;
-							}
-						}
-					}, o = a(e);
-					o && (l = o);
+			if (d && e.models[d]) {
+				let t = e.models[d];
+				if (t?.schema) {
+					let e = i.split(".").pop() || "", a = n(t.schema, e, r);
+					a && (d = a);
 				}
 			}
 		}
-		if (!l) {
-			let a = n.split(".").pop() || "";
-			if (c && c.schema) {
-				let e = c.schema, n = (e, r = "root") => {
-					if (!e || !e.virtuals) return;
-					let i = e.virtuals;
-					for (let e of Object.keys(i)) if (e === a) {
-						let n = i[e];
-						if (n && n.options && n.options.ref) {
-							let e;
-							if (typeof n.options.ref == "function" ? e = n.options.ref(t) : typeof n.options.ref == "string" && (e = n.options.ref), e && typeof e == "string") return e;
-						}
-					}
-					if (e.paths) for (let t of Object.keys(e.paths)) {
-						let i = e.paths[t];
-						if (i && i.schema) {
-							let e = n(i.schema, `${r}.${t}`);
-							if (e) return e;
-						}
-					}
-				}, r = n(e);
-				r && (l = r);
+		if (!d) {
+			let o = i.split(".").pop() || "";
+			if (s?.schema) {
+				let e = n(s.schema, o, r);
+				e && (d = e);
 			}
-			if (!l && c) {
-				let r = i(e, c, n, t);
-				r && (l = r);
+			if (!d && s) {
+				let t = c(e, s, i, r);
+				t && (d = t);
 			}
-			if (!l && r && r.length > 0) {
-				let e = r.find((e) => e.name === a);
-				if (e && e.options.ref) {
-					let n;
-					typeof e.options.ref == "function" ? n = e.options.ref(t) : typeof e.options.ref == "string" && (n = e.options.ref), n && typeof n == "string" && (l = n);
+			if (!d && a && a.length > 0) {
+				let e = a.find((e) => e.name === o);
+				if (e?.options.ref) {
+					let n = t(e.options.ref, r);
+					n && typeof n == "string" && (d = n);
 				}
 			}
 		}
-		if (!l) {
-			let t = n.split(".").pop() || "", r = t ? t.charAt(0).toUpperCase() + t.slice(1) : "";
-			r && e.models[r] && (l = r);
+		if (!d) {
+			let t = i.split(".").pop() || "", n = t ? t.charAt(0).toUpperCase() + t.slice(1) : "";
+			n && e.models[n] && (d = n);
 		}
 	}
-	let u = e.models[l];
-	if (!u) return;
-	let d = `${n}Id`, f = `${n}Ids`, p = t[d] || t[f] || t[n];
-	if (!p) return;
-	let m = await u.find({ id: { $in: Array.isArray(p) ? p : [p] } }).lean();
-	m.length > 0 && (Array.isArray(p) ? t[n] = m : t[n] = m[0]);
+	let f = e.models[d];
+	if (!f) return;
+	let p = `${i}Id`, m = `${i}Ids`, h = r[p] || r[m] || r[i];
+	if (!h) return;
+	let g = await f.find({ id: { $in: Array.isArray(h) ? h : [h] } }).lean();
+	g.length > 0 && (Array.isArray(h) ? r[i] = g : r[i] = g[0]);
 }
 //#endregion
-export { t as applyNestedPopulate };
+export { i as applyNestedPopulate };
 
 //# sourceMappingURL=mongo.populate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"mongo.populate.js","names":[],"sources":["../../../src/node/mongo/mongo.populate.ts"],"sourcesContent":["import type mongooseRaw from 'mongoose';\n\nimport type { I_DynamicVirtualConfig, T_Input_Populate } from './mongo.type.js';\n\nimport { convertEnumToModelName } from './mongo.util.js';\n\n/**\n * Recursively applies nested populate options to populated documents.\n * This function handles cases where a populated field needs further population.\n *\n * @template T - The document type\n * @param mongoose - The Mongoose instance\n * @param documents - The documents to apply nested populations to\n * @param populateOptions - The populate options to apply\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n * @returns Promise with documents that have nested populations applied\n */\nexport async function applyNestedPopulate<T extends object>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    populateOptions: T_Input_Populate,\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    currentModel?: any,\n): Promise<T[]> {\n    if (!documents.length || !populateOptions) {\n        return documents;\n    }\n\n    const populateArray = Array.isArray(populateOptions) ? populateOptions : [populateOptions];\n\n    for (const populateOption of populateArray) {\n        if (typeof populateOption === 'string') {\n            await applyStringPopulate(mongoose, documents, populateOption, virtualConfigs, currentModel);\n        }\n        else if (populateOption && typeof populateOption === 'object') {\n            const popObj = populateOption as { path?: string; populate?: T_Input_Populate; [key: string]: unknown };\n\n            await applyObjectPopulate(mongoose, documents, popObj, virtualConfigs, currentModel);\n        }\n    }\n\n    return documents;\n}\n\n/**\n * Applies string-based populate options (e.g., \"field.subfield\") to documents.\n *\n * @template T - The document type\n * @param mongoose - The Mongoose instance\n * @param documents - The documents to populate\n * @param populatePath - The populate path string\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n */\nasync function applyStringPopulate<T extends object>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    populatePath: string,\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    currentModel?: any,\n): Promise<void> {\n    const pathParts = populatePath.split('.');\n\n    if (pathParts.length < 2) {\n        for (const doc of documents) {\n            const docObj = doc as { [key: string]: unknown };\n\n            await populateNestedFieldOnParent(mongoose, docObj, populatePath, virtualConfigs, undefined, currentModel);\n        }\n\n        return;\n    }\n\n    const mainField = pathParts[0];\n\n    if (!mainField || mainField.trim() === '') {\n        return;\n    }\n\n    const nestedPath = pathParts.slice(1).join('.');\n\n    for (const doc of documents) {\n        const docObj = doc as { [key: string]: unknown };\n        const mainValue = docObj[mainField];\n\n        if (mainValue && typeof mainValue === 'object') {\n            let nextModelForChildren = currentModel;\n            const originalModelForChildren = nextModelForChildren;\n\n            if (currentModel && currentModel.schema && currentModel.schema.virtuals) {\n                const virtual = currentModel.schema.virtuals[mainField];\n\n                if (virtual && virtual.options && virtual.options.ref) {\n                    let refResult: string | undefined;\n\n                    if (typeof virtual.options.ref === 'function') {\n                        refResult = virtual.options.ref(docObj);\n                    }\n                    else if (typeof virtual.options.ref === 'string') {\n                        refResult = virtual.options.ref;\n                    }\n                    if (refResult) {\n                        const modelName = convertEnumToModelName(refResult);\n\n                        if (mongoose.models[modelName]) {\n                            nextModelForChildren = mongoose.models[modelName];\n                        }\n                    }\n                }\n            }\n\n            if (!nextModelForChildren) {\n                const schemaStatics = (currentModel?.schema?.statics ?? {}) as Record<string, unknown>;\n                const dynamicVirtuals = ((currentModel as any)?._virtualConfigs as Array<{ name: string; options?: { ref?: unknown } }>)\n                    || (schemaStatics['_dynamicVirtuals'] as Array<{ name: string; options?: { ref?: unknown } }> | undefined)\n                    || [];\n                const dyn = (dynamicVirtuals as Array<{ name: string; options?: { ref?: unknown } }>).find(v => v.name === mainField);\n\n                if (dyn && dyn.options && dyn.options.ref) {\n                    let refResult: string | undefined;\n\n                    if (typeof dyn.options.ref === 'function') {\n                        refResult = (dyn.options.ref as (d: unknown) => string | undefined)(docObj);\n                    }\n                    else if (typeof dyn.options.ref === 'string') {\n                        refResult = dyn.options.ref as string;\n                    }\n                    if (refResult) {\n                        const modelName = convertEnumToModelName(refResult);\n\n                        if (mongoose.models[modelName]) {\n                            nextModelForChildren = mongoose.models[modelName];\n                        }\n                    }\n                }\n            }\n\n            if (nextModelForChildren === originalModelForChildren) {\n                const schemaStatics = (currentModel?.schema?.statics ?? {}) as Record<string, unknown>;\n                const dynamicVirtuals = ((currentModel as any)?._virtualConfigs as Array<{ name: string; options?: { ref?: unknown } }>)\n                    || (schemaStatics['_dynamicVirtuals'] as Array<{ name: string; options?: { ref?: unknown } }> | undefined)\n                    || [];\n                const dyn = (dynamicVirtuals as Array<{ name: string; options?: { ref?: unknown } }>).find(v => v.name === mainField);\n\n                if (dyn && dyn.options && dyn.options.ref) {\n                    let refResult: string | undefined;\n\n                    if (typeof dyn.options.ref === 'function') {\n                        refResult = (dyn.options.ref as (d: unknown) => string | undefined)(docObj);\n                    }\n                    else if (typeof dyn.options.ref === 'string') {\n                        refResult = dyn.options.ref as string;\n                    }\n                    if (refResult) {\n                        const modelName = convertEnumToModelName(refResult);\n\n                        if (mongoose.models[modelName]) {\n                            nextModelForChildren = mongoose.models[modelName];\n                        }\n                    }\n                }\n            }\n\n            if (Array.isArray(mainValue)) {\n                for (const item of mainValue) {\n                    if (item && typeof item === 'object') {\n                        await populateNestedFieldOnParent(mongoose, item as { [key: string]: unknown }, nestedPath, virtualConfigs, mainField, nextModelForChildren);\n                    }\n                }\n            }\n            else if (mainValue && typeof mainValue === 'object') {\n                await populateNestedFieldOnParent(mongoose, mainValue as { [key: string]: unknown }, nestedPath, virtualConfigs, mainField, nextModelForChildren);\n            }\n        }\n    }\n}\n\n/**\n * Applies object-based populate options with nested populate to documents.\n *\n * @template T - The document type\n * @param mongoose - The Mongoose instance\n * @param documents - The documents to populate\n * @param populateOption - The populate option object\n * @param populateOption.path - The path to populate\n * @param populateOption.populate - The nested populate options\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n */\nasync function applyObjectPopulate<T extends object>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    populateOption: { path?: string; populate?: T_Input_Populate; [key: string]: unknown },\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    currentModel?: any,\n): Promise<void> {\n    const { path, populate: nestedPopulate } = populateOption;\n\n    if (!path) {\n        return;\n    }\n\n    if (!nestedPopulate) {\n        await applyStringPopulate(mongoose, documents, path, virtualConfigs, currentModel);\n\n        return;\n    }\n\n    const pathString = path;\n\n    for (const doc of documents) {\n        const docObj = doc as { [key: string]: unknown };\n        const fieldValue = docObj[pathString];\n\n        let nextModelForChildren = currentModel;\n\n        if (currentModel && currentModel.schema && currentModel.schema.virtuals) {\n            const virtual = currentModel.schema.virtuals[pathString];\n\n            if (virtual && virtual.options && virtual.options.ref) {\n                let refResult: string | undefined;\n\n                if (typeof virtual.options.ref === 'function') {\n                    refResult = virtual.options.ref(docObj);\n                }\n                else if (typeof virtual.options.ref === 'string') {\n                    refResult = virtual.options.ref;\n                }\n                if (refResult) {\n                    const modelName = convertEnumToModelName(refResult);\n                    if (mongoose.models[modelName]) {\n                        nextModelForChildren = mongoose.models[modelName];\n                    }\n                }\n            }\n        }\n        if (!nextModelForChildren && typeof fieldValue === 'object' && fieldValue && 'entityType' in (fieldValue as object)) {\n            const maybeModel = convertEnumToModelName(String((fieldValue as { [k: string]: unknown })['entityType']));\n\n            if (mongoose.models[maybeModel]) {\n                nextModelForChildren = mongoose.models[maybeModel];\n            }\n        }\n\n        if (fieldValue && typeof fieldValue === 'object') {\n            if (Array.isArray(fieldValue)) {\n                for (const item of fieldValue) {\n                    if (item && typeof item === 'object') {\n                        await applyNestedPopulate(mongoose, [item as { [key: string]: unknown }], nestedPopulate, virtualConfigs, nextModelForChildren);\n                    }\n                }\n            }\n            else if (fieldValue && typeof fieldValue === 'object') {\n                await applyNestedPopulate(mongoose, [fieldValue as { [key: string]: unknown }], nestedPopulate, virtualConfigs, nextModelForChildren);\n            }\n        }\n    }\n}\n\n/**\n * Resolves the target model for a given populate path by following the path step by step.\n * This function traverses the schema hierarchy to find the correct model for population.\n *\n * @param mongoose - The Mongoose instance\n * @param startModel - The starting model (usually the model containing the document)\n * @param path - The populate path to resolve (e.g., \"entity.partner1.gallery\")\n * @param document - The document being populated (for dynamic virtual resolution)\n * @returns The resolved model name or undefined if not found\n */\nfunction resolveModelFromPath(\n    mongoose: typeof mongooseRaw,\n    startModel: any,\n    path: string,\n    document: { [key: string]: unknown },\n): string | undefined {\n    if (!path || !startModel || !startModel.schema) {\n        return undefined;\n    }\n\n    const pathParts = path.split('.');\n    let currentSchema = startModel.schema;\n\n    for (let i = 0; i < pathParts.length; i++) {\n        const pathPart = pathParts[i];\n\n        if (currentSchema && currentSchema.virtuals && pathPart) {\n            const virtual = currentSchema.virtuals[pathPart];\n            if (virtual && virtual.options && virtual.options.ref) {\n                let refResult: string | undefined;\n\n                if (typeof virtual.options.ref === 'function') {\n                    refResult = virtual.options.ref(document);\n                }\n                else if (typeof virtual.options.ref === 'string') {\n                    refResult = virtual.options.ref;\n                }\n                if (refResult && typeof refResult === 'string') {\n                    if (i === pathParts.length - 1) {\n                        return refResult;\n                    }\n\n                    const nextModel = mongoose.models[refResult];\n\n                    if (nextModel && nextModel.schema) {\n                        currentSchema = nextModel.schema;\n                        continue;\n                    }\n                }\n            }\n        }\n\n        if (currentSchema && currentSchema.paths && pathPart) {\n            const pathSchema = currentSchema.paths[pathPart];\n\n            if (pathSchema && pathSchema.schema) {\n                currentSchema = pathSchema.schema;\n                continue;\n            }\n        }\n\n        return undefined;\n    }\n\n    return undefined;\n}\n\n/**\n * Attempts to find a model whose schema contains the given field\n * either as a direct path or a virtual. Searches only at the root level\n * of each model schema.\n */\nfunction findModelBySchemaField(\n    mongoose: typeof mongooseRaw,\n    fieldName: string,\n): any | undefined {\n    if (!fieldName) {\n        return undefined;\n    }\n    for (const modelName of Object.keys(mongoose.models)) {\n        const Model = mongoose.models[modelName];\n        const schema = Model?.schema as any;\n\n        if (!schema) {\n            continue;\n        }\n        if ((schema.paths && schema.paths[fieldName]) || (schema.virtuals && schema.virtuals[fieldName])) {\n            return Model;\n        }\n    }\n\n    return undefined;\n}\n\n/**\n * Finds a start model whose root schema contains the first segment of the path\n * as either a direct path or a virtual. Useful to jump into the correct model\n * when the current model context is misaligned (e.g., 'partner1.*' should start from User).\n */\nfunction findStartModelByFirstSegment(\n    mongoose: typeof mongooseRaw,\n    fullPath: string,\n): any | undefined {\n    const first = (fullPath || '').split('.')[0] || '';\n\n    if (!first) {\n        return undefined;\n    }\n    for (const modelName of Object.keys(mongoose.models)) {\n        const Model = mongoose.models[modelName];\n        const schema = Model?.schema as any;\n\n        if (!schema) {\n            continue;\n        }\n        if ((schema.paths && schema.paths[first]) || (schema.virtuals && schema.virtuals[first])) {\n            return Model;\n        }\n    }\n\n    return undefined;\n}\n\n/**\n * Populates a nested field on the parent object by finding the referenced document and applying populate options.\n *\n * @param mongoose - The Mongoose instance\n * @param document - The document containing the field to populate\n * @param nestedPath - The nested populate path\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param pathPrefix - The parent path prefix (if nested within another populated field)\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n */\nasync function populateNestedFieldOnParent(\n    mongoose: typeof mongooseRaw,\n    document: { [key: string]: unknown },\n    nestedPath: string,\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    pathPrefix?: string,\n    currentModel?: any,\n): Promise<void> {\n    let modelName = document['__t'];\n\n    if (!modelName) {\n        if (currentModel) {\n            const fullPath = pathPrefix ? `${pathPrefix}.${nestedPath}` : nestedPath;\n\n            const firstSegment = (fullPath || '').split('.')[0] || '';\n            let startModel = currentModel;\n            const hasFirstOnCurrent = Boolean(\n                (startModel?.schema?.paths && startModel.schema.paths[firstSegment])\n                || (startModel?.schema?.virtuals && startModel.schema.virtuals[firstSegment]),\n            );\n\n            if (!hasFirstOnCurrent) {\n                const betterStart = findStartModelByFirstSegment(mongoose, fullPath);\n\n                if (betterStart) {\n                    startModel = betterStart;\n                }\n            }\n\n            const resolvedFromPath = resolveModelFromPath(mongoose, startModel, fullPath, document);\n\n            if (resolvedFromPath) {\n                modelName = resolvedFromPath;\n            }\n            else {\n                const lastSegment = (fullPath.includes('.') ? fullPath.split('.').pop() : fullPath) || '';\n\n                if (lastSegment) {\n                    const candidateModel = findModelBySchemaField(mongoose, lastSegment);\n\n                    if (candidateModel) {\n                        const rerun = resolveModelFromPath(mongoose, candidateModel, fullPath, document);\n\n                        if (rerun) {\n                            modelName = rerun;\n                        }\n                    }\n                }\n            }\n        }\n\n        if (virtualConfigs && virtualConfigs.length > 0) {\n            const fieldName = nestedPath.split('.').pop() || '';\n            const matchingVirtual = virtualConfigs.find(v => v.name === fieldName);\n\n            if (matchingVirtual && matchingVirtual.options.ref) {\n                let refResult: string | undefined;\n\n                if (typeof matchingVirtual.options.ref === 'function') {\n                    refResult = matchingVirtual.options.ref(document);\n                }\n                else if (typeof matchingVirtual.options.ref === 'string') {\n                    refResult = matchingVirtual.options.ref;\n                }\n\n                if (refResult && typeof refResult === 'string') {\n                    modelName = refResult;\n                }\n            }\n        }\n\n        if (!modelName) {\n            for (const [key, value] of Object.entries(document as Record<string, unknown>)) {\n                if (key === 'entityType' && typeof value === 'string') {\n                    modelName = value;\n                    break;\n                }\n            }\n\n            if (modelName && mongoose.models[modelName as string]) {\n                const Model = mongoose.models[modelName as string];\n\n                if (Model && Model.schema) {\n                    const schema = Model.schema;\n                    const fieldName = nestedPath.split('.').pop() || '';\n\n                    const searchVirtualsInSchema = (schemaToSearch: any, schemaPath = 'root'): string | undefined => {\n                        if (!schemaToSearch || !schemaToSearch.virtuals) {\n                            return undefined;\n                        }\n\n                        const virtuals = schemaToSearch.virtuals;\n\n                        for (const virtualName of Object.keys(virtuals)) {\n                            if (virtualName === fieldName) {\n                                const virtual = virtuals[virtualName];\n                                if (virtual && virtual.options && virtual.options.ref) {\n                                    let refResult: string | undefined;\n\n                                    if (typeof virtual.options.ref === 'function') {\n                                        refResult = virtual.options.ref(document);\n                                    }\n                                    else if (typeof virtual.options.ref === 'string') {\n                                        refResult = virtual.options.ref;\n                                    }\n                                    if (refResult && typeof refResult === 'string') {\n                                        return refResult;\n                                    }\n                                }\n                            }\n                        }\n\n                        if (schemaToSearch.paths) {\n                            for (const pathName of Object.keys(schemaToSearch.paths)) {\n                                const pathSchema = schemaToSearch.paths[pathName];\n\n                                if (pathSchema && pathSchema.schema) {\n                                    const nestedResult = searchVirtualsInSchema(pathSchema.schema, `${schemaPath}.${pathName}`);\n\n                                    if (nestedResult) {\n                                        return nestedResult;\n                                    }\n                                }\n                            }\n                        }\n\n                        return undefined;\n                    };\n\n                    const foundModelName = searchVirtualsInSchema(schema);\n                    if (foundModelName) {\n                        modelName = foundModelName;\n                    }\n                }\n            }\n        }\n\n        if (!modelName) {\n            const fieldName = nestedPath.split('.').pop() || '';\n\n            if (currentModel && currentModel.schema) {\n                const schema = currentModel.schema;\n\n                const searchVirtualsInSchema = (schemaToSearch: any, schemaPath = 'root'): string | undefined => {\n                    if (!schemaToSearch || !schemaToSearch.virtuals) {\n                        return undefined;\n                    }\n\n                    const virtuals = schemaToSearch.virtuals;\n\n                    for (const virtualName of Object.keys(virtuals)) {\n                        if (virtualName === fieldName) {\n                            const virtual = virtuals[virtualName];\n                            if (virtual && virtual.options && virtual.options.ref) {\n                                let refResult: string | undefined;\n\n                                if (typeof virtual.options.ref === 'function') {\n                                    refResult = virtual.options.ref(document);\n                                }\n                                else if (typeof virtual.options.ref === 'string') {\n                                    refResult = virtual.options.ref;\n                                }\n\n                                if (refResult && typeof refResult === 'string') {\n                                    return refResult;\n                                }\n                            }\n                        }\n                    }\n\n                    if (schemaToSearch.paths) {\n                        for (const pathName of Object.keys(schemaToSearch.paths)) {\n                            const pathSchema = schemaToSearch.paths[pathName];\n\n                            if (pathSchema && pathSchema.schema) {\n                                const nestedResult = searchVirtualsInSchema(pathSchema.schema, `${schemaPath}.${pathName}`);\n\n                                if (nestedResult) {\n                                    return nestedResult;\n                                }\n                            }\n                        }\n                    }\n\n                    return undefined;\n                };\n\n                const foundModelName = searchVirtualsInSchema(schema);\n                if (foundModelName) {\n                    modelName = foundModelName;\n                }\n            }\n\n            if (!modelName) {\n                if (currentModel) {\n                    const resolvedModel = resolveModelFromPath(mongoose, currentModel, nestedPath, document);\n\n                    if (resolvedModel) {\n                        modelName = resolvedModel;\n                    }\n                }\n            }\n\n            if (!modelName && virtualConfigs && virtualConfigs.length > 0) {\n                const matchingVirtual = virtualConfigs.find(v => v.name === fieldName);\n\n                if (matchingVirtual && matchingVirtual.options.ref) {\n                    let refResult: string | undefined;\n\n                    if (typeof matchingVirtual.options.ref === 'function') {\n                        refResult = matchingVirtual.options.ref(document);\n                    }\n                    else if (typeof matchingVirtual.options.ref === 'string') {\n                        refResult = matchingVirtual.options.ref;\n                    }\n                    if (refResult && typeof refResult === 'string') {\n                        modelName = refResult;\n                    }\n                }\n            }\n        }\n\n        if (!modelName) {\n            const fieldName = nestedPath.split('.').pop() || '';\n            const candidate = fieldName ? fieldName.charAt(0).toUpperCase() + fieldName.slice(1) : '';\n\n            if (candidate && mongoose.models[candidate]) {\n                modelName = candidate;\n            }\n        }\n    }\n\n    const Model = mongoose.models[modelName as string];\n\n    if (!Model) {\n        return;\n    }\n\n    const fieldIdKey = `${nestedPath}Id`;\n    const fieldIdsKey = `${nestedPath}Ids`;\n\n    const docIds = document[fieldIdKey] || document[fieldIdsKey] || document[nestedPath];\n\n    if (!docIds) {\n        return;\n    }\n\n    const idsArray = Array.isArray(docIds) ? docIds : [docIds];\n\n    const populatedDocs = await Model.find({ id: { $in: idsArray } }).lean();\n\n    if (populatedDocs.length > 0) {\n        if (Array.isArray(docIds)) {\n            document[nestedPath] = populatedDocs;\n        }\n        else {\n            document[nestedPath] = populatedDocs[0];\n        }\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"mongo.populate.js","names":[],"sources":["../../../src/node/mongo/mongo.populate.ts"],"sourcesContent":["import type mongooseRaw from 'mongoose';\n\nimport type { I_ModelWithSchema } from './mongo.internal-types.js';\nimport type { I_DynamicVirtualConfig, T_Input_Populate } from './mongo.type.js';\n\nimport { getDynamicVirtualConfigs, resolveRef, searchVirtualsInSchema } from './mongo.internal-types.js';\nimport { convertEnumToModelName } from './mongo.util.js';\n\n/**\n * Recursively applies nested populate options to populated documents.\n * This function handles cases where a populated field needs further population.\n *\n * @template T - The document type\n * @param mongoose - The Mongoose instance\n * @param documents - The documents to apply nested populations to\n * @param populateOptions - The populate options to apply\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n * @returns Promise with documents that have nested populations applied\n */\nexport async function applyNestedPopulate<T extends object>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    populateOptions: T_Input_Populate,\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    currentModel?: I_ModelWithSchema,\n): Promise<T[]> {\n    if (!documents.length || !populateOptions) {\n        return documents;\n    }\n\n    const populateArray = Array.isArray(populateOptions) ? populateOptions : [populateOptions];\n\n    for (const populateOption of populateArray) {\n        if (typeof populateOption === 'string') {\n            await applyStringPopulate(mongoose, documents, populateOption, virtualConfigs, currentModel);\n        }\n        else if (populateOption && typeof populateOption === 'object') {\n            const popObj = populateOption as { path?: string; populate?: T_Input_Populate; [key: string]: unknown };\n\n            await applyObjectPopulate(mongoose, documents, popObj, virtualConfigs, currentModel);\n        }\n    }\n\n    return documents;\n}\n\n/**\n * Resolves the next child model from virtual/dynamic configurations on the current model.\n * Consolidates the repeated _virtualConfigs / schema.virtuals / _dynamicVirtuals lookup.\n *\n * @param mongoose - The Mongoose instance\n * @param currentModel - The model whose schema to search\n * @param fieldName - The field name to look up\n * @param document - The document context for function refs\n * @returns The resolved child model, or the original currentModel if not resolved\n */\nfunction resolveChildModel(\n    mongoose: typeof mongooseRaw,\n    currentModel: I_ModelWithSchema | undefined,\n    fieldName: string,\n    document: Record<string, unknown>,\n): I_ModelWithSchema | undefined {\n    if (!currentModel) {\n        return undefined;\n    }\n\n    // 1. Try schema virtuals\n    if (currentModel.schema?.virtuals) {\n        const virtual = currentModel.schema.virtuals[fieldName];\n        if (virtual?.options?.ref) {\n            const refResult = resolveRef(virtual.options.ref, document);\n            if (refResult) {\n                const modelName = convertEnumToModelName(refResult);\n                if (mongoose.models[modelName]) {\n                    return mongoose.models[modelName] as unknown as I_ModelWithSchema;\n                }\n            }\n        }\n    }\n\n    // 2. Try dynamic virtual configs (_virtualConfigs / _dynamicVirtuals)\n    const dynamicVirtuals = getDynamicVirtualConfigs(currentModel);\n    const dyn = dynamicVirtuals.find(v => v.name === fieldName);\n\n    if (dyn?.options?.ref) {\n        const refResult = resolveRef(dyn.options.ref, document);\n        if (refResult) {\n            const modelName = convertEnumToModelName(refResult);\n            if (mongoose.models[modelName]) {\n                return mongoose.models[modelName] as unknown as I_ModelWithSchema;\n            }\n        }\n    }\n\n    return currentModel;\n}\n\n/**\n * Applies string-based populate options (e.g., \"field.subfield\") to documents.\n *\n * @template T - The document type\n * @param mongoose - The Mongoose instance\n * @param documents - The documents to populate\n * @param populatePath - The populate path string\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n */\nasync function applyStringPopulate<T extends object>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    populatePath: string,\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    currentModel?: I_ModelWithSchema,\n): Promise<void> {\n    const pathParts = populatePath.split('.');\n\n    if (pathParts.length < 2) {\n        for (const doc of documents) {\n            const docObj = doc as { [key: string]: unknown };\n\n            await populateNestedFieldOnParent(mongoose, docObj, populatePath, virtualConfigs, undefined, currentModel);\n        }\n\n        return;\n    }\n\n    const mainField = pathParts[0];\n\n    if (!mainField || mainField.trim() === '') {\n        return;\n    }\n\n    const nestedPath = pathParts.slice(1).join('.');\n\n    for (const doc of documents) {\n        const docObj = doc as { [key: string]: unknown };\n        const mainValue = docObj[mainField];\n\n        if (mainValue && typeof mainValue === 'object') {\n            const nextModelForChildren = resolveChildModel(mongoose, currentModel, mainField, docObj);\n\n            if (Array.isArray(mainValue)) {\n                for (const item of mainValue) {\n                    if (item && typeof item === 'object') {\n                        await populateNestedFieldOnParent(mongoose, item as { [key: string]: unknown }, nestedPath, virtualConfigs, mainField, nextModelForChildren);\n                    }\n                }\n            }\n            else if (mainValue && typeof mainValue === 'object') {\n                await populateNestedFieldOnParent(mongoose, mainValue as { [key: string]: unknown }, nestedPath, virtualConfigs, mainField, nextModelForChildren);\n            }\n        }\n    }\n}\n\n/**\n * Applies object-based populate options with nested populate to documents.\n *\n * @template T - The document type\n * @param mongoose - The Mongoose instance\n * @param documents - The documents to populate\n * @param populateOption - The populate option object\n * @param populateOption.path - The path to populate\n * @param populateOption.populate - The nested populate options\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n */\nasync function applyObjectPopulate<T extends object>(\n    mongoose: typeof mongooseRaw,\n    documents: T[],\n    populateOption: { path?: string; populate?: T_Input_Populate; [key: string]: unknown },\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    currentModel?: I_ModelWithSchema,\n): Promise<void> {\n    const { path, populate: nestedPopulate } = populateOption;\n\n    if (!path) {\n        return;\n    }\n\n    if (!nestedPopulate) {\n        await applyStringPopulate(mongoose, documents, path, virtualConfigs, currentModel);\n\n        return;\n    }\n\n    const pathString = path;\n\n    for (const doc of documents) {\n        const docObj = doc as { [key: string]: unknown };\n        const fieldValue = docObj[pathString];\n\n        let nextModelForChildren: I_ModelWithSchema | undefined = currentModel;\n\n        // Try resolving from schema virtuals\n        if (currentModel?.schema?.virtuals) {\n            const virtual = currentModel.schema.virtuals[pathString];\n\n            if (virtual?.options?.ref) {\n                const refResult = resolveRef(virtual.options.ref, docObj);\n                if (refResult) {\n                    const modelName = convertEnumToModelName(refResult);\n                    if (mongoose.models[modelName]) {\n                        nextModelForChildren = mongoose.models[modelName] as unknown as I_ModelWithSchema;\n                    }\n                }\n            }\n        }\n        if (!nextModelForChildren && typeof fieldValue === 'object' && fieldValue && 'entityType' in (fieldValue as object)) {\n            const maybeModel = convertEnumToModelName(String((fieldValue as { [k: string]: unknown })['entityType']));\n\n            if (mongoose.models[maybeModel]) {\n                nextModelForChildren = mongoose.models[maybeModel] as unknown as I_ModelWithSchema;\n            }\n        }\n\n        if (fieldValue && typeof fieldValue === 'object') {\n            if (Array.isArray(fieldValue)) {\n                for (const item of fieldValue) {\n                    if (item && typeof item === 'object') {\n                        await applyNestedPopulate(mongoose, [item as { [key: string]: unknown }], nestedPopulate, virtualConfigs, nextModelForChildren);\n                    }\n                }\n            }\n            else if (fieldValue && typeof fieldValue === 'object') {\n                await applyNestedPopulate(mongoose, [fieldValue as { [key: string]: unknown }], nestedPopulate, virtualConfigs, nextModelForChildren);\n            }\n        }\n    }\n}\n\n/**\n * Resolves the target model for a given populate path by following the path step by step.\n * This function traverses the schema hierarchy to find the correct model for population.\n *\n * @param mongoose - The Mongoose instance\n * @param startModel - The starting model (usually the model containing the document)\n * @param path - The populate path to resolve (e.g., \"entity.partner1.gallery\")\n * @param document - The document being populated (for dynamic virtual resolution)\n * @returns The resolved model name or undefined if not found\n */\nfunction resolveModelFromPath(\n    mongoose: typeof mongooseRaw,\n    startModel: I_ModelWithSchema,\n    path: string,\n    document: { [key: string]: unknown },\n): string | undefined {\n    if (!path || !startModel || !startModel.schema) {\n        return undefined;\n    }\n\n    const pathParts = path.split('.');\n    let currentSchema = startModel.schema;\n\n    for (let i = 0; i < pathParts.length; i++) {\n        const pathPart = pathParts[i];\n\n        if (currentSchema?.virtuals && pathPart) {\n            const virtual = currentSchema.virtuals[pathPart];\n            if (virtual?.options?.ref) {\n                const refResult = resolveRef(virtual.options.ref, document);\n\n                if (refResult && typeof refResult === 'string') {\n                    if (i === pathParts.length - 1) {\n                        return refResult;\n                    }\n\n                    const nextModel = mongoose.models[refResult];\n\n                    if (nextModel && (nextModel as unknown as I_ModelWithSchema).schema) {\n                        currentSchema = (nextModel as unknown as I_ModelWithSchema).schema!;\n                        continue;\n                    }\n                }\n            }\n        }\n\n        if (currentSchema?.paths && pathPart) {\n            const pathSchema = currentSchema.paths[pathPart];\n\n            if (pathSchema?.schema) {\n                currentSchema = pathSchema.schema;\n                continue;\n            }\n        }\n\n        return undefined;\n    }\n\n    return undefined;\n}\n\n/**\n * Attempts to find a model whose schema contains the given field\n * either as a direct path or a virtual. Searches only at the root level\n * of each model schema.\n */\nfunction findModelBySchemaField(\n    mongoose: typeof mongooseRaw,\n    fieldName: string,\n): I_ModelWithSchema | undefined {\n    if (!fieldName) {\n        return undefined;\n    }\n    for (const modelName of Object.keys(mongoose.models)) {\n        const Model = mongoose.models[modelName] as unknown as I_ModelWithSchema;\n        const schema = Model?.schema;\n\n        if (!schema) {\n            continue;\n        }\n        if ((schema.paths && schema.paths[fieldName]) || (schema.virtuals && schema.virtuals[fieldName])) {\n            return Model;\n        }\n    }\n\n    return undefined;\n}\n\n/**\n * Finds a start model whose root schema contains the first segment of the path\n * as either a direct path or a virtual. Useful to jump into the correct model\n * when the current model context is misaligned (e.g., 'partner1.*' should start from User).\n */\nfunction findStartModelByFirstSegment(\n    mongoose: typeof mongooseRaw,\n    fullPath: string,\n): I_ModelWithSchema | undefined {\n    const first = (fullPath || '').split('.')[0] || '';\n\n    if (!first) {\n        return undefined;\n    }\n    for (const modelName of Object.keys(mongoose.models)) {\n        const Model = mongoose.models[modelName] as unknown as I_ModelWithSchema;\n        const schema = Model?.schema;\n\n        if (!schema) {\n            continue;\n        }\n        if ((schema.paths && schema.paths[first]) || (schema.virtuals && schema.virtuals[first])) {\n            return Model;\n        }\n    }\n\n    return undefined;\n}\n\n/**\n * Populates a nested field on the parent object by finding the referenced document and applying populate options.\n *\n * @param mongoose - The Mongoose instance\n * @param document - The document containing the field to populate\n * @param nestedPath - The nested populate path\n * @param virtualConfigs - Optional virtual configurations for model inference\n * @param pathPrefix - The parent path prefix (if nested within another populated field)\n * @param currentModel - The current model context (which model's schema to search for virtuals)\n */\nasync function populateNestedFieldOnParent(\n    mongoose: typeof mongooseRaw,\n    document: { [key: string]: unknown },\n    nestedPath: string,\n    virtualConfigs?: I_DynamicVirtualConfig<unknown, string>[],\n    pathPrefix?: string,\n    currentModel?: I_ModelWithSchema,\n): Promise<void> {\n    let modelName = document['__t'];\n\n    if (!modelName) {\n        if (currentModel) {\n            const fullPath = pathPrefix ? `${pathPrefix}.${nestedPath}` : nestedPath;\n\n            const firstSegment = (fullPath || '').split('.')[0] || '';\n            let startModel: I_ModelWithSchema = currentModel;\n            const hasFirstOnCurrent = Boolean(\n                (startModel?.schema?.paths && startModel.schema.paths[firstSegment])\n                || (startModel?.schema?.virtuals && startModel.schema.virtuals[firstSegment]),\n            );\n\n            if (!hasFirstOnCurrent) {\n                const betterStart = findStartModelByFirstSegment(mongoose, fullPath);\n\n                if (betterStart) {\n                    startModel = betterStart;\n                }\n            }\n\n            const resolvedFromPath = resolveModelFromPath(mongoose, startModel, fullPath, document);\n\n            if (resolvedFromPath) {\n                modelName = resolvedFromPath;\n            }\n            else {\n                const lastSegment = (fullPath.includes('.') ? fullPath.split('.').pop() : fullPath) || '';\n\n                if (lastSegment) {\n                    const candidateModel = findModelBySchemaField(mongoose, lastSegment);\n\n                    if (candidateModel) {\n                        const rerun = resolveModelFromPath(mongoose, candidateModel, fullPath, document);\n\n                        if (rerun) {\n                            modelName = rerun;\n                        }\n                    }\n                }\n            }\n        }\n\n        if (virtualConfigs && virtualConfigs.length > 0) {\n            const fieldName = nestedPath.split('.').pop() || '';\n            const matchingVirtual = virtualConfigs.find(v => v.name === fieldName);\n\n            if (matchingVirtual?.options.ref) {\n                const refResult = resolveRef(matchingVirtual.options.ref as string | ((doc: unknown) => string | undefined), document);\n\n                if (refResult && typeof refResult === 'string') {\n                    modelName = refResult;\n                }\n            }\n        }\n\n        if (!modelName) {\n            for (const [key, value] of Object.entries(document as Record<string, unknown>)) {\n                if (key === 'entityType' && typeof value === 'string') {\n                    modelName = value;\n                    break;\n                }\n            }\n\n            if (modelName && mongoose.models[modelName as string]) {\n                const Model = mongoose.models[modelName as string] as unknown as I_ModelWithSchema;\n\n                if (Model?.schema) {\n                    const fieldName = nestedPath.split('.').pop() || '';\n                    const foundModelName = searchVirtualsInSchema(Model.schema, fieldName, document);\n                    if (foundModelName) {\n                        modelName = foundModelName;\n                    }\n                }\n            }\n        }\n\n        if (!modelName) {\n            const fieldName = nestedPath.split('.').pop() || '';\n\n            if (currentModel?.schema) {\n                const foundModelName = searchVirtualsInSchema(currentModel.schema, fieldName, document);\n                if (foundModelName) {\n                    modelName = foundModelName;\n                }\n            }\n\n            if (!modelName) {\n                if (currentModel) {\n                    const resolvedModel = resolveModelFromPath(mongoose, currentModel, nestedPath, document);\n\n                    if (resolvedModel) {\n                        modelName = resolvedModel;\n                    }\n                }\n            }\n\n            if (!modelName && virtualConfigs && virtualConfigs.length > 0) {\n                const matchingVirtual = virtualConfigs.find(v => v.name === fieldName);\n\n                if (matchingVirtual?.options.ref) {\n                    const refResult = resolveRef(matchingVirtual.options.ref as string | ((doc: unknown) => string | undefined), document);\n\n                    if (refResult && typeof refResult === 'string') {\n                        modelName = refResult;\n                    }\n                }\n            }\n        }\n\n        if (!modelName) {\n            const fieldName = nestedPath.split('.').pop() || '';\n            const candidate = fieldName ? fieldName.charAt(0).toUpperCase() + fieldName.slice(1) : '';\n\n            if (candidate && mongoose.models[candidate]) {\n                modelName = candidate;\n            }\n        }\n    }\n\n    const Model = mongoose.models[modelName as string];\n\n    if (!Model) {\n        return;\n    }\n\n    const fieldIdKey = `${nestedPath}Id`;\n    const fieldIdsKey = `${nestedPath}Ids`;\n\n    const docIds = document[fieldIdKey] || document[fieldIdsKey] || document[nestedPath];\n\n    if (!docIds) {\n        return;\n    }\n\n    const idsArray = Array.isArray(docIds) ? docIds : [docIds];\n\n    const populatedDocs = await Model.find({ id: { $in: idsArray } }).lean();\n\n    if (populatedDocs.length > 0) {\n        if (Array.isArray(docIds)) {\n            document[nestedPath] = populatedDocs;\n        }\n        else {\n            document[nestedPath] = populatedDocs[0];\n        }\n    }\n}\n"],"mappings":"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"}

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

@@ -34,7 +34,7 @@ export type T_PreSaveMiddlewareFunction<T> = PreSaveMiddlewareFunction<T>;
 export type T_PostMiddlewareFunction<T> = PostMiddlewareFunction<T>;
 export type T_ErrorHandlingMiddlewareFunction<T> = ErrorHandlingMiddlewareFunction<T>;
 export type T_ErrorHandlingMiddlewareWithOption<T> = ErrorHandlingMiddlewareWithOption<T>;
-export type T_MongooseShema<T> = mongoose.Schema<T>;
+export type T_MongooseSchema<T> = mongoose.Schema<T>;
 export type T_Input_MongooseSchema<T> = SchemaDefinition<T>;
 export type T_MongoosePlugin = (schema: Schema, options?: Record<string, unknown>) => void;
 export interface I_GenericDocument extends Partial<C_Document> {

package/dist/node/mongo/mongo.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"mongo.type.js","names":[],"sources":["../../../src/node/mongo/mongo.type.ts"],"sourcesContent":["import type {\n    DeleteResult,\n    Filter,\n    InsertManyResult,\n    InsertOneResult,\n    OptionalUnlessRequiredId,\n    UpdateResult,\n    WithId,\n} from 'mongodb';\nimport type {\n    AggregatePaginateModel,\n    AggregatePaginateResult,\n    ClientSession,\n    ErrorHandlingMiddlewareFunction,\n    ErrorHandlingMiddlewareWithOption,\n    InsertManyOptions,\n    PaginateModel,\n    PaginateOptions,\n    PaginateResult,\n    PipelineStage,\n    PopulateOption,\n    PopulateOptions,\n    PostMiddlewareFunction,\n    PreMiddlewareFunction,\n    PreSaveMiddlewareFunction,\n    ProjectionType,\n    QueryFilter,\n    QueryOptions,\n    QueryWithHelpers,\n    Schema,\n    SchemaDefinition,\n    UpdateQuery,\n    UpdateWriteOpResult,\n} from 'mongoose';\nimport type mongoose from 'mongoose';\n\nimport { Collection, Db } from 'mongodb';\nimport {\n    Document,\n    Model,\n} from 'mongoose';\n\nexport class C_Db extends Db { }\n\nexport type T_Filter<T> = Filter<T>;\n\nexport type T_InsertOneResult<T> = InsertOneResult<T>;\n\nexport type T_InsertManyResult<T> = InsertManyResult<T>;\n\nexport type T_UpdateResult = UpdateResult | UpdateWriteOpResult;\n\nexport type T_DeleteResult = DeleteResult;\n\nexport type T_WithId<T> = WithId<T>;\n\nexport type T_OptionalUnlessRequiredId<T> = OptionalUnlessRequiredId<T>;\n\nexport class C_Document extends Document { }\n\nexport class C_Model extends Model { }\n\nexport class C_Collection<\n    T extends Partial<C_Document>,\n> extends Collection<T> { }\n\nexport interface I_ExtendedModel<T extends Partial<C_Document>>\n    extends Model<T>, PaginateModel<T>,\n    AggregatePaginateModel<T> { }\n\nexport type T_QueryFilter<T> = QueryFilter<T>;\n\nexport type T_ProjectionType<T> = ProjectionType<T>;\n\nexport type T_QueryOptions<T> = QueryOptions<T>;\n\nexport type T_PaginateOptions = PaginateOptions;\n\nexport type T_PopulateOption = PopulateOption;\n\nexport type T_PopulateOptions = PopulateOptions;\n\nexport type T_PipelineStage = PipelineStage;\n\nexport type T_PaginateResult<T> = PaginateResult<T>;\n\nexport type T_AggregatePaginateResult<T> = AggregatePaginateResult<T>;\n\nexport type T_InsertManyOptions = InsertManyOptions;\n\nexport type T_UpdateQuery<T> = UpdateQuery<T>;\n\nexport type T_QueryWithHelpers<T> = QueryWithHelpers<T, T>;\n\nexport type T_PreMiddlewareFunction<T> = PreMiddlewareFunction<T>;\n\nexport type T_PreSaveMiddlewareFunction<T> = PreSaveMiddlewareFunction<T>;\n\nexport type T_PostMiddlewareFunction<T> = PostMiddlewareFunction<T>;\n\nexport type T_ErrorHandlingMiddlewareFunction<T> = ErrorHandlingMiddlewareFunction<T>;\n\nexport type T_ErrorHandlingMiddlewareWithOption<T> = ErrorHandlingMiddlewareWithOption<T>;\n\nexport type T_MongooseShema<T> = mongoose.Schema<T>;\n\nexport type T_Input_MongooseSchema<T> = SchemaDefinition<T>;\n\nexport type T_MongoosePlugin = (schema: Schema, options?: Record<string, unknown>) => void;\n\nexport interface I_GenericDocument extends Partial<C_Document> {\n    id: string;\n    isDel: boolean;\n    createdAt: string | Date;\n    updatedAt: string | Date;\n}\n\nexport type T_Omit_Create = 'id' | 'isDel' | 'createdAt' | 'updatedAt';\n\nexport type T_Omit_Update = 'id' | 'createdAt' | 'updatedAt';\n\ninterface I_VirtualNestedOptions {\n    [key: string]: I_VirtualNestedOptions | number | string | boolean;\n}\n\n/**\n * Function type for dynamically determining the reference model name.\n * Can return either a string (model name) or an enum value that represents the model.\n * The function can also return undefined, which will be handled gracefully.\n * This allows for optional properties in documents without requiring non-null assertions.\n *\n * @template T - The document type\n * @template R - The return type (string or enum)\n */\ntype T_DynamicRefFunction<T = unknown, R extends string = string> = (doc: T) => R | undefined;\n\ninterface I_VirtualBaseOptions {\n    localField: string;\n    foreignField: string;\n    count?: boolean;\n    justOne?: boolean;\n    options?: I_VirtualNestedOptions;\n}\n\ninterface I_VirtualOptions extends I_VirtualBaseOptions {\n    ref: string;\n}\n\nexport interface I_DynamicVirtualOptions<T, R extends string = string> extends I_VirtualBaseOptions {\n    ref: T_DynamicRefFunction<T, R>;\n}\n\nexport type T_VirtualOptions<T, R extends string = string> = I_VirtualOptions | I_DynamicVirtualOptions<T, R>;\n\nexport interface I_DynamicVirtualConfig<T, R extends string = string> {\n    name: string;\n    options: I_DynamicVirtualOptions<T, R>;\n}\n\ninterface I_MongooseOptions<T, R extends string = string> {\n    mongoose: typeof mongoose;\n    virtuals?: {\n        name: keyof T | string;\n        options?: T_VirtualOptions<T, R>;\n        get?: (this: T) => void;\n    }[];\n}\n\nexport interface I_CreateSchemaOptions<T, R extends string = string>\n    extends I_MongooseOptions<T, R> {\n    schema: T_Input_MongooseSchema<T>;\n    standalone?: boolean;\n}\n\nexport type T_MongooseMiddlewareMethod = string | RegExp;\n\nexport type T_MongooseMiddlewarePreFunction<T> = T_PreMiddlewareFunction<T> & T_PreSaveMiddlewareFunction<T>;\n\nexport type T_MongooseMiddlewarePostFunction<T> = T_PostMiddlewareFunction<T> & T_ErrorHandlingMiddlewareFunction<T> & T_ErrorHandlingMiddlewareWithOption<T>;\n\nexport interface I_MongooseModelMiddleware<T extends Partial<C_Document>> {\n    method: T_MongooseMiddlewareMethod;\n    pre?: T_MongooseMiddlewarePreFunction<T & T_QueryWithHelpers<T>>;\n    post?: T_MongooseMiddlewarePostFunction<T>;\n}\n\nexport interface I_CreateModelOptions<T extends Partial<C_Document>, R extends string = string>\n    extends I_MongooseOptions<T, R> {\n    schema: T_Input_MongooseSchema<T>;\n    name: string;\n    pagination?: boolean;\n    aggregate?: boolean;\n    middlewares?: I_MongooseModelMiddleware<T>[];\n}\n\nexport type T_Input_Populate = string | string[] | T_PopulateOptions | T_PopulateOptions[];\n\nexport interface I_PaginateOptionsWithPopulate\n    extends T_PaginateOptions,\n    Omit<T_PopulateOption, 'populate'> {\n    populate?: T_Input_Populate;\n}\n\nexport interface I_Input_FindOne<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    projection?: T_ProjectionType<T>;\n    options?: T_QueryOptions<T>;\n}\n\nexport interface I_Input_FindAll<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    projection?: T_ProjectionType<T>;\n    options?: T_QueryOptions<T>;\n}\n\nexport interface I_Input_FindPaging<T = undefined> {\n    filter?: T_QueryFilter<T>;\n    options?: I_PaginateOptionsWithPopulate;\n};\n\nexport interface I_Input_FindPagingAggregate {\n    pipeline: T_PipelineStage[];\n    options?: I_PaginateOptionsWithPopulate;\n}\n\nexport interface I_Input_CreateOne<T> {\n    doc: T;\n}\n\nexport interface I_Input_CreateMany<T> {\n    docs: T[];\n}\n\nexport interface I_UpdateOptionsExtended extends Omit<QueryOptions, 'session'> {\n    session?: ClientSession;\n}\n\nexport interface I_Input_UpdateOne<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    update: T_UpdateQuery<T>;\n    options?: I_UpdateOptionsExtended;\n}\n\nexport interface I_Input_UpdateMany<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    update: T_UpdateQuery<T>;\n    options?: I_UpdateOptionsExtended;\n}\n\nexport interface I_DeleteOptionsExtended extends Omit<QueryOptions, 'session'> {\n    session?: ClientSession;\n}\n\nexport interface I_Input_DeleteOne<T> {\n    filter: T_QueryFilter<T>;\n    options?: I_DeleteOptionsExtended;\n}\n\nexport interface I_Input_DeleteMany<T> {\n    filter: T_QueryFilter<T>;\n    options?: I_DeleteOptionsExtended;\n}\n\nexport interface I_InputSlug<T> {\n    field: string;\n    filter?: T_QueryFilter<T>;\n    haveHistory?: boolean;\n}\n\nexport interface I_Input_CreateSlug<T> extends I_InputSlug<T> {\n    from: T;\n}\n\nexport interface I_Input_CheckSlug<T> extends I_InputSlug<T> {\n    slug: string;\n    from: T;\n}\n\nexport interface I_Input_GenerateSlug<T> extends I_InputSlug<T> {\n    slug: string;\n    isObject: boolean;\n    haveHistory?: boolean;\n}\n"],"mappings":";;;AA0CA,IAAa,IAAb,cAA0B,EAAG,IAgBhB,IAAb,cAAgC,EAAS,IAE5B,IAAb,cAA6B,EAAM,IAEtB,IAAb,cAEU,EAAc"}
+{"version":3,"file":"mongo.type.js","names":[],"sources":["../../../src/node/mongo/mongo.type.ts"],"sourcesContent":["import type {\n    DeleteResult,\n    Filter,\n    InsertManyResult,\n    InsertOneResult,\n    OptionalUnlessRequiredId,\n    UpdateResult,\n    WithId,\n} from 'mongodb';\nimport type {\n    AggregatePaginateModel,\n    AggregatePaginateResult,\n    ClientSession,\n    ErrorHandlingMiddlewareFunction,\n    ErrorHandlingMiddlewareWithOption,\n    InsertManyOptions,\n    PaginateModel,\n    PaginateOptions,\n    PaginateResult,\n    PipelineStage,\n    PopulateOption,\n    PopulateOptions,\n    PostMiddlewareFunction,\n    PreMiddlewareFunction,\n    PreSaveMiddlewareFunction,\n    ProjectionType,\n    QueryFilter,\n    QueryOptions,\n    QueryWithHelpers,\n    Schema,\n    SchemaDefinition,\n    UpdateQuery,\n    UpdateWriteOpResult,\n} from 'mongoose';\nimport type mongoose from 'mongoose';\n\nimport { Collection, Db } from 'mongodb';\nimport {\n    Document,\n    Model,\n} from 'mongoose';\n\nexport class C_Db extends Db { }\n\nexport type T_Filter<T> = Filter<T>;\n\nexport type T_InsertOneResult<T> = InsertOneResult<T>;\n\nexport type T_InsertManyResult<T> = InsertManyResult<T>;\n\nexport type T_UpdateResult = UpdateResult | UpdateWriteOpResult;\n\nexport type T_DeleteResult = DeleteResult;\n\nexport type T_WithId<T> = WithId<T>;\n\nexport type T_OptionalUnlessRequiredId<T> = OptionalUnlessRequiredId<T>;\n\nexport class C_Document extends Document { }\n\nexport class C_Model extends Model { }\n\nexport class C_Collection<\n    T extends Partial<C_Document>,\n> extends Collection<T> { }\n\nexport interface I_ExtendedModel<T extends Partial<C_Document>>\n    extends Model<T>, PaginateModel<T>,\n    AggregatePaginateModel<T> { }\n\nexport type T_QueryFilter<T> = QueryFilter<T>;\n\nexport type T_ProjectionType<T> = ProjectionType<T>;\n\nexport type T_QueryOptions<T> = QueryOptions<T>;\n\nexport type T_PaginateOptions = PaginateOptions;\n\nexport type T_PopulateOption = PopulateOption;\n\nexport type T_PopulateOptions = PopulateOptions;\n\nexport type T_PipelineStage = PipelineStage;\n\nexport type T_PaginateResult<T> = PaginateResult<T>;\n\nexport type T_AggregatePaginateResult<T> = AggregatePaginateResult<T>;\n\nexport type T_InsertManyOptions = InsertManyOptions;\n\nexport type T_UpdateQuery<T> = UpdateQuery<T>;\n\nexport type T_QueryWithHelpers<T> = QueryWithHelpers<T, T>;\n\nexport type T_PreMiddlewareFunction<T> = PreMiddlewareFunction<T>;\n\nexport type T_PreSaveMiddlewareFunction<T> = PreSaveMiddlewareFunction<T>;\n\nexport type T_PostMiddlewareFunction<T> = PostMiddlewareFunction<T>;\n\nexport type T_ErrorHandlingMiddlewareFunction<T> = ErrorHandlingMiddlewareFunction<T>;\n\nexport type T_ErrorHandlingMiddlewareWithOption<T> = ErrorHandlingMiddlewareWithOption<T>;\n\nexport type T_MongooseSchema<T> = mongoose.Schema<T>;\n\nexport type T_Input_MongooseSchema<T> = SchemaDefinition<T>;\n\nexport type T_MongoosePlugin = (schema: Schema, options?: Record<string, unknown>) => void;\n\nexport interface I_GenericDocument extends Partial<C_Document> {\n    id: string;\n    isDel: boolean;\n    createdAt: string | Date;\n    updatedAt: string | Date;\n}\n\nexport type T_Omit_Create = 'id' | 'isDel' | 'createdAt' | 'updatedAt';\n\nexport type T_Omit_Update = 'id' | 'createdAt' | 'updatedAt';\n\ninterface I_VirtualNestedOptions {\n    [key: string]: I_VirtualNestedOptions | number | string | boolean;\n}\n\n/**\n * Function type for dynamically determining the reference model name.\n * Can return either a string (model name) or an enum value that represents the model.\n * The function can also return undefined, which will be handled gracefully.\n * This allows for optional properties in documents without requiring non-null assertions.\n *\n * @template T - The document type\n * @template R - The return type (string or enum)\n */\ntype T_DynamicRefFunction<T = unknown, R extends string = string> = (doc: T) => R | undefined;\n\ninterface I_VirtualBaseOptions {\n    localField: string;\n    foreignField: string;\n    count?: boolean;\n    justOne?: boolean;\n    options?: I_VirtualNestedOptions;\n}\n\ninterface I_VirtualOptions extends I_VirtualBaseOptions {\n    ref: string;\n}\n\nexport interface I_DynamicVirtualOptions<T, R extends string = string> extends I_VirtualBaseOptions {\n    ref: T_DynamicRefFunction<T, R>;\n}\n\nexport type T_VirtualOptions<T, R extends string = string> = I_VirtualOptions | I_DynamicVirtualOptions<T, R>;\n\nexport interface I_DynamicVirtualConfig<T, R extends string = string> {\n    name: string;\n    options: I_DynamicVirtualOptions<T, R>;\n}\n\ninterface I_MongooseOptions<T, R extends string = string> {\n    mongoose: typeof mongoose;\n    virtuals?: {\n        name: keyof T | string;\n        options?: T_VirtualOptions<T, R>;\n        get?: (this: T) => void;\n    }[];\n}\n\nexport interface I_CreateSchemaOptions<T, R extends string = string>\n    extends I_MongooseOptions<T, R> {\n    schema: T_Input_MongooseSchema<T>;\n    standalone?: boolean;\n}\n\nexport type T_MongooseMiddlewareMethod = string | RegExp;\n\nexport type T_MongooseMiddlewarePreFunction<T> = T_PreMiddlewareFunction<T> & T_PreSaveMiddlewareFunction<T>;\n\nexport type T_MongooseMiddlewarePostFunction<T> = T_PostMiddlewareFunction<T> & T_ErrorHandlingMiddlewareFunction<T> & T_ErrorHandlingMiddlewareWithOption<T>;\n\nexport interface I_MongooseModelMiddleware<T extends Partial<C_Document>> {\n    method: T_MongooseMiddlewareMethod;\n    pre?: T_MongooseMiddlewarePreFunction<T & T_QueryWithHelpers<T>>;\n    post?: T_MongooseMiddlewarePostFunction<T>;\n}\n\nexport interface I_CreateModelOptions<T extends Partial<C_Document>, R extends string = string>\n    extends I_MongooseOptions<T, R> {\n    schema: T_Input_MongooseSchema<T>;\n    name: string;\n    pagination?: boolean;\n    aggregate?: boolean;\n    middlewares?: I_MongooseModelMiddleware<T>[];\n}\n\nexport type T_Input_Populate = string | string[] | T_PopulateOptions | T_PopulateOptions[];\n\nexport interface I_PaginateOptionsWithPopulate\n    extends T_PaginateOptions,\n    Omit<T_PopulateOption, 'populate'> {\n    populate?: T_Input_Populate;\n}\n\nexport interface I_Input_FindOne<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    projection?: T_ProjectionType<T>;\n    options?: T_QueryOptions<T>;\n}\n\nexport interface I_Input_FindAll<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    projection?: T_ProjectionType<T>;\n    options?: T_QueryOptions<T>;\n}\n\nexport interface I_Input_FindPaging<T = undefined> {\n    filter?: T_QueryFilter<T>;\n    options?: I_PaginateOptionsWithPopulate;\n};\n\nexport interface I_Input_FindPagingAggregate {\n    pipeline: T_PipelineStage[];\n    options?: I_PaginateOptionsWithPopulate;\n}\n\nexport interface I_Input_CreateOne<T> {\n    doc: T;\n}\n\nexport interface I_Input_CreateMany<T> {\n    docs: T[];\n}\n\nexport interface I_UpdateOptionsExtended extends Omit<QueryOptions, 'session'> {\n    session?: ClientSession;\n}\n\nexport interface I_Input_UpdateOne<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    update: T_UpdateQuery<T>;\n    options?: I_UpdateOptionsExtended;\n}\n\nexport interface I_Input_UpdateMany<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    update: T_UpdateQuery<T>;\n    options?: I_UpdateOptionsExtended;\n}\n\nexport interface I_DeleteOptionsExtended extends Omit<QueryOptions, 'session'> {\n    session?: ClientSession;\n}\n\nexport interface I_Input_DeleteOne<T> {\n    filter: T_QueryFilter<T>;\n    options?: I_DeleteOptionsExtended;\n}\n\nexport interface I_Input_DeleteMany<T> {\n    filter: T_QueryFilter<T>;\n    options?: I_DeleteOptionsExtended;\n}\n\nexport interface I_InputSlug<T> {\n    field: string;\n    filter?: T_QueryFilter<T>;\n    haveHistory?: boolean;\n}\n\nexport interface I_Input_CreateSlug<T> extends I_InputSlug<T> {\n    from: T;\n}\n\nexport interface I_Input_CheckSlug<T> extends I_InputSlug<T> {\n    slug: string;\n    from: T;\n}\n\nexport interface I_Input_GenerateSlug<T> extends I_InputSlug<T> {\n    slug: string;\n    isObject: boolean;\n    haveHistory?: boolean;\n}\n"],"mappings":";;;AA0CA,IAAa,IAAb,cAA0B,EAAG,IAgBhB,IAAb,cAAgC,EAAS,IAE5B,IAAb,cAA6B,EAAM,IAEtB,IAAb,cAEU,EAAc"}

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

@@ -1,7 +1,7 @@
 import { default as migrate } from 'migrate-mongo';
 import { default as mongooseRaw } from 'mongoose';
 import { MongoController } from './mongo.controller.js';
-import { C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_MongooseModelMiddleware, T_MongoosePlugin, T_MongooseShema, T_QueryFilter, T_VirtualOptions, T_WithId } from './mongo.type.js';
+import { C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_MongooseModelMiddleware, T_MongoosePlugin, T_MongooseSchema, 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'.
@@ -16,10 +16,10 @@ export declare function convertEnumToModelName(enumValue: string): string;
  */
 interface I_MongoUtils {
     createGenericFields: () => I_GenericDocument;
-    applyPlugins: <T>(schema: T_MongooseShema<T>, plugins: Array<T_MongoosePlugin | false>) => void;
-    applyMiddlewares: <T extends Partial<C_Document>>(schema: T_MongooseShema<T>, middlewares: I_MongooseModelMiddleware<T>[]) => void;
-    createGenericSchema: (mongoose: typeof mongooseRaw) => T_MongooseShema<I_GenericDocument>;
-    createSchema: <T, R extends string = string>(options: I_CreateSchemaOptions<T, R>) => T_MongooseShema<T>;
+    applyPlugins: <T>(schema: T_MongooseSchema<T>, plugins: Array<T_MongoosePlugin | false>) => void;
+    applyMiddlewares: <T extends Partial<C_Document>>(schema: T_MongooseSchema<T>, middlewares: I_MongooseModelMiddleware<T>[]) => void;
+    createGenericSchema: (mongoose: typeof mongooseRaw) => T_MongooseSchema<I_GenericDocument>;
+    createSchema: <T, R extends string = string>(options: I_CreateSchemaOptions<T, R>) => T_MongooseSchema<T>;
     createModel: <T extends Partial<C_Document>, R extends string = string>(options: I_CreateModelOptions<T, R>) => I_ExtendedModel<T>;
     validator: {
         isRequired: <T>() => (this: T, value: unknown) => Promise<boolean>;
@@ -40,8 +40,8 @@ interface I_MongoUtils {
     };
     regexify: <T>(filter?: T_QueryFilter<T>, fields?: (keyof T | string)[]) => T_QueryFilter<T>;
     isDynamicVirtual: <T, R extends string>(options?: T_VirtualOptions<T, R>) => options is I_DynamicVirtualOptions<T, R>;
-    getNewRecords: <T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean) => Promise<T[]>;
-    getExistingRecords: <T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean) => Promise<T_WithId<T>[]>;
+    getNewRecords: <T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean, filter?: Record<string, unknown>) => Promise<T[]>;
+    getExistingRecords: <T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean, filter?: Record<string, unknown>) => Promise<T_WithId<T>[]>;
 }
 /**
  * MongoDB utility object providing comprehensive database operations and utilities.