typescript-virtual-container 1.4.4 → 1.4.6

package/src/utils/vfsDiff.js

@@ -1,177 +0,0 @@
-/**
- * vfsDiff.ts
- *
- * Snapshot diff tooling for `VirtualFileSystem`.
- *
- * Compares two VFS snapshots and returns structured diff results suitable
- * for test assertions, audit logging, and deployment verification.
- *
- * @example
- * ```ts
- * import { diffSnapshots, formatDiff } from "typescript-virtual-container/utils/vfsDiff";
- *
- * const before = shell.vfs.toSnapshot();
- * await client.exec("npm install && mkdir -p /app");
- * const after = shell.vfs.toSnapshot();
- *
- * const diff = diffSnapshots(before, after);
- * console.log(formatDiff(diff));
- *
- * // Test assertions
- * expect(diff.added).toContain("/app");
- * expect(diff.modified).toContain("/etc/hosts");
- * expect(diff.removed).not.toContain("/tmp/needed-file");
- * ```
- */
-// ─── internal helpers ─────────────────────────────────────────────────────────
-function flattenSnapshot(node, prefix, out) {
-    const path = prefix === "" ? "/" : prefix;
-    out.set(path, node);
-    if (node.type === "directory") {
-        for (const child of node.children ?? []) {
-            flattenSnapshot(child, `${prefix}/${child.name}`, out);
-        }
-    }
-}
-function decodeContent(node) {
-    try {
-        return Buffer.from(node.contentBase64, "base64").toString("utf8");
-    }
-    catch {
-        return node.contentBase64;
-    }
-}
-// ─── public API ───────────────────────────────────────────────────────────────
-/**
- * Compute the diff between two VFS snapshots.
- *
- * @param before  Snapshot taken before the operation.
- * @param after   Snapshot taken after the operation.
- * @param options Optional filtering options.
- * @returns A structured `VfsDiff` result.
- */
-export function diffSnapshots(before, after, options = {}) {
-    const ignorePrefixes = options.ignore ?? [];
-    const shouldIgnore = (path) => ignorePrefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
-    const beforeMap = new Map();
-    const afterMap = new Map();
-    flattenSnapshot(before.root, "", beforeMap);
-    flattenSnapshot(after.root, "", afterMap);
-    const added = [];
-    const removed = [];
-    const modified = [];
-    // Added — in after, not in before
-    for (const [path, node] of afterMap) {
-        if (shouldIgnore(path))
-            continue;
-        if (!beforeMap.has(path)) {
-            added.push({ path, type: node.type });
-        }
-    }
-    // Removed — in before, not in after
-    for (const [path, node] of beforeMap) {
-        if (shouldIgnore(path))
-            continue;
-        if (!afterMap.has(path)) {
-            removed.push({ path, type: node.type });
-        }
-    }
-    // Modified — in both, but content or mode changed
-    for (const [path, afterNode] of afterMap) {
-        if (shouldIgnore(path))
-            continue;
-        const beforeNode = beforeMap.get(path);
-        if (!beforeNode)
-            continue; // already in added
-        if (afterNode.type !== beforeNode.type)
-            continue; // type change = add+remove
-        if (afterNode.type === "file" && beforeNode.type === "file") {
-            const beforeContent = decodeContent(beforeNode);
-            const afterContent = decodeContent(afterNode);
-            const modeChanged = afterNode.mode !== beforeNode.mode;
-            if (beforeContent !== afterContent || modeChanged) {
-                modified.push({
-                    path,
-                    type: "file",
-                    before: beforeContent,
-                    after: afterContent,
-                });
-            }
-        }
-    }
-    // Sort all arrays for determinism
-    const sortByPath = (a, b) => a.path.localeCompare(b.path);
-    added.sort(sortByPath);
-    removed.sort(sortByPath);
-    modified.sort(sortByPath);
-    return {
-        added,
-        removed,
-        modified,
-        clean: added.length === 0 && removed.length === 0 && modified.length === 0,
-    };
-}
-/**
- * Format a `VfsDiff` as a human-readable string similar to `git diff --stat`.
- *
- * @param diff    Result from `diffSnapshots`.
- * @param options Formatting options.
- */
-export function formatDiff(diff, options = {}) {
-    if (diff.clean)
-        return "(no changes)";
-    const { showContent = false, maxContentChars = 120 } = options;
-    const lines = [];
-    for (const entry of diff.added) {
-        lines.push(`+ ${entry.path}  [${entry.type}]`);
-    }
-    for (const entry of diff.removed) {
-        lines.push(`- ${entry.path}  [${entry.type}]`);
-    }
-    for (const entry of diff.modified) {
-        lines.push(`~ ${entry.path}  [modified]`);
-        if (showContent) {
-            const before = entry.before.slice(0, maxContentChars);
-            const after = entry.after.slice(0, maxContentChars);
-            lines.push(`  before: ${JSON.stringify(before)}${entry.before.length > maxContentChars ? "…" : ""}`);
-            lines.push(`  after:  ${JSON.stringify(after)}${entry.after.length > maxContentChars ? "…" : ""}`);
-        }
-    }
-    const summary = [
-        diff.added.length > 0 ? `${diff.added.length} added` : "",
-        diff.removed.length > 0 ? `${diff.removed.length} removed` : "",
-        diff.modified.length > 0 ? `${diff.modified.length} modified` : "",
-    ]
-        .filter(Boolean)
-        .join(", ");
-    lines.push(`\n${summary}`);
-    return lines.join("\n");
-}
-/**
- * Assert that a diff contains specific paths, throwing on mismatch.
- * Designed for use in test suites.
- *
- * @param diff    Result from `diffSnapshots`.
- * @param expect  Expected paths in each category.
- * @throws When any expectation is not met.
- */
-export function assertDiff(diff, expect) {
-    const addedPaths = diff.added.map((e) => e.path);
-    const removedPaths = diff.removed.map((e) => e.path);
-    const modifiedPaths = diff.modified.map((e) => e.path);
-    for (const path of expect.added ?? []) {
-        if (!addedPaths.includes(path)) {
-            throw new Error(`assertDiff: expected "${path}" to be added, but it was not.\nAdded: ${JSON.stringify(addedPaths)}`);
-        }
-    }
-    for (const path of expect.removed ?? []) {
-        if (!removedPaths.includes(path)) {
-            throw new Error(`assertDiff: expected "${path}" to be removed, but it was not.\nRemoved: ${JSON.stringify(removedPaths)}`);
-        }
-    }
-    for (const path of expect.modified ?? []) {
-        if (!modifiedPaths.includes(path)) {
-            throw new Error(`assertDiff: expected "${path}" to be modified, but it was not.\nModified: ${JSON.stringify(modifiedPaths)}`);
-        }
-    }
-}

package/src/web-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web-api.d.ts","sourceRoot":"","sources":["web-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAG,MAAM,kBAAkB,CAAC;AAGjE;;;;GAIG;AACH,cAAM,gBAAgB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE9C,QAAQ,SAAkB;IAIhC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,4DAA4D;IACtD,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7D,uDAAuD;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9C,MAAM;IAIN,WAAW;IAIX,gFAAgF;IAChF,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAInF,uCAAuC;IACvC,MAAM,IAAI,QAAQ;IAIlB,oDAAoD;IACpD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAO9G;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,oBAEvD;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/src/web-api.js

@@ -1,46 +0,0 @@
-import { createWebShell } from "./web";
-/**
- * Browser shim that exposes a VirtualShell-like API backed by the WebShell
- * implementation (IndexedDB mirror). This avoids importing Node-only
- * modules while providing a familiar surface for browser demos.
- */
-class VirtualShellShim {
-    shell;
-    constructor(hostname = "typescript-vm") {
-        this.shell = createWebShell(hostname, {});
-    }
-    async ensureInitialized() {
-        await this.shell.ensureInitialized();
-    }
-    /** Execute a command line and return the command result. */
-    async executeCommandLine(raw) {
-        return this.shell.executeCommandLine(raw);
-    }
-    /** Alias for executeCommandLine to match some APIs. */
-    async run(raw) {
-        return this.executeCommandLine(raw);
-    }
-    getVfs() {
-        return this.shell.vfs;
-    }
-    getHostname() {
-        return this.shell.hostname;
-    }
-    /** Minimal compatibility: write a file as user (no quota checks in browser). */
-    writeFileAsUser(_authUser, targetPath, content) {
-        return this.shell.vfs.writeFile(targetPath, content);
-    }
-    /** Expose env for simple inspection */
-    getEnv() {
-        return this.shell.env;
-    }
-    /** Register a custom command into the web shell. */
-    addCommand(name, params, callback) {
-        // WebShell keeps a private register() method; cast to a minimal register shape.
-        const registrable = this.shell;
-        registrable.register({ name, params, aliases: [], description: "", run: callback });
-    }
-}
-export function createVirtualShellShim(hostname) {
-    return new VirtualShellShim(hostname);
-}

package/src/web-full.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web-full.d.ts","sourceRoot":"","sources":["web-full.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,QAAQ,SAAkB,gBAK5D;AAED,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/src/web-full.js

@@ -1,8 +0,0 @@
-import VirtualFileSystem from "./VirtualFileSystem";
-import { VirtualShell } from "./VirtualShell";
-export function createFullWebShell(hostname = "typescript-vm") {
-    // Use the real VirtualFileSystem so the existing shell runtime gets the full
-    // API surface it expects. The default persistence mode is in-memory, which
-    // keeps this usable in browser bundles without a host filesystem.
-    return new VirtualShell(hostname, undefined, new VirtualFileSystem({}));
-}

package/src/web.d.ts.map

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