typescript-virtual-container 1.1.3 → 1.1.5

package/dist/VirtualFileSystem/index.js

@@ -1,10 +1,8 @@
-import { promises as fs } from "node:fs";
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs";
 import * as path from "node:path";
 import { gunzipSync, gzipSync } from "node:zlib";
-import { archiveExists, createTarBuffer, readSnapshotFromTar } from "./archive";
-import { getNode, getParentDirectory, normalizePath, splitPath } from "./path";
-import { applySnapshot, createSnapshot } from "./snapshot";
-import { renderTree } from "./tree";
+import { normalizePath } from "./path";
 /**
  * In-memory virtual filesystem with tar.gz mirror persistence.
  *
@@ -12,36 +10,74 @@ import { renderTree } from "./tree";
  * {@link VirtualFileSystem.restoreMirror} on startup and
  * {@link VirtualFileSystem.flushMirror} to persist pending changes.
  */
-class VirtualFileSystem {
-    root;
-    archivePath;
-    dirty = false;
-    computeNodeUsageBytes(node) {
-        if (node.type === "file") {
-            return node.content.length;
+class VirtualFileSystem extends EventEmitter {
+    mirrorRoot;
+    ensureMirrorRoot() {
+        fs.mkdirSync(this.mirrorRoot, { recursive: true, mode: 0o755 });
+    }
+    resolveFsPath(targetPath) {
+        const normalized = normalizePath(targetPath);
+        const relativePath = normalized.slice(1);
+        const resolved = path.resolve(this.mirrorRoot, relativePath || ".");
+        const relative = path.relative(this.mirrorRoot, resolved);
+        if (relative.startsWith("..") || path.isAbsolute(relative)) {
+            throw new Error(`Invalid path '${targetPath}'.`);
+        }
+        return resolved;
+    }
+    detectGzipFile(targetPath) {
+        const fd = fs.openSync(targetPath, "r");
+        try {
+            const header = Buffer.alloc(2);
+            const bytesRead = fs.readSync(fd, header, 0, 2, 0);
+            return bytesRead === 2 && header[0] === 0x1f && header[1] === 0x8b;
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    computeDiskUsageBytes(targetPath) {
+        const stats = fs.statSync(targetPath);
+        if (stats.isFile()) {
+            return stats.size;
         }
         let total = 0;
-        for (const child of node.children.values()) {
-            total += this.computeNodeUsageBytes(child);
+        for (const entry of fs.readdirSync(targetPath)) {
+            total += this.computeDiskUsageBytes(path.join(targetPath, entry));
         }
         return total;
     }
+    renderTreeLines(targetPath, label) {
+        const lines = [label];
+        const walk = (currentPath, prefix) => {
+            const entries = fs
+                .readdirSync(currentPath, { withFileTypes: true })
+                .map((entry) => entry.name)
+                .sort((left, right) => left.localeCompare(right));
+            for (let i = 0; i < entries.length; i += 1) {
+                const name = entries[i];
+                const isLast = i === entries.length - 1;
+                const connector = isLast ? "└── " : "├── ";
+                const nextPrefix = `${prefix}${isLast ? "    " : "│   "}`;
+                const entryPath = path.join(currentPath, name);
+                const isDirectory = fs.statSync(entryPath).isDirectory();
+                lines.push(`${prefix}${connector}${name}`);
+                if (isDirectory) {
+                    walk(entryPath, nextPrefix);
+                }
+            }
+        };
+        walk(targetPath, "");
+        return lines.join("\n");
+    }
     /**
      * Creates a virtual filesystem instance.
      *
      * @param baseDir Base directory used to resolve mirror archive location.
      */
     constructor(baseDir = process.cwd()) {
-        const now = new Date();
-        this.archivePath = path.resolve(baseDir, ".vfs", "mirror.tar.gz");
-        this.root = {
-            type: "directory",
-            name: "",
-            mode: 0o755,
-            createdAt: now,
-            updatedAt: now,
-            children: new Map(),
-        };
+        super();
+        this.mirrorRoot = path.resolve(baseDir, ".vfs", "mirror");
     }
     /**
      * Restores filesystem state from mirror archive.
@@ -49,19 +85,7 @@ class VirtualFileSystem {
      * If archive does not exist or cannot be read, creates fresh mirror file.
      */
     async restoreMirror() {
-        await fs.mkdir(path.dirname(this.archivePath), { recursive: true });
-        try {
-            const compressed = await fs.readFile(this.archivePath);
-            const tarBuffer = gunzipSync(compressed);
-            const snapshot = await readSnapshotFromTar(tarBuffer);
-            applySnapshot(this.root, snapshot);
-            this.dirty = false;
-            return;
-        }
-        catch {
-            console.warn(`No valid mirror archive found at '${this.archivePath}'. Starting with empty filesystem.`);
-            await this.flushMirror();
-        }
+        this.ensureMirrorRoot();
     }
     /**
      * Persists current filesystem state to mirror archive.
@@ -69,15 +93,8 @@ class VirtualFileSystem {
      * No-op when nothing changed and archive already exists.
      */
     async flushMirror() {
-        if (!this.dirty && (await archiveExists(this.archivePath))) {
-            return;
-        }
-        await fs.mkdir(path.dirname(this.archivePath), { recursive: true });
-        const snapshotJson = JSON.stringify(createSnapshot(this.root), null, 2);
-        const tarBuffer = await createTarBuffer(snapshotJson);
-        const compressed = gzipSync(tarBuffer);
-        await fs.writeFile(this.archivePath, compressed);
-        this.dirty = false;
+        this.ensureMirrorRoot();
+        this.emit("mirror:flush");
     }
     /**
      * Creates directory and any missing parent directories.
@@ -86,32 +103,13 @@ class VirtualFileSystem {
      * @param mode POSIX-like mode bits for new directories.
      */
     mkdir(targetPath, mode = 0o755) {
-        const normalized = normalizePath(targetPath);
-        const parts = splitPath(normalized);
-        let current = this.root;
-        for (const part of parts) {
-            const existing = current.children.get(part);
-            if (!existing) {
-                const now = new Date();
-                const nextDir = {
-                    type: "directory",
-                    name: part,
-                    mode,
-                    createdAt: now,
-                    updatedAt: now,
-                    children: new Map(),
-                };
-                current.children.set(part, nextDir);
-                current.updatedAt = now;
-                this.dirty = true;
-                current = nextDir;
-                continue;
-            }
-            if (existing.type !== "directory") {
-                throw new Error(`Cannot create directory '${normalized}': '${part}' is a file.`);
-            }
-            current = existing;
+        this.ensureMirrorRoot();
+        const fsPath = this.resolveFsPath(targetPath);
+        if (fs.existsSync(fsPath) && !fs.statSync(fsPath).isDirectory()) {
+            throw new Error(`Cannot create directory '${normalizePath(targetPath)}': path is a file.`);
         }
+        fs.mkdirSync(fsPath, { recursive: true, mode });
+        this.emit("dir:create", { path: normalizePath(targetPath), mode });
     }
     /**
      * Writes UTF-8 text or binary content into file.
@@ -123,31 +121,22 @@ class VirtualFileSystem {
      * @param options Optional write behavior (mode, compression).
      */
     writeFile(targetPath, content, options = {}) {
+        this.ensureMirrorRoot();
         const normalized = normalizePath(targetPath);
-        const { parent, name } = getParentDirectory(this.root, normalized, true, (pathToCreate) => this.mkdir(pathToCreate));
-        const now = new Date();
+        const fsPath = this.resolveFsPath(normalized);
+        const parentPath = path.dirname(fsPath);
+        fs.mkdirSync(parentPath, { recursive: true, mode: 0o755 });
         const rawContent = Buffer.isBuffer(content)
             ? content
             : Buffer.from(content, "utf8");
         const shouldCompress = options.compress ?? false;
         const storedContent = shouldCompress ? gzipSync(rawContent) : rawContent;
-        const existing = parent.children.get(name);
-        if (existing && existing.type === "directory") {
+        if (fs.existsSync(fsPath) && fs.statSync(fsPath).isDirectory()) {
             throw new Error(`Cannot write file '${normalized}': path is a directory.`);
         }
-        const createdAt = existing?.type === "file" ? existing.createdAt : now;
-        const mode = options.mode ?? (existing?.type === "file" ? existing.mode : 0o644);
-        parent.children.set(name, {
-            type: "file",
-            name,
-            mode,
-            createdAt,
-            updatedAt: now,
-            content: storedContent,
-            compressed: shouldCompress,
-        });
-        parent.updatedAt = now;
-        this.dirty = true;
+        fs.writeFileSync(fsPath, storedContent);
+        fs.chmodSync(fsPath, options.mode ?? 0o644);
+        this.emit("file:write", { path: normalized, size: storedContent.length });
     }
     /**
      * Reads file content as UTF-8 text.
@@ -158,11 +147,15 @@ class VirtualFileSystem {
      * @returns UTF-8 string content.
      */
     readFile(targetPath) {
-        const node = getNode(this.root, targetPath);
-        if (node.type !== "file") {
+        this.ensureMirrorRoot();
+        const fsPath = this.resolveFsPath(targetPath);
+        if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isFile()) {
             throw new Error(`Cannot read '${targetPath}': not a file.`);
         }
-        const raw = node.compressed ? gunzipSync(node.content) : node.content;
+        const stored = fs.readFileSync(fsPath);
+        const raw = this.detectGzipFile(fsPath) ? gunzipSync(stored) : stored;
+        const normalized = normalizePath(targetPath);
+        this.emit("file:read", { path: normalized, size: raw.length });
         return raw.toString("utf8");
     }
     /**
@@ -173,8 +166,8 @@ class VirtualFileSystem {
      */
     exists(targetPath) {
         try {
-            getNode(this.root, targetPath);
-            return true;
+            const fsPath = this.resolveFsPath(targetPath);
+            return fs.existsSync(fsPath);
         }
         catch {
             return false;
@@ -187,10 +180,11 @@ class VirtualFileSystem {
      * @param mode New POSIX-like mode.
      */
     chmod(targetPath, mode) {
-        const node = getNode(this.root, targetPath);
-        node.mode = mode;
-        node.updatedAt = new Date();
-        this.dirty = true;
+        const fsPath = this.resolveFsPath(targetPath);
+        if (!fs.existsSync(fsPath)) {
+            throw new Error(`Path '${normalizePath(targetPath)}' does not exist.`);
+        }
+        fs.chmodSync(fsPath, mode);
     }
     /**
      * Returns metadata for file or directory.
@@ -199,28 +193,35 @@ class VirtualFileSystem {
      * @returns Typed stat object based on node type.
      */
     stat(targetPath) {
+        this.ensureMirrorRoot();
         const normalized = normalizePath(targetPath);
-        const node = getNode(this.root, normalized);
-        if (node.type === "file") {
+        const fsPath = this.resolveFsPath(normalized);
+        if (!fs.existsSync(fsPath)) {
+            throw new Error(`Path '${normalized}' does not exist.`);
+        }
+        const stats = fs.statSync(fsPath);
+        const mode = stats.mode & 0o777;
+        const name = normalized === "/" ? "" : path.posix.basename(normalized);
+        if (stats.isFile()) {
             return {
                 type: "file",
-                name: node.name,
+                name,
                 path: normalized,
-                mode: node.mode,
-                createdAt: node.createdAt,
-                updatedAt: node.updatedAt,
-                compressed: node.compressed,
-                size: node.content.length,
+                mode,
+                createdAt: stats.birthtime,
+                updatedAt: stats.mtime,
+                compressed: this.detectGzipFile(fsPath),
+                size: stats.size,
             };
         }
         return {
             type: "directory",
-            name: node.name,
+            name,
             path: normalized,
-            mode: node.mode,
-            createdAt: node.createdAt,
-            updatedAt: node.updatedAt,
-            childrenCount: node.children.size,
+            mode,
+            createdAt: stats.birthtime,
+            updatedAt: stats.mtime,
+            childrenCount: fs.readdirSync(fsPath).length,
         };
     }
     /**
@@ -230,11 +231,11 @@ class VirtualFileSystem {
      * @returns Sorted child names.
      */
     list(dirPath = "/") {
-        const node = getNode(this.root, dirPath);
-        if (node.type !== "directory") {
+        const fsPath = this.resolveFsPath(dirPath);
+        if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isDirectory()) {
             throw new Error(`Cannot list '${dirPath}': not a directory.`);
         }
-        return Array.from(node.children.keys()).sort();
+        return fs.readdirSync(fsPath).sort();
     }
     /**
      * Renders ASCII tree view of directory hierarchy.
@@ -243,12 +244,12 @@ class VirtualFileSystem {
      * @returns Multi-line tree string.
      */
     tree(dirPath = "/") {
-        const node = getNode(this.root, dirPath);
-        if (node.type !== "directory") {
+        const fsPath = this.resolveFsPath(dirPath);
+        if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isDirectory()) {
             throw new Error(`Cannot render tree for '${dirPath}': not a directory.`);
         }
         const rootLabel = dirPath === "/" ? "/" : path.posix.basename(normalizePath(dirPath));
-        return renderTree(node, rootLabel);
+        return this.renderTreeLines(fsPath, rootLabel);
     }
     /**
      * Computes total stored file bytes under a path.
@@ -260,8 +261,11 @@ class VirtualFileSystem {
      * @returns Total byte usage for file content under target path.
      */
     getUsageBytes(targetPath = "/") {
-        const node = getNode(this.root, targetPath);
-        return this.computeNodeUsageBytes(node);
+        const fsPath = this.resolveFsPath(targetPath);
+        if (!fs.existsSync(fsPath)) {
+            throw new Error(`Path '${normalizePath(targetPath)}' does not exist.`);
+        }
+        return this.computeDiskUsageBytes(fsPath);
     }
     /**
      * Compresses file content with gzip and flags node as compressed.
@@ -269,15 +273,13 @@ class VirtualFileSystem {
      * @param targetPath Path to file.
      */
     compressFile(targetPath) {
-        const node = getNode(this.root, targetPath);
-        if (node.type !== "file") {
+        const fsPath = this.resolveFsPath(targetPath);
+        if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isFile()) {
             throw new Error(`Cannot compress '${targetPath}': not a file.`);
         }
-        if (!node.compressed) {
-            node.content = gzipSync(node.content);
-            node.compressed = true;
-            node.updatedAt = new Date();
-            this.dirty = true;
+        if (!this.detectGzipFile(fsPath)) {
+            const content = fs.readFileSync(fsPath);
+            fs.writeFileSync(fsPath, gzipSync(content));
         }
     }
     /**
@@ -286,15 +288,13 @@ class VirtualFileSystem {
      * @param targetPath Path to file.
      */
     decompressFile(targetPath) {
-        const node = getNode(this.root, targetPath);
-        if (node.type !== "file") {
+        const fsPath = this.resolveFsPath(targetPath);
+        if (!fs.existsSync(fsPath) || !fs.statSync(fsPath).isFile()) {
             throw new Error(`Cannot decompress '${targetPath}': not a file.`);
         }
-        if (node.compressed) {
-            node.content = gunzipSync(node.content);
-            node.compressed = false;
-            node.updatedAt = new Date();
-            this.dirty = true;
+        if (this.detectGzipFile(fsPath)) {
+            const content = fs.readFileSync(fsPath);
+            fs.writeFileSync(fsPath, gunzipSync(content));
         }
     }
     /**
@@ -308,19 +308,23 @@ class VirtualFileSystem {
         if (normalized === "/") {
             throw new Error("Cannot remove root directory.");
         }
-        const { parent, name } = getParentDirectory(this.root, normalized, false, () => undefined);
-        const node = parent.children.get(name);
-        if (!node) {
+        const fsPath = this.resolveFsPath(normalized);
+        if (!fs.existsSync(fsPath)) {
             throw new Error(`Path '${normalized}' does not exist.`);
         }
-        if (node.type === "directory" &&
-            node.children.size > 0 &&
-            !options.recursive) {
-            throw new Error(`Directory '${normalized}' is not empty. Use recursive option.`);
+        const stats = fs.statSync(fsPath);
+        if (stats.isDirectory() && !options.recursive) {
+            const entries = fs.readdirSync(fsPath);
+            if (entries.length > 0) {
+                throw new Error(`Directory '${normalized}' is not empty. Use recursive option.`);
+            }
+        }
+        if (stats.isDirectory()) {
+            fs.rmSync(fsPath, { recursive: options.recursive ?? false });
+        }
+        else {
+            fs.rmSync(fsPath);
         }
-        parent.children.delete(name);
-        parent.updatedAt = new Date();
-        this.dirty = true;
     }
     /**
      * Moves or renames node to destination path.
@@ -334,22 +338,16 @@ class VirtualFileSystem {
         if (fromNormalized === "/" || toNormalized === "/") {
             throw new Error("Cannot move root directory.");
         }
-        const { parent: fromParent, name: fromName } = getParentDirectory(this.root, fromNormalized, false, () => undefined);
-        const node = fromParent.children.get(fromName);
-        if (!node) {
+        const fromFsPath = this.resolveFsPath(fromNormalized);
+        const toFsPath = this.resolveFsPath(toNormalized);
+        if (!fs.existsSync(fromFsPath)) {
             throw new Error(`Path '${fromNormalized}' does not exist.`);
         }
-        const { parent: toParent, name: toName } = getParentDirectory(this.root, toNormalized, true, (pathToCreate) => this.mkdir(pathToCreate));
-        if (toParent.children.has(toName)) {
+        if (fs.existsSync(toFsPath)) {
             throw new Error(`Destination '${toNormalized}' already exists.`);
         }
-        fromParent.children.delete(fromName);
-        node.name = toName;
-        node.updatedAt = new Date();
-        toParent.children.set(toName, node);
-        fromParent.updatedAt = new Date();
-        toParent.updatedAt = new Date();
-        this.dirty = true;
+        fs.mkdirSync(path.dirname(toFsPath), { recursive: true, mode: 0o755 });
+        fs.renameSync(fromFsPath, toFsPath);
     }
 }
 export default VirtualFileSystem;

package/dist/VirtualShell/index.d.ts

@@ -1,3 +1,4 @@
+import { EventEmitter } from "node:events";
 import type { CommandContext, CommandResult } from "../types/commands";
 import type { ShellStream } from "../types/streams";
 import VirtualFileSystem from "../VirtualFileSystem";
@@ -13,12 +14,13 @@ export interface ShellProperties {
  * Instances are used both by the SSH server facade and by the programmatic
  * client API.
  */
-declare class VirtualShell {
+declare class VirtualShell extends EventEmitter {
     basePath: string;
     vfs: VirtualFileSystem;
     users: VirtualUserManager;
     hostname: string;
     properties: ShellProperties;
+    private initialized;
     /**
      * Creates a new virtual shell instance.
      *
@@ -27,6 +29,11 @@ declare class VirtualShell {
      * @param basePath Optional base path for the virtual filesystem (defaults to process.cwd()).
      */
     constructor(hostname: string, properties?: ShellProperties, basePath?: string);
+    /**
+     * Ensures initialization is complete before allowing operations.
+     * Call this before any authentication or command execution.
+     */
+    ensureInitialized(): Promise<void>;
     /**
      * Registers a new command in the shell runtime.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AAEA,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,YAAY;IACjB,QAAQ,EAAE,MAAM,CAAO;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAE5B;;;;;;OAMG;gBAEF,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE,MAAM;IAqBlB;;;;;;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;IAIrE;;;;;;;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;IAcP;;;;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;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"}

package/dist/VirtualShell/index.js

@@ -1,4 +1,5 @@
 import { randomBytes } from "node:crypto";
+import { EventEmitter } from "node:events";
 import { createCustomCommand, registerCommand, runCommand } from "../commands";
 import VirtualFileSystem from "../VirtualFileSystem";
 import { VirtualUserManager } from "../VirtualUserManager";
@@ -30,12 +31,13 @@ function resolveAutoSudoForNewUsers() {
  * Instances are used both by the SSH server facade and by the programmatic
  * client API.
  */
-class VirtualShell {
+class VirtualShell extends EventEmitter {
     basePath = ".";
     vfs;
     users;
     hostname;
     properties;
+    initialized;
     /**
      * Creates a new virtual shell instance.
      *
@@ -44,15 +46,28 @@ class VirtualShell {
      * @param basePath Optional base path for the virtual filesystem (defaults to process.cwd()).
      */
     constructor(hostname, properties, basePath) {
+        super();
         this.hostname = hostname;
         this.properties = properties || defaultShellProperties;
         this.basePath = basePath || ".";
         this.vfs = new VirtualFileSystem(this.basePath);
         this.users = new VirtualUserManager(this.vfs, resolveRootPassword(), resolveAutoSudoForNewUsers());
-        this.vfs.restoreMirror().then(() => {
-            this.users = new VirtualUserManager(this.vfs, resolveRootPassword(), resolveAutoSudoForNewUsers());
-            this.users.initialize();
-        });
+        // Store references to avoid TypeScript "used before assigned" errors
+        const vfs = this.vfs;
+        const users = this.users;
+        // Initialize both VFS mirror and users, ensuring all is ready before auth
+        this.initialized = (async () => {
+            await vfs.restoreMirror();
+            await users.initialize();
+            this.emit("initialized");
+        })();
+    }
+    /**
+     * Ensures initialization is complete before allowing operations.
+     * Call this before any authentication or command execution.
+     */
+    async ensureInitialized() {
+        await this.initialized;
     }
     /**
      * Registers a new command in the shell runtime.
@@ -77,6 +92,7 @@ class VirtualShell {
      */
     executeCommand(rawInput, authUser, cwd) {
         runCommand(rawInput, authUser, this.hostname, "shell", cwd, this);
+        this.emit("command", { command: rawInput, user: authUser, cwd });
     }
     /**
      * Starts an interactive session with the shell.
@@ -88,6 +104,7 @@ class VirtualShell {
      */
     startInteractiveSession(stream, authUser, sessionId, remoteAddress, terminalSize) {
         // Interactive shell logic
+        this.emit("session:start", { user: authUser, sessionId, remoteAddress });
         startShell(this.properties, stream, authUser, this.hostname, sessionId, remoteAddress, terminalSize, this);
     }
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/shell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC;AAMvD,OAAO,EAGN,KAAK,YAAY,EAEjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAmBpD,wBAAgB,UAAU,CACzB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,oBAAY,EACzB,YAAY,EAAE,YAAY,YAAyB,EACnD,KAAK,EAAE,YAAY,GACjB,IAAI,CAulBN"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/shell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC;AAMvD,OAAO,EAGN,KAAK,YAAY,EAEjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAmBpD,wBAAgB,UAAU,CACzB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,oBAAY,EACzB,YAAY,EAAE,YAAY,YAAyB,EACnD,KAAK,EAAE,YAAY,GACjB,IAAI,CA8lBN"}

package/dist/VirtualShell/shell.js

@@ -312,6 +312,13 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
         for (let i = 0; i < input.length; i += 1) {
             const ch = input[i];
             if (ch === "\u0004") {
+                lineBuffer = "";
+                cursorPos = 0;
+                historyIndex = null;
+                historyDraft = "";
+                stream.write("bye\r\n");
+                pushHistory("bye");
+                await shell.vfs.flushMirror();
                 stream.write("logout\r\n");
                 stream.exit(0);
                 stream.end();

package/dist/VirtualUserManager/index.d.ts

@@ -1,3 +1,4 @@
+import { EventEmitter } from "node:events";
 import type VirtualFileSystem from "../VirtualFileSystem";
 /** Persisted virtual user credential record. */
 export interface VirtualUserRecord {
@@ -26,7 +27,7 @@ export interface VirtualActiveSession {
  *
  * Passwords are hashed with scrypt and stored in the backing virtual filesystem.
  */
-export declare class VirtualUserManager {
+export declare class VirtualUserManager extends EventEmitter {
     private readonly vfs;
     private readonly defaultRootPassword;
     private readonly autoSudoForNewUsers;
@@ -49,6 +50,7 @@ export declare class VirtualUserManager {
     constructor(vfs: VirtualFileSystem, defaultRootPassword?: string, autoSudoForNewUsers?: boolean);
     /**
      * Loads users/sudoers from disk and ensures root account exists.
+     * Also creates the current system user if not already present.
      */
     initialize(): Promise<void>;
     /**

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

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