typescript-virtual-container 1.2.4 → 1.2.6

package/dist/commands/touch.js

@@ -1,6 +1,8 @@
 import { assertPathAccess, resolvePath } from "./helpers";
 export const touchCommand = {
     name: "touch",
+    description: "Create or update files",
+    category: "files",
     params: ["<file>"],
     run: ({ authUser, shell, cwd, args }) => {
         if (args.length === 0) {

package/dist/commands/tr.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const trCommand: ShellModule;
+//# sourceMappingURL=tr.d.ts.map

package/dist/commands/tr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../src/commands/tr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,SAAS,EAAE,WAoBvB,CAAC"}

package/dist/commands/tr.js

@@ -0,0 +1,24 @@
+import { ifFlag } from "./command-helpers";
+export const trCommand = {
+    name: "tr",
+    description: "Translate or delete characters",
+    category: "text",
+    params: ["[-d] <set1> [set2]"],
+    run: ({ args, stdin }) => {
+        const del = ifFlag(args, ["-d"]);
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const set1 = positionals[0] ?? "";
+        const set2 = positionals[1] ?? "";
+        let input = stdin ?? "";
+        if (del) {
+            for (const c of set1)
+                input = input.split(c).join("");
+        }
+        else if (set2) {
+            for (let i = 0; i < set1.length; i++) {
+                input = input.split(set1[i]).join(set2[i] ?? set2[set2.length - 1] ?? "");
+            }
+        }
+        return { stdout: input, exitCode: 0 };
+    },
+};

package/dist/commands/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/commands/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WAQzB,CAAC"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/commands/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WAUzB,CAAC"}

package/dist/commands/tree.js

@@ -2,6 +2,8 @@ import { getArg } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const treeCommand = {
     name: "tree",
+    description: "Display directory tree",
+    category: "navigation",
     params: ["[path]"],
     run: ({ authUser, shell, cwd, args }) => {
         const target = resolvePath(cwd, getArg(args, 0) ?? cwd);

package/dist/commands/uname.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const unameCommand: ShellModule;
+//# sourceMappingURL=uname.d.ts.map

package/dist/commands/uname.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uname.d.ts","sourceRoot":"","sources":["../../src/commands/uname.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WAgB1B,CAAC"}

package/dist/commands/uname.js

@@ -0,0 +1,21 @@
+import { ifFlag } from "./command-helpers";
+export const unameCommand = {
+    name: "uname",
+    description: "Print system information",
+    category: "system",
+    params: ["[-a] [-s] [-r] [-m]"],
+    run: ({ shell, args }) => {
+        const all = ifFlag(args, ["-a"]);
+        const sysname = "Linux";
+        const release = shell.properties?.kernel ?? "5.15.0";
+        const machine = shell.properties?.arch ?? "x86_64";
+        const hostname = shell.hostname;
+        if (all)
+            return { stdout: `${sysname} ${hostname} ${release} #1 SMP ${machine} GNU/Linux`, exitCode: 0 };
+        if (ifFlag(args, ["-r"]))
+            return { stdout: release, exitCode: 0 };
+        if (ifFlag(args, ["-m"]))
+            return { stdout: machine, exitCode: 0 };
+        return { stdout: sysname, exitCode: 0 };
+    },
+};

package/dist/commands/uniq.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const uniqCommand: ShellModule;
+//# sourceMappingURL=uniq.d.ts.map

package/dist/commands/uniq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq.d.ts","sourceRoot":"","sources":["../../src/commands/uniq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WAwBzB,CAAC"}

package/dist/commands/uniq.js

@@ -0,0 +1,33 @@
+import { ifFlag } from "./command-helpers";
+export const uniqCommand = {
+    name: "uniq",
+    description: "Report or filter out repeated lines",
+    category: "text",
+    params: ["[-c] [-d] [-u] [file]"],
+    run: ({ args, stdin }) => {
+        const count = ifFlag(args, ["-c"]);
+        const dupOnly = ifFlag(args, ["-d"]);
+        const uniqOnly = ifFlag(args, ["-u"]);
+        const lines = (stdin ?? "").split("\n");
+        const out = [];
+        let i = 0;
+        while (i < lines.length) {
+            let j = i;
+            while (j < lines.length && lines[j] === lines[i])
+                j++;
+            const n = j - i;
+            const line = lines[i];
+            if (dupOnly && n === 1) {
+                i = j;
+                continue;
+            }
+            if (uniqOnly && n > 1) {
+                i = j;
+                continue;
+            }
+            out.push(count ? `${String(n).padStart(4)} ${line}` : line);
+            i = j;
+        }
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/unset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unset.d.ts","sourceRoot":"","sources":["../../src/commands/unset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WAe1B,CAAC"}
+{"version":3,"file":"unset.d.ts","sourceRoot":"","sources":["../../src/commands/unset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WAS1B,CAAC"}

package/dist/commands/unset.js

@@ -1,15 +1,11 @@
-import { setEnvVar } from "./set";
 export const unsetCommand = {
     name: "unset",
-    params: ["<VAR...>"],
-    run: ({ args }) => {
-        if (args.length === 0) {
-            return { stderr: "unset: missing variable name", exitCode: 1 };
-        }
-        // Unset (remove) all specified variables
-        for (const varName of args) {
-            setEnvVar(varName, "");
-        }
+    description: "Remove shell variable",
+    category: "shell",
+    params: ["<VAR>"],
+    run: ({ args, env }) => {
+        for (const name of args)
+            delete env.vars[name];
         return { exitCode: 0 };
     },
 };

package/dist/commands/wc.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const wcCommand: ShellModule;
+//# sourceMappingURL=wc.d.ts.map

package/dist/commands/wc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wc.d.ts","sourceRoot":"","sources":["../../src/commands/wc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WA6CvB,CAAC"}

package/dist/commands/wc.js

@@ -0,0 +1,50 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const wcCommand = {
+    name: "wc",
+    description: "Count words/lines/bytes",
+    category: "text",
+    params: ["[-l] [-w] [-c] [file...]"],
+    run: ({ authUser, shell, cwd, args, stdin }) => {
+        const lines = ifFlag(args, ["-l"]);
+        const words = ifFlag(args, ["-w"]);
+        const bytes = ifFlag(args, ["-c"]);
+        const showAll = !lines && !words && !bytes;
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const count = (content, label) => {
+            const l = content.split("\n").length - (content.endsWith("\n") ? 1 : 0);
+            const w = content.trim().split(/\s+/).filter(Boolean).length;
+            const c = Buffer.byteLength(content, "utf8");
+            const parts = [];
+            if (showAll || lines)
+                parts.push(String(l).padStart(7));
+            if (showAll || words)
+                parts.push(String(w).padStart(7));
+            if (showAll || bytes)
+                parts.push(String(c).padStart(7));
+            if (label)
+                parts.push(` ${label}`);
+            return parts.join("");
+        };
+        if (positionals.length === 0) {
+            const content = stdin ?? "";
+            return { stdout: count(content, ""), exitCode: 0 };
+        }
+        const results = [];
+        for (const file of positionals) {
+            const filePath = resolvePath(cwd, file);
+            try {
+                assertPathAccess(authUser, filePath, "wc");
+                const content = shell.vfs.readFile(filePath);
+                results.push(count(content, file));
+            }
+            catch {
+                return {
+                    stderr: `wc: ${file}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+        }
+        return { stdout: results.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/wget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wget.d.ts","sourceRoot":"","sources":["../../src/commands/wget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA8ErD,eAAO,MAAM,WAAW,EAAE,WA6DzB,CAAC"}
+{"version":3,"file":"wget.d.ts","sourceRoot":"","sources":["../../src/commands/wget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA8ErD,eAAO,MAAM,WAAW,EAAE,WA+DzB,CAAC"}

package/dist/commands/wget.js

@@ -61,6 +61,8 @@ function runHostWget(args) {
 }
 export const wgetCommand = {
     name: "wget",
+    description: "File downloader",
+    category: "network",
     params: ["[url]"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {

package/dist/commands/who.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../../src/commands/who.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,WAcxB,CAAC"}
+{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../../src/commands/who.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,WAgBxB,CAAC"}

package/dist/commands/who.js

@@ -1,6 +1,8 @@
 import { formatLoginDate } from "../SSHMimic/loginFormat";
 export const whoCommand = {
     name: "who",
+    description: "Show active sessions",
+    category: "system",
     params: [],
     run: ({ shell }) => {
         const lines = shell.users.listActiveSessions().map((session) => {

package/dist/commands/whoami.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,WAI3B,CAAC"}
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,WAM3B,CAAC"}

package/dist/commands/whoami.js

@@ -1,5 +1,7 @@
 export const whoamiCommand = {
     name: "whoami",
+    description: "Print current user",
+    category: "system",
     params: [],
     run: ({ authUser }) => ({ stdout: authUser, exitCode: 0 }),
 };

package/dist/commands/xargs.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const xargsCommand: ShellModule;
+//# sourceMappingURL=xargs.d.ts.map

package/dist/commands/xargs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xargs.d.ts","sourceRoot":"","sources":["../../src/commands/xargs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WAa1B,CAAC"}

package/dist/commands/xargs.js

@@ -0,0 +1,16 @@
+import { runCommand } from "./index";
+export const xargsCommand = {
+    name: "xargs",
+    description: "Build and execute command lines from stdin",
+    category: "text",
+    params: ["[command] [args...]"],
+    run: async ({ authUser, hostname, mode, cwd, args, stdin, shell, env }) => {
+        const baseCmd = args[0] ?? "echo";
+        const extraArgs = args.slice(1);
+        const items = (stdin ?? "").trim().split(/\s+/).filter(Boolean);
+        if (items.length === 0)
+            return { exitCode: 0 };
+        const fullCmd = [baseCmd, ...extraArgs, ...items].join(" ");
+        return runCommand(fullCmd, authUser, hostname, mode, cwd, shell, undefined, env);
+    },
+};

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export type { AuditLogEntry, HoneyPotStats, } from "./Honeypot/index";
 export type { CommandContext, CommandMode, CommandOutcome, CommandResult, NanoEditorSession, ShellModule, SudoChallenge, } from "./types/commands";
 export type { ExecStream, ShellStream } from "./types/streams";
 export type { RemoveOptions, VfsBaseNode, VfsDirectoryNode, VfsFileNode, VfsNodeStats, VfsNodeType, VfsSnapshot, VfsSnapshotBaseNode, VfsSnapshotDirectoryNode, VfsSnapshotFileNode, VfsSnapshotNode, WriteFileOptions, } from "./types/vfs";
+export type { VfsOptions, VfsPersistenceMode } from "./VirtualFileSystem/index";
 export { HoneyPot, SshClient, VirtualFileSystem, SftpMimic as VirtualSftpServer, VirtualShell, SshMimic as VirtualSshServer, VirtualUserManager, };
 export { getArg, getFlag, ifFlag, } from "./commands/command-helpers";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EACX,aAAa,EACb,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,SAAS,IAAI,iBAAiB,EAC9B,YAAY,EACZ,QAAQ,IAAI,gBAAgB,EAC5B,kBAAkB,GAClB,CAAC;AAEF,OAAO,EACN,MAAM,EACN,OAAO,EACP,MAAM,GACN,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EACX,aAAa,EACb,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,EACN,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,SAAS,IAAI,iBAAiB,EAC9B,YAAY,EACZ,QAAQ,IAAI,gBAAgB,EAC5B,kBAAkB,GAClB,CAAC;AAEF,OAAO,EACN,MAAM,EACN,OAAO,EACP,MAAM,GACN,MAAM,4BAA4B,CAAC"}

package/dist/types/commands.d.ts

@@ -52,6 +52,13 @@ export interface NanoEditorSession {
     /** Initial editor content shown to user. */
     initialContent: string;
 }
+/** Per-session shell environment (variables, last exit code). */
+export interface ShellEnv {
+    /** Environment variables visible to commands. */
+    vars: Record<string, string>;
+    /** Exit status of the last executed command. */
+    lastExitCode: number;
+}
 /** Runtime context object passed to each command module. */
 export interface CommandContext {
     /** Authenticated user currently bound to stream. */
@@ -72,6 +79,8 @@ export interface CommandContext {
     stdin?: string;
     /** Current working directory for command execution. */
     cwd: string;
+    /** Per-session environment available to command modules. */
+    env: ShellEnv;
 }
 /** Contract implemented by each shell command module. */
 export interface ShellModule {
@@ -83,6 +92,10 @@ export interface ShellModule {
     run: (ctx: CommandContext) => CommandResult | Promise<CommandResult>;
     /** Optional alternative command names. */
     aliases?: string[];
+    /** Short description shown in `help`. */
+    description?: string;
+    /** Category used for grouped help output. */
+    category?: string;
 }
 /** Command return union allowing sync or async handlers. */
 export type CommandOutcome = CommandResult | Promise<CommandResult>;

package/dist/types/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IACjC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"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"}

package/dist/types/pipeline.d.ts

@@ -11,6 +11,8 @@ export interface PipelineCommand {
     /** Append to output file (>> file) */
     appendOutput?: boolean;
 }
+/** Logical operator connecting two statement groups. */
+export type LogicalOp = "&&" | "||" | ";";
 /** Represents a parsed shell pipeline */
 export interface Pipeline {
     /** List of commands in the pipeline */
@@ -20,4 +22,22 @@ export interface Pipeline {
     /** Error message if parsing failed */
     error?: string;
 }
+/** A statement: one pipeline optionally followed by && / || / ; and the next statement */
+export interface Statement {
+    /** Pipeline to execute for this statement. */
+    pipeline: Pipeline;
+    /** Operator connecting this statement to the next one. */
+    op?: LogicalOp;
+    /** Optional next statement in sequence. */
+    next?: Statement;
+}
+/** Top-level parse result for a script. */
+export interface Script {
+    /** Statements contained in the script. */
+    statements: Statement[];
+    /** Whether the script was parsed successfully. */
+    isValid: boolean;
+    /** Optional parse error message. */
+    error?: string;
+}
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/types/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACxB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;AAE1C,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACxB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,0DAA0D;IAC1D,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,MAAM;IACtB,0CAA0C;IAC1C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -27,13 +27,16 @@
     "test": "bunx --bun @biomejs/biome test ./src",
     "build": "tsc --project tsconfig.json",
     "deploy:npm": "npm publish --access public",
+    "bench": "rm -rf .benchmark-shells/ && bun benchmark-virtualshell.ts",
+    "publish-package": "bash ./scripts/publish-package.sh",
     "standalone-build": "bunx esbuild src/standalone.ts --bundle --platform=node --target=node18 --outfile=standalone.js --tree-shaking=true --minify --sourcemap"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.11",
     "@types/bun": "latest",
     "@types/node": "^25.6.0",
-    "@types/ssh2": "^1.15.5"
+    "@types/ssh2": "^1.15.5",
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "typescript": "^5"

package/scripts/publish-package.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  echo "Error: this command must run inside a git repository."
+  exit 1
+fi
+
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "Error: working tree is not clean. Commit or stash your changes first."
+  exit 1
+fi
+
+VERSION="$(node -p "require('./package.json').version")"
+TAG="v${VERSION}"
+
+if [[ -z "${VERSION}" ]]; then
+  echo "Error: package.json version is empty."
+  exit 1
+fi
+
+git fetch --tags --quiet
+
+TAG_EXISTS_LOCAL="false"
+TAG_EXISTS_REMOTE="false"
+
+if git rev-parse --verify --quiet "refs/tags/${TAG}" >/dev/null; then
+  TAG_EXISTS_LOCAL="true"
+fi
+
+if git ls-remote --tags origin "refs/tags/${TAG}" | grep -q .; then
+  TAG_EXISTS_REMOTE="true"
+fi
+
+if [[ "${TAG_EXISTS_LOCAL}" == "true" || "${TAG_EXISTS_REMOTE}" == "true" ]]; then
+  echo "Tag ${TAG} already exists. Deleting existing release/tag before republishing."
+
+  if command -v gh >/dev/null 2>&1; then
+    if gh release view "${TAG}" >/dev/null 2>&1; then
+      gh release delete "${TAG}" --yes
+      echo "GitHub release ${TAG} deleted."
+    fi
+  else
+    echo "gh CLI not found; skipping GitHub release deletion."
+  fi
+
+  if [[ "${TAG_EXISTS_LOCAL}" == "true" ]]; then
+    git tag -d "${TAG}" >/dev/null
+    echo "Local tag ${TAG} deleted."
+  fi
+
+  if [[ "${TAG_EXISTS_REMOTE}" == "true" ]]; then
+    git push --delete origin "${TAG}" >/dev/null
+    echo "Remote tag ${TAG} deleted."
+  fi
+fi
+
+git tag -a "${TAG}" -m "Release ${TAG}"
+git push origin "${TAG}"
+
+echo "Tag ${TAG} pushed."
+
+if command -v gh >/dev/null 2>&1; then
+  gh release create "${TAG}" --title "${TAG}" --generate-notes
+  echo "GitHub release ${TAG} created."
+else
+  echo "gh CLI not found; skipping GitHub release creation."
+fi
+
+echo "Done. The publish workflow should run from tag ${TAG}."

package/src/SSHMimic/exec.ts

@@ -1,4 +1,4 @@
-import { runCommand } from "../commands";
+import { makeDefaultEnv, runCommand } from "../commands";
 import type { ExecStream } from "../types/streams";
 import type { VirtualShell } from "../VirtualShell";
 
@@ -17,7 +17,7 @@ export function runExec(
 	shell: VirtualShell,
 ): void {
 	Promise.resolve(
-		runCommand(cmd, authUser, hostname, "exec", `/home/${authUser}`, shell),
+		runCommand(cmd, authUser, hostname, "exec", `/home/${authUser}`, shell, undefined, makeDefaultEnv(authUser, hostname)),
 	)
 		.then((result) => {
 			if (result.stdout) {