@cyberskill/shared 3.12.0 → 3.14.0

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

@@ -4,117 +4,120 @@ import { E_PackageType as n } from "../package/package.type.js";
 import { setupPackages as ee } from "../package/package.util.js";
 import { formatCommand as r, rawCommand as i } from "../command/command.util.js";
 import { join as a, resolveWorkingPath as o } from "./path.util.js";
-import te from "fs-extra";
+import s from "fs-extra";
 //#region src/node/path/path.constant.ts
-var s = e().CWD, c = "@cyberskill/shared", l = "node_modules", u = "dist", d = "public", f = "package.json", p = "package-lock.json", m = "tsconfig.json", h = ".gitignore", g = ".simple-git-hooks.json", _ = "pnpm-lock.yaml", v = ".git/hooks/", y = ".git/COMMIT_EDITMSG", b = ".git/info/exclude", x = ".migrate-mongo.config.js", S = null;
-function C() {
-	if (S !== null) return S;
+var c = e().CWD, l = "@cyberskill/shared", u = "node_modules", d = "dist", f = "public", p = "package.json", m = "package-lock.json", h = "tsconfig.json", g = ".gitignore", _ = ".simple-git-hooks.json", v = "pnpm-lock.yaml", y = ".git/hooks/", b = ".git/COMMIT_EDITMSG", x = ".git/info/exclude", S = ".migrate-mongo.config.js", C = null;
+function te() {
+	C = null;
+}
+function w() {
+	if (C !== null) return C;
 	try {
-		S = te.readJsonSync(o("package.json")).name === "@cyberskill/shared" ? a(s, u) : a(s, l, c, u);
+		C = s.readJsonSync(o("package.json")).name === "@cyberskill/shared" ? a(c, d) : a(c, u, l, d);
 	} catch {
-		S = a(s, l, c, u);
+		C = a(c, u, l, d);
 	}
-	return S;
+	return C;
 }
-var ne = C(), w = "cyberskill", re = "src/node/cli/index.ts", T = "eslint", E = "eslint", D = "vitest", O = "vitest", k = "@commitlint/cli", A = "@commitlint/config-conventional", j = "commitlint", M = "lint-staged", N = "lint-staged", P = "typescript", F = "tsc", I = "tsx", L = "git", R = "pnpm", z = "pnpm exec", B = "simple-git-hooks", V = "simple-git-hooks", H = "@eslint/config-inspector", U = "eslint-config-inspector", W = "node-modules-inspector", G = "node-modules-inspector", K = "migrate-mongo", q = "./node_modules/migrate-mongo/bin/migrate-mongo", J = "storybook", Y = "storybook", X = "@vudovn/ag-kit", Z = ".agent", Q = {
+var T = w(), E = "cyberskill", ne = "src/node/cli/index.ts", D = "eslint", O = "eslint", k = "vitest", A = "vitest", j = "@commitlint/cli", M = "@commitlint/config-conventional", N = "commitlint", P = "lint-staged", F = "lint-staged", I = "typescript", re = "tsc", L = "tsx", R = "git", z = "pnpm", B = "pnpm exec", V = "simple-git-hooks", H = "simple-git-hooks", U = "@eslint/config-inspector", W = "eslint-config-inspector", G = "node-modules-inspector", K = "node-modules-inspector", q = "migrate-mongo", J = "./node_modules/migrate-mongo/bin/migrate-mongo", Y = "storybook", X = "storybook", ie = "@vudovn/ag-kit", Z = ".agent", Q = {
 	get CYBERSKILL_DIRECTORY() {
-		return C();
+		return w();
 	},
-	WORKING_DIRECTORY: s,
-	PUBLIC_DIRECTORY: o(d),
-	TS_CONFIG: o(m),
-	GIT_IGNORE: o(h),
-	GIT_HOOK: o(v),
-	GIT_COMMIT_MSG: o(y),
-	GIT_EXCLUDE: o(b),
-	SIMPLE_GIT_HOOKS_JSON: o(g),
-	PACKAGE_JSON: o(f),
-	PACKAGE_LOCK_JSON: o(p),
-	PNPM_LOCK_YAML: o(_),
-	NODE_MODULES: o(l),
-	MIGRATE_MONGO_CONFIG: o(x),
+	WORKING_DIRECTORY: c,
+	PUBLIC_DIRECTORY: o(f),
+	TS_CONFIG: o(h),
+	GIT_IGNORE: o(g),
+	GIT_HOOK: o(y),
+	GIT_COMMIT_MSG: o(b),
+	GIT_EXCLUDE: o(x),
+	SIMPLE_GIT_HOOKS_JSON: o(_),
+	PACKAGE_JSON: o(p),
+	PACKAGE_LOCK_JSON: o(m),
+	PNPM_LOCK_YAML: o(v),
+	NODE_MODULES: o(u),
+	MIGRATE_MONGO_CONFIG: o(S),
 	get LINT_STAGED_CONFIG() {
-		return o(`${C()}/config/lint-staged/index.js`);
+		return o(`${w()}/config/lint-staged/index.js`);
 	},
 	get COMMITLINT_CONFIG() {
-		return o(`${C()}/config/commitlint/index.js`);
+		return o(`${w()}/config/commitlint/index.js`);
 	},
 	get VITEST_UNIT_CONFIG() {
-		return o(`${C()}/config/vitest/vitest.unit.js`);
+		return o(`${w()}/config/vitest/vitest.unit.js`);
 	},
 	get VITEST_E2E_CONFIG() {
-		return o(`${C()}/config/vitest/vitest.e2e.js`);
+		return o(`${w()}/config/vitest/vitest.e2e.js`);
 	},
 	get STORYBOOK_MAIN_CONFIG() {
-		return o(`${C()}/config/storybook/storybook.main.js`);
+		return o(`${w()}/config/storybook/storybook.main.js`);
 	},
 	get STORYBOOK_PREVIEW_CONFIG() {
-		return o(`${C()}/config/storybook/storybook.preview.js`);
+		return o(`${w()}/config/storybook/storybook.preview.js`);
 	},
 	DOT_AGENT: o(Z)
 };
-function ie() {
+function ae() {
 	return {
-		"pre-commit": N,
-		"commit-msg": j,
-		"pre-push": i(`git pull && ${R} run --if-present test`)
+		"pre-commit": F,
+		"commit-msg": N,
+		"pre-push": i(`git pull && ${z} run --if-present test`)
 	};
 }
 function $({ type: e, packages: n, command: a }) {
 	let o = n?.reduce((e, t) => (e.some((e) => e.name === t.name) || e.push(t), e), []);
 	return async () => {
 		switch (e) {
-			case t.CLI: return o?.length && await ee(o, { install: !0 }), r(i(`${z} ${a}`));
+			case t.CLI: return o?.length && await ee(o, { install: !0 }), r(i(`${B} ${a}`));
 			case t.STRING: return r(i(a));
 			default: throw Error("Unsupported command type");
 		}
 	};
 }
-var ae = /^[\w-]+$/, oe = {
+var oe = /^[\w-]+$/, se = {
 	simpleGitHooks: $({
 		type: t.CLI,
 		packages: [{
-			name: B,
+			name: V,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: V
+		command: H
 	}),
 	eslintInspect: $({
 		type: t.CLI,
 		packages: [{
-			name: H,
+			name: U,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: U
+		command: W
 	}),
 	nodeModulesInspect: $({
 		type: t.CLI,
 		packages: [{
-			name: W,
+			name: G,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: G
+		command: K
 	}),
 	eslintCheck: $({
 		type: t.CLI,
 		packages: [{
-			name: T,
+			name: D,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${E} ${Q.WORKING_DIRECTORY} --no-cache`
+		command: `${O} ${Q.WORKING_DIRECTORY} --no-cache`
 	}),
 	eslintFix: $({
 		type: t.CLI,
 		packages: [{
-			name: T,
+			name: D,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${E} ${Q.WORKING_DIRECTORY} --fix --no-cache`
+		command: `${O} ${Q.WORKING_DIRECTORY} --fix --no-cache`
 	}),
 	typescriptCheck: $({
 		type: t.CLI,
 		packages: [{
-			name: P,
+			name: I,
 			type: n.DEV_DEPENDENCY
 		}],
 		command: `tsc -p ${Q.TS_CONFIG} --noEmit --incremental`
@@ -122,31 +125,31 @@ var ae = /^[\w-]+$/, oe = {
 	testUnit: $({
 		type: t.CLI,
 		packages: [{
-			name: D,
+			name: k,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${O} --config ${Q.VITEST_UNIT_CONFIG}`
+		command: `${A} --config ${Q.VITEST_UNIT_CONFIG}`
 	}),
 	testE2e: $({
 		type: t.CLI,
 		packages: [{
-			name: D,
+			name: k,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${O} --config ${Q.VITEST_E2E_CONFIG}`
+		command: `${A} --config ${Q.VITEST_E2E_CONFIG}`
 	}),
 	mongoMigrateCreate: (e) => {
-		if (!ae.test(e)) throw Error("Migration name must only contain alphanumeric characters, underscores, and hyphens.");
+		if (!oe.test(e)) throw Error("Migration name must only contain alphanumeric characters, underscores, and hyphens.");
 		return $({
 			type: t.CLI,
 			packages: [{
 				name: "tsx",
 				type: n.DEPENDENCY
 			}, {
-				name: K,
+				name: q,
 				type: n.DEPENDENCY
 			}],
-			command: `tsx ${q} create ${e} -f ${Q.MIGRATE_MONGO_CONFIG}`
+			command: `tsx ${J} create ${e} -f ${Q.MIGRATE_MONGO_CONFIG}`
 		})();
 	},
 	mongoMigrateUp: $({
@@ -155,10 +158,10 @@ var ae = /^[\w-]+$/, oe = {
 			name: "tsx",
 			type: n.DEPENDENCY
 		}, {
-			name: K,
+			name: q,
 			type: n.DEPENDENCY
 		}],
-		command: `tsx ${q} up -f ${Q.MIGRATE_MONGO_CONFIG}`
+		command: `tsx ${J} up -f ${Q.MIGRATE_MONGO_CONFIG}`
 	}),
 	mongoMigrateDown: $({
 		type: t.CLI,
@@ -166,29 +169,29 @@ var ae = /^[\w-]+$/, oe = {
 			name: "tsx",
 			type: n.DEPENDENCY
 		}, {
-			name: K,
+			name: q,
 			type: n.DEPENDENCY
 		}],
-		command: `tsx ${q} down -f ${Q.MIGRATE_MONGO_CONFIG}`
+		command: `tsx ${J} down -f ${Q.MIGRATE_MONGO_CONFIG}`
 	}),
 	commitLint: $({
 		type: t.CLI,
 		packages: [{
-			name: k,
+			name: j,
 			type: n.DEV_DEPENDENCY
 		}, {
-			name: A,
+			name: M,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${j} --edit ${Q.GIT_COMMIT_MSG} --config ${Q.COMMITLINT_CONFIG}`
+		command: `${N} --edit ${Q.GIT_COMMIT_MSG} --config ${Q.COMMITLINT_CONFIG}`
 	}),
 	lintStaged: $({
 		type: t.CLI,
 		packages: [{
-			name: M,
+			name: P,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${N} --config ${Q.LINT_STAGED_CONFIG}`
+		command: `${F} --config ${Q.LINT_STAGED_CONFIG}`
 	}),
 	configureGitHook: $({
 		type: t.STRING,
@@ -196,46 +199,46 @@ var ae = /^[\w-]+$/, oe = {
 	}),
 	build: $({
 		type: t.STRING,
-		command: `${R} run --if-present build`
+		command: `${z} run --if-present build`
 	}),
 	pnpmInstallStandard: $({
 		type: t.STRING,
-		command: `${R} install --ignore-scripts`
+		command: `${z} install --ignore-scripts`
 	}),
 	pnpmInstallLegacy: $({
 		type: t.STRING,
-		command: `${R} install --ignore-scripts --legacy-peer-deps`
+		command: `${z} install --ignore-scripts --legacy-peer-deps`
 	}),
 	pnpmInstallForce: $({
 		type: t.STRING,
-		command: `${R} install --ignore-scripts --force`
+		command: `${z} install --ignore-scripts --force`
 	}),
 	pnpmPruneStore: $({
 		type: t.STRING,
-		command: `${R} store prune`
+		command: `${z} store prune`
 	}),
 	pnpmCleanCache: $({
 		type: t.STRING,
-		command: `${R} cache delete`
+		command: `${z} cache delete`
 	}),
 	storybookDev: $({
 		type: t.CLI,
 		packages: [{
-			name: J,
+			name: Y,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${Y} dev`
+		command: `${X} dev`
 	}),
 	storybookBuild: $({
 		type: t.CLI,
 		packages: [{
-			name: J,
+			name: Y,
 			type: n.DEV_DEPENDENCY
 		}],
-		command: `${Y} build`
+		command: `${X} build`
 	})
 };
 //#endregion
-export { X as AG_KIT_PACKAGE_NAME, u as BUILD_DIRECTORY, j as COMMIT_LINT_CLI, A as COMMIT_LINT_CONVENTIONAL_CONFIG_PACKAGE_NAME, k as COMMIT_LINT_PACKAGE_NAME, w as CYBERSKILL_CLI, re as CYBERSKILL_CLI_PATH, ne as CYBERSKILL_DIRECTORY, c as CYBERSKILL_PACKAGE_NAME, Z as DOT_AGENT, E as ESLINT_CLI, U as ESLINT_INSPECT_CLI, H as ESLINT_INSPECT_PACKAGE_NAME, T as ESLINT_PACKAGE_NAME, L as GIT_CLI, y as GIT_COMMIT_EDITMSG, b as GIT_EXCLUDE, v as GIT_HOOK, h as GIT_IGNORE, N as LINT_STAGED_CLI, M as LINT_STAGED_PACKAGE_NAME, q as MIGRATE_MONGO_CLI, x as MIGRATE_MONGO_CONFIG, K as MIGRATE_MONGO_PACKAGE_NAME, l as NODE_MODULES, G as NODE_MODULES_INSPECT_CLI, W as NODE_MODULES_INSPECT_PACKAGE_NAME, f as PACKAGE_JSON, p as PACKAGE_LOCK_JSON, Q as PATH, R as PNPM_CLI, z as PNPM_EXEC_CLI, _ as PNPM_LOCK_YAML, d as PUBLIC_DIRECTORY, B as SIMPLE_GIT_HOOKS_PACKAGE_NAME, V as SIMPLE_GIT_HOOK_CLI, g as SIMPLE_GIT_HOOK_JSON, Y as STORYBOOK_CLI, J as STORYBOOK_PACKAGE_NAME, m as TSCONFIG_JSON, F as TSC_CLI, P as TSC_PACKAGE_NAME, I as TSX_CLI, O as VITEST_CLI, D as VITEST_PACKAGE_NAME, s as WORKING_DIRECTORY, oe as command, ie as createGitHooksConfig, C as getCyberskillDirectory };
+export { ie as AG_KIT_PACKAGE_NAME, d as BUILD_DIRECTORY, N as COMMIT_LINT_CLI, M as COMMIT_LINT_CONVENTIONAL_CONFIG_PACKAGE_NAME, j as COMMIT_LINT_PACKAGE_NAME, E as CYBERSKILL_CLI, ne as CYBERSKILL_CLI_PATH, T as CYBERSKILL_DIRECTORY, l as CYBERSKILL_PACKAGE_NAME, Z as DOT_AGENT, O as ESLINT_CLI, W as ESLINT_INSPECT_CLI, U as ESLINT_INSPECT_PACKAGE_NAME, D as ESLINT_PACKAGE_NAME, R as GIT_CLI, b as GIT_COMMIT_EDITMSG, x as GIT_EXCLUDE, y as GIT_HOOK, g as GIT_IGNORE, F as LINT_STAGED_CLI, P as LINT_STAGED_PACKAGE_NAME, J as MIGRATE_MONGO_CLI, S as MIGRATE_MONGO_CONFIG, q as MIGRATE_MONGO_PACKAGE_NAME, u as NODE_MODULES, K as NODE_MODULES_INSPECT_CLI, G as NODE_MODULES_INSPECT_PACKAGE_NAME, p as PACKAGE_JSON, m as PACKAGE_LOCK_JSON, Q as PATH, z as PNPM_CLI, B as PNPM_EXEC_CLI, v as PNPM_LOCK_YAML, f as PUBLIC_DIRECTORY, V as SIMPLE_GIT_HOOKS_PACKAGE_NAME, H as SIMPLE_GIT_HOOK_CLI, _ as SIMPLE_GIT_HOOK_JSON, X as STORYBOOK_CLI, Y as STORYBOOK_PACKAGE_NAME, h as TSCONFIG_JSON, re as TSC_CLI, I as TSC_PACKAGE_NAME, L as TSX_CLI, A as VITEST_CLI, k as VITEST_PACKAGE_NAME, c as WORKING_DIRECTORY, se as command, ae as createGitHooksConfig, w as getCyberskillDirectory, te as resetCyberskillDirCacheForTesting };
 
 //# sourceMappingURL=path.constant.js.map

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 --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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"}
+{"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 * Resets the cached directory path. For testing only.\n */\nexport function resetCyberskillDirCacheForTesting(): void {\n    _cyberskillDir = null;\n}\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        /* Intentionally empty — fallback to node_modules path when package.json is unreadable */\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/dist/node/storage/index.d.ts

@@ -1 +1,3 @@
-export {}
+export * from './storage.constant.js';
+export * from './storage.type.js';
+export * from './storage.util.js';

package/dist/{src/node → node}/storage/storage.util.d.ts

@@ -1,9 +1,25 @@
+export interface I_StorageDriver {
+    init: (options?: unknown) => Promise<void>;
+    clear: () => Promise<void>;
+    getItem: <T>(key: string) => Promise<T | null>;
+    keys: () => Promise<string[]>;
+    removeItem: (key: string) => Promise<void>;
+    setItem: <T>(key: string, value: T) => Promise<T>;
+}
 /**
  * Persistent storage utility object for data persistence across application sessions.
  * Uses a filesystem-backed driver that stores JSON-encoded values on disk,
  * with automatic initialization and error handling.
  */
 export declare const storage: {
+    /**
+     * Initializes the utility with a custom storage driver instead of the default filesystem driver.
+     * This allows swapping to Redis, Memory, or cloud-based drivers.
+     * Must optionally be called before the first read/write operation.
+     *
+     * @param driver - The custom storage driver object that adheres to I_StorageDriver.
+     */
+    initDriver(driver: I_StorageDriver): Promise<void>;
     /**
      * Retrieves a value from persistent storage by key.
      * This method fetches data that was previously stored using the set method.
@@ -20,9 +36,13 @@ export declare const storage: {
      *
      * @param key - The unique identifier for the value to store.
      * @param value - The data to store (will be automatically serialized).
+     * @param options - Optional settings, such as `ttlMs` for setting an expiration on the key.
+     * @param options.ttlMs - The time-to-live in milliseconds.
      * @returns A promise that resolves when the storage operation is complete.
      */
-    set<T = unknown>(key: string, value: T): Promise<void>;
+    set<T = unknown>(key: string, value: T, options?: {
+        ttlMs?: number;
+    }): Promise<void>;
     /**
      * Removes a value from persistent storage by key.
      * This method permanently deletes the stored data associated with the specified key.
@@ -31,6 +51,21 @@ export declare const storage: {
      * @returns A promise that resolves when the removal operation is complete.
      */
     remove(key: string): Promise<void>;
+    /**
+     * Checks if a key exists in persistent storage.
+     * This method efficiently checks for key existence and respects TTL parsing.
+     * Returns false if the key exists but has expired.
+     *
+     * @param key - The unique identifier to check.
+     * @returns A promise that resolves to true if the key exists and has not expired.
+     * @since 3.13.0
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clears all entries from storage atomically.
+     * @returns A promise that resolves when the clearing operation is complete.
+     */
+    clear(): Promise<void>;
     /**
      * Retrieves all storage keys.
      * This method returns an array of all keys that currently have stored values.
@@ -48,10 +83,24 @@ export declare const storage: {
      * @returns A promise that resolves to a formatted log link string or null if an error occurs.
      */
     getLogLink(key: string): Promise<string | null>;
+    /**
+     * Retrieves a value from persistent storage, or creates and stores it if it doesn't exist.
+     * This method combines check, creation, and storage into a single convenient operation.
+     *
+     * @param key - The unique identifier for the value.
+     * @param factory - A function (sync or async) that generates the value if it's missing or expired.
+     * @param options - Optional storage options.
+     * @param options.ttlMs - The time-to-live in milliseconds.
+     * @returns A promise that resolves to the retrieved or newly created value.
+     */
+    getOrSet<T = unknown>(key: string, factory: () => T | Promise<T>, options?: {
+        ttlMs?: number;
+    }): Promise<T>;
 };
 /**
  * Resets all module-level singleton state used by the storage module.
  * Intended for use in tests to ensure isolation between test cases.
  * Do NOT call this in production code.
+ * @since 3.13.0
  */
 export declare function resetStorageForTesting(): void;