typescript-virtual-container 1.2.8 → 1.3.0

package/src/commands/npm.ts

@@ -0,0 +1,132 @@
+/**
+ * npm.ts — Virtual npm command.
+ * Gated behind `apt install npm`. Provides version info and informative
+ * stubs for common subcommands.
+ */
+import type { ShellModule } from "../types/commands";
+import { ifFlag } from "./command-helpers";
+
+const NPM_VERSION = "9.2.0";
+const NODE_VERSION = "18.19.0";
+
+/**
+ * `npm` virtual CLI. Requires `apt install npm` in the virtual package manager.
+ * @category system
+ * @params ["<command> [args]"]
+ */
+export const npmCommand: ShellModule = {
+	name: "npm",
+	description: "Node.js package manager (virtual)",
+	category: "system",
+	params: ["<command> [args]"],
+	run: ({ args, shell }) => {
+		// Require explicit installation
+		if (!shell.packageManager.isInstalled("npm")) {
+			return {
+				stderr:
+					"bash: npm: command not found\nHint: install it with: apt install npm\n",
+				exitCode: 127,
+			};
+		}
+
+		if (ifFlag(args, ["--version", "-v"])) {
+			return { stdout: `${NPM_VERSION}\n`, exitCode: 0 };
+		}
+
+		const sub = args[0]?.toLowerCase();
+
+		switch (sub) {
+			case "version":
+			case "-version":
+				return {
+					stdout: `{ npm: '${NPM_VERSION}', node: '${NODE_VERSION}', v8: '10.2.154.26' }\n`,
+					exitCode: 0,
+				};
+
+			case "install":
+			case "i":
+			case "add":
+				return {
+					stderr:
+						"npm warn: package installation is not available in the virtual runtime.\nnpm warn: This environment simulates npm CLI behaviour only.\n",
+					exitCode: 1,
+				};
+
+			case "run":
+			case "exec":
+			case "x":
+				return {
+					stderr: `npm error: script execution is not available in the virtual runtime.\n`,
+					exitCode: 1,
+				};
+
+			case "init":
+				return {
+					stdout: "Wrote to /home/user/package.json\n",
+					exitCode: 0,
+				};
+
+			case "list":
+			case "ls":
+				return {
+					stdout: `${sub === "ls" || sub === "list" ? "virtual-env@1.0.0" : ""}\n└── (empty)\n`,
+					exitCode: 0,
+				};
+
+			case "help":
+			case undefined:
+				return {
+					stdout: `${[
+						`npm ${NPM_VERSION}`,
+						"",
+						"Usage: npm <command>",
+						"",
+						"Commands:",
+						"  install       (not available in virtual runtime)",
+						"  run           (not available in virtual runtime)",
+						"  exec          (not available in virtual runtime)",
+						"  list          List installed packages",
+						"  version       Print versions",
+						"  --version     Print npm version",
+					].join("\n")}\n`,
+					exitCode: 0,
+				};
+
+			default:
+				return {
+					stderr: `npm error: unknown command: ${sub}\n`,
+					exitCode: 1,
+				};
+		}
+	},
+};
+
+/**
+ * `npx` virtual runner. Requires `apt install npm` in the virtual package manager.
+ * @category system
+ * @params ["<package> [args]"]
+ */
+export const npxCommand: ShellModule = {
+	name: "npx",
+	description: "Node.js package runner (virtual)",
+	category: "system",
+	params: ["<package> [args]"],
+	run: ({ args, shell }) => {
+		if (!shell.packageManager.isInstalled("npm")) {
+			return {
+				stderr:
+					"bash: npx: command not found\nHint: install it with: apt install npm\n",
+				exitCode: 127,
+			};
+		}
+
+		if (ifFlag(args, ["--version"])) {
+			return { stdout: `${NPM_VERSION}\n`, exitCode: 0 };
+		}
+
+		return {
+			stderr: `npx: package execution is not available in the virtual runtime.\n`,
+			exitCode: 1,
+		};
+	},
+};

package/src/commands/ping.ts

@@ -1,4 +1,5 @@
 import type { ShellModule } from "../types/commands";
+import { parseArgs } from "./command-helpers";
 
 export const pingCommand: ShellModule = {
 	name: "ping",
@@ -6,15 +7,21 @@ export const pingCommand: ShellModule = {
 	category: "network",
 	params: ["[-c <count>] <host>"],
 	run: ({ args }) => {
-		const host = args.find((a) => !a.startsWith("-")) ?? "localhost";
-		const count = 4;
+		const { flagsWithValues, positionals } = parseArgs(args, {
+			flagsWithValue: ["-c", "-i", "-W"],
+		});
+		const host = positionals[0] ?? "localhost";
+		const countArg = flagsWithValues.get("-c");
+		const count = countArg ? Math.max(1, parseInt(countArg, 10) || 4) : 4;
 		const lines = [`PING ${host}: 56 data bytes`];
 		for (let i = 0; i < count; i++) {
 			const ms = (Math.random() * 10 + 1).toFixed(3);
 			lines.push(`64 bytes from ${host}: icmp_seq=${i} ttl=64 time=${ms} ms`);
 		}
 		lines.push(`--- ${host} ping statistics ---`);
-		lines.push(`${count} packets transmitted, ${count} received, 0% packet loss`);
+		lines.push(
+			`${count} packets transmitted, ${count} received, 0% packet loss`,
+		);
 		return { stdout: lines.join("\n"), exitCode: 0 };
 	},
 };

package/src/commands/printf.ts

@@ -0,0 +1,112 @@
+import type { ShellModule } from "../types/commands";
+
+/**
+ * Render a printf format string with given arguments.
+ * Supports: %s %d %i %f %o %x %X %% \n \t \r \\
+ */
+function renderPrintf(fmt: string, args: string[]): string {
+	let argIdx = 0;
+	let out = "";
+	let i = 0;
+	while (i < fmt.length) {
+		if (fmt[i] === "\\" && i + 1 < fmt.length) {
+			switch (fmt[i + 1]) {
+				case "n":
+					out += "\n";
+					i += 2;
+					continue;
+				case "t":
+					out += "\t";
+					i += 2;
+					continue;
+				case "r":
+					out += "\r";
+					i += 2;
+					continue;
+				case "\\":
+					out += "\\";
+					i += 2;
+					continue;
+				case "a":
+					out += "\x07";
+					i += 2;
+					continue;
+				case "b":
+					out += "\x08";
+					i += 2;
+					continue;
+				case "f":
+					out += "\x0C";
+					i += 2;
+					continue;
+				case "v":
+					out += "\x0B";
+					i += 2;
+					continue;
+				default:
+					out += fmt[i]!;
+					i++;
+					continue;
+			}
+		}
+		if (fmt[i] === "%" && i + 1 < fmt.length) {
+			// Optional width/precision: %[-][width][.prec]spec
+			let j = i + 1;
+			if (fmt[j] === "-") j++;
+			while (j < fmt.length && /\d/.test(fmt[j]!)) j++;
+			if (fmt[j] === ".") {
+				j++;
+				while (j < fmt.length && /\d/.test(fmt[j]!)) j++;
+			}
+			const spec = fmt[j];
+			const arg = args[argIdx++] ?? "";
+			switch (spec) {
+				case "s":
+					out += arg;
+					break;
+				case "d":
+				case "i":
+					out += String(parseInt(arg, 10) || 0);
+					break;
+				case "f":
+					out += String(parseFloat(arg) || 0);
+					break;
+				case "o":
+					out += (parseInt(arg, 10) || 0).toString(8);
+					break;
+				case "x":
+					out += (parseInt(arg, 10) || 0).toString(16);
+					break;
+				case "X":
+					out += (parseInt(arg, 10) || 0).toString(16).toUpperCase();
+					break;
+				case "%":
+					out += "%";
+					argIdx--;
+					break;
+				default:
+					out += fmt[i]!;
+					i++;
+					continue;
+			}
+			i = j + 1;
+			continue;
+		}
+		out += fmt[i]!;
+		i++;
+	}
+	return out;
+}
+
+export const printfCommand: ShellModule = {
+	name: "printf",
+	description: "Format and print data",
+	category: "shell",
+	params: ["<format> [args...]"],
+	run: ({ args }) => {
+		const fmt = args[0];
+		if (!fmt) return { stderr: "printf: missing format string", exitCode: 1 };
+		const output = renderPrintf(fmt, args.slice(1));
+		return { stdout: output, exitCode: 0 };
+	},
+};

package/src/commands/ps.ts

@@ -1,19 +1,53 @@
 import type { ShellModule } from "../types/commands";
+import { ifFlag } from "./command-helpers";
 
 export const psCommand: ShellModule = {
 	name: "ps",
 	description: "Report process status",
 	category: "system",
-	params: ["[-a] [-u] [-x]"],
-	run: ({ authUser, shell }) => {
+	params: ["[-a] [-u] [-x] [aux]"],
+	run: ({ authUser, shell, args }) => {
 		const sessions = shell.users.listActiveSessions();
-		const lines = ["  PID TTY          TIME CMD"];
+		const showUser =
+			ifFlag(args, ["-u"]) ||
+			args.includes("u") ||
+			args.includes("aux") ||
+			args.includes("au");
+		const showAll =
+			ifFlag(args, ["-a", "-x"]) || args.includes("a") || args.includes("aux");
+
+		if (showUser) {
+			const header =
+				"USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND";
+			const rows: string[] = [header];
+			let pid = 1000;
+			for (const s of sessions) {
+				const user = s.username.padEnd(10).slice(0, 10);
+				const mem = (Math.random() * 0.5).toFixed(1);
+				const vsz = Math.floor(Math.random() * 20000 + 5000);
+				const rss = Math.floor(Math.random() * 5000 + 1000);
+				rows.push(
+					`${user} ${String(pid).padStart(6)}  0.0  ${mem.padStart(4)} ${String(vsz).padStart(6)} ${String(rss).padStart(5)} ${s.tty.padEnd(8)} Ss   00:00   0:00 bash`,
+				);
+				pid++;
+			}
+			rows.push(
+				`root       ${String(pid).padStart(6)}  0.0   0.0      0      0 ?        S    00:00   0:00 ps`,
+			);
+			return { stdout: rows.join("\n"), exitCode: 0 };
+		}
+
+		const header = "  PID TTY          TIME CMD";
+		const rows: string[] = [header];
 		let pid = 1000;
 		for (const s of sessions) {
-			lines.push(`${String(pid).padStart(5)} ${s.tty.padEnd(12)} 00:00:00 ${s.username === authUser ? "bash" : `bash (${s.username})`}`);
+			if (!showAll && s.username !== authUser) continue;
+			rows.push(
+				`${String(pid).padStart(5)} ${s.tty.padEnd(12)} 00:00:00 ${s.username === authUser ? "bash" : `bash (${s.username})`}`,
+			);
 			pid++;
 		}
-		lines.push(`${String(pid).padStart(5)} pts/0        00:00:00 ps`);
-		return { stdout: lines.join("\n"), exitCode: 0 };
+		rows.push(`${String(pid).padStart(5)} pts/0        00:00:00 ps`);
+		return { stdout: rows.join("\n"), exitCode: 0 };
 	},
 };