@nanoforge-dev/cli 1.5.3-beta.8113568 → 1.5.4-beta.2af80f5

package/dist/nf.js

@@ -4,7 +4,7 @@ import "reflect-metadata";
 import { execSync, spawn } from "node:child_process";
 import fs, { existsSync } from "fs";
 import { join, posix, resolve } from "path";
-import { bgRgb, bold, green, red, yellow } from "ansis";
+import { bgRgb, bold, cyan, green, red, yellow } from "ansis";
 import { get } from "node-emoji";
 import ora from "ora";
 import { watch } from "chokidar";
@@ -232,12 +232,79 @@ const Prefixes = {
 //#region src/lib/ui/spinner.ts
 const getSpinner = (message) => ora({ text: message });
 //#endregion
+//#region src/lib/utils/errors.ts
+var CLIError = class extends Error {
+	suggestion;
+	constructor(message, suggestion) {
+		super(message);
+		this.name = this.constructor.name;
+		this.suggestion = suggestion;
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+var ConfigNotFoundError = class extends CLIError {
+	constructor(configPath) {
+		super(`Configuration file not found at path: ${configPath}.`, "Please run 'nf new' or provide a valid --config path.");
+	}
+};
+var InvalidCommandArgumentError = class extends CLIError {
+	constructor(argName, expected) {
+		super(`Invalid argument '${argName}'. Expected: ${expected}.`, "Verify the command syntax using the --help flag.");
+	}
+};
+var RegistryAuthenticationError = class extends CLIError {
+	constructor() {
+		super("You must be logged in to perform this action.", "Run 'nf login' to authenticate.");
+	}
+};
+var ManifestError = class extends CLIError {
+	constructor(detail) {
+		super(`Manifest Error: ${detail}`, "Check your nanoforge.manifest.json file for syntax or formatting errors.");
+	}
+};
+var FileSystemError = class extends CLIError {
+	constructor(action, targetPath) {
+		super(`File System Error [${action}]: ${targetPath}`, "Verify your file permissions and ensure the path exists.");
+	}
+};
+var ApiRequestError = class extends CLIError {
+	constructor(status, cause) {
+		const causeStr = cause && typeof cause === "object" ? JSON.stringify(cause, null, 2) : cause;
+		super(`API Request failed (Status ${status})${causeStr ? `\nDetails: ${causeStr}` : ""}`, "Check your network connection, API key, or the registry status.");
+	}
+};
+const getErrorString = (error) => {
+	const stack = error.stack ? error.stack : error.message;
+	const cause = error.cause && typeof error.cause === "object" ? JSON.stringify(error.cause, null, 2) : error.cause;
+	return `${stack}${cause ? `\n${cause}` : ""}`;
+};
+const getErrorMessage = (error) => {
+	if (error instanceof Error) return getErrorString(error);
+	if (typeof error === "string") return error;
+};
+const handleActionError = (context, error) => {
+	console.error();
+	console.error(red(context));
+	if (error instanceof CLIError) {
+		console.error(error.message);
+		if (error.suggestion) console.info(cyan(`\n💡 Suggestion: ${error.suggestion}`));
+		process.exit(1);
+	}
+	const msg = getErrorMessage(error);
+	if (msg) console.error(msg);
+	process.exit(1);
+};
+const promptError = (err) => {
+	if (err.name === "ExitPromptError") process.exit(1);
+	throw err;
+};
+//#endregion
 //#region src/lib/input/base-inputs.ts
 const getStringInput = (input, field) => {
 	const value = input.get(field)?.value;
 	if (value === void 0) return void 0;
 	if (typeof value === "string") return value;
-	throw new Error(`Invalid type for ${field}`);
+	throw new InvalidCommandArgumentError(field, "string");
 };
 const getStringInputWithDefault = (input, field, defaultValue) => {
 	return getStringInput(input, field) ?? defaultValue;
@@ -246,7 +313,7 @@ const getBooleanInput = (input, field) => {
 	const value = input.get(field)?.value;
 	if (value === void 0) return void 0;
 	if (typeof value === "boolean") return value;
-	throw new Error(`Invalid type for ${field}`);
+	throw new InvalidCommandArgumentError(field, "boolean");
 };
 const getBooleanInputWithDefault = (input, field, defaultValue) => {
 	return getBooleanInput(input, field) ?? defaultValue;
@@ -255,7 +322,7 @@ const getArrayInput = (input, field) => {
 	const value = input.get(field)?.value;
 	if (value === void 0) return void 0;
 	if (typeof value === "object" && Array.isArray(value)) return value;
-	throw new Error(`Invalid type for ${field}`);
+	throw new InvalidCommandArgumentError(field, "array");
 };
 //#endregion
 //#region src/lib/input/ask-inputs.ts
@@ -264,7 +331,7 @@ const getInputOrAsk = async (baseInput, askCb, defaultValue) => {
 	const res = await askCb();
 	if (res !== void 0) return res;
 	if (defaultValue !== void 0) return defaultValue;
-	throw new Error("No input provided");
+	throw new CLIError("No input provided. Please provide a valid value.");
 };
 //#endregion
 //#region src/lib/input/inputs/directory.input.ts
@@ -283,28 +350,6 @@ const getEditorInput = (inputs) => {
 	return getBooleanInputWithDefault(inputs, "editor", false);
 };
 //#endregion
-//#region src/lib/utils/errors.ts
-const getErrorMessage = (error) => {
-	if (error instanceof Error) return getErrorString(error);
-	if (typeof error === "string") return error;
-};
-const getErrorString = (error) => {
-	const stack = error.stack ? error.stack : error.message;
-	const cause = error.cause && typeof error.cause === "object" ? JSON.stringify(error.cause, null, 2) : error.cause;
-	return `${stack}${cause ? `\n${cause}` : ""}`;
-};
-const handleActionError = (context, error) => {
-	console.error();
-	console.error(red(context));
-	const msg = getErrorMessage(error);
-	if (msg) console.error(msg);
-	process.exit(1);
-};
-const promptError = (err) => {
-	if (err.name === "ExitPromptError") process.exit(1);
-	throw err;
-};
-//#endregion
 //#region src/lib/question/questions/confirm.question.ts
 const askConfirm = async (question, baseOptions) => {
 	return await confirm({
@@ -396,7 +441,7 @@ const getWatchInput = (inputs) => {
 const getCreateTypeInput = (inputs) => {
 	const res = getStringInput(inputs, "type");
 	if (res && ["component", "system"].includes(res)) return res;
-	throw new Error("Invalid type. Please enter 'component' or 'system'.");
+	throw new InvalidCommandArgumentError("type", "'component' or 'system'");
 };
 //#endregion
 //#region src/lib/input/inputs/dev/generate.input.ts
@@ -532,7 +577,7 @@ const resolveCLINodeBinaryPath = (name) => {
 			base = join(base, "..");
 		}
 	}
-	throw new Error("Could not find module path");
+	throw new FileSystemError("resolve binary", name);
 };
 //#endregion
 //#region src/lib/utils/spinner.ts
@@ -651,7 +696,7 @@ var PackageManager = class {
 		return (await withSpinner(() => this.exec(args, directory), Messages.PACKAGE_MANAGER_INSTALLATION_IN_PROGRESS, Messages.PACKAGE_MANAGER_INSTALLATION_SUCCEED(), Messages.PACKAGE_MANAGER_INSTALLATION_FAILED(this.formatFailCommand(args)))).success;
 	}
 	assertSupports(feature) {
-		if (!this.commands[feature]) throw new Error(`Package manager "${this.name}" does not support "${feature}"`);
+		if (!this.commands[feature]) throw new CLIError(`Package manager "${this.name}" does not support "${feature}"`);
 	}
 	buildRunArgs(script, params, flags, silent) {
 		const args = [...flags, this.commands.run];
@@ -662,7 +707,7 @@ var PackageManager = class {
 		return args.concat(params);
 	}
 	buildRunFileArgs(script, params, flags, silent) {
-		if (!this.commands.runFile) throw new Error("Package manager does not support runFile");
+		if (!this.commands.runFile) throw new CLIError("Package manager does not support runFile");
 		const args = [...flags, this.commands.runFile];
 		if (silent) args.push(this.commands.silentFlag);
 		args.push(script);
@@ -776,7 +821,7 @@ var RunnerFactory = class {
 		try {
 			return getModulePath("@angular-devkit/schematics-cli/bin/schematics.js");
 		} catch {
-			throw new Error("'schematics' binary path could not be found!");
+			throw new CLIError("'schematics' binary path could not be found!");
 		}
 	}
 };
@@ -868,7 +913,7 @@ const LOCK_FILE_MAP = {
 var PackageManagerFactory = class {
 	static create(name) {
 		const config = PM_CONFIGS[name];
-		if (!config) throw new Error(`Package manager ${name} is not managed.`);
+		if (!config) throw new CLIError(`Package manager '${name}' is not managed/supported.`);
 		const runner = this.createRunner(name, config.binary);
 		return new PackageManager(name, config.commands, runner);
 	}
@@ -892,7 +937,7 @@ var PackageManagerFactory = class {
 //#region src/lib/utils/files.ts
 const copyFiles = (from, to) => {
 	if (!fs.existsSync(from)) return;
-	if (!fs.existsSync(to)) throw new Error(`Directory ${to} does not exist`);
+	if (!fs.existsSync(to)) throw new FileSystemError("directory not found", to);
 	fs.readdirSync(from, { recursive: true }).forEach((file) => {
 		fs.copyFileSync(join(from, file.toString()), join(to, file.toString()));
 	});
@@ -1119,7 +1164,7 @@ const getConfigPath = (directory, name) => {
 			const path = join$1(directory, n);
 			if (existsSync$1(path)) return path;
 		}
-		throw new Error(`No config file found in directory: ${directory}`);
+		throw new ConfigNotFoundError(join$1(directory, CONFIG_FILE_NAME));
 	}
 };
 const loadConfig = async (directory, name, noThrow = false) => {
@@ -1131,10 +1176,10 @@ const loadConfig = async (directory, name, noThrow = false) => {
 	} catch {
 		rawData = noThrow ? CONFIG_DEFAULTS : null;
 	}
-	if (!rawData) throw new Error(`Not able to read config file : ${path}`);
+	if (!rawData) throw new FileSystemError("read config file", path);
 	const data = plainToInstance(Config, rawData, { excludeExtraneousValues: true });
 	const errors = await validate(data);
-	if (errors.length > 0) throw new Error(`Invalid config :\n${errors.toString().replace(/,/g, "\n")}`);
+	if (errors.length > 0) throw new CLIError(`Invalid config:\n${errors.toString().replace(/,/g, "\n")}`);
 	config = data;
 	return config;
 };
@@ -1324,7 +1369,7 @@ var NanoforgeCollection = class NanoforgeCollection extends AbstractCollection {
 	}
 	validate(name) {
 		const schematic = NanoforgeCollection.schematics.find((s) => s.name === name || s.alias === name);
-		if (schematic === void 0 || schematic === null) throw new Error(`Invalid schematic "${name}". Please, ensure that "${name}" exists in this collection.`);
+		if (schematic === void 0 || schematic === null) throw new CLIError(`Invalid schematic "${name}". Please, ensure that "${name}" exists in this collection.`);
 		return schematic.name;
 	}
 };
@@ -1334,7 +1379,7 @@ var CollectionFactory = class {
 	static create(collection, directory) {
 		const schematicRunner = RunnerFactory.createSchematic();
 		if (collection === "@nanoforge-dev/schematics") return new NanoforgeCollection(schematicRunner, directory);
-		throw new Error(`Unknown collection: ${collection}`);
+		throw new CLIError(`Unknown collection: ${collection}`);
 	}
 };
 //#endregion
@@ -1428,20 +1473,34 @@ var DevAction = class extends AbstractAction {
 	async handle(_args, options) {
 		const directory = getDirectoryInput(options);
 		const generate = getDevGenerateInput(options);
-		const tasks = this.buildTaskList(directory, generate);
+		const editor = getEditorInput(options);
+		const tasks = this.buildTaskList(directory, generate, editor);
 		await Promise.all(tasks);
 		return { keepAlive: true };
 	}
-	buildTaskList(directory, generate) {
+	buildTaskList(directory, generate, editor) {
 		const tasks = [];
-		if (generate) tasks.push(this.runSubCommand("generate", directory, { silent: true }));
-		tasks.push(this.runSubCommand("build", directory, { silent: true }));
+		const extraFlags = editor ? ["--editor"] : [];
+		if (generate) tasks.push(this.runSubCommand("generate", directory, {
+			silent: true,
+			extraFlags
+		}));
+		tasks.push(this.runSubCommand("build", directory, {
+			silent: true,
+			extraFlags
+		}));
 		tasks.push(this.runSubCommand("start", directory, { silent: false }));
 		return tasks;
 	}
 	async runSubCommand(command, directory, options) {
 		await runSafe(async () => {
-			await (await PackageManagerFactory.find(directory)).runDev(directory, "nf", {}, [command, "--watch"], options.silent);
+			const packageManager = await PackageManagerFactory.find(directory);
+			const args = [
+				command,
+				"--watch",
+				...options.extraFlags ?? []
+			];
+			await packageManager.runDev(directory, "nf", {}, args, options.silent);
 		});
 	}
 };
@@ -1669,27 +1728,24 @@ var Repository = class {
 	async runRequest(request, path, options) {
 		const res = await this._client[request](path, options);
 		const data = await res.json();
-		if (!res.ok) throw new Error(`Request failed with status code ${res.status}`, { cause: data["error"] });
+		if (!res.ok) throw new ApiRequestError(res.status, data["error"]);
 		return data;
 	}
 	async runFileRequest(request, path, options) {
 		const res = await this._client[request](path, options);
-		if (!res.ok) throw new Error(`Request failed with status code ${res.status}`, { cause: (await res.json())["error"] });
+		if (!res.ok) throw new ApiRequestError(res.status, (await res.json())["error"]);
 		return await res.blob();
 	}
 	async runRequestBody(request, path, body, options) {
 		const res = await this._client[request](path, body === void 0 ? void 0 : body instanceof FormData ? body : JSON.stringify(body), options);
 		const data = await res.json();
-		if (!res.ok) throw new Error(`Request failed with status code ${res.status}`, { cause: data["error"] });
+		if (!res.ok) throw new ApiRequestError(res.status, data["error"]);
 		return data;
 	}
 };
 new Repository(new HttpClient("https://api.nanoforge.eu"));
 const withAuth = (apiKey, force = false, headers = { "Content-Type": "application/json" }) => {
-	if (!apiKey && force) {
-		console.error("No registry key found. Please use `nf login` to login");
-		throw new Error("No apikey found. Please use `nf login` to login");
-	}
+	if (!apiKey && force) throw new RegistryAuthenticationError();
 	return new Repository(new HttpClient("https://api.nanoforge.eu", { headers: {
 		Authorization: apiKey,
 		...headers
@@ -1765,12 +1821,12 @@ var Registry = class {
 	}
 	static _getPackageFile(filename, dir) {
 		const path = join(getCwd(dir ?? "."), filename);
-		if (!fs.existsSync(path)) throw new Error("Package not found, please specify path in the nanoforge.manifest.json : `publish.paths.package`!");
+		if (!fs.existsSync(path)) throw new CLIError("Package not found, please specify path in the nanoforge.manifest.json : `publish.paths.package`!");
 		try {
 			fs.accessSync(path, fs.constants.R_OK);
 			return fs.openAsBlob(path);
 		} catch {
-			throw new Error("Cannot read package file, please verify your file permissions!");
+			throw new CLIError("Cannot read package file, please verify your file permissions!");
 		}
 	}
 };
@@ -2077,7 +2133,7 @@ const getManifestPath = (directory) => {
 		const path = join$1(directory, n);
 		if (existsSync$1(path)) return path;
 	}
-	throw new Error(`No manifest file found in directory: ${directory}`);
+	throw new ManifestError(`No manifest file found in directory: ${directory}`);
 };
 const loadManifest = async (directory) => {
 	let rawData;
@@ -2087,10 +2143,10 @@ const loadManifest = async (directory) => {
 	} catch {
 		rawData = null;
 	}
-	if (!rawData) throw new Error(`Not able to read manifest file : ${path}`);
+	if (!rawData) throw new ManifestError(`Unable to read or parse file at ${path}`);
 	const data = plainToInstance(Manifest, rawData, { excludeExtraneousValues: true });
 	const errors = await validate(data);
-	if (errors.length > 0) throw new Error(`Invalid manifest\n${errors.toString().replace(/,/g, "\n")}`);
+	if (errors.length > 0) throw new ManifestError(`Validation failed\n${errors.toString()}`);
 	return data;
 };
 //#endregion
@@ -2133,8 +2189,8 @@ var StartAction = class extends AbstractAction {
 		const cert = getStringInput(options, "cert");
 		const key = getStringInput(options, "key");
 		if (!cert && !key) return void 0;
-		if (!cert) throw new Error("No cert entered for SSL. Please enter a key with --cert.");
-		if (!key) throw new Error("No key entered for SSL. Please enter a key with --key.");
+		if (!cert) throw new CLIError("No cert entered for SSL. Please enter a cert with --cert.");
+		if (!key) throw new CLIError("No key entered for SSL. Please enter a key with --key.");
 		return {
 			cert,
 			key
@@ -2279,11 +2335,12 @@ var CreateCommand = class extends AbstractCommand {
 //#region src/command/commands/dev.command.ts
 var DevCommand = class extends AbstractCommand {
 	load(program) {
-		program.command("dev").description("run your game in dev mode").option("-d, --directory <directory>", "specify the working directory of the command").option("-c, --config <config>", "path to the config file", CONFIG_FILE_NAME).option("--generate", "generate app from config", false).action(async (rawOptions) => {
+		program.command("dev").description("run your game in dev mode").option("-d, --directory <directory>", "specify the working directory of the command").option("-c, --config <config>", "path to the config file", CONFIG_FILE_NAME).option("--generate", "generate app from config", false).option("-e, --editor", "run the editor", false).action(async (rawOptions) => {
 			const options = AbstractCommand.mapToInput({
 				directory: rawOptions.directory,
 				config: rawOptions.config,
-				generate: rawOptions.generate
+				generate: rawOptions.generate,
+				editor: rawOptions.editor
 			});
 			await this.action.run(/* @__PURE__ */ new Map(), options);
 		});
@@ -2453,7 +2510,7 @@ var CommandLoader = class {
 };
 //#endregion
 //#region package.json
-var version = "1.5.3-beta.8113568";
+var version = "1.5.4-beta.2af80f5";
 //#endregion
 //#region src/bin/nf.ts
 const bootstrap = async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@nanoforge-dev/cli",
-  "version": "1.5.3-beta.8113568",
+  "version": "1.5.4-beta.2af80f5",
   "description": "NanoForge CLI",
   "keywords": [
     "nanoforge",
@@ -56,7 +56,7 @@
     "@commitlint/cli": "^21.0.2",
     "@commitlint/config-conventional": "^21.0.2",
     "@favware/cliff-jumper": "^6.1.0",
-    "@nanoforge-dev/actions": "^2.1.1",
+    "@nanoforge-dev/actions": "^2.1.2",
     "@nanoforge-dev/utils-eslint-config": "^1.0.2",
     "@nanoforge-dev/utils-prettier-config": "^1.0.2",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",