@cyberskill/shared 3.8.0 → 3.9.0

package/dist/config/graphql-codegen/graphql-codegen.util.js

@@ -13,7 +13,7 @@ function n({ uri: e, from: n, to: r, target: i = "client" }) {
 			...a && { [r]: {
 				preset: "client",
 				presetConfig: {
-					fragmentMasking: !1,
+					fragmentMasking: !0,
 					persistedDocuments: !0
 				},
 				config: {

package/dist/config/graphql-codegen/graphql-codegen.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-codegen.util.js","names":[],"sources":["../../../src/config/graphql-codegen/graphql-codegen.util.ts"],"sourcesContent":["import type { CodegenConfig } from '@graphql-codegen/cli';\n\nimport { defineConfig } from '@eddeee888/gcg-typescript-resolver-files';\n\nimport type { I_GraphqlCodegenConfig } from './graphql-codegen.type.js';\n\nimport { loadEnvFile } from '../env/env.util.js';\n\nloadEnvFile();\n\n/**\n * Creates a GraphQL Code Generator configuration for client or server code generation.\n * This function generates a complete GraphQL Code Generator configuration based on\n * the specified target (client or server) with appropriate presets and settings.\n *\n * For client targets, it configures:\n * - Client preset with fragment masking disabled\n * - Persisted documents support\n * - Type imports and naming convention settings\n * - Document processing from specified source\n *\n * For server targets, it configures:\n * - TypeScript resolver files generation\n * - Server-side GraphQL type definitions\n * - Resolver function generation\n *\n * @param options - Configuration object containing uri, from, to, and target properties.\n * @param options.uri - The GraphQL schema URI to generate types from.\n * @param options.from - The source path for GraphQL documents (used for client generation).\n * @param options.to - The output path for generated files.\n * @param options.target - The generation target ('client' for frontend, 'server' for backend).\n * @returns A complete GraphQL Code Generator configuration object.\n */\nexport function createGraphqlCodegenConfig({\n    uri,\n    from,\n    to,\n    target = 'client',\n}: I_GraphqlCodegenConfig): CodegenConfig {\n    const isClient = target === 'client';\n    const isServer = target === 'server';\n\n    return {\n        schema: uri,\n        ignoreNoDocuments: true,\n        overwrite: true,\n        ...(isClient && { documents: [from] }),\n        generates: {\n            ...(isClient && {\n                [to]: {\n                    preset: 'client',\n                    presetConfig: {\n                        fragmentMasking: false,\n                        persistedDocuments: true,\n                    },\n                    config: {\n                        useTypeImports: true,\n                        namingConvention: 'keep',\n                    },\n                },\n            }),\n            ...(isServer && {\n                [to]: defineConfig(),\n            }),\n        },\n    };\n}\n"],"mappings":";;;AAQA,GAAa;AAyBb,SAAgB,EAA2B,EACvC,QACA,SACA,OACA,YAAS,YAC6B;CACtC,IAAM,IAAW,MAAW,UACtB,IAAW,MAAW;AAE5B,QAAO;EACH,QAAQ;EACR,mBAAmB;EACnB,WAAW;EACX,GAAI,KAAY,EAAE,WAAW,CAAC,EAAK,EAAE;EACrC,WAAW;GACP,GAAI,KAAY,GACX,IAAK;IACF,QAAQ;IACR,cAAc;KACV,iBAAiB;KACjB,oBAAoB;KACvB;IACD,QAAQ;KACJ,gBAAgB;KAChB,kBAAkB;KACrB;IACJ,EACJ;GACD,GAAI,KAAY,GACX,IAAK,GAAc,EACvB;GACJ;EACJ"}
+{"version":3,"file":"graphql-codegen.util.js","names":[],"sources":["../../../src/config/graphql-codegen/graphql-codegen.util.ts"],"sourcesContent":["import type { CodegenConfig } from '@graphql-codegen/cli';\n\nimport { defineConfig } from '@eddeee888/gcg-typescript-resolver-files';\n\nimport type { I_GraphqlCodegenConfig } from './graphql-codegen.type.js';\n\nimport { loadEnvFile } from '../env/env.util.js';\n\nloadEnvFile();\n\n/**\n * Creates a GraphQL Code Generator configuration for client or server code generation.\n * This function generates a complete GraphQL Code Generator configuration based on\n * the specified target (client or server) with appropriate presets and settings.\n *\n * For client targets, it configures:\n * - Client preset with fragment masking disabled\n * - Persisted documents support\n * - Type imports and naming convention settings\n * - Document processing from specified source\n *\n * For server targets, it configures:\n * - TypeScript resolver files generation\n * - Server-side GraphQL type definitions\n * - Resolver function generation\n *\n * @param options - Configuration object containing uri, from, to, and target properties.\n * @param options.uri - The GraphQL schema URI to generate types from.\n * @param options.from - The source path for GraphQL documents (used for client generation).\n * @param options.to - The output path for generated files.\n * @param options.target - The generation target ('client' for frontend, 'server' for backend).\n * @returns A complete GraphQL Code Generator configuration object.\n */\nexport function createGraphqlCodegenConfig({\n    uri,\n    from,\n    to,\n    target = 'client',\n}: I_GraphqlCodegenConfig): CodegenConfig {\n    const isClient = target === 'client';\n    const isServer = target === 'server';\n\n    return {\n        schema: uri,\n        ignoreNoDocuments: true,\n        overwrite: true,\n        ...(isClient && { documents: [from] }),\n        generates: {\n            ...(isClient && {\n                [to]: {\n                    preset: 'client',\n                    presetConfig: {\n                        fragmentMasking: true,\n                        persistedDocuments: true,\n                    },\n                    config: {\n                        useTypeImports: true,\n                        namingConvention: 'keep',\n                    },\n                },\n            }),\n            ...(isServer && {\n                [to]: defineConfig(),\n            }),\n        },\n    };\n}\n"],"mappings":";;;AAQA,GAAa;AAyBb,SAAgB,EAA2B,EACvC,QACA,SACA,OACA,YAAS,YAC6B;CACtC,IAAM,IAAW,MAAW,UACtB,IAAW,MAAW;AAE5B,QAAO;EACH,QAAQ;EACR,mBAAmB;EACnB,WAAW;EACX,GAAI,KAAY,EAAE,WAAW,CAAC,EAAK,EAAE;EACrC,WAAW;GACP,GAAI,KAAY,GACX,IAAK;IACF,QAAQ;IACR,cAAc;KACV,iBAAiB;KACjB,oBAAoB;KACvB;IACD,QAAQ;KACJ,gBAAgB;KAChB,kBAAkB;KACrB;IACJ,EACJ;GACD,GAAI,KAAY,GACX,IAAK,GAAc,EACvB;GACJ;EACJ"}

package/dist/node/cli/index.js

@@ -18,7 +18,11 @@ function E() {
 	}
 }
 async function D() {
-	t(y.TS_CONFIG) ? await p("Performing TypeScript validation", await x.typescriptCheck()) : s.warn("No TypeScript configuration found. Skipping type check.");
+	if (!t(y.TS_CONFIG)) {
+		s.warn("No TypeScript configuration found. Skipping type check.");
+		return;
+	}
+	await p("Performing TypeScript validation", await x.typescriptCheck());
 }
 async function O(e = !1) {
 	let t = e ? await x.eslintFix() : await x.eslintCheck(), n = e ? "Running ESLint with auto-fix" : "Running ESLint check";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"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(import.meta.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: unknown) {\n        const errObj = error as { code?: string; killed?: boolean; signal?: string };\n        if (errObj.code === 'ETIMEDOUT' || errObj.killed || errObj.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    // Allow pending I/O (runCommand writes) to flush before reading results\n    await new Promise(resolve => setImmediate(resolve));\n\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}\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    await 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    await 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    await 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    await 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, PATH.SIMPLE_GIT_HOOKS_JSON);\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 (error) {\n        log.error(error);\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 (error) {\n        log.error(error);\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"],"mappings":";;;;;;;;;;;;AAoBA,SAAS,IAAqB;AAC1B,KAAI;AAIA,SAHY,KAAK,MACb,EAAa,EAAQ,OAAO,KAAK,SAAS,wBAAwB,EAAE,QAAQ,CAC/E,CACU;SAET;AACF,SAAO;;;AAYf,eAAe,IAAkB;AAC7B,CAAI,EAAe,EAAK,UAAU,GAC9B,MAAM,EAAW,oCAAoC,MAAM,EAAQ,iBAAiB,CAAC,GAGrF,EAAI,KAAK,0DAA0D;;AAY3E,eAAe,EAAY,IAAM,IAAO;CACpC,IAAM,IAAe,IAAM,MAAM,EAAQ,WAAW,GAAG,MAAM,EAAQ,aAAa,EAC5E,IAAQ,IAAM,iCAAiC;AAErD,KAAI;AACA,QAAM,EAAW,GAAO,GAAc;GAAE,SAAS;GAAO,cAAc;GAAM,CAAC;UAE1E,GAAgB;EACnB,IAAM,IAAS;AACf,EAAI,EAAO,SAAS,eAAe,EAAO,UAAU,EAAO,WAAW,aAClE,EAAI,KAAK,4DAA4D,EACrE,EAAQ,IAAI,QAAW,QACvB,MAAM,EAAW,GAAG,EAAM,gBAAgB,EAAa,IAGvD,EAAW,EAAM;;;AAa7B,SAAS,EAAY,GAA6B,GAAsB;AAC/D,GAAK,UAKV,EAAI,cAAc,MAAS,WAAW,aAAa,cAAc,GADnD,MAAS,WAAW,QAAQ,SACmC;;AAWjF,eAAe,IAAkB;AAE7B,OAAM,IAAI,SAAQ,MAAW,aAAa,EAAQ,CAAC;CAEnD,IAAM,IAAc,MAAM,GAAqB,IAAK,EAAE,EAChD,IAAS,EAAW,QAAO,MAAK,EAAE,SAAS,EAAY,MAAM,EAC7D,IAAW,EAAW,QAAO,MAAK,EAAE,SAAS,EAAY,QAAQ;AAEvE,CAAI,CAAC,EAAO,UAAU,CAAC,EAAS,SAC5B,EAAI,cAAc,qBAAqB,EAAE,EAAE,QAAQ,IAGnD,EAAY,YAAY,EAAS,EACjC,EAAY,UAAU,EAAO,EAEzB,EAAO,SAAS,KAChB,EAAQ,KAAK,EAAE;;AAa3B,eAAe,IAAa;AACxB,OAAM,GAAoB;CAC1B,IAAM,IAAc,MAAM,EAAW,EAAE,MAAM,GAAyB,CAAC;AAEvE,KAAI,CAAC,EAAY,SAAS;AACtB,IAAI,MAAM,gEAAgE;AAC1E;;AAQJ,CALI,EAAY,OAAO,oBACnB,MAAM,EAAW,qBAAqB,KAA2B,MAAM,EAAQ,OAAO,CAAC,EAG3F,MAAM,EAAW,yBAAyB,MAAM,EAAQ,YAAY,CAAC,EACrE,MAAM,GAAiB;;AAU3B,eAAe,IAAc;AACzB,OAAM,EAAW,mCAAmC,MAAM,EAAQ,eAAe,CAAC;;AAUtF,eAAe,IAAY;AAIvB,CAHA,MAAM,GAAoB,EAC1B,MAAM,GAAiB,EACvB,MAAM,GAAa,EACnB,MAAM,GAAiB;;AAU3B,eAAe,IAAU;AAIrB,CAHA,MAAM,GAAoB,EAC1B,MAAM,GAAiB,EACvB,MAAM,EAAY,GAAK,EACvB,MAAM,GAAiB;;AAU3B,eAAe,IAAa;AAGxB,CAFA,MAAM,GAAoB,EAC1B,MAAM,EAAW,6BAA6B,MAAM,EAAQ,YAAY,CAAC,EACzE,MAAM,GAAiB;;AAW3B,eAAe,IAAe;AAG1B,CAFA,MAAM,EAAW,yBAAyB,MAAM,EAAQ,kBAAkB,CAAC,EAE3E,EAAW,EAAK,SAAS;CAEzB,IAAM,IAAQ,MAAM,EAAgB,EAAqB;AAMzD,CAJA,EAAc,EAAK,uBAAuB,KAAK,UAAU,GAAO,MAAM,EAAE,CAAC,EAEzE,EAAkB,EAAK,YAAY,EAAqB,EAExD,MAAM,EAAW,+BAA+B,MAAM,EAAQ,gBAAgB,CAAC;;AAWnF,eAAe,IAAU;AACrB,KAAI;AACA,QAAM,EAAW,gBAAgB,KAAuB,gBAAgB,IAAsB;SAE5F;AACF,QAAM,EAAW,cAAc,EAAoB,YAAY,aAAa,IAAsB;;AAUtG,CAPI,EAAe,EAAK,UAAU,GAC9B,MAAM,EAAW,qBAAqB,yBAAyB,GAG/D,MAAM,EAAW,yBAAyB,cAAc,EAG5D,EAAkB,EAAK,aAAa,EAAU;;AAUlD,eAAe,IAAQ;AAEnB,CADA,MAAM,GAAqB,EAC3B,MAAM,GAAc;;AAWxB,eAAe,IAAQ;AAKnB,CAJA,EAAW,EAAK,cAAc,EAAK,gBAAgB,EAAK,sBAAsB,EAC9E,MAAM,EAAW,sBAAsB,MAAM,EAAQ,gBAAgB,CAAC,EACtE,MAAM,EAAW,uBAAuB,MAAM,EAAQ,gBAAgB,CAAC,EACvE,MAAM,GAAqB,EAC3B,MAAM,GAAc;;AAWxB,eAAe,IAAU;AACrB,OAAM,EAAW,mCAAmC,MAAM,EAAQ,oBAAoB,CAAC;;AAU3F,eAAe,IAAW;AACtB,KAAI;EACA,IAAM,IAAc,MAAM,EAAW,EAAE,MAAM,GAAyB,CAAC;AAKvE,QAAM,EAAW,sBAJL,EAAY,WAAW,EAAY,OAAO,mBAChD,yBACA,MAAM,EAAQ,UAAU,EAEc,EAAE,cAAc,IAAM,CAAC;UAEhE,GAAO;AAEV,EADA,EAAI,MAAM,EAAM,EAChB,EAAQ,KAAK,EAAE;;;AAWvB,eAAe,IAAU;AACrB,KAAI;EACA,IAAM,IAAc,MAAM,EAAW,EAAE,MAAM,GAAyB,CAAC;AAKvE,QAAM,EAAW,4BAJL,EAAY,WAAW,EAAY,OAAO,mBAChD,oFACA,MAAM,EAAQ,SAAS,EAEqB,EAAE,cAAc,IAAM,CAAC;UAEtE,GAAO;AAEV,EADA,EAAI,MAAM,EAAM,EAChB,EAAQ,KAAK,EAAE;;;AAYvB,eAAe,EAAmB,GAAuB;AACrD,OAAM,EAAW,8BAA8B,MAAM,EAAQ,mBAAmB,EAAc,CAAC;;AAUnG,eAAe,IAAiB;AAC5B,OAAM,EAAW,8BAA8B,MAAM,EAAQ,gBAAgB,CAAC;;AAUlF,eAAe,IAAmB;AAC9B,OAAM,EAAW,kCAAkC,MAAM,EAAQ,kBAAkB,CAAC;;AAUxF,eAAe,IAAe;AAC1B,OAAM,EAAW,yCAAyC,MAAM,EAAQ,cAAc,CAAC;;AAU3F,eAAe,IAAiB;AAC5B,OAAM,EAAW,sBAAsB,MAAM,EAAQ,gBAAgB,CAAC;;CAGzE,YAAY;AACT,KAAI;AACA,QAAM,EAAM,EAAQ,EAAQ,KAAK,CAAC,CAC7B,WAAW,EAAe,CAC1B,MAAM,yBAAyB,CAC/B,QAAQ,YAAY,8BAA8B,EAAQ,CAC1D,QAAQ,QAAQ,iCAAiC,EAAU,CAC3D,QAAQ,YAAY,oCAAoC,EAAQ,CAChE,QAAQ,gBAAgB,oCAAoC,EAAY,CACxE,QAAQ,eAAe,mCAAmC,EAAW,CACrE,QAAQ,cAAc,kCAAkC,EAAW,CACnE,QAAQ,SAAS,uCAAuC,EAAM,CAC9D,QAAQ,SAAS,gDAAgD,EAAM,CACvE,QAAQ,WAAW,0CAA0C,EAAQ,CACrE,QAAQ,aAAa,uBAAuB,EAAS,CACrD,QAAQ,YAAY,6BAA6B,EAAQ,CACzD,QAAQ,+BAA+B,+BAA8B,MAClE,EAAE,WAAW,QAAQ;GACjB,UAAU;GACV,MAAM;GACT,CAAC,EAAE,OAAO,MAAS;AACpB,OAAI,CAAC,EAAK,MAAM;AACZ,MAAI,MAAM,8BAA8B;AAExC;;AAGJ,SAAM,EAAmB,EAAK,KAAK;IACrC,CACD,QAAQ,oBAAoB,gCAAgC,EAAe,CAC3E,QAAQ,sBAAsB,mCAAmC,EAAiB,CAClF,QAAQ,iBAAiB,sCAAsC,EAAa,CAC5E,QAAQ,mBAAmB,kCAAkC,EAAe,CAC5E,cAAc,GAAG,kCAAkC,CACnD,QAAQ,CACR,MAAM,CACN,MAAM,KAAK,OAAO,CAClB,MAAM,KAAK,UAAU,CACrB,QAAQ,GAAY,CAAC,CACrB,OAAO,2DAAyD,CAChE,OAAO;UAET,GAAO;AAEV,EADA,EAAW,EAAM,EACjB,EAAQ,KAAK,EAAE;;IAEnB"}
+{"version":3,"file":"index.js","names":[],"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(import.meta.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 * Uses `--incremental` mode to cache results — the first run may be slow\n * (especially with large generated files), but subsequent runs are near-instant.\n *\n * @returns A promise that resolves when the TypeScript validation is complete.\n */\nasync function checkTypescript() {\n    if (!pathExistsSync(PATH.TS_CONFIG)) {\n        log.warn('No TypeScript configuration found. Skipping type check.');\n        return;\n    }\n\n    await runCommand('Performing TypeScript validation', await command.typescriptCheck());\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: unknown) {\n        const errObj = error as { code?: string; killed?: boolean; signal?: string };\n        if (errObj.code === 'ETIMEDOUT' || errObj.killed || errObj.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    // Allow pending I/O (runCommand writes) to flush before reading results\n    await new Promise(resolve => setImmediate(resolve));\n\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}\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    await 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    await 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    await 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    await 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, PATH.SIMPLE_GIT_HOOKS_JSON);\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 (error) {\n        log.error(error);\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 (error) {\n        log.error(error);\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"],"mappings":"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"}

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

@@ -59,7 +59,8 @@ function h(e, n = !1, r = "1mb", o = !1, c = {}) {
 		standardHeaders: !0,
 		legacyHeaders: !1,
 		...c.store !== void 0 && { store: c.store },
-		...c.skip !== void 0 && { skip: c.skip }
+		...c.skip !== void 0 && { skip: c.skip },
+		...!o && { validate: { xForwardedForHeader: !1 } }
 	})), e.use(a()), e.use(t.json({ limit: r })), e.use(t.urlencoded({
 		extended: !0,
 		limit: r

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

@@ -1 +1 @@
-{"version":3,"file":"express.util.js","names":[],"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 rateLimit from 'express-rate-limit';\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    // Safety net: warn loudly if isDev is mistakenly true in production\n    if (isDev && process.env['NODE_ENV'] === 'production') {\n        console.warn('[CORS] WARNING: isDev is true but NODE_ENV is \"production\". CORS restrictions are relaxed. This is likely a misconfiguration.');\n    }\n\n    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            // Allow requests without Origin header only in development mode.\n            // In production, undefined origin (e.g., curl, server-to-server) is rejected.\n            if (isDev && !origin) {\n                callback(null, true);\n                return;\n            }\n\n            if (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    if (!options.secret) {\n        throw new Error('Session secret is required. Provide a strong secret string.');\n    }\n\n    if (!options.store && process.env['NODE_ENV'] === 'production') {\n        console.warn('[Session] WARNING: No session store configured in production. The default MemoryStore leaks memory and loses sessions on restart. Use connect-redis, connect-mongo, or another production store.');\n    }\n\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            maxAge: 24 * 60 * 60 * 1000, // 24 hours\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 * @param isDev - Whether the application is running in development mode.\n * @param jsonLimit - Maximum request body size for JSON payloads.\n * @param trustProxy - Trust proxy setting; pass a truthy value to enable.\n * @param rateLimitOptions - Rate limit configuration, or `false` to disable.\n */\nfunction setupMiddleware(\n    app: Application,\n    isDev = false,\n    jsonLimit = '1mb',\n    trustProxy: boolean | number | string | string[] = false,\n    rateLimitOptions: false | import('./express.type.js').I_RateLimitOptions = {},\n) {\n    if (trustProxy !== false) {\n        app.set('trust proxy', trustProxy);\n    }\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\n        }),\n    );\n    if (rateLimitOptions !== false) {\n        app.use(\n            rateLimit({\n                windowMs: rateLimitOptions.windowMs ?? 15 * 60 * 1000,\n                limit: rateLimitOptions.limit ?? 1000,\n                standardHeaders: true,\n                legacyHeaders: false,\n                ...(rateLimitOptions.store !== undefined && { store: rateLimitOptions.store }),\n                ...(rateLimitOptions.skip !== undefined && { skip: rateLimitOptions.skip }),\n            }),\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 * @remarks\n * **Requires Express 5.x** — This module uses Express 5 APIs and is not compatible with Express 4.\n * The peer dependency requires `express >= 5.0.0`.\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, options?.trustProxy, options?.rateLimit);\n    setupStaticFolders(app, options?.static);\n    const uploadMiddleware = graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    });\n    app.use(options?.uploadPath ?? '/graphql', uploadMiddleware);\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, options.trustProxy, options.rateLimit);\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"],"mappings":"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"}
+{"version":3,"file":"express.util.js","names":[],"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 rateLimit from 'express-rate-limit';\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    // Safety net: warn loudly if isDev is mistakenly true in production\n    if (isDev && process.env['NODE_ENV'] === 'production') {\n        console.warn('[CORS] WARNING: isDev is true but NODE_ENV is \"production\". CORS restrictions are relaxed. This is likely a misconfiguration.');\n    }\n\n    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            // Allow requests without Origin header only in development mode.\n            // In production, undefined origin (e.g., curl, server-to-server) is rejected.\n            if (isDev && !origin) {\n                callback(null, true);\n                return;\n            }\n\n            if (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    if (!options.secret) {\n        throw new Error('Session secret is required. Provide a strong secret string.');\n    }\n\n    if (!options.store && process.env['NODE_ENV'] === 'production') {\n        console.warn('[Session] WARNING: No session store configured in production. The default MemoryStore leaks memory and loses sessions on restart. Use connect-redis, connect-mongo, or another production store.');\n    }\n\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            maxAge: 24 * 60 * 60 * 1000, // 24 hours\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 * @param isDev - Whether the application is running in development mode.\n * @param jsonLimit - Maximum request body size for JSON payloads.\n * @param trustProxy - Trust proxy setting; pass a truthy value to enable.\n * @param rateLimitOptions - Rate limit configuration, or `false` to disable.\n */\nfunction setupMiddleware(\n    app: Application,\n    isDev = false,\n    jsonLimit = '1mb',\n    trustProxy: boolean | number | string | string[] = false,\n    rateLimitOptions: false | import('./express.type.js').I_RateLimitOptions = {},\n) {\n    if (trustProxy !== false) {\n        app.set('trust proxy', trustProxy);\n    }\n\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\n        }),\n    );\n\n    if (rateLimitOptions !== false) {\n        app.use(\n            rateLimit({\n                windowMs: rateLimitOptions.windowMs ?? 15 * 60 * 1000,\n                limit: rateLimitOptions.limit ?? 1000,\n                standardHeaders: true,\n                legacyHeaders: false,\n                ...(rateLimitOptions.store !== undefined && { store: rateLimitOptions.store }),\n                ...(rateLimitOptions.skip !== undefined && { skip: rateLimitOptions.skip }),\n                // When trustProxy is not explicitly set, suppress the\n                // ERR_ERL_UNEXPECTED_X_FORWARDED_FOR validation that crashes on\n                // X-Forwarded-For headers behind a reverse proxy.\n                ...(!trustProxy && { validate: { xForwardedForHeader: false } }),\n            }),\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 * @remarks\n * **Requires Express 5.x** — This module uses Express 5 APIs and is not compatible with Express 4.\n * The peer dependency requires `express >= 5.0.0`.\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, options?.trustProxy, options?.rateLimit);\n    setupStaticFolders(app, options?.static);\n    const uploadMiddleware = graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    });\n    app.use(options?.uploadPath ?? '/graphql', uploadMiddleware);\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, options.trustProxy, options.rateLimit);\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"],"mappings":";;;;;;;;;;;;;AA6BA,SAAgB,EAAwC,EAAE,UAAO,cAAW,GAAG,KAA0B;AAMrG,QAJI,KAAS,EAAQ,IAAI,aAAgB,gBACrC,QAAQ,KAAK,kIAAgI,EAG1I;EACH,SAAS,GAA4B,MAA2D;AAG5F,OAAI,KAAS,CAAC,GAAQ;AAClB,MAAS,MAAM,GAAK;AACpB;;AAGJ,GAAI,KAAU,GAAW,SAAS,EAAO,GACrC,EAAS,MAAM,GAAK,GAGpB,EAAS,gBAAI,MAAM,sBAAsB,EAAE,GAAM;;EAGzD,aAAa;EACb,GAAG;EACN;;AAWL,SAAgB,EAAiC,GAA2B;AACxE,QAAO,EAAuB,EAAkB,EAAQ,CAAC;;AAW7D,SAAgB,EAAc,GAAyC;AACnE,KAAI,CAAC,EAAQ,OACT,OAAU,MAAM,8DAA8D;AAGlF,CAAI,CAAC,EAAQ,SAAS,EAAQ,IAAI,aAAgB,gBAC9C,QAAQ,KAAK,mMAAmM;CAGpN,IAAM,IAA0C;EAC5C,QAAQ;EACR,mBAAmB;EACnB,QAAQ;GACJ,UAAU;GACV,UAAU;GACV,QAAQ,EAAQ,IAAI,aAAgB;GACpC,QAAQ,OAAU,KAAK;GAC1B;EACJ;AAED,QAAO,EAAQ;EACX,GAAG;EACH,GAAG;EACH,QAAQ;GAAE,GAAG,EAAe;GAAQ,GAAG,EAAQ;GAAQ;EAC1D,CAAC;;AAkBN,SAAS,EACL,GACA,IAAQ,IACR,IAAY,OACZ,IAAmD,IACnD,IAA2E,EAAE,EAC/E;AAgCE,CA/BI,MAAe,MACf,EAAI,IAAI,eAAe,EAAW,EAGtC,EAAI,IACA,EAAO;EACH,2BAA2B,IAAQ,KAAQ,KAAA;EAC3C,uBAAuB,IAAQ,KAAQ,KAAA;EAC1C,CAAC,CACL,EAEG,MAAqB,MACrB,EAAI,IACA,EAAU;EACN,UAAU,EAAiB,YAAY,MAAU;EACjD,OAAO,EAAiB,SAAS;EACjC,iBAAiB;EACjB,eAAe;EACf,GAAI,EAAiB,UAAU,KAAA,KAAa,EAAE,OAAO,EAAiB,OAAO;EAC7E,GAAI,EAAiB,SAAS,KAAA,KAAa,EAAE,MAAM,EAAiB,MAAM;EAI1E,GAAI,CAAC,KAAc,EAAE,UAAU,EAAE,qBAAqB,IAAO,EAAE;EAClE,CAAC,CACL,EAEL,EAAI,IAAI,GAAc,CAAC,EACvB,EAAI,IAAI,EAAQ,KAAK,EAAE,OAAO,GAAW,CAAC,CAAC,EAC3C,EAAI,IAAI,EAAQ,WAAW;EAAE,UAAU;EAAM,OAAO;EAAW,CAAC,CAAC,EACjE,EAAI,IAAI,GAAa,CAAC,EACtB,EAAI,IAAI,GAAW,CAAC;;AAWxB,SAAS,EAAmB,GAAkB,GAAmC;AAC7E,CAAI,MACgB,MAAM,QAAQ,EAAc,GAAG,IAAgB,CAAC,EAAc,EACtE,SAAS,MAAW;AACxB,IAAI,IAAI,IAAI,KAAU,EAAQ,OAAO,EAAO,CAAC;GAC/C;;AAkBV,SAAgB,EAAc,GAAyC;CACnE,IAAM,IAAM,GAAS;AAGrB,CADA,EAAgB,GAAK,GAAS,OAAO,GAAS,WAAW,GAAS,YAAY,GAAS,UAAU,EACjG,EAAmB,GAAK,GAAS,OAAO;CACxC,IAAM,IAAmB,EAAqB;EAC1C,aAAa,GAAS,eAAe;EACrC,UAAU,GAAS,YAAY;EAClC,CAAC;AAGF,QAFA,EAAI,IAAI,GAAS,cAAc,YAAY,EAAiB,EAErD;;AAcX,eAAsB,EAAW,GAAmD;CAChF,IAAM,IAAM,MAAM,EAAY,OAAO,EAAQ,OAAO;AAapD,QAXA,EAAgB,EAAI,gBAAgB,CAAC,aAAa,EAAE,EAAQ,OAAO,EAAQ,WAAW,EAAQ,YAAY,EAAQ,UAAU,EAC5H,EAAmB,EAAI,gBAAgB,CAAC,aAAa,EAAE,EAAQ,OAAO,EAElE,EAAQ,WACR,EAAI,iBAAiB,GAAG,EAAQ,QAAQ,EAGxC,EAAQ,SACR,EAAI,eAAe,GAAG,EAAQ,MAAM,EAGjC"}

package/dist/node/path/path.constant.js

@@ -117,7 +117,7 @@ var ae = /^[\w-]+$/, oe = {
 			name: P,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `tsc -p ${Q.TS_CONFIG} --noEmit`
+		command: `tsc -p ${Q.TS_CONFIG} --noEmit --incremental`
 	}),
 	testUnit: $({
 		type: t.CLI,

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

@@ -1 +1 @@
-{"version":3,"file":"path.constant.js","names":[],"sources":["../../../src/node/path/path.constant.ts"],"sourcesContent":["import fsExtra from 'fs-extra';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { I_PackageInput, I_PackageJson } from '../package/index.js';\n\nimport { E_CommandType, formatCommand, rawCommand } from '../command/index.js';\nimport { E_PackageType, setupPackages } from '../package/index.js';\nimport { join, resolveWorkingPath } from './path.util.js';\n\nexport const WORKING_DIRECTORY = getEnv().CWD;\nexport const CYBERSKILL_PACKAGE_NAME = '@cyberskill/shared';\nexport const NODE_MODULES = 'node_modules';\nexport const BUILD_DIRECTORY = 'dist';\nexport const PUBLIC_DIRECTORY = 'public';\nexport const PACKAGE_JSON = 'package.json';\nexport const PACKAGE_LOCK_JSON = 'package-lock.json';\nexport const TSCONFIG_JSON = 'tsconfig.json';\nexport const GIT_IGNORE = '.gitignore';\nexport const SIMPLE_GIT_HOOK_JSON = '.simple-git-hooks.json';\nexport const PNPM_LOCK_YAML = 'pnpm-lock.yaml';\nexport const GIT_HOOK = '.git/hooks/';\nexport const GIT_COMMIT_EDITMSG = '.git/COMMIT_EDITMSG';\nexport const GIT_EXCLUDE = '.git/info/exclude';\nexport const MIGRATE_MONGO_CONFIG = '.migrate-mongo.config.js';\nlet _cyberskillDir: string | null = null;\n\n/**\n * Lazily computes the CyberSkill directory path.\n * Reads package.json on first access to determine whether this is the shared package itself\n * or a consumer project, avoiding filesystem reads at module load time.\n */\nexport function getCyberskillDirectory(): string {\n    if (_cyberskillDir !== null) {\n        return _cyberskillDir;\n    }\n\n    try {\n        const packageJson = fsExtra.readJsonSync(resolveWorkingPath(PACKAGE_JSON)) as I_PackageJson;\n\n        _cyberskillDir = packageJson.name === CYBERSKILL_PACKAGE_NAME\n            ? join(WORKING_DIRECTORY, BUILD_DIRECTORY)\n            : join(WORKING_DIRECTORY, NODE_MODULES, CYBERSKILL_PACKAGE_NAME, BUILD_DIRECTORY);\n    }\n    catch {\n        _cyberskillDir = join(WORKING_DIRECTORY, NODE_MODULES, CYBERSKILL_PACKAGE_NAME, BUILD_DIRECTORY);\n    }\n\n    return _cyberskillDir;\n}\n\n/** @deprecated Use `getCyberskillDirectory()` instead. Kept for backward compatibility. */\nexport const CYBERSKILL_DIRECTORY = getCyberskillDirectory();\nexport const CYBERSKILL_CLI = 'cyberskill';\nexport const CYBERSKILL_CLI_PATH = 'src/node/cli/index.ts';\nexport const ESLINT_PACKAGE_NAME = 'eslint';\nexport const ESLINT_CLI = 'eslint';\nexport const VITEST_PACKAGE_NAME = 'vitest';\nexport const VITEST_CLI = 'vitest';\nexport const COMMIT_LINT_PACKAGE_NAME = '@commitlint/cli';\nexport const COMMIT_LINT_CONVENTIONAL_CONFIG_PACKAGE_NAME = '@commitlint/config-conventional';\nexport const COMMIT_LINT_CLI = 'commitlint';\nexport const LINT_STAGED_PACKAGE_NAME = 'lint-staged';\nexport const LINT_STAGED_CLI = 'lint-staged';\nexport const TSC_PACKAGE_NAME = 'typescript';\nexport const TSC_CLI = 'tsc';\nexport const TSX_CLI = 'tsx';\nexport const GIT_CLI = 'git';\nexport const PNPM_CLI = 'pnpm';\nexport const PNPM_EXEC_CLI = 'pnpm exec';\nexport const SIMPLE_GIT_HOOKS_PACKAGE_NAME = 'simple-git-hooks';\nexport const SIMPLE_GIT_HOOK_CLI = 'simple-git-hooks';\nexport const ESLINT_INSPECT_PACKAGE_NAME = '@eslint/config-inspector';\nexport const ESLINT_INSPECT_CLI = 'eslint-config-inspector';\nexport const NODE_MODULES_INSPECT_PACKAGE_NAME = 'node-modules-inspector';\nexport const NODE_MODULES_INSPECT_CLI = 'node-modules-inspector';\nexport const MIGRATE_MONGO_PACKAGE_NAME = 'migrate-mongo';\nexport const MIGRATE_MONGO_CLI = './node_modules/migrate-mongo/bin/migrate-mongo';\nexport const STORYBOOK_PACKAGE_NAME = 'storybook';\nexport const STORYBOOK_CLI = 'storybook';\nexport const AG_KIT_PACKAGE_NAME = '@vudovn/ag-kit';\nexport const DOT_AGENT = '.agent';\n\nexport const PATH = {\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get CYBERSKILL_DIRECTORY() { return getCyberskillDirectory(); },\n    WORKING_DIRECTORY,\n    PUBLIC_DIRECTORY: resolveWorkingPath(PUBLIC_DIRECTORY),\n    TS_CONFIG: resolveWorkingPath(TSCONFIG_JSON),\n    GIT_IGNORE: resolveWorkingPath(GIT_IGNORE),\n    GIT_HOOK: resolveWorkingPath(GIT_HOOK),\n    GIT_COMMIT_MSG: resolveWorkingPath(GIT_COMMIT_EDITMSG),\n    GIT_EXCLUDE: resolveWorkingPath(GIT_EXCLUDE),\n    SIMPLE_GIT_HOOKS_JSON: resolveWorkingPath(SIMPLE_GIT_HOOK_JSON),\n    PACKAGE_JSON: resolveWorkingPath(PACKAGE_JSON),\n    PACKAGE_LOCK_JSON: resolveWorkingPath(PACKAGE_LOCK_JSON),\n    PNPM_LOCK_YAML: resolveWorkingPath(PNPM_LOCK_YAML),\n    NODE_MODULES: resolveWorkingPath(NODE_MODULES),\n    MIGRATE_MONGO_CONFIG: resolveWorkingPath(MIGRATE_MONGO_CONFIG),\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get LINT_STAGED_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/lint-staged/index.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get COMMITLINT_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/commitlint/index.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get VITEST_UNIT_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/vitest/vitest.unit.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get VITEST_E2E_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/vitest/vitest.e2e.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get STORYBOOK_MAIN_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/storybook/storybook.main.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get STORYBOOK_PREVIEW_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/storybook/storybook.preview.js`); },\n    DOT_AGENT: resolveWorkingPath(DOT_AGENT),\n};\n\n/**\n * Creates Git hooks configuration based on whether this is the current project.\n * This function generates a configuration object for Git hooks that includes\n * pre-commit and commit-msg hooks, with an optional pre-push hook for the current project.\n *\n * @returns A Git hooks configuration object with appropriate commands for each hook.\n */\nexport function createGitHooksConfig() {\n    return {\n        'pre-commit': LINT_STAGED_CLI,\n        'commit-msg': COMMIT_LINT_CLI,\n        'pre-push': rawCommand(`${GIT_CLI} pull && ${PNPM_CLI} run --if-present test`),\n    };\n}\n\n/**\n * Builds a command function based on the specified type and configuration.\n * This function creates a command executor that handles different command types\n * including CLI commands and string commands. It manages package dependencies\n * and formats commands appropriately for execution.\n *\n * The function supports:\n * - CLI commands that require package installation\n * - String commands that are executed directly\n * - Automatic package dependency management\n * - Command formatting and validation\n *\n * @param config - Configuration object containing type, packages, and command properties.\n * @param config.type - The type of command to build (CLI or STRING).\n * @param config.packages - Optional array of packages required for CLI commands.\n * @param config.command - The command string to execute.\n * @returns A function that returns a promise resolving to the formatted command string.\n * @throws {Error} When an unsupported command type is provided.\n */\nfunction buildCommand({ type, packages, command }: { type: E_CommandType; packages?: I_PackageInput[]; command: string }): () => Promise<string> {\n    const uniquePackages = packages?.reduce((acc: I_PackageInput[], pkg) => {\n        if (!acc.some(existingPkg => existingPkg.name === pkg.name)) {\n            acc.push(pkg);\n        }\n        return acc;\n    }, []);\n\n    return async () => {\n        switch (type) {\n            case E_CommandType.CLI: {\n                if (uniquePackages?.length) {\n                    await setupPackages(uniquePackages, {\n                        install: true,\n                    });\n                }\n\n                return formatCommand(rawCommand(`${PNPM_EXEC_CLI} ${command}`)) as string;\n            }\n            case E_CommandType.STRING: {\n                return formatCommand(rawCommand(command)) as string;\n            }\n            default: {\n                throw new Error('Unsupported command type');\n            }\n        }\n    };\n}\n\nconst RE_MIGRATE_NAME = /^[\\w-]+$/;\n\nexport const command = {\n    simpleGitHooks: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: SIMPLE_GIT_HOOKS_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: SIMPLE_GIT_HOOK_CLI,\n    }),\n    eslintInspect: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name:\n                    ESLINT_INSPECT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: ESLINT_INSPECT_CLI,\n    }),\n    nodeModulesInspect: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: NODE_MODULES_INSPECT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: NODE_MODULES_INSPECT_CLI,\n    }),\n    eslintCheck: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: ESLINT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: `${ESLINT_CLI} ${PATH.WORKING_DIRECTORY} --no-cache`,\n    }),\n    eslintFix: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: ESLINT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: `${ESLINT_CLI} ${PATH.WORKING_DIRECTORY} --fix --no-cache`,\n    }),\n    typescriptCheck: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: TSC_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: `${TSC_CLI} -p ${PATH.TS_CONFIG} --noEmit`,\n    }),\n    testUnit: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: VITEST_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${VITEST_CLI} --config ${PATH.VITEST_UNIT_CONFIG}`,\n    }),\n    testE2e: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: VITEST_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${VITEST_CLI} --config ${PATH.VITEST_E2E_CONFIG}`,\n    }),\n    mongoMigrateCreate: (migrateName: string) => {\n        if (!RE_MIGRATE_NAME.test(migrateName)) {\n            throw new Error('Migration name must only contain alphanumeric characters, underscores, and hyphens.');\n        }\n\n        return buildCommand({\n            type: E_CommandType.CLI,\n            packages: [\n                {\n                    name: TSX_CLI,\n                    type: E_PackageType.DEPENDENCY,\n                },\n                {\n                    name: MIGRATE_MONGO_PACKAGE_NAME,\n                    type: E_PackageType.DEPENDENCY,\n                },\n            ],\n            command: `${TSX_CLI} ${MIGRATE_MONGO_CLI} create ${migrateName} -f ${PATH.MIGRATE_MONGO_CONFIG}`,\n        })();\n    },\n    mongoMigrateUp: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: TSX_CLI,\n                type: E_PackageType.DEPENDENCY,\n            },\n            {\n                name: MIGRATE_MONGO_PACKAGE_NAME,\n                type: E_PackageType.DEPENDENCY,\n            },\n        ],\n        command: `${TSX_CLI} ${MIGRATE_MONGO_CLI} up -f ${PATH.MIGRATE_MONGO_CONFIG}`,\n    }),\n    mongoMigrateDown: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: TSX_CLI,\n                type: E_PackageType.DEPENDENCY,\n            },\n            {\n                name: MIGRATE_MONGO_PACKAGE_NAME,\n                type: E_PackageType.DEPENDENCY,\n            },\n        ],\n        command: `${TSX_CLI} ${MIGRATE_MONGO_CLI} down -f ${PATH.MIGRATE_MONGO_CONFIG}`,\n    }),\n    commitLint: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: COMMIT_LINT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n            {\n                name: COMMIT_LINT_CONVENTIONAL_CONFIG_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${COMMIT_LINT_CLI} --edit ${PATH.GIT_COMMIT_MSG} --config ${PATH.COMMITLINT_CONFIG}`,\n    }),\n    lintStaged: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: LINT_STAGED_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${LINT_STAGED_CLI} --config ${PATH.LINT_STAGED_CONFIG}`,\n    }),\n    configureGitHook: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${GIT_CLI} config core.hooksPath ${PATH.GIT_HOOK}`,\n    }),\n    build: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} run --if-present build`,\n    }),\n    pnpmInstallStandard: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} install --ignore-scripts`,\n    }),\n    pnpmInstallLegacy: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} install --ignore-scripts --legacy-peer-deps`,\n    }),\n    pnpmInstallForce: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} install --ignore-scripts --force`,\n    }),\n    pnpmPruneStore: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} store prune`,\n    }),\n    pnpmCleanCache: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} cache delete`,\n    }),\n    storybookDev: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: STORYBOOK_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${STORYBOOK_CLI} dev`,\n    }),\n    storybookBuild: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: STORYBOOK_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${STORYBOOK_CLI} build`,\n    }),\n};\n"],"mappings":"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"}
+{"version":3,"file":"path.constant.js","names":[],"sources":["../../../src/node/path/path.constant.ts"],"sourcesContent":["import fsExtra from 'fs-extra';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { I_PackageInput, I_PackageJson } from '../package/index.js';\n\nimport { E_CommandType, formatCommand, rawCommand } from '../command/index.js';\nimport { E_PackageType, setupPackages } from '../package/index.js';\nimport { join, resolveWorkingPath } from './path.util.js';\n\nexport const WORKING_DIRECTORY = getEnv().CWD;\nexport const CYBERSKILL_PACKAGE_NAME = '@cyberskill/shared';\nexport const NODE_MODULES = 'node_modules';\nexport const BUILD_DIRECTORY = 'dist';\nexport const PUBLIC_DIRECTORY = 'public';\nexport const PACKAGE_JSON = 'package.json';\nexport const PACKAGE_LOCK_JSON = 'package-lock.json';\nexport const TSCONFIG_JSON = 'tsconfig.json';\nexport const GIT_IGNORE = '.gitignore';\nexport const SIMPLE_GIT_HOOK_JSON = '.simple-git-hooks.json';\nexport const PNPM_LOCK_YAML = 'pnpm-lock.yaml';\nexport const GIT_HOOK = '.git/hooks/';\nexport const GIT_COMMIT_EDITMSG = '.git/COMMIT_EDITMSG';\nexport const GIT_EXCLUDE = '.git/info/exclude';\nexport const MIGRATE_MONGO_CONFIG = '.migrate-mongo.config.js';\nlet _cyberskillDir: string | null = null;\n\n/**\n * Lazily computes the CyberSkill directory path.\n * Reads package.json on first access to determine whether this is the shared package itself\n * or a consumer project, avoiding filesystem reads at module load time.\n */\nexport function getCyberskillDirectory(): string {\n    if (_cyberskillDir !== null) {\n        return _cyberskillDir;\n    }\n\n    try {\n        const packageJson = fsExtra.readJsonSync(resolveWorkingPath(PACKAGE_JSON)) as I_PackageJson;\n\n        _cyberskillDir = packageJson.name === CYBERSKILL_PACKAGE_NAME\n            ? join(WORKING_DIRECTORY, BUILD_DIRECTORY)\n            : join(WORKING_DIRECTORY, NODE_MODULES, CYBERSKILL_PACKAGE_NAME, BUILD_DIRECTORY);\n    }\n    catch {\n        _cyberskillDir = join(WORKING_DIRECTORY, NODE_MODULES, CYBERSKILL_PACKAGE_NAME, BUILD_DIRECTORY);\n    }\n\n    return _cyberskillDir;\n}\n\n/** @deprecated Use `getCyberskillDirectory()` instead. Kept for backward compatibility. */\nexport const CYBERSKILL_DIRECTORY = getCyberskillDirectory();\nexport const CYBERSKILL_CLI = 'cyberskill';\nexport const CYBERSKILL_CLI_PATH = 'src/node/cli/index.ts';\nexport const ESLINT_PACKAGE_NAME = 'eslint';\nexport const ESLINT_CLI = 'eslint';\nexport const VITEST_PACKAGE_NAME = 'vitest';\nexport const VITEST_CLI = 'vitest';\nexport const COMMIT_LINT_PACKAGE_NAME = '@commitlint/cli';\nexport const COMMIT_LINT_CONVENTIONAL_CONFIG_PACKAGE_NAME = '@commitlint/config-conventional';\nexport const COMMIT_LINT_CLI = 'commitlint';\nexport const LINT_STAGED_PACKAGE_NAME = 'lint-staged';\nexport const LINT_STAGED_CLI = 'lint-staged';\nexport const TSC_PACKAGE_NAME = 'typescript';\nexport const TSC_CLI = 'tsc';\nexport const TSX_CLI = 'tsx';\nexport const GIT_CLI = 'git';\nexport const PNPM_CLI = 'pnpm';\nexport const PNPM_EXEC_CLI = 'pnpm exec';\nexport const SIMPLE_GIT_HOOKS_PACKAGE_NAME = 'simple-git-hooks';\nexport const SIMPLE_GIT_HOOK_CLI = 'simple-git-hooks';\nexport const ESLINT_INSPECT_PACKAGE_NAME = '@eslint/config-inspector';\nexport const ESLINT_INSPECT_CLI = 'eslint-config-inspector';\nexport const NODE_MODULES_INSPECT_PACKAGE_NAME = 'node-modules-inspector';\nexport const NODE_MODULES_INSPECT_CLI = 'node-modules-inspector';\nexport const MIGRATE_MONGO_PACKAGE_NAME = 'migrate-mongo';\nexport const MIGRATE_MONGO_CLI = './node_modules/migrate-mongo/bin/migrate-mongo';\nexport const STORYBOOK_PACKAGE_NAME = 'storybook';\nexport const STORYBOOK_CLI = 'storybook';\nexport const AG_KIT_PACKAGE_NAME = '@vudovn/ag-kit';\nexport const DOT_AGENT = '.agent';\n\nexport const PATH = {\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get CYBERSKILL_DIRECTORY() { return getCyberskillDirectory(); },\n    WORKING_DIRECTORY,\n    PUBLIC_DIRECTORY: resolveWorkingPath(PUBLIC_DIRECTORY),\n    TS_CONFIG: resolveWorkingPath(TSCONFIG_JSON),\n    GIT_IGNORE: resolveWorkingPath(GIT_IGNORE),\n    GIT_HOOK: resolveWorkingPath(GIT_HOOK),\n    GIT_COMMIT_MSG: resolveWorkingPath(GIT_COMMIT_EDITMSG),\n    GIT_EXCLUDE: resolveWorkingPath(GIT_EXCLUDE),\n    SIMPLE_GIT_HOOKS_JSON: resolveWorkingPath(SIMPLE_GIT_HOOK_JSON),\n    PACKAGE_JSON: resolveWorkingPath(PACKAGE_JSON),\n    PACKAGE_LOCK_JSON: resolveWorkingPath(PACKAGE_LOCK_JSON),\n    PNPM_LOCK_YAML: resolveWorkingPath(PNPM_LOCK_YAML),\n    NODE_MODULES: resolveWorkingPath(NODE_MODULES),\n    MIGRATE_MONGO_CONFIG: resolveWorkingPath(MIGRATE_MONGO_CONFIG),\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get LINT_STAGED_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/lint-staged/index.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get COMMITLINT_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/commitlint/index.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get VITEST_UNIT_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/vitest/vitest.unit.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get VITEST_E2E_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/vitest/vitest.e2e.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get STORYBOOK_MAIN_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/storybook/storybook.main.js`); },\n    /** Lazily resolved — defers `getCyberskillDirectory()` until first property access. */\n    get STORYBOOK_PREVIEW_CONFIG() { return resolveWorkingPath(`${getCyberskillDirectory()}/config/storybook/storybook.preview.js`); },\n    DOT_AGENT: resolveWorkingPath(DOT_AGENT),\n};\n\n/**\n * Creates Git hooks configuration based on whether this is the current project.\n * This function generates a configuration object for Git hooks that includes\n * pre-commit and commit-msg hooks, with an optional pre-push hook for the current project.\n *\n * @returns A Git hooks configuration object with appropriate commands for each hook.\n */\nexport function createGitHooksConfig() {\n    return {\n        'pre-commit': LINT_STAGED_CLI,\n        'commit-msg': COMMIT_LINT_CLI,\n        'pre-push': rawCommand(`${GIT_CLI} pull && ${PNPM_CLI} run --if-present test`),\n    };\n}\n\n/**\n * Builds a command function based on the specified type and configuration.\n * This function creates a command executor that handles different command types\n * including CLI commands and string commands. It manages package dependencies\n * and formats commands appropriately for execution.\n *\n * The function supports:\n * - CLI commands that require package installation\n * - String commands that are executed directly\n * - Automatic package dependency management\n * - Command formatting and validation\n *\n * @param config - Configuration object containing type, packages, and command properties.\n * @param config.type - The type of command to build (CLI or STRING).\n * @param config.packages - Optional array of packages required for CLI commands.\n * @param config.command - The command string to execute.\n * @returns A function that returns a promise resolving to the formatted command string.\n * @throws {Error} When an unsupported command type is provided.\n */\nfunction buildCommand({ type, packages, command }: { type: E_CommandType; packages?: I_PackageInput[]; command: string }): () => Promise<string> {\n    const uniquePackages = packages?.reduce((acc: I_PackageInput[], pkg) => {\n        if (!acc.some(existingPkg => existingPkg.name === pkg.name)) {\n            acc.push(pkg);\n        }\n        return acc;\n    }, []);\n\n    return async () => {\n        switch (type) {\n            case E_CommandType.CLI: {\n                if (uniquePackages?.length) {\n                    await setupPackages(uniquePackages, {\n                        install: true,\n                    });\n                }\n\n                return formatCommand(rawCommand(`${PNPM_EXEC_CLI} ${command}`)) as string;\n            }\n            case E_CommandType.STRING: {\n                return formatCommand(rawCommand(command)) as string;\n            }\n            default: {\n                throw new Error('Unsupported command type');\n            }\n        }\n    };\n}\n\nconst RE_MIGRATE_NAME = /^[\\w-]+$/;\n\nexport const command = {\n    simpleGitHooks: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: SIMPLE_GIT_HOOKS_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: SIMPLE_GIT_HOOK_CLI,\n    }),\n    eslintInspect: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name:\n                    ESLINT_INSPECT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: ESLINT_INSPECT_CLI,\n    }),\n    nodeModulesInspect: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: NODE_MODULES_INSPECT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: NODE_MODULES_INSPECT_CLI,\n    }),\n    eslintCheck: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: ESLINT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: `${ESLINT_CLI} ${PATH.WORKING_DIRECTORY} --no-cache`,\n    }),\n    eslintFix: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: ESLINT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: `${ESLINT_CLI} ${PATH.WORKING_DIRECTORY} --fix --no-cache`,\n    }),\n    typescriptCheck: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: TSC_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n\n        ],\n        command: `${TSC_CLI} -p ${PATH.TS_CONFIG} --noEmit --incremental`,\n    }),\n    testUnit: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: VITEST_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${VITEST_CLI} --config ${PATH.VITEST_UNIT_CONFIG}`,\n    }),\n    testE2e: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: VITEST_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${VITEST_CLI} --config ${PATH.VITEST_E2E_CONFIG}`,\n    }),\n    mongoMigrateCreate: (migrateName: string) => {\n        if (!RE_MIGRATE_NAME.test(migrateName)) {\n            throw new Error('Migration name must only contain alphanumeric characters, underscores, and hyphens.');\n        }\n\n        return buildCommand({\n            type: E_CommandType.CLI,\n            packages: [\n                {\n                    name: TSX_CLI,\n                    type: E_PackageType.DEPENDENCY,\n                },\n                {\n                    name: MIGRATE_MONGO_PACKAGE_NAME,\n                    type: E_PackageType.DEPENDENCY,\n                },\n            ],\n            command: `${TSX_CLI} ${MIGRATE_MONGO_CLI} create ${migrateName} -f ${PATH.MIGRATE_MONGO_CONFIG}`,\n        })();\n    },\n    mongoMigrateUp: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: TSX_CLI,\n                type: E_PackageType.DEPENDENCY,\n            },\n            {\n                name: MIGRATE_MONGO_PACKAGE_NAME,\n                type: E_PackageType.DEPENDENCY,\n            },\n        ],\n        command: `${TSX_CLI} ${MIGRATE_MONGO_CLI} up -f ${PATH.MIGRATE_MONGO_CONFIG}`,\n    }),\n    mongoMigrateDown: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: TSX_CLI,\n                type: E_PackageType.DEPENDENCY,\n            },\n            {\n                name: MIGRATE_MONGO_PACKAGE_NAME,\n                type: E_PackageType.DEPENDENCY,\n            },\n        ],\n        command: `${TSX_CLI} ${MIGRATE_MONGO_CLI} down -f ${PATH.MIGRATE_MONGO_CONFIG}`,\n    }),\n    commitLint: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: COMMIT_LINT_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n            {\n                name: COMMIT_LINT_CONVENTIONAL_CONFIG_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${COMMIT_LINT_CLI} --edit ${PATH.GIT_COMMIT_MSG} --config ${PATH.COMMITLINT_CONFIG}`,\n    }),\n    lintStaged: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: LINT_STAGED_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${LINT_STAGED_CLI} --config ${PATH.LINT_STAGED_CONFIG}`,\n    }),\n    configureGitHook: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${GIT_CLI} config core.hooksPath ${PATH.GIT_HOOK}`,\n    }),\n    build: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} run --if-present build`,\n    }),\n    pnpmInstallStandard: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} install --ignore-scripts`,\n    }),\n    pnpmInstallLegacy: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} install --ignore-scripts --legacy-peer-deps`,\n    }),\n    pnpmInstallForce: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} install --ignore-scripts --force`,\n    }),\n    pnpmPruneStore: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} store prune`,\n    }),\n    pnpmCleanCache: buildCommand({\n        type: E_CommandType.STRING,\n        command: `${PNPM_CLI} cache delete`,\n    }),\n    storybookDev: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: STORYBOOK_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${STORYBOOK_CLI} dev`,\n    }),\n    storybookBuild: buildCommand({\n        type: E_CommandType.CLI,\n        packages: [\n            {\n                name: STORYBOOK_PACKAGE_NAME,\n                type: E_PackageType.DEV_DEPENDENCY,\n            },\n        ],\n        command: `${STORYBOOK_CLI} build`,\n    }),\n};\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "3.8.0",
+    "version": "3.9.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",