typescript-virtual-container 1.2.8 → 1.3.0

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

@@ -1,4 +1,4 @@
-import { runCommand as runSingleCommand } from "../commands";
+import { runCommandDirect } from "../commands";
 import { resolvePath } from "../commands/helpers";
 // ── Script executor (handles &&/||/;) ────────────────────────────────────────
 export async function executeScript(script, authUser, hostname, mode, cwd, shell, env) {
@@ -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,22 +70,26 @@ 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 rawInput = [cmd.name, ...cmd.args].join(" ");
-    const result = await runSingleCommand(rawInput, authUser, hostname, mode, cwd, shell, stdin, env);
+    const result = await runCommandDirect(cmd.name, cmd.args, authUser, hostname, mode, cwd, shell, stdin, env);
     if (cmd.outputFile) {
         const outputPath = resolvePath(cwd, cmd.outputFile);
         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 {
@@ -92,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;
@@ -108,23 +118,27 @@ 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 rawInput = [cmd.name, ...cmd.args].join(" ");
-        const result = await runSingleCommand(rawInput, authUser, hostname, mode, cwd, shell, currentOutput, env);
+        const result = await runCommandDirect(cmd.name, cmd.args, authUser, hostname, mode, cwd, shell, currentOutput, env);
         exitCode = result.exitCode ?? 0;
         if (i === commands.length - 1 && cmd.outputFile) {
             const outputPath = resolvePath(cwd, cmd.outputFile);
             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":"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"}

package/dist/VirtualFileSystem/index.js

@@ -244,15 +244,24 @@ class VirtualFileSystem extends EventEmitter {
         if (node.type === "file") {
             const f = node;
             return {
-                type: "file", name, path: normalized, mode: f.mode,
-                createdAt: f.createdAt, updatedAt: f.updatedAt,
-                compressed: f.compressed, size: f.content.length,
+                type: "file",
+                name,
+                path: normalized,
+                mode: f.mode,
+                createdAt: f.createdAt,
+                updatedAt: f.updatedAt,
+                compressed: f.compressed,
+                size: f.content.length,
             };
         }
         const d = node;
         return {
-            type: "directory", name, path: normalized, mode: d.mode,
-            createdAt: d.createdAt, updatedAt: d.updatedAt,
+            type: "directory",
+            name,
+            path: normalized,
+            mode: d.mode,
+            createdAt: d.createdAt,
+            updatedAt: d.updatedAt,
             childrenCount: d.children.size,
         };
     }
@@ -287,7 +296,8 @@ class VirtualFileSystem extends EventEmitter {
             lines.push(`${connector}${name}`);
             if (child.type === "directory") {
                 const sub = this.renderTreeLines(child, "")
-                    .split("\n").slice(1)
+                    .split("\n")
+                    .slice(1)
                     .map((l) => `${nextPrefix}${l}`);
                 lines.push(...sub);
             }
@@ -342,14 +352,19 @@ class VirtualFileSystem extends EventEmitter {
             : targetPath;
         const { parent, name } = getParentDirectory(this.root, normalizedLink, true, (p) => this.mkdirRecursive(p, 0o755));
         const symNode = {
-            type: "file", name,
+            type: "file",
+            name,
             content: Buffer.from(normalizedTarget, "utf8"),
             mode: 0o120777,
             compressed: false,
-            createdAt: new Date(), updatedAt: new Date(),
+            createdAt: new Date(),
+            updatedAt: new Date(),
         };
         parent.children.set(name, symNode);
-        this.emit("symlink:create", { link: normalizedLink, target: normalizedTarget });
+        this.emit("symlink:create", {
+            link: normalizedLink,
+            target: normalizedTarget,
+        });
     }
     /** Returns true when the path is a symbolic link node. */
     isSymlink(targetPath) {
@@ -437,7 +452,9 @@ class VirtualFileSystem extends EventEmitter {
                 : this.serializeDir(child));
         }
         return {
-            type: "directory", name: dir.name, mode: dir.mode,
+            type: "directory",
+            name: dir.name,
+            mode: dir.mode,
             createdAt: dir.createdAt.toISOString(),
             updatedAt: dir.updatedAt.toISOString(),
             children,
@@ -445,7 +462,9 @@ class VirtualFileSystem extends EventEmitter {
     }
     serializeFile(file) {
         return {
-            type: "file", name: file.name, mode: file.mode,
+            type: "file",
+            name: file.name,
+            mode: file.mode,
             createdAt: file.createdAt.toISOString(),
             updatedAt: file.updatedAt.toISOString(),
             compressed: file.compressed,
@@ -480,7 +499,9 @@ class VirtualFileSystem extends EventEmitter {
     }
     deserializeDir(snap, name) {
         const dir = {
-            type: "directory", name, mode: snap.mode,
+            type: "directory",
+            name,
+            mode: snap.mode,
             createdAt: new Date(snap.createdAt),
             updatedAt: new Date(snap.updatedAt),
             children: new Map(),
@@ -489,7 +510,9 @@ class VirtualFileSystem extends EventEmitter {
             if (child.type === "file") {
                 const f = child;
                 dir.children.set(f.name, {
-                    type: "file", name: f.name, mode: f.mode,
+                    type: "file",
+                    name: f.name,
+                    mode: f.mode,
                     createdAt: new Date(f.createdAt),
                     updatedAt: new Date(f.updatedAt),
                     compressed: f.compressed,

package/dist/VirtualPackageManager/index.d.ts

@@ -0,0 +1,202 @@
+import type VirtualFileSystem from "../VirtualFileSystem";
+import type { VirtualUserManager } from "../VirtualUserManager";
+/**
+ * A single file entry written into the VFS when a package is installed.
+ */
+export interface PackageFile {
+    /** Absolute VFS destination path (e.g. `"/usr/bin/vim"`). */
+    path: string;
+    /** Text content to write. */
+    content: string;
+    /** POSIX mode bits (default `0o644`; use `0o755` for executables). */
+    mode?: number;
+}
+/**
+ * Metadata and behaviour definition for a single package in the registry.
+ *
+ * Used both for the built-in registry entries and for consumer-supplied custom
+ * packages. `files` are written to the VFS on `install()`, and `onInstall` /
+ * `onRemove` hooks allow arbitrary VFS mutations.
+ */
+export interface PackageDefinition {
+    /** Package name — lowercase, no spaces (e.g. `"vim"`, `"build-essential"`). */
+    name: string;
+    /** Debian-style version string (e.g. `"2:9.0.1378-2"`). */
+    version: string;
+    /** CPU architecture label (default `"amd64"`). */
+    architecture?: string;
+    /** Maintainer name and email shown in `apt show` output. */
+    maintainer?: string;
+    /** Full package description. */
+    description: string;
+    /** Short one-line summary shown in `apt search` results. */
+    shortDesc?: string;
+    /** Installed disk usage in kilobytes (informational). */
+    installedSizeKb?: number;
+    /** Other package names that must be installed first (resolved recursively). */
+    depends?: string[];
+    /** Repository section (e.g. `"utils"`, `"net"`, `"editors"`, `"devel"`). */
+    section?: string;
+    /** Files to write into the VFS during installation. */
+    files?: PackageFile[];
+    /**
+     * Hook called after all files are written.
+     * Use to create directories, write config, or register shell commands.
+     */
+    onInstall?: (vfs: VirtualFileSystem, users: VirtualUserManager) => void;
+    /** Hook called before VFS files are removed during uninstall. */
+    onRemove?: (vfs: VirtualFileSystem) => void;
+}
+/**
+ * Runtime record of an installed package, persisted to `/var/lib/dpkg/status`.
+ */
+export interface InstalledPackage {
+    /** Package name. */
+    name: string;
+    /** Installed version string. */
+    version: string;
+    /** CPU architecture. */
+    architecture: string;
+    /** Maintainer display string. */
+    maintainer: string;
+    /** Full description. */
+    description: string;
+    /** Repository section. */
+    section: string;
+    /** Installed disk usage in kilobytes. */
+    installedSizeKb: number;
+    /** ISO-8601 timestamp of when the package was installed. */
+    installedAt: string;
+    /** Absolute VFS paths written by this package (used by `dpkg -L`). */
+    files: string[];
+}
+/**
+ * Pure-TypeScript APT/dpkg package manager backed by a built-in registry.
+ *
+ * Accessed via `shell.packageManager` — not constructed directly.
+ *
+ * `install()` resolves dependencies recursively, writes declared files to the
+ * VFS, runs `onInstall` hooks, and persists state to `/var/lib/dpkg/status`.
+ * `remove()` reverses the process. All state survives VFS snapshot round-trips.
+ *
+ * @example
+ * ```ts
+ * const pm = shell.packageManager;
+ * pm.install(["vim", "git"]);
+ * console.log(pm.isInstalled("vim")); // true
+ * console.log(pm.installedCount());   // 2
+ * ```
+ */
+export declare class VirtualPackageManager {
+    private readonly vfs;
+    private readonly users;
+    private readonly installed;
+    private readonly registryPath;
+    private readonly logPath;
+    private readonly aptLogPath;
+    /**
+     * @param vfs   Backing virtual filesystem for file I/O and dpkg status persistence.
+     * @param users User manager reference passed to `onInstall` hooks.
+     */
+    constructor(vfs: VirtualFileSystem, users: VirtualUserManager);
+    /**
+     * Loads installed package state from `/var/lib/dpkg/status` in the VFS.
+     *
+     * Called automatically by `VirtualShell` after `bootstrapLinuxRootfs`.
+     * Safe to call again to reload state after a snapshot restore.
+     */
+    load(): void;
+    /** Persist installed state to /var/lib/dpkg/status. */
+    private persist;
+    private parseFields;
+    private log;
+    private aptLog;
+    /**
+     * Looks up a package definition in the built-in registry by name.
+     *
+     * @param name Package name (case-insensitive).
+     * @returns The matching `PackageDefinition`, or `undefined` if not found.
+     */
+    findInRegistry(name: string): PackageDefinition | undefined;
+    /**
+     * Returns all packages in the built-in registry, sorted alphabetically.
+     *
+     * @returns Array of `PackageDefinition` entries.
+     */
+    listAvailable(): PackageDefinition[];
+    /**
+     * Returns all currently installed packages, sorted alphabetically.
+     *
+     * @returns Array of `InstalledPackage` records.
+     */
+    listInstalled(): InstalledPackage[];
+    /**
+     * Returns `true` when the given package is currently installed.
+     *
+     * @param name Package name (case-insensitive).
+     */
+    isInstalled(name: string): boolean;
+    /**
+     * Returns the total number of installed packages.
+     *
+     * Used by `neofetch` to populate the `Packages:` field.
+     */
+    installedCount(): number;
+    /**
+     * Installs one or more packages from the registry.
+     *
+     * Dependencies listed in `PackageDefinition.depends` are resolved and
+     * installed automatically. Already-installed packages are skipped. Files
+     * declared in `PackageDefinition.files` are written to the VFS and
+     * `onInstall` hooks are called in dependency order.
+     *
+     * @param names   Package names to install.
+     * @param opts    Installation options.
+     * @param opts.quiet  Suppress progress output lines when `true`.
+     * @returns Terminal-style `output` string and an APT-compatible `exitCode`
+     *          (`0` on success, `100` when a package is not found).
+     */
+    install(names: string[], opts?: {
+        quiet?: boolean;
+    }): {
+        output: string;
+        exitCode: number;
+    };
+    /**
+     * Removes one or more installed packages.
+     *
+     * Package files are deleted from the VFS. Config files (paths under
+     * `/etc/` or ending in `.conf`) are preserved unless `opts.purge` is set.
+     * The `onRemove` hook is called for each package.
+     *
+     * @param names       Package names to remove.
+     * @param opts        Removal options.
+     * @param opts.purge  Also delete configuration files when `true`.
+     * @param opts.quiet  Suppress progress output lines when `true`.
+     * @returns Terminal-style `output` string and exit code (`0` on success).
+     */
+    remove(names: string[], opts?: {
+        purge?: boolean;
+        quiet?: boolean;
+    }): {
+        output: string;
+        exitCode: number;
+    };
+    /**
+     * Searches the registry for packages whose name or description contains
+     * the given term (case-insensitive). Equivalent to `apt-cache search`.
+     *
+     * @param term Search string.
+     * @returns Matching `PackageDefinition` entries sorted alphabetically.
+     */
+    search(term: string): PackageDefinition[];
+    /**
+     * Returns a dpkg-style metadata block for a package, including its
+     * install status. Equivalent to `apt-cache show` / `dpkg -s`.
+     *
+     * @param name Package name.
+     * @returns Multi-line metadata string, or `null` if not in the registry.
+     */
+    show(name: string): string | null;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualPackageManager/index.ts"],"names":[],"mappings":"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"}