typescript-virtual-container 1.2.9 → 1.3.0

package/.vscode/settings.json

@@ -12,7 +12,6 @@
         
         "LICENSE": true,
         "*.md": true,
-        "biome.json": true,
         "tsconfig.tsbuildinfo": true
     }
 }

package/README.md

@@ -2,26 +2,6 @@
 
 > Pure in-memory SSH/SFTP server with a realistic Linux rootfs, a virtual package manager, a real shell interpreter, and a typed programmatic API for testing, automation, honeypots, and interactive shell scripting in TypeScript/JavaScript.
 
----
-
-> **Release notes — what changed in this drop**
->
-> **Linux rootfs** — full `/etc`, `/proc`, `/sys`, `/dev`, `/usr`, `/var` hierarchy bootstrapped at init. `neofetch` now shows real uptime and package count. `/proc/meminfo`, `/proc/cpuinfo`, `/proc/version` populated from live system data. `/etc/passwd`, `/etc/group`, `/etc/shadow` synced from `VirtualUserManager`.
->
-> **Virtual package manager** — `apt install vim git nodejs python3` works. 25 packages in the built-in registry. Dependency resolution, file installation into VFS, `/var/lib/dpkg/status` persistence, `dpkg -l|-s|-L`, `apt-cache search|show|policy`. `neofetch` reflects installed count.
->
-> **`curl` / `wget` — pure `fetch()`** — host binary no longer spawned. Full flag support (`-o`, `-X`, `-d`, `-H`, `-s`, `-I`, `-L`, `-v` for curl; `-O`, `-P`, `-q` for wget). Zero host filesystem access.
->
-> **New commands** — `which`, `type`, `man` (with built-in pages), `uptime`, `free`, `lsb_release`, `alias`, `unalias`.
->
-> **`$(cmd)` command substitution** — `echo $(whoami)`, `mkdir /tmp/$(date +%s)`, nested subs, all work.
->
-> **Alias expansion** — `alias ll='ls -la'` then `ll /etc` resolves transparently in the dispatcher.
->
-> *— written by Claude because explaining every change manually is a waste of everyone's time*
-
----
-
 [![npm version](https://badge.fury.io/js/typescript-virtual-container.svg)](https://www.npmjs.com/package/typescript-virtual-container)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
@@ -82,7 +62,7 @@
 - **Security Auditing**: Built-in `HoneyPot` utility for comprehensive activity logging, event tracking, statistics collection, and anomaly detection across all components.
 - **Linux rootfs on boot**: Realistic `/etc`, `/proc`, `/sys`, `/dev`, `/usr`, `/var` hierarchy populated at startup — `os-release`, `passwd`, `hosts`, `resolv.conf`, `/proc/meminfo`, `/proc/cpuinfo`, and more.
 - **Virtual package manager**: `apt install`, `apt remove`, `apt search`, `dpkg -l`, `dpkg -s` — 25 packages in the built-in registry (vim, git, nodejs, python3, curl, openssh, gcc…). Writes files into VFS, tracks state in `/var/lib/dpkg/status`.
-- **90+ Built-in Commands**: Full navigation, text processing, archiving, system info, package management, and user management commands — grouped and documented in the interactive `help` system.
+- **87 Built-in Commands**: Full navigation, text processing, archiving, system info, package management, and user management commands — grouped and documented in the interactive `help` system.
 - **`$(cmd)` command substitution**: Nested command execution in any argument position.
 - **Alias support**: `alias`, `unalias` — persisted in session environment.
 - **Full TypeScript Support**: Complete JSDoc coverage, exported types, and first-class async/await for all operations.
@@ -804,6 +784,77 @@ interface InstalledPackage {
 
 ---
 
+### Snapshot Diff Tooling
+
+Three utility functions for comparing VFS snapshots in tests and deployment verification.
+
+```typescript
+import {
+  diffSnapshots,
+  formatDiff,
+  assertDiff,
+} from "typescript-virtual-container";
+```
+
+#### `diffSnapshots(before, after, options?): VfsDiff`
+
+Compares two snapshots and returns structured diff results.
+
+```ts
+const before = shell.vfs.toSnapshot();
+await client.exec("apt install vim && mkdir -p /app");
+const after = shell.vfs.toSnapshot();
+
+const diff = diffSnapshots(before, after, {
+  ignore: ["/proc", "/var/log"],  // skip volatile paths
+});
+
+diff.clean;       // false
+diff.added;       // [{ path: "/usr/bin/vim", type: "file" }, ...]
+diff.removed;     // []
+diff.modified;    // [{ path: "/var/lib/dpkg/status", before: "...", after: "..." }]
+```
+
+#### `formatDiff(diff, options?): string`
+
+Human-readable output similar to `git diff --stat`.
+
+```ts
+console.log(formatDiff(diff));
+// + /app  [directory]
+// + /usr/bin/vim  [file]
+// ~ /var/lib/dpkg/status  [modified]
+//
+// 2 added, 1 modified
+
+console.log(formatDiff(diff, { showContent: true, maxContentChars: 80 }));
+```
+
+#### `assertDiff(diff, expected): void`
+
+Throws on mismatch — designed for test suites.
+
+```ts
+assertDiff(diff, {
+  added:    ["/app", "/usr/bin/vim"],
+  modified: ["/var/lib/dpkg/status"],
+});
+// throws if any expected path is not in the diff
+```
+
+#### Types
+
+```ts
+interface VfsDiff {
+  added:    VfsDiffEntry[];      // { path, type }
+  removed:  VfsDiffEntry[];      // { path, type }
+  modified: VfsDiffModified[];   // { path, type, before, after }
+  clean:    boolean;
+}
+```
+
+---
+
 ### `HoneyPot`
 
 Comprehensive security auditing and event tracking utility. Attaches listeners to all core components to log activity, track statistics, and detect anomalies.
@@ -1475,6 +1526,9 @@ On every `VirtualShell` init, a realistic Linux directory hierarchy is bootstrap
 │   ├── resolv.conf          1.1.1.1 + 8.8.8.8
 │   └── shadow               (mode 0o640)
 ├── proc/
+│   ├── 1/                   init process (cmdline, status, comm, environ, fd/)
+│   ├── <pid>/               one entry per active session (based on pts/* TTY)
+│   ├── self/                mirrors the most recent session's /proc/<pid>/
 │   ├── cpuinfo              real host CPU info
 │   ├── loadavg
 │   ├── meminfo              real host memory
@@ -1617,6 +1671,7 @@ All commands are available in SSH shell mode and via `SshClient.exec()`. Type `h
 | `mkdir <path>` | `-p` | Create directory |
 | `mv <src> <dest>` | | Move or rename |
 | `rm <path>` | `-r` | Remove file or directory |
+| `nano <path>` | | Interactive text editor |
 | `touch <path>` | | Create or update file |
 
 ### Text Processing
@@ -1661,6 +1716,8 @@ All commands are available in SSH shell mode and via `SshClient.exec()`. Type `h
 | `free` | `-h` `-m` `-g` | Display free and used memory |
 | `lsb_release` | `-a` `-i` `-d` `-r` `-c` | Print distribution information |
 | `neofetch` | | System info display (shows real packages/uptime) |
+| `node` | `--version` `-e` `-p` | JavaScript runtime (virtual REPL — evaluates expressions and VFS `.js` files) |
+| `python3` | `--version` `-c` `-V` | Python 3 interpreter (virtual REPL — evaluates expressions and VFS `.py` files); alias `python` |
 | `uptime` | `-p` `-s` | Tell how long the system has been running |
 | `ping [-c <n>] <host>` | | Send ICMP ECHO_REQUEST (mock) |
 | `ps` | `-a` `-u` `-x` `aux` | Report process status; `-u` / `aux` shows USER/PID/%CPU/%MEM columns |
@@ -1682,20 +1739,31 @@ All commands are available in SSH shell mode and via `SshClient.exec()`. Type `h
 |---------|-------|-------------|
 | `alias [name=value]` | | Define or display aliases |
 | `clear` | | Clear terminal screen (full ANSI reset) |
-| `echo <text>` | `-n` `-e` | Display text; `-n` suppresses newline, `-e` interprets escape sequences (`\n`, `\t`, `\r`, `\\`) |
+| `declare [name=value]` | `-i` `-r` `-x` | Declare variables with attributes; aliases `local`, `typeset` |
+| `echo <text>` | `-n` `-e` | Display text; `-n` suppresses newline, `-e` interprets `\n` `\t` `\r` `\\` |
 | `env` | | Print session environment variables |
-| `exit [code]` | | Exit session |
+| `exit [code]` | | Exit session with optional exit code |
 | `export NAME=VALUE` | | Set shell variable in current session |
-| `help [command]` | | List commands (grouped) or show command details |
-| `set [VAR=val]` | | Display or set shell variables |
-| `sh` | `-c <script>` `[file]` | Execute shell script (supports if/for/while/do/done); `$(cmd)` substitution inside single-quoted args is preserved |
+| `help [command]` | | List commands grouped by category, or show usage for a specific command |
 | `history [n]` | | Display command history (last N entries) |
-| `source <file>` | | Execute file in current shell environment (aliases and exports persist) |
+| `man <command>` | | Display command reference manual |
+| `printf <fmt> [args...]` | | Format and print data (`%s` `%d` `%f` `%x` `\n` `\t`) |
+| `read [-r] <var...>` | `-r` `-p` | Read a line from stdin into variable(s) |
+| `return [n]` | | Return from a shell function with optional exit code |
+| `set [VAR=val]` | | Display or set shell variables |
+| `sh` | `-c <script>` `[file]` | Execute shell script — supports `if`/`for`/`while`/`case`/functions, bare `VAR=val` assignments, `$((expr))` arithmetic; single-quoted args are never expanded |
+| `shift [n]` | | Shift positional parameters left by n (default 1) |
+| `source <file>` | | Execute file in current shell environment; aliases and exports persist |
 | `. <file>` | | Alias for `source` |
-| `test <expr>` | | Evaluate conditional expression |
-| `[ <expr> ]` | | Alias for `test` — supports `-f`, `-d`, `-e`, `-z`, `-n`, `=`, `!=`, `-eq`, `-lt`, `-gt`, etc. |
+| `test <expr>` | | Evaluate POSIX conditional expression |
+| `[ <expr> ]` | | Alias for `test`; supports `-f` `-d` `-e` `-z` `-n` `-x` `-s` `=` `!=` `-eq` `-lt` `-gt` `-le` `-ge` `!` `-a` `-o` |
+| `trap [action] [signal]` | | Register handler for shell signals; supports `EXIT` |
+| `true` | | Return success exit code (0) |
+| `false` | | Return failure exit code (1) |
+| `type <command>` | | Describe how a command would be interpreted (builtin vs PATH) |
 | `unalias <name>` | `-a` | Remove alias definitions |
 | `unset <VAR>` | | Remove shell variable |
+| `which <command>` | | Locate a command in the session PATH |
 
 ### Package Management
 
@@ -1707,15 +1775,6 @@ All commands are available in SSH shell mode and via `SshClient.exec()`. Type `h
 | `dpkg` | `-l` `-s` `-L` `-r` `-P` | Debian package manager low-level tool |
 | `dpkg-query` | `-W` `-l` | Show information about installed packages |
 
-### Shell (extended)
-
-| Command | Flags | Description |
-|---------|-------|-------------|
-| `alias [name=value]` | | Define or display aliases |
-| `man <command>` | | Display command manual page |
-| `type <command>` | | Describe how command is interpreted |
-| `unalias <name>` | `-a` | Remove alias definitions |
-| `which <command>` | | Locate command in PATH |
 
 ### Users & Permissions
 
@@ -1723,7 +1782,6 @@ All commands are available in SSH shell mode and via `SshClient.exec()`. Type `h
 |---------|-------|-------------|
 | `adduser <name> <pass>` | | Create user (root only) |
 | `deluser <name>` | | Delete user (root only) |
-| `nano <path>` | | Interactive text editor |
 | `passwd [user]` | | Change password |
 | `su [user]` | | Switch user |
 | `sudo <cmd>` | `-i` | Run as root |
@@ -1758,11 +1816,34 @@ cat /tmp/out.txt >> /tmp/log.txt
 ```bash
 export NAME=world
 echo "Hello $NAME"           # Hello world
+echo "${NAME}"               # world (braced form)
 echo "${NAME:-fallback}"     # world (or fallback if unset)
-echo "${UNSET:-default}"     # default
-echo "Exit: $?"              # last exit code
+echo "${UNSET:-default}"     # default (assign-on-read: use ${UNSET:=default})
+echo "${NAME:+alternate}"    # alternate (only if NAME is set)
+echo "${#NAME}"              # 5 (string length)
+echo "$?"                    # last exit code
+echo "~"                     # /home/<user> (tilde expansion)
+```
+
+### Arithmetic Expansion
+
+```bash
+echo $((2 + 3))              # 5
+echo $((10 % 3))             # 1
+X=4; echo $((X * 2))         # 8
+i=0; i=$((i + 1)); echo $i   # 1
+
+# In loops (via sh):
+sh -c 'i=0
+while [ $i -lt 5 ]; do
+  echo $i
+  i=$((i + 1))
+done'
 ```
 
+> **Single-quote isolation** — variable and arithmetic expansion never occurs inside single quotes.
+> `echo '$NAME'` always outputs the literal string `$NAME`.
+
 ### Conditionals
 
 ```bash
@@ -2115,13 +2196,23 @@ MIT — see [LICENSE](./LICENSE).
 - [x] `>>` append redirect fixed — was broken because `echo` lacked terminal newline
 - [x] `export A=1 && echo $A` — env vars visible to subsequent commands in same pipeline
 - [x] `echo` uses session `env.vars` (not stale global store)
-- [ ] Snapshot diff tooling for test assertions
+- [x] `printf` — format string with `%s` `%d` `%f` `%x` `\n` `\t`
+- [x] `read` — read stdin into variables (supports multiple vars, splits on whitespace)
+- [x] `declare` / `local` / `typeset` — variable declaration with `-i` integer, `-r` readonly, `-x` export
+- [x] `shift [n]` — shift positional parameters
+- [x] `trap [action] [signal]` — signal handlers with `EXIT` support
+- [x] `return [n]` — return from shell functions
+- [x] `exit [code]` — optional exit code
+- [x] `help` rewrite — Package Management category, aliases shown inline, `help <cmd>` shows category
+- [x] Category corrections — `neofetch`→system, `nano`→files, `apt`/`dpkg`→package
+- [x] `src/utils/expand.ts` — centralised expansion module used by `runCommand`, `echo`, and `sh.ts`
+- [x] `${#VAR}` string length, `$((expr))` arithmetic, `~` tilde expansion
+- [x] `${VAR:=assign}` assign-on-read, `${VAR:+alternate}` alternate-if-set
+- [x] Single-quote isolation in expansion — `$VAR` never expanded inside `'...'`
+- [x] `true` / `false` builtins
+- [x] Bare `VAR=val` assignments in `sh` scripts (`i=0`, `i=$((i+1))`)
+- [x] `$?` reflects last command exit code correctly across `&&` / `;` chains
+- [x] `node` / `python3` virtual REPL stubs — `node -e`, `node <file>`, `python3 -c`, `python3 <file>`, `--version` flags
+- [x] `/proc/self` and `/proc/<pid>` per-session process entries — `comm`, `status`, `cmdline`, `environ`, `cwd`, `exe`, `fd/`
+- [x] Snapshot diff tooling — `diffSnapshots()`, `formatDiff()`, `assertDiff()` exported from `typescript-virtual-container`
 - [ ] WebSocket-based remote shell client (experimental)
-- [ ] Package stubs that simulate REPL behavior (node, python3)
-- [ ] `/proc/self` and `/proc/<pid>` per-session process entries
-
----
-
-## Changelog
-
-See [CHANGELOG.md](./CHANGELOG.md).

package/biome.json

@@ -26,5 +26,12 @@
         "indentWidth": 2,
         "lineWidth": 80,
         "lineEnding": "lf"
+    },
+    "files": {
+        "ignoreUnknown": true,
+        "includes": [
+            "**/*.ts",
+            "**/*.tsx"
+        ]
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AASpD,wBAAgB,OAAO,CACtB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,GACjB,IAAI,CAuBN"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/exec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AASpD,wBAAgB,OAAO,CACtB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,GACjB,IAAI,CAgCN"}

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

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,wBAAsB,aAAa,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CAiBxB;AAED,8CAA8C;AAC9C,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAID,wBAAsB,eAAe,CACpC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CAiBxB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/SSHMimic/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EACX,QAAQ,EAER,MAAM,EACN,SAAS,EACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,wBAAsB,aAAa,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CA8BxB;AAED,8CAA8C;AAC9C,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CAoCxB;AAID,wBAAsB,eAAe,CACpC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/SSHMimic/executor.js

@@ -10,7 +10,9 @@ export async function executeScript(script, authUser, hostname, mode, cwd, shell
         lastResult = await executePipeline(stmt.pipeline, authUser, hostname, mode, cwd, shell, env);
         env.lastExitCode = lastResult.exitCode ?? 0;
         // Propagate session-control signals
-        if (lastResult.closeSession || lastResult.switchUser || lastResult.nextCwd) {
+        if (lastResult.closeSession ||
+            lastResult.switchUser ||
+            lastResult.nextCwd) {
             break;
         }
     }
@@ -68,7 +70,10 @@ async function executeSingleCommandWithRedirections(cmd, authUser, hostname, mod
             stdin = shell.vfs.readFile(inputPath);
         }
         catch {
-            return { stderr: `${cmd.inputFile}: No such file or directory`, exitCode: 1 };
+            return {
+                stderr: `${cmd.inputFile}: No such file or directory`,
+                exitCode: 1,
+            };
         }
     }
     const result = await runCommandDirect(cmd.name, cmd.args, authUser, hostname, mode, cwd, shell, stdin, env);
@@ -77,12 +82,14 @@ async function executeSingleCommandWithRedirections(cmd, authUser, hostname, mod
         const output = result.stdout || "";
         try {
             if (cmd.appendOutput) {
-                const existing = (() => { try {
-                    return shell.vfs.readFile(outputPath);
-                }
-                catch {
-                    return "";
-                } })();
+                const existing = (() => {
+                    try {
+                        return shell.vfs.readFile(outputPath);
+                    }
+                    catch {
+                        return "";
+                    }
+                })();
                 shell.writeFileAsUser(authUser, outputPath, existing + output);
             }
             else {
@@ -91,7 +98,11 @@ async function executeSingleCommandWithRedirections(cmd, authUser, hostname, mod
             return { ...result, stdout: "" };
         }
         catch {
-            return { ...result, stderr: `Failed to write to ${cmd.outputFile}`, exitCode: 1 };
+            return {
+                ...result,
+                stderr: `Failed to write to ${cmd.outputFile}`,
+                exitCode: 1,
+            };
         }
     }
     return result;
@@ -107,7 +118,10 @@ async function executePipelineChain(commands, authUser, hostname, mode, cwd, she
                 currentOutput = shell.vfs.readFile(inputPath);
             }
             catch {
-                return { stderr: `${cmd.inputFile}: No such file or directory`, exitCode: 1 };
+                return {
+                    stderr: `${cmd.inputFile}: No such file or directory`,
+                    exitCode: 1,
+                };
             }
         }
         const result = await runCommandDirect(cmd.name, cmd.args, authUser, hostname, mode, cwd, shell, currentOutput, env);
@@ -117,12 +131,14 @@ async function executePipelineChain(commands, authUser, hostname, mode, cwd, she
             const output = result.stdout || "";
             try {
                 if (cmd.appendOutput) {
-                    const existing = (() => { try {
-                        return shell.vfs.readFile(outputPath);
-                    }
-                    catch {
-                        return "";
-                    } })();
+                    const existing = (() => {
+                        try {
+                            return shell.vfs.readFile(outputPath);
+                        }
+                        catch {
+                            return "";
+                        }
+                    })();
                     shell.writeFileAsUser(authUser, outputPath, existing + output);
                 }
                 else {

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;AA0B/C,cAAM,QAAS,SAAQ,YAAY;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,CAAe;IAE5B,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAElE;;;;;;;;OAQG;gBACS,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAkC,EAClC,eAAmB,EACnB,iBAA0B,GAC1B,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAYD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAcrB;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IA0JrC;;OAEG;IACI,IAAI,IAAI,IAAI;IAUnB;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGrC;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;AA0B/C,cAAM,QAAS,SAAQ,YAAY;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,CAAe;IAE5B,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAElE;;;;;;;;OAQG;gBACS,EACX,IAAI,EACJ,QAA0B,EAC1B,KAAkC,EAClC,eAAmB,EACnB,iBAA0B,GAC1B,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAYD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAcrB;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IA6LrC;;OAEG;IACI,IAAI,IAAI,IAAI;IAUnB;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGrC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/SSHMimic/index.js

@@ -103,7 +103,11 @@ class SshMimic extends EventEmitter {
                 remoteAddress = ctx.ip ?? remoteAddress;
                 // Rate-limit check
                 if (this.isLockedOut(remoteAddress)) {
-                    this.emit("auth:failure", { username: candidateUser, remoteAddress, reason: "lockout" });
+                    this.emit("auth:failure", {
+                        username: candidateUser,
+                        remoteAddress,
+                        reason: "lockout",
+                    });
                     ctx.reject();
                     return;
                 }
@@ -123,7 +127,10 @@ class SshMimic extends EventEmitter {
                         ctx.password === "" ||
                         !shell.users.verifyPassword(candidateUser, ctx.password)) {
                         this.recordFailure(remoteAddress);
-                        this.emit("auth:failure", { username: candidateUser, remoteAddress });
+                        this.emit("auth:failure", {
+                            username: candidateUser,
+                            remoteAddress,
+                        });
                         ctx.reject();
                         return;
                     }
@@ -144,11 +151,14 @@ class SshMimic extends EventEmitter {
                         return;
                     }
                     const incomingKey = ctx.key;
-                    const keyMatches = authorizedKeys.some((k) => k.algo === incomingKey.algo &&
-                        k.data.equals(incomingKey.data));
+                    const keyMatches = authorizedKeys.some((k) => k.algo === incomingKey.algo && k.data.equals(incomingKey.data));
                     if (!keyMatches) {
                         this.recordFailure(remoteAddress);
-                        this.emit("auth:failure", { username: candidateUser, remoteAddress, method: "publickey" });
+                        this.emit("auth:failure", {
+                            username: candidateUser,
+                            remoteAddress,
+                            method: "publickey",
+                        });
                         ctx.reject();
                         return;
                     }
@@ -157,7 +167,11 @@ class SshMimic extends EventEmitter {
                         authUser = candidateUser;
                         sessionId = shell.users.registerSession(authUser, remoteAddress).id;
                         this.recordSuccess(remoteAddress);
-                        this.emit("auth:success", { username: authUser, remoteAddress, method: "publickey" });
+                        this.emit("auth:success", {
+                            username: authUser,
+                            remoteAddress,
+                            method: "publickey",
+                        });
                         this.ensureHomeDir(authUser);
                         ctx.accept();
                     }

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

@@ -1 +1 @@
-{"version":3,"file":"binaryPack.d.ts","sourceRoot":"","sources":["../../src/VirtualFileSystem/binaryPack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAkC,MAAM,iBAAiB,CAAC;AA2E7F;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAM7D;AAuED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}
+{"version":3,"file":"binaryPack.d.ts","sourceRoot":"","sources":["../../src/VirtualFileSystem/binaryPack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EACX,qBAAqB,EAGrB,MAAM,iBAAiB,CAAC;AA+EzB;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAM7D;AA0FD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/VirtualFileSystem/binaryPack.js

@@ -37,7 +37,9 @@ const TYPE_DIR = 0x02;
 // ── Encoder ───────────────────────────────────────────────────────────────────
 class Encoder {
     chunks = [];
-    write(buf) { this.chunks.push(buf); }
+    write(buf) {
+        this.chunks.push(buf);
+    }
     writeUint8(n) {
         const b = Buffer.allocUnsafe(1);
         b.writeUInt8(n, 0);
@@ -67,7 +69,9 @@ class Encoder {
         this.writeUint32(bytes.length);
         this.chunks.push(bytes);
     }
-    toBuffer() { return Buffer.concat(this.chunks); }
+    toBuffer() {
+        return Buffer.concat(this.chunks);
+    }
 }
 function encodeNode(enc, node) {
     if (node.type === "file") {
@@ -111,7 +115,9 @@ class Decoder {
     constructor(buf) {
         this.buf = buf;
     }
-    readUint8() { return this.buf.readUInt8(this.pos++); }
+    readUint8() {
+        return this.buf.readUInt8(this.pos++);
+    }
     readUint16() {
         const v = this.buf.readUInt16LE(this.pos);
         this.pos += 2;
@@ -139,7 +145,9 @@ class Decoder {
         this.pos += len;
         return b;
     }
-    remaining() { return this.buf.length - this.pos; }
+    remaining() {
+        return this.buf.length - this.pos;
+    }
 }
 function decodeNode(dec) {
     const type = dec.readUint8();
@@ -150,7 +158,15 @@ function decodeNode(dec) {
     if (type === TYPE_FILE) {
         const compressed = dec.readUint8() === 0x01;
         const content = dec.readBytes();
-        return { type: "file", name, mode, createdAt, updatedAt, compressed, content };
+        return {
+            type: "file",
+            name,
+            mode,
+            createdAt,
+            updatedAt,
+            compressed,
+            content,
+        };
     }
     if (type === TYPE_DIR) {
         const count = dec.readUint32();
@@ -159,7 +175,14 @@ function decodeNode(dec) {
             const child = decodeNode(dec);
             children.set(child.name, child);
         }
-        return { type: "directory", name, mode, createdAt, updatedAt, children };
+        return {
+            type: "directory",
+            name,
+            mode,
+            createdAt,
+            updatedAt,
+            children,
+        };
     }
     throw new Error(`[VFS binary] Unknown node type: 0x${type.toString(16)}`);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualFileSystem/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualFileSystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EAIX,gBAAgB,EAChB,MAAM,cAAc,CAAC;AAItB;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,UAAU;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,cAAM,iBAAkB,SAAQ,YAAY;IAC3C,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,OAAO,GAAE,UAAe;IAqBpC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,cAAc;IAwBtB;;;;;;OAMG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3C;;;;;;OAMG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAazC,4CAA4C;IACrC,OAAO,IAAI,kBAAkB;IAIpC,qEAAqE;IAC9D,eAAe,IAAI,MAAM,GAAG,IAAI;IAMvC,qDAAqD;IAC9C,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI;IAiB5D;;;OAGG;IACI,SAAS,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,gBAAqB,GAC5B,IAAI;IAuCP;;;OAGG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAY3C,+DAA+D;IACxD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAY9C,4DAA4D;IACrD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS1C,mCAAmC;IAC5B,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpD,gDAAgD;IACzC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IA6B7C,2DAA2D;IACpD,IAAI,CAAC,OAAO,GAAE,MAAY,GAAG,MAAM,EAAE;IAS5C,wDAAwD;IACjD,IAAI,CAAC,OAAO,GAAE,MAAY,GAAG,MAAM;IAU1C,OAAO,CAAC,eAAe;IAqBvB,gDAAgD;IACzC,aAAa,CAAC,UAAU,GAAE,MAAY,GAAG,MAAM;IAItD,OAAO,CAAC,YAAY;IASpB,sDAAsD;IAC/C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAY7C,oDAAoD;IAC7C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAY/C;;;OAGG;IACI,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA2B1D,0DAA0D;IACnD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS7C;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM;IAsB7D,wCAAwC;IACjC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAsBpE,+BAA+B;IACxB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA8BnD;;;;;OAKG;IACI,UAAU,IAAI,WAAW;IAIhC,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,aAAa;IAYrB;;;;;;;OAOG;WACW,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,iBAAiB;IAMpE;;;;;;;;OAQG;IACI,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAKlD,OAAO,CAAC,cAAc;CAkCtB;AAED,eAAe,iBAAiB,CAAC"}