typescript-virtual-container 1.5.2 → 1.5.4

package/src/commands/tr.ts

@@ -1,70 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { ifFlag } from "./command-helpers";
-
-function unescapeTrSet(s: string): string {
-	return s
-		.replace(/\\n/g, "\n")
-		.replace(/\\t/g, "\t")
-		.replace(/\\r/g, "\r")
-		.replace(/\\\\/g, "\\");
-}
-
-function expandTrSet(s: string): string[] {
-	const chars: string[] = [];
-	const unescaped = unescapeTrSet(s);
-	let i = 0;
-	while (i < unescaped.length) {
-		// Range: a-z, A-Z, 0-9
-		if (i + 2 < unescaped.length && unescaped[i + 1] === "-") {
-			const from = unescaped.charCodeAt(i);
-			const to   = unescaped.charCodeAt(i + 2);
-			if (from <= to) {
-				for (let c = from; c <= to; c++) chars.push(String.fromCharCode(c));
-				i += 3;
-				continue;
-			}
-		}
-		chars.push(unescaped[i]!);
-		i++;
-	}
-	return chars;
-}
-
-export const trCommand: ShellModule = {
-	name: "tr",
-	description: "Translate or delete characters",
-	category: "text",
-	params: ["[-d] [-s] <set1> [set2]"],
-	run: ({ args, stdin }) => {
-		const del     = ifFlag(args, ["-d"]);
-		const squeeze = ifFlag(args, ["-s"]);
-		const positionals = args.filter((a) => !a.startsWith("-"));
-		const set1chars = expandTrSet(positionals[0] ?? "");
-		const set2chars = expandTrSet(positionals[1] ?? "");
-
-		let input = stdin ?? "";
-
-		if (del) {
-			const deleteSet = new Set(set1chars);
-			input = [...input].filter((c) => !deleteSet.has(c)).join("");
-		} else if (set2chars.length > 0) {
-			// Build translation map
-			const map = new Map<string, string>();
-			for (let i = 0; i < set1chars.length; i++) {
-				map.set(
-					set1chars[i]!,
-					set2chars[i] ?? set2chars[set2chars.length - 1] ?? "",
-				);
-			}
-			input = [...input].map((c) => map.get(c) ?? c).join("");
-		}
-
-		if (squeeze && set2chars.length > 0) {
-			// Squeeze repeated characters in set2
-			const squeezeSet = new Set(set2chars);
-			input = input.replace(/(.)\1+/g, (_, c) => squeezeSet.has(c) ? c : _);
-		}
-
-		return { stdout: input, exitCode: 0 };
-	},
-};

package/src/commands/tree.ts

@@ -1,20 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { getArg } from "./command-helpers";
-import { assertPathAccess, resolvePath } from "./helpers";
-
-/**
- * Display directory structure in a tree format.
- * @category navigation
- * @params ["[path]"]
- */
-export const treeCommand: ShellModule = {
-	name: "tree",
-	description: "Display directory tree",
-	category: "navigation",
-	params: ["[path]"],
-	run: ({ authUser, shell, cwd, args }) => {
-		const target = resolvePath(cwd, getArg(args, 0) ?? cwd);
-		assertPathAccess(authUser, target, "tree");
-		return { stdout: shell.vfs.tree(target), exitCode: 0 };
-	},
-};

package/src/commands/true.ts

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

package/src/commands/type.ts

@@ -1,48 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { resolveModule } from "./registry";
-
-/**
- * Describe how a command name would be interpreted (builtin, function, or file).
- * @category shell
- * @params ["<command...>"]
- */
-export const typeCommand: ShellModule = {
-	name: "type",
-	description: "Describe how a command would be interpreted",
-	category: "shell",
-	params: ["<command...>"],
-	run: ({ args, shell, env }) => {
-		if (args.length === 0)
-			return { stderr: "type: missing argument", exitCode: 1 };
-
-		const pathDirs = (env?.vars?.PATH ?? "/usr/local/bin:/usr/bin:/bin").split(
-			":",
-		);
-		const lines: string[] = [];
-		let exitCode = 0;
-
-		for (const name of args) {
-			if (resolveModule(name)) {
-				lines.push(`${name} is a shell builtin`);
-				continue;
-			}
-
-			let found = false;
-			for (const dir of pathDirs) {
-				const full = `${dir}/${name}`;
-				if (shell.vfs.exists(full)) {
-					lines.push(`${name} is ${full}`);
-					found = true;
-					break;
-				}
-			}
-
-			if (!found) {
-				lines.push(`${name}: not found`);
-				exitCode = 1;
-			}
-		}
-
-		return { stdout: lines.join("\n"), exitCode };
-	},
-};

package/src/commands/uname.ts

@@ -1,29 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { ifFlag } from "./command-helpers";
-
-/**
- * Print system information (kernel name, version, machine type).
- * @category system
- * @params ["[-a] [-s] [-r] [-m]"]
- */
-export const unameCommand: ShellModule = {
-	name: "uname",
-	description: "Print system information",
-	category: "system",
-	params: ["[-a] [-s] [-r] [-m]"],
-	run: ({ shell, args }) => {
-		const all = ifFlag(args, ["-a"]);
-		const sysname = "Linux";
-		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 (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

@@ -1,39 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { ifFlag } from "./command-helpers";
-
-/**
- * Report or filter out repeated consecutive lines.
- * @category text
- * @params ["[-c] [-d] [-u] [file]"]
- */
-export const uniqCommand: ShellModule = {
-	name: "uniq",
-	description: "Report or filter out repeated lines",
-	category: "text",
-	params: ["[-c] [-d] [-u] [file]"],
-	run: ({ args, stdin }) => {
-		const count = ifFlag(args, ["-c"]);
-		const dupOnly = ifFlag(args, ["-d"]);
-		const uniqOnly = ifFlag(args, ["-u"]);
-		const lines = (stdin ?? "").split("\n");
-		const out: string[] = [];
-		let i = 0;
-		while (i < lines.length) {
-			let j = i;
-			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;
-			}
-			out.push(count ? `${String(n).padStart(4)} ${line}` : line);
-			i = j;
-		}
-		return { stdout: out.join("\n"), exitCode: 0 };
-	},
-};

package/src/commands/unset.ts

@@ -1,17 +0,0 @@
-import type { ShellModule } from "../types/commands";
-
-/**
- * Remove shell variable from the environment.
- * @category shell
- * @params ["<VAR>"]
- */
-export const unsetCommand: ShellModule = {
-	name: "unset",
-	description: "Remove shell variable",
-	category: "shell",
-	params: ["<VAR>"],
-	run: ({ args, env }) => {
-		for (const name of args) delete env.vars[name];
-		return { exitCode: 0 };
-	},
-};

package/src/commands/uptime.ts

@@ -1,54 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { ifFlag } from "./command-helpers";
-
-/**
- * Tell how long the system has been running.
- * @category system
- * @params ["[-p] [-s]"]
- */
-export const uptimeCommand: ShellModule = {
-	name: "uptime",
-	description: "Tell how long the system has been running",
-	category: "system",
-	params: ["[-p] [-s]"],
-	run: ({ args, shell }) => {
-		const pretty = ifFlag(args, ["-p"]);
-		const since = ifFlag(args, ["-s"]);
-
-		const uptimeSec = Math.floor((Date.now() - shell.startTime) / 1000);
-		const days = Math.floor(uptimeSec / 86400);
-		const hours = Math.floor((uptimeSec % 86400) / 3600);
-		const mins = Math.floor((uptimeSec % 3600) / 60);
-
-		if (since) {
-			return {
-				stdout: new Date(shell.startTime)
-					.toISOString()
-					.slice(0, 19)
-					.replace("T", " "),
-				exitCode: 0,
-			};
-		}
-
-		if (pretty) {
-			const parts: string[] = [];
-			if (days > 0) parts.push(`${days} day${days > 1 ? "s" : ""}`);
-			if (hours > 0) parts.push(`${hours} hour${hours > 1 ? "s" : ""}`);
-			parts.push(`${mins} minute${mins !== 1 ? "s" : ""}`);
-			return { stdout: `up ${parts.join(", ")}`, exitCode: 0 };
-		}
-
-		const timeStr = new Date().toTimeString().slice(0, 8);
-		const uptimeStr =
-			days > 0
-				? `${days} day${days > 1 ? "s" : ""}, ${String(hours).padStart(2)}:${String(mins).padStart(2, "0")}`
-				: `${String(hours).padStart(2)}:${String(mins).padStart(2, "0")}`;
-		const sessions = shell.users.listActiveSessions().length;
-		const load = (Math.random() * 0.5).toFixed(2);
-
-		return {
-			stdout: ` ${timeStr} up ${uptimeStr},  ${sessions} user${sessions !== 1 ? "s" : ""},  load average: ${load}, ${load}, ${load}`,
-			exitCode: 0,
-		};
-	},
-};

package/src/commands/wc.ts

@@ -1,55 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { ifFlag } from "./command-helpers";
-import { assertPathAccess, resolvePath } from "./helpers";
-
-/**
- * Count words, lines, and/or bytes in files or stdin.
- * @category text
- * @params ["[-l] [-w] [-c] [file...]"]
- */
-export const wcCommand: ShellModule = {
-	name: "wc",
-	description: "Count words/lines/bytes",
-	category: "text",
-	params: ["[-l] [-w] [-c] [file...]"],
-	run: ({ authUser, shell, cwd, args, stdin }) => {
-		const lines = ifFlag(args, ["-l"]);
-		const words = ifFlag(args, ["-w"]);
-		const bytes = ifFlag(args, ["-c"]);
-		const showAll = !lines && !words && !bytes;
-		const positionals = args.filter((a) => !a.startsWith("-"));
-
-		const count = (content: string, label: string): string => {
-			const l = content.length === 0 ? 0 : content.trim().split("\n").length;
-			const w = content.trim().split(/\s+/).filter(Boolean).length;
-			const c = Buffer.byteLength(content, "utf8");
-			const parts: string[] = [];
-			if (showAll || lines) parts.push(String(l).padStart(7));
-			if (showAll || words) parts.push(String(w).padStart(7));
-			if (showAll || bytes) parts.push(String(c).padStart(7));
-			if (label) parts.push(` ${label}`);
-			return parts.join("");
-		};
-
-		if (positionals.length === 0) {
-			const content = stdin ?? "";
-			return { stdout: count(content, ""), exitCode: 0 };
-		}
-
-		const results: string[] = [];
-		for (const file of positionals) {
-			const filePath = resolvePath(cwd, file);
-			try {
-				assertPathAccess(authUser, filePath, "wc");
-				const content = shell.vfs.readFile(filePath);
-				results.push(count(content, file));
-			} catch {
-				return {
-					stderr: `wc: ${file}: No such file or directory`,
-					exitCode: 1,
-				};
-			}
-		}
-		return { stdout: results.join("\n"), exitCode: 0 };
-	},
-};

package/src/commands/wget.ts

@@ -1,148 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { ifFlag, parseArgs } from "./command-helpers";
-import { assertPathAccess, resolvePath, stripUrlFilename } from "./helpers";
-
-/**
- * Download files from the web (fetch-based implementation).
- * @category network
- * @params ["[options] <url>"]
- */
-export const wgetCommand: ShellModule = {
-	name: "wget",
-	description: "File downloader (pure fetch)",
-	category: "network",
-	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",
-			],
-		});
-
-		if (ifFlag(args, ["-h", "--help"])) {
-			return {
-				stdout: [
-					"Usage: wget [option]... [URL]...",
-					"  -O, --output-document=FILE  Write to FILE ('-' for stdout)",
-					"  -P, --directory-prefix=DIR  Save files in DIR",
-					"  -q, --quiet                 Quiet mode",
-					"  -v, --verbose               Verbose output (default)",
-					"  -c, --continue              Continue partial download",
-					"  --tries=N                   Retry N times",
-					"  --timeout=N                 Timeout in seconds",
-				].join("\n"),
-				exitCode: 0,
-			};
-		}
-
-		if (ifFlag(args, ["-V", "--version"])) {
-			return {
-				stdout: "GNU Wget 1.21.3 (virtual) built on Fortune GNU/Linux.",
-				exitCode: 0,
-			};
-		}
-
-		const urlWithoutProtocol = positionals[0];
-		if (!urlWithoutProtocol) {
-			return {
-				stderr: "wget: missing URL\nUsage: wget [OPTION]... [URL]...",
-				exitCode: 1,
-			};
-		}
-
-		const url = urlWithoutProtocol.startsWith("http://") ||
-			urlWithoutProtocol.startsWith("https://")
-			? urlWithoutProtocol
-			: `http://${urlWithoutProtocol}`;
-		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 quiet = ifFlag(args, ["-q", "--quiet"]);
-
-		// Derive target filename
-		const filename =
-			outputArg === "-" ? null : (outputArg ?? stripUrlFilename(url));
-		const targetPath = filename
-			? resolvePath(cwd, dirPrefix ? `${dirPrefix}/${filename}` : filename)
-			: null;
-
-		if (targetPath) assertPathAccess(authUser, targetPath, "wget");
-
-		const stderrLines: string[] = [];
-		if (!quiet) {
-			stderrLines.push(`--${new Date().toISOString()}--  ${url}`);
-			stderrLines.push(`Resolving ${new URL(url).host}...`);
-			stderrLines.push(`Connecting to ${new URL(url).host}...`);
-		}
-
-		let response: Response;
-		try {
-			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}`);
-			return { stderr: stderrLines.join("\n"), exitCode: 4 };
-		}
-
-		if (!response.ok) {
-			stderrLines.push(`ERROR ${response.status}: ${response.statusText}`);
-			return { stderr: stderrLines.join("\n"), exitCode: 8 };
-		}
-
-		let body: string;
-		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}`,
-			);
-			stderrLines.push(`Length: ${body.length} [${ct}]`);
-		}
-
-		// Output to stdout (pipe) or file
-		if (outputArg === "-") {
-			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`,
-				);
-			return { stderr: stderrLines.join("\n") || undefined, exitCode: 0 };
-		}
-
-		return { stdout: body, exitCode: 0 };
-	},
-};

package/src/commands/which.ts

@@ -1,37 +0,0 @@
-import type { ShellModule } from "../types/commands";
-
-export const whichCommand: ShellModule = {
-	name: "which",
-	description: "Locate a command in PATH",
-	category: "shell",
-	params: ["<command...>"],
-	run: ({ args, shell, env }) => {
-		if (args.length === 0)
-			return { stderr: "which: missing argument", exitCode: 1 };
-
-		const pathDirs = (env?.vars?.PATH ?? "/usr/local/bin:/usr/bin:/bin").split(
-			":",
-		);
-		const lines: string[] = [];
-		let anyMissing = false;
-
-		for (const name of args) {
-			let found = false;
-			for (const dir of pathDirs) {
-				const full = `${dir}/${name}`;
-				if (shell.vfs.exists(full)) {
-					const st = shell.vfs.stat(full);
-					if (st.type === "file") {
-						lines.push(full);
-						found = true;
-						break;
-					}
-				}
-			}
-			if (!found) anyMissing = true;
-		}
-
-		if (lines.length === 0) return { exitCode: 1 };
-		return { stdout: lines.join("\n"), exitCode: anyMissing ? 1 : 0 };
-	},
-};

package/src/commands/who.ts

@@ -1,25 +0,0 @@
-import { formatLoginDate } from "../SSHMimic/loginFormat";
-import type { ShellModule } from "../types/commands";
-
-/**
- * Show active user sessions.
- * @category system
- * @params []
- */
-export const whoCommand: ShellModule = {
-	name: "who",
-	description: "Show active sessions",
-	category: "system",
-	params: [],
-	run: ({ shell }) => {
-		const lines = shell.users.listActiveSessions().map((session) => {
-			const loginAt = new Date(session.startedAt);
-			const displayDate = Number.isNaN(loginAt.getTime())
-				? session.startedAt
-				: formatLoginDate(loginAt);
-			return `${session.username} ${session.tty} ${displayDate} (${session.remoteAddress || "unknown"})`;
-		});
-
-		return { stdout: lines.join("\n"), exitCode: 0 };
-	},
-};

package/src/commands/whoami.ts

@@ -1,14 +0,0 @@
-import type { ShellModule } from "../types/commands";
-
-/**
- * Print the current user name.
- * @category system
- * @params []
- */
-export const whoamiCommand: ShellModule = {
-	name: "whoami",
-	description: "Print current user",
-	category: "system",
-	params: [],
-	run: ({ authUser }) => ({ stdout: authUser, exitCode: 0 }),
-};

package/src/commands/xargs.ts

@@ -1,31 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { runCommand } from "./runtime";
-
-/**
- * Build and execute commands from stdin arguments.
- * @category text
- * @params ["[command] [args...]"]
- */
-export const xargsCommand: ShellModule = {
-	name: "xargs",
-	description: "Build and execute command lines from stdin",
-	category: "text",
-	params: ["[command] [args...]"],
-	run: async ({ authUser, hostname, mode, cwd, args, stdin, shell, env }) => {
-		const baseCmd = args[0] ?? "echo";
-		const extraArgs = args.slice(1);
-		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,
-		);
-	},
-};

package/src/index.ts

@@ -1,67 +0,0 @@
-export { HoneyPot } from "./Honeypot/index";
-export { SshClient } from "./SSHClient/index";
-export { SftpMimic as VirtualSftpServer, SshMimic as VirtualSshServer } from "./SSHMimic/index";
-export type { SftpMimicOptions as VirtualSftpServerOptions } from "./SSHMimic/sftp";
-export { default as VirtualFileSystem } from "./VirtualFileSystem/index";
-export { VirtualPackageManager } from "./VirtualPackageManager/index";
-export { VirtualShell } from "./VirtualShell/index";
-export { VirtualUserManager } from "./VirtualUserManager/index";
-export type { VirtualActiveSession } from "./VirtualUserManager/index";
-export { IdleManager } from "./VirtualShell/idleManager";
-export type { IdleManagerOptions, IdleState } from "./VirtualShell/idleManager";
-
-export type {
-	AuditLogEntry,
-	HoneyPotStats
-} from "./Honeypot/index";
-export type {
-	CommandContext,
-	CommandMode,
-	CommandOutcome,
-	CommandResult,
-	NanoEditorSession,
-	PasswordChallenge,
-	ShellEnv,
-	ShellModule,
-	SudoChallenge
-} from "./types/commands";
-export type { ExecStream, ShellStream } from "./types/streams";
-export type {
-	RemoveOptions,
-	VfsBaseNode,
-	VfsDirectoryNode,
-	VfsFileNode,
-	VfsNodeStats,
-	VfsNodeType,
-	VfsSnapshot,
-	VfsSnapshotBaseNode,
-	VfsSnapshotDirectoryNode,
-	VfsSnapshotFileNode,
-	VfsSnapshotNode,
-	WriteFileOptions
-} from "./types/vfs";
-export type { VfsOptions, VfsPersistenceMode } from "./VirtualFileSystem/index";
-export type { ShellProperties, VirtualShellVfsLike, VirtualShellVfsOptions } from "./VirtualShell/index";
-
-export type {
-	InstalledPackage, PackageDefinition,
-	PackageFile
-} from "./VirtualPackageManager/index";
-
-export {
-	assertDiff, diffSnapshots,
-	formatDiff
-} from "./utils/vfsDiff";
-export type {
-	VfsDiff,
-	VfsDiffEntry,
-	VfsDiffModified
-} from "./utils/vfsDiff";
-
-export {
-	getArg,
-	getFlag,
-	ifFlag
-} from "./commands/command-helpers";
-export type { ArgParseOptions } from "./commands/command-helpers";
-