typescript-virtual-container 1.1.4 → 1.1.6

package/src/VirtualFileSystem/index.ts

@@ -1,3 +1,4 @@
+import { EventEmitter } from "node:events";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { gunzipSync, gzipSync } from "node:zlib";
@@ -15,7 +16,7 @@ import { normalizePath } from "./path";
  * {@link VirtualFileSystem.restoreMirror} on startup and
  * {@link VirtualFileSystem.flushMirror} to persist pending changes.
  */
-class VirtualFileSystem {
+class VirtualFileSystem extends EventEmitter {
 	private readonly mirrorRoot: string;
 
 	private ensureMirrorRoot(): void {
@@ -93,6 +94,7 @@ class VirtualFileSystem {
 	 * @param baseDir Base directory used to resolve mirror archive location.
 	 */
 	constructor(baseDir: string = process.cwd()) {
+		super();
 		this.mirrorRoot = path.resolve(baseDir, ".vfs", "mirror");
 	}
 
@@ -112,6 +114,7 @@ class VirtualFileSystem {
 	 */
 	public async flushMirror(): Promise<void> {
 		this.ensureMirrorRoot();
+		this.emit("mirror:flush");
 	}
 
 	/**
@@ -129,6 +132,7 @@ class VirtualFileSystem {
 			);
 		}
 		fs.mkdirSync(fsPath, { recursive: true, mode });
+		this.emit("dir:create", { path: normalizePath(targetPath), mode });
 	}
 
 	/**
@@ -165,6 +169,7 @@ class VirtualFileSystem {
 
 		fs.writeFileSync(fsPath, storedContent);
 		fs.chmodSync(fsPath, options.mode ?? 0o644);
+		this.emit("file:write", { path: normalized, size: storedContent.length });
 	}
 
 	/**
@@ -184,6 +189,8 @@ class VirtualFileSystem {
 
 		const stored = fs.readFileSync(fsPath);
 		const raw = this.detectGzipFile(fsPath) ? gunzipSync(stored) : stored;
+		const normalized = normalizePath(targetPath);
+		this.emit("file:read", { path: normalized, size: raw.length });
 		return raw.toString("utf8");
 	}
 

package/src/VirtualShell/index.ts

@@ -1,4 +1,5 @@
 import { randomBytes } from "node:crypto";
+import { EventEmitter } from "node:events";
 import { createCustomCommand, registerCommand, runCommand } from "../commands";
 import type { CommandContext, CommandResult } from "../types/commands";
 import type { ShellStream } from "../types/streams";
@@ -46,7 +47,7 @@ function resolveAutoSudoForNewUsers(): boolean {
  * Instances are used both by the SSH server facade and by the programmatic
  * client API.
  */
-class VirtualShell {
+class VirtualShell extends EventEmitter {
 	basePath: string = ".";
 	vfs: VirtualFileSystem;
 	users: VirtualUserManager;
@@ -66,6 +67,7 @@ class VirtualShell {
 		properties?: ShellProperties,
 		basePath?: string,
 	) {
+		super();
 		this.hostname = hostname;
 		this.properties = properties || defaultShellProperties;
 		this.basePath = basePath || ".";
@@ -84,6 +86,7 @@ class VirtualShell {
 		this.initialized = (async () => {
 			await vfs.restoreMirror();
 			await users.initialize();
+			this.emit("initialized");
 		})();
 	}
 
@@ -124,6 +127,7 @@ class VirtualShell {
 	 */
 	executeCommand(rawInput: string, authUser: string, cwd: string): void {
 		runCommand(rawInput, authUser, this.hostname, "shell", cwd, this);
+		this.emit("command", { command: rawInput, user: authUser, cwd });
 	}
 
 	/**
@@ -143,6 +147,7 @@ class VirtualShell {
 		terminalSize: { cols: number; rows: number },
 	): void {
 		// Interactive shell logic
+		this.emit("session:start", { user: authUser, sessionId, remoteAddress });
 		startShell(
 			this.properties,
 			stream,

package/src/VirtualUserManager/index.ts

@@ -1,4 +1,5 @@
 import { randomBytes, randomUUID, scryptSync } from "node:crypto";
+import { EventEmitter } from "node:events";
 import * as path from "node:path";
 import type VirtualFileSystem from "../VirtualFileSystem";
 
@@ -31,7 +32,7 @@ export interface VirtualActiveSession {
  *
  * Passwords are hashed with scrypt and stored in the backing virtual filesystem.
  */
-export class VirtualUserManager {
+export class VirtualUserManager extends EventEmitter {
 	private readonly usersPath = "/virtual-env-js/.auth/htpasswd";
 	private readonly sudoersPath = "/virtual-env-js/.auth/sudoers";
 	private readonly quotasPath = "/virtual-env-js/.auth/quotas";
@@ -53,7 +54,9 @@ export class VirtualUserManager {
 		private readonly vfs: VirtualFileSystem,
 		private readonly defaultRootPassword: string = "root",
 		private readonly autoSudoForNewUsers: boolean = true,
-	) {}
+	) {
+		super();
+	}
 
 	/**
 	 * Loads users/sudoers from disk and ensures root account exists.
@@ -88,6 +91,7 @@ export class VirtualUserManager {
 		}
 
 		await this.persist();
+		this.emit("initialized");
 	}
 
 	/**
@@ -240,6 +244,7 @@ export class VirtualUserManager {
 			);
 		}
 		await this.persist();
+		this.emit("user:add", { username });
 	}
 
 	/**
@@ -278,6 +283,7 @@ export class VirtualUserManager {
 
 		this.sudoers.delete(username);
 
+		this.emit("user:delete", { username });
 		await this.persist();
 	}
 
@@ -339,8 +345,12 @@ export class VirtualUserManager {
 			remoteAddress,
 			startedAt: new Date().toISOString(),
 		};
-
 		this.activeSessions.set(session.id, session);
+		this.emit("session:register", {
+			sessionId: session.id,
+			username,
+			remoteAddress,
+		});
 		return session;
 	}
 
@@ -354,6 +364,14 @@ export class VirtualUserManager {
 			return;
 		}
 
+		const session = this.activeSessions.get(sessionId);
+		this.activeSessions.delete(sessionId);
+		if (session) {
+			this.emit("session:unregister", {
+				sessionId,
+				username: session.username,
+			});
+		}
 		this.activeSessions.delete(sessionId);
 	}
 

package/src/index.ts

@@ -1,9 +1,14 @@
+import { HoneyPot } from "./Honeypot";
 import { SshClient } from "./SSHClient";
 import { SftpMimic, SshMimic } from "./SSHMimic/index";
 import VirtualFileSystem from "./VirtualFileSystem";
 import { VirtualShell } from "./VirtualShell";
 import { VirtualUserManager } from "./VirtualUserManager";
 
+export type {
+	AuditLogEntry,
+	HoneyPotStats,
+} from "./Honeypot";
 export type {
 	CommandContext,
 	CommandMode,
@@ -30,6 +35,7 @@ export type {
 } from "./types/vfs";
 
 export {
+	HoneyPot,
 	SshClient,
 	VirtualFileSystem,
 	SftpMimic as VirtualSftpServer,