typescript-virtual-container 1.5.2 → 1.5.4

package/src/commands/free.ts

@@ -1,47 +0,0 @@
-import * as os from "node:os";
-import type { ShellModule } from "../types/commands";
-import { ifFlag } from "./command-helpers";
-
-/**
- * Display memory usage information (human / MB / GB options).
- * @category system
- * @params ["[-h] [-m] [-g]"]
- */
-export const freeCommand: ShellModule = {
-	name: "free",
-	description: "Display amount of free and used memory",
-	category: "system",
-	params: ["[-h] [-m] [-g]"],
-	run: ({ args }) => {
-		const human = ifFlag(args, ["-h", "--human"]);
-		const mb = ifFlag(args, ["-m"]);
-		const gb = ifFlag(args, ["-g"]);
-
-		const osTotalB = os.totalmem();
-		const osFreeB = os.freemem();
-		const usedB = osTotalB - osFreeB;
-		const sharedB = Math.floor(osTotalB * 0.02);
-		const buffersB = Math.floor(osTotalB * 0.05);
-		const availableB = Math.floor(osFreeB * 0.95);
-		const swapB = Math.floor(osTotalB * 0.5);
-
-		const fmt = (bytes: number): string => {
-			if (human) {
-				if (bytes >= 1024 * 1024 * 1024)
-					return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}G`;
-				if (bytes >= 1024 * 1024)
-					return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
-				return `${(bytes / 1024).toFixed(1)}K`;
-			}
-			if (gb) return String(Math.floor(bytes / (1024 * 1024 * 1024)));
-			if (mb) return String(Math.floor(bytes / (1024 * 1024)));
-			return String(Math.floor(bytes / 1024));
-		};
-
-		const header = `               total        used        free      shared  buff/cache   available`;
-		const memRow = `Mem:  ${fmt(osTotalB).padStart(12)} ${fmt(usedB).padStart(11)} ${fmt(osFreeB).padStart(11)} ${fmt(sharedB).padStart(11)} ${fmt(buffersB).padStart(11)} ${fmt(availableB).padStart(11)}`;
-		const swapRow = `Swap: ${fmt(swapB).padStart(12)} ${fmt(0).padStart(11)} ${fmt(swapB).padStart(11)}`;
-
-		return { stdout: [header, memRow, swapRow].join("\n"), exitCode: 0 };
-	},
-};

package/src/commands/grep.ts

@@ -1,116 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { parseArgs } from "./command-helpers";
-import { assertPathAccess, resolvePath } from "./helpers";
-
-/**
- * Search for a regex pattern in files or stdin with common flags.
- * @category text
- * @params ["[-i] [-v] [-n] [-r] <pattern> [file...]"]
- */
-export const grepCommand: ShellModule = {
-	name: "grep",
-	description: "Search text patterns",
-	category: "text",
-	params: ["[-i] [-v] [-n] [-r] <pattern> [file...]"],
-	run: ({ authUser, shell, cwd, args, stdin }) => {
-		const { flags, positionals } = parseArgs(args, {
-			flags: ["-i", "-v", "-n", "-r", "-c", "-l", "-L", "-q", "--quiet", "--silent"],
-		});
-		const caseInsensitive  = flags.has("-i");
-		const invertMatch      = flags.has("-v");
-		const showLineNumbers  = flags.has("-n");
-		const recursive        = flags.has("-r");
-		const countOnly        = flags.has("-c");
-		const filesWithMatches = flags.has("-l");
-		const quiet            = flags.has("-q") || flags.has("--quiet") || flags.has("--silent");
-		const pattern = positionals[0];
-		const files = positionals.slice(1);
-
-		if (!pattern) {
-			return { stderr: "grep: no pattern specified", exitCode: 1 };
-		}
-
-		let regex: RegExp;
-		try {
-			// No "g" flag — avoids the stateful lastIndex problem with regex.test()
-			const regexFlags = caseInsensitive ? "mi" : "m";
-			regex = new RegExp(pattern, regexFlags);
-		} catch {
-			return { stderr: `grep: invalid regex: ${pattern}`, exitCode: 1 };
-		}
-
-		const matchLines = (content: string, prefix = ""): string[] => {
-			const lines = content.split("\n");
-			const out: string[] = [];
-			for (let i = 0; i < lines.length; i++) {
-				const line = lines[i] ?? "";
-				const matches = regex.test(line);
-				const shouldInclude = invertMatch ? !matches : matches;
-				if (shouldInclude) {
-					const lineLabel = showLineNumbers ? `${i + 1}:` : "";
-					out.push(`${prefix}${lineLabel}${line}`);
-				}
-			}
-			return out;
-		};
-
-		const readPaths = (base: string): string[] => {
-			if (!shell.vfs.exists(base)) return [];
-			const stat = shell.vfs.stat(base);
-			if (stat.type === "file") return [base];
-			if (!recursive) return [];
-			const paths: string[] = [];
-			const walk = (dir: string) => {
-				for (const entry of shell.vfs.list(dir)) {
-					const full = `${dir}/${entry}`;
-					const s = shell.vfs.stat(full);
-					if (s.type === "file") paths.push(full);
-					else walk(full);
-				}
-			};
-			walk(base);
-			return paths;
-		};
-
-		const results: string[] = [];
-
-		if (files.length === 0) {
-			if (!stdin) return { stdout: "", exitCode: 1 };
-			const matched = matchLines(stdin);
-			if (countOnly) return { stdout: `${matched.length}\n`, exitCode: matched.length > 0 ? 0 : 1 };
-			if (quiet) return { exitCode: matched.length > 0 ? 0 : 1 };
-			results.push(...matched);
-		} else {
-			const resolvedPaths = files.flatMap((f) => {
-				const target = resolvePath(cwd, f);
-				return readPaths(target).map((p) => ({ file: f, path: p }));
-			});
-
-			for (const { file, path: filePath } of resolvedPaths) {
-				try {
-					assertPathAccess(authUser, filePath, "grep");
-					const content = shell.vfs.readFile(filePath);
-					const prefix = resolvedPaths.length > 1 ? `${file}:` : "";
-					const matched = matchLines(content, prefix);
-					if (countOnly) {
-						results.push(resolvedPaths.length > 1 ? `${file}:${matched.length}` : String(matched.length));
-					} else if (filesWithMatches) {
-						if (matched.length > 0) results.push(file);
-					} else {
-						results.push(...matched);
-					}
-				} catch {
-					return {
-						stderr: `grep: ${file}: No such file or directory`,
-						exitCode: 1,
-					};
-				}
-			}
-		}
-
-		return {
-			stdout: results.length > 0 ? `${results.join("\n")}\n` : "",
-			exitCode: results.length > 0 ? 0 : 1,
-		};
-	},
-};

package/src/commands/groups.ts

@@ -1,19 +0,0 @@
-import type { ShellModule } from "../types/commands";
-
-/**
- * Print group memberships for a user.
- * @category system
- * @params ["[user]"]
- */
-export const groupsCommand: ShellModule = {
-	name: "groups",
-	description: "Print group memberships",
-	category: "system",
-	params: ["[user]"],
-	run: ({ authUser, shell, args }) => {
-		const target = args[0] ?? authUser;
-		const isSudo = shell.users.isSudoer(target);
-		const grps = isSudo ? `${target} sudo root` : target;
-		return { stdout: grps, exitCode: 0 };
-	},
-};

package/src/commands/gzip.ts

@@ -1,88 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { resolvePath } from "./helpers";
-
-/**
- * Compress files using gzip — renames file to `<file>.gz`, removes original.
- * @category archive
- */
-export const gzipCommand: ShellModule = {
-	name: "gzip",
-	description: "Compress files",
-	category: "archive",
-	params: ["[-k] [-d] <file>"],
-	run: ({ shell, cwd, args }) => {
-		if (!shell.packageManager.isInstalled("gzip")) {
-			return {
-				stderr:
-					"bash: gzip: command not found\nHint: install it with: apt install gzip\n",
-				exitCode: 127,
-			};
-		}
-		const keepOrig = args.includes("-k") || args.includes("--keep");
-		const decompress = args.includes("-d");
-		const file = args.find((a) => !a.startsWith("-"));
-		if (!file) return { stderr: "gzip: no file specified\n", exitCode: 1 };
-
-		const p = resolvePath(cwd, file);
-
-		if (decompress) {
-			// gzip -d = gunzip
-			if (!file.endsWith(".gz")) {
-				return { stderr: `gzip: ${file}: unknown suffix -- ignored\n`, exitCode: 1 };
-			}
-			if (!shell.vfs.exists(p)) {
-				return { stderr: `gzip: ${file}: No such file or directory\n`, exitCode: 1 };
-			}
-			const content = shell.vfs.readFile(p);
-			const dest = p.slice(0, -3);
-			shell.vfs.writeFile(dest, content);
-			if (!keepOrig) shell.vfs.remove(p);
-			return { exitCode: 0 };
-		}
-
-		if (!shell.vfs.exists(p)) {
-			return { stderr: `gzip: ${file}: No such file or directory\n`, exitCode: 1 };
-		}
-		if (file.endsWith(".gz")) {
-			return { stderr: `gzip: ${file}: already has .gz suffix -- unchanged\n`, exitCode: 1 };
-		}
-
-		const rawContent = shell.vfs.readFileRaw(p);
-		const gzPath = `${p}.gz`;
-		shell.vfs.writeFile(gzPath, rawContent, { compress: true });
-		if (!keepOrig) shell.vfs.remove(p);
-		return { exitCode: 0 };
-	},
-};
-
-/**
- * Decompress gzip files — renames `<file>.gz` to `<file>`, removes original.
- * @category archive
- */
-export const gunzipCommand: ShellModule = {
-	name: "gunzip",
-	description: "Decompress files",
-	category: "archive",
-	aliases: ["zcat"],
-	params: ["[-k] <file>"],
-	run: ({ shell, cwd, args }) => {
-		const keepOrig = args.includes("-k") || args.includes("--keep");
-		const file = args.find((a) => !a.startsWith("-"));
-		if (!file) return { stderr: "gunzip: no file specified\n", exitCode: 1 };
-
-		const p = resolvePath(cwd, file);
-
-		if (!shell.vfs.exists(p)) {
-			return { stderr: `gunzip: ${file}: No such file or directory\n`, exitCode: 1 };
-		}
-		if (!file.endsWith(".gz")) {
-			return { stderr: `gunzip: ${file}: unknown suffix -- ignored\n`, exitCode: 1 };
-		}
-
-		const content = shell.vfs.readFile(p);
-		const dest = p.slice(0, -3);
-		shell.vfs.writeFile(dest, content);
-		if (!keepOrig) shell.vfs.remove(p);
-		return { exitCode: 0 };
-	},
-};

package/src/commands/head.ts

@@ -1,52 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { getFlag } from "./command-helpers";
-import { assertPathAccess, resolvePath } from "./helpers";
-
-/**
- * Output the first part of files or stdin (head).
- * @category text
- * @params ["[-n <lines>] [file...]"]
- */
-export const headCommand: ShellModule = {
-	name: "head",
-	description: "Output first lines",
-	category: "text",
-	params: ["[-n <lines>] [file...]"],
-	run: ({ authUser, shell, cwd, args, stdin }) => {
-		const nArg = getFlag(args, ["-n"]);
-		// Support both -n N and -N shorthand (head -2, head -10)
-		const shortN = args.find((a) => /^-\d+$/.test(a));
-		const n = typeof nArg === "string"
-			? parseInt(nArg, 10)
-			: shortN ? parseInt(shortN.slice(1), 10) : 10;
-		const positionals = args.filter(
-			(a) => !a.startsWith("-") && a !== nArg && a !== String(n),
-		);
-
-		const take = (content: string) => {
-			const lines = content.split("\n");
-			// Preserve trailing newline
-			const sliced = lines.slice(0, n);
-			return sliced.join("\n") + (content.endsWith("\n") && sliced.length === lines.slice(0, n).length ? "\n" : "");
-		};
-
-		if (positionals.length === 0) {
-			return { stdout: take(stdin ?? ""), exitCode: 0 };
-		}
-
-		const results: string[] = [];
-		for (const file of positionals) {
-			const filePath = resolvePath(cwd, file);
-			try {
-				assertPathAccess(authUser, filePath, "head");
-				results.push(take(shell.vfs.readFile(filePath)));
-			} catch {
-				return {
-					stderr: `head: ${file}: No such file or directory`,
-					exitCode: 1,
-				};
-			}
-		}
-		return { stdout: results.join("\n"), exitCode: 0 };
-	},
-};

package/src/commands/help.ts

@@ -1,152 +0,0 @@
-import type { ShellModule } from "../types/commands";
-import { getCommandModulesPublic } from "./registry";
-
-// ─── category config ──────────────────────────────────────────────────────────
-
-const CATEGORY_ORDER = [
-	"navigation",
-	"files",
-	"text",
-	"archive",
-	"system",
-	"package",
-	"network",
-	"shell",
-	"users",
-	"misc",
-];
-
-const CATEGORY_LABELS: Record<string, string> = {
-	navigation: "Navigation",
-	files: "Files & Filesystem",
-	text: "Text Processing",
-	archive: "Archive & Compression",
-	system: "System",
-	package: "Package Management",
-	network: "Network",
-	shell: "Shell & Scripting",
-	users: "Users & Permissions",
-	misc: "Miscellaneous",
-};
-
-// ─── formatting helpers ───────────────────────────────────────────────────────
-
-const BOLD = "\x1b[1m";
-const RESET = "\x1b[0m";
-const CYAN = "\x1b[36m";
-const YLW = "\x1b[33m";
-const DIM = "\x1b[2m";
-const GREEN = "\x1b[32m";
-
-function pad(s: string, n: number): string {
-	return s.length >= n ? s : s + " ".repeat(n - s.length);
-}
-
-function formatCmdLine(mod: ShellModule): string {
-	const aliases = mod.aliases?.length
-		? ` ${DIM}(${mod.aliases.join(", ")})${RESET}`
-		: "";
-	return `  ${CYAN}${pad(mod.name, 16)}${RESET}${aliases}${pad("", mod.aliases?.length ? 0 : 0)} ${mod.description ?? ""}`;
-}
-
-// ─── full grouped listing ─────────────────────────────────────────────────────
-
-function renderFull(modules: ShellModule[]): string {
-	const grouped: Record<string, ShellModule[]> = {};
-	for (const mod of modules) {
-		const cat = mod.category ?? "misc";
-		if (!grouped[cat]) grouped[cat] = [];
-		grouped[cat]!.push(mod);
-	}
-
-	const lines: string[] = [
-		`${BOLD}Available commands${RESET}`,
-		`${DIM}Type 'help <command>' for detailed usage.${RESET}`,
-		"",
-	];
-
-	const cats = [
-		...CATEGORY_ORDER.filter((c) => grouped[c]),
-		...Object.keys(grouped)
-			.filter((c) => !CATEGORY_ORDER.includes(c))
-			.sort(),
-	];
-
-	for (const cat of cats) {
-		const mods = grouped[cat];
-		if (!mods?.length) continue;
-
-		lines.push(`${YLW}${CATEGORY_LABELS[cat] ?? cat}${RESET}`);
-		const sorted = [...mods].sort((a, b) => a.name.localeCompare(b.name));
-		for (const mod of sorted) {
-			lines.push(formatCmdLine(mod));
-		}
-		lines.push("");
-	}
-
-	const total = modules.length;
-	lines.push(`${DIM}${total} commands available.${RESET}`);
-
-	return lines.join("\n");
-}
-
-// ─── single-command detail ────────────────────────────────────────────────────
-
-function renderDetail(mod: ShellModule): string {
-	const lines: string[] = [];
-
-	lines.push(
-		`${BOLD}${mod.name}${RESET} — ${mod.description ?? "no description"}`,
-	);
-
-	if (mod.aliases?.length) {
-		lines.push(`${DIM}Aliases: ${mod.aliases.join(", ")}${RESET}`);
-	}
-
-	lines.push("");
-	lines.push(`${GREEN}Usage:${RESET}`);
-	if (mod.params.length) {
-		for (const p of mod.params) {
-			lines.push(`  ${mod.name} ${p}`);
-		}
-	} else {
-		lines.push(`  ${mod.name}`);
-	}
-
-	const catLabel =
-		CATEGORY_LABELS[mod.category ?? "misc"] ?? mod.category ?? "misc";
-	lines.push("");
-	lines.push(`${DIM}Category: ${catLabel}${RESET}`);
-
-	return lines.join("\n");
-}
-
-// ─── export ───────────────────────────────────────────────────────────────────
-
-export function createHelpCommand(_getNames: () => string[]): ShellModule {
-	return {
-		name: "help",
-		description: "List all commands, or show usage for a specific command",
-		category: "shell",
-		params: ["[command]"],
-		run: ({ args }) => {
-			const modules = getCommandModulesPublic();
-
-			if (args[0]) {
-				const target = args[0].toLowerCase();
-				const mod = modules.find(
-					(m) => m.name === target || m.aliases?.includes(target),
-				);
-				if (!mod) {
-					return {
-						stderr: `help: no help entry for '${args[0]}'`,
-						exitCode: 1,
-					};
-				}
-				return { stdout: renderDetail(mod), exitCode: 0 };
-			}
-
-			return { stdout: renderFull(modules), exitCode: 0 };
-		},
-	};
-}