typescript-virtual-container 1.1.7 → 1.2.1

package/benchmark-results.txt

@@ -0,0 +1,40 @@
+Benchmarking VirtualShell concurrency:
+
+Running 1 shells...
+  Initialized 1 shells in 86ms, RSS 82 MB
+  Executed shell commands in 2ms, RSS now 82 MB (+0 MB)
+
+Running 2 shells...
+  Initialized 2 shells in 2ms, RSS 82 MB
+  Executed shell commands in 1ms, RSS now 82 MB (+0 MB)
+
+Running 5 shells...
+  Initialized 5 shells in 5ms, RSS 82 MB
+  Executed shell commands in 2ms, RSS now 82 MB (+0 MB)
+
+Running 10 shells...
+  Initialized 10 shells in 5ms, RSS 84 MB
+  Executed shell commands in 3ms, RSS now 84 MB (+1 MB)
+
+Running 20 shells...
+  Initialized 20 shells in 12ms, RSS 84 MB
+  Executed shell commands in 6ms, RSS now 85 MB (+1 MB)
+
+Running 50 shells...
+  Initialized 50 shells in 30ms, RSS 87 MB
+  Executed shell commands in 12ms, RSS now 88 MB (+2 MB)
+
+Running 100 shells...
+  Initialized 100 shells in 52ms, RSS 91 MB
+  Executed shell commands in 28ms, RSS now 92 MB (+2 MB)
+
+Summary:
+
+count   init_ms cmd_ms  init_rss        final_rss
+1       86      2       82 MB   82 MB   0 MB
+2       2       1       82 MB   82 MB   0 MB
+5       5       2       82 MB   82 MB   0 MB
+10      5       3       84 MB   84 MB   1 MB
+20      12      6       84 MB   85 MB   1 MB
+50      30      12      87 MB   88 MB   2 MB
+100     52      28      91 MB   92 MB   2 MB

package/benchmark-virtualshell.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env bun
+
+import { mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { VirtualShell } from "./src/index.ts";
+
+const counts = [1, 2, 5, 10, 20, 50, 100];
+const rootBenchmarkPath = join(process.cwd(), ".benchmark-shells");
+
+function bytesToMb(bytes: number): string {
+	return `${Math.round(bytes / 1024 / 1024)} MB`;
+}
+
+async function createShell(baseName: string, index: number): Promise<VirtualShell> {
+	const basePath = join(rootBenchmarkPath, `${baseName}-${index}`);
+	mkdirSync(basePath, { recursive: true });
+	const shell = new VirtualShell(`${baseName}-${index}`, undefined, basePath);
+	await shell.ensureInitialized();
+	return shell;
+}
+
+async function runSingleBenchmark(count: number) {
+	const label = `shells-${count}`;
+	const start = Date.now();
+	const shells: VirtualShell[] = await Promise.all(
+		Array.from({ length: count }, (_, index) => createShell(label, index)),
+	);
+	const initMs = Date.now() - start;
+	const initRss = process.memoryUsage().rss;
+
+	const commandStart = Date.now();
+	await Promise.all(
+		shells.map(async (shell, index) => {
+			const cwd = "/home/root";
+			shell.executeCommand(`mkdir -p /tmp/benchmark-${index}`, "root", cwd);
+			shell.executeCommand(
+				`echo "hello ${index}" > /tmp/benchmark-${index}/result.txt`,
+				"root",
+				cwd,
+			);
+			shell.executeCommand(
+				`cat /tmp/benchmark-${index}/result.txt`,
+				"root",
+				cwd,
+			);
+		}),
+	);
+	const commandMs = Date.now() - commandStart;
+	const finalRss = process.memoryUsage().rss;
+
+	return {
+		count,
+		initMs,
+		commandMs,
+		initRss,
+		finalRss,
+		deltaRss: finalRss - initRss,
+	};
+}
+
+async function main() {
+	rmSync(rootBenchmarkPath, { recursive: true, force: true });
+	mkdirSync(rootBenchmarkPath, { recursive: true });
+
+	console.log("Benchmarking VirtualShell concurrency:\n");
+	const results = [];
+	for (const count of counts) {
+		console.log(`Running ${count} shells...`);
+		const result = await runSingleBenchmark(count);
+		results.push(result);
+		console.log(
+			`  Initialized ${count} shells in ${result.initMs}ms, RSS ${bytesToMb(result.initRss)}`,
+		);
+		console.log(
+			`  Executed shell commands in ${result.commandMs}ms, RSS now ${bytesToMb(result.finalRss)} (+${bytesToMb(result.deltaRss)})`,
+		);
+		console.log("");
+	}
+
+	console.log("Summary:\n");
+	console.log(
+		"count\tinit_ms\tcmd_ms\tinit_rss\tfinal_rss\tdelta_rss",
+	);
+	for (const row of results) {
+		console.log(
+			`${row.count}\t${row.initMs}\t${row.commandMs}\t${bytesToMb(row.initRss)}\t${bytesToMb(row.finalRss)}\t${bytesToMb(row.deltaRss)}`,
+		);
+	}
+
+	console.log(`\nBenchmark data stored under ${rootBenchmarkPath}`);
+}
+
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});

package/dist/Honeypot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Honeypot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAaX;IAEF,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;gBACS,UAAU,GAAE,MAAc;IAItC;;;;;;;;OAQG;IACI,MAAM,CACZ,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,SAAS,GACd,IAAI;IAYP;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkChC;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;IAuBX;;;;;;OAMG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAOnE;;;;OAIG;IACI,QAAQ,IAAI,QAAQ,CAAC,aAAa,CAAC;IAI1C;;OAEG;IACI,KAAK,IAAI,IAAI;IAkBpB;;;;;OAKG;IACI,SAAS,CAAC,KAAK,GAAE,MAAY,GAAG,aAAa,EAAE;IAItD;;;;OAIG;IACI,eAAe,IAAI,KAAK,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CAkDF;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Honeypot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;GAKG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAaX;IAEF,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;gBACS,UAAU,GAAE,MAAc;IAKtC;;;;;;;;OAQG;IACI,MAAM,CACZ,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,SAAS,GACd,IAAI;IAaP;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkChC;;OAEG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG;IAuBX;;;;;;OAMG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAQnE;;;;OAIG;IACI,QAAQ,IAAI,QAAQ,CAAC,aAAa,CAAC;IAK1C;;OAEG;IACI,KAAK,IAAI,IAAI;IAmBpB;;;;;OAKG;IACI,SAAS,CAAC,KAAK,GAAE,MAAY,GAAG,aAAa,EAAE;IAKtD;;;;OAIG;IACI,eAAe,IAAI,KAAK,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CAmDF;AAED,eAAe,QAAQ,CAAC"}

package/dist/Honeypot/index.js

@@ -7,6 +7,8 @@
  *
  * @module honeypot
  */
+import { createPerfLogger } from "../utils/perfLogger";
+const perf = createPerfLogger("HoneyPot");
 /**
  * HoneyPot audit and event tracking utility.
  *
@@ -36,6 +38,7 @@ export class HoneyPot {
      * @param maxLogSize Maximum audit log entries to retain (default: 10000).
      */
     constructor(maxLogSize = 10000) {
+        perf.mark("constructor");
         this.maxLogSize = maxLogSize;
     }
     /**
@@ -48,6 +51,7 @@ export class HoneyPot {
      * @param sftp SftpMimic instance (optional).
      */
     attach(shell, vfs, users, ssh, sftp) {
+        perf.mark("attach");
         this.attachVirtualShell(shell);
         this.attachVirtualFileSystem(vfs);
         this.attachVirtualUserManager(users);
@@ -204,6 +208,7 @@ export class HoneyPot {
      * @returns Filtered audit log entries.
      */
     getAuditLog(type, source) {
+        perf.mark("getAuditLog");
         return this.auditLog.filter((entry) => (!type || entry.type === type) && (!source || entry.source === source));
     }
     /**
@@ -212,12 +217,14 @@ export class HoneyPot {
      * @returns Snapshot of honeypot stats.
      */
     getStats() {
+        perf.mark("getStats");
         return Object.freeze({ ...this.stats });
     }
     /**
      * Clears audit log and resets statistics.
      */
     reset() {
+        perf.mark("reset");
         this.auditLog = [];
         this.stats = {
             authAttempts: 0,
@@ -241,6 +248,7 @@ export class HoneyPot {
      * @returns Recent audit log entries.
      */
     getRecent(limit = 100) {
+        perf.mark("getRecent");
         return this.auditLog.slice(Math.max(0, this.auditLog.length - limit));
     }
     /**
@@ -249,6 +257,7 @@ export class HoneyPot {
      * @returns Array of anomalies detected.
      */
     detectAnomalies() {
+        perf.mark("detectAnomalies");
         const anomalies = [];
         // High auth failure rate
         if (this.stats.authAttempts > 0 &&

package/dist/SSHClient/index.d.ts

@@ -1,19 +1,5 @@
 import type { CommandResult } from "../types/commands";
 import type { VirtualShell } from "../VirtualShell";
-/**
- * Programmatic client for executing shell commands against a virtual shell.
- *
- * Maintains working-directory state across invocations and runs commands as a
- * single authenticated user without SSH transport overhead.
- *
- * @example
- * ```ts
- * const shell = new VirtualShell("typescript-vm");
- * const client = new SshClient(shell, "alice");
- * const result = await client.cd("/tmp");
- * const list = await client.ls();
- * ```
- */
 export declare class SshClient {
     private shell;
     private username;

package/dist/SSHClient/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/SSHClient/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IAUpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAVjB,OAAO,CAAC,UAAU,CAAO;IAEzB;;;;;OAKG;gBAEM,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM;IAGzB;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA0BnD;;;;;OAKG;IACG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK/C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;IAInC;;;;;OAKG;IACG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ9C;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/C;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAKpE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD;;;;;;OAMG;IACG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjE;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBtE;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBpD;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjD;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAItC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAIxC;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;CAGnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/SSHClient/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAkBpD,qBAAa,SAAS;IAUpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAVjB,OAAO,CAAC,UAAU,CAAO;IAEzB;;;;;OAKG;gBAEM,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM;IAKzB;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BnD;;;;;OAKG;IACG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAM/C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;IAKnC;;;;;OAKG;IACG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAS9C;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK/C;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjD;;;;;;OAMG;IACG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjE;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBtE;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBpD;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAKhB;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAKrB;;;;;OAKG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjD;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAKtC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAKxC;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;CAInC"}

package/dist/SSHClient/index.js

@@ -1,4 +1,5 @@
 import { runCommand } from "../commands";
+import { createPerfLogger } from "../utils/perfLogger";
 /**
  * Programmatic client for executing shell commands against a virtual shell.
  *
@@ -13,6 +14,7 @@ import { runCommand } from "../commands";
  * const list = await client.ls();
  * ```
  */
+const perf = createPerfLogger("SshClient");
 export class SshClient {
     shell;
     username;
@@ -26,6 +28,7 @@ export class SshClient {
     constructor(shell, username) {
         this.shell = shell;
         this.username = username;
+        perf.mark("constructor");
     }
     /**
      * Executes raw shell command.
@@ -34,6 +37,7 @@ export class SshClient {
      * @returns Command result with stdout/stderr/exitCode.
      */
     async exec(command) {
+        perf.mark("exec");
         const vfs = this.shell.getVfs();
         const users = this.shell.getUsers();
         const hostname = this.shell.getHostname();
@@ -54,6 +58,7 @@ export class SshClient {
      * @returns Result with directory listing in stdout.
      */
     async ls(path) {
+        perf.mark("ls");
         const target = path ?? ".";
         return this.exec(`ls ${target}`);
     }
@@ -63,6 +68,7 @@ export class SshClient {
      * @returns Result with cwd path in stdout.
      */
     async pwd() {
+        perf.mark("pwd");
         return this.exec("pwd");
     }
     /**
@@ -72,6 +78,7 @@ export class SshClient {
      * @returns Result; updates internal cwd on success.
      */
     async cd(path) {
+        perf.mark("cd");
         const result = await this.exec(`cd ${path}`);
         if (result.nextCwd && result.exitCode !== 1) {
             this.currentCwd = result.nextCwd;
@@ -85,6 +92,7 @@ export class SshClient {
      * @returns Result with file content in stdout.
      */
     async cat(path) {
+        perf.mark("cat");
         return this.exec(`cat ${path}`);
     }
     /**
@@ -95,6 +103,7 @@ export class SshClient {
      * @returns Result from mkdir command.
      */
     async mkdir(path, recursive = false) {
+        perf.mark("mkdir");
         const flag = recursive ? "-p " : "";
         return this.exec(`mkdir ${flag}${path}`);
     }
@@ -105,6 +114,7 @@ export class SshClient {
      * @returns Result from touch command.
      */
     async touch(path) {
+        perf.mark("touch");
         return this.exec(`touch ${path}`);
     }
     /**
@@ -115,6 +125,7 @@ export class SshClient {
      * @returns Result from rm command.
      */
     async rm(path, recursive = false) {
+        perf.mark("rm");
         const flag = recursive ? "-r " : "";
         return this.exec(`rm ${flag}${path}`);
     }
@@ -126,6 +137,7 @@ export class SshClient {
      * @returns Result from touch/write simulation.
      */
     async writeFile(path, content) {
+        perf.mark("writeFile");
         const vfs = this.shell.getVfs();
         if (!vfs) {
             throw new Error("SSH client not started");
@@ -148,6 +160,7 @@ export class SshClient {
      * @returns File content as string or error in result.
      */
     async readFile(path) {
+        perf.mark("readFile");
         const vfs = this.shell.getVfs();
         if (!vfs) {
             throw new Error("SSH client not started");
@@ -169,6 +182,7 @@ export class SshClient {
      * @returns Normalized cwd path.
      */
     getCwd() {
+        perf.mark("getCwd");
         return this.currentCwd;
     }
     /**
@@ -177,6 +191,7 @@ export class SshClient {
      * @returns Associated username.
      */
     getUsername() {
+        perf.mark("getUsername");
         return this.username;
     }
     /**
@@ -186,6 +201,7 @@ export class SshClient {
      * @returns Result with ASCII tree in stdout.
      */
     async tree(path) {
+        perf.mark("tree");
         const target = path ?? ".";
         return this.exec(`tree ${target}`);
     }
@@ -195,6 +211,7 @@ export class SshClient {
      * @returns Result from whoami command.
      */
     async whoami() {
+        perf.mark("whoami");
         return this.exec("whoami");
     }
     /**
@@ -203,6 +220,7 @@ export class SshClient {
      * @returns Result from hostname command.
      */
     async hostname() {
+        perf.mark("hostname");
         return this.exec("hostname");
     }
     /**
@@ -211,6 +229,7 @@ export class SshClient {
      * @returns Result from who command.
      */
     async who() {
+        perf.mark("who");
         return this.exec("who");
     }
 }

package/dist/SSHMimic/index.d.ts

@@ -1,13 +1,6 @@
 import { EventEmitter } from "node:events";
 import { Server as SshServer } from "ssh2";
 import { VirtualShell } from "../VirtualShell";
-/**
- * SSH server facade that wires the virtual shell runtime into ssh2 sessions.
- *
- * This class is exported as `VirtualSshServer` for public API compatibility.
- * Create an instance, call {@link SshMimic.start}, and stop it with
- * {@link SshMimic.stop} when your process exits.
- */
 declare class SshMimic extends EventEmitter {
     port: number;
     server: SshServer | null;

package/dist/SSHMimic/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI/C;;;;;;GAMG;AACH,cAAM,QAAS,SAAQ,YAAY;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;;;OAMG;gBACS,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAkC,GAClC,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,YAAY,CAAC;KACrB;IAQD;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAwHrC;;OAEG;IACI,IAAI,IAAI,IAAI;CAQnB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAc/C,cAAM,QAAS,SAAQ,YAAY;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;;;OAMG;gBACS,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAkC,GAClC,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,YAAY,CAAC;KACrB;IASD;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAyHrC;;OAEG;IACI,IAAI,IAAI,IAAI;CASnB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/SSHMimic/index.js

@@ -1,6 +1,7 @@
 import { EventEmitter } from "node:events";
 import { Server as SshServer } from "ssh2";
 import { VirtualShell } from "../VirtualShell";
+import { createPerfLogger } from "../utils/perfLogger";
 import { runExec } from "./exec";
 import { loadOrCreateHostKey } from "./hostKey";
 /**
@@ -10,6 +11,7 @@ import { loadOrCreateHostKey } from "./hostKey";
  * Create an instance, call {@link SshMimic.start}, and stop it with
  * {@link SshMimic.stop} when your process exits.
  */
+const perf = createPerfLogger("SshMimic");
 class SshMimic extends EventEmitter {
     port;
     server;
@@ -24,6 +26,7 @@ class SshMimic extends EventEmitter {
      */
     constructor({ port, hostname = "typescript-vm", shell = new VirtualShell(hostname), }) {
         super();
+        perf.mark("constructor");
         this.port = port;
         this.shellHostname = hostname;
         this.server = null;
@@ -35,6 +38,7 @@ class SshMimic extends EventEmitter {
      * @returns Promise resolved with bound listening port.
      */
     async start() {
+        perf.mark("start");
         const shell = this.shell;
         const privateKey = loadOrCreateHostKey();
         // Ensure VirtualShell is fully initialized before accepting connections
@@ -118,6 +122,7 @@ class SshMimic extends EventEmitter {
      * Stops server if running.
      */
     stop() {
+        perf.mark("stop");
         if (this.server) {
             this.server.close(() => {
                 console.log("SSH Mimic stopped");

package/dist/SSHMimic/sftp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sftp.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/sftp.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA2HhE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,qBAAa,SAAU,SAAQ,YAAY;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAiC;gBAEpC,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAK,EACL,GAAG,EACH,KAAK,GACL,EAAE,gBAAgB;IAuBnB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAwJ9B,IAAI,IAAI,IAAI;IASnB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;CA6a1B"}
+{"version":3,"file":"sftp.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/sftp.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAI3C,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA4HhE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,qBAAa,SAAU,SAAQ,YAAY;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAiC;gBAEpC,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAK,EACL,GAAG,EACH,KAAK,GACL,EAAE,gBAAgB;IAwBnB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAyJ9B,IAAI,IAAI,IAAI;IAUnB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;CA6a1B"}

package/dist/SSHMimic/sftp.js

@@ -2,6 +2,7 @@
 import { EventEmitter } from "node:events";
 import * as path from "node:path";
 import { Server as SshServer } from "ssh2";
+import { createPerfLogger } from "../utils/perfLogger";
 import { VirtualShell } from "../VirtualShell";
 import { loadOrCreateHostKey } from "./hostKey";
 const SFTP_STATUS_CODE = {
@@ -23,6 +24,7 @@ const OPEN_MODE = {
     TRUNC: 0x00000010,
     EXCL: 0x00000020,
 };
+const perf = createPerfLogger("SftpMimic");
 export class SftpMimic extends EventEmitter {
     port;
     server;
@@ -34,6 +36,7 @@ export class SftpMimic extends EventEmitter {
     handles = new Map();
     constructor({ port, hostname = "typescript-vm", shell, vfs, users, }) {
         super();
+        perf.mark("constructor");
         this.port = port;
         this.server = null;
         this.hostname = hostname;
@@ -62,6 +65,7 @@ export class SftpMimic extends EventEmitter {
         return this.shell?.users ?? this.users;
     }
     async start() {
+        perf.mark("start");
         const privateKey = loadOrCreateHostKey();
         // Ensure VirtualShell is fully initialized before accepting connections
         if (this.shell) {
@@ -175,6 +179,7 @@ export class SftpMimic extends EventEmitter {
         });
     }
     stop() {
+        perf.mark("stop");
         if (this.server) {
             this.server.close(() => {
                 console.log("SFTP Mimic stopped");

package/dist/VirtualFileSystem/index.d.ts

@@ -1,12 +1,5 @@
 import { EventEmitter } from "node:events";
 import type { RemoveOptions, VfsNodeStats, WriteFileOptions } from "../types/vfs";
-/**
- * In-memory virtual filesystem with tar.gz mirror persistence.
- *
- * Paths are normalized to POSIX-like absolute paths. Use
- * {@link VirtualFileSystem.restoreMirror} on startup and
- * {@link VirtualFileSystem.flushMirror} to persist pending changes.
- */
 declare class VirtualFileSystem extends EventEmitter {
     private readonly mirrorRoot;
     private ensureMirrorRoot;

package/dist/VirtualFileSystem/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualFileSystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,MAAM,cAAc,CAAC;AAGtB;;;;;;GAMG;AACH,cAAM,iBAAkB,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,eAAe;IA4BvB;;;;OAIG;gBACS,OAAO,GAAE,MAAsB;IAK3C;;;;OAIG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;;;OAIG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzC;;;;;OAKG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI;IAY5D;;;;;;;;OAQG;IACI,SAAS,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,gBAAqB,GAC5B,IAAI;IAwBP;;;;;;;OAOG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAc3C;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS1C;;;;;OAKG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQpD;;;;;OAKG;IACI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAqC7C;;;;;OAKG;IACI,IAAI,CAAC,OAAO,GAAE,MAAY,GAAG,MAAM,EAAE;IAS5C;;;;;OAKG;IACI,IAAI,CAAC,OAAO,GAAE,MAAY,GAAG,MAAM;IAW1C;;;;;;;;OAQG;IACI,aAAa,CAAC,UAAU,GAAE,MAAY,GAAG,MAAM;IAQtD;;;;OAIG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAY7C;;;;OAIG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAY/C;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IA4BpE;;;;;OAKG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAsBnD;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualFileSystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,MAAM,cAAc,CAAC;AActB,cAAM,iBAAkB,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,eAAe;IA4BvB;;;;OAIG;gBACS,OAAO,GAAE,MAAsB;IAM3C;;;;OAIG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3C;;;;OAIG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;OAKG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI;IAa5D;;;;;;;;OAQG;IACI,SAAS,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,gBAAqB,GAC5B,IAAI;IAyBP;;;;;;;OAOG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAe3C;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAU1C;;;;;OAKG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASpD;;;;;OAKG;IACI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAsC7C;;;;;OAKG;IACI,IAAI,CAAC,OAAO,GAAE,MAAY,GAAG,MAAM,EAAE;IAU5C;;;;;OAKG;IACI,IAAI,CAAC,OAAO,GAAE,MAAY,GAAG,MAAM;IAY1C;;;;;;;;OAQG;IACI,aAAa,CAAC,UAAU,GAAE,MAAY,GAAG,MAAM;IAStD;;;;OAIG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAa7C;;;;OAIG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAa/C;;;;;OAKG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IA6BpE;;;;;OAKG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuBnD;AAED,eAAe,iBAAiB,CAAC"}

package/dist/VirtualFileSystem/index.js

@@ -2,6 +2,7 @@ import { EventEmitter } from "node:events";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { gunzipSync, gzipSync } from "node:zlib";
+import { createPerfLogger } from "../utils/perfLogger";
 import { normalizePath } from "./path";
 /**
  * In-memory virtual filesystem with tar.gz mirror persistence.
@@ -10,6 +11,7 @@ import { normalizePath } from "./path";
  * {@link VirtualFileSystem.restoreMirror} on startup and
  * {@link VirtualFileSystem.flushMirror} to persist pending changes.
  */
+const perf = createPerfLogger("VirtualFileSystem");
 class VirtualFileSystem extends EventEmitter {
     mirrorRoot;
     ensureMirrorRoot() {
@@ -77,6 +79,7 @@ class VirtualFileSystem extends EventEmitter {
      */
     constructor(baseDir = process.cwd()) {
         super();
+        perf.mark("constructor");
         this.mirrorRoot = path.resolve(baseDir, ".vfs", "mirror");
     }
     /**
@@ -85,6 +88,7 @@ class VirtualFileSystem extends EventEmitter {
      * If archive does not exist or cannot be read, creates fresh mirror file.
      */
     async restoreMirror() {
+        perf.mark("restoreMirror");
         this.ensureMirrorRoot();
     }
     /**
@@ -93,6 +97,7 @@ class VirtualFileSystem extends EventEmitter {
      * No-op when nothing changed and archive already exists.
      */
     async flushMirror() {
+        perf.mark("flushMirror");
         this.ensureMirrorRoot();
         this.emit("mirror:flush");
     }
@@ -103,6 +108,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param mode POSIX-like mode bits for new directories.
      */
     mkdir(targetPath, mode = 0o755) {
+        perf.mark("mkdir");
         this.ensureMirrorRoot();
         const fsPath = this.resolveFsPath(targetPath);
         if (fs.existsSync(fsPath) && !fs.statSync(fsPath).isDirectory()) {
@@ -121,6 +127,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param options Optional write behavior (mode, compression).
      */
     writeFile(targetPath, content, options = {}) {
+        perf.mark("writeFile");
         this.ensureMirrorRoot();
         const normalized = normalizePath(targetPath);
         const fsPath = this.resolveFsPath(normalized);
@@ -147,6 +154,7 @@ class VirtualFileSystem extends EventEmitter {
      * @returns UTF-8 string content.
      */
     readFile(targetPath) {
+        perf.mark("readFile");
         this.ensureMirrorRoot();
         const fsPath = this.resolveFsPath(targetPath);
         if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isFile()) {
@@ -165,6 +173,7 @@ class VirtualFileSystem extends EventEmitter {
      * @returns True when file or directory exists.
      */
     exists(targetPath) {
+        perf.mark("exists");
         try {
             const fsPath = this.resolveFsPath(targetPath);
             return fs.existsSync(fsPath);
@@ -180,6 +189,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param mode New POSIX-like mode.
      */
     chmod(targetPath, mode) {
+        perf.mark("chmod");
         const fsPath = this.resolveFsPath(targetPath);
         if (!fs.existsSync(fsPath)) {
             throw new Error(`Path '${normalizePath(targetPath)}' does not exist.`);
@@ -193,6 +203,7 @@ class VirtualFileSystem extends EventEmitter {
      * @returns Typed stat object based on node type.
      */
     stat(targetPath) {
+        perf.mark("stat");
         this.ensureMirrorRoot();
         const normalized = normalizePath(targetPath);
         const fsPath = this.resolveFsPath(normalized);
@@ -231,6 +242,7 @@ class VirtualFileSystem extends EventEmitter {
      * @returns Sorted child names.
      */
     list(dirPath = "/") {
+        perf.mark("list");
         const fsPath = this.resolveFsPath(dirPath);
         if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isDirectory()) {
             throw new Error(`Cannot list '${dirPath}': not a directory.`);
@@ -244,6 +256,7 @@ class VirtualFileSystem extends EventEmitter {
      * @returns Multi-line tree string.
      */
     tree(dirPath = "/") {
+        perf.mark("tree");
         const fsPath = this.resolveFsPath(dirPath);
         if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isDirectory()) {
             throw new Error(`Cannot render tree for '${dirPath}': not a directory.`);
@@ -261,6 +274,7 @@ class VirtualFileSystem extends EventEmitter {
      * @returns Total byte usage for file content under target path.
      */
     getUsageBytes(targetPath = "/") {
+        perf.mark("getUsageBytes");
         const fsPath = this.resolveFsPath(targetPath);
         if (!fs.existsSync(fsPath)) {
             throw new Error(`Path '${normalizePath(targetPath)}' does not exist.`);
@@ -273,6 +287,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param targetPath Path to file.
      */
     compressFile(targetPath) {
+        perf.mark("compressFile");
         const fsPath = this.resolveFsPath(targetPath);
         if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isFile()) {
             throw new Error(`Cannot compress '${targetPath}': not a file.`);
@@ -288,6 +303,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param targetPath Path to file.
      */
     decompressFile(targetPath) {
+        perf.mark("decompressFile");
         const fsPath = this.resolveFsPath(targetPath);
         if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isFile()) {
             throw new Error(`Cannot decompress '${targetPath}': not a file.`);
@@ -304,6 +320,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param options Removal options, including recursive delete.
      */
     remove(targetPath, options = {}) {
+        perf.mark("remove");
         const normalized = normalizePath(targetPath);
         if (normalized === "/") {
             throw new Error("Cannot remove root directory.");
@@ -333,6 +350,7 @@ class VirtualFileSystem extends EventEmitter {
      * @param toPath Destination path.
      */
     move(fromPath, toPath) {
+        perf.mark("move");
         const fromNormalized = normalizePath(fromPath);
         const toNormalized = normalizePath(toPath);
         if (fromNormalized === "/" || toNormalized === "/") {

package/dist/VirtualShell/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AA8BD;;;;;GAKG;AACH,cAAM,YAAa,SAAQ,YAAY;IACtC,QAAQ,EAAE,MAAM,CAAO;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;;;OAMG;gBAEF,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE,MAAM;IAyBlB;;;OAGG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;;;OAMG;IACH,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GACvE,IAAI;IASP;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKrE;;;;;;;OAOG;IAEH,uBAAuB,CACtB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAeP;;;;OAIG;IACI,MAAM,IAAI,iBAAiB,GAAG,IAAI;IAIzC;;;;OAIG;IACI,QAAQ,IAAI,kBAAkB,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;;;OAMG;IACI,eAAe,CACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,GACtB,IAAI;CAIP;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAwCD;;;;;GAKG;AACH,cAAM,YAAa,SAAQ,YAAY;IACtC,QAAQ,EAAE,MAAM,CAAO;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;;;OAMG;gBAEF,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE,MAAM;IA0BlB;;;OAGG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/C;;;;;;OAMG;IACH,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GACvE,IAAI;IASP;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMrE;;;;;;;OAOG;IAEH,uBAAuB,CACtB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAgBP;;;;OAIG;IACI,MAAM,IAAI,iBAAiB,GAAG,IAAI;IAIzC;;;;OAIG;IACI,QAAQ,IAAI,kBAAkB,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;;;OAMG;IACI,eAAe,CACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,GACtB,IAAI;CAKP;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}