typescript-virtual-container 1.2.4 → 1.2.5

package/dist/commands/index.js

@@ -1,19 +1,25 @@
 import { adduserCommand } from "./adduser";
 import { catCommand } from "./cat";
 import { cdCommand } from "./cd";
+import { chmodCommand } from "./chmod";
 import { clearCommand } from "./clear";
+import { cpCommand } from "./cp";
 import { curlCommand } from "./curl";
 import { deluserCommand } from "./deluser";
 import { echoCommand } from "./echo";
 import { envCommand } from "./env";
 import { exitCommand } from "./exit";
 import { exportCommand } from "./export";
+import { findCommand } from "./find";
 import { grepCommand } from "./grep";
+import { headCommand } from "./head";
 import { createHelpCommand } from "./help";
 import { hostnameCommand } from "./hostname";
 import { htopCommand } from "./htop";
+import { lnCommand } from "./ln";
 import { lsCommand } from "./ls";
 import { mkdirCommand } from "./mkdir";
+import { mvCommand } from "./mv";
 import { nanoCommand } from "./nano";
 import { neofetchCommand } from "./neofetch";
 import { passwdCommand } from "./passwd";
@@ -23,9 +29,11 @@ import { setCommand } from "./set";
 import { shCommand } from "./sh";
 import { suCommand } from "./su";
 import { sudoCommand } from "./sudo";
+import { tailCommand } from "./tail";
 import { touchCommand } from "./touch";
 import { treeCommand } from "./tree";
 import { unsetCommand } from "./unset";
+import { wcCommand } from "./wc";
 import { wgetCommand } from "./wget";
 import { whoCommand } from "./who";
 import { whoamiCommand } from "./whoami";
@@ -60,12 +68,21 @@ const BASE_COMMANDS = [
     shCommand,
     clearCommand,
     exitCommand,
+    cpCommand,
+    mvCommand,
+    lnCommand,
+    findCommand,
+    wcCommand,
+    headCommand,
+    tailCommand,
+    chmodCommand,
 ];
 const customCommands = [];
 const helpCommand = createHelpCommand(() => getCommandModules().map((cmd) => cmd.name));
 const commandRegistry = new Map();
 let cachedCommandNames = null;
 function buildCache() {
+    commandRegistry.clear();
     for (const mod of getCommandModules()) {
         commandRegistry.set(mod.name, mod);
         for (const alias of mod.aliases ?? []) {
@@ -75,13 +92,6 @@ function buildCache() {
     cachedCommandNames = Array.from(commandRegistry.keys()).sort();
 }
 function getCommandModules() {
-    // console.log("Loading command modules...");
-    // console.log(
-    // 	`Base commands: ${BASE_COMMANDS.map((cmd) => cmd.name).join(", ")}`,
-    // );
-    // console.log(
-    // 	`Custom commands: ${customCommands.map((cmd) => cmd.name).join(", ")}`,
-    // );
     return [...BASE_COMMANDS, ...customCommands, helpCommand];
 }
 export function registerCommand(module) {
@@ -94,31 +104,20 @@ export function registerCommand(module) {
     if (names.some((name) => name.length === 0 || /\s/.test(name))) {
         throw new Error("Command names and aliases must be non-empty and contain no spaces");
     }
-    for (const name of names) {
-        if (commandRegistry.has(name)) {
-            throw new Error(`Command '${name}' already exists`);
-        }
-        commandRegistry.set(name, normalized);
-    }
+    customCommands.push(normalized);
     buildCache();
 }
 export function createCustomCommand(name, params, run) {
-    return {
-        name,
-        params,
-        run,
-    };
+    return { name, params, run };
 }
 export function getCommandNames() {
-    if (!cachedCommandNames) {
+    if (!cachedCommandNames)
         buildCache();
-    }
     return cachedCommandNames;
 }
 export function resolveModule(name) {
-    if (!cachedCommandNames) {
+    if (!cachedCommandNames)
         buildCache();
-    }
     return commandRegistry.get(name.toLowerCase());
 }
 function splitArgsRespectingQuotes(input) {
@@ -150,9 +149,8 @@ function splitArgsRespectingQuotes(input) {
         }
         current += ch;
     }
-    if (current.length > 0) {
+    if (current.length > 0)
         tokens.push(current);
-    }
     return tokens;
 }
 function parseInput(rawInput) {
@@ -162,21 +160,16 @@ function parseInput(rawInput) {
         args: parts.slice(1),
     };
 }
-// Internal async function for pipeline execution
 export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell, stdin) {
     const trimmed = rawInput.trim();
-    if (trimmed.length === 0) {
+    if (trimmed.length === 0)
         return { exitCode: 0 };
-    }
     if (trimmed.includes("|") || trimmed.includes(">") || trimmed.includes("<")) {
         const { parseShellPipeline } = await import("../VirtualShell/shellParser");
         const { executePipeline } = await import("../SSHMimic/executor");
         const pipeline = parseShellPipeline(trimmed);
         if (!pipeline.isValid) {
-            return {
-                stderr: pipeline.error || "Syntax error",
-                exitCode: 1,
-            };
+            return { stderr: pipeline.error || "Syntax error", exitCode: 1 };
         }
         try {
             return await executePipeline(pipeline, authUser, hostname, mode, cwd, shell);
@@ -189,10 +182,7 @@ export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell,
     const { commandName, args } = parseInput(trimmed);
     const mod = resolveModule(commandName);
     if (!mod) {
-        return {
-            stderr: `Command '${trimmed}' not found`,
-            exitCode: 127,
-        };
+        return { stderr: `Command '${trimmed}' not found`, exitCode: 127 };
     }
     try {
         return await mod.run({

package/dist/commands/ln.d.ts

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

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

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

package/dist/commands/ln.js

@@ -0,0 +1,42 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const lnCommand = {
+    name: "ln",
+    params: ["[-s] <target> <link_name>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const symbolic = ifFlag(args, ["-s", "--symbolic"]);
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const [targetArg, linkArg] = positionals;
+        if (!targetArg || !linkArg) {
+            return { stderr: "ln: missing operand", exitCode: 1 };
+        }
+        const linkPath = resolvePath(cwd, linkArg);
+        const targetPath = symbolic
+            ? targetArg // keep relative for symlinks
+            : resolvePath(cwd, targetArg);
+        try {
+            assertPathAccess(authUser, linkPath, "ln");
+            if (!symbolic) {
+                // Hard link — copy file contents
+                const srcPath = resolvePath(cwd, targetArg);
+                assertPathAccess(authUser, srcPath, "ln");
+                if (!shell.vfs.exists(srcPath)) {
+                    return {
+                        stderr: `ln: ${targetArg}: No such file or directory`,
+                        exitCode: 1,
+                    };
+                }
+                const content = shell.vfs.readFile(srcPath);
+                shell.writeFileAsUser(authUser, linkPath, content);
+            }
+            else {
+                shell.vfs.symlink(targetPath, linkPath);
+            }
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `ln: ${msg}`, exitCode: 1 };
+        }
+    },
+};

package/dist/commands/mv.d.ts

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

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

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

package/dist/commands/mv.js

@@ -0,0 +1,35 @@
+import { assertPathAccess, resolvePath } from "./helpers";
+export const mvCommand = {
+    name: "mv",
+    params: ["<source> <dest>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const [srcArg, destArg] = positionals;
+        if (!srcArg || !destArg) {
+            return { stderr: "mv: missing operand", exitCode: 1 };
+        }
+        const srcPath = resolvePath(cwd, srcArg);
+        const destPath = resolvePath(cwd, destArg);
+        try {
+            assertPathAccess(authUser, srcPath, "mv");
+            assertPathAccess(authUser, destPath, "mv");
+            if (!shell.vfs.exists(srcPath)) {
+                return {
+                    stderr: `mv: ${srcArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+            // If dest is a directory, move into it
+            const finalDest = shell.vfs.exists(destPath) &&
+                shell.vfs.stat(destPath).type === "directory"
+                ? `${destPath}/${srcArg.split("/").pop()}`
+                : destPath;
+            shell.vfs.move(srcPath, finalDest);
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `mv: ${msg}`, exitCode: 1 };
+        }
+    },
+};

package/dist/commands/tail.d.ts

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

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

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

package/dist/commands/tail.js

@@ -0,0 +1,33 @@
+import { getFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const tailCommand = {
+    name: "tail",
+    params: ["[-n <lines>] [file...]"],
+    run: ({ authUser, shell, cwd, args, stdin }) => {
+        const nArg = getFlag(args, ["-n"]);
+        const n = typeof nArg === "string" ? parseInt(nArg, 10) : 10;
+        const positionals = args.filter((a) => !a.startsWith("-") && a !== nArg);
+        const take = (content) => {
+            const lines = content.split("\n");
+            return lines.slice(Math.max(0, lines.length - n)).join("\n");
+        };
+        if (positionals.length === 0) {
+            return { stdout: take(stdin ?? ""), exitCode: 0 };
+        }
+        const results = [];
+        for (const file of positionals) {
+            const filePath = resolvePath(cwd, file);
+            try {
+                assertPathAccess(authUser, filePath, "tail");
+                results.push(take(shell.vfs.readFile(filePath)));
+            }
+            catch {
+                return {
+                    stderr: `tail: ${file}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+        }
+        return { stdout: results.join("\n"), 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,WA2CvB,CAAC"}

package/dist/commands/wc.js

@@ -0,0 +1,48 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const wcCommand = {
+    name: "wc",
+    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/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/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "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}."