hackmud-script-manager 0.19.1-bf4dc4a → 0.19.1-c2f3057

package/README.md

@@ -1,7 +1,7 @@
 # Hackmud Script Manager
 Command made for [hackmud-environment](https://github.com/samualtnorman/hackmud-environment), which is a scripting environment for hackmud with minification, autocompletes / intellisense, and TypeScript support.
 
-Install with `npm install hackmud-script-manager -g` to make the `hsm` command available everywhere.
+Install with `npm install -g hackmud-script-manager` to make the `hsm` command available everywhere.
 
 ## Features
 - Minification

package/bin/hsm.js

@@ -1,23 +1,18 @@
 #!/usr/bin/env node
 import { Cache } from "@samual/lib/Cache"
 import { assert } from "@samual/lib/assert"
-import { catchError } from "@samual/lib/catchError"
 import { countHackmudCharacters } from "@samual/lib/countHackmudCharacters"
-import { getDeepObjectProperty } from "@samual/lib/getDeepObjectProperty"
-import { isRecord } from "@samual/lib/isRecord"
-import { setDeepObjectProperty } from "@samual/lib/setDeepObjectProperty"
 import { writeFilePersistent } from "@samual/lib/writeFilePersistent"
-import { readFile, writeFile, mkdir, rmdir } from "fs/promises"
+import { writeFile, readFile } from "fs/promises"
 import { homedir } from "os"
-import { resolve, extname, basename, dirname, relative } from "path"
+import { extname, basename, resolve, dirname, relative } from "path"
 import { supportedExtensions } from "../constants.js"
 import { generateTypeDeclaration } from "../generateTypeDeclaration.js"
 import { pull } from "../pull.js"
 import { syncMacros } from "../syncMacros.js"
 import "@samual/lib/readDirectoryWithStats"
 import "@samual/lib/copyFilePersistent"
-const configDirectoryPath = resolve(homedir(), ".config"),
-	configFilePath = resolve(configDirectoryPath, "hsm.json"),
+const version = "0.19.1-c2f3057",
 	options = new Map(),
 	commands = [],
 	userColours = new Cache(user => {
@@ -25,118 +20,7 @@ const configDirectoryPath = resolve(homedir(), ".config"),
 		for (const char of user) hash += (hash >> 1) + hash + "xi1_8ratvsw9hlbgm02y5zpdcn7uekof463qj".indexOf(char) + 1
 		return [colourJ, colourK, colourM, colourW, colourL, colourB][hash % 6](user)
 	}),
-	logNeedHackmudPathMessage = () =>
-		console.error(
-			colourS(
-				`${colourD("You need to set hackmudPath in config before you can use this command")}\n\n${colourA("To fix this:")}\nOpen hackmud and run "${colourC("#dir")}"\nThis will open a file browser and print your hackmud user's script directory\nGo up 2 directories and then copy the path\nThen in a terminal run "${colourC("hsm")} ${colourL("config set")} ${colourV("hackmudPath")} ${colourB("<the path you copied>")}"`
-			)
-		),
-	logHelp = () => {
-		const pushCommandDescription = "Push scripts from a directory to hackmud user's scripts directories",
-			forceQuineCheatsOptionDescription = `Force quine cheats on. Use ${colourN("--force-quine-cheats")}=${colourV("false")} to force off`
-		console.log(colourN("Version") + colourS(": ") + colourV("0.19.1-bf4dc4a"))
-		switch (commands[0]) {
-			case "config":
-				switch (commands[1]) {
-					case "get":
-						console.log(
-							`\n${colourJ("Retrieve a value from the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(`${commands[0]} ${commands[1]}`)} ${colourB("<key>")}`
-						)
-						break
-					case "set":
-						console.log(
-							`\n${colourJ("Assign a value to the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(`${commands[0]} ${commands[1]}`)} ${colourB("<key> <value>")}`
-						)
-						break
-					case "delete":
-						console.log(
-							`\n${colourJ("Remove a key and value from the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(`${commands[0]} ${commands[1]}`)} ${colourB("<key>")}`
-						)
-						break
-					default:
-						console.log(
-							colourS(
-								`${colourN("Config path")}: ${colourV(configFilePath)}\n\n${colourJ("Modify the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0] + " get")} ${colourB("<key>")}\n    Retrieve a value from the config file\n${colourC("hsm")} ${colourL(commands[0] + " set")} ${colourB("<key> <value>")}\n    Assign a value to the config file\n${colourC("hsm")} ${colourL(commands[0] + " delete")} ${colourB("<key>")}\n    Remove a key and value from the config file`
-							)
-						)
-				}
-				break
-			case "dev":
-			case "watch":
-			case "push":
-				console.log(
-					colourS(
-						`\n${colourJ("push" == commands[0] ? pushCommandDescription : "Watch a directory and push a script when modified")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB('<directory> ["<script user>.<script name>"...]')}\n\n${colourA("Arguments:")}\n${colourB("<directory>")}\n    The source directory containing your scripts\n${colourB("<script user>")}\n    A user to push script(s) to. Can be set to wild card (${colourV("*")}) which will try\n    and discover users to push to\n${colourB("<script name>")}\n    Name of a script to push. Can be set to wild card (${colourV("*")}) to find all scripts\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}\n    ${forceQuineCheatsOptionDescription}\n${"push" == commands[0] ? "" : `${colourN("--type-declaration-path")}=${colourB("<path>")}\n    Path to generate a type declaration file for the scripts\n`}\n${colourA("Examples:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")}\n\tPushes all scripts found in ${colourV("src")} folder to all users\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")}\n    Pushes a script named ${colourL("bar")} found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")} ${colourC("baz")}${colourV(".")}${colourL("qux")}\n    Multiple can be specified.\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("*")}\n\tPushes all scripts found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("foo")}\n\tPushes all scripts named ${colourL("foo")} found in ${colourV("src")} folder to all user\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("*")}\n\tPushes all scripts found in ${colourV("src")} folder to all users`
-					)
-				)
-				break
-			case "pull":
-				console.log(
-					colourS(
-						`\n${colourJ("Pull a script a from a hackmud user's script directory")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<script user>")}${colourV(".")}${colourB("<script name>")}`
-					)
-				)
-				break
-			case "minify":
-			case "golf":
-				console.log(
-					colourS(
-						`\n${colourJ("Minify a script file on the spot")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<target> [output path]")}\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}\n    ${forceQuineCheatsOptionDescription}\n${colourN("--watch")}\n    Watch for changes`
-					)
-				)
-				break
-			case "generate-type-declaration":
-			case "gen-type-declaration":
-			case "gen-dts":
-			case "gen-types":
-				console.log(
-					colourS(
-						`${colourJ("Generate a type declaration file for a directory of scripts")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<directory> [output path]")}`
-					)
-				)
-				break
-			case "sync-macros":
-				console.log("\n" + colourJ("Sync macros across all hackmud users"))
-				break
-			default:
-				console.log(
-					colourS(
-						`\n${colourJ("Hackmud Script Manager")}\n\n${colourA("Commands:")}\n${colourL("push")}\n    ${pushCommandDescription}\n${colourL("dev")}\n    Watch a directory and push a script when modified\n${colourL("golf")}\n    Minify a script file on the spot\n${colourL("gen-dts")}\n    Generate a type declaration file for a directory of scripts\n${colourL("sync-macros")}\n    Sync macros across all hackmud users\n${colourL("config")}\n    Modify and view the config file\n${colourL("pull")}\n    Pull a script a from a hackmud user's script directory`
-					)
-				)
-		}
-	},
-	updateConfig = async config => {
-		const json = JSON.stringify(config, void 0, "\t")
-		configDidNotExist && log("Creating config file at " + configFilePath)
-		await writeFile(configFilePath, json).catch(async error => {
-			switch (error.code) {
-				case "EISDIR":
-					await rmdir(configFilePath)
-					break
-				case "ENOENT":
-					await mkdir(configDirectoryPath)
-					break
-				default:
-					throw error
-			}
-			await writeFile(configFilePath, json)
-		})
-	},
-	logInfo = ({ file, users, minLength, error }, hackmudPath) => {
-		error ?
-			logError(`error "${chalk.bold(error.message)}" in ${chalk.bold(file)}`)
-		:	console.log(
-				`pushed ${chalk.bold(file)} to ${users.map(user => chalk.bold(userColours.get(user))).join(", ")} | ${chalk.bold(minLength + "")} chars | ${chalk.bold(resolve(hackmudPath, users[0], "scripts", basename(file, extname(file))) + ".js")}`
-			)
-	},
-	log = message => {
-		console.log(colourS(message))
-	},
-	logError = message => {
-		console.error(colourD(message))
-		process.exitCode = 1
-	}
+	log = message => console.log(colourS(message))
 for (const argument of process.argv.slice(2))
 	if ("-" == argument[0]) {
 		const [key, valueRaw] = argument.split("=")
@@ -153,35 +37,10 @@ for (const argument of process.argv.slice(2))
 		else for (const option of key.slice(1)) options.set(option, value)
 	} else commands.push(argument)
 if ("v" == commands[0] || "version" == commands[0] || options.get("version") || options.get("v")) {
-	console.log("0.19.1-bf4dc4a")
+	console.log(version)
 	process.exit()
 }
-let configDidNotExist = !1
-const configPromise = readFile(configFilePath, { encoding: "utf-8" }).then(
-		configFile => {
-			let temporaryConfig
-			try {
-				temporaryConfig = JSON.parse(configFile)
-			} catch {
-				log("Config file was corrupted, resetting")
-				return {}
-			}
-			if (!temporaryConfig || "object" != typeof temporaryConfig) {
-				log("Config file was corrupted, resetting")
-				return {}
-			}
-			if ("hackmudPath" in temporaryConfig && "string" != typeof temporaryConfig.hackmudPath) {
-				log('Property "hackmudPath" of config file was corrupted, removing')
-				delete temporaryConfig.hackmudPath
-			}
-			return temporaryConfig
-		},
-		() => {
-			configDidNotExist = !0
-			return {}
-		}
-	),
-	pushModule = import("../push.js"),
+const pushModule = import("../push.js"),
 	processScriptModule = import("../processScript/index.js"),
 	watchModule = import("../watch.js"),
 	chokidarModule = import("chokidar"),
@@ -206,12 +65,8 @@ let autoExit = !0
 switch (commands[0]) {
 	case "push":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const sourcePath = commands[1]
+			const hackmudPath = getHackmudPath(),
+				sourcePath = commands[1]
 			if (!sourcePath) {
 				logError("Must provide the directory to push from\n")
 				logHelp()
@@ -279,12 +134,8 @@ switch (commands[0]) {
 	case "dev":
 	case "watch":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const sourcePath = commands[1]
+			const hackmudPath = getHackmudPath(),
+				sourcePath = commands[1]
 			if (!sourcePath) {
 				logError("Must provide the directory to watch\n")
 				logHelp()
@@ -357,34 +208,24 @@ switch (commands[0]) {
 		break
 	case "pull":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const script = commands[1]
+			const hackmudPath = getHackmudPath(),
+				script = commands[1]
 			if (!script) {
 				logError("Must provide the script to pull\n")
 				logHelp()
 				break
 			}
 			const sourcePath = commands[2] || "."
-			try {
-				await pull(sourcePath, hackmudPath, script)
-			} catch (error) {
+			await pull(sourcePath, hackmudPath, script).catch(error => {
 				console.error(error)
 				logError(`Something went wrong, did you forget to ${colourC("#down")} the script?`)
-			}
+			})
 		}
 		break
 	case "sync-macros":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const { macrosSynced, usersSynced } = await syncMacros(hackmudPath)
+			const hackmudPath = getHackmudPath(),
+				{ macrosSynced, usersSynced } = await syncMacros(hackmudPath)
 			log(`Synced ${macrosSynced} macros to ${usersSynced} users`)
 		}
 		break
@@ -401,79 +242,17 @@ switch (commands[0]) {
 			}
 			const sourcePath = resolve(target),
 				outputPath = commands[2] || "./player.d.ts",
-				typeDeclaration = await generateTypeDeclaration(sourcePath, (await configPromise).hackmudPath)
+				typeDeclaration = await generateTypeDeclaration(sourcePath, getHackmudPath())
 			let typeDeclarationPath = resolve(outputPath)
-			try {
-				await writeFile(typeDeclarationPath, typeDeclaration)
-			} catch (error) {
-				assert(error instanceof Error)
+			await writeFile(typeDeclarationPath, typeDeclaration).catch(error => {
+				assert(error instanceof Error, "src/bin/hsm.ts:327:35")
 				if ("EISDIR" != error.code) throw error
 				typeDeclarationPath = resolve(typeDeclarationPath, "player.d.ts")
-				await writeFile(typeDeclarationPath, typeDeclaration)
-			}
+				return writeFile(typeDeclarationPath, typeDeclaration)
+			})
 			log("Wrote type declaration to " + chalk.bold(typeDeclarationPath))
 		}
 		break
-	case "config":
-		switch (commands[1]) {
-			case "get":
-				{
-					const key = commands[2],
-						config = await configPromise
-					if (key) {
-						const [value, error] = catchError(() => getDeepObjectProperty(config, key.split(".")))
-						error ? logError("Could not get key " + colourV(key))
-						: "string" == typeof value ? log(value)
-						: console.log(value)
-					} else console.log(config)
-				}
-				break
-			case "delete":
-				{
-					const key = commands[2]
-					if (!key) {
-						logError("Must provide a key to delete\n")
-						logHelp()
-						break
-					}
-					const keys = key.split("."),
-						lastKey = keys.pop(),
-						config = await configPromise,
-						object = getDeepObjectProperty(config, keys)
-					if (isRecord(object)) {
-						delete object[lastKey]
-						await updateConfig(config)
-						log(`Removed ${colourV(key)} from config file:`)
-						console.log(config)
-					} else log("Could not delete " + colourV(key))
-				}
-				break
-			case "set":
-				{
-					const key = commands[2],
-						value = commands[3]
-					if (!key) {
-						logError("Must provide a key and value\n")
-						logHelp()
-						break
-					}
-					if (!value) {
-						logError(`Must provide a value for the key ${colourV(key)}\n`)
-						logHelp()
-						break
-					}
-					const config = await configPromise
-					setDeepObjectProperty(config, key.split("."), value)
-					log(`Set ${colourV(key)} to ${colourV(value)}:`)
-					console.log(config)
-					await updateConfig(config)
-				}
-				break
-			default:
-				commands[1] && logError(`Unknown command: ${colourL(commands[1])}\n`)
-				logHelp()
-		}
-		break
 	case "help":
 	case "h":
 		logHelp()
@@ -501,7 +280,7 @@ switch (commands[0]) {
 				scriptUser =
 					"scripts" == basename(resolve(target, "..")) && "hackmud" == basename(resolve(target, "../../..")) ?
 						basename(resolve(target, "../.."))
-					:	"UNKNOWN",
+					:	void 0,
 				optionsHasNoMinify = options.has("no-minify")
 			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
 				logError(
@@ -537,36 +316,31 @@ switch (commands[0]) {
 					: fileBaseName + ".js"
 				)
 			const golfFile = () =>
-				readFile(target, { encoding: "utf-8" }).then(
-					async source => {
-						const timeStart = performance.now(),
-							{ script, warnings } = await processScript(source, {
-								minify: !(options.get("no-minify") || options.get("skip-minify")),
-								scriptUser,
-								scriptName,
-								filePath: target,
-								mangleNames,
-								forceQuineCheats
-							}),
-							timeTook = performance.now() - timeStart
-						for (const { message, line } of warnings)
-							log(`Warning "${chalk.bold(message)}" on line ${chalk.bold(line + "")}`)
-						await writeFilePersistent(outputPath, script)
-							.catch(async error => {
-								if (!commands[2] || "EISDIR" != error.code) throw error
-								outputPath = resolve(outputPath, basename(target, fileExtension) + ".js")
-								await writeFilePersistent(outputPath, script)
-							})
-							.then(
-								() =>
-									log(
-										`Wrote ${chalk.bold(countHackmudCharacters(script))} chars to ${chalk.bold(relative(".", outputPath))} | took ${Math.round(100 * timeTook) / 100}ms`
-									),
-								error => logError(error.message)
+				readFile(target, { encoding: "utf-8" }).then(async source => {
+					const timeStart = performance.now(),
+						{ script, warnings } = await processScript(source, {
+							minify: !(options.get("no-minify") || options.get("skip-minify")),
+							scriptUser,
+							scriptName,
+							filePath: target,
+							mangleNames,
+							forceQuineCheats
+						}),
+						timeTook = performance.now() - timeStart
+					for (const { message, line } of warnings)
+						log(`Warning "${chalk.bold(message)}" on line ${chalk.bold(line + "")}`)
+					await writeFilePersistent(outputPath, script)
+						.catch(error => {
+							if (!commands[2] || "EISDIR" != error.code) throw error
+							outputPath = resolve(outputPath, basename(target, fileExtension) + ".js")
+							return writeFilePersistent(outputPath, script)
+						})
+						.then(() =>
+							log(
+								`Wrote ${chalk.bold(countHackmudCharacters(script))} chars to ${chalk.bold(relative(".", outputPath))} | took ${Math.round(100 * timeTook) / 100}ms`
 							)
-					},
-					error => logError(error.message)
-				)
+						)
+				})
 			if (options.get("watch")) {
 				const { watch: watchFile } = await chokidarModule
 				watchFile(target, { awaitWriteFinish: { stabilityThreshold: 100 } })
@@ -581,3 +355,82 @@ switch (commands[0]) {
 		logHelp()
 }
 autoExit && process.exit()
+function logHelp() {
+	const pushCommandDescription = "Push scripts from a directory to hackmud user's scripts directories",
+		forceQuineCheatsOptionDescription = `Force quine cheats on. Use ${colourN("--force-quine-cheats")}=${colourV("false")} to force off`,
+		hackmudPathOption = `${colourN("--hackmud-path")}=${colourB("<path>")}\n    Override hackmud path`
+	console.log(colourN("Version") + colourS(": ") + colourV(version))
+	switch (commands[0]) {
+		case "dev":
+		case "watch":
+		case "push":
+			console.log(
+				colourS(
+					`\n${colourJ("push" == commands[0] ? pushCommandDescription : "Watch a directory and push a script when modified")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB('<directory> ["<script user>.<script name>"...]')}\n\n${colourA("Arguments:")}\n${colourB("<directory>")}\n    The source directory containing your scripts\n${colourB("<script user>")}\n    A user to push script(s) to. Can be set to wild card (${colourV("*")}) which will try\n    and discover users to push to\n${colourB("<script name>")}\n    Name of a script to push. Can be set to wild card (${colourV("*")}) to find all scripts\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}\n    ${forceQuineCheatsOptionDescription}\n${hackmudPathOption}\n${"push" == commands[0] ? "" : `${colourN("--type-declaration-path")}=${colourB("<path>")}\n    Path to generate a type declaration file for the scripts\n`}\n${colourA("Examples:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")}\n\tPushes all scripts found in ${colourV("src")} folder to all users\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")}\n    Pushes a script named ${colourL("bar")} found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")} ${colourC("baz")}${colourV(".")}${colourL("qux")}\n    Multiple can be specified\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("*")}\n\tPushes all scripts found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("foo")}\n\tPushes all scripts named ${colourL("foo")} found in ${colourV("src")} folder to all user\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("*")}\n\tPushes all scripts found in ${colourV("src")} folder to all users`
+				)
+			)
+			break
+		case "pull":
+			console.log(
+				colourS(
+					`\n${colourJ("Pull a script a from a hackmud user's script directory")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<script user>")}${colourV(".")}${colourB("<script name>")}\n\n${colourA("Options:")}\n${hackmudPathOption}`
+				)
+			)
+			break
+		case "minify":
+		case "golf":
+			console.log(
+				colourS(
+					`\n${colourJ("Minify a script file on the spot")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<target> [output path]")}\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}\n    ${forceQuineCheatsOptionDescription}\n${colourN("--watch")}\n    Watch for changes`
+				)
+			)
+			break
+		case "generate-type-declaration":
+		case "gen-type-declaration":
+		case "gen-dts":
+		case "gen-types":
+			console.log(
+				colourS(
+					`${colourJ("Generate a type declaration file for a directory of scripts")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<directory> [output path]")}\n\n${colourA("Options:")}\n${hackmudPathOption}`
+				)
+			)
+			break
+		case "sync-macros":
+			console.log(
+				colourS(
+					`\n${colourJ("Sync macros across all hackmud users")}\n\n${colourA("Options:")}\n${hackmudPathOption}`
+				)
+			)
+			break
+		default:
+			console.log(
+				colourS(
+					`\n${colourJ("Hackmud Script Manager")}\n\n${colourA("Commands:")}\n${colourL("push")}\n    ${pushCommandDescription}\n${colourL("dev")}\n    Watch a directory and push a script when modified\n${colourL("golf")}\n    Minify a script file on the spot\n${colourL("gen-dts")}\n    Generate a type declaration file for a directory of scripts\n${colourL("sync-macros")}\n    Sync macros across all hackmud users\n${colourL("pull")}\n    Pull a script a from a hackmud user's script directory`
+				)
+			)
+	}
+}
+function logInfo({ file, users, minLength, error }, hackmudPath) {
+	error ?
+		logError(`error "${chalk.bold(error.message)}" in ${chalk.bold(file)}`)
+	:	console.log(
+			`pushed ${chalk.bold(file)} to ${users.map(user => chalk.bold(userColours.get(user))).join(", ")} | ${chalk.bold(minLength + "")} chars | ${chalk.bold(resolve(hackmudPath, users[0], "scripts", basename(file, extname(file))) + ".js")}`
+		)
+}
+function logError(message) {
+	console.error(colourD(message))
+	process.exitCode = 1
+}
+function getHackmudPath() {
+	const hackmudPathOption = options.get("hackmud-path")
+	if (null != hackmudPathOption && "string" != typeof hackmudPathOption) {
+		logError(`Option ${colourN("--hackmud-path")} must be a string, got ${colourV(hackmudPathOption)}\n`)
+		logHelp()
+		process.exit(1)
+	}
+	return (
+		hackmudPathOption ||
+		process.env.HSM_HACKMUD_PATH ||
+		("win32" == process.platform ? resolve(process.env.APPDATA, "hackmud") : resolve(homedir(), ".config/hackmud"))
+	)
+}

package/generateTypeDeclaration.d.ts

@@ -1,2 +1 @@
-export declare const generateTypeDeclaration: (sourceDirectory: string, hackmudPath?: string) => Promise<string>;
-export default generateTypeDeclaration;
+export declare function generateTypeDeclaration(sourceDirectory: string, hackmudPath?: string): Promise<string>;

package/generateTypeDeclaration.js

@@ -1,6 +1,6 @@
 import { readDirectoryWithStats } from "@samual/lib/readDirectoryWithStats"
 import { basename, resolve } from "path"
-const generateTypeDeclaration = async (sourceDirectory, hackmudPath) => {
+async function generateTypeDeclaration(sourceDirectory, hackmudPath) {
 	const users = new Set()
 	if (hackmudPath)
 		for (const { stats, name } of await readDirectoryWithStats(hackmudPath))
@@ -65,4 +65,4 @@ const generateTypeDeclaration = async (sourceDirectory, hackmudPath) => {
 	o += "}\n"
 	return o
 }
-export { generateTypeDeclaration as default, generateTypeDeclaration }
+export { generateTypeDeclaration }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hackmud-script-manager",
-  "version": "0.19.1-bf4dc4a",
+  "version": "0.19.1-c2f3057",
   "description": "Script manager for game hackmud, with minification, TypeScript support, and player script type definition generation.",
   "keywords": [
     "api",
@@ -69,17 +69,16 @@
     "rollup": "^4.14.2",
     "terser": "^5.30.3"
   },
-  "engines": {
-    "node": "^18 || >=20",
-    "pnpm": "^9.0.1"
-  },
   "type": "module",
   "exports": {
+    ".": "./index.js",
     "./*": "./*.js",
     "./*.js": "./*.js"
   },
   "bin": {
-    "hsm.d": "bin/hsm.d.ts",
     "hsm": "bin/hsm.js"
+  },
+  "engines": {
+    "node": "^18 || >=20"
   }
 }

package/processScript/index.d.ts

@@ -3,38 +3,29 @@ export { minify } from "./minify";
 export { postprocess } from "./postprocess";
 export { preprocess } from "./preprocess";
 export { transform } from "./transform";
-export type ProcessOptions = {
-    /** whether to minify the given code */
-    minify: boolean;
-    /** 11 a-z 0-9 characters */
-    uniqueID: string;
-    /** the user going to be hosting this script (or set to `true` if not yet known) */
-    scriptUser: string | true;
-    /** the name of this script (or set to `true` if not yet known) */
-    scriptName: string | true;
+export type ProcessOptions = LaxPartial<{
+    /** whether to minify the given code */ minify: boolean;
+    /** 11 a-z 0-9 characters */ uniqueID: string;
+    /** the user going to be hosting this script (or set to `true` if not yet known) */ scriptUser: string | true;
     filePath: string;
-    /** whether to mangle function and class names (defaults to `false`) */
-    mangleNames: boolean;
-    /**
-     * when set to `true` forces use of quine cheats
-     *
-     * when set to `false` forces quine cheats not to be used
-     *
-     * when left unset or set to `undefined`, automatically uses or doesn't use quine cheats based on character count
-     */
+    /** whether to mangle function and class names (defaults to `false`) */ mangleNames: boolean;
+    /** when set to `true` forces use of quine cheats
+      *
+      * when set to `false` forces quine cheats not to be used
+      *
+      * when left unset or set to `undefined`, automatically uses or doesn't use quine cheats based on character count
+      */
     forceQuineCheats: boolean;
+}> & {
+    scriptName: string | true;
 };
-/**
- * Minifies a given script
- *
- * @param code JavaScript or TypeScript code
- * @param options {@link ProcessOptions details}
- */
-export declare const processScript: (code: string, { minify: shouldMinify, uniqueID, scriptUser, scriptName, filePath, mangleNames, forceQuineCheats }?: LaxPartial<ProcessOptions>) => Promise<{
+/** Minifies a given script
+  * @param code JavaScript or TypeScript code
+  * @param options {@link ProcessOptions details} */
+export declare function processScript(code: string, { minify: shouldMinify, uniqueID, scriptUser, scriptName, filePath, mangleNames, forceQuineCheats }: ProcessOptions): Promise<{
     script: string;
     warnings: {
         message: string;
         line: number;
     }[];
 }>;
-export default processScript;