typescript-virtual-container 1.2.9 → 1.3.0

package/src/commands/test.ts

@@ -6,7 +6,11 @@ import type { ShellModule } from "../types/commands";
  *           string =, !=, numeric -eq -ne -lt -le -gt -ge,
  *           ! (negate), -a (and), -o (or).
  */
-function evalTest(tokens: string[], shell: import("../VirtualShell").VirtualShell, cwd: string): boolean {
+function evalTest(
+	tokens: string[],
+	shell: import("../VirtualShell").VirtualShell,
+	cwd: string,
+): boolean {
 	// When called via [ command, ] is the last arg — strip it
 	// When called via test command, no brackets present
 	if (tokens[tokens.length - 1] === "]") {
@@ -25,32 +29,53 @@ function evalTest(tokens: string[], shell: import("../VirtualShell").VirtualShel
 	// Boolean -a / -o (simple left-right, no precedence)
 	const andIdx = tokens.indexOf("-a");
 	if (andIdx !== -1) {
-		return evalTest(tokens.slice(0, andIdx), shell, cwd) &&
-			evalTest(tokens.slice(andIdx + 1), shell, cwd);
+		return (
+			evalTest(tokens.slice(0, andIdx), shell, cwd) &&
+			evalTest(tokens.slice(andIdx + 1), shell, cwd)
+		);
 	}
 	const orIdx = tokens.indexOf("-o");
 	if (orIdx !== -1) {
-		return evalTest(tokens.slice(0, orIdx), shell, cwd) ||
-			evalTest(tokens.slice(orIdx + 1), shell, cwd);
+		return (
+			evalTest(tokens.slice(0, orIdx), shell, cwd) ||
+			evalTest(tokens.slice(orIdx + 1), shell, cwd)
+		);
 	}
 
 	// Unary file tests
 	if (tokens.length === 2) {
 		const [flag, operand = ""] = tokens;
-		const resolvePath = (p: string) => p.startsWith("/") ? p : `${cwd}/${p}`.replace(/\/+/g, "/");
+		const resolvePath = (p: string) =>
+			p.startsWith("/") ? p : `${cwd}/${p}`.replace(/\/+/g, "/");
 		const path = resolvePath(operand);
 
 		switch (flag) {
-			case "-e": return shell.vfs.exists(path);
-			case "-f": return shell.vfs.exists(path) && shell.vfs.stat(path).type === "file";
-			case "-d": return shell.vfs.exists(path) && shell.vfs.stat(path).type === "directory";
-			case "-r": return shell.vfs.exists(path); // all readable in virtual env
-			case "-w": return shell.vfs.exists(path);
-			case "-x": return shell.vfs.exists(path) && !!(shell.vfs.stat(path).mode & 0o111);
-			case "-s": return shell.vfs.exists(path) && shell.vfs.stat(path).type === "file" && (shell.vfs.stat(path) as import("../types/vfs").VfsFileNode).size > 0;
-			case "-z": return operand.length === 0;
-			case "-n": return operand.length > 0;
-			case "-L": return shell.vfs.isSymlink(path);
+			case "-e":
+				return shell.vfs.exists(path);
+			case "-f":
+				return shell.vfs.exists(path) && shell.vfs.stat(path).type === "file";
+			case "-d":
+				return (
+					shell.vfs.exists(path) && shell.vfs.stat(path).type === "directory"
+				);
+			case "-r":
+				return shell.vfs.exists(path); // all readable in virtual env
+			case "-w":
+				return shell.vfs.exists(path);
+			case "-x":
+				return shell.vfs.exists(path) && !!(shell.vfs.stat(path).mode & 0o111);
+			case "-s":
+				return (
+					shell.vfs.exists(path) &&
+					shell.vfs.stat(path).type === "file" &&
+					(shell.vfs.stat(path) as import("../types/vfs").VfsFileNode).size > 0
+				);
+			case "-z":
+				return operand.length === 0;
+			case "-n":
+				return operand.length > 0;
+			case "-L":
+				return shell.vfs.isSymlink(path);
 		}
 	}
 
@@ -63,17 +88,27 @@ function evalTest(tokens: string[], shell: import("../VirtualShell").VirtualShel
 		switch (op) {
 			// String
 			case "=":
-			case "==": return left === right;
-			case "!=": return left !== right;
-			case "<":  return left < right;
-			case ">":  return left > right;
+			case "==":
+				return left === right;
+			case "!=":
+				return left !== right;
+			case "<":
+				return left < right;
+			case ">":
+				return left > right;
 			// Numeric
-			case "-eq": return leftN === rightN;
-			case "-ne": return leftN !== rightN;
-			case "-lt": return leftN < rightN;
-			case "-le": return leftN <= rightN;
-			case "-gt": return leftN > rightN;
-			case "-ge": return leftN >= rightN;
+			case "-eq":
+				return leftN === rightN;
+			case "-ne":
+				return leftN !== rightN;
+			case "-lt":
+				return leftN < rightN;
+			case "-le":
+				return leftN <= rightN;
+			case "-gt":
+				return leftN > rightN;
+			case "-ge":
+				return leftN >= rightN;
 		}
 	}
 

package/src/commands/tr.ts

@@ -16,7 +16,9 @@ export const trCommand: ShellModule = {
 			for (const c of set1) input = input.split(c).join("");
 		} else if (set2) {
 			for (let i = 0; i < set1.length; i++) {
-				input = input.split(set1[i]!).join(set2[i] ?? set2[set2.length - 1] ?? "");
+				input = input
+					.split(set1[i]!)
+					.join(set2[i] ?? set2[set2.length - 1] ?? "");
 			}
 		}
 		return { stdout: input, exitCode: 0 };

package/src/commands/true.ts

@@ -0,0 +1,17 @@
+import type { ShellModule } from "../types/commands";
+
+export const trueCommand: ShellModule = {
+	name: "true",
+	description: "Return success exit code",
+	category: "shell",
+	params: [],
+	run: () => ({ exitCode: 0 }),
+};
+
+export const falseCommand: ShellModule = {
+	name: "false",
+	description: "Return failure exit code",
+	category: "shell",
+	params: [],
+	run: () => ({ exitCode: 1 }),
+};

package/src/commands/type.ts

@@ -1,5 +1,5 @@
-import { resolveModule } from ".";
 import type { ShellModule } from "../types/commands";
+import { resolveModule } from "./registry";
 
 export const typeCommand: ShellModule = {
 	name: "type",
@@ -7,9 +7,12 @@ export const typeCommand: ShellModule = {
 	category: "shell",
 	params: ["<command...>"],
 	run: ({ args, shell, env }) => {
-		if (args.length === 0) return { stderr: "type: missing argument", exitCode: 1 };
+		if (args.length === 0)
+			return { stderr: "type: missing argument", exitCode: 1 };
 
-		const pathDirs = (env?.vars?.PATH ?? "/usr/local/bin:/usr/bin:/bin").split(":");
+		const pathDirs = (env?.vars?.PATH ?? "/usr/local/bin:/usr/bin:/bin").split(
+			":",
+		);
 		const lines: string[] = [];
 		let exitCode = 0;
 

package/src/commands/uname.ts

@@ -12,7 +12,11 @@ export const unameCommand: ShellModule = {
 		const release = shell.properties?.kernel ?? "5.15.0";
 		const machine = shell.properties?.arch ?? "x86_64";
 		const hostname = shell.hostname;
-		if (all) return { stdout: `${sysname} ${hostname} ${release} #1 SMP ${machine} GNU/Linux`, exitCode: 0 };
+		if (all)
+			return {
+				stdout: `${sysname} ${hostname} ${release} #1 SMP ${machine} GNU/Linux`,
+				exitCode: 0,
+			};
 		if (ifFlag(args, ["-r"])) return { stdout: release, exitCode: 0 };
 		if (ifFlag(args, ["-m"])) return { stdout: machine, exitCode: 0 };
 		return { stdout: sysname, exitCode: 0 };

package/src/commands/uniq.ts

@@ -18,8 +18,14 @@ export const uniqCommand: ShellModule = {
 			while (j < lines.length && lines[j] === lines[i]) j++;
 			const n = j - i;
 			const line = lines[i]!;
-			if (dupOnly && n === 1) { i = j; continue; }
-			if (uniqOnly && n > 1) { i = j; continue; }
+			if (dupOnly && n === 1) {
+				i = j;
+				continue;
+			}
+			if (uniqOnly && n > 1) {
+				i = j;
+				continue;
+			}
 			out.push(count ? `${String(n).padStart(4)} ${line}` : line);
 			i = j;
 		}

package/src/commands/uptime.ts

@@ -17,7 +17,10 @@ export const uptimeCommand: ShellModule = {
 
 		if (since) {
 			return {
-				stdout: new Date(shell.startTime).toISOString().slice(0, 19).replace("T", " "),
+				stdout: new Date(shell.startTime)
+					.toISOString()
+					.slice(0, 19)
+					.replace("T", " "),
 				exitCode: 0,
 			};
 		}

package/src/commands/wget.ts

@@ -9,7 +9,16 @@ export const wgetCommand: ShellModule = {
 	params: ["[options] <url>"],
 	run: async ({ authUser, cwd, args, shell }) => {
 		const { flagsWithValues, positionals } = parseArgs(args, {
-			flagsWithValue: ["-O", "--output-document", "-o", "--output-file", "-P", "--directory-prefix", "--tries", "--timeout"],
+			flagsWithValue: [
+				"-O",
+				"--output-document",
+				"-o",
+				"--output-file",
+				"-P",
+				"--directory-prefix",
+				"--tries",
+				"--timeout",
+			],
 		});
 
 		if (ifFlag(args, ["-h", "--help"])) {
@@ -29,18 +38,32 @@ export const wgetCommand: ShellModule = {
 		}
 
 		if (ifFlag(args, ["-V", "--version"])) {
-			return { stdout: "GNU Wget 1.21.3 (virtual) built on Fortune GNU/Linux.", exitCode: 0 };
+			return {
+				stdout: "GNU Wget 1.21.3 (virtual) built on Fortune GNU/Linux.",
+				exitCode: 0,
+			};
 		}
 
 		const url = positionals[0];
-		if (!url) return { stderr: "wget: missing URL\nUsage: wget [OPTION]... [URL]...", exitCode: 1 };
+		if (!url)
+			return {
+				stderr: "wget: missing URL\nUsage: wget [OPTION]... [URL]...",
+				exitCode: 1,
+			};
 
-		const outputArg = flagsWithValues.get("-O") ?? flagsWithValues.get("--output-document") ?? null;
-		const dirPrefix = flagsWithValues.get("-P") ?? flagsWithValues.get("--directory-prefix") ?? null;
+		const outputArg =
+			flagsWithValues.get("-O") ??
+			flagsWithValues.get("--output-document") ??
+			null;
+		const dirPrefix =
+			flagsWithValues.get("-P") ??
+			flagsWithValues.get("--directory-prefix") ??
+			null;
 		const quiet = ifFlag(args, ["-q", "--quiet"]);
 
 		// Derive target filename
-		const filename = outputArg === "-" ? null : (outputArg ?? stripUrlFilename(url));
+		const filename =
+			outputArg === "-" ? null : (outputArg ?? stripUrlFilename(url));
 		const targetPath = filename
 			? resolvePath(cwd, dirPrefix ? `${dirPrefix}/${filename}` : filename)
 			: null;
@@ -56,7 +79,9 @@ export const wgetCommand: ShellModule = {
 
 		let response: Response;
 		try {
-			response = await fetch(url, { headers: { "User-Agent": "Wget/1.21.3 (Fortune GNU/Linux)" } });
+			response = await fetch(url, {
+				headers: { "User-Agent": "Wget/1.21.3 (Fortune GNU/Linux)" },
+			});
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
 			stderrLines.push(`wget: unable to resolve host: ${msg}`);
@@ -69,22 +94,36 @@ export const wgetCommand: ShellModule = {
 		}
 
 		let body: string;
-		try { body = await response.text(); } catch { return { stderr: "wget: failed to read response", exitCode: 1 }; }
+		try {
+			body = await response.text();
+		} catch {
+			return { stderr: "wget: failed to read response", exitCode: 1 };
+		}
 
 		if (!quiet) {
-			const ct = response.headers.get("content-type") ?? "application/octet-stream";
-			stderrLines.push(`HTTP request sent, awaiting response... ${response.status} ${response.statusText}`);
+			const ct =
+				response.headers.get("content-type") ?? "application/octet-stream";
+			stderrLines.push(
+				`HTTP request sent, awaiting response... ${response.status} ${response.statusText}`,
+			);
 			stderrLines.push(`Length: ${body.length} [${ct}]`);
 		}
 
 		// Output to stdout (pipe) or file
 		if (outputArg === "-") {
-			return { stdout: body, stderr: stderrLines.join("\n") || undefined, exitCode: 0 };
+			return {
+				stdout: body,
+				stderr: stderrLines.join("\n") || undefined,
+				exitCode: 0,
+			};
 		}
 
 		if (targetPath) {
 			shell.writeFileAsUser(authUser, targetPath, body);
-			if (!quiet) stderrLines.push(`Saving to: '${targetPath}'\n${targetPath}            100%[==================>]  ${body.length} B`);
+			if (!quiet)
+				stderrLines.push(
+					`Saving to: '${targetPath}'\n${targetPath}            100%[==================>]  ${body.length} B`,
+				);
 			return { stderr: stderrLines.join("\n") || undefined, exitCode: 0 };
 		}
 

package/src/commands/which.ts

@@ -6,9 +6,12 @@ export const whichCommand: ShellModule = {
 	category: "shell",
 	params: ["<command...>"],
 	run: ({ args, shell, env }) => {
-		if (args.length === 0) return { stderr: "which: missing argument", exitCode: 1 };
+		if (args.length === 0)
+			return { stderr: "which: missing argument", exitCode: 1 };
 
-		const pathDirs = (env?.vars?.PATH ?? "/usr/local/bin:/usr/bin:/bin").split(":");
+		const pathDirs = (env?.vars?.PATH ?? "/usr/local/bin:/usr/bin:/bin").split(
+			":",
+		);
 		const lines: string[] = [];
 		let anyMissing = false;
 

package/src/commands/xargs.ts

@@ -1,5 +1,5 @@
 import type { ShellModule } from "../types/commands";
-import { runCommand } from "./index";
+import { runCommand } from "./runtime";
 
 export const xargsCommand: ShellModule = {
 	name: "xargs",
@@ -12,6 +12,15 @@ export const xargsCommand: ShellModule = {
 		const items = (stdin ?? "").trim().split(/\s+/).filter(Boolean);
 		if (items.length === 0) return { exitCode: 0 };
 		const fullCmd = [baseCmd, ...extraArgs, ...items].join(" ");
-		return runCommand(fullCmd, authUser, hostname, mode, cwd, shell, undefined, env);
+		return runCommand(
+			fullCmd,
+			authUser,
+			hostname,
+			mode,
+			cwd,
+			shell,
+			undefined,
+			env,
+		);
 	},
 };

package/src/index.ts

@@ -1,14 +1,14 @@
-import { HoneyPot } from "./Honeypot/index";
-import { SshClient } from "./SSHClient/index";
-import { SftpMimic, SshMimic } from "./SSHMimic/index";
-import VirtualFileSystem from "./VirtualFileSystem/index";
-import { VirtualShell } from "./VirtualShell/index";
-import { VirtualUserManager } from "./VirtualUserManager/index";
-import { VirtualPackageManager } from "./VirtualPackageManager/index";
+export { HoneyPot } from "./Honeypot/index";
+export { SshClient } from "./SSHClient/index";
+export { SftpMimic as VirtualSftpServer, SshMimic as VirtualSshServer } from "./SSHMimic/index";
+export { default as VirtualFileSystem } from "./VirtualFileSystem/index";
+export { VirtualPackageManager } from "./VirtualPackageManager/index";
+export { VirtualShell } from "./VirtualShell/index";
+export { VirtualUserManager } from "./VirtualUserManager/index";
 
 export type {
 	AuditLogEntry,
-	HoneyPotStats,
+	HoneyPotStats
 } from "./Honeypot/index";
 export type {
 	CommandContext,
@@ -18,9 +18,8 @@ export type {
 	NanoEditorSession,
 	ShellEnv,
 	ShellModule,
-	SudoChallenge,
+	SudoChallenge
 } from "./types/commands";
-export type { ShellProperties } from "./VirtualShell/index";
 export type { ExecStream, ShellStream } from "./types/streams";
 export type {
 	RemoveOptions,
@@ -34,29 +33,29 @@ export type {
 	VfsSnapshotDirectoryNode,
 	VfsSnapshotFileNode,
 	VfsSnapshotNode,
-	WriteFileOptions,
+	WriteFileOptions
 } from "./types/vfs";
 export type { VfsOptions, VfsPersistenceMode } from "./VirtualFileSystem/index";
+export type { ShellProperties } from "./VirtualShell/index";
 
 export type {
-	PackageDefinition,
-	PackageFile,
-	InstalledPackage,
+	InstalledPackage, PackageDefinition,
+	PackageFile
 } from "./VirtualPackageManager/index";
 
 export {
-	HoneyPot,
-	SshClient,
-	VirtualFileSystem,
-	SftpMimic as VirtualSftpServer,
-	VirtualShell,
-	SshMimic as VirtualSshServer,
-	VirtualUserManager,
-	VirtualPackageManager,
-};
+	assertDiff, diffSnapshots,
+	formatDiff
+} from "./utils/vfsDiff";
+export type {
+	VfsDiff,
+	VfsDiffEntry,
+	VfsDiffModified
+} from "./utils/vfsDiff";
 
 export {
 	getArg,
 	getFlag,
-	ifFlag,
+	ifFlag
 } from "./commands/command-helpers";
+