typescript-virtual-container 1.5.2 → 1.5.4

package/examples/app.ts

@@ -1,299 +0,0 @@
-/** biome-ignore-all lint/suspicious/noControlCharactersInRegex: need to parse ANSI */
-import { getCommandNames } from '../src/commands/registry.js';
-import { makeDefaultEnv, runCommand, userHome } from '../src/commands/runtime.js';
-import { VirtualShell } from '../src/index.js';
-import { resolvePath } from '../src/modules/shellRuntime.js';
-import { type LoginBannerState, buildLoginBanner } from '../src/SSHMimic/loginBanner.js';
-import { buildPrompt } from '../src/SSHMimic/prompt.js';
-import type { CommandResult } from '../src/types/commands.js';
-
-const HOSTNAME = 'my-vm';
-const MAX_HISTORY = 500;
-
-const terminal = document.getElementById('terminal') as HTMLElement;
-const out = document.getElementById('output') as HTMLElement;
-const cmd = document.getElementById('cmd') as HTMLInputElement;
-
-function scrollToBottom(): void {
-  terminal.scrollTop = terminal.scrollHeight;
-}
-
-cmd.focus();
-document.addEventListener('click', () => {
-  if (!window.getSelection()?.toString()) cmd.focus();
-});
-
-// ANSI to HTML
-const FG_COLORS: Record<number, string> = {
-  30: '#000', 31: '#c00', 32: '#0c0', 33: '#cc0',
-  34: '#00c', 35: '#c0c', 36: '#0cc', 37: '#ccc',
-  90: '#555', 91: '#f55', 92: '#5f5', 93: '#ff5',
-  94: '#55f', 95: '#f5f', 96: '#5ff', 97: '#fff',
-};
-const BG_COLORS: Record<number, string> = {
-  40: '#000', 41: '#c00', 42: '#0c0', 43: '#cc0',
-  44: '#00c', 45: '#c0c', 46: '#0cc', 47: '#ccc',
-};
-
-function ansiToHtml(s: string): string {
-  let html = '';
-  let bold = false, fg = '', bg = '';
-  for (const part of s.split(/(\x1b\[[0-9;]*m)/)) {
-    const m = part.match(/^\x1b\[([0-9;]*)m$/);
-    if (m) {
-      for (const code of m[1].split(';').map(Number)) {
-        if (code === 0) { bold = false; fg = ''; bg = ''; }
-        else if (code === 1) bold = true;
-        else if (FG_COLORS[code]) fg = FG_COLORS[code];
-        else if (BG_COLORS[code]) bg = BG_COLORS[code];
-      }
-    } else if (part) {
-      const style = [
-        fg ? `color:${fg}` : '',
-        bg ? `background:${bg}` : '',
-        bold ? 'font-weight:bold' : '',
-      ].filter(Boolean).join(';');
-      const escaped = part.replace(/&/g, '&amp;').replace(/</g, '&lt;');
-      html += style ? `<span style="${style}">${escaped}</span>` : escaped;
-    }
-  }
-  return html;
-}
-
-// All output goes into a single <span> appended to #output.
-// #output is pre-wrap so \n = newline, no extra divs needed.
-function print(s: string): void {
-  const span = document.createElement('span');
-  span.innerHTML = ansiToHtml(s);
-  if (inputLineEl) {
-    out.insertBefore(span, inputLineEl);
-  } else {
-    out.appendChild(span);
-  }
-  scrollToBottom();
-}
-
-// Live input line — sits at bottom of #output as an inline element
-let inputLineEl: HTMLSpanElement | null = null;
-
-function printPrompt(): void {
-  if (inputLineEl) { inputLineEl.remove(); inputLineEl = null; }
-  cmd.value = '';
-
-  inputLineEl = document.createElement('span');
-  inputLineEl.className = 'input-line';
-
-  const promptSpan = document.createElement('span');
-  const cwdLabel = cwd === userHome(authUser) ? '~' : (cwd.split('/').at(-1) || '/');
-  promptSpan.innerHTML = ansiToHtml(buildPrompt(authUser, HOSTNAME, cwdLabel));
-
-  const textSpan = document.createElement('span');
-  textSpan.className = 'typed';
-
-  const cursor = document.createElement('span');
-  cursor.className = 'cursor';
-  cursor.textContent = '\u00a0';
-
-  inputLineEl.appendChild(promptSpan);
-  inputLineEl.appendChild(textSpan);
-  inputLineEl.appendChild(cursor);
-  out.appendChild(inputLineEl);
-  scrollToBottom();
-}
-
-cmd.addEventListener('input', () => {
-  if (!inputLineEl) return;
-  (inputLineEl.querySelector('.typed') as HTMLSpanElement).textContent = cmd.value;
-  scrollToBottom();
-});
-
-// Wait for IndexedDB fs shim memCache
-// biome-ignore lint/suspicious/noExplicitAny: globalThis shim
-await (globalThis as any).__fsReady__;
-
-const shell = new VirtualShell(HOSTNAME, undefined, {
-  mode: 'fs',
-  snapshotPath: '/vfs-data',
-  flushIntervalMs: 10_000,
-});
-
-const vfs = shell.vfs;
-
-await vfs.restoreMirror();
-
-const isFirstRun = !vfs.exists('/bin');
-if (isFirstRun) {
-  await shell.ensureInitialized();
-  if (!vfs.exists('/root')) vfs.mkdir('/root', 0o700);
-  vfs.writeFile('/root/README.txt', `Welcome to ${HOSTNAME}\n`);
-  await vfs.flushMirror();
-}
-
-window.addEventListener('beforeunload', () => { vfs.flushMirror(); });
-
-// Session state
-let authUser = 'root';
-let cwd = userHome(authUser);
-const shellEnv = makeDefaultEnv(authUser, HOSTNAME);
-shellEnv.vars.PWD = cwd;
-
-function applyResult(result: CommandResult): void {
-  if (result.switchUser) {
-    authUser = result.switchUser;
-    cwd = result.nextCwd ?? userHome(authUser);
-    shellEnv.vars.USER = authUser;
-    shellEnv.vars.LOGNAME = authUser;
-    shellEnv.vars.HOME = userHome(authUser);
-    shellEnv.vars.PWD = cwd;
-  } else if (result.nextCwd) {
-    cwd = result.nextCwd;
-    shellEnv.vars.PWD = cwd;
-  }
-}
-
-// History
-function historyPath(): string { return `${userHome(authUser)}/.bash_history`; }
-
-function loadHistory(): string[] {
-  try {
-    if (!vfs.exists(historyPath())) return [];
-    return (vfs.readFile(historyPath()) as string)
-      .split('\n').map((l: string) => l.trim()).filter((l: string) => l.length > 0);
-  } catch { return []; }
-}
-
-function saveHistory(): void {
-  vfs.writeFile(historyPath(), history.length > 0 ? `${history.join('\n')}\n` : '');
-}
-
-let history: string[] = loadHistory();
-let historyIdx = -1;
-
-// Login banner + lastlog
-function readLastLogin(): LoginBannerState | null {
-  try {
-    if (!vfs.exists('/root/.lastlog')) return null;
-    return JSON.parse(vfs.readFile('/root/.lastlog'));
-  } catch { return null; }
-}
-
-function writeLastLogin(): void {
-  vfs.writeFile('/root/.lastlog', JSON.stringify({ at: new Date().toISOString(), from: 'browser' }));
-}
-
-print(buildLoginBanner(HOSTNAME, shell.properties, readLastLogin()));
-writeLastLogin();
-await vfs.flushMirror();
-printPrompt();
-
-
-// Tab completion
-function listPathCompletions(prefix: string): string[] {
-  const slashIndex = prefix.lastIndexOf('/');
-  const dirPart  = slashIndex >= 0 ? prefix.slice(0, slashIndex + 1) : '';
-  const namePart = slashIndex >= 0 ? prefix.slice(slashIndex + 1)    : prefix;
-  const basePath = resolvePath(cwd, dirPart || '.');
-  try {
-    return vfs.list(basePath)
-      .filter((e: string) => !e.startsWith('.') && e.startsWith(namePart))
-      .map((e: string) => {
-        const fullPath = `${basePath}/${e}`.replace(/\/+/g, '/');
-        const st = vfs.stat(fullPath);
-        return `${dirPart}${e}${st.type === 'directory' ? '/' : ''}`;
-      })
-      .sort();
-  } catch { return []; }
-}
-
-const commandNames = Array.from(new Set(getCommandNames())).sort();
-
-function getCompletions(line: string): [string[], string] {
-  const token = line.split(/\s+/).at(-1) ?? '';
-  const isFirstToken = line.trimStart() === token;
-  const cmdHits  = isFirstToken ? commandNames.filter(n => n.startsWith(token)) : [];
-  const pathHits = listPathCompletions(token);
-  const hits = Array.from(new Set([...cmdHits, ...pathHits])).sort();
-  return [hits, token];
-}
-
-// Input handler
-cmd.addEventListener('keydown', async (e: KeyboardEvent) => {
-  if (e.key === 'Tab') {
-    e.preventDefault();
-    const line = cmd.value;
-    const [hits, token] = getCompletions(line);
-    if (hits.length === 0) return;
-    if (hits.length === 1) {
-      // Unique match — complete inline
-      cmd.value = line.slice(0, line.length - token.length) + hits[0];
-      if (inputLineEl) (inputLineEl.querySelector('.typed') as HTMLSpanElement).textContent = cmd.value;
-    } else {
-      // Multiple matches — print them below current line, re-prompt
-      const prevLine = inputLineEl;
-      inputLineEl = null;
-      prevLine?.querySelector('.cursor')?.remove();
-      out.appendChild(document.createTextNode('\n'));
-      print(`${hits.join('  ')}
-`);
-      printPrompt();
-      cmd.value = line;
-      if (inputLineEl) ((inputLineEl as HTMLSpanElement).querySelector('.typed') as HTMLSpanElement).textContent = cmd.value;
-    }
-    return;
-  }
-
-  if (e.key === 'ArrowUp') {
-    e.preventDefault();
-    if (historyIdx < history.length - 1) {
-      historyIdx++;
-      cmd.value = history[history.length - 1 - historyIdx];
-      if (inputLineEl) (inputLineEl.querySelector('.typed') as HTMLSpanElement).textContent = cmd.value;
-    }
-    return;
-  }
-
-  if (e.key === 'ArrowDown') {
-    e.preventDefault();
-    if (historyIdx > 0) { historyIdx--; cmd.value = history[history.length - 1 - historyIdx]; }
-    else { historyIdx = -1; cmd.value = ''; }
-    if (inputLineEl) (inputLineEl.querySelector('.typed') as HTMLSpanElement).textContent = cmd.value;
-    return;
-  }
-
-  if (e.key !== 'Enter') return;
-
-  const value = cmd.value.trim();
-  historyIdx = -1;
-
-  // Freeze input line: remove cursor span, null the ref (keeps prompt+typed in DOM)
-  if (inputLineEl) {
-    inputLineEl.querySelector('.cursor')?.remove();
-    inputLineEl = null;
-  }
-
-  // Newline after the frozen line
-  out.appendChild(document.createTextNode('\n'));
-
-  if (value) {
-    history.push(value);
-    if (history.length > MAX_HISTORY) history = history.slice(history.length - MAX_HISTORY);
-    saveHistory();
-  }
-
-  try {
-    const result = await runCommand(value, authUser, HOSTNAME, 'shell', cwd, shell, undefined, shellEnv);
-
-    if (result.clearScreen) out.innerHTML = '';
-    if (result.stdout) print(`${result.stdout.trim()}\n`);
-    if (result.stderr) print(`${result.stderr.trim()}\n`);
-
-    applyResult(result);
-    await vfs.flushMirror();
-
-    if (result.closeSession) { print('\nSession closed.\n'); return; }
-  } catch (err) {
-    print(`${String(err)}\n`);
-  }
-
-  printPrompt();
-});

package/examples/build.js

@@ -1,27 +0,0 @@
-import esbuild from 'esbuild';
-
-const ctx = await esbuild.context({
-    entryPoints: ['app.ts'],
-    bundle: true,
-    format: 'esm',
-    outfile: `app.js`,
-    platform: 'browser',
-    alias: {
-        'node:events': '../polyfills/node_events/index.js',
-        'node:path': '../polyfills/node_path/index.js',
-        'node:os': '../polyfills/node_os/index.js',
-        'node:fs': '../polyfills/node_fs/index.js',
-        'node:fs/promises': '../polyfills/node_fs/promises.js',
-        'node:crypto': '../polyfills/node_crypto/index.js',
-        'node:child_process': '../polyfills/node_child_process/index.js',
-        'node:zlib': '../polyfills/node_zlib/index.js',
-        'node:vm': '../polyfills/node_vm/index.js',
-        'ssh2': '../polyfills/ssh2/index.js',
-    },
-    minify: true,
-    treeShaking: true,
-    inject: ['../polyfills/process.js', '../polyfills/buffer.js'],
-});
-
-await ctx.watch();
-console.log('watching...');

package/examples/demo.html

@@ -1,33 +0,0 @@
-    <!DOCTYPE html>
-    <html lang="en">
-        <head>
-            <meta charset="UTF-8">
-            <meta name="viewport" content="width=device-width, initial-scale=1.0">
-            <title>Virtual Env JS</title>
-            <script type="module">
-                import { VirtualShell, VirtualFileSystem } from '../builds/fortune-nyx-v1.5.2-web.min.js';
-
-                const now1 = new Date();
-                const ready = await globalThis.__fsReady__;
-                window.ready = ready; // Expose for debugging
-                const now2 = new Date();
-                console.log(`IndexedDB VFS ready in ${now2 - now1}ms`);
-                const shell = new VirtualShell('my-vm', undefined, {
-                    mode: 'fs',
-                    snapshotPath: '/vfs-data',
-                    flushIntervalMs: 10_000,
-                });
-
-                window.addEventListener('beforeunload', () => {
-                    shell.vfs.flushMirror();
-                });
-
-                window.shell = shell; // Expose shell for debugging
-                const result = await shell.executeCommand("ls -l", "root", "/root");
-                await shell.vfs.flushMirror()
-                console.log(shell.vfs.getMode());
-            </script>
-        </head>
-        <body>
-        </body>
-    </html>

package/examples/honeypot-audit.ts

@@ -1,180 +0,0 @@
-/**
- * HoneyPot Auditing Example
- *
- * Demonstrates how to use the HoneyPot utility to track all activity
- * in a virtual environment, collect statistics, and detect anomalies.
- *
- * Run with: bun run examples/honeypot-audit.ts
- */
-
-import {
-    HoneyPot,
-    SshClient,
-    VirtualShell,
-    VirtualSshServer,
-} from "../src/index";
-
-async function demonstrateHoneypot() {
-	console.log("🍯 HoneyPot Auditing Example\n");
-
-	// Initialize the virtual environment
-	const shell = new VirtualShell("security-lab");
-	const ssh = new VirtualSshServer({ port: 2222, shell });
-	await ssh.start();
-
-	const users = shell.getUsers()!;
-	const vfs = shell.getVfs()!;
-
-	// Create HoneyPot instance with 1000-entry log limit
-	const honeypot = new HoneyPot(1000);
-
-	// Attach HoneyPot to all components
-	honeypot.attach(shell, vfs, users, ssh);
-
-	console.log("✅ HoneyPot attached to all components\n");
-
-	// ------ Scenario 1: Normal user activity ------
-	console.log("--- Scenario 1: Normal User Activity ---\n");
-
-	await users.addUser("alice", "alice_pass123");
-	await users.addUser("bob", "bob_pass456");
-
-	const alice = new SshClient(shell, "alice");
-	await alice.mkdir("/home/alice/work", true);
-	await alice.writeFile("/home/alice/work/notes.txt", "Project notes");
-	await alice.ls("/home/alice/work");
-	await alice.cat("/home/alice/work/notes.txt");
-
-	console.log("✓ Alice performed normal operations\n");
-
-	// ------ Scenario 2: Bob attempts suspicious operations ------
-	console.log("--- Scenario 2: Suspicious Attempt ---\n");
-
-	const bob = new SshClient(shell, "bob");
-	// These will fail but are tracked
-	await bob.readFile("/etc/shadow");
-	await bob.readFile("/etc/passwd");
-	await bob.readFile("/root/.ssh/id_rsa");
-
-	console.log("✓ Bob attempted unauthorized file access\n");
-
-	// ------ Activity Summary ------
-	console.log("--- Activity Summary ---\n");
-
-	const stats = honeypot.getStats();
-	console.log("📊 Audit Statistics:");
-	console.log(`  • Auth attempts: ${stats.authAttempts}`);
-	console.log(`  • Auth successes: ${stats.authSuccesses}`);
-	console.log(`  • Auth failures: ${stats.authFailures}`);
-	console.log(`  • Commands executed: ${stats.commands}`);
-	console.log(`  • File reads: ${stats.fileReads}`);
-	console.log(`  • File writes: ${stats.fileWrites}`);
-	console.log(`  • Users created: ${stats.userCreated}`);
-	console.log(`  • Sessions started: ${stats.sessionStarts}\n`);
-
-	// ------ Recent Events ------
-	console.log("--- Most Recent Events ---\n");
-
-	const recent = honeypot.getRecent(10);
-	console.log(`📋 Last ${recent.length} events:\n`);
-	recent.forEach((entry) => {
-		console.log(`  [${entry.timestamp}]`);
-		console.log(`  Source: ${entry.source}`);
-		console.log(`  Event: ${entry.type}`);
-		console.log(`  Details: ${JSON.stringify(entry.details)}\n`);
-	});
-
-	// ------ Filtered Audit Log ------
-	console.log("--- Filtered Audit Log ---\n");
-
-	const authFailures = honeypot.getAuditLog("auth:failure");
-	console.log(`🚨 Auth Failures (${authFailures.length} total):\n`);
-	if (authFailures.length > 0) {
-		authFailures.forEach((entry) => {
-			console.log(
-				`  • User "${entry.details.username}" from ${entry.details.remoteAddress}`,
-			);
-		});
-	} else {
-		console.log("  • None detected");
-	}
-	console.log();
-
-	// ------ SSH-specific events ------
-	console.log("--- SSH-Specific Events ---\n");
-
-	const sshEvents = honeypot.getAuditLog(undefined, "SshMimic");
-	console.log(`🔗 SSH events (${sshEvents.length} total):\n`);
-	sshEvents.forEach((entry) => {
-		console.log(`  • ${entry.type}: ${JSON.stringify(entry.details)}`);
-	});
-	console.log();
-
-	// ------ File System Activity ------
-	console.log("--- File System Activity ---\n");
-
-	const fileWrites = honeypot.getAuditLog("file:write", "VirtualFileSystem");
-	const fileReads = honeypot.getAuditLog("file:read", "VirtualFileSystem");
-
-	console.log(`📁 File Operations:`);
-	console.log(`  • File writes: ${fileWrites.length}`);
-	fileWrites.forEach((entry) => {
-		console.log(`    - ${entry.details.path} (${entry.details.size} bytes)`);
-	});
-	console.log(`  • File reads: ${fileReads.length}`);
-	fileReads.forEach((entry) => {
-		console.log(`    - ${entry.details.path} (${entry.details.size} bytes)`);
-	});
-	console.log();
-
-	// ------ Anomaly Detection ------
-	console.log("--- Security Analysis ---\n");
-
-	const anomalies = honeypot.detectAnomalies();
-	if (anomalies.length > 0) {
-		console.log("⚠️  Anomalies Detected:\n");
-		anomalies.forEach((anomaly) => {
-			const severity = {
-				low: "ℹ️ ",
-				medium: "⚠️ ",
-				high: "🚨",
-			}[anomaly.severity];
-			console.log(`  ${severity} [${anomaly.type}]`);
-			console.log(`     ${anomaly.message}\n`);
-		});
-	} else {
-		console.log("✅ No anomalies detected\n");
-	}
-
-	// ------ Export Audit Log ------
-	console.log("--- Full Audit Export ---\n");
-
-	const allAuditEntries = honeypot.getAuditLog();
-	console.log(`📊 Total audit entries: ${allAuditEntries.length}`);
-	console.log(`💾 Audit log is ready for export/storage\n`);
-
-	// Example export to JSON
-	const exportData = {
-		timestamp: new Date().toISOString(),
-		environment: "security-lab",
-		stats,
-		auditLog: allAuditEntries.slice(-50), // Last 50 entries
-		anomalies,
-	};
-
-	console.log("📄 Sample export structure:");
-	console.log(`${JSON.stringify(exportData, null, 2).substring(0, 300)}...\n`);
-
-	// Cleanup
-	ssh.stop();
-
-	console.log(
-		"✅ Example completed! HoneyPot auditing demonstration finished.\n",
-	);
-}
-
-// Run the example
-demonstrateHoneypot().catch((error) => {
-	console.error("❌ Error:", error);
-	process.exit(1);
-});