typescript-virtual-container 1.4.4 → 1.4.6

package/dist/commands/cat.js

@@ -0,0 +1,45 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolveReadablePath } from "./helpers";
+/**
+ * Concatenate and print files to stdout.
+ * @category files
+ * @params ["[-n] [-b] <file...>"]
+ */
+export const catCommand = {
+    name: "cat",
+    description: "Concatenate and print files",
+    category: "files",
+    params: ["[-n] [-b] <file...>"],
+    run: ({ authUser, shell, cwd, args, stdin }) => {
+        const numberAll = ifFlag(args, ["-n", "--number"]);
+        const numberNonBlank = ifFlag(args, ["-b", "--number-nonblank"]);
+        const fileArgs = args.filter((a) => !a.startsWith("-"));
+        if (fileArgs.length === 0 && stdin !== undefined) {
+            return { stdout: stdin, exitCode: 0 };
+        }
+        if (fileArgs.length === 0) {
+            return { stderr: "cat: missing file operand", exitCode: 1 };
+        }
+        const parts = [];
+        for (const fileArg of fileArgs) {
+            const target = resolveReadablePath(shell.vfs, cwd, fileArg);
+            assertPathAccess(authUser, target, "cat");
+            parts.push(shell.vfs.readFile(target));
+        }
+        const combined = parts.join("");
+        if (!numberAll && !numberNonBlank) {
+            return { stdout: combined, exitCode: 0 };
+        }
+        let lineNum = 1;
+        const numbered = combined
+            .split("\n")
+            .map((line) => {
+            if (numberNonBlank && line.trim() === "")
+                return line;
+            return `${String(lineNum++).padStart(6)}\t${line}`;
+        })
+            .join("\n");
+        return { stdout: numbered, exitCode: 0 };
+    },
+};
+//# sourceMappingURL=cat.js.map

package/dist/commands/cat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cat.js","sourceRoot":"","sources":["../../src/commands/cat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB;IACtC,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,6BAA6B;IAC1C,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,CAAC,qBAAqB,CAAC;IAC/B,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QACnD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAExD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAClD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC7D,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEhC,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;YACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,QAAQ,GAAG,QAAQ;aACvB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,cAAc,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YACtD,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC1C,CAAC;CACD,CAAC"}

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

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

package/dist/commands/cd.js

@@ -0,0 +1,22 @@
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Change current working directory.
+ * @category navigation
+ * @params ["[path]"]
+ */
+export const cdCommand = {
+    name: "cd",
+    description: "Change directory",
+    category: "navigation",
+    params: ["[path]"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const target = resolvePath(cwd, args[0] ?? `~`);
+        assertPathAccess(authUser, target, "cd");
+        const stats = shell.vfs.stat(target);
+        if (stats.type !== "directory") {
+            return { stderr: `cd: not a directory: ${target}`, exitCode: 1 };
+        }
+        return { nextCwd: target, exitCode: 0 };
+    },
+};
+//# sourceMappingURL=cd.js.map

package/dist/commands/cd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cd.js","sourceRoot":"","sources":["../../src/commands/cd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgB;IACrC,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,kBAAkB;IAC/B,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAChD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,wBAAwB,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzC,CAAC;CACD,CAAC"}

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

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

package/dist/commands/chmod.js

@@ -0,0 +1,88 @@
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Parse a symbolic chmod mode string (e.g. "+x", "u+x", "go-w", "a+rx")
+ * and apply it to the existing mode bits.
+ * Returns null if the string is not a valid symbolic mode.
+ */
+function applySymbolicMode(existing, modeStr) {
+    const pattern = /^([ugoa]*)([+\-=])([rwx]*)$/;
+    const parts = modeStr.split(",");
+    let mode = existing;
+    for (const part of parts) {
+        const m = part.trim().match(pattern);
+        if (!m)
+            return null;
+        const [, who = "a", op, perms = ""] = m;
+        const targets = who === "" || who === "a" ? ["u", "g", "o"] : who.split("");
+        const bits = {
+            u: { r: 0o400, w: 0o200, x: 0o100 },
+            g: { r: 0o040, w: 0o020, x: 0o010 },
+            o: { r: 0o004, w: 0o002, x: 0o001 },
+        };
+        for (const t of targets) {
+            for (const p of perms.split("")) {
+                const bit = bits[t]?.[p];
+                if (bit === undefined)
+                    continue;
+                if (op === "+")
+                    mode |= bit;
+                else if (op === "-")
+                    mode &= ~bit;
+                else if (op === "=") {
+                    // clear all bits for this target, then set requested
+                    const mask = Object.values(bits[t] ?? {}).reduce((a, b) => a | b, 0);
+                    mode = (mode & ~mask) | bit;
+                }
+            }
+        }
+    }
+    return mode;
+}
+/**
+ * Change file permissions (octal or symbolic).
+ * @category files
+ * @params ["<mode> <file>"]
+ */
+export const chmodCommand = {
+    name: "chmod",
+    description: "Change file permissions",
+    category: "files",
+    params: ["<mode> <file>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const [modeArg, fileArg] = args;
+        if (!modeArg || !fileArg) {
+            return { stderr: "chmod: missing operand", exitCode: 1 };
+        }
+        const filePath = resolvePath(cwd, fileArg);
+        try {
+            assertPathAccess(authUser, filePath, "chmod");
+            if (!shell.vfs.exists(filePath)) {
+                return {
+                    stderr: `chmod: ${fileArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+            let mode;
+            const octal = parseInt(modeArg, 8);
+            if (!Number.isNaN(octal) && /^[0-7]+$/.test(modeArg)) {
+                mode = octal;
+            }
+            else {
+                // symbolic mode
+                const existing = shell.vfs.stat(filePath).mode;
+                const result = applySymbolicMode(existing, modeArg);
+                if (result === null) {
+                    return { stderr: `chmod: invalid mode: ${modeArg}`, exitCode: 1 };
+                }
+                mode = result;
+            }
+            shell.vfs.chmod(filePath, mode);
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `chmod: ${msg}`, exitCode: 1 };
+        }
+    },
+};
+//# sourceMappingURL=chmod.js.map

package/dist/commands/chmod.js.map

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

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

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

package/dist/commands/clear.js

@@ -0,0 +1,14 @@
+/**
+ * Clear the terminal screen.
+ * @category shell
+ * @params []
+ */
+export const clearCommand = {
+    name: "clear",
+    description: "Clear the terminal screen",
+    category: "shell",
+    params: [],
+    // clearScreen flag triggers \x1b[2J\x1b[H in the shell layer
+    run: () => ({ clearScreen: true, stdout: "", exitCode: 0 }),
+};
+//# sourceMappingURL=clear.js.map

package/dist/commands/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACxC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,2BAA2B;IACxC,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,EAAE;IACV,6DAA6D;IAC7D,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;CAC3D,CAAC"}

package/dist/commands/command-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAwFF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAYxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,GAAG,SAAS,CA0B3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC3D;IACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAiDA"}

package/dist/commands/command-helpers.js

@@ -0,0 +1,222 @@
+function toFlagList(flags) {
+    return Array.isArray(flags) ? flags : [flags];
+}
+function matchFlagToken(token, flag) {
+    if (token === flag) {
+        return { matched: true, inlineValue: null };
+    }
+    // --flag=value style
+    const prefix = `${flag}=`;
+    if (token.startsWith(prefix)) {
+        return { matched: true, inlineValue: token.slice(prefix.length) };
+    }
+    // Short flag inline value: -f2, -d: (single char flag like -f, -d, -n)
+    // Only applies to single-char flags (-X), not long flags (--flag)
+    if (flag.length === 2 && flag.startsWith("-") && !flag.startsWith("--")) {
+        if (token.startsWith(flag) && token.length > flag.length) {
+            return { matched: true, inlineValue: token.slice(flag.length) };
+        }
+    }
+    return { matched: false, inlineValue: null };
+}
+function collectPositionals(args, options = {}) {
+    const boolFlags = new Set(options.flags ?? []);
+    const valueFlags = new Set(options.flagsWithValue ?? []);
+    const positionals = [];
+    let passthrough = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (passthrough) {
+            positionals.push(arg);
+            continue;
+        }
+        if (arg === "--") {
+            passthrough = true;
+            continue;
+        }
+        let consumed = false;
+        for (const flag of boolFlags) {
+            const { matched } = matchFlagToken(arg, flag);
+            if (matched) {
+                consumed = true;
+                break;
+            }
+        }
+        if (consumed) {
+            continue;
+        }
+        for (const flag of valueFlags) {
+            const match = matchFlagToken(arg, flag);
+            if (!match.matched) {
+                continue;
+            }
+            consumed = true;
+            if (match.inlineValue === null && index + 1 < args.length) {
+                index += 1;
+            }
+            break;
+        }
+        if (!consumed) {
+            positionals.push(arg);
+        }
+    }
+    return positionals;
+}
+/**
+ * Returns `true` when any of the given flags appear in `args`.
+ *
+ * Matches both standalone tokens (`-s`, `--silent`) and inline forms
+ * (`--output=file`). Useful for simple boolean flag checks inside command
+ * `run` handlers.
+ *
+ * @param args  Tokenized argument array from `CommandContext.args`.
+ * @param flags Single flag string or array of equivalent flag strings.
+ * @returns `true` if at least one flag is present, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * ifFlag(args, "-r")              // single flag
+ * ifFlag(args, ["-r", "--recursive"]) // aliases
+ * ```
+ */
+export function ifFlag(args, flags) {
+    const allFlags = toFlagList(flags);
+    for (const arg of args) {
+        for (const flag of allFlags) {
+            if (matchFlagToken(arg, flag).matched) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Returns the value associated with a flag, or `true` if the flag is present
+ * but has no associated value, or `undefined` if the flag is absent.
+ *
+ * Handles three forms:
+ * - `--output file`   → returns `"file"` (next token)
+ * - `--output=file`   → returns `"file"` (inline `=` form)
+ * - `--verbose`       → returns `true` (flag with no value)
+ *
+ * @param args  Tokenized argument array from `CommandContext.args`.
+ * @param flags Single flag string or array of equivalent flag strings.
+ * @returns The flag value string, `true` when valueless, or `undefined`.
+ *
+ * @example
+ * ```ts
+ * const output = getFlag(args, ["-o", "--output"]);
+ * if (typeof output === "string") { /* use path *\/ }
+ * ```
+ */
+export function getFlag(args, flags) {
+    const allFlags = toFlagList(flags);
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        for (const flag of allFlags) {
+            const match = matchFlagToken(arg, flag);
+            if (!match.matched) {
+                continue;
+            }
+            if (match.inlineValue !== null) {
+                return match.inlineValue;
+            }
+            const next = args[index + 1];
+            if (next !== undefined && next !== "--") {
+                return next;
+            }
+            return true;
+        }
+    }
+    return undefined;
+}
+/**
+ * Returns the positional argument at the given zero-based index, skipping
+ * known flags and their values.
+ *
+ * Flags declared in `options.flags` are treated as boolean and skipped.
+ * Flags declared in `options.flagsWithValue` consume the next token too.
+ * Tokens after `--` are always treated as positionals.
+ *
+ * @param args    Tokenized argument array from `CommandContext.args`.
+ * @param index   Zero-based positional index to retrieve.
+ * @param options Optional flag declarations to skip during positional collection.
+ * @returns The positional value, or `undefined` if the index is out of range.
+ *
+ * @example
+ * ```ts
+ * // args = ["-r", "src", "dest"]
+ * getArg(args, 0, { flags: ["-r"] }) // "src"
+ * getArg(args, 1, { flags: ["-r"] }) // "dest"
+ * ```
+ */
+export function getArg(args, index, options = {}) {
+    const positionals = collectPositionals(args, options);
+    return positionals[index];
+}
+/**
+ * Parses an argument array into structured flags, flag values, and positionals.
+ *
+ * - `options.flags` — boolean flags (e.g. `["-r", "--recursive"]`); collected
+ *   into a `Set<string>` and not treated as positionals.
+ * - `options.flagsWithValue` — flags that consume the next token or an inline
+ *   `=value`; collected into a `Map<string, string>`.
+ * - All remaining tokens are positionals.
+ * - Tokens after `--` are always positionals, regardless of `-` prefix.
+ *
+ * @param args    Tokenized argument array from `CommandContext.args`.
+ * @param options Flag declaration lists.
+ * @returns `{ flags, flagsWithValues, positionals }`.
+ *
+ * @example
+ * ```ts
+ * const { flags, flagsWithValues, positionals } = parseArgs(args, {
+ *   flags:          ["-r", "--recursive"],
+ *   flagsWithValue: ["-o", "--output"],
+ * });
+ * const recursive = flags.has("-r");
+ * const output    = flagsWithValues.get("-o");
+ * ```
+ */
+export function parseArgs(args, options = {}) {
+    const flags = new Set();
+    const flagsWithValues = new Map();
+    const positionals = [];
+    const boolFlags = new Set(options.flags ?? []);
+    const valueFlags = new Set(options.flagsWithValue ?? []);
+    let passthrough = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (passthrough) {
+            positionals.push(arg);
+            continue;
+        }
+        if (arg === "--") {
+            passthrough = true;
+            continue;
+        }
+        if (boolFlags.has(arg)) {
+            flags.add(arg);
+            continue;
+        }
+        if (valueFlags.has(arg)) {
+            const next = args[index + 1];
+            if (next && !next.startsWith("-")) {
+                flagsWithValues.set(arg, next);
+                index += 1;
+            }
+            else {
+                flagsWithValues.set(arg, "");
+            }
+            continue;
+        }
+        const inlineFlag = Array.from(valueFlags).find((flag) => arg.startsWith(`${flag}=`));
+        if (inlineFlag) {
+            flagsWithValues.set(inlineFlag, arg.slice(inlineFlag.length + 1));
+            continue;
+        }
+        positionals.push(arg);
+    }
+    return { flags, flagsWithValues, positionals };
+}
+//# sourceMappingURL=command-helpers.js.map

package/dist/commands/command-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.js","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"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"}

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

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

package/dist/commands/cp.js

@@ -0,0 +1,76 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Copy files or directories inside the virtual filesystem.
+ * @category files
+ * @params ["[-r] <source> <dest>"]
+ */
+export const cpCommand = {
+    name: "cp",
+    description: "Copy files or directories",
+    category: "files",
+    params: ["[-r] <source> <dest>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const recursive = ifFlag(args, ["-r", "-R", "--recursive"]);
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const [srcArg, destArg] = positionals;
+        if (!srcArg || !destArg) {
+            return { stderr: "cp: missing operand", exitCode: 1 };
+        }
+        const srcPath = resolvePath(cwd, srcArg);
+        const destPath = resolvePath(cwd, destArg);
+        try {
+            assertPathAccess(authUser, srcPath, "cp");
+            assertPathAccess(authUser, destPath, "cp");
+            if (!shell.vfs.exists(srcPath)) {
+                return {
+                    stderr: `cp: ${srcArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+            const srcStat = shell.vfs.stat(srcPath);
+            if (srcStat.type === "directory") {
+                if (!recursive) {
+                    return {
+                        stderr: `cp: ${srcArg}: is a directory (use -r)`,
+                        exitCode: 1,
+                    };
+                }
+                const copyDir = (from, to) => {
+                    shell.vfs.mkdir(to, 0o755);
+                    for (const entry of shell.vfs.list(from)) {
+                        const fromEntry = `${from}/${entry}`;
+                        const toEntry = `${to}/${entry}`;
+                        const stat = shell.vfs.stat(fromEntry);
+                        if (stat.type === "directory") {
+                            copyDir(fromEntry, toEntry);
+                        }
+                        else {
+                            const content = shell.vfs.readFileRaw(fromEntry);
+                            shell.writeFileAsUser(authUser, toEntry, content);
+                        }
+                    }
+                };
+                const finalDest = shell.vfs.exists(destPath) &&
+                    shell.vfs.stat(destPath).type === "directory"
+                    ? `${destPath}/${srcArg.split("/").pop()}`
+                    : destPath;
+                copyDir(srcPath, finalDest);
+            }
+            else {
+                const finalDest = shell.vfs.exists(destPath) &&
+                    shell.vfs.stat(destPath).type === "directory"
+                    ? `${destPath}/${srcArg.split("/").pop()}`
+                    : destPath;
+                const content = shell.vfs.readFileRaw(srcPath);
+                shell.writeFileAsUser(authUser, finalDest, content);
+            }
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `cp: ${msg}`, exitCode: 1 };
+        }
+    },
+};
+//# sourceMappingURL=cp.js.map

package/dist/commands/cp.js.map

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

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

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

package/dist/commands/curl.js

@@ -0,0 +1,128 @@
+import { ifFlag, parseArgs } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * HTTP client wrapper using `fetch()` semantics (virtual curl).
+ * @category network
+ * @params ["[options] <url>"]
+ */
+export const curlCommand = {
+    name: "curl",
+    description: "Transfer data from or to a server (pure fetch)",
+    category: "network",
+    params: ["[options] <url>"],
+    run: async ({ authUser, cwd, args, shell }) => {
+        const { flagsWithValues, positionals } = parseArgs(args, {
+            flagsWithValue: [
+                "-o",
+                "--output",
+                "-X",
+                "--request",
+                "-d",
+                "--data",
+                "-H",
+                "--header",
+                "-u",
+                "--user",
+            ],
+        });
+        if (ifFlag(args, ["--help", "-h"])) {
+            return {
+                stdout: [
+                    "Usage: curl [options] <url>",
+                    "  -o, --output <file>    Write to file",
+                    "  -X, --request <method> HTTP method",
+                    "  -d, --data <data>      POST data",
+                    "  -H, --header <hdr>     Extra header",
+                    "  -s, --silent           Silent mode",
+                    "  -I, --head             Fetch headers only",
+                    "  -L, --location         Follow redirects",
+                    "  -v, --verbose          Verbose",
+                ].join("\n"),
+                exitCode: 0,
+            };
+        }
+        const url = positionals[0];
+        if (!url)
+            return { stderr: "curl: no URL specified", exitCode: 1 };
+        const outputPath = flagsWithValues.get("-o") ?? flagsWithValues.get("--output") ?? null;
+        const method = (flagsWithValues.get("-X") ??
+            flagsWithValues.get("--request") ??
+            "GET").toUpperCase();
+        const postData = flagsWithValues.get("-d") ?? flagsWithValues.get("--data") ?? null;
+        const headerRaw = flagsWithValues.get("-H") ?? flagsWithValues.get("--header") ?? null;
+        const silent = ifFlag(args, ["-s", "--silent"]);
+        const headOnly = ifFlag(args, ["-I", "--head"]);
+        const followRedirects = ifFlag(args, ["-L", "--location"]);
+        const verbose = ifFlag(args, ["-v", "--verbose"]);
+        const extraHeaders = {
+            "User-Agent": "curl/7.88.1",
+        };
+        if (headerRaw) {
+            const idx = headerRaw.indexOf(":");
+            if (idx !== -1)
+                extraHeaders[headerRaw.slice(0, idx).trim()] = headerRaw
+                    .slice(idx + 1)
+                    .trim();
+        }
+        const finalMethod = postData && method === "GET" ? "POST" : method;
+        const fetchOpts = {
+            method: finalMethod,
+            headers: extraHeaders,
+            redirect: followRedirects ? "follow" : "manual",
+        };
+        if (postData) {
+            extraHeaders["Content-Type"] ??= "application/x-www-form-urlencoded";
+            fetchOpts.body = postData;
+        }
+        const stderrLines = [];
+        if (verbose) {
+            stderrLines.push(`* Trying ${url}...`, `* Connected`);
+            stderrLines.push(`> ${finalMethod} / HTTP/1.1`, `> Host: ${new URL(url).host}`);
+        }
+        let response;
+        try {
+            const urlWithHttp = url.startsWith("http://") || url.startsWith("https://") ? url : `http://${url}`;
+            response = await fetch(urlWithHttp, fetchOpts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                stderr: `curl: (6) Could not resolve host: ${msg}`,
+                exitCode: 6,
+            };
+        }
+        if (verbose) {
+            stderrLines.push(`< HTTP/1.1 ${response.status} ${response.statusText}`);
+        }
+        if (headOnly) {
+            const lines = [`HTTP/1.1 ${response.status} ${response.statusText}`];
+            for (const [k, v] of response.headers.entries())
+                lines.push(`${k}: ${v}`);
+            return { stdout: `${lines.join("\r\n")}\r\n`, exitCode: 0 };
+        }
+        let body;
+        try {
+            body = await response.text();
+        }
+        catch {
+            return { stderr: "curl: failed to read response body", exitCode: 1 };
+        }
+        if (outputPath) {
+            const target = resolvePath(cwd, outputPath);
+            assertPathAccess(authUser, target, "curl");
+            shell.writeFileAsUser(authUser, target, body);
+            if (!silent)
+                stderrLines.push(`  % Total    % Received\n100 ${body.length}  100 ${body.length}`);
+            return {
+                stderr: stderrLines.join("\n") || undefined,
+                exitCode: response.ok ? 0 : 22,
+            };
+        }
+        return {
+            stdout: body,
+            stderr: stderrLines.length > 0 ? stderrLines.join("\n") : undefined,
+            exitCode: response.ok ? 0 : 22,
+        };
+    },
+};
+//# sourceMappingURL=curl.js.map