hackmud-script-manager 0.19.0 → 0.19.1-07fc9cb

package/README.md

@@ -1,6 +1,4 @@
 # Hackmud Script Manager
-![Test](https://github.com/samualtnorman/hackmud-script-manager/workflows/Test/badge.svg)
-
 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.

package/bin/hsm.js

@@ -1,2 +1,436 @@
 #!/usr/bin/env node
-import{DynamicMap as e}from"@samual/lib/DynamicMap";import{assert as t}from"@samual/lib/assert";import{countHackmudCharacters as n}from"@samual/lib/countHackmudCharacters";import{writeFilePersistent as a}from"@samual/lib/writeFilePersistent";import{readFile as s,writeFile as o,mkdir as i,rmdir as r}from"fs/promises";import{homedir as c}from"os";import{supportedExtensions as l}from"../constants.js";import{generateTypeDeclaration as f}from"../generateTypeDeclaration.js";import{pull as $}from"../pull.js";import{syncMacros as p}from"../syncMacros.js";import{resolve as m,extname as h,basename as u,dirname as g,relative as d}from"path";import"@samual/lib/copyFilePersistent";const y="0.19.0",b=m(c(),".config"),k=m(b,"hsm.json"),w=new Map,v=[],S=new e((e=>{let t=0;for(const n of e)t+=(t>>1)+t+"xi1_8ratvsw9hlbgm02y5zpdcn7uekof463qj".indexOf(n)+1;return[_,x,J,F,I,z][t%6](e)})),logNeedHackmudPathMessage=()=>console.error(D(`${W("You need to set hackmudPath in config before you can use this command")}\n\n${q("To fix this:")}\nOpen hackmud and run "${C("#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 "${C("hsm")} ${I("config set")} ${E("hackmudPath")} ${z("<the path you copied>")}"`)),logHelp=()=>{const e="Push scripts from a directory to hackmud user's scripts directories",t="Watch a directory and push a script when modified",n="Minify a script file on the spot",a="Generate a type declaration file for a directory of scripts",s="Sync macros across all hackmud users",o="Retrieve a value from the config file",i="Assign a value to the config file",r="Remove a key and value from the config file",c="Pull a script a from a hackmud user's script directory",l="Skip minification to produce a readable script",f="Reduce character count further but lose function names in error call stacks",$="Force quine cheats even if the character count is higher";switch(console.log(R("Version")+D(": ")+E(y)),v[0]){case"config":switch(v[1]){case"get":console.log(`\n${_(o)}\n\n${q("Usage:")}\n${C("hsm")} ${I(`${v[0]} ${v[1]}`)} ${z("<key>")}`);break;case"set":console.log(`\n${_(i)}\n\n${q("Usage:")}\n${C("hsm")} ${I(`${v[0]} ${v[1]}`)} ${z("<key> <value>")}`);break;case"delete":console.log(`\n${_(r)}\n\n${q("Usage:")}\n${C("hsm")} ${I(`${v[0]} ${v[1]}`)} ${z("<key>")}`);break;default:console.log(D(`${R("Config path")}: ${E(k)}\n\n${_("Modify the config file")}\n\n${q("Usage:")}\n${C("hsm")} ${I(`${v[0]} get`)} ${z("<key>")}\n    ${o}\n${C("hsm")} ${I(`${v[0]} set`)} ${z("<key> <value>")}\n    ${i}\n${C("hsm")} ${I(`${v[0]} delete`)} ${z("<key>")}\n    ${r}`))}break;case"push":console.log(D(`\n${_(e)}\n\n${q("Usage:")}\n${C("hsm")} ${I(v[0])} ${z("<directory> [<script user>.<script name>...]")}\n\n${q("Options:")}\n${R("--skip-minify")}\n    ${l}\n${R("--mangle-names")}\n    ${f}\n${R("--force-quine-cheats")}\n    ${$}`));break;case"dev":case"watch":console.log(D(`${R("Aliases")}: ${E("watch, dev")}\n\n${_(t)}\n\n${q("Usage:")}\n${C("hsm")} ${I(v[0])} ${z("<directory> [<script user>.<script name>...]")}\n\n${q("Options:")}\n${R("--skip-minify")}\n    ${l}\n${R("--mangle-names")}\n    ${f}\n${R("--type-declaration-path")}=${z("<path>")}\n    Path to generate a type declaration file for the scripts\n${R("--force-quine-cheats")}\n    ${$}`));break;case"pull":console.log(D(`\n${_(c)}\n\n${q("Usage:")}\n${C("hsm")} ${I(v[0])} ${z("<script user>")}${E(".")}${z("<script name>")}`));break;case"minify":case"golf":console.log(D(`${R("Aliases")}: ${E("minify, golf")}\n\n${_(n)}\n\n${q("Usage:")}\n${C("hsm")} ${I(v[0])} ${z("<target> [output path]")}\n\n${q("Options:")}\n${R("--skip-minify")}\n    ${l}\n${R("--mangle-names")}\n    ${f}\n${R("--force-quine-cheats")}\n    ${$}\n${R("--watch")}\n    Watch for changes`));break;case"generate-type-declaration":case"gen-type-declaration":case"gen-dts":case"gen-types":console.log(D(`${R("Aliases")}: ${E("generate-type-declaration, gen-type-declaration, gen-types, gen-dts")}\n\n${_(a)}\n\n${q("Usage:")}\n${C("hsm")} ${I(v[0])} ${z("<directory> [output path]")}`));break;case"sync-macros":console.log(`\n${_(s)}`);break;default:console.log(D(`\n${_("Hackmud Script Manager")}\n\n${q("Commands:")}\n${I("push")}\n    ${e}\n${I("watch")}, ${I("dev")}\n    ${t}\n${I("minify")}, ${I("golf")}\n    ${n}\n${I("generate-type-declaration")}, ${I("gen-type-declaration")}, ${I("gen-types")}, ${I("gen-dts")}\n    ${a}\n${I("sync-macros")}\n    ${s}\n${I("config")}\n    Modify and view the config file\n${I("pull")}\n    ${c}`))}},exploreObject=(e,t,n=!1)=>{for(const a of t)e=n?"object"==typeof e[a]?e[a]:e[a]={}:e?.[a];return e},logInfo=({file:e,users:t,minLength:n,error:a},s)=>{a?logError(`error "${T.bold(a.message)}" in ${T.bold(e)}`):console.log(`pushed ${T.bold(e)} to ${t.map((e=>T.bold(S.get(e)))).join(", ")} | ${T.bold(String(n))} chars | ${T.bold(`${m(s,t[0],"scripts",u(e,h(e)))}.js`)}`)},log=e=>{console.log(D(e))},logError=e=>{console.error(W(e)),process.exitCode=1};for(const e of process.argv.slice(2))if("-"==e[0]){const[t,n]=e.split("=");let a=n;if(a)if("true"==a)a=!0;else if("false"==a)a=!1;else{const e=Number(a);isFinite(e)&&(a=e)}else a=!0;if("-"==e[1])w.set(t.slice(2),a);else for(const e of t.slice(1))w.set(e,a)}else v.push(e);("v"==v[0]||"version"==v[0]||w.get("version")||w.get("v"))&&(console.log(y),process.exit());let P=!1;const j=s(k,{encoding:"utf-8"}).then((e=>{let t;try{t=JSON.parse(e)}catch{return log("Config file was corrupted, resetting"),{}}return t&&"object"==typeof t?("hackmudPath"in t&&"string"!=typeof t.hackmudPath&&(log('Property "hackmudPath" of config file was corrupted, removing'),delete t.hackmudPath),t):(log("Config file was corrupted, resetting"),{})}),(()=>(P=!0,{}))),N=import("../push.js"),O=import("../processScript/index.js"),M=import("../watch.js"),U=import("chokidar"),{default:T}=await import("chalk"),q=T.rgb(255,255,255),z=T.rgb(202,202,202),C=T.rgb(155,155,155),W=T.rgb(255,0,0),_=T.rgb(255,244,4),x=T.rgb(243,249,152),I=T.rgb(30,255,0),J=T.rgb(179,255,155),R=T.rgb(0,255,255),D=T.rgb(122,178,244),E=T.rgb(255,0,236),F=T.rgb(255,150,224);(w.get("help")||w.get("h"))&&(logHelp(),process.exit());let A=!0;switch(v[0]){case"push":{const{hackmudPath:e}=await j;if(!e){logNeedHackmudPathMessage();break}const t=v[1];if(!t){logError("Must provide the directory to push from\n"),logHelp();break}const n=v.slice(2);if(n.length){const e=n.find((e=>!/^(?:[a-z_][a-z\d_]{0,24}|\*)\.(?:[a-z_][a-z\d_]{0,24}|\*)$/.test(e)));if(e){logError(`Invalid script name: ${JSON.stringify(e)}\n`),logHelp();break}}else n.push("*.*");if(w.has("skip-minify")&&w.has("mangle-names")){logError(`Option ${R("--mangle-names")} is not compatible with ${R("--skip-minify")}\n`),logHelp();break}const a=w.get("skip-minify");let s;if(null!=a){if("boolean"!=typeof a){logError(`The value for ${R("--skip-minify")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}s=!a}const o=w.get("mangle-names");if(null!=o&&"boolean"!=typeof o){logError(`The value for ${R("--mangle-names")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}const i=w.get("force-quine-cheats");if(null!=i&&"boolean"!=typeof i){logError(`The value for ${R("--force-quine-cheats")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}const{push:r}=await N;(await r(t,e,{scripts:n,onPush:t=>logInfo(t,e),minify:s,mangleNames:o,forceQuineCheats:i})).length||logError("Could not find any scripts to push")}break;case"dev":case"watch":{const{hackmudPath:e}=await j;if(!e){logNeedHackmudPathMessage();break}const t=v[1];if(!t){logError("Must provide the directory to watch\n"),logHelp();break}const n=v.slice(2);if(n.length){const e=n.find((e=>!/^(?:[a-z_][a-z\d_]{0,24}|\*)\.(?:[a-z_][a-z\d_]{0,24}|\*)$/.test(e)));if(e){logError(`Invalid script name: ${JSON.stringify(e)}\n`),logHelp();break}}else n.push("*.*");if(w.has("skip-minify")&&w.has("mangle-names")){logError(`Option ${R("--mangle-names")} is not compatible with ${R("--skip-minify")}\n`),logHelp();break}const a=w.get("skip-minify");let s;if(null!=a){if("boolean"!=typeof a){logError(`The value for ${R("--skip-minify")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}s=!a}const o=w.get("mangle-names");if(null!=o&&"boolean"!=typeof o){logError(`The value for ${R("--mangle-names")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}const i=w.get("force-quine-cheats");if(null!=i&&"boolean"!=typeof i){logError(`The value for ${R("--force-quine-cheats")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}const{watch:r}=await M;r(t,e,{scripts:n,onPush:t=>logInfo(t,e),typeDeclarationPath:(w.get("type-declaration-path")||w.get("type-declaration")||w.get("dts")||w.get("gen-types"))?.toString(),minify:s,mangleNames:o,onReady:()=>log("Watching"),forceQuineCheats:i}),A=!1}break;case"pull":{const{hackmudPath:e}=await j;if(!e){logNeedHackmudPathMessage();break}const t=v[1];if(!t){logError("Must provide the script to pull\n"),logHelp();break}const n=v[2]||".";try{await $(n,e,t)}catch(e){console.error(e),logError(`Something went wrong, did you forget to ${C("#down")} the script?`)}}break;case"sync-macros":{const{hackmudPath:e}=await j;if(!e){logNeedHackmudPathMessage();break}const{macrosSynced:t,usersSynced:n}=await p(e);log(`Synced ${t} macros to ${n} users`)}break;case"generate-type-declaration":case"gen-type-declaration":case"gen-dts":case"gen-types":{const e=v[1];if(!e){logError("Must provide target directory\n"),logHelp();break}const n=m(e),a=v[2]||"./player.d.ts",s=await f(n,(await j).hackmudPath);let i=m(a);try{await o(i,s)}catch(e){if(t(e instanceof Error),"EISDIR"!=e.code)throw e;i=m(i,"player.d.ts"),await o(i,s)}log(`Wrote type declaration to ${T.bold(i)}`)}break;case"config":switch(v[1]){case"get":{const e=v[2];e?log(exploreObject(await j,e.split("."))):console.log(await j)}break;case"delete":{const e=v[2];if(!e){logError("Must provide a key to delete\n"),logHelp();break}const t=e.split("."),n=t.map((e=>/^[a-z_$][\w$]*$/i.test(e)?e:JSON.stringify(e))).join("."),a=t.pop(),s=await j;delete exploreObject(s,t)?.[a],log(`Removed ${E(n)} from config file`)}break;case"set":{const e=v[2],t=v[3];if(!e){logError("Must provide a key and value\n"),logHelp();break}const n=e.split("."),a=n.map((e=>/^[a-z_$][\w$]*$/i.test(e)?e:JSON.stringify(e))).join(".");if(!t){logError(`Must provide a value for the key ${a}\n`),logHelp();break}const s=n.pop(),l=await j;if(n.length||"hackmudPath"!=s){let e=l;for(const t of n)"object"==typeof e[t]||(e[t]={}),e=e[t];e[s]=t}else l.hackmudPath=m(t.startsWith("~/")?c()+t.slice(1):t);console.log(l),await(async e=>{const t=JSON.stringify(e,void 0,"\t");P&&log(`Creating config file at ${k}`),await o(k,t).catch((async e=>{switch(e.code){case"EISDIR":await r(k);break;case"ENOENT":await i(b);break;default:throw e}await o(k,t)}))})(l)}break;default:v[1]&&logError(`Unknown command: ${JSON.stringify(v[1])}\n`),logHelp()}break;case"help":case"h":logHelp();break;case"golf":case"minify":{const e=v[1];if(!e){logError("Must provide target\n"),logHelp();break}const t=h(e);if(!l.includes(t)){logError(`Unsupported file extension "${T.bold(t)}"\nSupported extensions are "${l.map((e=>T.bold(e))).join('", "')}"`);break}const{processScript:o}=await O,i=u(e,t),r=i.endsWith(".src"),c=r?i.slice(0,-4):i,f="scripts"==u(m(e,".."))&&"hackmud"==u(m(e,"../../.."))?u(m(e,"../..")):"UNKNOWN",$=!w.get("skip-minify");if(w.has("skip-minify")&&w.has("mangle-names")){logError(`Option ${R("--mangle-names")} would have no effect if minification is skipped\n`),logHelp();break}const p=w.get("mangle-names");if(null!=p&&"boolean"!=typeof p){logError(`The value for ${R("--mangle-names")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}const y=p,b=w.get("force-quine-cheats");if(null!=b&&"boolean"!=typeof b){logError(`the value for ${R("--force-quine-cheats")} must be ${E("true")} or ${E("false")}\n`),logHelp();break}const k=b;let S=v[2]||m(g(e),r?`${c}.js`:".js"==t?`${i}.min.js`:`${i}.js`);const golfFile=()=>s(e,{encoding:"utf-8"}).then((async s=>{const i=performance.now(),{script:r,warnings:l}=await o(s,{minify:$,scriptUser:f,scriptName:c,filePath:e,mangleNames:y,forceQuineCheats:k}),p=performance.now()-i;for(const{message:e,line:t}of l)log(`Warning "${T.bold(e)}" on line ${T.bold(String(t))}`);await a(S,r).catch((async n=>{if(!v[2]||"EISDIR"!=n.code)throw n;S=m(S,`${u(e,t)}.js`),await a(S,r)})).then((()=>log(`Wrote ${T.bold(n(r))} chars to ${T.bold(d(".",S))} | took ${Math.round(100*p)/100}ms`)),(e=>logError(e.message)))}),(e=>logError(e.message)));if(w.get("watch")){const{watch:t}=await U;t(e,{awaitWriteFinish:{stabilityThreshold:100}}).on("ready",(()=>log(`Watching ${e}`))).on("change",golfFile),A=!1}else await golfFile()}break;default:v[0]&&logError(`Unknown command: ${JSON.stringify(v[0])}\n`),logHelp()}A&&process.exit();
+import { Cache } from "@samual/lib/Cache"
+import { assert } from "@samual/lib/assert"
+import { countHackmudCharacters } from "@samual/lib/countHackmudCharacters"
+import { writeFilePersistent } from "@samual/lib/writeFilePersistent"
+import { writeFile, readFile } from "fs/promises"
+import { homedir } from "os"
+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 version = "0.19.1-07fc9cb",
+	options = new Map(),
+	commands = [],
+	userColours = new Cache(user => {
+		let hash = 0
+		for (const char of user) hash += (hash >> 1) + hash + "xi1_8ratvsw9hlbgm02y5zpdcn7uekof463qj".indexOf(char) + 1
+		return [colourJ, colourK, colourM, colourW, colourL, colourB][hash % 6](user)
+	}),
+	log = message => console.log(colourS(message))
+for (const argument of process.argv.slice(2))
+	if ("-" == argument[0]) {
+		const [key, valueRaw] = argument.split("=")
+		let value = valueRaw
+		if (value)
+			if ("true" == value) value = !0
+			else if ("false" == value) value = !1
+			else {
+				const number = Number(value)
+				isFinite(number) && (value = number)
+			}
+		else value = !0
+		if ("-" == argument[1]) options.set(key.slice(2), value)
+		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(version)
+	process.exit()
+}
+const pushModule = import("../push.js"),
+	processScriptModule = import("../processScript/index.js"),
+	watchModule = import("../watch.js"),
+	chokidarModule = import("chokidar"),
+	{ default: chalk } = await import("chalk"),
+	colourA = chalk.rgb(255, 255, 255),
+	colourB = chalk.rgb(202, 202, 202),
+	colourC = chalk.rgb(155, 155, 155),
+	colourD = chalk.rgb(255, 0, 0),
+	colourJ = chalk.rgb(255, 244, 4),
+	colourK = chalk.rgb(243, 249, 152),
+	colourL = chalk.rgb(30, 255, 0),
+	colourM = chalk.rgb(179, 255, 155),
+	colourN = chalk.rgb(0, 255, 255),
+	colourS = chalk.rgb(122, 178, 244),
+	colourV = chalk.rgb(255, 0, 236),
+	colourW = chalk.rgb(255, 150, 224)
+if (options.get("help") || options.get("h")) {
+	logHelp()
+	process.exit()
+}
+let autoExit = !0
+switch (commands[0]) {
+	case "push":
+		{
+			const hackmudPath = getHackmudPath(),
+				sourcePath = commands[1]
+			if (!sourcePath) {
+				logError("Must provide the directory to push from\n")
+				logHelp()
+				break
+			}
+			const scripts = commands.slice(2)
+			if (scripts.length) {
+				const invalidScript = scripts.find(
+					script => !/^(?:[a-z_][a-z\d_]{0,24}|\*)\.(?:[a-z_][a-z\d_]{0,24}|\*)$/.test(script)
+				)
+				if (invalidScript) {
+					logError(`Invalid script name: ${JSON.stringify(invalidScript)}\n`)
+					logHelp()
+					break
+				}
+			} else scripts.push("*.*")
+			const optionsHasNoMinify = options.has("no-minify")
+			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
+				logError(
+					`Options ${colourN("--mangle-names")} and ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} are incompatible\n`
+				)
+				logHelp()
+				break
+			}
+			const shouldSkipMinify = options.get("no-minify") || options.get("skip-minify")
+			let shouldMinify
+			if (null != shouldSkipMinify) {
+				if ("boolean" != typeof shouldSkipMinify) {
+					logError(
+						`The value for ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} must be ${colourV("true")} or ${colourV("false")}\n`
+					)
+					logHelp()
+					break
+				}
+				shouldMinify = !shouldSkipMinify
+			}
+			const shouldMangleNames = options.get("mangle-names")
+			if (null != shouldMangleNames && "boolean" != typeof shouldMangleNames) {
+				logError(
+					`The value for ${colourN("--mangle-names")} must be ${colourV("true")} or ${colourV("false")}\n`
+				)
+				logHelp()
+				break
+			}
+			const shouldforceQuineCheats = options.get("force-quine-cheats")
+			if (null != shouldforceQuineCheats && "boolean" != typeof shouldforceQuineCheats) {
+				logError(
+					`The value for ${colourN("--force-quine-cheats")} must be ${colourV("true")} or ${colourV("false")}\n`
+				)
+				logHelp()
+				break
+			}
+			const { push } = await pushModule
+			;(
+				await push(sourcePath, hackmudPath, {
+					scripts,
+					onPush: info => logInfo(info, hackmudPath),
+					minify: shouldMinify,
+					mangleNames: shouldMangleNames,
+					forceQuineCheats: shouldforceQuineCheats
+				})
+			).length || logError("Could not find any scripts to push")
+		}
+		break
+	case "dev":
+	case "watch":
+		{
+			const hackmudPath = getHackmudPath(),
+				sourcePath = commands[1]
+			if (!sourcePath) {
+				logError("Must provide the directory to watch\n")
+				logHelp()
+				break
+			}
+			const scripts = commands.slice(2)
+			if (scripts.length) {
+				const invalidScript = scripts.find(
+					script => !/^(?:[a-z_][a-z\d_]{0,24}|\*)\.(?:[a-z_][a-z\d_]{0,24}|\*)$/.test(script)
+				)
+				if (invalidScript) {
+					logError(`Invalid script name: ${JSON.stringify(invalidScript)}\n`)
+					logHelp()
+					break
+				}
+			} else scripts.push("*.*")
+			const optionsHasNoMinify = options.has("no-minify")
+			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
+				logError(
+					`Options ${colourN("--mangle-names")} and ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} are incompatible\n`
+				)
+				logHelp()
+				break
+			}
+			const shouldSkipMinify = options.get("no-minify") || options.get("skip-minify")
+			let shouldMinify
+			if (null != shouldSkipMinify) {
+				if ("boolean" != typeof shouldSkipMinify) {
+					logError(
+						`The value for ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} must be ${colourV("true")} or ${colourV("false")}\n`
+					)
+					logHelp()
+					break
+				}
+				shouldMinify = !shouldSkipMinify
+			}
+			const shouldMangleNames = options.get("mangle-names")
+			if (null != shouldMangleNames && "boolean" != typeof shouldMangleNames) {
+				logError(
+					`The value for ${colourN("--mangle-names")} must be ${colourV("true")} or ${colourV("false")}\n`
+				)
+				logHelp()
+				break
+			}
+			const shouldforceQuineCheats = options.get("force-quine-cheats")
+			if (null != shouldforceQuineCheats && "boolean" != typeof shouldforceQuineCheats) {
+				logError(
+					`The value for ${colourN("--force-quine-cheats")} must be ${colourV("true")} or ${colourV("false")}\n`
+				)
+				logHelp()
+				break
+			}
+			const { watch } = await watchModule
+			watch(sourcePath, hackmudPath, {
+				scripts,
+				onPush: info => logInfo(info, hackmudPath),
+				typeDeclarationPath: (
+					options.get("type-declaration-path") ||
+					options.get("type-declaration") ||
+					options.get("dts") ||
+					options.get("gen-types")
+				)?.toString(),
+				minify: shouldMinify,
+				mangleNames: shouldMangleNames,
+				onReady: () => log("Watching"),
+				forceQuineCheats: shouldforceQuineCheats
+			})
+			autoExit = !1
+		}
+		break
+	case "pull":
+		{
+			const hackmudPath = getHackmudPath(),
+				script = commands[1]
+			if (!script) {
+				logError("Must provide the script to pull\n")
+				logHelp()
+				break
+			}
+			const sourcePath = commands[2] || "."
+			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 = getHackmudPath(),
+				{ macrosSynced, usersSynced } = await syncMacros(hackmudPath)
+			log(`Synced ${macrosSynced} macros to ${usersSynced} users`)
+		}
+		break
+	case "generate-type-declaration":
+	case "gen-type-declaration":
+	case "gen-dts":
+	case "gen-types":
+		{
+			const target = commands[1]
+			if (!target) {
+				logError("Must provide target directory\n")
+				logHelp()
+				break
+			}
+			const sourcePath = resolve(target),
+				outputPath = commands[2] || "./player.d.ts",
+				typeDeclaration = await generateTypeDeclaration(sourcePath, getHackmudPath())
+			let typeDeclarationPath = resolve(outputPath)
+			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")
+				return writeFile(typeDeclarationPath, typeDeclaration)
+			})
+			log("Wrote type declaration to " + chalk.bold(typeDeclarationPath))
+		}
+		break
+	case "help":
+	case "h":
+		logHelp()
+		break
+	case "golf":
+	case "minify":
+		{
+			const target = commands[1]
+			if (!target) {
+				logError("Must provide target\n")
+				logHelp()
+				break
+			}
+			const fileExtension = extname(target)
+			if (!supportedExtensions.includes(fileExtension)) {
+				logError(
+					`Unsupported file extension "${chalk.bold(fileExtension)}"\nSupported extensions are "${supportedExtensions.map(extension => chalk.bold(extension)).join('", "')}"`
+				)
+				break
+			}
+			const { processScript } = await processScriptModule,
+				fileBaseName = basename(target, fileExtension),
+				fileBaseNameEndsWithDotSrc = fileBaseName.endsWith(".src"),
+				scriptName = fileBaseNameEndsWithDotSrc ? fileBaseName.slice(0, -4) : fileBaseName,
+				scriptUser =
+					"scripts" == basename(resolve(target, "..")) && "hackmud" == basename(resolve(target, "../../..")) ?
+						basename(resolve(target, "../.."))
+					:	"UNKNOWN",
+				optionsHasNoMinify = options.has("no-minify")
+			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
+				logError(
+					`Options ${colourN("--mangle-names")} and ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} are incompatible\n`
+				)
+				logHelp()
+				break
+			}
+			const mangleNames_ = options.get("mangle-names")
+			if (null != mangleNames_ && "boolean" != typeof mangleNames_) {
+				logError(
+					`The value for ${colourN("--mangle-names")} must be ${colourV("true")} or ${colourV("false")}\n`
+				)
+				logHelp()
+				break
+			}
+			const mangleNames = mangleNames_,
+				forceQuineCheats_ = options.get("force-quine-cheats")
+			if (null != forceQuineCheats_ && "boolean" != typeof forceQuineCheats_) {
+				logError(
+					`the value for ${colourN("--force-quine-cheats")} must be ${colourV("true")} or ${colourV("false")}\n`
+				)
+				logHelp()
+				break
+			}
+			const forceQuineCheats = forceQuineCheats_
+			let outputPath =
+				commands[2] ||
+				resolve(
+					dirname(target),
+					fileBaseNameEndsWithDotSrc ? scriptName + ".js"
+					: ".js" == fileExtension ? fileBaseName + ".min.js"
+					: 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(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`
+							)
+						)
+				})
+			if (options.get("watch")) {
+				const { watch: watchFile } = await chokidarModule
+				watchFile(target, { awaitWriteFinish: { stabilityThreshold: 100 } })
+					.on("ready", () => log("Watching " + target))
+					.on("change", golfFile)
+				autoExit = !1
+			} else await golfFile()
+		}
+		break
+	default:
+		commands[0] && logError(`Unknown command: ${colourL(commands[0])}\n`)
+		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/constants.js

@@ -1 +1,3 @@
-const s=[".js",".ts"],t=["i","r","f","u","u1","us","ObjectId"];export{s as supportedExtensions,t as validDBMethods};
+const supportedExtensions = [".js", ".ts"],
+	validDBMethods = ["i", "r", "f", "u", "u1", "us", "ObjectId"]
+export { supportedExtensions, validDBMethods }

package/generateTypeDeclaration.js

@@ -1 +1,68 @@
-import{readdir as e}from"fs/promises";import{basename as t,resolve as n}from"path";const generateTypeDeclaration=async(s,i)=>{const a=new Set;if(i)for(const n of await e(i,{withFileTypes:!0}))n.isFile()&&n.name.endsWith(".key")&&a.add(t(n.name,".key"));const r=[],o=[],f={},l={};await Promise.all((await e(s,{withFileTypes:!0})).map((async i=>{if(i.isFile())i.name.endsWith(".ts")?i.name.endsWith(".d.ts")||r.push(t(i.name,".ts")):i.name.endsWith(".js")&&o.push(t(i.name,".js"));else if(i.isDirectory()){const r=[],o=[];f[i.name]=r,l[i.name]=o,a.add(i.name);for(const a of await e(n(s,i.name),{withFileTypes:!0}))a.isFile()&&(a.name.endsWith(".ts")?i.name.endsWith(".d.ts")||r.push(t(a.name,".ts")):a.name.endsWith(".js")&&o.push(t(a.name,".js")))}}))),s=n(s);let c="";for(const e of r)c+=`type $${e}$ = typeof import("${s}/${e}").default\n`;c+="\n";for(const e in f){const t=f[e];for(const n of t)c+=`type $${e}$${n}$ = typeof import("${s}/${e}/${n}").default\n`}c+="\ntype ArrayRemoveFirst<A> = A extends [ infer FirstItem, ...infer Rest ] ? Rest : never\n\ntype Subscript<T extends (...args: any) => any> =\n\t(...args: ArrayRemoveFirst<Parameters<T>>) => ReturnType<T> | ScriptFailure\n\ntype WildFullsec = Record<string, () => ScriptFailure> & {\n";for(const e of r)c+=`\t${e}: Subscript<$${e}$>\n`;for(const e of o)c+=`\t${e}: (...args: any) => any\n`;c+="}\n\ninterface PlayerFullsec {";let m=!0;for(const e of a){const t=f[e],n=l[e];if(t&&t.length||n&&n.length){if(m=!0,c+=`\n\t${e}: WildFullsec & {\n`,t)for(const n of t)c+=`\t\t${n}: Subscript<$${e}$${n}$>\n`;if(n)for(const e of n)c+=`\t\t${e}: (...args: any) => any\n`;c+="\t}"}else m&&(c+="\n",m=!1),c+=`\t${e}: WildFullsec`;c+="\n"}return c+="}\n",c};export{generateTypeDeclaration as default,generateTypeDeclaration};
+import { readDirectoryWithStats } from "@samual/lib/readDirectoryWithStats"
+import { basename, resolve } from "path"
+async function generateTypeDeclaration(sourceDirectory, hackmudPath) {
+	const users = new Set()
+	if (hackmudPath)
+		for (const { stats, name } of await readDirectoryWithStats(hackmudPath))
+			stats.isFile() && name.endsWith(".key") && users.add(basename(name, ".key"))
+	const wildScripts = [],
+		wildAnyScripts = [],
+		allScripts = {},
+		allAnyScripts = {}
+	await Promise.all(
+		(await readDirectoryWithStats(sourceDirectory)).map(async ({ stats, name }) => {
+			if (stats.isFile())
+				name.endsWith(".ts") ?
+					name.endsWith(".d.ts") || wildScripts.push(basename(name, ".ts"))
+				:	name.endsWith(".js") && wildAnyScripts.push(basename(name, ".js"))
+			else if (stats.isDirectory()) {
+				const scripts = [],
+					anyScripts = []
+				allScripts[name] = scripts
+				allAnyScripts[name] = anyScripts
+				users.add(name)
+				for (const child of await readDirectoryWithStats(resolve(sourceDirectory, name)))
+					child.stats.isFile() &&
+						(child.name.endsWith(".ts") ?
+							name.endsWith(".d.ts") || scripts.push(basename(child.name, ".ts"))
+						:	child.name.endsWith(".js") && anyScripts.push(basename(child.name, ".js")))
+			}
+		})
+	)
+	sourceDirectory = resolve(sourceDirectory)
+	let o = ""
+	for (const script of wildScripts) o += `type $${script}$ = typeof import("${sourceDirectory}/${script}").default\n`
+	o += "\n"
+	for (const user in allScripts) {
+		const scripts = allScripts[user]
+		for (const script of scripts)
+			o += `type $${user}$${script}$ = typeof import("${sourceDirectory}/${user}/${script}").default\n`
+	}
+	o +=
+		"\ntype ArrayRemoveFirst<A> = A extends [ infer FirstItem, ...infer Rest ] ? Rest : never\n\ntype Subscript<T extends (...args: any) => any> =\n\t(...args: ArrayRemoveFirst<Parameters<T>>) => ReturnType<T> | ScriptFailure\n\ntype WildFullsec = Record<string, () => ScriptFailure> & {\n"
+	for (const script of wildScripts) o += `\t${script}: Subscript<$${script}$>\n`
+	for (const script of wildAnyScripts) o += `\t${script}: (...args: any) => any\n`
+	o += "}\n\ninterface PlayerFullsec {"
+	let lastWasMultiLine = !0
+	for (const user of users) {
+		const scripts = allScripts[user],
+			anyScripts = allAnyScripts[user]
+		if ((scripts && scripts.length) || (anyScripts && anyScripts.length)) {
+			lastWasMultiLine = !0
+			o += `\n\t${user}: WildFullsec & {\n`
+			if (scripts) for (const script of scripts) o += `\t\t${script}: Subscript<$${user}$${script}$>\n`
+			if (anyScripts) for (const script of anyScripts) o += `\t\t${script}: (...args: any) => any\n`
+			o += "\t}"
+		} else {
+			if (lastWasMultiLine) {
+				o += "\n"
+				lastWasMultiLine = !1
+			}
+			o += `\t${user}: WildFullsec`
+		}
+		o += "\n"
+	}
+	o += "}\n"
+	return o
+}
+export { generateTypeDeclaration as default, generateTypeDeclaration }

package/index.js

@@ -1 +1,51 @@
-export{supportedExtensions}from"./constants.js";export{generateTypeDeclaration}from"./generateTypeDeclaration.js";export{processScript}from"./processScript/index.js";export{pull}from"./pull.js";export{push}from"./push.js";export{syncMacros}from"./syncMacros.js";export{watch}from"./watch.js";import"fs/promises";import"path";import"@babel/generator";import"@babel/parser";import"@babel/plugin-proposal-decorators";import"@babel/plugin-proposal-destructuring-private";import"@babel/plugin-proposal-explicit-resource-management";import"@babel/plugin-transform-class-properties";import"@babel/plugin-transform-class-static-block";import"@babel/plugin-transform-exponentiation-operator";import"@babel/plugin-transform-json-strings";import"@babel/plugin-transform-logical-assignment-operators";import"@babel/plugin-transform-nullish-coalescing-operator";import"@babel/plugin-transform-numeric-separator";import"@babel/plugin-transform-object-rest-spread";import"@babel/plugin-transform-optional-catch-binding";import"@babel/plugin-transform-optional-chaining";import"@babel/plugin-transform-private-property-in-object";import"@babel/plugin-transform-unicode-sets-regex";import"@babel/traverse";import"@babel/types";import"@rollup/plugin-babel";import"@rollup/plugin-commonjs";import"@rollup/plugin-json";import"@rollup/plugin-node-resolve";import"@samual/lib/assert";import"prettier";import"rollup";import"./processScript/minify.js";import"@samual/lib/countHackmudCharacters";import"@samual/lib/spliceString";import"acorn";import"terser";import"./processScript/shared.js";import"./processScript/postprocess.js";import"./processScript/preprocess.js";import"import-meta-resolve";import"./processScript/transform.js";import"@samual/lib/clearObject";import"@samual/lib/copyFilePersistent";import"@samual/lib/DynamicMap";import"@samual/lib/writeFilePersistent";import"chokidar";
+export { supportedExtensions } from "./constants.js"
+export { generateTypeDeclaration } from "./generateTypeDeclaration.js"
+export { processScript } from "./processScript/index.js"
+export { pull } from "./pull.js"
+export { push } from "./push.js"
+export { syncMacros } from "./syncMacros.js"
+export { watch } from "./watch.js"
+import "@samual/lib/readDirectoryWithStats"
+import "path"
+import "@babel/generator"
+import "@babel/parser"
+import "@babel/plugin-proposal-decorators"
+import "@babel/plugin-proposal-destructuring-private"
+import "@babel/plugin-proposal-explicit-resource-management"
+import "@babel/plugin-transform-class-properties"
+import "@babel/plugin-transform-class-static-block"
+import "@babel/plugin-transform-exponentiation-operator"
+import "@babel/plugin-transform-json-strings"
+import "@babel/plugin-transform-logical-assignment-operators"
+import "@babel/plugin-transform-nullish-coalescing-operator"
+import "@babel/plugin-transform-numeric-separator"
+import "@babel/plugin-transform-object-rest-spread"
+import "@babel/plugin-transform-optional-catch-binding"
+import "@babel/plugin-transform-optional-chaining"
+import "@babel/plugin-transform-private-property-in-object"
+import "@babel/plugin-transform-unicode-sets-regex"
+import "@babel/traverse"
+import "@babel/types"
+import "@rollup/plugin-babel"
+import "@rollup/plugin-commonjs"
+import "@rollup/plugin-json"
+import "@rollup/plugin-node-resolve"
+import "@samual/lib/assert"
+import "prettier"
+import "rollup"
+import "./processScript/minify.js"
+import "@samual/lib/countHackmudCharacters"
+import "@samual/lib/spliceString"
+import "acorn"
+import "terser"
+import "./processScript/shared.js"
+import "./processScript/postprocess.js"
+import "./processScript/preprocess.js"
+import "import-meta-resolve"
+import "./processScript/transform.js"
+import "@samual/lib/clearObject"
+import "@samual/lib/copyFilePersistent"
+import "@samual/lib/Cache"
+import "@samual/lib/writeFilePersistent"
+import "fs/promises"
+import "chokidar"