@cyberskill/shared 3.0.0 → 3.1.0

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

@@ -0,0 +1,269 @@
+import { convertEnumToModelName as F } from "./mongo.util.js";
+async function $(f, o, a, c, n) {
+  if (!o.length || !a)
+    return o;
+  const r = Array.isArray(a) ? a : [a];
+  for (const i of r)
+    typeof i == "string" ? await k(f, o, i, c, n) : i && typeof i == "object" && await I(f, o, i, c, n);
+  return o;
+}
+async function k(f, o, a, c, n) {
+  const r = a.split(".");
+  if (r.length < 2) {
+    for (const d of o)
+      await w(f, d, a, c, void 0, n);
+    return;
+  }
+  const i = r[0];
+  if (!i || i.trim() === "")
+    return;
+  const j = r.slice(1).join(".");
+  for (const d of o) {
+    const h = d, p = h[i];
+    if (p && typeof p == "object") {
+      let b = n;
+      const l = b;
+      if (n && n.schema && n.schema.virtuals) {
+        const s = n.schema.virtuals[i];
+        if (s && s.options && s.options.ref) {
+          let e;
+          if (typeof s.options.ref == "function" ? e = s.options.ref(h) : typeof s.options.ref == "string" && (e = s.options.ref), e) {
+            const t = F(e);
+            f.models[t] && (b = f.models[t]);
+          }
+        }
+      }
+      if (!b) {
+        const s = n?.schema?.statics ?? {}, t = (n?._virtualConfigs || s._dynamicVirtuals || []).find((y) => y.name === i);
+        if (t && t.options && t.options.ref) {
+          let y;
+          if (typeof t.options.ref == "function" ? y = t.options.ref(h) : typeof t.options.ref == "string" && (y = t.options.ref), y) {
+            const m = F(y);
+            f.models[m] && (b = f.models[m]);
+          }
+        }
+      }
+      if (b === l) {
+        const s = n?.schema?.statics ?? {}, t = (n?._virtualConfigs || s._dynamicVirtuals || []).find((y) => y.name === i);
+        if (t && t.options && t.options.ref) {
+          let y;
+          if (typeof t.options.ref == "function" ? y = t.options.ref(h) : typeof t.options.ref == "string" && (y = t.options.ref), y) {
+            const m = F(y);
+            f.models[m] && (b = f.models[m]);
+          }
+        }
+      }
+      if (Array.isArray(p))
+        for (const s of p)
+          s && typeof s == "object" && await w(f, s, j, c, i, b);
+      else p && typeof p == "object" && await w(f, p, j, c, i, b);
+    }
+  }
+}
+async function I(f, o, a, c, n) {
+  const { path: r, populate: i } = a;
+  if (!r)
+    return;
+  if (!i) {
+    await k(f, o, r, c, n);
+    return;
+  }
+  const j = r;
+  for (const d of o) {
+    const h = d, p = h[j];
+    let b = n;
+    if (n && n.schema && n.schema.virtuals) {
+      const l = n.schema.virtuals[j];
+      if (l && l.options && l.options.ref) {
+        let s;
+        if (typeof l.options.ref == "function" ? s = l.options.ref(h) : typeof l.options.ref == "string" && (s = l.options.ref), s) {
+          const e = F(s);
+          f.models[e] && (b = f.models[e]);
+        }
+      }
+    }
+    if (!b && typeof p == "object" && p && "entityType" in p) {
+      const l = F(String(p.entityType));
+      f.models[l] && (b = f.models[l]);
+    }
+    if (p && typeof p == "object")
+      if (Array.isArray(p))
+        for (const l of p)
+          l && typeof l == "object" && await $(f, [l], i, c, b);
+      else p && typeof p == "object" && await $(f, [p], i, c, b);
+  }
+}
+function R(f, o, a, c) {
+  if (!a || !o || !o.schema)
+    return;
+  const n = a.split(".");
+  let r = o.schema;
+  for (let i = 0; i < n.length; i++) {
+    const j = n[i];
+    if (r && r.virtuals && j) {
+      const d = r.virtuals[j];
+      if (d && d.options && d.options.ref) {
+        let h;
+        if (typeof d.options.ref == "function" ? h = d.options.ref(c) : typeof d.options.ref == "string" && (h = d.options.ref), h && typeof h == "string") {
+          if (i === n.length - 1)
+            return h;
+          const p = f.models[h];
+          if (p && p.schema) {
+            r = p.schema;
+            continue;
+          }
+        }
+      }
+    }
+    if (r && r.paths && j) {
+      const d = r.paths[j];
+      if (d && d.schema) {
+        r = d.schema;
+        continue;
+      }
+    }
+    return;
+  }
+}
+function S(f, o) {
+  if (o)
+    for (const a of Object.keys(f.models)) {
+      const c = f.models[a], n = c?.schema;
+      if (n && (n.paths && n.paths[o] || n.virtuals && n.virtuals[o]))
+        return c;
+    }
+}
+function _(f, o) {
+  const a = (o || "").split(".")[0] || "";
+  if (a)
+    for (const c of Object.keys(f.models)) {
+      const n = f.models[c], r = n?.schema;
+      if (r && (r.paths && r.paths[a] || r.virtuals && r.virtuals[a]))
+        return n;
+    }
+}
+async function w(f, o, a, c, n, r) {
+  let i = o.__t;
+  if (!i) {
+    if (r) {
+      const s = n ? `${n}.${a}` : a, e = (s || "").split(".")[0] || "";
+      let t = r;
+      if (!!!(t?.schema?.paths && t.schema.paths[e] || t?.schema?.virtuals && t.schema.virtuals[e])) {
+        const N = _(f, s);
+        N && (t = N);
+      }
+      const m = R(f, t, s, o);
+      if (m)
+        i = m;
+      else {
+        const N = (s.includes(".") ? s.split(".").pop() : s) || "";
+        if (N) {
+          const V = S(f, N);
+          if (V) {
+            const O = R(f, V, s, o);
+            O && (i = O);
+          }
+        }
+      }
+    }
+    if (c && c.length > 0) {
+      const s = a.split(".").pop() || "", e = c.find((t) => t.name === s);
+      if (e && e.options.ref) {
+        let t;
+        typeof e.options.ref == "function" ? t = e.options.ref(o) : typeof e.options.ref == "string" && (t = e.options.ref), t && typeof t == "string" && (i = t);
+      }
+    }
+    if (!i) {
+      for (const [s, e] of Object.entries(o))
+        if (s === "entityType" && typeof e == "string") {
+          i = e;
+          break;
+        }
+      if (i && f.models[i]) {
+        const s = f.models[i];
+        if (s && s.schema) {
+          const e = s.schema, t = a.split(".").pop() || "", y = (N, V = "root") => {
+            if (!N || !N.virtuals)
+              return;
+            const O = N.virtuals;
+            for (const v of Object.keys(O))
+              if (v === t) {
+                const u = O[v];
+                if (u && u.options && u.options.ref) {
+                  let A;
+                  if (typeof u.options.ref == "function" ? A = u.options.ref(o) : typeof u.options.ref == "string" && (A = u.options.ref), A && typeof A == "string")
+                    return A;
+                }
+              }
+            if (N.paths)
+              for (const v of Object.keys(N.paths)) {
+                const u = N.paths[v];
+                if (u && u.schema) {
+                  const A = y(u.schema, `${V}.${v}`);
+                  if (A)
+                    return A;
+                }
+              }
+          }, m = y(e);
+          m && (i = m);
+        }
+      }
+    }
+    if (!i) {
+      const s = a.split(".").pop() || "";
+      if (r && r.schema) {
+        const e = r.schema, t = (m, N = "root") => {
+          if (!m || !m.virtuals)
+            return;
+          const V = m.virtuals;
+          for (const O of Object.keys(V))
+            if (O === s) {
+              const v = V[O];
+              if (v && v.options && v.options.ref) {
+                let u;
+                if (typeof v.options.ref == "function" ? u = v.options.ref(o) : typeof v.options.ref == "string" && (u = v.options.ref), u && typeof u == "string")
+                  return u;
+              }
+            }
+          if (m.paths)
+            for (const O of Object.keys(m.paths)) {
+              const v = m.paths[O];
+              if (v && v.schema) {
+                const u = t(v.schema, `${N}.${O}`);
+                if (u)
+                  return u;
+              }
+            }
+        }, y = t(e);
+        y && (i = y);
+      }
+      if (!i && r) {
+        const e = R(f, r, a, o);
+        e && (i = e);
+      }
+      if (!i && c && c.length > 0) {
+        const e = c.find((t) => t.name === s);
+        if (e && e.options.ref) {
+          let t;
+          typeof e.options.ref == "function" ? t = e.options.ref(o) : typeof e.options.ref == "string" && (t = e.options.ref), t && typeof t == "string" && (i = t);
+        }
+      }
+    }
+    if (!i) {
+      const s = a.split(".").pop() || "", e = s ? s.charAt(0).toUpperCase() + s.slice(1) : "";
+      e && f.models[e] && (i = e);
+    }
+  }
+  const j = f.models[i];
+  if (!j)
+    return;
+  const d = `${a}Id`, h = `${a}Ids`, p = o[d] || o[h] || o[a];
+  if (!p)
+    return;
+  const b = Array.isArray(p) ? p : [p], l = await j.find({ id: { $in: b } }).lean();
+  l.length > 0 && (Array.isArray(p) ? o[a] = l : o[a] = l[0]);
+}
+export {
+  $ as applyNestedPopulate
+};
+//# sourceMappingURL=mongo.populate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.populate.js","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"],"names":["applyNestedPopulate","mongoose","documents","populateOptions","virtualConfigs","currentModel","populateArray","populateOption","applyStringPopulate","applyObjectPopulate","populatePath","pathParts","doc","populateNestedFieldOnParent","mainField","nestedPath","docObj","mainValue","nextModelForChildren","originalModelForChildren","virtual","refResult","modelName","convertEnumToModelName","schemaStatics","dyn","v","item","path","nestedPopulate","pathString","fieldValue","maybeModel","resolveModelFromPath","startModel","document","currentSchema","pathPart","nextModel","pathSchema","findModelBySchemaField","fieldName","Model","schema","findStartModelByFirstSegment","fullPath","first","pathPrefix","firstSegment","betterStart","resolvedFromPath","lastSegment","candidateModel","rerun","matchingVirtual","key","value","searchVirtualsInSchema","schemaToSearch","schemaPath","virtuals","virtualName","pathName","nestedResult","foundModelName","resolvedModel","candidate","fieldIdKey","fieldIdsKey","docIds","idsArray","populatedDocs"],"mappings":"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"}

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

@@ -14,3 +14,4 @@ export {
   m as C_Document,
   C as C_Model
 };
+//# sourceMappingURL=mongo.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.type.js","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"],"names":["C_Db","Db","C_Document","Document","C_Model","Model","C_Collection","Collection"],"mappings":";;AA0CO,MAAMA,UAAaC,EAAG;AAAE;AAgBxB,MAAMC,UAAmBC,EAAS;AAAE;AAEpC,MAAMC,UAAgBC,EAAM;AAAE;AAE9B,MAAMC,UAEHC,EAAc;AAAE;"}

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

@@ -0,0 +1,52 @@
+import { default as mongooseRaw } from 'mongoose';
+import { default as migrate } from 'migrate-mongo';
+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';
+/**
+ * Converts enum values to proper model names.
+ * Handles common naming conventions like converting 'USER' to 'User'.
+ *
+ * @param enumValue - The enum value to convert
+ * @returns The converted model name
+ */
+export declare function convertEnumToModelName(enumValue: string): string;
+/**
+ * Interface for the MongoDB utility object to enable explicit type annotation.
+ * Required to avoid TS7056 (inferred type exceeds maximum serialization length).
+ */
+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>(options: I_CreateSchemaOptions<T, R>): T_MongooseShema<T>;
+    createModel<T extends Partial<C_Document>, R extends string>(options: I_CreateModelOptions<T, R>): I_ExtendedModel<T>;
+    validator: {
+        isRequired<T>(): (this: T, value: unknown) => Promise<boolean>;
+        isUnique<T extends {
+            constructor: {
+                exists: (query: {
+                    [key: string]: unknown;
+                }) => Promise<unknown>;
+            };
+        }>(fields: string[]): (this: T, value: unknown) => Promise<boolean>;
+        matchesRegex(regexArray: RegExp[]): (value: string) => Promise<boolean>;
+    };
+    migrate: {
+        getModule(): Promise<typeof migrate>;
+        setConfig: (options: Partial<migrate.config.Config> & {
+            moduleSystem?: 'commonjs' | 'esm';
+        }) => void;
+    };
+    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>[]>;
+}
+/**
+ * MongoDB utility object providing comprehensive database operations and utilities.
+ * This object contains methods for creating generic fields, applying plugins and middlewares,
+ * creating schemas and models, validation functions, migration utilities, and regex filtering.
+ */
+export declare const mongo: I_MongoUtils;
+export { applyNestedPopulate } from './mongo.populate.js';