typescript-virtual-container 1.2.4 → 1.2.6

package/dist/VirtualShell/index.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
 import type { CommandContext, CommandResult } from "../types/commands";
 import type { ShellStream } from "../types/streams";
-import VirtualFileSystem from "../VirtualFileSystem";
+import VirtualFileSystem, { type VfsOptions } from "../VirtualFileSystem";
 import { VirtualUserManager } from "../VirtualUserManager";
 export interface ShellProperties {
     kernel: string;
@@ -15,7 +15,6 @@ export interface ShellProperties {
  * client API.
  */
 declare class VirtualShell extends EventEmitter {
-    basePath: string;
     vfs: VirtualFileSystem;
     users: VirtualUserManager;
     hostname: string;
@@ -26,9 +25,9 @@ declare class VirtualShell extends EventEmitter {
      *
      * @param hostname Virtual hostname used for prompts and idents.
      * @param properties Customizable properties shown in `uname -a` and similar commands.
-     * @param basePath Optional base path for the virtual filesystem (defaults to process.cwd()).
+     * @param vfsOptions Optional VFS persistence options (mode, snapshotPath).
      */
-    constructor(hostname: string, properties?: ShellProperties, basePath?: string);
+    constructor(hostname: string, properties?: ShellProperties, vfsOptions?: VfsOptions);
     /**
      * Ensures initialization is complete before allowing operations.
      * Call this before any authentication or command execution.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AAAA,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;AAmBD;;;;;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;IAsBlB;;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AAAA,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,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1E,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;AAmBD;;;;;GAKG;AACH,cAAM,YAAa,SAAQ,YAAY;IACtC,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,UAAU,CAAC,EAAE,UAAU;IAqBxB;;;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"}

package/dist/VirtualShell/index.js

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
 import { createCustomCommand, registerCommand, runCommand } from "../commands";
 import { createPerfLogger } from "../utils/perfLogger";
-import VirtualFileSystem from "../VirtualFileSystem";
+import VirtualFileSystem, {} from "../VirtualFileSystem";
 import { VirtualUserManager } from "../VirtualUserManager";
 import { startShell } from "./shell";
 const defaultShellProperties = {
@@ -24,7 +24,6 @@ function resolveAutoSudoForNewUsers() {
  * client API.
  */
 class VirtualShell extends EventEmitter {
-    basePath = ".";
     vfs;
     users;
     hostname;
@@ -35,15 +34,14 @@ class VirtualShell extends EventEmitter {
      *
      * @param hostname Virtual hostname used for prompts and idents.
      * @param properties Customizable properties shown in `uname -a` and similar commands.
-     * @param basePath Optional base path for the virtual filesystem (defaults to process.cwd()).
+     * @param vfsOptions Optional VFS persistence options (mode, snapshotPath).
      */
-    constructor(hostname, properties, basePath) {
+    constructor(hostname, properties, vfsOptions) {
         super();
         perf.mark("constructor");
         this.hostname = hostname;
         this.properties = properties || defaultShellProperties;
-        this.basePath = basePath || ".";
-        this.vfs = new VirtualFileSystem(this.basePath);
+        this.vfs = new VirtualFileSystem(vfsOptions ?? {});
         this.users = new VirtualUserManager(this.vfs, resolveAutoSudoForNewUsers());
         // Store references to avoid TypeScript "used before assigned" errors
         const vfs = this.vfs;

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,CA8lBN"}
+{"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;AAOvD,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,CA8mBN"}

package/dist/VirtualShell/shell.js

@@ -1,6 +1,6 @@
 import { readFile, unlink, writeFile } from "node:fs/promises";
 import * as path from "node:path";
-import { getCommandNames, runCommand } from "../commands";
+import { getCommandNames, makeDefaultEnv, runCommand } from "../commands";
 import { spawnHtopProcess, spawnNanoEditorProcess, } from "../modules/shellInteractive";
 import { getVisibleHtopPidList, resolvePath, toTtyLines, } from "../modules/shellRuntime";
 import { formatLoginDate } from "../SSHMimic/loginFormat";
@@ -12,6 +12,7 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
     let historyIndex = null;
     let historyDraft = "";
     let cwd = `/home/${authUser}`;
+    const shellEnv = makeDefaultEnv(authUser, hostname);
     let nanoSession = null;
     let pendingSudo = null;
     const buildCurrentPrompt = () => {
@@ -21,6 +22,22 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
     };
     const commandNames = Array.from(new Set(getCommandNames())).sort();
     console.log(`[${sessionId}] Shell started for user '${authUser}' at ${remoteAddress}`);
+    // Load .bashrc if it exists
+    void (async () => {
+        const bashrcPath = `/home/${authUser}/.bashrc`;
+        if (shell.vfs.exists(bashrcPath)) {
+            try {
+                const bashrc = shell.vfs.readFile(bashrcPath);
+                for (const line of bashrc.split("\n")) {
+                    const l = line.trim();
+                    if (!l || l.startsWith("#"))
+                        continue;
+                    await runCommand(l, authUser, hostname, "shell", cwd, shell, undefined, shellEnv);
+                }
+            }
+            catch { /* ignore bashrc errors */ }
+        }
+    })();
     function renderLine() {
         const prompt = buildCurrentPrompt();
         stream.write(`\r${prompt}${lineBuffer}\u001b[K`);
@@ -404,7 +421,7 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
                 historyDraft = "";
                 stream.write("\r\n");
                 if (line.length > 0) {
-                    const result = await Promise.resolve(runCommand(line, authUser, hostname, "shell", cwd, shell));
+                    const result = await Promise.resolve(runCommand(line, authUser, hostname, "shell", cwd, shell, undefined, shellEnv));
                     pushHistory(line);
                     if (result.openEditor) {
                         await startNanoEditor(result.openEditor.targetPath, result.openEditor.initialContent, result.openEditor.tempPath);

package/dist/VirtualShell/shellParser.d.ts

@@ -1,4 +1,22 @@
-import type { Pipeline } from "../types/pipeline";
-/** Parse a shell command line into a structured pipeline */
+import type { Pipeline, Script } from "../types/pipeline";
+/**
+ * Parse a shell input line into a Script (sequence of statements connected
+ * by && / || / ;).  Each statement contains one Pipeline (commands connected
+ * by |).
+ */
+export declare function parseScript(rawInput: string): Script;
+/** Legacy compat: parse a single pipeline (no &&/||/;) */
 export declare function parseShellPipeline(rawInput: string): Pipeline;
+/**
+ * Expand ~ and $VAR / ${VAR} / ${VAR:-default} / $(cmd placeholder) in a
+ * token, given the current env vars and home path.
+ * Command substitution $(…) is NOT executed here — it's left as a marker so
+ * the executor can handle it.
+ */
+export declare function expandToken(token: string, env: Record<string, string>, authUser: string, lastExitCode?: number): string;
+/**
+ * Expand glob patterns (*, ?, [abc]) against a list of entries.
+ * Returns the original pattern if no match.
+ */
+export declare function expandGlob(pattern: string, entries: string[]): string[];
 //# sourceMappingURL=shellParser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shellParser.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/shellParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAEnE,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAkC7D"}
+{"version":3,"file":"shellParser.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/shellParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,EAAwB,MAAM,mBAAmB,CAAC;AAIjG;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAS7D;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,SAAI,GACd,MAAM,CA4BR;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKvE"}

package/dist/VirtualShell/shellParser.js

@@ -1,91 +1,225 @@
-/** Parse a shell command line into a structured pipeline */
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Parse a shell input line into a Script (sequence of statements connected
+ * by && / || / ;).  Each statement contains one Pipeline (commands connected
+ * by |).
+ */
+export function parseScript(rawInput) {
+    const trimmed = rawInput.trim();
+    if (!trimmed)
+        return { statements: [], isValid: true };
+    try {
+        const statements = parseStatements(trimmed);
+        return { statements, isValid: true };
+    }
+    catch (e) {
+        return { statements: [], isValid: false, error: e.message };
+    }
+}
+/** Legacy compat: parse a single pipeline (no &&/||/;) */
 export function parseShellPipeline(rawInput) {
     const trimmed = rawInput.trim();
-    if (!trimmed) {
+    if (!trimmed)
         return { commands: [], isValid: true };
+    try {
+        const commands = parsePipeline(trimmed);
+        return { commands, isValid: true };
     }
-    const commands = [];
-    const tokenized = tokenizePipeline(trimmed);
-    if (tokenized.error) {
-        return {
-            commands: [],
-            isValid: false,
-            error: tokenized.error,
-        };
+    catch (e) {
+        return { commands: [], isValid: false, error: e.message };
     }
-    const pipeTokens = tokenized.tokens;
-    for (const token of pipeTokens) {
-        const cmd = parseCommandWithRedirections(token);
-        if (!cmd.isValid) {
-            return {
-                commands: [],
-                isValid: false,
-                error: cmd.error,
-            };
-        }
-        if (cmd.command) {
-            commands.push(cmd.command);
+}
+// ── Variable & tilde expansion ────────────────────────────────────────────────
+/**
+ * Expand ~ and $VAR / ${VAR} / ${VAR:-default} / $(cmd placeholder) in a
+ * token, given the current env vars and home path.
+ * Command substitution $(…) is NOT executed here — it's left as a marker so
+ * the executor can handle it.
+ */
+export function expandToken(token, env, authUser, lastExitCode = 0) {
+    // tilde expansion
+    token = token.replace(/^~(\/|$)/, `/home/${authUser}$1`);
+    // $? special var
+    token = token.replace(/\$\?/g, String(lastExitCode));
+    // $$ PID (mock)
+    token = token.replace(/\$\$/g, "1");
+    // $# argc (0 for interactive)
+    token = token.replace(/\$#/g, "0");
+    // ${VAR:-default} and ${VAR:+value}
+    token = token.replace(/\$\{([^}:]+):-([^}]*)\}/g, (_, name, def) => env[name] ?? def);
+    token = token.replace(/\$\{([^}:]+):\+([^}]*)\}/g, (_, name, val) => env[name] ? val : "");
+    // ${VAR}
+    token = token.replace(/\$\{([^}]+)\}/g, (_, name) => env[name] ?? "");
+    // $VAR (greedy: match longest valid identifier)
+    token = token.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => env[name] ?? "");
+    return token;
+}
+/**
+ * Expand glob patterns (*, ?, [abc]) against a list of entries.
+ * Returns the original pattern if no match.
+ */
+export function expandGlob(pattern, entries) {
+    if (!/[*?[]/.test(pattern))
+        return [pattern];
+    const regex = globToRegex(pattern);
+    const matches = entries.filter((e) => regex.test(e));
+    return matches.length > 0 ? matches.sort() : [pattern];
+}
+function globToRegex(pattern) {
+    let re = "^";
+    for (let i = 0; i < pattern.length; i++) {
+        const c = pattern[i];
+        if (c === "*")
+            re += ".*";
+        else if (c === "?")
+            re += ".";
+        else if (c === "[") {
+            const close = pattern.indexOf("]", i + 1);
+            if (close === -1)
+                re += "\\[";
+            else {
+                re += `[${pattern.slice(i + 1, close)}]`;
+                i = close;
+            }
         }
+        else
+            re += c.replace(/[.+^${}()|[\]\\]/g, "\\$&");
     }
-    return { commands, isValid: true };
+    return new RegExp(`${re}$`);
 }
-/** Tokenize input by pipes, respecting quoted strings */
-function tokenizePipeline(input) {
-    const tokens = [];
+// ── Internal parser ───────────────────────────────────────────────────────────
+function parseStatements(input) {
+    // Split by ;, &&, || — respecting quotes and parens
+    const segments = splitByLogicalOps(input);
+    const statements = [];
+    for (const seg of segments) {
+        const commands = parsePipeline(seg.text.trim());
+        const stmt = { pipeline: { commands, isValid: true } };
+        if (seg.op)
+            stmt.op = seg.op;
+        statements.push(stmt);
+    }
+    return statements;
+}
+function splitByLogicalOps(input) {
+    const segments = [];
     let current = "";
-    let inQuotes = false;
-    let quoteChar = "";
+    let depth = 0; // parens/subshell depth
+    let inQ = false;
+    let qChar = "";
     let i = 0;
+    const flush = (op) => {
+        if (current.trim())
+            segments.push({ text: current, op });
+        current = "";
+    };
     while (i < input.length) {
         const ch = input[i];
-        if ((ch === '"' || ch === "'") && (i === 0 || input[i - 1] !== "\\")) {
-            if (!inQuotes) {
-                inQuotes = true;
-                quoteChar = ch;
-            }
-            else if (ch === quoteChar) {
-                inQuotes = false;
-            }
+        const ch2 = input.slice(i, i + 2);
+        if ((ch === '"' || ch === "'") && !inQ) {
+            inQ = true;
+            qChar = ch;
             current += ch;
             i++;
+            continue;
         }
-        else if (ch === "|" && !inQuotes) {
-            if (!current.trim()) {
-                return {
-                    tokens: [],
-                    error: "Syntax error near unexpected token '|'",
-                };
-            }
-            tokens.push(current.trim());
-            current = "";
+        if (inQ && ch === qChar) {
+            inQ = false;
+            current += ch;
             i++;
+            continue;
         }
-        else {
+        if (inQ) {
             current += ch;
             i++;
+            continue;
         }
+        if (ch === "(") {
+            depth++;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === ")") {
+            depth--;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (depth > 0) {
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch2 === "&&") {
+            flush("&&");
+            i += 2;
+            continue;
+        }
+        if (ch2 === "||") {
+            flush("||");
+            i += 2;
+            continue;
+        }
+        if (ch === ";") {
+            flush(";");
+            i++;
+            continue;
+        }
+        current += ch;
+        i++;
     }
-    if (inQuotes) {
-        return {
-            tokens: [],
-            error: "Syntax error: unterminated quote",
-        };
-    }
-    if (!current.trim()) {
-        return {
-            tokens: [],
-            error: "Syntax error near unexpected token '|'",
-        };
+    flush();
+    return segments;
+}
+function parsePipeline(input) {
+    const pipeTokens = splitByPipe(input);
+    return pipeTokens.map(parseCommandWithRedirections);
+}
+function splitByPipe(input) {
+    const tokens = [];
+    let current = "";
+    let inQ = false;
+    let qChar = "";
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        if ((ch === '"' || ch === "'") && !inQ) {
+            inQ = true;
+            qChar = ch;
+            current += ch;
+            continue;
+        }
+        if (inQ && ch === qChar) {
+            inQ = false;
+            current += ch;
+            continue;
+        }
+        if (inQ) {
+            current += ch;
+            continue;
+        }
+        // || was already consumed at statement level, bare | is pipe
+        if (ch === "|" && input[i + 1] !== "|") {
+            if (!current.trim())
+                throw new Error("Syntax error near unexpected token '|'");
+            tokens.push(current.trim());
+            current = "";
+        }
+        else {
+            current += ch;
+        }
     }
-    tokens.push(current.trim());
-    return { tokens };
+    const tail = current.trim();
+    if (!tail && tokens.length > 0)
+        throw new Error("Syntax error near unexpected token '|'");
+    if (tail)
+        tokens.push(tail);
+    return tokens;
 }
-/** Parse a single command with its redirections (>, >>, <) */
 function parseCommandWithRedirections(token) {
     const parts = tokenizeCommand(token);
-    if (parts.length === 0) {
-        return { isValid: true };
-    }
+    if (parts.length === 0)
+        return { name: "", args: [] };
     const cmdParts = [];
     let inputFile;
     let outputFile;
@@ -95,35 +229,23 @@ function parseCommandWithRedirections(token) {
         const part = parts[i];
         if (part === "<") {
             i++;
-            if (i >= parts.length) {
-                return {
-                    isValid: false,
-                    error: "Syntax error: expected filename after <",
-                };
-            }
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after <");
             inputFile = parts[i];
             i++;
         }
         else if (part === ">>") {
             i++;
-            if (i >= parts.length) {
-                return {
-                    isValid: false,
-                    error: "Syntax error: expected filename after >>",
-                };
-            }
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after >>");
             outputFile = parts[i];
             appendOutput = true;
             i++;
         }
         else if (part === ">") {
             i++;
-            if (i >= parts.length) {
-                return {
-                    isValid: false,
-                    error: "Syntax error: expected filename after >",
-                };
-            }
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after >");
             outputFile = parts[i];
             appendOutput = false;
             i++;
@@ -133,55 +255,44 @@ function parseCommandWithRedirections(token) {
             i++;
         }
     }
-    if (cmdParts.length === 0) {
-        return { isValid: true };
-    }
-    const name = cmdParts[0].toLowerCase();
-    const args = cmdParts.slice(1);
-    return {
-        command: {
-            name,
-            args,
-            inputFile,
-            outputFile,
-            appendOutput,
-        },
-        isValid: true,
-    };
+    const name = (cmdParts[0] ?? "").toLowerCase();
+    return { name, args: cmdParts.slice(1), inputFile, outputFile, appendOutput };
 }
-/** Tokenize a command, respecting quotes and handling >> vs > */
 function tokenizeCommand(input) {
     const tokens = [];
     let current = "";
-    let inQuotes = false;
-    let quoteChar = "";
+    let inQ = false;
+    let qChar = "";
     let i = 0;
     while (i < input.length) {
         const ch = input[i];
         const next = input[i + 1];
-        // Handle quotes
-        if ((ch === '"' || ch === "'") && (i === 0 || input[i - 1] !== "\\")) {
-            if (!inQuotes) {
-                inQuotes = true;
-                quoteChar = ch;
-            }
-            else if (ch === quoteChar) {
-                inQuotes = false;
-                quoteChar = "";
-            }
-            else {
-                current += ch;
-            }
+        if ((ch === '"' || ch === "'") && !inQ) {
+            inQ = true;
+            qChar = ch;
+            i++;
+            continue;
+        }
+        if (inQ && ch === qChar) {
+            inQ = false;
+            qChar = "";
             i++;
+            continue;
         }
-        else if (ch === " " && !inQuotes) {
+        if (inQ) {
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === " ") {
             if (current) {
                 tokens.push(current);
                 current = "";
             }
             i++;
+            continue;
         }
-        else if ((ch === ">" || ch === "<") && !inQuotes) {
+        if ((ch === ">" || ch === "<") && !inQ) {
             if (current) {
                 tokens.push(current);
                 current = "";
@@ -194,14 +305,12 @@ function tokenizeCommand(input) {
                 tokens.push(ch);
                 i++;
             }
+            continue;
         }
-        else {
-            current += ch;
-            i++;
-        }
+        current += ch;
+        i++;
     }
-    if (current) {
+    if (current)
         tokens.push(current);
-    }
     return tokens;
 }

package/dist/VirtualUserManager/index.d.ts

@@ -189,5 +189,30 @@ export declare class VirtualUserManager extends EventEmitter {
     hashPassword(password: string): string;
     private validateUsername;
     private validatePassword;
+    private readonly authorizedKeys;
+    /**
+     * Adds an SSH public key for a user, enabling public-key authentication.
+     *
+     * @param username Target user.
+     * @param algo Key algorithm (e.g. "ssh-rsa", "ssh-ed25519").
+     * @param data Raw key data as a Buffer (the base64-decoded key bytes).
+     */
+    addAuthorizedKey(username: string, algo: string, data: Buffer): void;
+    /**
+     * Removes all authorized keys for a user.
+     *
+     * @param username Target user.
+     */
+    removeAuthorizedKeys(username: string): void;
+    /**
+     * Returns the list of authorized keys for a user.
+     * Returns an empty array when no keys are registered.
+     *
+     * @param username Target user.
+     */
+    getAuthorizedKeys(username: string): Array<{
+        algo: string;
+        data: Buffer;
+    }>;
 }
 //# sourceMappingURL=index.d.ts.map

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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"}