@cyberskill/shared 2.28.0 → 3.1.0

package/dist/node/fs/fs.util.js

@@ -1,71 +1,57 @@
-import i from "fs-extra";
-import p from "node:path";
-var S = Object.defineProperty, c = Object.getOwnPropertySymbols, l = Object.prototype.hasOwnProperty, y = Object.prototype.propertyIsEnumerable, a = (n, r, e) => r in n ? S(n, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[r] = e, d = (n, r) => {
-  for (var e in r || (r = {}))
-    l.call(r, e) && a(n, e, r[e]);
-  if (c)
-    for (var e of c(r))
-      y.call(r, e) && a(n, e, r[e]);
-  return n;
-}, m = (n, r) => {
-  var e = {};
-  for (var t in n)
-    l.call(n, t) && r.indexOf(t) < 0 && (e[t] = n[t]);
-  if (n != null && c)
-    for (var t of c(n))
-      r.indexOf(t) < 0 && y.call(n, t) && (e[t] = n[t]);
-  return e;
-};
-const g = i, {
-  lstatSync: F,
-  readdirSync: b,
-  mkdirSync: j,
-  readFileSync: _,
-  unlinkSync: h,
-  statSync: v,
-  createWriteStream: J
-} = i, P = i.readJsonSync;
-function O(n, r, e) {
-  i.writeFileSync(n, r, e != null ? e : "utf-8");
+import c from "fs-extra";
+import y from "node:path";
+const l = c, {
+  lstatSync: m,
+  readdirSync: x,
+  mkdirSync: E,
+  readFileSync: f,
+  unlinkSync: F,
+  statSync: S,
+  createWriteStream: v
+} = c, g = c.readJsonSync;
+function u(n, t, e) {
+  c.writeFileSync(n, t, e ?? "utf-8");
 }
-function x(n, r, e) {
-  i.appendFileSync(n, r, e != null ? e : "utf-8");
+function p(n, t, e) {
+  c.appendFileSync(n, t, e ?? "utf-8");
 }
-function s(...n) {
-  return n.every((r) => i.pathExistsSync(r));
+function o(...n) {
+  return n.every((t) => c.pathExistsSync(t));
 }
-function C(...n) {
-  n.forEach((r) => {
-    s(r) && i.removeSync(r);
+function k(...n) {
+  n.forEach((t) => {
+    o(t) && c.removeSync(t);
   });
 }
-function D(n, r, e = {}) {
-  const t = e, { extensions: o } = t, u = m(t, ["extensions"]);
-  i.copySync(n, r, d({
-    filter: (f) => v(f).isDirectory() || !o || o.length === 0 ? !0 : o.includes(p.extname(f))
-  }, u));
+function w(n, t, e = {}) {
+  const { extensions: i, ...s } = e;
+  c.copySync(n, t, {
+    filter: (r) => S(r).isDirectory() || !i || i.length === 0 ? !0 : i.includes(y.extname(r)),
+    ...s
+  });
 }
-function G(n, r) {
+function J(n, t) {
   const e = `
-${r}
+${t}
 `;
-  s(n) ? _(n, "utf-8").split(`
-`).includes(r) || x(n, e) : O(n, e);
+  o(n) ? f(n, "utf-8").split(`
+`).includes(t) || p(n, e) : u(n, e);
 }
 export {
-  G as addGitIgnoreEntry,
-  x as appendFileSync,
-  D as copySync,
-  J as createWriteStream,
-  g as fs,
-  F as lstatSync,
-  j as mkdirSync,
-  s as pathExistsSync,
-  _ as readFileSync,
-  P as readJsonSync,
-  b as readdirSync,
-  C as removeSync,
-  v as statSync,
-  h as unlinkSync,
-  O as writeFileSync
+  J as addGitIgnoreEntry,
+  p as appendFileSync,
+  w as copySync,
+  v as createWriteStream,
+  l as fs,
+  m as lstatSync,
+  E as mkdirSync,
+  o as pathExistsSync,
+  f as readFileSync,
+  g as readJsonSync,
+  x as readdirSync,
+  k as removeSync,
+  S as statSync,
+  F as unlinkSync,
+  u as writeFileSync
 };
+//# sourceMappingURL=fs.util.js.map

package/dist/node/fs/fs.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.util.js","sources":["../../../src/node/fs/fs.util.ts"],"sourcesContent":["import fsExtra from 'fs-extra';\nimport path from 'node:path';\n\nimport type { I_CopySyncOptions } from './fs.type.js';\n\n/**\n * Re-export of the fs-extra module for file system operations.\n */\nexport const fs = fsExtra;\n\nexport const {\n    lstatSync,\n    readdirSync,\n    mkdirSync,\n    readFileSync,\n    unlinkSync,\n    statSync,\n    createWriteStream,\n} = fsExtra;\n\nexport const readJsonSync: typeof fsExtra.readJsonSync = fsExtra.readJsonSync;\n\n/**\n * Writes data to a file synchronously with UTF-8 encoding as default.\n * This function provides a simplified interface for writing files with automatic UTF-8 encoding\n * when no specific options are provided.\n *\n * @param file - The file path or file descriptor to write to.\n * @param data - The data to write to the file (string or Uint8Array).\n * @param options - Optional write file options (defaults to UTF-8 encoding).\n */\nexport function writeFileSync(file: fsExtra.PathOrFileDescriptor, data: string | Uint8Array, options?: fsExtra.WriteFileOptions): void {\n    fsExtra.writeFileSync(file, data, options ?? 'utf-8');\n}\n\n/**\n * Appends data to a file synchronously with UTF-8 encoding as default.\n * This function provides a simplified interface for appending to files with automatic UTF-8 encoding\n * when no specific options are provided.\n *\n * @param path - The file path or file descriptor to append to.\n * @param data - The data to append to the file (string or Uint8Array).\n * @param options - Optional write file options (defaults to UTF-8 encoding).\n */\nexport function appendFileSync(path: fsExtra.PathOrFileDescriptor, data: string | Uint8Array, options?: fsExtra.WriteFileOptions): void {\n    fsExtra.appendFileSync(path, data, options ?? 'utf-8');\n}\n\n/**\n * Checks if all specified paths exist synchronously.\n * This function verifies that every path in the provided array exists in the file system.\n * Returns true only if all paths exist, false if any path is missing.\n *\n * @param paths - An array of file or directory paths to check for existence.\n * @returns True if all paths exist, false if any path is missing.\n */\nexport function pathExistsSync(...paths: string[]) {\n    return paths.every(path => fsExtra.pathExistsSync(path));\n}\n\n/**\n * Removes files or directories synchronously if they exist.\n * This function safely removes multiple files or directories by checking for existence\n * before attempting removal, preventing errors for non-existent paths.\n *\n * @param paths - An array of file or directory paths to remove.\n */\nexport function removeSync(...paths: string[]) {\n    paths.forEach((filePath) => {\n        if (pathExistsSync(filePath)) {\n            fsExtra.removeSync(filePath);\n        }\n    });\n}\n\n/**\n * Copies files and directories synchronously with optional filtering.\n * This function copies files from source to destination with support for:\n * - Extension-based filtering (only copy files with specified extensions)\n * - Directory preservation (always copy directories regardless of extension filter)\n * - Additional copy options from fs-extra\n *\n * @param src - The source path to copy from.\n * @param dest - The destination path to copy to.\n * @param options - Optional copy configuration including extensions filter and other fs-extra options.\n */\nexport function copySync(src: string, dest: string, options: I_CopySyncOptions = {}): void {\n    const { extensions, ...rest } = options;\n\n    fsExtra.copySync(src, dest, {\n        filter: (srcPath: string) => {\n            if (statSync(srcPath).isDirectory()) {\n                return true;\n            }\n\n            if (!extensions || extensions.length === 0) {\n                return true;\n            }\n\n            return extensions.includes(path.extname(srcPath));\n        },\n        ...rest,\n    });\n}\n\n/**\n * Adds an entry to the .gitignore file if it doesn't already exist.\n * Creates the .gitignore file if it doesn't exist.\n *\n * @param gitIgnorePath - The absolute path to the .gitignore file.\n * @param entry - The entry name to add (e.g. '.agent', '.simple-git-hooks.json').\n */\nexport function addGitIgnoreEntry(gitIgnorePath: string, entry: string): void {\n    const gitIgnoreContent = `\\n${entry}\\n`;\n\n    if (pathExistsSync(gitIgnorePath)) {\n        const gitignore = readFileSync(gitIgnorePath, 'utf-8').split('\\n');\n\n        if (!gitignore.includes(entry)) {\n            appendFileSync(gitIgnorePath, gitIgnoreContent);\n        }\n    }\n    else {\n        writeFileSync(gitIgnorePath, gitIgnoreContent);\n    }\n}\n"],"names":["fsExtra","path","fs","lstatSync","readdirSync","mkdirSync","readFileSync","unlinkSync","statSync","createWriteStream","readJsonSync","writeFileSync","file","data","options","appendFileSync","pathExistsSync","paths","removeSync","filePath","copySync","src","dest","extensions","rest","srcPath","addGitIgnoreEntry","gitIgnorePath","entry","gitIgnoreContent"],"mappings":"AAQO,OAAAA,OAAA;AAAA,OAAAC,OAAA;AAAA,MAAMC,IAAKF,GAEL;AAAA,EACT,WAAAG;AAAA,EACA,aAAAC;AAAA,EACA,WAAAC;AAAA,EACA,cAAAC;AAAA,EACA,YAAAC;AAAA,EACA,UAAAC;AAAA,EACA,mBAAAC;AACJ,IAAIT,GAESU,IAA4CV,EAAQ;AAW1D,SAASW,EAAcC,GAAoCC,GAA2BC,GAA0C;AACnI,EAAAd,EAAQ,cAAcY,GAAMC,GAAMC,KAAW,OAAO;AACxD;AAWO,SAASC,EAAed,GAAoCY,GAA2BC,GAA0C;AACpI,EAAAd,EAAQ,eAAeC,GAAMY,GAAMC,KAAW,OAAO;AACzD;AAUO,SAASE,KAAkBC,GAAiB;AAC/C,SAAOA,EAAM,MAAM,CAAAhB,MAAQD,EAAQ,eAAeC,CAAI,CAAC;AAC3D;AASO,SAASiB,KAAcD,GAAiB;AAC3C,EAAAA,EAAM,QAAQ,CAACE,MAAa;AACxB,IAAIH,EAAeG,CAAQ,KACvBnB,EAAQ,WAAWmB,CAAQ;AAAA,EAEnC,CAAC;AACL;AAaO,SAASC,EAASC,GAAaC,GAAcR,IAA6B,CAAA,GAAU;AACvF,QAAM,EAAE,YAAAS,GAAY,GAAGC,EAAA,IAASV;AAEhC,EAAAd,EAAQ,SAASqB,GAAKC,GAAM;AAAA,IACxB,QAAQ,CAACG,MACDjB,EAASiB,CAAO,EAAE,iBAIlB,CAACF,KAAcA,EAAW,WAAW,IAC9B,KAGJA,EAAW,SAAStB,EAAK,QAAQwB,CAAO,CAAC;AAAA,IAEpD,GAAGD;AAAA,EAAA,CACN;AACL;AASO,SAASE,EAAkBC,GAAuBC,GAAqB;AAC1E,QAAMC,IAAmB;AAAA,EAAKD,CAAK;AAAA;AAEnC,EAAIZ,EAAeW,CAAa,IACVrB,EAAaqB,GAAe,OAAO,EAAE,MAAM;AAAA,CAAI,EAElD,SAASC,CAAK,KACzBb,EAAeY,GAAeE,CAAgB,IAIlDlB,EAAcgB,GAAeE,CAAgB;AAErD;"}

package/dist/node/fs/index.js

@@ -16,3 +16,4 @@ export {
   F as unlinkSync,
   f as writeFileSync
 };
+//# sourceMappingURL=index.js.map

package/dist/node/fs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/node/log/index.js

@@ -6,3 +6,4 @@ export {
   E as log,
   c as throwError
 };
+//# sourceMappingURL=index.js.map

package/dist/node/log/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/node/log/log.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/node/log/log.type.js

@@ -2,3 +2,4 @@ var n = /* @__PURE__ */ ((r) => (r.Error = "error", r.Warning = "warning", r))(n
 export {
   n as E_IssueType
 };
+//# sourceMappingURL=log.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.type.js","sources":["../../../src/node/log/log.type.ts"],"sourcesContent":["import type { I_Log as I_LogCommon } from '#typescript/index.js';\n\n/**\n * Enum representing the type of issues for logging and error handling.\n * - Error: Represents an error issue.\n * - Warning: Represents a warning issue.\n */\nexport enum E_IssueType {\n    Error = 'error',\n    Warning = 'warning',\n}\n\nexport interface I_IssueEntry {\n    type: E_IssueType;\n    file: string;\n    message: string;\n    position?: string;\n    rule?: string;\n}\n\nexport interface I_ThrowError {\n    message?: string;\n    status?: {\n        CODE: string | number;\n        MESSAGE: string;\n    };\n    type?: 'graphql' | 'rest';\n}\n\nexport interface I_Log extends I_LogCommon {\n    printBoxedLog: (\n        title: string,\n        issues: I_IssueEntry[],\n        color?: string,\n    ) => void;\n}\n\nexport interface I_CatchErrorOptions {\n    shouldLog?: boolean;\n    returnValue?: unknown;\n    callback?: (error: Error) => void;\n}\n"],"names":["E_IssueType"],"mappings":"AAOO,IAAKA,sBAAAA,OACRA,EAAA,QAAQ,SACRA,EAAA,UAAU,WAFFA,IAAAA,KAAA,CAAA,CAAA;"}

package/dist/node/log/log.util.js

@@ -1,24 +1,23 @@
-import c from "chalk";
+import l from "chalk";
 import r from "consola";
-import { GraphQLError as u } from "graphql";
-import { getEnv as h } from "../../config/env/env.util.js";
-import { RESPONSE_STATUS as s } from "../../constant/response-status.js";
-const R = h();
-function w({
-  message: o,
-  status: e = s.INTERNAL_SERVER_ERROR,
-  type: t = "graphql"
+import { GraphQLError as h } from "graphql";
+import { getEnv as u } from "../../config/env/env.util.js";
+import { RESPONSE_STATUS as f } from "../../constant/response-status.js";
+const R = u();
+function S({
+  message: e,
+  status: o = f.INTERNAL_SERVER_ERROR,
+  type: n = "graphql"
 }) {
-  var l;
-  const n = (l = o != null ? o : e.MESSAGE) != null ? l : "Internal server error";
-  throw t === "graphql" ? new u(n, {
-    extensions: { code: e.CODE }
-  }) : new Error(n);
+  const t = e ?? o.MESSAGE ?? "Internal server error";
+  throw n === "graphql" ? new h(t, {
+    extensions: { code: o.CODE }
+  }) : new Error(t);
 }
 R.DEBUG || (r.level = 4);
-function f(o) {
-  const e = c[o];
-  return typeof e == "function" ? e : c.green;
+function c(e) {
+  const o = l[e];
+  return typeof o == "function" ? o : l.green;
 }
 const m = {
   silent: r.silent,
@@ -47,27 +46,28 @@ const m = {
    * @param issues - An array of issue entries to display.
    * @param color - The color to use for highlighting (defaults to 'red').
    */
-  printBoxedLog(o, e, t = "red") {
-    if (!(e != null && e.length)) {
-      r.box(c.green(o));
+  printBoxedLog(e, o, n = "red") {
+    if (!o?.length) {
+      r.box(l.green(e));
       return;
     }
-    e.forEach(({ file: l, position: n, rule: a, message: g }) => {
-      const i = n ? `:${n}` : "", E = `${l}${i}`;
-      r.log(`${c.gray("File:")} ${c.blue(E)}`), a && r.log(`   ${f(t)("Rule:")} ${a}`), r.log(`   ${f(t)("Message:")} ${g}`);
-    }), r.box(f(t)(`${o} : ${e.length}`)), r.log(c.gray("─".repeat(40)));
+    o.forEach(({ file: t, position: s, rule: a, message: g }) => {
+      const i = s ? `:${s}` : "", E = `${t}${i}`;
+      r.log(`${l.gray("File:")} ${l.blue(E)}`), a && r.log(`   ${c(n)("Rule:")} ${a}`), r.log(`   ${c(n)("Message:")} ${g}`);
+    }), r.box(c(n)(`${e} : ${o.length}`)), r.log(l.gray("─".repeat(40)));
   }
 };
-function S(o, e) {
-  const { shouldLog: t = !0, returnValue: l, callback: n } = e != null ? e : {}, a = o instanceof Error ? o : new Error(typeof o == "string" ? o : "Unknown error");
-  return t && m.error(a.message), n && typeof n == "function" && n(a), l || {
+function v(e, o) {
+  const { shouldLog: n = !0, returnValue: t, callback: s } = o ?? {}, a = e instanceof Error ? e : new Error(typeof e == "string" ? e : "Unknown error");
+  return n && m.error(a.message), s && typeof s == "function" && s(a), t || {
     success: !1,
     message: a.message,
-    code: s.INTERNAL_SERVER_ERROR.CODE
+    code: f.INTERNAL_SERVER_ERROR.CODE
   };
 }
 export {
-  S as catchError,
+  v as catchError,
   m as log,
-  w as throwError
+  S as throwError
 };
+//# sourceMappingURL=log.util.js.map

package/dist/node/log/log.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.util.js","sources":["../../../src/node/log/log.util.ts"],"sourcesContent":["import type { ChalkInstance } from 'chalk';\n\nimport chalk from 'chalk';\nimport consola from 'consola';\nimport { GraphQLError } from 'graphql';\n\nimport type { I_Return } from '#typescript/index.js';\n\nimport { getEnv } from '#config/env/index.js';\nimport { RESPONSE_STATUS } from '#constant/index.js';\n\nimport type { I_CatchErrorOptions, I_IssueEntry, I_Log, I_ThrowError } from './log.type.js';\n\nconst env = getEnv();\n\n/**\n * Throws a standardized error with optional status information and type specification.\n * This function creates and throws errors that can be either GraphQL errors (with extensions)\n * or standard JavaScript errors, depending on the specified type.\n *\n * @param options - Error configuration including message, status information, and error type.\n * @param options.message - The error message to display.\n * @param options.status - The response status information (defaults to INTERNAL_SERVER_ERROR).\n * @param options.type - The type of error to throw ('graphql' or 'rest', defaults to 'graphql').\n * @throws {GraphQLError} When type is 'graphql', throws a GraphQL error with extensions.\n * @throws {Error} When type is 'rest' or unspecified, throws a standard JavaScript error.\n */\nexport function throwError({\n    message,\n    status = RESPONSE_STATUS.INTERNAL_SERVER_ERROR,\n    type = 'graphql',\n}: I_ThrowError): never {\n    const responseMessage\n        = message ?? status.MESSAGE ?? 'Internal server error';\n\n    if (type === 'graphql') {\n        throw new GraphQLError(responseMessage, {\n            extensions: { code: status.CODE },\n        });\n    }\n\n    else {\n        throw new Error(responseMessage);\n    }\n}\n\nif (!env.DEBUG) {\n    consola.level = 4;\n}\n\n/**\n * Gets a chalk color instance by keyword name.\n * This function safely retrieves a chalk color function by name, falling back to green\n * if the specified color is not available or invalid.\n *\n * @param color - The color keyword to get the chalk instance for.\n * @returns A chalk instance for the specified color, or green as fallback.\n */\nfunction chalkKeyword(color: string): ChalkInstance {\n    const chalkColor = chalk[color as keyof typeof chalk];\n\n    return typeof chalkColor === 'function' ? (chalkColor as ChalkInstance) : chalk.green;\n}\n\n/**\n * Enhanced logging interface that extends consola with custom functionality.\n * This object provides all standard consola logging methods plus additional features\n * like boxed log printing for structured error/warning display.\n */\nexport const log: I_Log = {\n    silent: consola.silent,\n    level: consola.level,\n    fatal: consola.fatal,\n    error: consola.error,\n    warn: consola.warn,\n    log: consola.log,\n    info: consola.info,\n    success: consola.success,\n    ready: consola.ready,\n    start: consola.start,\n    box: consola.box,\n    debug: consola.debug,\n    trace: consola.trace,\n    verbose: consola.verbose,\n    /**\n     * Prints a boxed log with structured issue information.\n     * This method displays issues (errors or warnings) in a formatted box with:\n     * - File paths and line/column positions\n     * - Rule violations (if applicable)\n     * - Error/warning messages\n     * - Color-coded output based on issue type\n     *\n     * @param title - The title to display in the box header.\n     * @param issues - An array of issue entries to display.\n     * @param color - The color to use for highlighting (defaults to 'red').\n     */\n    printBoxedLog(title: string, issues: I_IssueEntry[], color = 'red') {\n        if (!issues?.length) {\n            consola.box(chalk.green(title));\n            return;\n        }\n\n        issues.forEach(({ file, position, rule, message }) => {\n            const positionSuffix = position ? `:${position}` : '';\n            const filePath = `${file}${positionSuffix}`;\n            consola.log(`${chalk.gray('File:')} ${chalk.blue(filePath)}`);\n\n            if (rule) {\n                consola.log(`   ${chalkKeyword(color)('Rule:')} ${rule}`);\n            }\n\n            consola.log(`   ${chalkKeyword(color)('Message:')} ${message}`);\n        });\n\n        consola.box(chalkKeyword(color)(`${title} : ${issues.length}`));\n\n        consola.log(chalk.gray('─'.repeat(40)));\n    },\n};\n\n/**\n * Catches and handles errors with configurable behavior.\n * This function provides a standardized way to handle errors with options for:\n * - Logging control (whether to log the error)\n * - Return value specification (what to return on error)\n * - Custom callback execution (additional error handling)\n *\n * @param errorInput - The error to catch and handle.\n * @param options - Configuration options for error handling behavior.\n * @returns Either the specified return value or a standardized error response object.\n */\nexport function catchError<T = unknown>(errorInput: unknown, options: I_CatchErrorOptions & { returnValue: T }): T;\nexport function catchError<T = unknown>(errorInput: unknown, options?: I_CatchErrorOptions): I_Return<T>;\nexport function catchError<T = unknown>(errorInput: unknown, options?: I_CatchErrorOptions): I_Return<T> | T {\n    const { shouldLog = true, returnValue, callback } = options ?? {};\n\n    const error = errorInput instanceof Error\n        ? errorInput\n        : new Error(typeof errorInput === 'string' ? errorInput : 'Unknown error');\n\n    if (shouldLog) {\n        log.error(error.message);\n    }\n\n    if (callback && typeof callback === 'function') {\n        callback(error);\n    }\n\n    if (returnValue) {\n        return returnValue as T;\n    }\n\n    return {\n        success: false,\n        message: error.message,\n        code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n    };\n}\n"],"names":["env","getEnv","throwError","message","status","RESPONSE_STATUS","type","responseMessage","GraphQLError","consola","chalkKeyword","color","chalkColor","chalk","log","title","issues","file","position","rule","positionSuffix","filePath","catchError","errorInput","options","shouldLog","returnValue","callback","error"],"mappings":";;;;;AAaA,MAAMA,IAAMC,EAAA;AAcL,SAASC,EAAW;AAAA,EACvB,SAAAC;AAAA,EACA,QAAAC,IAASC,EAAgB;AAAA,EACzB,MAAAC,IAAO;AACX,GAAwB;AACpB,QAAMC,IACAJ,KAAWC,EAAO,WAAW;AAEnC,QAAIE,MAAS,YACH,IAAIE,EAAaD,GAAiB;AAAA,IACpC,YAAY,EAAE,MAAMH,EAAO,KAAA;AAAA,EAAK,CACnC,IAIK,IAAI,MAAMG,CAAe;AAEvC;AAEKP,EAAI,UACLS,EAAQ,QAAQ;AAWpB,SAASC,EAAaC,GAA8B;AAChD,QAAMC,IAAaC,EAAMF,CAA2B;AAEpD,SAAO,OAAOC,KAAe,aAAcA,IAA+BC,EAAM;AACpF;AAOO,MAAMC,IAAa;AAAA,EACtB,QAAQL,EAAQ;AAAA,EAChB,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,MAAMA,EAAQ;AAAA,EACd,KAAKA,EAAQ;AAAA,EACb,MAAMA,EAAQ;AAAA,EACd,SAASA,EAAQ;AAAA,EACjB,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,KAAKA,EAAQ;AAAA,EACb,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,SAASA,EAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAajB,cAAcM,GAAeC,GAAwBL,IAAQ,OAAO;AAChE,QAAI,CAACK,GAAQ,QAAQ;AACjB,MAAAP,EAAQ,IAAII,EAAM,MAAME,CAAK,CAAC;AAC9B;AAAA,IACJ;AAEA,IAAAC,EAAO,QAAQ,CAAC,EAAE,MAAAC,GAAM,UAAAC,GAAU,MAAAC,GAAM,SAAAhB,QAAc;AAClD,YAAMiB,IAAiBF,IAAW,IAAIA,CAAQ,KAAK,IAC7CG,IAAW,GAAGJ,CAAI,GAAGG,CAAc;AACzC,MAAAX,EAAQ,IAAI,GAAGI,EAAM,KAAK,OAAO,CAAC,IAAIA,EAAM,KAAKQ,CAAQ,CAAC,EAAE,GAExDF,KACAV,EAAQ,IAAI,MAAMC,EAAaC,CAAK,EAAE,OAAO,CAAC,IAAIQ,CAAI,EAAE,GAG5DV,EAAQ,IAAI,MAAMC,EAAaC,CAAK,EAAE,UAAU,CAAC,IAAIR,CAAO,EAAE;AAAA,IAClE,CAAC,GAEDM,EAAQ,IAAIC,EAAaC,CAAK,EAAE,GAAGI,CAAK,MAAMC,EAAO,MAAM,EAAE,CAAC,GAE9DP,EAAQ,IAAII,EAAM,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AAAA,EAC1C;AACJ;AAeO,SAASS,EAAwBC,GAAqBC,GAAgD;AACzG,QAAM,EAAE,WAAAC,IAAY,IAAM,aAAAC,GAAa,UAAAC,EAAA,IAAaH,KAAW,CAAA,GAEzDI,IAAQL,aAAsB,QAC9BA,IACA,IAAI,MAAM,OAAOA,KAAe,WAAWA,IAAa,eAAe;AAU7E,SARIE,KACAX,EAAI,MAAMc,EAAM,OAAO,GAGvBD,KAAY,OAAOA,KAAa,cAChCA,EAASC,CAAK,GAGdF,KAIG;AAAA,IACH,SAAS;AAAA,IACT,SAASE,EAAM;AAAA,IACf,MAAMvB,EAAgB,sBAAsB;AAAA,EAAA;AAEpD;"}

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

@@ -1,4 +1,6 @@
 export * from './mongo.constant.js';
 export * from './mongo.controller.js';
+export * from './mongo.dynamic-populate.js';
+export * from './mongo.populate.js';
 export * from './mongo.type.js';
 export * from './mongo.util.js';

package/dist/node/mongo/index.js

@@ -1,17 +1,26 @@
 import { MONGO_MIGRATE_OPTIONS as r, MONGO_SLUG_MAX_ATTEMPTS as t } from "./mongo.constant.js";
-import { MongoController as n, MongooseController as M } from "./mongo.controller.js";
-import { C_Collection as m, C_Db as p, C_Document as C, C_Model as O } from "./mongo.type.js";
-import { applyNestedPopulate as N, convertEnumToModelName as f, mongo as x } from "./mongo.util.js";
+import { filterDynamicVirtualsFromPopulate as m, isMongooseDoc as p, isObject as n, populateDynamicVirtuals as a, remapDynamicPopulate as M } from "./mongo.dynamic-populate.js";
+import { applyNestedPopulate as _ } from "./mongo.populate.js";
+import { C_Collection as f, C_Db as u, C_Document as s, C_Model as x } from "./mongo.type.js";
+import { convertEnumToModelName as O, mongo as D } from "./mongo.util.js";
+import { MongoController as N } from "./mongo.controller.native.js";
+import { MongooseController as g } from "./mongo.controller.mongoose.js";
 export {
-  m as C_Collection,
-  p as C_Db,
-  C as C_Document,
-  O as C_Model,
+  f as C_Collection,
+  u as C_Db,
+  s as C_Document,
+  x as C_Model,
   r as MONGO_MIGRATE_OPTIONS,
   t as MONGO_SLUG_MAX_ATTEMPTS,
-  n as MongoController,
-  M as MongooseController,
-  N as applyNestedPopulate,
-  f as convertEnumToModelName,
-  x as mongo
+  N as MongoController,
+  g as MongooseController,
+  _ as applyNestedPopulate,
+  O as convertEnumToModelName,
+  m as filterDynamicVirtualsFromPopulate,
+  p as isMongooseDoc,
+  n as isObject,
+  D as mongo,
+  a as populateDynamicVirtuals,
+  M as remapDynamicPopulate
 };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/dist/node/mongo/mongo.constant.js

@@ -3,3 +3,4 @@ export {
   O as MONGO_MIGRATE_OPTIONS,
   M as MONGO_SLUG_MAX_ATTEMPTS
 };
+//# sourceMappingURL=mongo.constant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.constant.js","sources":["../../../src/node/mongo/mongo.constant.ts"],"sourcesContent":["/**\n * Environment variable key for MongoDB migration options.\n * This constant defines the environment variable name that can be used to configure\n * MongoDB migration settings and options for database schema management.\n */\nexport const MONGO_MIGRATE_OPTIONS = 'MONGO_MIGRATE_OPTIONS';\n\n/**\n * Maximum number of attempts to generate a unique slug.\n * This constant defines the maximum number of attempts to generate a unique slug\n * before giving up and returning a fallback slug.\n */\nexport const MONGO_SLUG_MAX_ATTEMPTS = 100;\n"],"names":["MONGO_MIGRATE_OPTIONS","MONGO_SLUG_MAX_ATTEMPTS"],"mappings":"AAKO,MAAMA,IAAwB,yBAOxBC,IAA0B;"}