@cyberskill/shared 3.1.0 → 3.2.1

package/dist/node/command/command.util.js

@@ -1,61 +1,61 @@
-import { exec as P, execFile as I } from "node:child_process";
+import { exec as x, execFile as I } from "node:child_process";
 import m from "node:process";
-import * as $ from "node:util";
+import * as C from "node:util";
 import { storage as g } from "../storage/storage.util.js";
-import { getPackage as C } from "../package/package.util.js";
-import { CYBERSKILL_PACKAGE_NAME as S, PNPM_EXEC_CLI as w, TSX_CLI as T, CYBERSKILL_CLI_PATH as _, CYBERSKILL_CLI as A } from "../path/path.constant.js";
+import { getPackage as $ } from "../package/package.util.js";
+import { CYBERSKILL_PACKAGE_NAME as d, PNPM_EXEC_CLI as w, TSX_CLI as P, CYBERSKILL_CLI_PATH as S, CYBERSKILL_CLI as T } from "../path/path.constant.js";
 import { E_IssueType as f } from "../log/log.type.js";
-import { log as u, catchError as p } from "../log/log.util.js";
-import { getEnv as L } from "../../config/env/env.util.js";
-const B = $.promisify(P), k = $.promisify(I), N = /[|&;<>`$(){}\[\]!#~*?]/;
+import { log as u, catchError as E } from "../log/log.util.js";
+import { getEnv as _ } from "../../config/env/env.util.js";
+const O = C.promisify(x), A = C.promisify(I), N = /[|&;<>`$(){}[\]!#~*?]/, M = /^\s*(\d+):(\d+)\s+(error|warning)\s+(.+)\s+(\S+)$/, k = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:\s+(\S.+)$/, B = /^✖\s+(.+)\s+\[([^\]]*)\]$/, v = /\s+/;
 async function h() {
-  const t = await C();
+  const t = await $();
   return t.success ? t.result.name : Date.now().toString();
 }
-async function x(t) {
+async function L(t) {
   if (t.length === 0)
     return;
   const r = await h();
   try {
-    const s = [...await R(), ...t];
-    await g.set(r, s), setTimeout(async () => {
-      const o = await g.getLogLink(r);
-      o && u.info(`📂 Open the error list manually: ${o}`);
+    const o = [...await j(), ...t];
+    await g.set(r, o), setTimeout(async () => {
+      const e = await g.getLogLink(r);
+      e && u.info(`📂 Open the error list manually: ${e}`);
     }, 0);
-  } catch (e) {
-    p(e);
+  } catch (s) {
+    E(s);
   }
 }
-async function R() {
+async function j() {
   try {
     const t = await h();
     return await g.get(t) ?? [];
   } catch (t) {
-    return p(t, {
+    return E(t, {
       returnValue: []
     });
   }
 }
-async function U() {
+async function V() {
   try {
     const t = await h();
     await g.remove(t);
   } catch (t) {
-    p(t);
+    E(t);
   }
 }
-async function v(t) {
-  const r = [], e = [];
-  let s = "";
-  const o = /^\s*(\d+):(\d+)\s+(error|warning)\s+(.+)\s+(\S+)$/, i = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:\s+(\S.+)$/, n = /^✖\s+(.+)\s+\[([^\]]*)\]$/;
+async function D(t) {
+  const r = [], s = [];
+  let o = "";
+  const e = M, i = k, n = B;
   t.split(`
 `).forEach((a) => {
     if (a.startsWith("/"))
-      s = a.trim();
+      o = a.trim();
     else {
-      const c = o.exec(a) || [], l = i.exec(a) || [], E = n.exec(a) || [];
-      c.length && s ? r.push({
-        file: s,
+      const c = e.exec(a) || [], l = i.exec(a) || [], p = n.exec(a) || [];
+      c.length && o ? r.push({
+        file: o,
         position: `${c[1]}:${c[2]}`,
         type: c[3] === f.Error ? f.Error : f.Warning,
         message: c?.[4]?.trim() ?? "",
@@ -65,97 +65,97 @@ async function v(t) {
         position: `${l[2]}:${l[3]}`,
         type: l[4] === f.Error ? f.Error : f.Warning,
         message: l?.[5]?.trim() ?? ""
-      }) : E.length ? r.push({
+      }) : p.length ? r.push({
         file: "commitlint",
         type: f.Error,
-        message: E?.[1]?.trim() ?? "",
-        rule: E?.[2]?.trim() ?? ""
-      }) : e.push(a.trim());
+        message: p?.[1]?.trim() ?? "",
+        rule: p?.[2]?.trim() ?? ""
+      }) : s.push(a.trim());
     }
-  }), r.length && await x(r), L().DEBUG && e.length && (u.warn("Unmatched lines:"), e.forEach((a) => u.info(`  ${a}`)));
+  }), r.length && await L(r), s.length && (u.warn("Unmatched lines:"), s.forEach((a) => u.info(`  ${a}`)));
 }
-async function d(t) {
+async function R(t) {
   try {
-    const r = JSON.parse(t), e = [];
-    r.forEach(({ filePath: s, messages: o }) => {
-      o.forEach(({ severity: i, line: n, column: a, ruleId: c, message: l }) => {
-        e.push({
+    const r = JSON.parse(t), s = [];
+    r.forEach(({ filePath: o, messages: e }) => {
+      e.forEach(({ severity: i, line: n, column: a, ruleId: c, message: l }) => {
+        s.push({
           type: i === 2 ? f.Error : f.Warning,
-          file: s,
+          file: o,
           position: `${n}:${a}`,
           rule: c,
           message: l
         });
       });
-    }), e.length && await x(e);
+    }), s.length && await L(s);
   } catch {
-    await v(t);
+    await D(t);
   }
 }
-async function D(t, r = d, e = {}) {
-  const s = new AbortController();
+async function K(t, r = R, s = {}) {
+  const o = new AbortController();
   m.on("SIGINT", () => {
-    u.warn("Process interrupted. Terminating..."), s.abort(), m.exit();
+    u.warn("Process interrupted. Terminating..."), o.abort(), m.exit();
   });
   try {
     if (typeof t == "string") {
-      const o = {
+      const e = {
         maxBuffer: 10485760,
-        signal: s.signal,
-        timeout: e.timeout
+        signal: o.signal,
+        timeout: s.timeout
       };
       let i;
       if (N.test(t))
-        i = await B(t, o);
+        i = await O(t, e);
       else {
-        const n = t.split(/\s+/).filter(Boolean);
-        i = await k(n[0], n.slice(1), o);
+        const n = t.split(v).filter(Boolean);
+        i = await A(n[0], n.slice(1), e);
       }
       await Promise.all([i.stdout, i.stderr].map((n) => n && r(n)));
     }
-  } catch (o) {
-    const { stdout: i, stderr: n, message: a } = o;
-    await Promise.all([i, n].map((c) => c && r(c))), !n && !i && u.error(`Command failed: ${a}`);
+  } catch (e) {
+    const { stdout: i, stderr: n, message: a } = e;
+    throw await Promise.all([i, n].map((c) => c && r(c))), !n && !i && u.error(`Command failed: ${a}`), e;
   }
 }
-function Y(t) {
+function q(t) {
   return { raw: !0, cmd: t };
 }
 function y(t, r) {
-  return r?.isCurrentProject ? `${w} ${T} ${_} ${t}` : `${w} ${A} ${t}`;
+  return r?.isCurrentProject ? `${w} ${P} ${S} ${t}` : `${w} ${T} ${t}`;
 }
-function M(t, r) {
+function W(t, r) {
   return typeof t == "function" ? y(t(r), r) : typeof t == "object" && t?.raw === !0 ? t.cmd : typeof t == "string" ? y(t, r) : t;
 }
-async function X(t) {
-  const r = await C({ name: S });
+async function z(t) {
+  const r = await $({ name: d });
   if (r.success) {
-    const e = { isCurrentProject: r.result.isCurrentProject }, s = typeof t == "function" ? t(e) : t;
+    const s = { isCurrentProject: r.result.isCurrentProject }, o = typeof t == "function" ? t(s) : t;
     return Object.fromEntries(
-      Object.entries(s).map(([o, i]) => [o, M(i, e)])
+      Object.entries(o).map(([e, i]) => [e, W(i, s)])
     );
   }
 }
-async function J(t, r, e = {}) {
-  let s;
+async function Q(t, r, s = {}) {
+  let o;
   try {
-    const o = Date.now();
-    u.start(`${t}`), L().DEBUG ? u.info(`→ ${r}`) : s = setInterval(() => {
-      const i = Math.floor((Date.now() - o) / 1e3);
+    const e = Date.now();
+    u.start(`${t}`), _().DEBUG ? u.info(`→ ${r}`) : o = setInterval(() => {
+      const i = Math.floor((Date.now() - e) / 1e3);
       i > 0 && m.stdout.write(`\r⏳ ${t}... ${i}s`);
-    }, 100), await D(r, d, e), s && (clearInterval(s), m.stdout.write("\r\x1B[K")), u.success(`${t} done.`);
-  } catch (o) {
-    if (s && (clearInterval(s), m.stdout.write("\r\x1B[K")), e.throwOnError)
-      throw o;
-    p(o);
+    }, 100), await K(r, R, s), o && (clearInterval(o), m.stdout.write("\r\x1B[K")), u.success(`${t} done.`);
+  } catch (e) {
+    if (o && (clearInterval(o), m.stdout.write("\r\x1B[K")), s.throwOnError)
+      throw e;
+    E(e);
   }
 }
 export {
-  U as clearAllErrorLists,
-  M as formatCommand,
-  R as getStoredErrorLists,
-  Y as rawCommand,
-  X as resolveCommands,
-  J as runCommand
+  V as clearAllErrorLists,
+  W as formatCommand,
+  j as getStoredErrorLists,
+  q as rawCommand,
+  z as resolveCommands,
+  Q as runCommand
 };
 //# sourceMappingURL=command.util.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"command.util.js","sources":["../../../src/node/command/command.util.ts"],"sourcesContent":["import { exec, execFile } from 'node:child_process';\nimport process from 'node:process';\nimport * as util from 'node:util';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { I_IssueEntry } from '../log/index.js';\nimport type { I_CommandContext, I_EslintError, T_Command, T_CommandMapInput } from './command.type.js';\n\nimport { catchError, E_IssueType, log } from '../log/index.js';\nimport { getPackage } from '../package/index.js';\nimport { CYBERSKILL_CLI, CYBERSKILL_CLI_PATH, CYBERSKILL_PACKAGE_NAME, PNPM_EXEC_CLI, TSX_CLI } from '../path/index.js';\nimport { storage } from '../storage/index.js';\n\nconst execPromise = util.promisify(exec);\nconst execFilePromise = util.promisify(execFile);\nconst SHELL_METACHARACTERS = /[|&;<>`$(){}\\[\\]!#~*?]/;\n\n/**\n * Retrieves the package name for the current project.\n * This function attempts to get the package name from the current project's package.json.\n * If the package information cannot be retrieved, it returns a timestamp as a fallback.\n *\n * @returns A promise that resolves to the package name or a timestamp string.\n */\nasync function getPackageName() {\n    const pkg = await getPackage();\n\n    if (!pkg.success) {\n        return Date.now().toString();\n    }\n\n    return pkg.result.name;\n}\n\n/**\n * Saves a list of error entries to persistent storage.\n * This function stores error information with the package name as the key,\n * and provides a log link for manual inspection of the stored errors.\n *\n * @param errorList - An array of error entries to be stored.\n * @returns A promise that resolves when the storage operation is complete.\n */\nasync function saveErrorListToStorage(errorList: I_IssueEntry[]): Promise<void> {\n    if (errorList.length === 0) {\n        return;\n    }\n\n    const packageName = await getPackageName();\n\n    try {\n        const existingErrors = await getStoredErrorLists();\n        const mergedErrors = [...existingErrors, ...errorList];\n\n        await storage.set(packageName, mergedErrors);\n\n        setTimeout(async () => {\n            const logPath = await storage.getLogLink(packageName);\n\n            if (logPath) {\n                log.info(`📂 Open the error list manually: ${logPath}`);\n            }\n        }, 0);\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n\n/**\n * Retrieves all stored error lists from persistent storage.\n * This function fetches error entries that were previously saved using the package name as the key.\n *\n * @returns A promise that resolves to an array of error entries, or an empty array if none are found.\n */\nexport async function getStoredErrorLists(): Promise<I_IssueEntry[]> {\n    try {\n        const packageName = await getPackageName();\n        const allErrors = await storage.get<I_IssueEntry[]>(packageName);\n\n        return allErrors ?? [];\n    }\n    catch (error) {\n        return catchError<I_IssueEntry[]>(error, {\n            returnValue: [],\n        });\n    }\n}\n\n/**\n * Clears all stored error lists from persistent storage.\n * This function removes all error entries associated with the current package name.\n *\n * @returns A promise that resolves when the clearing operation is complete.\n */\nexport async function clearAllErrorLists(): Promise<void> {\n    try {\n        const packageName = await getPackageName();\n        await storage.remove(packageName);\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n\n/**\n * Parses text-based error output and converts it to structured error entries.\n * This function processes command output that contains error information in text format,\n * extracting file paths, line numbers, error types, messages, and rule violations.\n * It handles multiple error formats including ESLint, TypeScript, and commitlint errors.\n *\n * @param output - The raw text output from a command execution containing error information.\n */\nasync function parseTextErrors(output: string): Promise<void> {\n    const errorList: I_IssueEntry[] = [];\n    const unmatchedLines: string[] = [];\n    let lastFilePath = '';\n    const eslintErrorDetailsRegex = /^\\s*(\\d+):(\\d+)\\s+(error|warning)\\s+(.+)\\s+(\\S+)$/;\n    const tsRegex = /^(.+?)\\((\\d+),(\\d+)\\):\\s+(error|warning)\\s+TS\\d+:\\s+(\\S.+)$/;\n    const commitlintRegex = /^✖\\s+(.+)\\s+\\[([^\\]]*)\\]$/;\n\n    output.split('\\n').forEach((line) => {\n        if (line.startsWith('/')) {\n            lastFilePath = line.trim();\n        }\n        else {\n            const eslintMatch = eslintErrorDetailsRegex.exec(line) || [];\n            const tsMatch = tsRegex.exec(line) || [];\n            const commitlintMatch = commitlintRegex.exec(line) || [];\n\n            if (eslintMatch.length && lastFilePath) {\n                errorList.push({\n                    file: lastFilePath,\n                    position: `${eslintMatch[1]}:${eslintMatch[2]}`,\n                    type: eslintMatch[3] === E_IssueType.Error ? E_IssueType.Error : E_IssueType.Warning,\n                    message: eslintMatch?.[4]?.trim() ?? '',\n                    rule: eslintMatch?.[5]?.trim() ?? '',\n                });\n            }\n            else if (tsMatch.length) {\n                errorList.push({\n                    file: tsMatch?.[1] ?? '',\n                    position: `${tsMatch[2]}:${tsMatch[3]}`,\n                    type: tsMatch[4] === E_IssueType.Error ? E_IssueType.Error : E_IssueType.Warning,\n                    message: tsMatch?.[5]?.trim() ?? '',\n                });\n            }\n            else if (commitlintMatch.length) {\n                errorList.push({\n                    file: 'commitlint',\n                    type: E_IssueType.Error,\n                    message: commitlintMatch?.[1]?.trim() ?? '',\n                    rule: commitlintMatch?.[2]?.trim() ?? '',\n                });\n            }\n            else {\n                unmatchedLines.push(line.trim());\n            }\n        }\n    });\n\n    if (errorList.length) {\n        await saveErrorListToStorage(errorList);\n    }\n\n    if (getEnv().DEBUG && unmatchedLines.length) {\n        log.warn(`Unmatched lines:`);\n        unmatchedLines.forEach(line => log.info(`  ${line}`));\n    }\n}\n\n/**\n * Parses command output that contains structured error information.\n * This function attempts to parse JSON-formatted error output (typically from ESLint)\n * and converts it to structured error entries. If JSON parsing fails, it falls back\n * to text-based parsing.\n *\n * @param output - The command output to parse, expected to be JSON-formatted error data.\n */\nasync function parseCommandOutput(output: string): Promise<void> {\n    try {\n        const results: I_EslintError[] = JSON.parse(output);\n        const errorList: I_IssueEntry[] = [];\n\n        results.forEach(({ filePath, messages }) => {\n            messages.forEach(({ severity, line, column, ruleId, message }) => {\n                errorList.push({\n                    type: severity === 2 ? E_IssueType.Error : E_IssueType.Warning,\n                    file: filePath,\n                    position: `${line}:${column}`,\n                    rule: ruleId,\n                    message,\n                });\n            });\n        });\n\n        if (errorList.length) {\n            await saveErrorListToStorage(errorList);\n        }\n    }\n    catch {\n        await parseTextErrors(output);\n    }\n}\n\n/**\n * Executes a command and processes its output for errors.\n * This function runs a command with proper signal handling for graceful termination,\n * processes both stdout and stderr for error information, and handles command failures.\n *\n * @param command - The command string to execute, or undefined if no command should be run.\n * @param parser - The function to use for parsing command output (defaults to parseCommandOutput).\n * @returns A promise that resolves when the command execution is complete.\n */\nasync function executeCommand(command: string | void, parser = parseCommandOutput, options: { timeout?: number } = {}): Promise<void> {\n    const controller = new AbortController();\n\n    process.on('SIGINT', () => {\n        log.warn('Process interrupted. Terminating...');\n        controller.abort();\n        process.exit();\n    });\n\n    try {\n        if (typeof command === 'string') {\n            const execOptions = {\n                maxBuffer: 10 * 1024 * 1024,\n                signal: controller.signal,\n                timeout: options.timeout,\n            };\n\n            let result: { stdout: string; stderr: string };\n\n            if (SHELL_METACHARACTERS.test(command)) {\n                result = await execPromise(command, execOptions);\n            }\n            else {\n                const parts = command.split(/\\s+/).filter(Boolean);\n                result = await execFilePromise(parts[0]!, parts.slice(1), execOptions);\n            }\n\n            await Promise.all([result.stdout, result.stderr].map(output => output && parser(output)));\n        }\n    }\n    catch (error) {\n        const { stdout, stderr, message } = error as {\n            stdout?: string;\n            stderr?: string;\n            message: string;\n        };\n\n        await Promise.all([stdout, stderr].map(output => output && parser(output)));\n\n        if (!stderr && !stdout) {\n            log.error(`Command failed: ${message}`);\n        }\n    }\n}\n\n/**\n * Creates a raw command object that bypasses CLI formatting.\n * This function wraps a command string in an object that indicates it should be executed\n * as-is without any additional CLI formatting or path resolution.\n *\n * @param cmd - The raw command string to be executed directly.\n * @returns An object containing the raw command with a flag indicating it should not be formatted.\n */\nexport function rawCommand(cmd: string) {\n    return { raw: true, cmd };\n}\n\n/**\n * Formats a command for CLI execution based on the current project context.\n * This function determines whether to use the current project's CLI path or the global CLI,\n * and formats the command accordingly with the appropriate executable paths.\n *\n * @param command - The command string to format.\n * @param context - Optional context information about the current project.\n * @returns The formatted command string ready for execution.\n */\nfunction formatCLI(command: string, context?: I_CommandContext) {\n    if (context?.isCurrentProject) {\n        return `${PNPM_EXEC_CLI} ${TSX_CLI} ${CYBERSKILL_CLI_PATH} ${command}`;\n    }\n\n    return `${PNPM_EXEC_CLI} ${CYBERSKILL_CLI} ${command}`;\n}\n\n/**\n * Formats a command based on its type and context.\n * This function handles different command types:\n * - Function commands: Executes the function with context and formats the result\n * - Raw commands: Returns the command as-is without formatting\n * - String commands: Formats them as CLI commands\n *\n * @param command - The command to format, which can be a string, function, or raw command object.\n * @param context - Optional context information for command execution.\n * @returns The formatted command string ready for execution.\n */\nexport function formatCommand(command: T_Command, context?: I_CommandContext) {\n    if (typeof command === 'function') {\n        return formatCLI(command(context), context);\n    }\n\n    if (typeof command === 'object' && command?.raw === true) {\n        return command.cmd;\n    }\n\n    if (typeof command === 'string') {\n        return formatCLI(command, context);\n    }\n\n    return command;\n}\n\n/**\n * Resolves a map of commands by formatting them based on the current project context.\n * This function takes a command map (either static or dynamic) and formats all commands\n * using the appropriate CLI paths based on whether the current project is the Cyberskill package.\n *\n * @param input - The command map to resolve, which can be static or a function that returns a map.\n * @returns A promise that resolves to an object with formatted command strings, or undefined if package info cannot be retrieved.\n */\nexport async function resolveCommands(input: T_CommandMapInput) {\n    const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n\n    if (packageData.success) {\n        const ctx: I_CommandContext = { isCurrentProject: packageData.result.isCurrentProject };\n        const commands = typeof input === 'function' ? input(ctx) : input;\n\n        return Object.fromEntries(\n            Object.entries(commands).map(([key, cmd]) => [key, formatCommand(cmd, ctx)]),\n        );\n    }\n}\n\n/**\n * Executes a command with proper logging and error handling.\n * This function provides a standardized way to run commands with:\n * - Progress logging with start and success messages\n * - Debug logging of the actual command when DEBUG mode is enabled\n * - Error handling and reporting\n *\n * @param label - A human-readable label describing what the command does.\n * @param command - The command string to execute, or undefined if no command should be run.\n * @returns A promise that resolves when the command execution is complete.\n */\nexport async function runCommand(label: string, command: string | void, options: { timeout?: number; throwOnError?: boolean } = {}) {\n    let timer: NodeJS.Timeout | undefined;\n\n    try {\n        const startTime = Date.now();\n        log.start(`${label}`);\n\n        if (getEnv().DEBUG) {\n            log.info(`→ ${command}`);\n        }\n        else {\n            timer = setInterval(() => {\n                const elapsed = Math.floor((Date.now() - startTime) / 1000);\n\n                if (elapsed > 0) {\n                    process.stdout.write(`\\r⏳ ${label}... ${elapsed}s`);\n                }\n            }, 100);\n        }\n\n        await executeCommand(command, parseCommandOutput, options);\n\n        if (timer) {\n            clearInterval(timer);\n            process.stdout.write(`\\r\\x1B[K`);\n        }\n\n        log.success(`${label} done.`);\n    }\n    catch (error) {\n        if (timer) {\n            clearInterval(timer);\n            process.stdout.write(`\\r\\x1B[K`);\n        }\n\n        if (options.throwOnError) {\n            throw error;\n        }\n        catchError(error);\n    }\n}\n"],"names":["exec","execFile","process","util","storage","getPackage","CYBERSKILL_PACKAGE_NAME","PNPM_EXEC_CLI","TSX_CLI","CYBERSKILL_CLI_PATH","CYBERSKILL_CLI","E_IssueType","log","catchError","getEnv","execPromise","execFilePromise","SHELL_METACHARACTERS","getPackageName","pkg","saveErrorListToStorage","errorList","packageName","mergedErrors","getStoredErrorLists","logPath","error","clearAllErrorLists","parseTextErrors","output","unmatchedLines","lastFilePath","eslintErrorDetailsRegex","tsRegex","commitlintRegex","line","eslintMatch","tsMatch","commitlintMatch","parseCommandOutput","results","filePath","messages","severity","column","ruleId","message","executeCommand","command","parser","options","controller","execOptions","result","parts","stdout","stderr","rawCommand","cmd","formatCLI","context","formatCommand","resolveCommands","input","packageData","ctx","commands","key","runCommand","label","timer","startTime","elapsed"],"mappings":"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"}
+{"version":3,"file":"command.util.js","sources":["../../../src/node/command/command.util.ts"],"sourcesContent":["import { exec, execFile } from 'node:child_process';\nimport process from 'node:process';\nimport * as util from 'node:util';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { I_IssueEntry } from '../log/index.js';\nimport type { I_CommandContext, I_EslintError, T_Command, T_CommandMapInput } from './command.type.js';\n\nimport { catchError, E_IssueType, log } from '../log/index.js';\nimport { getPackage } from '../package/index.js';\nimport { CYBERSKILL_CLI, CYBERSKILL_CLI_PATH, CYBERSKILL_PACKAGE_NAME, PNPM_EXEC_CLI, TSX_CLI } from '../path/index.js';\nimport { storage } from '../storage/index.js';\n\nconst execPromise = util.promisify(exec);\nconst execFilePromise = util.promisify(execFile);\nconst SHELL_METACHARACTERS = /[|&;<>`$(){}[\\]!#~*?]/;\n// eslint-disable-next-line regexp/no-super-linear-backtracking, regexp/no-misleading-capturing-group\nconst RE_ESLINT_ERROR = /^\\s*(\\d+):(\\d+)\\s+(error|warning)\\s+(.+)\\s+(\\S+)$/;\nconst RE_TS_ERROR = /^(.+?)\\((\\d+),(\\d+)\\):\\s+(error|warning)\\s+TS\\d+:\\s+(\\S.+)$/;\n// eslint-disable-next-line regexp/no-super-linear-backtracking, regexp/no-misleading-capturing-group\nconst RE_COMMITLINT_ERROR = /^✖\\s+(.+)\\s+\\[([^\\]]*)\\]$/;\nconst RE_WHITESPACE = /\\s+/;\n\n/**\n * Retrieves the package name for the current project.\n * This function attempts to get the package name from the current project's package.json.\n * If the package information cannot be retrieved, it returns a timestamp as a fallback.\n *\n * @returns A promise that resolves to the package name or a timestamp string.\n */\nasync function getPackageName() {\n    const pkg = await getPackage();\n\n    if (!pkg.success) {\n        return Date.now().toString();\n    }\n\n    return pkg.result.name;\n}\n\n/**\n * Saves a list of error entries to persistent storage.\n * This function stores error information with the package name as the key,\n * and provides a log link for manual inspection of the stored errors.\n *\n * @param errorList - An array of error entries to be stored.\n * @returns A promise that resolves when the storage operation is complete.\n */\nasync function saveErrorListToStorage(errorList: I_IssueEntry[]): Promise<void> {\n    if (errorList.length === 0) {\n        return;\n    }\n\n    const packageName = await getPackageName();\n\n    try {\n        const existingErrors = await getStoredErrorLists();\n        const mergedErrors = [...existingErrors, ...errorList];\n\n        await storage.set(packageName, mergedErrors);\n\n        setTimeout(async () => {\n            const logPath = await storage.getLogLink(packageName);\n\n            if (logPath) {\n                log.info(`📂 Open the error list manually: ${logPath}`);\n            }\n        }, 0);\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n\n/**\n * Retrieves all stored error lists from persistent storage.\n * This function fetches error entries that were previously saved using the package name as the key.\n *\n * @returns A promise that resolves to an array of error entries, or an empty array if none are found.\n */\nexport async function getStoredErrorLists(): Promise<I_IssueEntry[]> {\n    try {\n        const packageName = await getPackageName();\n        const allErrors = await storage.get<I_IssueEntry[]>(packageName);\n\n        return allErrors ?? [];\n    }\n    catch (error) {\n        return catchError<I_IssueEntry[]>(error, {\n            returnValue: [],\n        });\n    }\n}\n\n/**\n * Clears all stored error lists from persistent storage.\n * This function removes all error entries associated with the current package name.\n *\n * @returns A promise that resolves when the clearing operation is complete.\n */\nexport async function clearAllErrorLists(): Promise<void> {\n    try {\n        const packageName = await getPackageName();\n        await storage.remove(packageName);\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n\n/**\n * Parses text-based error output and converts it to structured error entries.\n * This function processes command output that contains error information in text format,\n * extracting file paths, line numbers, error types, messages, and rule violations.\n * It handles multiple error formats including ESLint, TypeScript, and commitlint errors.\n *\n * @param output - The raw text output from a command execution containing error information.\n */\nasync function parseTextErrors(output: string): Promise<void> {\n    const errorList: I_IssueEntry[] = [];\n    const unmatchedLines: string[] = [];\n    let lastFilePath = '';\n    const eslintErrorDetailsRegex = RE_ESLINT_ERROR;\n    const tsRegex = RE_TS_ERROR;\n    const commitlintRegex = RE_COMMITLINT_ERROR;\n\n    output.split('\\n').forEach((line) => {\n        if (line.startsWith('/')) {\n            lastFilePath = line.trim();\n        }\n        else {\n            const eslintMatch = eslintErrorDetailsRegex.exec(line) || [];\n            const tsMatch = tsRegex.exec(line) || [];\n            const commitlintMatch = commitlintRegex.exec(line) || [];\n\n            if (eslintMatch.length && lastFilePath) {\n                errorList.push({\n                    file: lastFilePath,\n                    position: `${eslintMatch[1]}:${eslintMatch[2]}`,\n                    type: eslintMatch[3] === E_IssueType.Error ? E_IssueType.Error : E_IssueType.Warning,\n                    message: eslintMatch?.[4]?.trim() ?? '',\n                    rule: eslintMatch?.[5]?.trim() ?? '',\n                });\n            }\n            else if (tsMatch.length) {\n                errorList.push({\n                    file: tsMatch?.[1] ?? '',\n                    position: `${tsMatch[2]}:${tsMatch[3]}`,\n                    type: tsMatch[4] === E_IssueType.Error ? E_IssueType.Error : E_IssueType.Warning,\n                    message: tsMatch?.[5]?.trim() ?? '',\n                });\n            }\n            else if (commitlintMatch.length) {\n                errorList.push({\n                    file: 'commitlint',\n                    type: E_IssueType.Error,\n                    message: commitlintMatch?.[1]?.trim() ?? '',\n                    rule: commitlintMatch?.[2]?.trim() ?? '',\n                });\n            }\n            else {\n                unmatchedLines.push(line.trim());\n            }\n        }\n    });\n\n    if (errorList.length) {\n        await saveErrorListToStorage(errorList);\n    }\n\n    if (unmatchedLines.length) {\n        log.warn(`Unmatched lines:`);\n        unmatchedLines.forEach(line => log.info(`  ${line}`));\n    }\n}\n\n/**\n * Parses command output that contains structured error information.\n * This function attempts to parse JSON-formatted error output (typically from ESLint)\n * and converts it to structured error entries. If JSON parsing fails, it falls back\n * to text-based parsing.\n *\n * @param output - The command output to parse, expected to be JSON-formatted error data.\n */\nasync function parseCommandOutput(output: string): Promise<void> {\n    try {\n        const results: I_EslintError[] = JSON.parse(output);\n        const errorList: I_IssueEntry[] = [];\n\n        results.forEach(({ filePath, messages }) => {\n            messages.forEach(({ severity, line, column, ruleId, message }) => {\n                errorList.push({\n                    type: severity === 2 ? E_IssueType.Error : E_IssueType.Warning,\n                    file: filePath,\n                    position: `${line}:${column}`,\n                    rule: ruleId,\n                    message,\n                });\n            });\n        });\n\n        if (errorList.length) {\n            await saveErrorListToStorage(errorList);\n        }\n    }\n    catch {\n        await parseTextErrors(output);\n    }\n}\n\n/**\n * Executes a command and processes its output for errors.\n * This function runs a command with proper signal handling for graceful termination,\n * processes both stdout and stderr for error information, and handles command failures.\n *\n * @param command - The command string to execute, or undefined if no command should be run.\n * @param parser - The function to use for parsing command output (defaults to parseCommandOutput).\n * @returns A promise that resolves when the command execution is complete.\n */\nasync function executeCommand(command: string | void, parser = parseCommandOutput, options: { timeout?: number } = {}): Promise<void> {\n    const controller = new AbortController();\n\n    process.on('SIGINT', () => {\n        log.warn('Process interrupted. Terminating...');\n        controller.abort();\n        process.exit();\n    });\n\n    try {\n        if (typeof command === 'string') {\n            const execOptions = {\n                maxBuffer: 10 * 1024 * 1024,\n                signal: controller.signal,\n                timeout: options.timeout,\n            };\n\n            let result: { stdout: string; stderr: string };\n\n            if (SHELL_METACHARACTERS.test(command)) {\n                result = await execPromise(command, execOptions);\n            }\n            else {\n                const parts = command.split(RE_WHITESPACE).filter(Boolean);\n                result = await execFilePromise(parts[0]!, parts.slice(1), execOptions);\n            }\n\n            await Promise.all([result.stdout, result.stderr].map(output => output && parser(output)));\n        }\n    }\n    catch (error) {\n        const { stdout, stderr, message } = error as {\n            stdout?: string;\n            stderr?: string;\n            message: string;\n        };\n\n        await Promise.all([stdout, stderr].map(output => output && parser(output)));\n\n        if (!stderr && !stdout) {\n            log.error(`Command failed: ${message}`);\n        }\n\n        throw error;\n    }\n}\n\n/**\n * Creates a raw command object that bypasses CLI formatting.\n * This function wraps a command string in an object that indicates it should be executed\n * as-is without any additional CLI formatting or path resolution.\n *\n * @param cmd - The raw command string to be executed directly.\n * @returns An object containing the raw command with a flag indicating it should not be formatted.\n */\nexport function rawCommand(cmd: string) {\n    return { raw: true, cmd };\n}\n\n/**\n * Formats a command for CLI execution based on the current project context.\n * This function determines whether to use the current project's CLI path or the global CLI,\n * and formats the command accordingly with the appropriate executable paths.\n *\n * @param command - The command string to format.\n * @param context - Optional context information about the current project.\n * @returns The formatted command string ready for execution.\n */\nfunction formatCLI(command: string, context?: I_CommandContext) {\n    if (context?.isCurrentProject) {\n        return `${PNPM_EXEC_CLI} ${TSX_CLI} ${CYBERSKILL_CLI_PATH} ${command}`;\n    }\n\n    return `${PNPM_EXEC_CLI} ${CYBERSKILL_CLI} ${command}`;\n}\n\n/**\n * Formats a command based on its type and context.\n * This function handles different command types:\n * - Function commands: Executes the function with context and formats the result\n * - Raw commands: Returns the command as-is without formatting\n * - String commands: Formats them as CLI commands\n *\n * @param command - The command to format, which can be a string, function, or raw command object.\n * @param context - Optional context information for command execution.\n * @returns The formatted command string ready for execution.\n */\nexport function formatCommand(command: T_Command, context?: I_CommandContext) {\n    if (typeof command === 'function') {\n        return formatCLI(command(context), context);\n    }\n\n    if (typeof command === 'object' && command?.raw === true) {\n        return command.cmd;\n    }\n\n    if (typeof command === 'string') {\n        return formatCLI(command, context);\n    }\n\n    return command;\n}\n\n/**\n * Resolves a map of commands by formatting them based on the current project context.\n * This function takes a command map (either static or dynamic) and formats all commands\n * using the appropriate CLI paths based on whether the current project is the Cyberskill package.\n *\n * @param input - The command map to resolve, which can be static or a function that returns a map.\n * @returns A promise that resolves to an object with formatted command strings, or undefined if package info cannot be retrieved.\n */\nexport async function resolveCommands(input: T_CommandMapInput) {\n    const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n\n    if (packageData.success) {\n        const ctx: I_CommandContext = { isCurrentProject: packageData.result.isCurrentProject };\n        const commands = typeof input === 'function' ? input(ctx) : input;\n\n        return Object.fromEntries(\n            Object.entries(commands).map(([key, cmd]) => [key, formatCommand(cmd, ctx)]),\n        );\n    }\n}\n\n/**\n * Executes a command with proper logging and error handling.\n * This function provides a standardized way to run commands with:\n * - Progress logging with start and success messages\n * - Debug logging of the actual command when DEBUG mode is enabled\n * - Error handling and reporting\n *\n * @param label - A human-readable label describing what the command does.\n * @param command - The command string to execute, or undefined if no command should be run.\n * @returns A promise that resolves when the command execution is complete.\n */\nexport async function runCommand(label: string, command: string | void, options: { timeout?: number; throwOnError?: boolean } = {}) {\n    let timer: NodeJS.Timeout | undefined;\n\n    try {\n        const startTime = Date.now();\n        log.start(`${label}`);\n\n        if (getEnv().DEBUG) {\n            log.info(`→ ${command}`);\n        }\n        else {\n            timer = setInterval(() => {\n                const elapsed = Math.floor((Date.now() - startTime) / 1000);\n\n                if (elapsed > 0) {\n                    process.stdout.write(`\\r⏳ ${label}... ${elapsed}s`);\n                }\n            }, 100);\n        }\n\n        await executeCommand(command, parseCommandOutput, options);\n\n        if (timer) {\n            clearInterval(timer);\n            process.stdout.write(`\\r\\x1B[K`);\n        }\n\n        log.success(`${label} done.`);\n    }\n    catch (error) {\n        if (timer) {\n            clearInterval(timer);\n            process.stdout.write(`\\r\\x1B[K`);\n        }\n\n        if (options.throwOnError) {\n            throw error;\n        }\n        catchError(error);\n    }\n}\n"],"names":["exec","execFile","process","util","storage","getPackage","CYBERSKILL_PACKAGE_NAME","PNPM_EXEC_CLI","TSX_CLI","CYBERSKILL_CLI_PATH","CYBERSKILL_CLI","E_IssueType","log","catchError","getEnv","execPromise","execFilePromise","SHELL_METACHARACTERS","RE_ESLINT_ERROR","RE_TS_ERROR","RE_COMMITLINT_ERROR","RE_WHITESPACE","getPackageName","pkg","saveErrorListToStorage","errorList","packageName","mergedErrors","getStoredErrorLists","logPath","error","clearAllErrorLists","parseTextErrors","output","unmatchedLines","lastFilePath","eslintErrorDetailsRegex","tsRegex","commitlintRegex","line","eslintMatch","tsMatch","commitlintMatch","parseCommandOutput","results","filePath","messages","severity","column","ruleId","message","executeCommand","command","parser","options","controller","execOptions","result","parts","stdout","stderr","rawCommand","cmd","formatCLI","context","formatCommand","resolveCommands","input","packageData","ctx","commands","key","runCommand","label","timer","startTime","elapsed"],"mappings":"AAcA,SAAA,QAAAA,GAAA,YAAAC,SAAA;AAAA,OAAAC,OAAA;AAAA,YAAAC,OAAA;AAAA,SAAA,WAAAC,SAAA;AAAA,SAAA,cAAAC,SAAA;AAAA,SAAA,2BAAAC,GAAA,iBAAAC,GAAA,WAAAC,GAAA,uBAAAC,GAAA,kBAAAC,SAAA;AAAA,SAAA,eAAAC,SAAA;AAAA,SAAA,OAAAC,GAAA,cAAAC,SAAA;AAAA,SAAA,UAAAC,SAAA;AAAA,MAAMC,IAAcZ,EAAK,UAAUH,CAAI,GACjCgB,IAAkBb,EAAK,UAAUF,CAAQ,GACzCgB,IAAuB,yBAEvBC,IAAkB,qDAClBC,IAAc,+DAEdC,IAAsB,6BACtBC,IAAgB;AAStB,eAAeC,IAAiB;AAC5B,QAAMC,IAAM,MAAMlB,EAAA;AAElB,SAAKkB,EAAI,UAIFA,EAAI,OAAO,OAHP,KAAK,IAAA,EAAM,SAAA;AAI1B;AAUA,eAAeC,EAAuBC,GAA0C;AAC5E,MAAIA,EAAU,WAAW;AACrB;AAGJ,QAAMC,IAAc,MAAMJ,EAAA;AAE1B,MAAI;AAEA,UAAMK,IAAe,CAAC,GADC,MAAMC,EAAA,GACY,GAAGH,CAAS;AAErD,UAAMrB,EAAQ,IAAIsB,GAAaC,CAAY,GAE3C,WAAW,YAAY;AACnB,YAAME,IAAU,MAAMzB,EAAQ,WAAWsB,CAAW;AAEpD,MAAIG,KACAjB,EAAI,KAAK,oCAAoCiB,CAAO,EAAE;AAAA,IAE9D,GAAG,CAAC;AAAA,EACR,SACOC,GAAO;AACV,IAAAjB,EAAWiB,CAAK;AAAA,EACpB;AACJ;AAQA,eAAsBF,IAA+C;AACjE,MAAI;AACA,UAAMF,IAAc,MAAMJ,EAAA;AAG1B,WAFkB,MAAMlB,EAAQ,IAAoBsB,CAAW,KAE3C,CAAA;AAAA,EACxB,SACOI,GAAO;AACV,WAAOjB,EAA2BiB,GAAO;AAAA,MACrC,aAAa,CAAA;AAAA,IAAC,CACjB;AAAA,EACL;AACJ;AAQA,eAAsBC,IAAoC;AACtD,MAAI;AACA,UAAML,IAAc,MAAMJ,EAAA;AAC1B,UAAMlB,EAAQ,OAAOsB,CAAW;AAAA,EACpC,SACOI,GAAO;AACV,IAAAjB,EAAWiB,CAAK;AAAA,EACpB;AACJ;AAUA,eAAeE,EAAgBC,GAA+B;AAC1D,QAAMR,IAA4B,CAAA,GAC5BS,IAA2B,CAAA;AACjC,MAAIC,IAAe;AACnB,QAAMC,IAA0BlB,GAC1BmB,IAAUlB,GACVmB,IAAkBlB;AAExB,EAAAa,EAAO,MAAM;AAAA,CAAI,EAAE,QAAQ,CAACM,MAAS;AACjC,QAAIA,EAAK,WAAW,GAAG;AACnB,MAAAJ,IAAeI,EAAK,KAAA;AAAA,SAEnB;AACD,YAAMC,IAAcJ,EAAwB,KAAKG,CAAI,KAAK,CAAA,GACpDE,IAAUJ,EAAQ,KAAKE,CAAI,KAAK,CAAA,GAChCG,IAAkBJ,EAAgB,KAAKC,CAAI,KAAK,CAAA;AAEtD,MAAIC,EAAY,UAAUL,IACtBV,EAAU,KAAK;AAAA,QACX,MAAMU;AAAA,QACN,UAAU,GAAGK,EAAY,CAAC,CAAC,IAAIA,EAAY,CAAC,CAAC;AAAA,QAC7C,MAAMA,EAAY,CAAC,MAAM7B,EAAY,QAAQA,EAAY,QAAQA,EAAY;AAAA,QAC7E,SAAS6B,IAAc,CAAC,GAAG,UAAU;AAAA,QACrC,MAAMA,IAAc,CAAC,GAAG,UAAU;AAAA,MAAA,CACrC,IAEIC,EAAQ,SACbhB,EAAU,KAAK;AAAA,QACX,MAAMgB,IAAU,CAAC,KAAK;AAAA,QACtB,UAAU,GAAGA,EAAQ,CAAC,CAAC,IAAIA,EAAQ,CAAC,CAAC;AAAA,QACrC,MAAMA,EAAQ,CAAC,MAAM9B,EAAY,QAAQA,EAAY,QAAQA,EAAY;AAAA,QACzE,SAAS8B,IAAU,CAAC,GAAG,UAAU;AAAA,MAAA,CACpC,IAEIC,EAAgB,SACrBjB,EAAU,KAAK;AAAA,QACX,MAAM;AAAA,QACN,MAAMd,EAAY;AAAA,QAClB,SAAS+B,IAAkB,CAAC,GAAG,UAAU;AAAA,QACzC,MAAMA,IAAkB,CAAC,GAAG,UAAU;AAAA,MAAA,CACzC,IAGDR,EAAe,KAAKK,EAAK,MAAM;AAAA,IAEvC;AAAA,EACJ,CAAC,GAEGd,EAAU,UACV,MAAMD,EAAuBC,CAAS,GAGtCS,EAAe,WACftB,EAAI,KAAK,kBAAkB,GAC3BsB,EAAe,QAAQ,CAAAK,MAAQ3B,EAAI,KAAK,KAAK2B,CAAI,EAAE,CAAC;AAE5D;AAUA,eAAeI,EAAmBV,GAA+B;AAC7D,MAAI;AACA,UAAMW,IAA2B,KAAK,MAAMX,CAAM,GAC5CR,IAA4B,CAAA;AAElC,IAAAmB,EAAQ,QAAQ,CAAC,EAAE,UAAAC,GAAU,UAAAC,QAAe;AACxC,MAAAA,EAAS,QAAQ,CAAC,EAAE,UAAAC,GAAU,MAAAR,GAAM,QAAAS,GAAQ,QAAAC,GAAQ,SAAAC,QAAc;AAC9D,QAAAzB,EAAU,KAAK;AAAA,UACX,MAAMsB,MAAa,IAAIpC,EAAY,QAAQA,EAAY;AAAA,UACvD,MAAMkC;AAAA,UACN,UAAU,GAAGN,CAAI,IAAIS,CAAM;AAAA,UAC3B,MAAMC;AAAA,UACN,SAAAC;AAAA,QAAA,CACH;AAAA,MACL,CAAC;AAAA,IACL,CAAC,GAEGzB,EAAU,UACV,MAAMD,EAAuBC,CAAS;AAAA,EAE9C,QACM;AACF,UAAMO,EAAgBC,CAAM;AAAA,EAChC;AACJ;AAWA,eAAekB,EAAeC,GAAwBC,IAASV,GAAoBW,IAAgC,CAAA,GAAmB;AAClI,QAAMC,IAAa,IAAI,gBAAA;AAEvB,EAAArD,EAAQ,GAAG,UAAU,MAAM;AACvB,IAAAU,EAAI,KAAK,qCAAqC,GAC9C2C,EAAW,MAAA,GACXrD,EAAQ,KAAA;AAAA,EACZ,CAAC;AAED,MAAI;AACA,QAAI,OAAOkD,KAAY,UAAU;AAC7B,YAAMI,IAAc;AAAA,QAChB,WAAW;AAAA,QACX,QAAQD,EAAW;AAAA,QACnB,SAASD,EAAQ;AAAA,MAAA;AAGrB,UAAIG;AAEJ,UAAIxC,EAAqB,KAAKmC,CAAO;AACjC,QAAAK,IAAS,MAAM1C,EAAYqC,GAASI,CAAW;AAAA,WAE9C;AACD,cAAME,IAAQN,EAAQ,MAAM/B,CAAa,EAAE,OAAO,OAAO;AACzD,QAAAoC,IAAS,MAAMzC,EAAgB0C,EAAM,CAAC,GAAIA,EAAM,MAAM,CAAC,GAAGF,CAAW;AAAA,MACzE;AAEA,YAAM,QAAQ,IAAI,CAACC,EAAO,QAAQA,EAAO,MAAM,EAAE,IAAI,CAAAxB,MAAUA,KAAUoB,EAAOpB,CAAM,CAAC,CAAC;AAAA,IAC5F;AAAA,EACJ,SACOH,GAAO;AACV,UAAM,EAAE,QAAA6B,GAAQ,QAAAC,GAAQ,SAAAV,EAAA,IAAYpB;AAMpC,gBAAM,QAAQ,IAAI,CAAC6B,GAAQC,CAAM,EAAE,IAAI,CAAA3B,MAAUA,KAAUoB,EAAOpB,CAAM,CAAC,CAAC,GAEtE,CAAC2B,KAAU,CAACD,KACZ/C,EAAI,MAAM,mBAAmBsC,CAAO,EAAE,GAGpCpB;AAAA,EACV;AACJ;AAUO,SAAS+B,EAAWC,GAAa;AACpC,SAAO,EAAE,KAAK,IAAM,KAAAA,EAAA;AACxB;AAWA,SAASC,EAAUX,GAAiBY,GAA4B;AAC5D,SAAIA,GAAS,mBACF,GAAGzD,CAAa,IAAIC,CAAO,IAAIC,CAAmB,IAAI2C,CAAO,KAGjE,GAAG7C,CAAa,IAAIG,CAAc,IAAI0C,CAAO;AACxD;AAaO,SAASa,EAAcb,GAAoBY,GAA4B;AAC1E,SAAI,OAAOZ,KAAY,aACZW,EAAUX,EAAQY,CAAO,GAAGA,CAAO,IAG1C,OAAOZ,KAAY,YAAYA,GAAS,QAAQ,KACzCA,EAAQ,MAGf,OAAOA,KAAY,WACZW,EAAUX,GAASY,CAAO,IAG9BZ;AACX;AAUA,eAAsBc,EAAgBC,GAA0B;AAC5D,QAAMC,IAAc,MAAM/D,EAAW,EAAE,MAAMC,GAAyB;AAEtE,MAAI8D,EAAY,SAAS;AACrB,UAAMC,IAAwB,EAAE,kBAAkBD,EAAY,OAAO,iBAAA,GAC/DE,IAAW,OAAOH,KAAU,aAAaA,EAAME,CAAG,IAAIF;AAE5D,WAAO,OAAO;AAAA,MACV,OAAO,QAAQG,CAAQ,EAAE,IAAI,CAAC,CAACC,GAAKT,CAAG,MAAM,CAACS,GAAKN,EAAcH,GAAKO,CAAG,CAAC,CAAC;AAAA,IAAA;AAAA,EAEnF;AACJ;AAaA,eAAsBG,EAAWC,GAAerB,GAAwBE,IAAwD,CAAA,GAAI;AAChI,MAAIoB;AAEJ,MAAI;AACA,UAAMC,IAAY,KAAK,IAAA;AACvB,IAAA/D,EAAI,MAAM,GAAG6D,CAAK,EAAE,GAEhB3D,EAAA,EAAS,QACTF,EAAI,KAAK,KAAKwC,CAAO,EAAE,IAGvBsB,IAAQ,YAAY,MAAM;AACtB,YAAME,IAAU,KAAK,OAAO,KAAK,IAAA,IAAQD,KAAa,GAAI;AAE1D,MAAIC,IAAU,KACV1E,EAAQ,OAAO,MAAM,OAAOuE,CAAK,OAAOG,CAAO,GAAG;AAAA,IAE1D,GAAG,GAAG,GAGV,MAAMzB,EAAeC,GAAST,GAAoBW,CAAO,GAErDoB,MACA,cAAcA,CAAK,GACnBxE,EAAQ,OAAO,MAAM,UAAU,IAGnCU,EAAI,QAAQ,GAAG6D,CAAK,QAAQ;AAAA,EAChC,SACO3C,GAAO;AAMV,QALI4C,MACA,cAAcA,CAAK,GACnBxE,EAAQ,OAAO,MAAM,UAAU,IAG/BoD,EAAQ;AACR,YAAMxB;AAEV,IAAAjB,EAAWiB,CAAK;AAAA,EACpB;AACJ;"}

package/dist/node/express/express.util.js

@@ -1,14 +1,14 @@
-import u from "node:process";
-import { NestFactory as n } from "@nestjs/core";
-import l from "compression";
-import m from "cookie-parser";
-import f from "cors";
+import { NestFactory as u } from "@nestjs/core";
+import n from "compression";
+import l from "cookie-parser";
+import m from "cors";
 import i from "express";
 import { default as G } from "express";
-import d from "express-session";
-import { express as p } from "express-useragent";
-import x from "graphql-upload/graphqlUploadExpress.mjs";
-import y from "helmet";
+import f from "express-session";
+import { express as d } from "express-useragent";
+import p from "graphql-upload/graphqlUploadExpress.mjs";
+import x from "helmet";
+import y from "node:process";
 function E({ isDev: e, whiteList: r, ...t }) {
   return {
     origin: (s, o) => {
@@ -19,7 +19,7 @@ function E({ isDev: e, whiteList: r, ...t }) {
   };
 }
 function F(e) {
-  return f(E(e));
+  return m(E(e));
 }
 function P(e) {
   const r = {
@@ -28,10 +28,10 @@ function P(e) {
     cookie: {
       httpOnly: !0,
       sameSite: "lax",
-      secure: u.env.NODE_ENV === "production"
+      secure: y.env.NODE_ENV === "production"
     }
   };
-  return d({
+  return f({
     ...r,
     ...e,
     cookie: { ...r.cookie, ...e.cookie }
@@ -39,11 +39,11 @@ function P(e) {
 }
 function c(e, r = !1, t = "1mb") {
   e.set("trust proxy", 1), e.use(
-    y({
+    x({
       crossOriginEmbedderPolicy: r ? !1 : void 0,
       contentSecurityPolicy: r ? !1 : void 0
     })
-  ), e.use(m()), e.use(i.json({ limit: t })), e.use(i.urlencoded({ extended: !0, limit: t })), e.use(l()), e.use(p());
+  ), e.use(l()), e.use(i.json({ limit: t })), e.use(i.urlencoded({ extended: !0, limit: t })), e.use(n()), e.use(d());
 }
 function a(e, r) {
   r && (Array.isArray(r) ? r : [r]).forEach((s) => {
@@ -52,13 +52,13 @@ function a(e, r) {
 }
 function z(e) {
   const r = i();
-  return c(r, e?.isDev, e?.jsonLimit), a(r, e?.static), r.use(x({
+  return c(r, e?.isDev, e?.jsonLimit), a(r, e?.static), r.use(p({
     maxFileSize: e?.maxFileSize ?? 1e7,
     maxFiles: e?.maxFiles ?? 10
   })), r;
 }
 async function C(e) {
-  const r = await n.create(e.module);
+  const r = await u.create(e.module);
   return c(r.getHttpAdapter().getInstance(), e.isDev, e.jsonLimit), a(r.getHttpAdapter().getInstance(), e.static), e.filters && r.useGlobalFilters(...e.filters), e.pipes && r.useGlobalPipes(...e.pipes), r;
 }
 export {

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

@@ -1 +1 @@
-{"version":3,"file":"express.util.js","sources":["../../../src/node/express/express.util.ts"],"sourcesContent":["import type { INestApplication } from '@nestjs/common';\nimport type { Application, RequestHandler } from 'express';\nimport type { SessionOptions } from 'express-session';\n\nimport process from 'node:process';\n\nimport { NestFactory } from '@nestjs/core';\nimport bodyParser from 'body-parser';\nimport compression from 'compression';\nimport cookieParser from 'cookie-parser';\nimport cors from 'cors';\nimport express from 'express';\nimport session from 'express-session';\nimport { express as useragent } from 'express-useragent';\nimport graphqlUploadExpress from 'graphql-upload/graphqlUploadExpress.mjs';\nimport helmet from 'helmet';\n\nimport type { I_ExpressOptions, I_NestOptions, T_CorsOptions, T_CorsType } from './express.type.js';\n\n/**\n * Creates CORS options with environment-specific configuration.\n * This function generates CORS options based on the development environment,\n * including whitelist configuration for allowed origins.\n *\n * @param options - CORS configuration options.\n * @param options.isDev - Whether the application is running in development mode.\n * @param options.whiteList - Array of allowed origins for CORS requests.\n * @returns CORS options object configured for the specified environment.\n */\nexport function createCorsOptions<T extends T_CorsType>({ isDev, whiteList, ...rest }: T_CorsOptions<T>) {\n    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            if (isDev || !origin || whiteList?.includes(origin ?? '')) {\n                callback(null, true);\n            }\n            else {\n                callback(new Error('Not allowed by CORS'), false);\n            }\n        },\n        credentials: true,\n        ...rest,\n    };\n}\n\n/**\n * Creates a CORS middleware function with the specified configuration.\n * This function creates a CORS middleware that can be used with both Express and NestJS applications,\n * applying the configured CORS options for origin validation and credential handling.\n *\n * @param options - CORS configuration options to apply to the middleware.\n * @returns A CORS middleware function ready to be used in Express or NestJS applications.\n */\nexport function createCors<T extends T_CorsType>(options: T_CorsOptions<T>) {\n    return cors<cors.CorsRequest>(createCorsOptions(options));\n}\n\n/**\n * Creates a session middleware function with the specified configuration.\n * This function creates an Express session middleware that can be used to handle user sessions\n * with the provided session options including secret, cookie settings, and storage configuration.\n *\n * @param options - Session configuration options including secret, cookie settings, and storage.\n * @returns A session middleware function ready to be used in Express applications.\n */\nexport function createSession(options: SessionOptions): RequestHandler {\n    const secureDefaults: Partial<SessionOptions> = {\n        resave: false,\n        saveUninitialized: false,\n        cookie: {\n            httpOnly: true,\n            sameSite: 'lax',\n            secure: process.env['NODE_ENV'] === 'production',\n        },\n    };\n\n    return session({\n        ...secureDefaults,\n        ...options,\n        cookie: { ...secureDefaults.cookie, ...options.cookie },\n    });\n}\n\n/**\n * Sets up common middleware for Express applications.\n * This function configures essential middleware including:\n * - Trust proxy settings for proper IP handling\n * - Cookie parsing for request cookies\n * - URL-encoded body parsing for form data\n * - Compression for response optimization\n * - User agent parsing for device/browser detection\n *\n * @param app - The Express application instance to configure with middleware.\n */\nfunction setupMiddleware(app: Application, isDev = false, jsonLimit = '1mb') {\n    app.set('trust proxy', 1);\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\n        }),\n    );\n    app.use(cookieParser());\n    app.use(express.json({ limit: jsonLimit }));\n    app.use(express.urlencoded({ extended: true, limit: jsonLimit }));\n    app.use(compression());\n    app.use(useragent());\n}\n\n/**\n * Sets up static file serving for Express applications.\n * This function configures static file serving for the specified folders,\n * making files in those directories accessible via HTTP requests.\n *\n * @param app - The Express application instance to configure with static file serving.\n * @param staticFolders - A string or array of strings representing the paths to serve statically.\n */\nfunction setupStaticFolders(app: Application, staticFolders?: string | string[]) {\n    if (staticFolders) {\n        const statics = Array.isArray(staticFolders) ? staticFolders : [staticFolders];\n        statics.forEach((folder) => {\n            app.use(`/${folder}`, express.static(folder));\n        });\n    }\n}\n\n/**\n * Creates and configures an Express application with common middleware and settings.\n * This function sets up a complete Express application with:\n * - Essential middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - GraphQL upload support for file uploads\n *\n * @param options - Optional configuration for the Express application including static folder paths.\n * @returns A configured Express application instance ready for use.\n */\nexport function createExpress(options?: I_ExpressOptions): Application {\n    const app = express();\n\n    setupMiddleware(app, options?.isDev, options?.jsonLimit);\n    setupStaticFolders(app, options?.static);\n    app.use(graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    }));\n\n    return app;\n}\n\n/**\n * Creates and configures a NestJS application with Express integration.\n * This function sets up a NestJS application with:\n * - Express HTTP adapter configuration\n * - Common middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - Global filters and pipes if provided\n *\n * @param options - Configuration options for the NestJS application including module, static folders, filters, and pipes.\n * @returns A promise that resolves to a configured NestJS application instance.\n */\nexport async function createNest(options: I_NestOptions): Promise<INestApplication> {\n    const app = await NestFactory.create(options.module);\n\n    setupMiddleware(app.getHttpAdapter().getInstance(), options.isDev, options.jsonLimit);\n    setupStaticFolders(app.getHttpAdapter().getInstance(), options.static);\n\n    if (options.filters) {\n        app.useGlobalFilters(...options.filters);\n    }\n\n    if (options.pipes) {\n        app.useGlobalPipes(...options.pipes);\n    }\n\n    return app;\n}\n\nexport { bodyParser, express };\n"],"names":["createCorsOptions","isDev","whiteList","rest","origin","callback","createCors","options","cors","createSession","secureDefaults","process","session","setupMiddleware","app","jsonLimit","helmet","cookieParser","express","compression","useragent","setupStaticFolders","staticFolders","folder","createExpress","graphqlUploadExpress","createNest","NestFactory"],"mappings":";;;;;;;;;;;AA6BO,SAASA,EAAwC,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA0B;AACrG,SAAO;AAAA,IACH,QAAQ,CAACC,GAA4BC,MAA2D;AAC5F,MAAIJ,KAAS,CAACG,KAAUF,GAAW,SAASE,KAAU,EAAE,IACpDC,EAAS,MAAM,EAAI,IAGnBA,EAAS,IAAI,MAAM,qBAAqB,GAAG,EAAK;AAAA,IAExD;AAAA,IACA,aAAa;AAAA,IACb,GAAGF;AAAA,EAAA;AAEX;AAUO,SAASG,EAAiCC,GAA2B;AACxE,SAAOC,EAAuBR,EAAkBO,CAAO,CAAC;AAC5D;AAUO,SAASE,EAAcF,GAAyC;AACnE,QAAMG,IAA0C;AAAA,IAC5C,QAAQ;AAAA,IACR,mBAAmB;AAAA,IACnB,QAAQ;AAAA,MACJ,UAAU;AAAA,MACV,UAAU;AAAA,MACV,QAAQC,EAAQ,IAAI,aAAgB;AAAA,IAAA;AAAA,EACxC;AAGJ,SAAOC,EAAQ;AAAA,IACX,GAAGF;AAAA,IACH,GAAGH;AAAA,IACH,QAAQ,EAAE,GAAGG,EAAe,QAAQ,GAAGH,EAAQ,OAAA;AAAA,EAAO,CACzD;AACL;AAaA,SAASM,EAAgBC,GAAkBb,IAAQ,IAAOc,IAAY,OAAO;AACzE,EAAAD,EAAI,IAAI,eAAe,CAAC,GACxBA,EAAI;AAAA,IACAE,EAAO;AAAA,MACH,2BAA2Bf,IAAQ,KAAQ;AAAA,MAC3C,uBAAuBA,IAAQ,KAAQ;AAAA,IAAA,CAC1C;AAAA,EAAA,GAELa,EAAI,IAAIG,GAAc,GACtBH,EAAI,IAAII,EAAQ,KAAK,EAAE,OAAOH,EAAA,CAAW,CAAC,GAC1CD,EAAI,IAAII,EAAQ,WAAW,EAAE,UAAU,IAAM,OAAOH,EAAA,CAAW,CAAC,GAChED,EAAI,IAAIK,GAAa,GACrBL,EAAI,IAAIM,GAAW;AACvB;AAUA,SAASC,EAAmBP,GAAkBQ,GAAmC;AAC7E,EAAIA,MACgB,MAAM,QAAQA,CAAa,IAAIA,IAAgB,CAACA,CAAa,GACrE,QAAQ,CAACC,MAAW;AACxB,IAAAT,EAAI,IAAI,IAAIS,CAAM,IAAIL,EAAQ,OAAOK,CAAM,CAAC;AAAA,EAChD,CAAC;AAET;AAYO,SAASC,EAAcjB,GAAyC;AACnE,QAAMO,IAAMI,EAAA;AAEZ,SAAAL,EAAgBC,GAAKP,GAAS,OAAOA,GAAS,SAAS,GACvDc,EAAmBP,GAAKP,GAAS,MAAM,GACvCO,EAAI,IAAIW,EAAqB;AAAA,IACzB,aAAalB,GAAS,eAAe;AAAA,IACrC,UAAUA,GAAS,YAAY;AAAA,EAAA,CAClC,CAAC,GAEKO;AACX;AAaA,eAAsBY,EAAWnB,GAAmD;AAChF,QAAMO,IAAM,MAAMa,EAAY,OAAOpB,EAAQ,MAAM;AAEnD,SAAAM,EAAgBC,EAAI,iBAAiB,YAAA,GAAeP,EAAQ,OAAOA,EAAQ,SAAS,GACpFc,EAAmBP,EAAI,eAAA,EAAiB,YAAA,GAAeP,EAAQ,MAAM,GAEjEA,EAAQ,WACRO,EAAI,iBAAiB,GAAGP,EAAQ,OAAO,GAGvCA,EAAQ,SACRO,EAAI,eAAe,GAAGP,EAAQ,KAAK,GAGhCO;AACX;"}
+{"version":3,"file":"express.util.js","sources":["../../../src/node/express/express.util.ts"],"sourcesContent":["import type { INestApplication } from '@nestjs/common';\nimport type { Application, RequestHandler } from 'express';\nimport type { SessionOptions } from 'express-session';\n\nimport { NestFactory } from '@nestjs/core';\nimport bodyParser from 'body-parser';\nimport compression from 'compression';\nimport cookieParser from 'cookie-parser';\nimport cors from 'cors';\nimport express from 'express';\nimport session from 'express-session';\nimport { express as useragent } from 'express-useragent';\nimport graphqlUploadExpress from 'graphql-upload/graphqlUploadExpress.mjs';\nimport helmet from 'helmet';\nimport process from 'node:process';\n\nimport type { I_ExpressOptions, I_NestOptions, T_CorsOptions, T_CorsType } from './express.type.js';\n\n/**\n * Creates CORS options with environment-specific configuration.\n * This function generates CORS options based on the development environment,\n * including whitelist configuration for allowed origins.\n *\n * @param options - CORS configuration options.\n * @param options.isDev - Whether the application is running in development mode.\n * @param options.whiteList - Array of allowed origins for CORS requests.\n * @returns CORS options object configured for the specified environment.\n */\nexport function createCorsOptions<T extends T_CorsType>({ isDev, whiteList, ...rest }: T_CorsOptions<T>) {\n    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            if (isDev || !origin || whiteList?.includes(origin ?? '')) {\n                callback(null, true);\n            }\n            else {\n                callback(new Error('Not allowed by CORS'), false);\n            }\n        },\n        credentials: true,\n        ...rest,\n    };\n}\n\n/**\n * Creates a CORS middleware function with the specified configuration.\n * This function creates a CORS middleware that can be used with both Express and NestJS applications,\n * applying the configured CORS options for origin validation and credential handling.\n *\n * @param options - CORS configuration options to apply to the middleware.\n * @returns A CORS middleware function ready to be used in Express or NestJS applications.\n */\nexport function createCors<T extends T_CorsType>(options: T_CorsOptions<T>) {\n    return cors<cors.CorsRequest>(createCorsOptions(options));\n}\n\n/**\n * Creates a session middleware function with the specified configuration.\n * This function creates an Express session middleware that can be used to handle user sessions\n * with the provided session options including secret, cookie settings, and storage configuration.\n *\n * @param options - Session configuration options including secret, cookie settings, and storage.\n * @returns A session middleware function ready to be used in Express applications.\n */\nexport function createSession(options: SessionOptions): RequestHandler {\n    const secureDefaults: Partial<SessionOptions> = {\n        resave: false,\n        saveUninitialized: false,\n        cookie: {\n            httpOnly: true,\n            sameSite: 'lax',\n            secure: process.env['NODE_ENV'] === 'production',\n        },\n    };\n\n    return session({\n        ...secureDefaults,\n        ...options,\n        cookie: { ...secureDefaults.cookie, ...options.cookie },\n    });\n}\n\n/**\n * Sets up common middleware for Express applications.\n * This function configures essential middleware including:\n * - Trust proxy settings for proper IP handling\n * - Cookie parsing for request cookies\n * - URL-encoded body parsing for form data\n * - Compression for response optimization\n * - User agent parsing for device/browser detection\n *\n * @param app - The Express application instance to configure with middleware.\n */\nfunction setupMiddleware(app: Application, isDev = false, jsonLimit = '1mb') {\n    app.set('trust proxy', 1);\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\n        }),\n    );\n    app.use(cookieParser());\n    app.use(express.json({ limit: jsonLimit }));\n    app.use(express.urlencoded({ extended: true, limit: jsonLimit }));\n    app.use(compression());\n    app.use(useragent());\n}\n\n/**\n * Sets up static file serving for Express applications.\n * This function configures static file serving for the specified folders,\n * making files in those directories accessible via HTTP requests.\n *\n * @param app - The Express application instance to configure with static file serving.\n * @param staticFolders - A string or array of strings representing the paths to serve statically.\n */\nfunction setupStaticFolders(app: Application, staticFolders?: string | string[]) {\n    if (staticFolders) {\n        const statics = Array.isArray(staticFolders) ? staticFolders : [staticFolders];\n        statics.forEach((folder) => {\n            app.use(`/${folder}`, express.static(folder));\n        });\n    }\n}\n\n/**\n * Creates and configures an Express application with common middleware and settings.\n * This function sets up a complete Express application with:\n * - Essential middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - GraphQL upload support for file uploads\n *\n * @param options - Optional configuration for the Express application including static folder paths.\n * @returns A configured Express application instance ready for use.\n */\nexport function createExpress(options?: I_ExpressOptions): Application {\n    const app = express();\n\n    setupMiddleware(app, options?.isDev, options?.jsonLimit);\n    setupStaticFolders(app, options?.static);\n    app.use(graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    }));\n\n    return app;\n}\n\n/**\n * Creates and configures a NestJS application with Express integration.\n * This function sets up a NestJS application with:\n * - Express HTTP adapter configuration\n * - Common middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - Global filters and pipes if provided\n *\n * @param options - Configuration options for the NestJS application including module, static folders, filters, and pipes.\n * @returns A promise that resolves to a configured NestJS application instance.\n */\nexport async function createNest(options: I_NestOptions): Promise<INestApplication> {\n    const app = await NestFactory.create(options.module);\n\n    setupMiddleware(app.getHttpAdapter().getInstance(), options.isDev, options.jsonLimit);\n    setupStaticFolders(app.getHttpAdapter().getInstance(), options.static);\n\n    if (options.filters) {\n        app.useGlobalFilters(...options.filters);\n    }\n\n    if (options.pipes) {\n        app.useGlobalPipes(...options.pipes);\n    }\n\n    return app;\n}\n\nexport { bodyParser, express };\n"],"names":["createCorsOptions","isDev","whiteList","rest","origin","callback","createCors","options","cors","createSession","secureDefaults","process","session","setupMiddleware","app","jsonLimit","helmet","cookieParser","express","compression","useragent","setupStaticFolders","staticFolders","folder","createExpress","graphqlUploadExpress","createNest","NestFactory"],"mappings":";;;;;;;;;;;AA4BO,SAASA,EAAwC,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA0B;AACrG,SAAO;AAAA,IACH,QAAQ,CAACC,GAA4BC,MAA2D;AAC5F,MAAIJ,KAAS,CAACG,KAAUF,GAAW,SAASE,KAAU,EAAE,IACpDC,EAAS,MAAM,EAAI,IAGnBA,EAAS,IAAI,MAAM,qBAAqB,GAAG,EAAK;AAAA,IAExD;AAAA,IACA,aAAa;AAAA,IACb,GAAGF;AAAA,EAAA;AAEX;AAUO,SAASG,EAAiCC,GAA2B;AACxE,SAAOC,EAAuBR,EAAkBO,CAAO,CAAC;AAC5D;AAUO,SAASE,EAAcF,GAAyC;AACnE,QAAMG,IAA0C;AAAA,IAC5C,QAAQ;AAAA,IACR,mBAAmB;AAAA,IACnB,QAAQ;AAAA,MACJ,UAAU;AAAA,MACV,UAAU;AAAA,MACV,QAAQC,EAAQ,IAAI,aAAgB;AAAA,IAAA;AAAA,EACxC;AAGJ,SAAOC,EAAQ;AAAA,IACX,GAAGF;AAAA,IACH,GAAGH;AAAA,IACH,QAAQ,EAAE,GAAGG,EAAe,QAAQ,GAAGH,EAAQ,OAAA;AAAA,EAAO,CACzD;AACL;AAaA,SAASM,EAAgBC,GAAkBb,IAAQ,IAAOc,IAAY,OAAO;AACzE,EAAAD,EAAI,IAAI,eAAe,CAAC,GACxBA,EAAI;AAAA,IACAE,EAAO;AAAA,MACH,2BAA2Bf,IAAQ,KAAQ;AAAA,MAC3C,uBAAuBA,IAAQ,KAAQ;AAAA,IAAA,CAC1C;AAAA,EAAA,GAELa,EAAI,IAAIG,GAAc,GACtBH,EAAI,IAAII,EAAQ,KAAK,EAAE,OAAOH,EAAA,CAAW,CAAC,GAC1CD,EAAI,IAAII,EAAQ,WAAW,EAAE,UAAU,IAAM,OAAOH,EAAA,CAAW,CAAC,GAChED,EAAI,IAAIK,GAAa,GACrBL,EAAI,IAAIM,GAAW;AACvB;AAUA,SAASC,EAAmBP,GAAkBQ,GAAmC;AAC7E,EAAIA,MACgB,MAAM,QAAQA,CAAa,IAAIA,IAAgB,CAACA,CAAa,GACrE,QAAQ,CAACC,MAAW;AACxB,IAAAT,EAAI,IAAI,IAAIS,CAAM,IAAIL,EAAQ,OAAOK,CAAM,CAAC;AAAA,EAChD,CAAC;AAET;AAYO,SAASC,EAAcjB,GAAyC;AACnE,QAAMO,IAAMI,EAAA;AAEZ,SAAAL,EAAgBC,GAAKP,GAAS,OAAOA,GAAS,SAAS,GACvDc,EAAmBP,GAAKP,GAAS,MAAM,GACvCO,EAAI,IAAIW,EAAqB;AAAA,IACzB,aAAalB,GAAS,eAAe;AAAA,IACrC,UAAUA,GAAS,YAAY;AAAA,EAAA,CAClC,CAAC,GAEKO;AACX;AAaA,eAAsBY,EAAWnB,GAAmD;AAChF,QAAMO,IAAM,MAAMa,EAAY,OAAOpB,EAAQ,MAAM;AAEnD,SAAAM,EAAgBC,EAAI,iBAAiB,YAAA,GAAeP,EAAQ,OAAOA,EAAQ,SAAS,GACpFc,EAAmBP,EAAI,eAAA,EAAiB,YAAA,GAAeP,EAAQ,MAAM,GAEjEA,EAAQ,WACRO,EAAI,iBAAiB,GAAGP,EAAQ,OAAO,GAGvCA,EAAQ,SACRO,EAAI,eAAe,GAAGP,EAAQ,KAAK,GAGhCO;AACX;"}

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

@@ -1,7 +1,7 @@
+export * from './mongo.controller.mongoose.js';
 /**
  * Re-exports both MongoDB controller implementations.
  * - MongoController: Native MongoDB driver operations
  * - MongooseController: Mongoose ORM with pagination, aggregation, and slug generation
  */
 export * from './mongo.controller.native.js';
-export * from './mongo.controller.mongoose.js';