@cyberskill/shared 3.2.0 → 3.3.0

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

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

package/dist/node/command/index.js

@@ -1,12 +1,3 @@
-import { E_CommandType as m } from "./command.type.js";
-import { clearAllErrorLists as e, formatCommand as t, getStoredErrorLists as d, rawCommand as n, resolveCommands as s, runCommand as C } from "./command.util.js";
-export {
-  m as E_CommandType,
-  e as clearAllErrorLists,
-  t as formatCommand,
-  d as getStoredErrorLists,
-  n as rawCommand,
-  s as resolveCommands,
-  C as runCommand
-};
-//# sourceMappingURL=index.js.map
+import { E_CommandType as e } from "./command.type.js";
+import { clearAllErrorLists as t, formatCommand as n, getStoredErrorLists as r, rawCommand as i, resolveCommands as a, runCommand as o } from "./command.util.js";
+export { e as E_CommandType, t as clearAllErrorLists, n as formatCommand, r as getStoredErrorLists, i as rawCommand, a as resolveCommands, o as runCommand };

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

@@ -1,14 +1,23 @@
 import { ExceptionFilter, Type, ValidationPipe } from '@nestjs/common';
 import { CorsOptions as CorsOptionsNestJS } from '@nestjs/common/interfaces/external/cors-options.interface.js';
 import { CorsOptions, CorsOptionsDelegate, CorsRequest } from 'cors';
+import { Store } from 'express-rate-limit';
 export type { NextFunction, Request, Response } from 'express';
 export { Router } from 'express';
+export interface I_RateLimitOptions {
+    windowMs?: number;
+    limit?: number;
+    store?: Store;
+    skip?: (req: import('express').Request) => boolean | Promise<boolean>;
+}
 export interface I_ExpressOptions {
     isDev?: boolean;
     static?: string | string[];
     maxFileSize?: number;
     maxFiles?: number;
     jsonLimit?: string;
+    trustProxy?: boolean | number | string | string[];
+    rateLimit?: false | I_RateLimitOptions;
 }
 export interface I_NestOptions {
     module: Type<object>;
@@ -17,6 +26,8 @@ export interface I_NestOptions {
     filters?: ExceptionFilter[];
     pipes?: ValidationPipe[];
     jsonLimit?: string;
+    trustProxy?: boolean | number | string | string[];
+    rateLimit?: false | I_RateLimitOptions;
 }
 export type T_CorsType = 'node' | 'nest';
 interface I_BaseCorsOptions {

package/dist/node/express/express.type.js

@@ -0,0 +1,2 @@
+import { Router as e } from "express";
+export { e as Router };

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

@@ -1,72 +1,81 @@
-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 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) => {
-      e || !s || r?.includes(s ?? "") ? o(null, !0) : o(new Error("Not allowed by CORS"), !1);
-    },
-    credentials: !0,
-    ...t
-  };
+import e from "node:process";
+import t from "express";
+import { NestFactory as n } from "@nestjs/core";
+import r from "body-parser";
+import i from "compression";
+import a from "cookie-parser";
+import o from "cors";
+import s from "express-rate-limit";
+import c from "express-session";
+import { express as l } from "express-useragent";
+import u from "graphql-upload/graphqlUploadExpress.mjs";
+import d from "helmet";
+//#region src/node/express/express.util.ts
+function f({ isDev: e, whiteList: t, ...n }) {
+	return {
+		origin: (n, r) => {
+			e || !n || t?.includes(n ?? "") ? r(null, !0) : r(/* @__PURE__ */ Error("Not allowed by CORS"), !1);
+		},
+		credentials: !0,
+		...n
+	};
 }
-function F(e) {
-  return m(E(e));
+function p(e) {
+	return o(f(e));
 }
-function P(e) {
-  const r = {
-    resave: !1,
-    saveUninitialized: !1,
-    cookie: {
-      httpOnly: !0,
-      sameSite: "lax",
-      secure: y.env.NODE_ENV === "production"
-    }
-  };
-  return f({
-    ...r,
-    ...e,
-    cookie: { ...r.cookie, ...e.cookie }
-  });
+function m(t) {
+	if (!t.secret) throw Error("Session secret is required. Provide a strong secret string.");
+	let n = {
+		resave: !1,
+		saveUninitialized: !1,
+		cookie: {
+			httpOnly: !0,
+			sameSite: "lax",
+			secure: e.env.NODE_ENV === "production"
+		}
+	};
+	return c({
+		...n,
+		...t,
+		cookie: {
+			...n.cookie,
+			...t.cookie
+		}
+	});
 }
-function c(e, r = !1, t = "1mb") {
-  e.set("trust proxy", 1), e.use(
-    x({
-      crossOriginEmbedderPolicy: r ? !1 : void 0,
-      contentSecurityPolicy: r ? !1 : void 0
-    })
-  ), e.use(l()), e.use(i.json({ limit: t })), e.use(i.urlencoded({ extended: !0, limit: t })), e.use(n()), e.use(d());
+function h(e, n = !1, r = "1mb", o = !1, c = {}) {
+	o !== !1 && e.set("trust proxy", o), e.use(d({
+		crossOriginEmbedderPolicy: n ? !1 : void 0,
+		contentSecurityPolicy: n ? !1 : void 0
+	})), c !== !1 && e.use(s({
+		windowMs: c.windowMs ?? 900 * 1e3,
+		limit: c.limit ?? 1e3,
+		standardHeaders: !0,
+		legacyHeaders: !1,
+		...c.store !== void 0 && { store: c.store },
+		...c.skip !== void 0 && { skip: c.skip }
+	})), e.use(a()), e.use(t.json({ limit: r })), e.use(t.urlencoded({
+		extended: !0,
+		limit: r
+	})), e.use(i()), e.use(l());
 }
-function a(e, r) {
-  r && (Array.isArray(r) ? r : [r]).forEach((s) => {
-    e.use(`/${s}`, i.static(s));
-  });
+function g(e, n) {
+	n && (Array.isArray(n) ? n : [n]).forEach((n) => {
+		e.use(`/${n}`, t.static(n));
+	});
 }
-function z(e) {
-  const r = i();
-  return c(r, e?.isDev, e?.jsonLimit), a(r, e?.static), r.use(p({
-    maxFileSize: e?.maxFileSize ?? 1e7,
-    maxFiles: e?.maxFiles ?? 10
-  })), r;
+function _(e) {
+	let n = t();
+	return h(n, e?.isDev, e?.jsonLimit, e?.trustProxy, e?.rateLimit), g(n, e?.static), n.use(u({
+		maxFileSize: e?.maxFileSize ?? 1e7,
+		maxFiles: e?.maxFiles ?? 10
+	})), n;
 }
-async function C(e) {
-  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;
+async function v(e) {
+	let t = await n.create(e.module);
+	return h(t.getHttpAdapter().getInstance(), e.isDev, e.jsonLimit, e.trustProxy, e.rateLimit), g(t.getHttpAdapter().getInstance(), e.static), e.filters && t.useGlobalFilters(...e.filters), e.pipes && t.useGlobalPipes(...e.pipes), t;
 }
-export {
-  F as createCors,
-  E as createCorsOptions,
-  z as createExpress,
-  C as createNest,
-  P as createSession,
-  G as express
-};
-//# sourceMappingURL=express.util.js.map
+//#endregion
+export { r as bodyParser, p as createCors, f as createCorsOptions, _ as createExpress, v as createNest, m as createSession, t as express };
+
+//# sourceMappingURL=express.util.js.map