@mtndev/cli 2.0.0 → 2.0.1

package/cjs/commands/doppler/utils/exec.cjs

@@ -1,12 +1,106 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-var _NIMXXHJQcjs = require('../../../__chunks/NIMXXHJQ.cjs');
-
-
-
-
-
-exports.exec = _NIMXXHJQcjs.exec; exports.execJson = _NIMXXHJQcjs.execJson; exports.execNumber = _NIMXXHJQcjs.execNumber; exports.execString = _NIMXXHJQcjs.execString;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("../../../__chunks/VH7oDXx4.cjs");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk, 1);
+let child_process = require("child_process");
+//#region src/commands/doppler/utils/exec.js
+/**
+* @typedef {'silent' | 'verbose' | 'default'} VerbosityLevel
+*/
+/**
+* @typedef {Object} ExecOptions
+* @property {'string' | 'number' | 'json'} [stdoutParser='string'] - How to parse stdout
+* @property {boolean} [throwOnError=true] - Whether to throw on error
+* @property {VerbosityLevel} [verbosity='default'] - Output verbosity level
+*/
+/**
+* Execute a command and parse the output
+* @param {string} command - Command to execute
+* @param {import('child_process').ExecSyncOptions & ExecOptions} [options={}] - Execution options (inherits all execSync options + custom options)
+* @returns {string | number | any} - Parsed output based on stdoutParser
+*/
+function exec(command, options = {}) {
+	const { stdoutParser = "string", throwOnError = true, verbosity = "default", stdio: userStdio, ...execSyncOptions } = options;
+	try {
+		if (verbosity === "verbose") console.log(chalk.default.gray(`   Executing: ${command}`));
+		/** @type {import('child_process').StdioOptions} */
+		let stdio;
+		if (userStdio) stdio = userStdio;
+		else if (verbosity === "verbose") stdio = "inherit";
+		else if (verbosity === "silent") stdio = "pipe";
+		else stdio = [
+			"pipe",
+			"pipe",
+			"pipe"
+		];
+		const result = (0, child_process.execSync)(command, {
+			encoding: "utf-8",
+			stdio,
+			...execSyncOptions
+		});
+		if (stdio === "inherit") return stdoutParser === "string" ? "" : void 0;
+		if (!result || typeof result === "string" && !result.trim()) return stdoutParser === "string" ? "" : void 0;
+		switch (stdoutParser) {
+			case "json": try {
+				return JSON.parse(result);
+			} catch (parseError) {
+				if (throwOnError) throw new Error(`Failed to parse JSON output: ${parseError.message}`);
+				return;
+			}
+			case "number": {
+				const num = parseFloat(result.trim());
+				if (isNaN(num)) {
+					if (throwOnError) throw new Error(`Failed to parse number from output: ${result}`);
+					return;
+				}
+				return num;
+			}
+			default: return result;
+		}
+	} catch (error) {
+		if (!throwOnError) return;
+		if (error.stderr) throw new Error(error.stderr.toString());
+		throw error;
+	}
+}
+/**
+* Execute a command with string output
+* @param {string} command - Command to execute
+* @param {import('child_process').ExecSyncOptions & ExecOptions} [options] - Execution options
+* @returns {string}
+*/
+function execString(command, options = {}) {
+	return exec(command, {
+		...options,
+		stdoutParser: "string"
+	});
+}
+/**
+* Execute a command with JSON output
+* @param {string} command - Command to execute
+* @param {import('child_process').ExecSyncOptions & ExecOptions} [options] - Execution options
+* @returns {any}
+*/
+function execJson(command, options = {}) {
+	return exec(command, {
+		...options,
+		stdoutParser: "json"
+	});
+}
+/**
+* Execute a command with number output
+* @param {string} command - Command to execute
+* @param {import('child_process').ExecSyncOptions & ExecOptions} [options] - Execution options
+* @returns {number}
+*/
+function execNumber(command, options = {}) {
+	return exec(command, {
+		...options,
+		stdoutParser: "number"
+	});
+}
+//#endregion
+exports.exec = exec;
+exports.execJson = execJson;
+exports.execNumber = execNumber;
+exports.execString = execString;

package/cjs/commands/doppler/utils.cjs

@@ -1,34 +1,412 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-
-
-
-var _JB7T7PKQcjs = require('../../__chunks/JB7T7PKQ.cjs');
-
-
-
-
-
-var _NIMXXHJQcjs = require('../../__chunks/NIMXXHJQ.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.checkDependencies = _JB7T7PKQcjs.checkDependencies; exports.checkDopplerAuth = _JB7T7PKQcjs.checkDopplerAuth; exports.cloneProject = _JB7T7PKQcjs.cloneProject; exports.createDiff = _JB7T7PKQcjs.createDiff; exports.downloadConfigs = _JB7T7PKQcjs.downloadConfigs; exports.exec = _NIMXXHJQcjs.exec; exports.execDoppler = _JB7T7PKQcjs.execDoppler; exports.execJson = _NIMXXHJQcjs.execJson; exports.execNumber = _NIMXXHJQcjs.execNumber; exports.execString = _NIMXXHJQcjs.execString; exports.getConfigs = _JB7T7PKQcjs.getConfigs; exports.normalizeEscapeSequences = _JB7T7PKQcjs.normalizeEscapeSequences; exports.promptConfirmation = _JB7T7PKQcjs.promptConfirmation; exports.uploadConfigs = _JB7T7PKQcjs.uploadConfigs;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("../../__chunks/VH7oDXx4.cjs");
+const require_commands_doppler_utils_exec = require("./utils/exec.cjs");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk, 1);
+let child_process = require("child_process");
+let fs = require("fs");
+let path = require("path");
+let readline = require("readline");
+let os = require("os");
+//#region src/commands/doppler/utils.js
+/**
+* @typedef {import('./utils/exec.js').VerbosityLevel} VerbosityLevel
+* @typedef {import('./utils/exec.js').ExecOptions} ExecOptions
+*/
+const DEFAULT_DOPPLER_ENVIRONMENT = "dev";
+const DOPPLER_INTERNAL_KEYS = /* @__PURE__ */ new Set([
+	"DOPPLER_CONFIG",
+	"DOPPLER_ENVIRONMENT",
+	"DOPPLER_PROJECT"
+]);
+/**
+* Execute a doppler command and return the result
+* @param {string[]} args - Command arguments
+* @param {'string' | 'json'} parser - How to parse the output
+* @param {boolean} silent - Suppress output
+* @param {boolean} verbose - Show verbose output
+* @returns {string | any}
+*/
+function execDoppler(args, parser = "string", silent = false, verbose = false) {
+	const command = `doppler ${args.join(" ")}`;
+	/** @type {import('./utils/exec.js').VerbosityLevel} */
+	let verbosity = "default";
+	if (verbose) verbosity = "verbose";
+	else if (silent) verbosity = "silent";
+	return require_commands_doppler_utils_exec.exec(command, {
+		verbosity,
+		stdoutParser: parser,
+		throwOnError: true
+	});
+}
+/**
+* Check if the Doppler CLI is installed and the user is logged in.
+* Does not require a local project setup (doppler setup).
+* @param {boolean} verbose - Show verbose output
+*/
+function checkDopplerAuth(verbose = false) {
+	if (verbose) console.log(chalk.default.blue("\n🔍 Checking Doppler authentication..."));
+	try {
+		(0, child_process.execSync)("which doppler", { stdio: "pipe" });
+		if (verbose) console.log(chalk.default.green("   ✓ Doppler CLI is installed"));
+	} catch {
+		throw new Error("Doppler is not installed. Please install Doppler (brew install dopplerhq/cli/doppler), login, and try again.");
+	}
+	try {
+		execDoppler(["me"], "string", true, verbose);
+		if (verbose) console.log(chalk.default.green("   ✓ Doppler is authenticated"));
+	} catch {
+		throw new Error("Doppler is not logged in. Please run 'doppler login' and try again.");
+	}
+}
+/**
+* Check if doppler CLI is installed, logged in, and a project is configured.
+* @param {boolean} verbose - Show verbose output
+*/
+function checkDependencies(verbose = false) {
+	checkDopplerAuth(verbose);
+	if (verbose) console.log(chalk.default.blue("\n🔍 Checking Doppler project setup..."));
+	try {
+		execDoppler(["configs", "--json"], "json", true, verbose);
+		if (verbose) console.log(chalk.default.green("   ✓ Doppler project is configured"));
+	} catch {
+		throw new Error("Doppler is not configured. Please run 'doppler setup' and try again.");
+	}
+}
+/**
+* Get list of configurations based on environments parameter
+* @param {string} environments - Comma-separated env names ('all', 'dev', 'dev,stg', etc.)
+* @param {boolean} verbose - Show verbose output
+* @param {string | null} project - Optional Doppler project name
+* @returns {string[]}
+*/
+function getConfigs(environments, verbose = false, project = null) {
+	if (verbose) console.log(chalk.default.blue(`\n📋 Resolving configurations for environments: ${chalk.default.cyan(environments)}`));
+	const configArgs = ["configs", "--json"];
+	if (project) configArgs.push("--project", project);
+	const availableConfigs = execDoppler(configArgs, "json", true, verbose);
+	const configNames = Array.isArray(availableConfigs) ? availableConfigs.map((config) => config.name) : [];
+	if (verbose && configNames.length > 0) console.log(chalk.default.gray(`   Available configurations: ${configNames.join(", ")}`));
+	if (environments === "all") {
+		if (configNames.length === 0) throw new Error("No configurations found in Doppler");
+		if (verbose) console.log(chalk.default.green(`   ✓ Using all ${configNames.length} configurations`));
+		return configNames;
+	}
+	const requested = environments.split(",").map((e) => e.trim());
+	if (configNames.length > 0) {
+		const missing = requested.filter((e) => !configNames.includes(e));
+		if (missing.length > 0) throw new Error(`Configurations not found: ${missing.join(", ")}. Available: ${configNames.join(", ")}`);
+	}
+	if (verbose) console.log(chalk.default.green(`   ✓ Using configurations: ${requested.join(", ")}`));
+	return requested;
+}
+/**
+* Normalize escape sequences in file content
+* @param {string} content - File content
+* @returns {string}
+*/
+function normalizeEscapeSequences(content) {
+	return content.replace(/\\n/g, "\n").replace(/\\t/g, "	").replace(/\\r/g, "\r");
+}
+/**
+* Create a unified diff between two strings
+* @param {string} oldContent - Original content
+* @param {string} newContent - New content
+* @returns {string[]}
+*/
+function createDiff(oldContent, newContent) {
+	const oldLines = oldContent.split("\n");
+	const newLines = newContent.split("\n");
+	const diff = [];
+	const maxLines = Math.max(oldLines.length, newLines.length);
+	for (let i = 0; i < maxLines; i++) {
+		const oldLine = oldLines[i] || "";
+		const newLine = newLines[i] || "";
+		if (oldLine !== newLine) {
+			if (oldLine && !newLine) diff.push(`-${oldLine}`);
+			else if (!oldLine && newLine) diff.push(`+${newLine}`);
+			else {
+				diff.push(`-${oldLine}`);
+				diff.push(`+${newLine}`);
+			}
+		}
+	}
+	return diff;
+}
+/**
+* Prompt user for confirmation
+* @param {string} message - Prompt message
+* @returns {Promise<boolean>}
+*/
+function promptConfirmation(message) {
+	return new Promise((resolve) => {
+		const rl = (0, readline.createInterface)({
+			input: process.stdin,
+			output: process.stdout
+		});
+		rl.question(message, (answer) => {
+			rl.close();
+			resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+		});
+	});
+}
+/**
+* Download configurations from Doppler
+* @param {{
+* verbose: boolean;
+* environments: string;
+* }} options - Options for downloading configurations
+*/
+async function downloadConfigs(options) {
+	const { environments, verbose } = options;
+	const actualEnvironments = environments ?? DEFAULT_DOPPLER_ENVIRONMENT;
+	const configs = getConfigs(actualEnvironments, verbose);
+	if (verbose) console.log(chalk.default.blue(`\n⬇️  Starting download process for ${configs.length} configuration(s)...`));
+	if (configs.length === 1 && actualEnvironments !== "all") console.log("You can use -e all to download all configurations, or -e dev,stg for specific environments.");
+	for (const config of configs) {
+		const envFile = `.env.${config}`;
+		const backupFile = `${envFile}.backup`;
+		let backupMsg = "";
+		if (verbose) console.log(chalk.default.blue(`\n📦 Processing config: ${chalk.default.cyan(config)}`));
+		try {
+			if ((0, fs.existsSync)(envFile)) {
+				if (verbose) console.log(chalk.default.gray(`   Creating backup: ${backupFile}`));
+				(0, fs.renameSync)(envFile, backupFile);
+				backupMsg = "Backed up existing file, ";
+			}
+			if (verbose) console.log(chalk.default.gray(`   Downloading secrets from Doppler...`));
+			const content = execDoppler([
+				"secrets",
+				"download",
+				"--no-file",
+				"--format",
+				"env",
+				"--config",
+				config
+			], "string", !verbose, verbose);
+			if (typeof content === "string") {
+				(0, fs.writeFileSync)(envFile, content, "utf-8");
+				if (verbose) console.log(chalk.default.gray(`   Written to: ${envFile}`));
+			} else throw new Error("Invalid content received from Doppler");
+			console.log(`Config ${chalk.default.blue(config)}: ${backupMsg}downloaded successfully to ${chalk.default.green(envFile)}`);
+			if (config === "dev" && !(0, fs.existsSync)(".env")) {
+				(0, fs.copyFileSync)(envFile, ".env");
+				console.log(`Copied ${chalk.default.green(".env.dev")} to ${chalk.default.green(".env")}`);
+			}
+			if ((0, fs.existsSync)(backupFile)) {
+				if (verbose) console.log(chalk.default.gray(`   Removing backup file`));
+				(0, fs.unlinkSync)(backupFile);
+			}
+		} catch (error) {
+			console.error(`Failed to download ${config}: ${error?.message || error}`);
+			if ((0, fs.existsSync)(backupFile)) {
+				(0, fs.renameSync)(backupFile, envFile);
+				console.log(`Restored backup for ${envFile}`);
+			}
+		}
+	}
+}
+/**
+* Upload configurations to Doppler
+* @param {{
+* environments: string;
+* verbose: boolean;
+* }} options - Options for uploading configurations
+*/
+async function uploadConfigs(options) {
+	const { environments, verbose } = options;
+	const configs = getConfigs(environments, verbose);
+	if (verbose) console.log(chalk.default.blue(`\n⬆️  Starting upload process for ${configs.length} configuration(s)...`));
+	for (const config of configs) {
+		const envFile = `.env.${config}`;
+		const backupFile = `${envFile}.doppler`;
+		const normalizedFile = `${envFile}.normalized`;
+		if (verbose) console.log(chalk.default.blue(`\n📦 Processing config: ${chalk.default.cyan(config)}`));
+		try {
+			if (!(0, fs.existsSync)(envFile)) {
+				console.log(`Config ${config}: ${chalk.default.green(envFile)} does not exist. Skipping upload.`);
+				continue;
+			}
+			if (verbose) console.log(chalk.default.gray(`   Creating backup of current Doppler config...`));
+			try {
+				const backupContent = execDoppler([
+					"secrets",
+					"download",
+					"--no-file",
+					"--format",
+					"env",
+					"--config",
+					config
+				], "string", !verbose, verbose);
+				if (typeof backupContent === "string") {
+					(0, fs.writeFileSync)(backupFile, backupContent, "utf-8");
+					if (verbose) console.log(chalk.default.gray(`   Backup created: ${backupFile}`));
+				} else throw new Error("Invalid backup content received from Doppler");
+			} catch {
+				console.log(`Config ${config}: Failed to create backup. Skipping upload.`);
+				continue;
+			}
+			if (verbose) console.log(chalk.default.gray(`   Reading local file: ${envFile}`));
+			const normalizedContent = normalizeEscapeSequences((0, fs.readFileSync)(envFile, "utf-8"));
+			(0, fs.writeFileSync)(normalizedFile, normalizedContent, "utf-8");
+			if (verbose) console.log(chalk.default.gray(`   Comparing local changes with Doppler...`));
+			const diff = createDiff((0, fs.readFileSync)(backupFile, "utf-8"), normalizedContent);
+			if (diff.length === 0) {
+				console.log(`Config ${config}: No differences found. Skipping upload.`);
+				(0, fs.unlinkSync)(backupFile);
+				(0, fs.unlinkSync)(normalizedFile);
+				continue;
+			}
+			if (verbose) console.log(chalk.default.yellow(`   Found ${diff.length} line changes`));
+			console.log("\nChanges to be uploaded:");
+			for (const line of diff) if (line.startsWith("-")) console.log(chalk.default.red(line));
+			else if (line.startsWith("+")) console.log(chalk.default.green(line));
+			if (!await promptConfirmation("\nDo you want to proceed with the upload? (y/n) ")) {
+				console.log(`Upload cancelled for ${chalk.default.green(envFile)}`);
+				(0, fs.unlinkSync)(backupFile);
+				(0, fs.unlinkSync)(normalizedFile);
+				continue;
+			}
+			if (verbose) console.log(chalk.default.gray(`   Uploading to Doppler...`));
+			try {
+				execDoppler([
+					"secrets",
+					"upload",
+					normalizedFile,
+					"--config",
+					config,
+					"--silent"
+				], "string", !verbose, verbose);
+				if (config === "dev") console.log(`Config ${chalk.default.blue(config)}: Successfully uploaded ${chalk.default.green(envFile)}`);
+				else console.log(`Config ${config}: Successfully uploaded ${chalk.default.green(envFile)}`);
+			} catch {
+				console.error(`Config ${config}: Failed to upload ${chalk.default.green(envFile)}. Restoring previous configuration.`);
+				try {
+					if (verbose) console.log(chalk.default.gray(`   Restoring previous configuration...`));
+					execDoppler([
+						"secrets",
+						"upload",
+						backupFile,
+						"--config",
+						config,
+						"--silent"
+					], "string", !verbose, verbose);
+					console.log(`Config ${config}: Successfully restored previous configuration`);
+				} catch {
+					console.error(`Config ${config}: Failed to restore previous configuration`);
+				}
+			}
+			if ((0, fs.existsSync)(backupFile)) (0, fs.unlinkSync)(backupFile);
+			if ((0, fs.existsSync)(normalizedFile)) (0, fs.unlinkSync)(normalizedFile);
+		} catch (error) {
+			console.error(`Error processing config ${config}: ${error?.message || error}`);
+			if ((0, fs.existsSync)(backupFile)) (0, fs.unlinkSync)(backupFile);
+			if ((0, fs.existsSync)(normalizedFile)) (0, fs.unlinkSync)(normalizedFile);
+		}
+	}
+}
+/**
+* Clone secrets from one Doppler project to another
+* @param {{
+* from: string;
+* to: string;
+* environments: string;
+* force: boolean;
+* verbose: boolean;
+* }} options
+*/
+async function cloneProject({ from, to, environments, force, verbose }) {
+	if (verbose) console.log(chalk.default.blue(`\n🔁 Cloning from ${chalk.default.cyan(from)} to ${chalk.default.cyan(to)}...`));
+	const configsToClone = getConfigs(environments, verbose, from);
+	if (configsToClone.length === 0) throw new Error(`No configurations found in source project "${from}"`);
+	const targetConfigsRaw = execDoppler([
+		"configs",
+		"--json",
+		"--project",
+		to
+	], "json", true, verbose);
+	const targetConfigNames = Array.isArray(targetConfigsRaw) ? targetConfigsRaw.map((c) => c.name) : [];
+	const missingInTarget = configsToClone.filter((c) => !targetConfigNames.includes(c));
+	if (missingInTarget.length > 0) throw new Error(`Configs missing in target project "${to}": ${missingInTarget.join(", ")}. Create them in Doppler first.`);
+	for (const config of configsToClone) {
+		if (verbose) console.log(chalk.default.blue(`\n📦 Processing config: ${chalk.default.cyan(config)}`));
+		const sourceSecrets = execDoppler([
+			"secrets",
+			"--json",
+			"--project",
+			from,
+			"--config",
+			config
+		], "json", true, verbose);
+		const sourceKeys = sourceSecrets ? Object.keys(sourceSecrets).filter((k) => !DOPPLER_INTERNAL_KEYS.has(k)) : [];
+		const targetSecrets = execDoppler([
+			"secrets",
+			"--json",
+			"--project",
+			to,
+			"--config",
+			config
+		], "json", true, verbose);
+		const targetKeys = targetSecrets ? Object.keys(targetSecrets) : [];
+		const conflicts = sourceKeys.filter((k) => targetKeys.includes(k));
+		if (conflicts.length > 0) {
+			if (process.env["CI"]) throw new Error(`Config "${config}" has ${conflicts.length} conflicting key(s) in target: ${conflicts.join(", ")}`);
+			if (!force) {
+				console.log(`\nConfig ${chalk.default.cyan(config)}: ${conflicts.length} key(s) already exist in ${chalk.default.cyan(to)}:`);
+				conflicts.forEach((k) => console.log(chalk.default.yellow(`  • ${k}`)));
+				if (!await promptConfirmation(`\nOverwrite these keys in "${to}/${config}"? (y/n) `)) {
+					console.log(`Skipped ${chalk.default.blue(config)}`);
+					continue;
+				}
+			}
+		}
+		const tmpFile = (0, path.join)((0, os.tmpdir)(), `doppler-clone-${config}-${Date.now()}.env`);
+		try {
+			const content = execDoppler([
+				"secrets",
+				"download",
+				"--no-file",
+				"--format",
+				"env",
+				"--project",
+				from,
+				"--config",
+				config
+			], "string", true, verbose);
+			if (typeof content !== "string" || !content) throw new Error(`No secrets returned for config "${config}"`);
+			const filtered = content.split("\n").filter((line) => {
+				const key = line.split("=")[0] ?? "";
+				return !DOPPLER_INTERNAL_KEYS.has(key);
+			}).join("\n");
+			(0, fs.writeFileSync)(tmpFile, filtered, "utf-8");
+			execDoppler([
+				"secrets",
+				"upload",
+				tmpFile,
+				"--project",
+				to,
+				"--config",
+				config,
+				"--silent"
+			], "string", true, verbose);
+			console.log(`Config ${chalk.default.blue(config)}: cloned to ${chalk.default.green(to)}`);
+		} finally {
+			if ((0, fs.existsSync)(tmpFile)) (0, fs.unlinkSync)(tmpFile);
+		}
+	}
+}
+//#endregion
+exports.checkDependencies = checkDependencies;
+exports.checkDopplerAuth = checkDopplerAuth;
+exports.cloneProject = cloneProject;
+exports.createDiff = createDiff;
+exports.downloadConfigs = downloadConfigs;
+exports.exec = require_commands_doppler_utils_exec.exec;
+exports.execDoppler = execDoppler;
+exports.execJson = require_commands_doppler_utils_exec.execJson;
+exports.execNumber = require_commands_doppler_utils_exec.execNumber;
+exports.execString = require_commands_doppler_utils_exec.execString;
+exports.getConfigs = getConfigs;
+exports.normalizeEscapeSequences = normalizeEscapeSequences;
+exports.promptConfirmation = promptConfirmation;
+exports.uploadConfigs = uploadConfigs;

package/cjs/commands/icons/handler.cjs

@@ -1,8 +1,82 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _INFOPAHNcjs = require('../../__chunks/INFOPAHN.cjs');
-require('../../__chunks/4SFWHCB3.cjs');
-require('../../__chunks/J36P6UNE.cjs');
-
-
-exports.iconsCommand = _INFOPAHNcjs.iconsCommand;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("../../__chunks/VH7oDXx4.cjs");
+const require_commands_icons_schema = require("./schema.cjs");
+const require_commands_icons_utils = require("./utils.cjs");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk, 1);
+let zod = require("zod");
+//#region src/commands/icons/handler.js
+/**
+* Main icons command handler
+* @param {unknown} options - Command options (will be validated)
+*/
+async function iconsCommand(options) {
+	try {
+		const validatedOptions = require_commands_icons_schema.iconsCommandOptionsSchema.parse(options);
+		if (validatedOptions.help) {
+			console.log(chalk.default.bold(`\nUsage: mtn icons <input> [options]`));
+			console.log(chalk.default.gray(require_commands_icons_schema.iconsCommandMetadata.description));
+			console.log(chalk.default.bold("\nOptions:"));
+			Object.entries(require_commands_icons_schema.iconsCommandOptionsSchema.shape).forEach(([key, fieldSchema]) => {
+				if (key === "input") return;
+				const description = fieldSchema.description || "No description available";
+				const optionMeta = require_commands_icons_schema.iconsCommandMetadata.options[key];
+				const defaultValue = optionMeta?.default ?? false;
+				const alias = optionMeta?.alias ? chalk.default.cyan(`, -${optionMeta.alias}`) : "";
+				console.log(chalk.default.cyan(`  --${key}`) + alias + `  ${description} (default: ${defaultValue})`);
+			});
+			console.log("");
+			return;
+		}
+		const { input, channels, iconTypes, verbose } = validatedOptions;
+		if (verbose) {
+			console.log(chalk.default.blue("\n📱 Icon Generation"));
+			console.log(chalk.default.gray(`   Input directory: ${input}`));
+			console.log(chalk.default.gray(`   Channels: ${channels.join(", ")}`));
+			console.log(chalk.default.gray(`   Icon types: ${iconTypes.join(", ")}`));
+		}
+		require_commands_icons_utils.checkDependencies(verbose);
+		require_commands_icons_utils.validateBaseIcons(input, iconTypes, verbose);
+		const result = require_commands_icons_utils.generateAllIcons({
+			baseDir: input,
+			channels,
+			iconTypes,
+			verbose
+		});
+		console.log(chalk.default.bold("\n📊 Summary:"));
+		console.log(chalk.default.green(`   ✓ Successfully generated: ${result.success.length} icon(s)`));
+		if (result.failed.length > 0) {
+			console.log(chalk.default.red(`   ✗ Failed: ${result.failed.length} icon(s)`));
+			result.failed.forEach(({ icon, error }) => {
+				console.log(chalk.default.red(`     - ${icon}: ${error}`));
+			});
+			process.exit(1);
+		}
+		console.log(chalk.default.green(`\n✅ All icons generated successfully!`));
+	} catch (error) {
+		if (error instanceof zod.ZodError) {
+			console.error(chalk.default.red(`\n❌ Invalid command options:`));
+			error.errors.forEach((err) => {
+				console.error(chalk.default.red(`   ${err.path.join(".")}: ${err.message}`));
+			});
+			process.exit(1);
+		}
+		const verbose = options?.verbose || false;
+		console.error(chalk.default.red(`\n❌ Icon generation failed:`));
+		if (error instanceof Error) {
+			console.error(chalk.default.red(`   ${error.message}`));
+			if (verbose && error.stack) {
+				console.error(chalk.default.gray("\nStack trace:"));
+				console.error(chalk.default.gray(error.stack));
+			}
+		} else console.error(chalk.default.red(`   ${String(error)}`));
+		console.error(chalk.default.yellow("\n💡 Troubleshooting tips:"));
+		console.error(chalk.default.yellow("   • Ensure ImageMagick is installed (brew install imagemagick)"));
+		console.error(chalk.default.yellow("   • Make sure icon.png and adaptive-icon.png exist in the input directory"));
+		console.error(chalk.default.yellow("   • Verify the input directory path is correct"));
+		console.error(chalk.default.yellow("   • Use --verbose for detailed error information\n"));
+		process.exit(1);
+	}
+}
+//#endregion
+exports.iconsCommand = iconsCommand;