@cyberskill/shared 3.0.0 → 3.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/node/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport process from 'node:process';\nimport { hideBin } from 'yargs/helpers';\nimport yargs from 'yargs/yargs';\n\nimport type { I_IssueEntry } from '../log/index.js';\n\nimport { clearAllErrorLists, getStoredErrorLists, resolveCommands, runCommand } from '../command/index.js';\nimport { addGitIgnoreEntry, pathExistsSync, readFileSync, removeSync, writeFileSync } from '../fs/index.js';\nimport { catchError, E_IssueType, log } from '../log/index.js';\nimport { getPackage, installDependencies } from '../package/index.js';\nimport { AG_KIT_PACKAGE_NAME, command, createGitHooksConfig, CYBERSKILL_CLI, CYBERSKILL_PACKAGE_NAME, DOT_AGENT, PATH, resolve, SIMPLE_GIT_HOOK_JSON } from '../path/index.js';\n\n/**\n * Retrieves the version from the package.json file.\n * This function reads the package.json file and extracts the version number.\n * If the file cannot be read or parsed, it returns a default version of '1.0.0'.\n *\n * @returns The version string from package.json or '1.0.0' as fallback.\n */\nfunction getVersion(): string {\n    try {\n        const pkg = JSON.parse(\n            readFileSync(resolve(__dirname, '../../../package.json'), 'utf-8'),\n        );\n        return pkg.version;\n    }\n    catch {\n        return '1.0.0';\n    }\n}\n\n/**\n * Performs TypeScript validation if a TypeScript configuration file exists.\n * This function checks for the presence of a TypeScript configuration file\n * and runs TypeScript validation if found. If no configuration is found,\n * it logs a warning and skips the type check.\n *\n * @returns A promise that resolves when the TypeScript validation is complete.\n */\nasync function checkTypescript() {\n    if (pathExistsSync(PATH.TS_CONFIG)) {\n        await runCommand('Performing TypeScript validation', await command.typescriptCheck());\n    }\n    else {\n        log.warn('No TypeScript configuration found. Skipping type check.');\n    }\n}\n\n/**\n * Performs ESLint checking with optional auto-fix functionality.\n * This function runs ESLint checks on the codebase and optionally applies\n * automatic fixes to resolve linting issues.\n *\n * @param fix - Whether to apply automatic fixes to linting issues (default: false).\n * @returns A promise that resolves when the ESLint check is complete.\n */\nasync function checkEslint(fix = false) {\n    const commandToRun = fix ? await command.eslintFix() : await command.eslintCheck();\n    const label = fix ? 'Running ESLint with auto-fix' : 'Running ESLint check';\n\n    try {\n        await runCommand(label, commandToRun, { timeout: 60000, throwOnError: true });\n    }\n    catch (error: any) {\n        if (error.code === 'ETIMEDOUT' || error.killed || error.signal === 'SIGTERM') {\n            log.warn('Lint check timed out. Retrying with debug mode enabled...');\n            process.env['DEBUG'] = 'true';\n            await runCommand(`${label} (Debug Mode)`, commandToRun);\n        }\n        else {\n            catchError(error);\n        }\n    }\n}\n\n/**\n * Prints a formatted list of issues (errors or warnings) to the console.\n * This function displays issues in a boxed format with appropriate color coding\n * based on the issue type. It only displays issues if the list is not empty.\n *\n * @param type - The type of issues to display ('Errors' or 'Warnings').\n * @param list - An array of issue entries to display.\n */\nfunction printIssues(type: 'Errors' | 'Warnings', list: I_IssueEntry[]) {\n    if (!list.length) {\n        return;\n    }\n\n    const color = type === 'Errors' ? 'red' : 'yellow';\n    log.printBoxedLog(type === 'Errors' ? '✖ Errors' : '⚠ Warnings', list, color);\n}\n\n/**\n * Displays the final check results after all validation processes.\n * This function retrieves stored error lists and displays them in a formatted manner.\n * If no errors or warnings are found, it displays a success message. If errors are found,\n * it exits the process with code 1 to indicate failure.\n *\n * @returns A promise that resolves when the results are displayed.\n */\nasync function showCheckResult() {\n    setTimeout(async () => {\n        const allResults = (await getStoredErrorLists()) || [];\n        const errors = allResults.filter(e => e.type === E_IssueType.Error);\n        const warnings = allResults.filter(e => e.type === E_IssueType.Warning);\n\n        if (!errors.length && !warnings.length) {\n            log.printBoxedLog('✔ NO ISSUES FOUND', [], 'green');\n        }\n        else {\n            printIssues('Warnings', warnings);\n            printIssues('Errors', errors);\n\n            if (errors.length > 0) {\n                process.exit(1);\n            }\n        }\n    }, 0);\n}\n\n/**\n * Executes lint-staged to check only staged files.\n * This function runs lint-staged which executes linting tools only on files\n * that are staged for commit. It includes building the package if it's the current project\n * and displays the results after completion.\n *\n * @returns A promise that resolves when lint-staged execution is complete.\n */\nasync function lintStaged() {\n    await clearAllErrorLists();\n    const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n\n    if (!packageData.success) {\n        log.error('Failed to retrieve package information. Aborting lint-staged.');\n        return;\n    }\n\n    if (packageData.result.isCurrentProject) {\n        await runCommand(`Building package: ${CYBERSKILL_PACKAGE_NAME}`, await command.build());\n    }\n\n    await runCommand('Executing lint-staged', await command.lintStaged());\n    showCheckResult();\n}\n\n/**\n * Inspects the ESLint configuration to show active rules and settings.\n * This function runs ESLint inspection to display the current configuration,\n * including which rules are active and their settings.\n *\n * @returns A promise that resolves when the ESLint inspection is complete.\n */\nasync function inspectLint() {\n    await runCommand('Inspecting ESLint configuration', await command.eslintInspect());\n}\n\n/**\n * Performs comprehensive linting checks including TypeScript and ESLint.\n * This function runs both TypeScript validation and ESLint checks in parallel,\n * then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks are complete.\n */\nasync function lintCheck() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint();\n    showCheckResult();\n}\n\n/**\n * Performs comprehensive linting checks with automatic fixes.\n * This function runs both TypeScript validation and ESLint checks with auto-fix\n * in parallel, then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks with fixes are complete.\n */\nasync function lintFix() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint(true);\n    showCheckResult();\n}\n\n/**\n * Validates commit message format using commitlint.\n * This function runs commitlint to check if the current commit message\n * follows the conventional commit format and displays the results.\n *\n * @returns A promise that resolves when commit message validation is complete.\n */\nasync function commitLint() {\n    await clearAllErrorLists();\n    await runCommand('Validating commit message', await command.commitLint());\n    showCheckResult();\n}\n\n/**\n * Sets up Git hooks for automated code quality checks.\n * This function configures Git hooks using simple-git-hooks, creates the necessary\n * configuration files, and updates .gitignore to exclude hook configuration files.\n * It also sets up the hooks to run linting and commit validation automatically.\n *\n * @returns A promise that resolves when Git hook setup is complete.\n */\nasync function gitHookSetup() {\n    await runCommand('Configuring Git hooks', await command.configureGitHook());\n\n    removeSync(PATH.GIT_HOOK);\n\n    const hooks = await resolveCommands(createGitHooksConfig);\n\n    writeFileSync(PATH.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(hooks, null, 4));\n\n    addGitIgnoreEntry(PATH.GIT_IGNORE, SIMPLE_GIT_HOOK_JSON);\n\n    await runCommand('Setting up simple-git-hooks', await command.simpleGitHooks());\n}\n\n/**\n * Sets up the AI agent environment.\n * This function ensures the ag-kit package is installed globally, initializes\n * or updates the AI agent configuration, and adds the agent directory\n * to .gitignore to exclude it from version control.\n *\n * @returns A promise that resolves when the AI agent setup is complete.\n */\nasync function aiSetup() {\n    try {\n        await runCommand(`Checking for ${AG_KIT_PACKAGE_NAME}`, `pnpm list -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n    catch {\n        await runCommand(`Installing ${AG_KIT_PACKAGE_NAME} globally`, `pnpm i -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n\n    if (pathExistsSync(PATH.DOT_AGENT)) {\n        await runCommand('Updating AI agent', 'echo y | ag-kit update');\n    }\n    else {\n        await runCommand('Initializing AI agent', 'ag-kit init');\n    }\n\n    addGitIgnoreEntry(PATH.GIT_EXCLUDE, DOT_AGENT);\n}\n\n/**\n * Initializes the project with dependencies and Git hooks.\n * This function installs project dependencies and sets up Git hooks for\n * automated code quality checks. It's typically run when setting up a new project.\n *\n * @returns A promise that resolves when project initialization is complete.\n */\nasync function ready() {\n    await installDependencies();\n    await gitHookSetup();\n}\n\n/**\n * Resets the project by removing dependencies and reinstalling them.\n * This function removes node_modules and lock files, cleans the package manager cache,\n * reinstalls dependencies, and sets up Git hooks. It's useful for resolving\n * dependency-related issues.\n *\n * @returns A promise that resolves when project reset is complete.\n */\nasync function reset() {\n    removeSync(PATH.NODE_MODULES, PATH.PNPM_LOCK_YAML);\n    await runCommand('Pruning pnpm store', await command.pnpmPruneStore());\n    await runCommand('Clearing pnpm cache', await command.pnpmCleanCache());\n    await installDependencies();\n    await gitHookSetup();\n    await aiSetup();\n}\n\n/**\n * Inspects project dependencies to analyze their status.\n * This function runs dependency inspection to check for outdated packages,\n * security vulnerabilities, and other dependency-related issues.\n *\n * @returns A promise that resolves when dependency inspection is complete.\n */\nasync function inspect() {\n    await runCommand('Inspecting project dependencies', await command.nodeModulesInspect());\n}\n\n/**\n * Runs the unit test suite.\n * This function executes unit tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when unit tests are complete.\n */\nasync function testUnit() {\n    try {\n        const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n        const cmd = packageData.success && packageData.result.isCurrentProject\n            ? `pnpm exec vitest run`\n            : await command.testUnit();\n\n        await runCommand('Running unit tests', cmd, { throwOnError: true });\n    }\n    catch {\n        process.exit(1);\n    }\n}\n\n/**\n * Runs the end-to-end test suite.\n * This function executes end-to-end tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when end-to-end tests are complete.\n */\nasync function testE2E() {\n    try {\n        const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n        const cmd = packageData.success && packageData.result.isCurrentProject\n            ? `pnpm exec vitest run --passWithNoTests --config src/config/vitest/vitest.e2e.ts`\n            : await command.testE2e();\n\n        await runCommand('Running end-to-end tests', cmd, { throwOnError: true });\n    }\n    catch {\n        process.exit(1);\n    }\n}\n\n/**\n * Creates a new MongoDB migration file.\n * This function creates a new migration file with the specified name\n * for database schema changes.\n *\n * @param migrationName - The name for the new migration file.\n * @returns A promise that resolves when the migration file is created.\n */\nasync function mongoMigrateCreate(migrationName: string) {\n    await runCommand('Creating MongoDB migration', await command.mongoMigrateCreate(migrationName));\n}\n\n/**\n * Applies all pending MongoDB migrations.\n * This function runs all pending database migrations to update the database schema\n * to the latest version.\n *\n * @returns A promise that resolves when all migrations are applied.\n */\nasync function mongoMigrateUp() {\n    await runCommand('Running MongoDB migrations', await command.mongoMigrateUp());\n}\n\n/**\n * Rolls back the last applied MongoDB migration.\n * This function reverts the most recent database migration, undoing\n * the last schema change.\n *\n * @returns A promise that resolves when the migration is rolled back.\n */\nasync function mongoMigrateDown() {\n    await runCommand('Rolling back MongoDB migration', await command.mongoMigrateDown());\n}\n\n/**\n * Starts the Storybook development server.\n * This function runs Storybook in development mode, allowing you to\n * view and interact with your component stories in a browser.\n *\n * @returns A promise that resolves when the Storybook dev server is started.\n */\nasync function storybookDev() {\n    await runCommand('Starting Storybook development server', await command.storybookDev());\n}\n\n/**\n * Builds Storybook for production deployment.\n * This function creates a static build of Storybook that can be\n * deployed to a web server or hosting service.\n *\n * @returns A promise that resolves when the Storybook build is complete.\n */\nasync function storybookBuild() {\n    await runCommand('Building Storybook', await command.storybookBuild());\n}\n\n(async () => {\n    try {\n        await yargs(hideBin(process.argv))\n            .scriptName(CYBERSKILL_CLI)\n            .usage('$0 <command> [options]')\n            .command('ai:setup', 'Setup AI agent environment', aiSetup)\n            .command('lint', 'Check code for linting issues', lintCheck)\n            .command('lint:fix', 'Fix linting issues automatically', lintFix)\n            .command('lint:inspect', 'View active ESLint configuration', inspectLint)\n            .command('lint-staged', 'Run lint checks on staged files', lintStaged)\n            .command('commitlint', 'Validate commit message format', commitLint)\n            .command('ready', 'Initialize project and dependencies', ready)\n            .command('reset', 'Reset the project and reinstall dependencies', reset)\n            .command('inspect', 'Analyze installed project dependencies', inspect)\n            .command('test:unit', 'Run unit test suite', testUnit)\n            .command('test:e2e', 'Run end-to-end test suite', testE2E)\n            .command('mongo:migrate:create <name>', 'Create a MongoDB migration', y =>\n                y.positional('name', {\n                    describe: 'Migration name',\n                    type: 'string',\n                }), async (argv) => {\n                if (!argv.name) {\n                    log.error('Migration name is required.');\n\n                    return;\n                }\n\n                await mongoMigrateCreate(argv.name);\n            })\n            .command('mongo:migrate:up', 'Apply all MongoDB migrations', mongoMigrateUp)\n            .command('mongo:migrate:down', 'Rollback last MongoDB migration', mongoMigrateDown)\n            .command('storybook:dev', 'Start Storybook development server', storybookDev)\n            .command('storybook:build', 'Build Storybook for production', storybookBuild)\n            .demandCommand(1, 'Please specify a valid command.')\n            .strict()\n            .help()\n            .alias('h', 'help')\n            .alias('v', 'version')\n            .version(getVersion())\n            .epilog('💡 Tip: Use \"--help\" with any command to see options\\n')\n            .parse();\n    }\n    catch (error) {\n        catchError(error);\n        process.exit(1);\n    }\n})();\n"],"names":["process","hideBin","yargs","runCommand","clearAllErrorLists","getStoredErrorLists","resolveCommands","getPackage","installDependencies","pathExistsSync","addGitIgnoreEntry","removeSync","readFileSync","writeFileSync","resolve","CYBERSKILL_CLI","command","CYBERSKILL_PACKAGE_NAME","PATH","SIMPLE_GIT_HOOK_JSON","createGitHooksConfig","AG_KIT_PACKAGE_NAME","DOT_AGENT","log","catchError","E_IssueType","getVersion","checkTypescript","checkEslint","fix","commandToRun","label","error","printIssues","type","list","color","showCheckResult","allResults","errors","warnings","lintStaged","packageData","inspectLint","lintCheck","lintFix","commitLint","gitHookSetup","hooks","aiSetup","ready","reset","inspect","testUnit","cmd","testE2E","mongoMigrateCreate","migrationName","mongoMigrateUp","mongoMigrateDown","storybookDev","storybookBuild","y","argv"],"mappings":"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"}

package/dist/node/command/command.type.js

@@ -2,3 +2,4 @@ var N = /* @__PURE__ */ ((I) => (I.CLI = "CLI", I.STRING = "STRING", I.FUNCTION
 export {
   N as E_CommandType
 };
+//# sourceMappingURL=command.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.type.js","sources":["../../../src/node/command/command.type.ts"],"sourcesContent":["/**\n * Interface representing an ESLint error structure.\n */\nexport interface I_EslintError {\n    filePath: string;\n    messages: Array<{\n        ruleId: string;\n        severity: number;\n        message: string;\n        line: number;\n        column: number;\n    }>;\n}\n\n/**\n * Interface representing the command execution context.\n */\nexport interface I_CommandContext {\n    isCurrentProject: boolean;\n}\n\n/**\n * Interface representing a command with raw flag and command string.\n */\nexport interface I_Command { raw: boolean; cmd: string }\n\n/**\n * Type for a function that generates a command string based on context.\n */\nexport type T_CommandFunction = (context?: I_CommandContext) => string;\n\n/**\n * Type for a command, which can be a string, function that returns a string, or a raw command object.\n */\nexport type T_Command = string | T_CommandFunction | I_Command;\n\n/**\n * Type for a command map input, which can be a record or a function returning a record.\n */\nexport type T_CommandMapInput = Record<string, T_Command> | ((context: I_CommandContext) => Record<string, T_Command>);\n\n/**\n * Enum for command types: CLI, STRING, or FUNCTION.\n */\nexport enum E_CommandType {\n    CLI = 'CLI',\n    STRING = 'STRING',\n    FUNCTION = 'FUNCTION',\n}\n"],"names":["E_CommandType"],"mappings":"AA4CO,IAAKA,sBAAAA,OACRA,EAAA,MAAM,OACNA,EAAA,SAAS,UACTA,EAAA,WAAW,YAHHA,IAAAA,KAAA,CAAA,CAAA;"}

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

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

@@ -0,0 +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":"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/command/index.js

@@ -9,3 +9,4 @@ export {
   s as resolveCommands,
   C as runCommand
 };
+//# sourceMappingURL=index.js.map

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

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

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

@@ -6,6 +6,9 @@ export { Router } from 'express';
 export interface I_ExpressOptions {
     isDev?: boolean;
     static?: string | string[];
+    maxFileSize?: number;
+    maxFiles?: number;
+    jsonLimit?: string;
 }
 export interface I_NestOptions {
     module: Type<object>;
@@ -13,6 +16,7 @@ export interface I_NestOptions {
     static?: string | string[];
     filters?: ExceptionFilter[];
     pipes?: ValidationPipe[];
+    jsonLimit?: string;
 }
 export type T_CorsType = 'node' | 'nest';
 interface I_BaseCorsOptions {

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

@@ -1,54 +1,72 @@
 import { NestFactory as u } from "@nestjs/core";
-import a from "compression";
-import f from "cookie-parser";
+import n from "compression";
+import l from "cookie-parser";
 import m from "cors";
-import s from "express";
-import { default as $ } from "express";
-import l from "express-session";
-import { express as p } from "express-useragent";
-import d from "graphql-upload/graphqlUploadExpress.mjs";
+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";
-function y({ isDev: e, whiteList: r, ...o }) {
+import y from "node:process";
+function E({ isDev: e, whiteList: r, ...t }) {
   return {
-    origin: (t, i) => {
-      e || !t || r?.includes(t ?? "") ? i(null, !0) : i(new Error("Not allowed by CORS"), !1);
+    origin: (s, o) => {
+      e || !s || r?.includes(s ?? "") ? o(null, !0) : o(new Error("Not allowed by CORS"), !1);
     },
     credentials: !0,
-    ...o
+    ...t
   };
 }
-function C(e) {
-  return m(y(e));
+function F(e) {
+  return m(E(e));
 }
-function N(e) {
-  return l(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 c(e, r = !1) {
+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(f()), e.use(s.urlencoded({ extended: !0 })), e.use(a()), 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 n(e, r) {
-  r && (Array.isArray(r) ? r : [r]).forEach((t) => {
-    e.use(`/${t}`, s.static(t));
+function a(e, r) {
+  r && (Array.isArray(r) ? r : [r]).forEach((s) => {
+    e.use(`/${s}`, i.static(s));
   });
 }
-function O(e) {
-  const r = s();
-  return c(r, e?.isDev), n(r, e?.static), r.use(d()), r;
+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;
 }
-async function G(e) {
+async function C(e) {
   const r = await u.create(e.module);
-  return c(r.getHttpAdapter().getInstance(), e.isDev), n(r.getHttpAdapter().getInstance(), e.static), e.filters && r.useGlobalFilters(...e.filters), e.pipes && r.useGlobalPipes(...e.pipes), r;
+  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 {
-  C as createCors,
-  y as createCorsOptions,
-  O as createExpress,
-  G as createNest,
-  N as createSession,
-  $ as express
+  F as createCors,
+  E as createCorsOptions,
+  z as createExpress,
+  C as createNest,
+  P as createSession,
+  G as express
 };
+//# sourceMappingURL=express.util.js.map

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

@@ -0,0 +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 { 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/express/index.js

@@ -11,3 +11,4 @@ export {
   p as createSession,
   x as express
 };
+//# sourceMappingURL=index.js.map

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

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

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

@@ -54,3 +54,4 @@ export {
   F as unlinkSync,
   u as writeFileSync
 };
+//# sourceMappingURL=fs.util.js.map

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

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

package/dist/node/fs/index.js

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

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

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

package/dist/node/log/index.js

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

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

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

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

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

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

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

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

@@ -70,3 +70,4 @@ export {
   m as log,
   S as throwError
 };
+//# sourceMappingURL=log.util.js.map