alex-c-line 1.31.0 → 1.33.0

package/dist/index.cjs

@@ -59,6 +59,7 @@ let _alextheman_utility_node = require("@alextheman/utility/node");
 let supports_color = require("supports-color");
 supports_color = __toESM(supports_color);
 let node_crypto = require("node:crypto");
+let semver = require("semver");
 
 //#region src/utility/miscellaneous/asciiToPng.ts
 async function asciiToPng(ascii, options) {
@@ -627,35 +628,35 @@ async function parseDotenvFile(envFilePath) {
 //#endregion
 //#region src/cli/commands/edit-env-file/index.ts
 function editEnvFile(program) {
-	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ interactive, file }) => {
+	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ file, interactive }) => {
 		if (interactive) {
 			let exitInteractiveMode = false;
 			while (!exitInteractiveMode) {
 				const envFileContents = await parseDotenvFile(file);
 				const variableToEdit = await (0, _inquirer_prompts.select)({
-					message: _alextheman_utility.normaliseIndents`
-            Please select the environment variable you wish to edit
-            Currently editing file: ${file}
-            `,
 					choices: [
 						...Object.keys(envFileContents).map((key) => {
 							return {
+								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>",
 								name: key,
-								value: key,
-								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>"
+								value: key
 							};
 						}),
 						{
+							description: `Add a new environment variable to .env.`,
 							name: `${chalk.default.green("+")} Add new environment variable`,
-							value: "Add new",
-							description: `Add a new environment variable to .env.`
+							value: "Add new"
 						},
 						{
+							description: "Exit the .env file interactive editor.",
 							name: `${chalk.default.dim("⏎")} Exit editor`,
-							value: "Exit editor",
-							description: "Exit the .env file interactive editor."
+							value: "Exit editor"
 						}
-					]
+					],
+					message: _alextheman_utility.normaliseIndents`
+            Please select the environment variable you wish to edit
+            Currently editing file: ${file}
+            `
 				});
 				switch (variableToEdit) {
 					case "Add new":
@@ -735,6 +736,31 @@ function gitPostMergeCleanup(program) {
 	});
 }
 
+//#endregion
+//#region src/cli/commands/internal/outdated-dependencies.ts
+function outdatedDependencies(program) {
+	program.command("outdated-dependencies").action(async () => {
+		const { exitCode, stdout, stderr } = await (0, execa.execa)({ reject: false })`pnpm outdated`;
+		if (![0, 1].includes(exitCode)) program.error(stderr ?? stdout, {
+			exitCode,
+			code: "PNPM_OUDATED_ERROR"
+		});
+		console.info(stdout);
+	});
+}
+
+//#endregion
+//#region src/utility/miscellaneous/loadCommands.ts
+function loadCommands(program, commandMap) {
+	for (const loader of Object.values(commandMap)) loader(program);
+}
+
+//#endregion
+//#region src/cli/commands/internal/index.ts
+function internal(program) {
+	loadCommands(program.command("internal").description("Commands meant more for internal use by me and is not recommended for production usage."), { outdatedDependencies });
+}
+
 //#endregion
 //#region src/cli/commands/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = (0, execa.execa)({
@@ -1316,7 +1342,7 @@ function parseZodSchemaForProgram(programError, schema, data) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version = "1.31.0";
+var version = "1.33.0";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 
 //#endregion
@@ -1561,12 +1587,6 @@ function generateUUID(program) {
 	});
 }
 
-//#endregion
-//#region src/utility/miscellaneous/loadCommands.ts
-function loadCommands(program, commandMap) {
-	for (const loader of Object.values(commandMap)) loader(program);
-}
-
 //#endregion
 //#region src/cli/commands/uuid/index.ts
 function uuid(program) {
@@ -1619,6 +1639,50 @@ function incrementVersion(program) {
 	});
 }
 
+//#endregion
+//#region src/utility/constants/successPrefix.ts
+const successPrefix = chalk.default.green("✓");
+
+//#endregion
+//#region src/cli/commands/package-json/noPreReleaseDependencies.ts
+function isPreRelease(dependencyVersionRange) {
+	const minimumFromRange = (0, semver.minVersion)(dependencyVersionRange);
+	return minimumFromRange !== null && (0, semver.prerelease)(minimumFromRange) !== null;
+}
+async function noPreReleaseDependencies(program) {
+	const packageJson = await (0, _alextheman_utility_internal.getPackageJsonContents)(process.cwd());
+	if (packageJson === null) throw (0, _alextheman_utility_internal.packageJsonNotFoundError)(process.cwd());
+	const dependencies = (0, _alextheman_utility_internal.getDependenciesFromGroup)(packageJson, "dependencies");
+	const devDependencies = (0, _alextheman_utility_internal.getDependenciesFromGroup)(packageJson, "devDependencies");
+	const preReleaseDependencies = {};
+	const preReleaseDevDependencies = {};
+	for (const [dependencyName, dependencyVersionRange] of Object.entries(dependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDependencies[dependencyName] = dependencyVersionRange;
+	for (const [dependencyName, dependencyVersionRange] of Object.entries(devDependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDevDependencies[dependencyName] = dependencyVersionRange;
+	if (Object.keys(preReleaseDependencies).length !== 0 || Object.keys(preReleaseDevDependencies).length !== 0) program.error(_alextheman_utility.normaliseIndents`
+            ${errorPrefix}: Pre-release version pinning is not allowed. Found the following violations:
+
+            ${JSON.stringify({
+		dependencies: preReleaseDependencies,
+		devDependencies: preReleaseDevDependencies
+	}, null, 2)}
+        `, {
+		exitCode: 2,
+		code: "UNEXPECTED_PRE_RELEASE_VERSION"
+	});
+	console.info(`${successPrefix} No pre-release versions found!`);
+}
+
+//#endregion
+//#region src/cli/commands/package-json/index.ts
+const RuleName = { NO_PRE_RELEASE_DEPENDENCIES: "no-pre-release-dependencies" };
+function packageJson(program) {
+	program.command("package-json").description("Run checks on your package.json file").argument("[ruleName]", "The name of the rule to check", (rawRuleName) => {
+		return (0, _alextheman_utility.parseZodSchema)(zod.default.enum(RuleName), rawRuleName);
+	}).action(async (ruleName) => {
+		if (ruleName === "no-pre-release-dependencies") return await noPreReleaseDependencies(program);
+	});
+}
+
 //#endregion
 //#region src/cli/commands/index.ts
 function createCommands(program) {
@@ -1641,7 +1705,9 @@ function createCommands(program) {
 		getVersionType,
 		gitPostMergeCleanup,
 		incrementVersion,
+		internal,
 		migrateReleaseNotes,
+		packageJson,
 		preCommit,
 		preCommit2,
 		sayHello,

package/dist/index.js

@@ -15,12 +15,13 @@ import dotenvStringify from "dotenv-stringify";
 import z from "zod";
 import { confirm, input, password, select } from "@inquirer/prompts";
 import os from "node:os";
-import { PackageManager, getDependenciesFromGroup, getExpectedTgzName, getPackageJsonContents } from "@alextheman/utility/internal";
+import { PackageManager, getDependenciesFromGroup, getExpectedTgzName, getPackageJsonContents, packageJsonNotFoundError } from "@alextheman/utility/internal";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import matter from "gray-matter";
 import { parseFilePath } from "@alextheman/utility/node";
 import supportsColor from "supports-color";
 import { randomUUID } from "node:crypto";
+import { minVersion, prerelease } from "semver";
 
 //#region src/utility/miscellaneous/asciiToPng.ts
 async function asciiToPng(ascii, options) {
@@ -589,35 +590,35 @@ async function parseDotenvFile(envFilePath) {
 //#endregion
 //#region src/cli/commands/edit-env-file/index.ts
 function editEnvFile(program) {
-	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ interactive, file }) => {
+	program.command("edit-env-file").description("Edit properties in a .env file").option("--interactive", "Enable interactive mode", true).option("--file <filePath>", "The path to the .env file you want to edit, relative to the working directory this command is run", ".env").action(async ({ file, interactive }) => {
 		if (interactive) {
 			let exitInteractiveMode = false;
 			while (!exitInteractiveMode) {
 				const envFileContents = await parseDotenvFile(file);
 				const variableToEdit = await select({
-					message: normaliseIndents`
-            Please select the environment variable you wish to edit
-            Currently editing file: ${file}
-            `,
 					choices: [
 						...Object.keys(envFileContents).map((key) => {
 							return {
+								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>",
 								name: key,
-								value: key,
-								description: envFileContents[key] === "" ? "<empty>" : "<redacted for safety>"
+								value: key
 							};
 						}),
 						{
+							description: `Add a new environment variable to .env.`,
 							name: `${chalk.green("+")} Add new environment variable`,
-							value: "Add new",
-							description: `Add a new environment variable to .env.`
+							value: "Add new"
 						},
 						{
+							description: "Exit the .env file interactive editor.",
 							name: `${chalk.dim("⏎")} Exit editor`,
-							value: "Exit editor",
-							description: "Exit the .env file interactive editor."
+							value: "Exit editor"
 						}
-					]
+					],
+					message: normaliseIndents`
+            Please select the environment variable you wish to edit
+            Currently editing file: ${file}
+            `
 				});
 				switch (variableToEdit) {
 					case "Add new":
@@ -697,6 +698,31 @@ function gitPostMergeCleanup(program) {
 	});
 }
 
+//#endregion
+//#region src/cli/commands/internal/outdated-dependencies.ts
+function outdatedDependencies(program) {
+	program.command("outdated-dependencies").action(async () => {
+		const { exitCode, stdout, stderr } = await execa({ reject: false })`pnpm outdated`;
+		if (![0, 1].includes(exitCode)) program.error(stderr ?? stdout, {
+			exitCode,
+			code: "PNPM_OUDATED_ERROR"
+		});
+		console.info(stdout);
+	});
+}
+
+//#endregion
+//#region src/utility/miscellaneous/loadCommands.ts
+function loadCommands(program, commandMap) {
+	for (const loader of Object.values(commandMap)) loader(program);
+}
+
+//#endregion
+//#region src/cli/commands/internal/index.ts
+function internal(program) {
+	loadCommands(program.command("internal").description("Commands meant more for internal use by me and is not recommended for production usage."), { outdatedDependencies });
+}
+
 //#endregion
 //#region src/cli/commands/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = execa({
@@ -1278,7 +1304,7 @@ function parseZodSchemaForProgram(programError, schema, data) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version = "1.31.0";
+var version = "1.33.0";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 
 //#endregion
@@ -1523,12 +1549,6 @@ function generateUUID(program) {
 	});
 }
 
-//#endregion
-//#region src/utility/miscellaneous/loadCommands.ts
-function loadCommands(program, commandMap) {
-	for (const loader of Object.values(commandMap)) loader(program);
-}
-
 //#endregion
 //#region src/cli/commands/uuid/index.ts
 function uuid(program) {
@@ -1581,6 +1601,50 @@ function incrementVersion(program) {
 	});
 }
 
+//#endregion
+//#region src/utility/constants/successPrefix.ts
+const successPrefix = chalk.green("✓");
+
+//#endregion
+//#region src/cli/commands/package-json/noPreReleaseDependencies.ts
+function isPreRelease(dependencyVersionRange) {
+	const minimumFromRange = minVersion(dependencyVersionRange);
+	return minimumFromRange !== null && prerelease(minimumFromRange) !== null;
+}
+async function noPreReleaseDependencies(program) {
+	const packageJson = await getPackageJsonContents(process.cwd());
+	if (packageJson === null) throw packageJsonNotFoundError(process.cwd());
+	const dependencies = getDependenciesFromGroup(packageJson, "dependencies");
+	const devDependencies = getDependenciesFromGroup(packageJson, "devDependencies");
+	const preReleaseDependencies = {};
+	const preReleaseDevDependencies = {};
+	for (const [dependencyName, dependencyVersionRange] of Object.entries(dependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDependencies[dependencyName] = dependencyVersionRange;
+	for (const [dependencyName, dependencyVersionRange] of Object.entries(devDependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDevDependencies[dependencyName] = dependencyVersionRange;
+	if (Object.keys(preReleaseDependencies).length !== 0 || Object.keys(preReleaseDevDependencies).length !== 0) program.error(normaliseIndents`
+            ${errorPrefix}: Pre-release version pinning is not allowed. Found the following violations:
+
+            ${JSON.stringify({
+		dependencies: preReleaseDependencies,
+		devDependencies: preReleaseDevDependencies
+	}, null, 2)}
+        `, {
+		exitCode: 2,
+		code: "UNEXPECTED_PRE_RELEASE_VERSION"
+	});
+	console.info(`${successPrefix} No pre-release versions found!`);
+}
+
+//#endregion
+//#region src/cli/commands/package-json/index.ts
+const RuleName = { NO_PRE_RELEASE_DEPENDENCIES: "no-pre-release-dependencies" };
+function packageJson(program) {
+	program.command("package-json").description("Run checks on your package.json file").argument("[ruleName]", "The name of the rule to check", (rawRuleName) => {
+		return parseZodSchema(z.enum(RuleName), rawRuleName);
+	}).action(async (ruleName) => {
+		if (ruleName === "no-pre-release-dependencies") return await noPreReleaseDependencies(program);
+	});
+}
+
 //#endregion
 //#region src/cli/commands/index.ts
 function createCommands(program) {
@@ -1603,7 +1667,9 @@ function createCommands(program) {
 		getVersionType,
 		gitPostMergeCleanup,
 		incrementVersion,
+		internal,
 		migrateReleaseNotes,
+		packageJson,
 		preCommit,
 		preCommit2,
 		sayHello,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alex-c-line",
-  "version": "1.31.0",
+  "version": "1.33.0",
   "description": "Command-line tool with commands to streamline the developer workflow.",
   "repository": {
     "type": "git",
@@ -34,8 +34,8 @@
     "templates"
   ],
   "dependencies": {
-    "@alextheman/utility": "^5.4.1",
-    "@inquirer/prompts": "^8.2.1",
+    "@alextheman/utility": "^5.5.0",
+    "@inquirer/prompts": "^8.3.0",
     "boxen": "^8.0.1",
     "canvas": "^3.2.1",
     "chalk": "^5.6.2",
@@ -47,24 +47,27 @@
     "figlet": "^1.10.0",
     "gray-matter": "^4.0.3",
     "libsodium-wrappers": "^0.8.2",
+    "semver": "^7.7.4",
     "supports-color": "^10.2.2",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^5.8.1",
+    "@alextheman/eslint-plugin": "^5.9.1",
     "@commander-js/extra-typings": "^14.0.0",
     "@types/eslint": "^9.6.1",
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.2",
+    "@types/semver": "^7.7.1",
     "@types/update-notifier": "^6.0.8",
+    "cross-env": "^10.1.0",
     "dotenv-cli": "^11.0.0",
-    "eslint": "^10.0.1",
+    "eslint": "^10.0.2",
     "husky": "^9.1.7",
     "prettier": "^3.8.1",
     "tempy": "^3.2.0",
     "ts-node": "^10.9.2",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.0",
+    "typescript-eslint": "^8.56.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.0.18"
   },
@@ -95,7 +98,7 @@
     "prepare-local-eslint-plugin": "dotenv -e .env -- sh -c 'ESLINT_PLUGIN_PATH=${LOCAL_ESLINT_PLUGIN_PATH:-../eslint-plugin}; pnpm --prefix \"$ESLINT_PLUGIN_PATH\" run build && pnpm uninstall @alextheman/eslint-plugin && pnpm install --save-dev file:\"$ESLINT_PLUGIN_PATH\"'",
     "prepare-local-utility": "dotenv -e .env -- sh -c 'UTILITY_PATH=${LOCAL_UTILITY_PATH:-../utility}; pnpm --prefix \"$UTILITY_PATH\" run build && pnpm uninstall @alextheman/utility && pnpm install file:\"$UTILITY_PATH\"'",
     "test": "vitest run",
-    "test-end-to-end": "RUN_END_TO_END=true vitest run tests/end-to-end --reporter verbose",
+    "test-end-to-end": "cross-env RUN_END_TO_END=true vitest run tests/end-to-end --reporter verbose",
     "test-watch": "vitest",
     "update-dependencies": "pnpm update --latest && pnpm update",
     "use-live-eslint-plugin": "pnpm run prepare-live-eslint-plugin && pnpm run lint",