@cyberskill/shared 2.28.0 → 3.1.0

package/dist/node/mongo/mongo.util.js

@@ -1,39 +1,15 @@
-import C from "migrate-mongo";
-import k from "mongoose-aggregate-paginate-v2";
-import U from "mongoose-paginate-v2";
-import { randomUUID as I } from "node:crypto";
-import { deepClone as q, getNestedValue as B, setNestedValue as J } from "../../util/object/object.util.js";
-import { regexSearchMapper as K } from "../../util/common/common.util.js";
-import { writeFileSync as L, addGitIgnoreEntry as H } from "../fs/fs.util.js";
-import { PATH as V, MIGRATE_MONGO_CONFIG as z } from "../path/path.constant.js";
-import { validate as Q } from "../../util/validate/validate.util.js";
-var W = Object.defineProperty, X = Object.defineProperties, Y = Object.getOwnPropertyDescriptors, x = Object.getOwnPropertySymbols, Z = Object.prototype.hasOwnProperty, T = Object.prototype.propertyIsEnumerable, $ = (t, e, i) => e in t ? W(t, e, { enumerable: !0, configurable: !0, writable: !0, value: i }) : t[e] = i, M = (t, e) => {
-  for (var i in e || (e = {}))
-    Z.call(e, i) && $(t, i, e[i]);
-  if (x)
-    for (var i of x(e))
-      T.call(e, i) && $(t, i, e[i]);
-  return t;
-}, tt = (t, e) => X(t, Y(e)), w = (t, e, i) => new Promise((n, r) => {
-  var o = (s) => {
-    try {
-      y(i.next(s));
-    } catch (h) {
-      r(h);
-    }
-  }, l = (s) => {
-    try {
-      y(i.throw(s));
-    } catch (h) {
-      r(h);
-    }
-  }, y = (s) => s.done ? n(s.value) : Promise.resolve(s.value).then(o, l);
-  y((i = i.apply(t, e)).next());
-});
-function P(t) {
-  return t === t.toUpperCase() ? t.charAt(0).toUpperCase() + t.slice(1).toLowerCase() : t;
+import m from "mongoose-aggregate-paginate-v2";
+import p from "mongoose-paginate-v2";
+import { randomUUID as f } from "node:crypto";
+import { deepClone as y, getNestedValue as g, setNestedValue as h } from "../../util/object/object.util.js";
+import { regexSearchMapper as w } from "../../util/common/common.util.js";
+import { writeFileSync as S, addGitIgnoreEntry as E } from "../fs/fs.util.js";
+import { PATH as d, MIGRATE_MONGO_CONFIG as R } from "../path/path.constant.js";
+import { validate as x } from "../../util/validate/validate.util.js";
+function I(e) {
+  return e === e.toUpperCase() ? e.charAt(0).toUpperCase() + e.slice(1).toLowerCase() : e;
 }
-const A = {
+const l = {
   /**
    * Creates generic fields that are commonly used across MongoDB documents.
    * This function generates standard fields including a UUID, deletion flag, and timestamps
@@ -43,7 +19,7 @@ const A = {
    */
   createGenericFields() {
     return {
-      id: I(),
+      id: f(),
       isDel: !1,
       createdAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
@@ -57,8 +33,8 @@ const A = {
    * @param schema - The Mongoose schema to apply plugins to.
    * @param plugins - An array of plugin functions or false values to filter and apply.
    */
-  applyPlugins(t, e) {
-    e.filter((i) => typeof i == "function").forEach((i) => t.plugin(i));
+  applyPlugins(e, r) {
+    r.filter((t) => typeof t == "function").forEach((t) => e.plugin(t));
   },
   /**
    * Applies middleware functions to a Mongoose schema.
@@ -67,9 +43,9 @@ const A = {
    * @param schema - The Mongoose schema to apply middleware to.
    * @param middlewares - An array of middleware configurations with method, pre, and post functions.
    */
-  applyMiddlewares(t, e) {
-    e.forEach(({ method: i, pre: n, post: r }) => {
-      i && n && t.pre(i, n), i && r && t.post(i, r);
+  applyMiddlewares(e, r) {
+    r.forEach(({ method: t, pre: n, post: i }) => {
+      t && n && e.pre(t, n), t && i && e.post(t, i);
     });
   },
   /**
@@ -80,10 +56,10 @@ const A = {
    * @param mongoose - The Mongoose instance to create the schema with.
    * @returns A Mongoose schema with generic document fields.
    */
-  createGenericSchema(t) {
-    return new t.Schema(
+  createGenericSchema(e) {
+    return new e.Schema(
       {
-        id: { type: String, default: () => I(), unique: !0 },
+        id: { type: String, default: () => f(), unique: !0 },
         isDel: { type: Boolean, default: !1 }
       },
       { timestamps: !0 }
@@ -102,34 +78,33 @@ const A = {
    * @returns A configured Mongoose schema.
    */
   createSchema({
-    mongoose: t,
-    schema: e,
-    virtuals: i = [],
+    mongoose: e,
+    schema: r,
+    virtuals: t = [],
     standalone: n = !1
   }) {
-    const r = new t.Schema(e, {
+    const i = new e.Schema(r, {
       toJSON: { virtuals: !0 },
       // So `res.json()` and other `JSON.stringify()` functions include virtuals
       toObject: { virtuals: !0 }
       // So `console.log()` and other functions that use `toObject()` include virtuals
     });
-    return i.forEach(({ name: o, options: l, get: y }) => {
-      if (A.isDynamicVirtual(l)) {
-        const s = r.statics;
-        s._dynamicVirtuals || (s._dynamicVirtuals = []), s._dynamicVirtuals.push({
-          name: o,
-          options: l
+    return t.forEach(({ name: s, options: a, get: o }) => {
+      if (l.isDynamicVirtual(a)) {
+        const c = i.statics;
+        c._dynamicVirtuals || (c._dynamicVirtuals = []), c._dynamicVirtuals.push({
+          name: s,
+          options: a
         });
-        const h = r.virtual(o);
-        y ? h.get(y) : h.get(function() {
-          var u;
-          return ((u = this._populated) == null ? void 0 : u[o]) || (l != null && l.count ? 0 : l != null && l.justOne ? null : []);
+        const u = i.virtual(s);
+        o ? u.get(o) : u.get(function() {
+          return this._populated?.[s] || (a?.count ? 0 : a?.justOne ? null : []);
         });
       } else {
-        const s = r.virtual(o, l);
-        y && s.get(y);
+        const c = i.virtual(s, a);
+        o && c.get(o);
       }
-    }), n || r.add(A.createGenericSchema(t)), r;
+    }), n || i.add(l.createGenericSchema(e)), i;
   },
   /**
    * Creates a Mongoose model with plugins, middleware, and pagination support.
@@ -148,25 +123,25 @@ const A = {
    * @throws {Error} When the model name is not provided.
    */
   createModel({
-    mongoose: t,
-    name: e,
-    schema: i,
+    mongoose: e,
+    name: r,
+    schema: t,
     virtuals: n = [],
-    pagination: r = !0,
-    aggregate: o = !0,
-    middlewares: l = []
+    pagination: i = !0,
+    aggregate: s = !0,
+    middlewares: a = []
   }) {
-    if (!e)
+    if (!r)
       throw new Error("Model name is required.");
-    if (t.models[e])
-      return t.models[e];
-    const y = A.createSchema({ mongoose: t, schema: i, virtuals: n });
-    (r || o) && A.applyPlugins(y, [
-      r && U,
-      o && k
-    ]), A.applyMiddlewares(y, l);
-    const s = t.model(e, y);
-    return n.length > 0 && (s._virtualConfigs = n), s;
+    if (e.models[r])
+      return e.models[r];
+    const o = l.createSchema({ mongoose: e, schema: t, virtuals: n });
+    (i || s) && l.applyPlugins(o, [
+      i && p,
+      s && m
+    ]), l.applyMiddlewares(o, a);
+    const c = e.model(r, o);
+    return n.length > 0 && (c._virtualConfigs = n), c;
   },
   /**
    * Validation utilities for Mongoose schemas.
@@ -181,10 +156,8 @@ const A = {
      * @returns A validation function that returns true if the field is not empty.
      */
     isRequired() {
-      return function(t) {
-        return w(this, null, function* () {
-          return !Q.isEmpty(t);
-        });
+      return async function(e) {
+        return !x.isEmpty(e);
       };
     },
     /**
@@ -196,14 +169,12 @@ const A = {
      * @returns A validation function that returns true if the value is unique across the specified fields.
      * @throws {Error} When fields is not a non-empty array of strings.
      */
-    isUnique(t) {
-      return function(e) {
-        return w(this, null, function* () {
-          if (!Array.isArray(t) || t.length === 0)
-            throw new Error("Fields must be a non-empty array of strings.");
-          const i = { $or: t.map((r) => ({ [r]: e })) };
-          return !(yield this.constructor.exists(i));
-        });
+    isUnique(e) {
+      return async function(r) {
+        if (!Array.isArray(e) || e.length === 0)
+          throw new Error("Fields must be a non-empty array of strings.");
+        const t = { $or: e.map((i) => ({ [i]: r })) };
+        return !await this.constructor.exists(t);
       };
     },
     /**
@@ -215,19 +186,28 @@ const A = {
      * @returns A validation function that returns true if the value matches all regex patterns.
      * @throws {Error} When regexArray is not an array of valid RegExp objects.
      */
-    matchesRegex(t) {
-      return (e) => w(null, null, function* () {
-        if (!Array.isArray(t) || t.some((i) => !(i instanceof RegExp)))
+    matchesRegex(e) {
+      return async (r) => {
+        if (!Array.isArray(e) || e.some((t) => !(t instanceof RegExp)))
           throw new Error("regexArray must be an array of valid RegExp objects.");
-        return t.every((i) => i.test(e));
-      });
+        return e.every((t) => t.test(r));
+      };
     }
   },
   /**
    * Migration utilities for MongoDB.
    * This object extends the migrate-mongo library with additional configuration utilities.
    */
-  migrate: tt(M({}, C), {
+  migrate: {
+    /**
+     * Lazily loads the migrate-mongo module to avoid eager import overhead.
+     * Use this to access migrate-mongo methods (up, down, status, create) programmatically.
+     *
+     * @returns A promise resolving to the migrate-mongo module.
+     */
+    async getModule() {
+      return (await import("migrate-mongo")).default;
+    },
     /**
      * Sets the migration configuration and updates .gitignore.
      * This function creates a migration configuration file and ensures it's properly
@@ -235,12 +215,12 @@ const A = {
      *
      * @param options - Migration configuration options to write to the config file.
      */
-    setConfig: (t) => {
-      const e = `// This file is automatically generated by the Cyberskill CLI.
-module.exports = ${JSON.stringify(t, null, 4)}`;
-      L(V.MIGRATE_MONGO_CONFIG, e), H(V.GIT_IGNORE, z);
+    setConfig: (e) => {
+      const r = `// This file is automatically generated by the Cyberskill CLI.
+module.exports = ${JSON.stringify(e, null, 4)}`;
+      S(d.MIGRATE_MONGO_CONFIG, r), E(d.GIT_IGNORE, R);
     }
-  }),
+  },
   /**
    * Converts string values in a filter to regex patterns for case-insensitive search.
    * This function recursively processes a filter object and converts string values in specified fields
@@ -250,23 +230,23 @@ module.exports = ${JSON.stringify(t, null, 4)}`;
    * @param fields - An array of field names to convert to regex patterns.
    * @returns A new filter object with string values converted to regex patterns.
    */
-  regexify(t, e) {
-    if (!t)
+  regexify(e, r) {
+    if (!e)
       return {};
-    let i = q(t);
-    if (!e || e.length === 0)
-      return i;
-    for (const n of e) {
-      const r = n.toString().split("."), o = B(i, r);
-      if (typeof o == "string" && o.length > 0) {
-        const l = {
-          $regex: `.*${K(o)}.*`,
+    let t = y(e);
+    if (!r || r.length === 0)
+      return t;
+    for (const n of r) {
+      const i = n.toString().split("."), s = g(t, i);
+      if (typeof s == "string" && s.length > 0) {
+        const a = {
+          $regex: `.*${w(s)}.*`,
           $options: "i"
         };
-        i = J(i, r, l);
+        t = h(t, i, a);
       }
     }
-    return i;
+    return t;
   },
   /**
    * Checks if a virtual options object has a dynamic ref function.
@@ -274,8 +254,8 @@ module.exports = ${JSON.stringify(t, null, 4)}`;
    * @param options - The virtual options to check.
    * @returns True if the options contain a dynamic ref function.
    */
-  isDynamicVirtual(t) {
-    return !!(t && typeof t.ref == "function");
+  isDynamicVirtual(e) {
+    return !!(e && typeof e.ref == "function");
   },
   /**
    * Generic utility function to get new records from the database
@@ -284,15 +264,13 @@ module.exports = ${JSON.stringify(t, null, 4)}`;
    * @param filterFn - Function to determine if a record already exists
    * @returns Array of records that don't exist in the database
    */
-  getNewRecords(t, e, i) {
-    return w(this, null, function* () {
-      const n = yield t.findAll({});
-      return n.success ? e.filter(
-        (o) => !n.result.some(
-          (l) => i(l, o)
-        )
-      ) : e;
-    });
+  async getNewRecords(e, r, t) {
+    const n = await e.findAll({});
+    return n.success ? r.filter(
+      (s) => !n.result.some(
+        (a) => t(a, s)
+      )
+    ) : r;
   },
   /**
    * Generic utility function to get existing records that match the filter criteria
@@ -301,293 +279,17 @@ module.exports = ${JSON.stringify(t, null, 4)}`;
    * @param filterFn - Function to determine if a record exists
    * @returns Array of existing records that match the filter criteria
    */
-  getExistingRecords(t, e, i) {
-    return w(this, null, function* () {
-      const n = yield t.findAll({});
-      return n.success ? n.result.filter(
-        (o) => e.some(
-          (l) => i(o, l)
-        )
-      ) : [];
-    });
+  async getExistingRecords(e, r, t) {
+    const n = await e.findAll({});
+    return n.success ? n.result.filter(
+      (s) => r.some(
+        (a) => t(s, a)
+      )
+    ) : [];
   }
 };
-function D(t, e, i, n, r) {
-  return w(this, null, function* () {
-    if (!e.length || !i)
-      return e;
-    const o = Array.isArray(i) ? i : [i];
-    for (const l of o)
-      typeof l == "string" ? yield G(t, e, l, n, r) : l && typeof l == "object" && (yield et(t, e, l, n, r));
-    return e;
-  });
-}
-function G(t, e, i, n, r) {
-  return w(this, null, function* () {
-    var o, l, y, s;
-    const h = i.split(".");
-    if (h.length < 2) {
-      for (const m of e)
-        yield F(t, m, i, n, void 0, r);
-      return;
-    }
-    const u = h[0];
-    if (!u || u.trim() === "")
-      return;
-    const R = h.slice(1).join(".");
-    for (const m of e) {
-      const j = m, O = j[u];
-      if (O && typeof O == "object") {
-        let c = r;
-        const a = c;
-        if (r && r.schema && r.schema.virtuals) {
-          const f = r.schema.virtuals[u];
-          if (f && f.options && f.options.ref) {
-            let b;
-            if (typeof f.options.ref == "function" ? b = f.options.ref(j) : typeof f.options.ref == "string" && (b = f.options.ref), b) {
-              const p = P(b);
-              t.models[p] && (c = t.models[p]);
-            }
-          }
-        }
-        if (!c) {
-          const f = (l = (o = r == null ? void 0 : r.schema) == null ? void 0 : o.statics) != null ? l : {}, p = ((r == null ? void 0 : r._virtualConfigs) || f._dynamicVirtuals || []).find((d) => d.name === u);
-          if (p && p.options && p.options.ref) {
-            let d;
-            if (typeof p.options.ref == "function" ? d = p.options.ref(j) : typeof p.options.ref == "string" && (d = p.options.ref), d) {
-              const g = P(d);
-              t.models[g] && (c = t.models[g]);
-            }
-          }
-        }
-        if (c === a) {
-          const f = (s = (y = r == null ? void 0 : r.schema) == null ? void 0 : y.statics) != null ? s : {}, p = ((r == null ? void 0 : r._virtualConfigs) || f._dynamicVirtuals || []).find((d) => d.name === u);
-          if (p && p.options && p.options.ref) {
-            let d;
-            if (typeof p.options.ref == "function" ? d = p.options.ref(j) : typeof p.options.ref == "string" && (d = p.options.ref), d) {
-              const g = P(d);
-              t.models[g] && (c = t.models[g]);
-            }
-          }
-        }
-        if (Array.isArray(O))
-          for (const f of O)
-            f && typeof f == "object" && (yield F(t, f, R, n, u, c));
-        else O && typeof O == "object" && (yield F(t, O, R, n, u, c));
-      }
-    }
-  });
-}
-function et(t, e, i, n, r) {
-  return w(this, null, function* () {
-    const { path: o, populate: l } = i;
-    if (!o)
-      return;
-    if (!l) {
-      yield G(t, e, o, n, r);
-      return;
-    }
-    const y = o;
-    for (const s of e) {
-      const h = s, u = h[y];
-      let R = r;
-      if (r && r.schema && r.schema.virtuals) {
-        const m = r.schema.virtuals[y];
-        if (m && m.options && m.options.ref) {
-          let j;
-          if (typeof m.options.ref == "function" ? j = m.options.ref(h) : typeof m.options.ref == "string" && (j = m.options.ref), j) {
-            const O = P(j);
-            t.models[O] && (R = t.models[O]);
-          }
-        }
-      }
-      if (!R && typeof u == "object" && u && "entityType" in u) {
-        const m = P(String(u.entityType));
-        t.models[m] && (R = t.models[m]);
-      }
-      if (u && typeof u == "object")
-        if (Array.isArray(u))
-          for (const m of u)
-            m && typeof m == "object" && (yield D(t, [m], l, n, R));
-        else u && typeof u == "object" && (yield D(t, [u], l, n, R));
-    }
-  });
-}
-function E(t, e, i, n) {
-  if (!i || !e || !e.schema)
-    return;
-  const r = i.split(".");
-  let o = e.schema;
-  for (let l = 0; l < r.length; l++) {
-    const y = r[l];
-    if (o && o.virtuals && y) {
-      const s = o.virtuals[y];
-      if (s && s.options && s.options.ref) {
-        let h;
-        if (typeof s.options.ref == "function" ? h = s.options.ref(n) : typeof s.options.ref == "string" && (h = s.options.ref), h && typeof h == "string") {
-          if (l === r.length - 1)
-            return h;
-          const u = t.models[h];
-          if (u && u.schema) {
-            o = u.schema;
-            continue;
-          }
-        }
-      }
-    }
-    if (o && o.paths && y) {
-      const s = o.paths[y];
-      if (s && s.schema) {
-        o = s.schema;
-        continue;
-      }
-    }
-    return;
-  }
-}
-function it(t, e) {
-  if (e)
-    for (const i of Object.keys(t.models)) {
-      const n = t.models[i], r = n == null ? void 0 : n.schema;
-      if (r && (r.paths && r.paths[e] || r.virtuals && r.virtuals[e]))
-        return n;
-    }
-}
-function rt(t, e) {
-  const i = (e || "").split(".")[0] || "";
-  if (i)
-    for (const n of Object.keys(t.models)) {
-      const r = t.models[n], o = r == null ? void 0 : r.schema;
-      if (o && (o.paths && o.paths[i] || o.virtuals && o.virtuals[i]))
-        return r;
-    }
-}
-function F(t, e, i, n, r, o) {
-  return w(this, null, function* () {
-    var l, y;
-    let s = e.__t;
-    if (!s) {
-      if (o) {
-        const c = r ? `${r}.${i}` : i, a = (c || "").split(".")[0] || "";
-        let f = o;
-        if (!!!((l = f == null ? void 0 : f.schema) != null && l.paths && f.schema.paths[a] || (y = f == null ? void 0 : f.schema) != null && y.virtuals && f.schema.virtuals[a])) {
-          const d = rt(t, c);
-          d && (f = d);
-        }
-        const p = E(t, f, c, e);
-        if (p)
-          s = p;
-        else {
-          const d = (c.includes(".") ? c.split(".").pop() : c) || "";
-          if (d) {
-            const g = it(t, d);
-            if (g) {
-              const N = E(t, g, c, e);
-              N && (s = N);
-            }
-          }
-        }
-      }
-      if (n && n.length > 0) {
-        const c = i.split(".").pop() || "", a = n.find((f) => f.name === c);
-        if (a && a.options.ref) {
-          let f;
-          typeof a.options.ref == "function" ? f = a.options.ref(e) : typeof a.options.ref == "string" && (f = a.options.ref), f && typeof f == "string" && (s = f);
-        }
-      }
-      if (!s) {
-        for (const [c, a] of Object.entries(e))
-          if (c === "entityType" && typeof a == "string") {
-            s = a;
-            break;
-          }
-        if (s && t.models[s]) {
-          const c = t.models[s];
-          if (c && c.schema) {
-            const a = c.schema, f = i.split(".").pop() || "", b = (d, g = "root") => {
-              if (!d || !d.virtuals)
-                return;
-              const N = d.virtuals;
-              for (const _ of Object.keys(N))
-                if (_ === f) {
-                  const v = N[_];
-                  if (v && v.options && v.options.ref) {
-                    let S;
-                    if (typeof v.options.ref == "function" ? S = v.options.ref(e) : typeof v.options.ref == "string" && (S = v.options.ref), S && typeof S == "string")
-                      return S;
-                  }
-                }
-              if (d.paths)
-                for (const _ of Object.keys(d.paths)) {
-                  const v = d.paths[_];
-                  if (v && v.schema) {
-                    const S = b(v.schema, `${g}.${_}`);
-                    if (S)
-                      return S;
-                  }
-                }
-            }, p = b(a);
-            p && (s = p);
-          }
-        }
-      }
-      if (!s) {
-        const c = i.split(".").pop() || "";
-        if (o && o.schema) {
-          const a = o.schema, f = (p, d = "root") => {
-            if (!p || !p.virtuals)
-              return;
-            const g = p.virtuals;
-            for (const N of Object.keys(g))
-              if (N === c) {
-                const _ = g[N];
-                if (_ && _.options && _.options.ref) {
-                  let v;
-                  if (typeof _.options.ref == "function" ? v = _.options.ref(e) : typeof _.options.ref == "string" && (v = _.options.ref), v && typeof v == "string")
-                    return v;
-                }
-              }
-            if (p.paths)
-              for (const N of Object.keys(p.paths)) {
-                const _ = p.paths[N];
-                if (_ && _.schema) {
-                  const v = f(_.schema, `${d}.${N}`);
-                  if (v)
-                    return v;
-                }
-              }
-          }, b = f(a);
-          b && (s = b);
-        }
-        if (!s && o) {
-          const a = E(t, o, i, e);
-          a && (s = a);
-        }
-        if (!s && n && n.length > 0) {
-          const a = n.find((f) => f.name === c);
-          if (a && a.options.ref) {
-            let f;
-            typeof a.options.ref == "function" ? f = a.options.ref(e) : typeof a.options.ref == "string" && (f = a.options.ref), f && typeof f == "string" && (s = f);
-          }
-        }
-      }
-      if (!s) {
-        const c = i.split(".").pop() || "", a = c ? c.charAt(0).toUpperCase() + c.slice(1) : "";
-        a && t.models[a] && (s = a);
-      }
-    }
-    const h = t.models[s];
-    if (!h)
-      return;
-    const u = `${i}Id`, R = `${i}Ids`, m = e[u] || e[R] || e[i];
-    if (!m)
-      return;
-    const j = Array.isArray(m) ? m : [m], O = yield h.find({ id: { $in: j } }).lean();
-    O.length > 0 && (Array.isArray(m) ? e[i] = O : e[i] = O[0]);
-  });
-}
 export {
-  D as applyNestedPopulate,
-  P as convertEnumToModelName,
-  A as mongo
+  I as convertEnumToModelName,
+  l as mongo
 };
+//# sourceMappingURL=mongo.util.js.map