typescript-virtual-container 1.1.1 → 1.1.3

package/dist/modules/shellRuntime.d.ts

@@ -0,0 +1,11 @@
+export interface TerminalSize {
+    cols: number;
+    rows: number;
+}
+export declare function shellQuote(value: string): string;
+export declare function toTtyLines(text: string): string;
+export declare function withTerminalSize(command: string, terminalSize: TerminalSize): string;
+export declare function resolvePath(base: string, inputPath: string): string;
+export declare function collectChildPids(parentPid: number): Promise<number[]>;
+export declare function getVisibleHtopPidList(rootPid?: number): Promise<string | null>;
+//# sourceMappingURL=shellRuntime.d.ts.map

package/dist/modules/shellRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellRuntime.d.ts","sourceRoot":"","sources":["../../src/modules/shellRuntime.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,GACxB,MAAM,CAUR;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB3E;AAED,wBAAsB,qBAAqB,CAC1C,OAAO,SAAc,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB"}

package/dist/modules/shellRuntime.js

@@ -0,0 +1,52 @@
+import { readFile } from "node:fs/promises";
+import * as path from "node:path";
+export function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+export function toTtyLines(text) {
+    return text
+        .replace(/\r\n/g, "\n")
+        .replace(/\r/g, "\n")
+        .replace(/\n/g, "\r\n");
+}
+export function withTerminalSize(command, terminalSize) {
+    const cols = Number.isFinite(terminalSize.cols) && terminalSize.cols > 0
+        ? Math.floor(terminalSize.cols)
+        : 80;
+    const rows = Number.isFinite(terminalSize.rows) && terminalSize.rows > 0
+        ? Math.floor(terminalSize.rows)
+        : 24;
+    return `stty cols ${cols} rows ${rows} 2>/dev/null; ${command}`;
+}
+export function resolvePath(base, inputPath) {
+    if (!inputPath || inputPath.trim() === "" || inputPath === ".") {
+        return base;
+    }
+    return inputPath.startsWith("/")
+        ? path.posix.normalize(inputPath)
+        : path.posix.normalize(path.posix.join(base, inputPath));
+}
+export async function collectChildPids(parentPid) {
+    try {
+        const childrenRaw = await readFile(`/proc/${parentPid}/task/${parentPid}/children`, "utf8");
+        const directChildren = childrenRaw
+            .trim()
+            .split(/\s+/)
+            .filter(Boolean)
+            .map((value) => Number.parseInt(value, 10))
+            .filter((pid) => Number.isInteger(pid) && pid > 0);
+        const nested = await Promise.all(directChildren.map((pid) => collectChildPids(pid)));
+        return [...directChildren, ...nested.flat()];
+    }
+    catch {
+        return [];
+    }
+}
+export async function getVisibleHtopPidList(rootPid = process.pid) {
+    const descendants = await collectChildPids(rootPid);
+    const unique = Array.from(new Set(descendants)).sort((a, b) => a - b);
+    if (unique.length === 0) {
+        return null;
+    }
+    return unique.join(",");
+}

package/dist/standalone.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":""}

package/dist/standalone.js

@@ -0,0 +1,25 @@
+import { VirtualShell, VirtualSshServer } from ".";
+const hostname = process.env.SSH_MIMIC_HOSTNAME ?? "typescript-vm";
+const virtualShell = new VirtualShell(hostname);
+virtualShell.addCommand("demo", [], () => {
+    return {
+        stdout: "This is a demo command. It does nothing useful.",
+        exitCode: 0,
+    };
+});
+new VirtualSshServer({
+    port: 2222,
+    hostname,
+    shell: virtualShell,
+})
+    .start()
+    .then((port) => {
+    // if (!sshMimic) console.error("Failed to initialize SSH Mimic shell.");
+    // else {
+    console.log(`SSH Mimic initialized. Listening on port ${port}.`);
+    // }
+})
+    .catch((error) => {
+    console.error("Failed to start SSH Mimic:", error);
+    process.exit(1);
+});

package/dist/types/commands.d.ts

@@ -0,0 +1,89 @@
+/** Command invocation mode used by shell runtime. */
+export type CommandMode = "shell" | "exec";
+import type { VirtualShell } from "../VirtualShell";
+import type { VirtualActiveSession } from "../VirtualUserManager";
+/**
+ * Normalized command execution output.
+ *
+ * A command can write text, control session lifecycle, request UI state
+ * transitions, and update active identity/cwd.
+ */
+export interface CommandResult {
+    /** Standard output payload to append in terminal. */
+    stdout?: string;
+    /** Standard error payload to append in terminal. */
+    stderr?: string;
+    /** Request full terminal clear before next prompt. */
+    clearScreen?: boolean;
+    /** Request current shell/exec session close. */
+    closeSession?: boolean;
+    /** Optional exit code (default behavior handled by caller). */
+    exitCode?: number;
+    /** Optional cwd to apply for next prompt iteration. */
+    nextCwd?: string;
+    /** Optional user switch for current session state. */
+    switchUser?: string;
+    /** Request opening built-in nano editor workflow. */
+    openEditor?: NanoEditorSession;
+    /** Request opening built-in htop-like screen. */
+    openHtop?: boolean;
+    /** Request sudo password challenge flow. */
+    sudoChallenge?: SudoChallenge;
+}
+/** Deferred sudo challenge metadata returned by sudo command. */
+export interface SudoChallenge {
+    /** User currently requesting elevation. */
+    username: string;
+    /** Target identity for elevated command. */
+    targetUser: string;
+    /** Command to execute after successful challenge; null for login shell. */
+    commandLine: string | null;
+    /** True when challenge targets interactive login shell. */
+    loginShell: boolean;
+    /** Prompt text shown before password input. */
+    prompt: string;
+}
+/** State payload used by nano command interactive editor flow. */
+export interface NanoEditorSession {
+    /** Final destination path to write when save succeeds. */
+    targetPath: string;
+    /** Temporary scratch path used while editing. */
+    tempPath: string;
+    /** Initial editor content shown to user. */
+    initialContent: string;
+}
+/** Runtime context object passed to each command module. */
+export interface CommandContext {
+    /** Authenticated user currently bound to stream. */
+    authUser: string;
+    /** Virtual hostname shown in prompt and banners. */
+    hostname: string;
+    /** Snapshot of currently active user sessions. */
+    activeSessions: VirtualActiveSession[];
+    /** Original unparsed command line input. */
+    rawInput: string;
+    /** Invocation mode (interactive shell or direct exec). */
+    mode: CommandMode;
+    /** Tokenized arguments excluding command name. */
+    args: string[];
+    /** Virtual shell instance. */
+    shell: VirtualShell;
+    /** Optional stdin payload (used by pipes/redirections). */
+    stdin?: string;
+    /** Current working directory for command execution. */
+    cwd: string;
+}
+/** Contract implemented by each shell command module. */
+export interface ShellModule {
+    /** Primary command name used in CLI. */
+    name: string;
+    /** Parameter help snippets displayed by help command. */
+    params: string[];
+    /** Command handler implementation. */
+    run: (ctx: CommandContext) => CommandResult | Promise<CommandResult>;
+    /** Optional alternative command names. */
+    aliases?: string[];
+}
+/** Command return union allowing sync or async handlers. */
+export type CommandOutcome = CommandResult | Promise<CommandResult>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/pipeline.d.ts

@@ -0,0 +1,23 @@
+/** Represents a single command in a pipeline. */
+export interface PipelineCommand {
+    /** Command name */
+    name: string;
+    /** Command arguments */
+    args: string[];
+    /** Input redirection file path (< file) */
+    inputFile?: string;
+    /** Output redirection file path (> file) */
+    outputFile?: string;
+    /** Append to output file (>> file) */
+    appendOutput?: boolean;
+}
+/** Represents a parsed shell pipeline */
+export interface Pipeline {
+    /** List of commands in the pipeline */
+    commands: PipelineCommand[];
+    /** Whether this is a valid pipeline */
+    isValid: boolean;
+    /** Error message if parsing failed */
+    error?: string;
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/streams.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Minimal stream contract used by exec command handlers.
+ */
+export interface ExecStream {
+    /** Writes text to stdout channel. */
+    write(data: string): void;
+    /** Signals output completion. */
+    end(): void;
+    /** Sets process-like exit code for exec response. */
+    exit(code: number): void;
+    /** Writable stderr channel. */
+    stderr: {
+        /** Writes text to stderr channel. */
+        write(data: string): void;
+    };
+}
+/**
+ * Minimal interactive stream contract used by shell mode.
+ */
+export interface ShellStream {
+    /** Writes text to shell output channel. */
+    write(data: string): void;
+    /** Sets shell exit code on close. */
+    exit(code: number): void;
+    /** Ends shell stream. */
+    end(): void;
+    /** Subscribes to incoming user input chunks. */
+    on(event: "data", listener: (chunk: Buffer) => void): void;
+    /** Subscribes to stream close event. */
+    on(event: "close", listener: () => void): void;
+}
+//# sourceMappingURL=streams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/types/streams.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,qCAAqC;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,GAAG,IAAI,IAAI,CAAC;IACZ,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+BAA+B;IAC/B,MAAM,EAAE;QACP,qCAAqC;QACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yBAAyB;IACzB,GAAG,IAAI,IAAI,CAAC;IACZ,gDAAgD;IAChD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,wCAAwC;IACxC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC/C"}

package/dist/types/vfs.d.ts

@@ -0,0 +1,71 @@
+/** Supported virtual node kinds. */
+export type VfsNodeType = "file" | "directory";
+/** Shared metadata fields available on file and directory stats. */
+export interface VfsBaseNode {
+    /** Node name without parent path. */
+    name: string;
+    /** Absolute normalized node path. */
+    path: string;
+    /** POSIX-like mode bits. */
+    mode: number;
+    /** Node creation timestamp. */
+    createdAt: Date;
+    /** Last update timestamp. */
+    updatedAt: Date;
+}
+/** Stat shape returned for file nodes. */
+export interface VfsFileNode extends VfsBaseNode {
+    type: "file";
+    /** True when file content stored as gzip bytes. */
+    compressed: boolean;
+    /** Stored byte length (compressed when compressed=true). */
+    size: number;
+}
+/** Stat shape returned for directory nodes. */
+export interface VfsDirectoryNode extends VfsBaseNode {
+    type: "directory";
+    /** Number of direct children in directory. */
+    childrenCount: number;
+}
+/** Union of file and directory stat responses. */
+export type VfsNodeStats = VfsFileNode | VfsDirectoryNode;
+/** Optional behavior flags for writeFile operations. */
+export interface WriteFileOptions {
+    /** POSIX-like mode to apply on create or overwrite. */
+    mode?: number;
+    /** Store content compressed with gzip. */
+    compress?: boolean;
+}
+/** Optional behavior flags for remove operations. */
+export interface RemoveOptions {
+    /** Allow deleting non-empty directory trees. */
+    recursive?: boolean;
+}
+/** Base snapshot node schema used for archive serialization. */
+export interface VfsSnapshotBaseNode {
+    name: string;
+    mode: number;
+    /** ISO-8601 creation timestamp. */
+    createdAt: string;
+    /** ISO-8601 update timestamp. */
+    updatedAt: string;
+}
+/** Serialized snapshot shape for file nodes. */
+export interface VfsSnapshotFileNode extends VfsSnapshotBaseNode {
+    type: "file";
+    compressed: boolean;
+    /** Base64-encoded raw file bytes. */
+    contentBase64: string;
+}
+/** Serialized snapshot shape for directory nodes. */
+export interface VfsSnapshotDirectoryNode extends VfsSnapshotBaseNode {
+    type: "directory";
+    children: VfsSnapshotNode[];
+}
+/** Union of serialized snapshot node variants. */
+export type VfsSnapshotNode = VfsSnapshotFileNode | VfsSnapshotDirectoryNode;
+/** Top-level serialized filesystem snapshot. */
+export interface VfsSnapshot {
+    root: VfsSnapshotDirectoryNode;
+}
+//# sourceMappingURL=vfs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../../src/types/vfs.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC3B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE1D,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACpE,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE7E,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,wBAAwB,CAAC;CAC/B"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "typescript-virtual-container",
   "description": "In-memory SSH server with virtual filesystem and typed programmatic API",
-  "module": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "license": "MIT",
   "keywords": [
     "ssh",
@@ -20,6 +21,7 @@
     "lint": "bunx --bun @biomejs/biome lint ./src",
     "lint:write": "bunx --bun @biomejs/biome lint --write ./src",
     "test": "bunx --bun @biomejs/biome test ./src",
+    "build": "tsc --project tsconfig.json",
     "deploy:npm": "npm publish --access public"
   },
   "devDependencies": {

package/src/VirtualShell/shell.ts

@@ -2,17 +2,17 @@ import type { ChildProcessWithoutNullStreams } from "node:child_process";
 import { readFile, unlink, writeFile } from "node:fs/promises";
 import * as path from "node:path";
 import type { ShellProperties, VirtualShell } from ".";
+import { getCommandNames, runCommand } from "../commands";
 import {
 	spawnHtopProcess,
 	spawnNanoEditorProcess,
-} from "../../modules/shellInteractive";
+} from "../modules/shellInteractive";
 import {
 	getVisibleHtopPidList,
 	resolvePath,
 	type TerminalSize,
 	toTtyLines,
-} from "../../modules/shellRuntime";
-import { getCommandNames, runCommand } from "../commands";
+} from "../modules/shellRuntime";
 import { formatLoginDate } from "../SSHMimic/loginFormat";
 import { buildPrompt } from "../SSHMimic/prompt";
 import type { ShellStream } from "../types/streams";

package/src/VirtualUserManager/index.ts

@@ -222,6 +222,24 @@ export class VirtualUserManager {
 		await this.persist();
 	}
 
+	/**
+	 * Updates password for an existing user account.
+	 *
+	 * @param username Username to update.
+	 * @param password New plaintext password.
+	 */
+	public async setPassword(username: string, password: string): Promise<void> {
+		this.validateUsername(username);
+		this.validatePassword(password);
+
+		if (!this.users.has(username)) {
+			throw new Error(`passwd: user '${username}' does not exist`);
+		}
+
+		this.users.set(username, this.createRecord(username, password));
+		await this.persist();
+	}
+
 	/**
 	 * Deletes existing non-root user account.
 	 *

package/src/commands/index.ts

@@ -23,6 +23,7 @@ import { lsCommand } from "./ls";
 import { mkdirCommand } from "./mkdir";
 import { nanoCommand } from "./nano";
 import { neofetchCommand } from "./neofetch";
+import { passwdCommand } from "./passwd";
 import { pwdCommand } from "./pwd";
 import { rmCommand } from "./rm";
 import { setCommand } from "./set";
@@ -53,6 +54,7 @@ const BASE_COMMANDS: ShellModule[] = [
 	neofetchCommand,
 	htopCommand,
 	adduserCommand,
+	passwdCommand,
 	deluserCommand,
 	sudoCommand,
 	suCommand,

package/src/commands/neofetch.ts

@@ -1,4 +1,4 @@
-import { buildNeofetchOutput } from "../../modules/neofetch";
+import { buildNeofetchOutput } from "../modules/neofetch";
 import type { ShellModule } from "../types/commands";
 import { ifFlag } from "./command-helpers";
 import { getAllEnvVars } from "./set";

package/src/commands/passwd.ts

@@ -0,0 +1,25 @@
+import type { ShellModule } from "../types/commands";
+
+export const passwdCommand: ShellModule = {
+	name: "passwd",
+	params: ["<username> <password>"],
+	run: async ({ authUser, args, shell }) => {
+		const [username, password] = args;
+		if (!username || !password) {
+			return {
+				stderr: "passwd: usage: passwd <username> <password>",
+				exitCode: 1,
+			};
+		}
+
+		if (authUser !== "root" && authUser !== username) {
+			return { stderr: "passwd: permission denied", exitCode: 1 };
+		}
+
+		await shell.users.setPassword(username, password);
+		return {
+			stdout: `passwd: password updated for '${username}'`,
+			exitCode: 0,
+		};
+	},
+};

package/{modules → src/modules}/neofetch.ts

@@ -1,7 +1,7 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import type { ShellProperties } from "../src/VirtualShell";
+import type { ShellProperties } from "../VirtualShell";
 
 function formatUptime(seconds: number): string {
 	const totalMinutes = Math.max(1, Math.floor(seconds / 60));
@@ -56,11 +56,11 @@ function colorizeDetailLine(line: string): string {
 		return line;
 	}
 
-	const colonIndex = line.indexOf(':');
+	const colonIndex = line.indexOf(":");
 
 	if (colonIndex === -1) {
 		// Pas de ':', chercher '@' pour identifier user@host
-		if (line.includes('@')) {
+		if (line.includes("@")) {
 			// C'est user@host, appliquer dégradé horizontal
 			return applyHorizontalGradient(line);
 		}
@@ -79,8 +79,8 @@ function colorizeDetailLine(line: string): string {
 
 function applyHorizontalGradient(text: string): string {
 	// Nettoyer les codes ANSI existants
-	const ansiRegex = new RegExp(`${String.fromCharCode(27)}\\[[\\d;]*m`, 'g');
-	const cleaned = text.replace(ansiRegex, '');
+	const ansiRegex = new RegExp(`${String.fromCharCode(27)}\\[[\\d;]*m`, "g");
+	const cleaned = text.replace(ansiRegex, "");
 
 	if (cleaned.trim().length === 0) {
 		return text;
@@ -88,7 +88,7 @@ function applyHorizontalGradient(text: string): string {
 
 	const start = { r: 255, g: 255, b: 255 };
 	const end = { r: 168, g: 85, b: 247 };
-	let result = '';
+	let result = "";
 
 	for (let i = 0; i < cleaned.length; i += 1) {
 		const ratio = cleaned.length <= 1 ? 0 : i / (cleaned.length - 1);
@@ -111,7 +111,7 @@ export interface NeofetchInfo {
 	uptimeSeconds?: number;
 	packages?: string;
 	shell?: string;
-    shellProps?: ShellProperties;
+	shellProps?: ShellProperties;
 	resolution?: string;
 	terminal?: string;
 	cpu?: string;
@@ -180,8 +180,7 @@ function countDpkgPackages(): number | undefined {
 			const data = readFileSync(filePath, "utf8");
 			const matches = data.match(/^Package:\s+/gm);
 			return matches?.length ?? 0;
-		} catch {
-		}
+		} catch {}
 	}
 
 	return undefined;
@@ -199,8 +198,7 @@ function countSnapPackages(): number | undefined {
 			const entries = readdirSync(dirPath, { withFileTypes: true });
 			const count = entries.filter((entry) => entry.isDirectory()).length;
 			return count;
-		} catch {
-		}
+		} catch {}
 	}
 
 	return undefined;
@@ -250,28 +248,29 @@ function resolveDefaults(info: NeofetchInfo): Required<NeofetchInfo> {
 	const totalMem = os.totalmem();
 	const freeMem = os.freemem();
 	const usedMem = Math.max(0, totalMem - freeMem);
-    const shellProps = info.shellProps;
-
-    const processUptime = process.uptime();
-    if (info.uptimeSeconds === undefined) {
-        info.uptimeSeconds = Math.round(processUptime);
-    }
+	const shellProps = info.shellProps;
 
-    console.log("Resolving neofetch info with shellProps:", shellProps);
+	const processUptime = process.uptime();
+	if (info.uptimeSeconds === undefined) {
+		info.uptimeSeconds = Math.round(processUptime);
+	}
 
 	return {
 		user: info.user,
 		host: info.host,
-		osName: shellProps?.os ?? info.osName ?? `${readOsPrettyName() ?? os.type()} ${os.arch()}`,
+		osName:
+			shellProps?.os ??
+			info.osName ??
+			`${readOsPrettyName() ?? os.type()} ${os.arch()}`,
 		kernel: shellProps?.kernel ?? info.kernel ?? os.release(),
 		uptimeSeconds: info.uptimeSeconds ?? os.uptime(),
 		packages: info.packages ?? resolvePackagesLabel(),
 		shell: resolveShellLabel(info.shell),
-		shellProps: info.shellProps as ShellProperties ?? {
-            kernel: info.kernel ?? os.release(),
-            os: info.osName ?? `${readOsPrettyName() ?? os.type()} ${os.arch()}`,
-            arch: os.arch(),
-        },
+		shellProps: (info.shellProps as ShellProperties) ?? {
+			kernel: info.kernel ?? os.release(),
+			os: info.osName ?? `${readOsPrettyName() ?? os.type()} ${os.arch()}`,
+			arch: os.arch(),
+		},
 		resolution: info.resolution ?? "n/a (ssh)",
 		terminal: info.terminal ?? "unknown",
 		cpu: info.cpu ?? resolveCpuLabel(),
@@ -287,32 +286,32 @@ export function buildNeofetchOutput(info: NeofetchInfo): string {
 	const colorBars = buildColorBars();
 
 	const distroLogo = [
-        "                               .. .:.    ",
-        " .::..                       ..     ..   ",
-        ".    ....                  ...       ..  ",
-        ":       ....             .:.          .. ",
-        ":           .:.:........:.            .. ",
-        ":                                     .. ",
-        ".                                      : ",
-        ".                                      : ",
-        "..                                     : ",
-        " :.                                   .. ",
-        " ..                                   .. ",
-        " :-.                                  :: ",
-        "  .:.                                 :. ",
-        "   ..:                               ... ",
-        "   ..:                               :.. ",
-        "  :...                              :....",
-        "   ..                                ....",
-        "   .                                  .. ",
-        "  .:.                                 .: ",
-        "  :.                                  .. ",
-        " ::.                                 ..  ",
-        ".....                          ..:...    ",
-        "...:.                         ..         ",
-        ".:...:.       ::.           ..           ",
-        "  ... ..:::::..  ..:::::::..             ",
-    ]
+		"                               .. .:.    ",
+		" .::..                       ..     ..   ",
+		".    ....                  ...       ..  ",
+		":       ....             .:.          .. ",
+		":           .:.:........:.            .. ",
+		":                                     .. ",
+		".                                      : ",
+		".                                      : ",
+		"..                                     : ",
+		" :.                                   .. ",
+		" ..                                   .. ",
+		" :-.                                  :: ",
+		"  .:.                                 :. ",
+		"   ..:                               ... ",
+		"   ..:                               :.. ",
+		"  :...                              :....",
+		"   ..                                ....",
+		"   .                                  .. ",
+		"  .:.                                 .: ",
+		"  :.                                  .. ",
+		" ::.                                 ..  ",
+		".....                          ..:...    ",
+		"...:.                         ..         ",
+		".:...:.       ::.           ..           ",
+		"  ... ..:::::..  ..:::::::..             ",
+	];
 
 	const details = [
 		`${fields.user}@${fields.host}`,
@@ -341,7 +340,11 @@ export function buildNeofetchOutput(info: NeofetchInfo): string {
 		const rawLeft = distroLogo[i] ?? "";
 		const right = details[i] ?? "";
 		if (right.length > 0) {
-			const left = colorizeLogoLine(rawLeft.padEnd(31, " "), i, distroLogo.length);
+			const left = colorizeLogoLine(
+				rawLeft.padEnd(31, " "),
+				i,
+				distroLogo.length,
+			);
 			const coloredRight = colorizeDetailLine(right);
 			lines.push(`${left}  ${coloredRight}`);
 			continue;
@@ -351,4 +354,4 @@ export function buildNeofetchOutput(info: NeofetchInfo): string {
 	}
 
 	return lines.join("\n");
-}
+}