@superblocksteam/workspace-sync 0.0.0-stage → 2.0.0-SNAPSHOT.e3d0ac5dd38ba62e

package/dist/server-tree.d.ts

@@ -0,0 +1,56 @@
+import type { DbfsTransport } from "./dbfs-transport.js";
+import type { DirectoryState } from "./snapshot/types.js";
+/**
+ * Reads the whole tree `rootHash` from DBFS. Directories download skips
+ * (`node_modules`, `dist`, ...) are listed with empty contents and not
+ * descended into, so a polluted historical tree costs one listing.
+ */
+export declare function readServerTree(transport: Pick<DbfsTransport, "getDirectory">, rootHash: string): Promise<DirectoryState>;
+/** A tree flattened to slash-separated paths of files and symlinks. */
+export type FlatTree = Map<string, {
+    type: "-";
+    hash: string;
+    executable: boolean;
+} | {
+    type: "l";
+    target: string;
+}>;
+/**
+ * Flattens a tree, leaving out download-skipped directories so a server tree
+ * and a local tree compare like for like.
+ */
+export declare function flattenTree(tree: {
+    contents: ReadonlyArray<{
+        type: "-";
+        name: string;
+        hash: string;
+        executable: boolean;
+    } | {
+        type: "l";
+        name: string;
+        target: string;
+    } | {
+        type: "d";
+        name: string;
+        contents: ReadonlyArray<unknown>;
+    }>;
+}): FlatTree;
+/** What {@link downloadServerTree} wrote. */
+export interface DownloadStats {
+    files: number;
+    bytes: number;
+}
+/**
+ * Makes the local directory `root` match the server tree, touching only what
+ * differs from `local` (the local tree's hashed state, or undefined when the
+ * root is empty). Preserves the exec bit and symlinks, and never deletes
+ * sync-excluded directories such as `node_modules`. Returns how many files it
+ * wrote and their bytes.
+ */
+export declare function downloadServerTree({ transport, tree, local, root, }: {
+    transport: Pick<DbfsTransport, "getContents">;
+    tree: DirectoryState;
+    local: DirectoryState | undefined;
+    root: string;
+}): Promise<DownloadStats>;
+//# sourceMappingURL=server-tree.d.ts.map

package/dist/server-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tree.d.ts","sourceRoot":"","sources":["../src/server-tree.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAe9E;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,EAC9C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CA2CzB;AAED,uEAAuE;AACvE,MAAM,MAAM,QAAQ,GAAG,GAAG,CACxB,MAAM,EACJ;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,QAAQ,EAAE,aAAa,CACnB;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAC9D;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC3C;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAChE,CAAC;CACH,GAAG,QAAQ,CAsBX;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAWD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,SAAS,EACT,IAAI,EACJ,KAAK,EACL,IAAI,GACL,EAAE;IACD,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,aAAa,CAAC,CAkGzB"}

package/dist/server-tree.js

@@ -0,0 +1,179 @@
+import * as fsp from "node:fs/promises";
+import path from "node:path";
+import { codeModeDownloadSkippedDirectories, codeModeSyncExcludedDirectories, } from "@superblocksteam/shared";
+import { isSnapshotExcludedName } from "./sync-paths.js";
+const DIRECTORY_CONCURRENCY = 16;
+const CONTENT_BATCH = 256;
+function isPrivateSnapshotEntry(entry) {
+    return ((entry.name !== ".superblocks" || entry.type !== "d") &&
+        isSnapshotExcludedName(entry.name));
+}
+/**
+ * Reads the whole tree `rootHash` from DBFS. Directories download skips
+ * (`node_modules`, `dist`, ...) are listed with empty contents and not
+ * descended into, so a polluted historical tree costs one listing.
+ */
+export async function readServerTree(transport, rootHash) {
+    const pending = [];
+    const root = { hash: rootHash, contents: [] };
+    const visit = async (target) => {
+        const entries = await transport.getDirectory(target.hash);
+        for (const entry of entries) {
+            if (isPrivateSnapshotEntry(entry))
+                continue;
+            if (entry.type !== "d") {
+                target.contents.push(entry);
+                continue;
+            }
+            const child = { ...entry, contents: [] };
+            target.contents.push(child);
+            if (!codeModeDownloadSkippedDirectories.includes(entry.name))
+                pending.push(() => visit(child));
+        }
+    };
+    pending.push(() => visit(root));
+    // A bounded pool: workers keep pulling until no listing is left.
+    let active = 0;
+    await new Promise((resolve, reject) => {
+        let failed = false;
+        const pump = () => {
+            if (failed)
+                return;
+            if (pending.length === 0 && active === 0)
+                return resolve();
+            while (active < DIRECTORY_CONCURRENCY && pending.length > 0) {
+                const task = pending.shift();
+                active++;
+                task().then(() => {
+                    active--;
+                    pump();
+                }, (error) => {
+                    failed = true;
+                    reject(error);
+                });
+            }
+        };
+        pump();
+    });
+    return root;
+}
+/**
+ * Flattens a tree, leaving out download-skipped directories so a server tree
+ * and a local tree compare like for like.
+ */
+export function flattenTree(tree) {
+    const flat = new Map();
+    const walk = (entries, prefix) => {
+        for (const entry of entries) {
+            if (isPrivateSnapshotEntry(entry))
+                continue;
+            const entryPath = prefix + entry.name;
+            if (entry.type === "d") {
+                if (codeModeDownloadSkippedDirectories.includes(entry.name))
+                    continue;
+                walk(entry.contents, `${entryPath}/`);
+            }
+            else if (entry.type === "l") {
+                flat.set(entryPath, { type: "l", target: entry.target });
+            }
+            else {
+                flat.set(entryPath, {
+                    type: "-",
+                    hash: entry.hash,
+                    executable: entry.executable,
+                });
+            }
+        }
+    };
+    walk(tree.contents, "");
+    return flat;
+}
+function fileMode(executable) {
+    return executable ? 0o755 : 0o644;
+}
+/**
+ * Makes the local directory `root` match the server tree, touching only what
+ * differs from `local` (the local tree's hashed state, or undefined when the
+ * root is empty). Preserves the exec bit and symlinks, and never deletes
+ * sync-excluded directories such as `node_modules`. Returns how many files it
+ * wrote and their bytes.
+ */
+export async function downloadServerTree({ transport, tree, local, root, }) {
+    await fsp.mkdir(root, { recursive: true });
+    const files = [];
+    const apply = async (server, existing, directory, prefix) => {
+        const localByName = new Map((existing ?? []).map((entry) => [entry.name, entry]));
+        for (const entry of server) {
+            let current = localByName.get(entry.name);
+            localByName.delete(entry.name);
+            if (codeModeDownloadSkippedDirectories.includes(entry.name) ||
+                isPrivateSnapshotEntry(entry))
+                continue;
+            const localPath = path.join(directory, entry.name);
+            const dbfsPath = prefix + entry.name;
+            if (current !== undefined && current.type !== entry.type) {
+                await fsp.rm(localPath, { recursive: true, force: true });
+                current = undefined;
+            }
+            switch (entry.type) {
+                case "-": {
+                    const previous = current;
+                    if (previous?.hash !== entry.hash) {
+                        files.push({
+                            path: dbfsPath,
+                            hash: entry.hash,
+                            localPath,
+                            executable: entry.executable,
+                        });
+                    }
+                    else if (previous.executable !== entry.executable) {
+                        await fsp.chmod(localPath, fileMode(entry.executable));
+                    }
+                    break;
+                }
+                case "l": {
+                    const previous = current;
+                    if (previous?.target !== entry.target) {
+                        await fsp.rm(localPath, { force: true });
+                        await fsp.symlink(entry.target, localPath);
+                    }
+                    break;
+                }
+                case "d": {
+                    const previous = current;
+                    if (previous === undefined)
+                        await fsp.mkdir(localPath, { recursive: true });
+                    if (previous?.hash !== entry.hash)
+                        await apply(entry.contents, previous?.contents, localPath, `${dbfsPath}/`);
+                    break;
+                }
+            }
+        }
+        for (const entry of localByName.values()) {
+            if (isSnapshotExcludedName(entry.name) ||
+                (entry.type === "d" &&
+                    codeModeSyncExcludedDirectories.includes(entry.name)))
+                continue;
+            await fsp.rm(path.join(directory, entry.name), {
+                recursive: true,
+                force: true,
+            });
+        }
+    };
+    if (local?.hash !== tree.hash)
+        await apply(tree.contents, local?.contents, root, "");
+    let bytes = 0;
+    for (let idx = 0; idx < files.length; idx += CONTENT_BATCH) {
+        const batch = files.slice(idx, idx + CONTENT_BATCH);
+        const contents = await transport.getContents(tree.hash, batch.map(({ path: filePath, hash }) => ({ path: filePath, hash })));
+        for (const [index, file] of batch.entries()) {
+            const mode = fileMode(file.executable);
+            const content = contents[index];
+            bytes += content.length;
+            await fsp.writeFile(file.localPath, content, { mode });
+            await fsp.chmod(file.localPath, mode);
+        }
+    }
+    return { files: files.length, bytes };
+}
+//# sourceMappingURL=server-tree.js.map

package/dist/server-tree.js.map

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

package/dist/session-draft-journal-store.d.ts

@@ -0,0 +1,42 @@
+import type { DraftJournalRecord, DraftJournalStore } from "./draft-journal-store.js";
+import type { StdISocketRPCClient } from "./rpc-client.js";
+/** The pointer file's name inside the session state directory. */
+export declare const SESSION_DRAFT_JOURNAL_FILE = "native-draft-journal.json";
+/**
+ * Content-addressed blob storage for journal file contents. DBFS file contents
+ * satisfy it; hashes are DBFS content hashes (`hashFileContents`).
+ */
+export interface DraftJournalBlobStore {
+    /** Stores every buffer and returns their content hashes, in order. */
+    put(contents: readonly Buffer[]): Promise<string[]>;
+    /** The bytes stored under `hash`. */
+    get(hash: string): Promise<Buffer>;
+}
+/** {@link DraftJournalBlobStore} over DBFS `putMany` / `fileContents.get`. */
+export declare function createSocketDraftJournalBlobStore(rpcClient: StdISocketRPCClient): DraftJournalBlobStore;
+/**
+ * Keeps the journal as a small pointer record in session storage, with every
+ * file's contents stored as a DBFS blob referenced by content hash. A
+ * microVM's local disk then never holds the base64 copy of the tree, and a
+ * fresh process over the same state directory can still accept or discard the
+ * drafts of a session that was killed.
+ *
+ * Blobs are put before the pointer that references them is written, so a
+ * pointer on disk always resolves.
+ */
+export declare class SessionDraftJournalStore implements DraftJournalStore {
+    private readonly options;
+    private readonly stored;
+    constructor(options: {
+        /** Session state directory; must be outside the application root. */
+        stateDir: string;
+        blobs: DraftJournalBlobStore;
+    });
+    get file(): string;
+    read(): Promise<DraftJournalRecord | undefined>;
+    write(record: DraftJournalRecord): Promise<void>;
+    clear(): Promise<void>;
+    private put;
+    private fetch;
+}
+//# sourceMappingURL=session-draft-journal-store.d.ts.map

package/dist/session-draft-journal-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-draft-journal-store.d.ts","sourceRoot":"","sources":["../src/session-draft-journal-store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAoBtE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,GAAG,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,8EAA8E;AAC9E,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,mBAAmB,GAC7B,qBAAqB,CAwBvB;AAuBD;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAI9D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,YACmB,OAAO,EAAE;QACxB,qEAAqE;QACrE,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,qBAAqB,CAAC;KAC9B,EACC;IAEJ,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,IAAI,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAwCpD;IAEK,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;YAEa,GAAG;YAuBH,KAAK;CAmBpB"}

package/dist/session-draft-journal-store.js

@@ -0,0 +1,177 @@
+import * as fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { hashFileContents, unwrapResponseDto } from "@superblocksteam/shared";
+import { writeFileAtomic } from "./atomic-write.js";
+import { assertOutsideRoot } from "./file-draft-journal-store.js";
+import { SafeDirectoryReader } from "./safe-directory-reader.js";
+/** The pointer file's name inside the session state directory. */
+export const SESSION_DRAFT_JOURNAL_FILE = "native-draft-journal.json";
+const MAX_POINTER_BYTES = 8 * 1024 * 1024;
+const PUT_BATCH_ITEMS = 64;
+const PUT_BATCH_BYTES = 8 * 1024 * 1024;
+const GET_CONCURRENCY = 16;
+const pointerSchema = z.object({
+    version: z.literal(1),
+    root: z.string(),
+    scope: z.string(),
+    id: z.string(),
+    /** Relative path -> DBFS content hash. */
+    before: z.record(z.string()),
+    originals: z.record(z.string()),
+    phase: z.enum(["running", "complete"]),
+    hash: z.string().optional(),
+});
+/** {@link DraftJournalBlobStore} over DBFS `putMany` / `fileContents.get`. */
+export function createSocketDraftJournalBlobStore(rpcClient) {
+    return {
+        async put(contents) {
+            const hashes = [];
+            for (const batch of batches(contents)) {
+                const response = await unwrapResponseDto(rpcClient.call.v1.dbfs.putMany({
+                    items: batch.map((bytes) => ({
+                        type: "fileContents",
+                        contents: bytes.toString("base64"),
+                    })),
+                }));
+                hashes.push(...response.items.map((item) => item.hash));
+            }
+            return hashes;
+        },
+        async get(hash) {
+            const response = await unwrapResponseDto(rpcClient.call.v1.dbfs.fileContents.get({ hash }));
+            return Buffer.from(response.contents, "base64");
+        },
+    };
+}
+/** Splits `contents` into putMany-sized batches by item count and bytes. */
+function* batches(contents) {
+    let batch = [];
+    let bytes = 0;
+    for (const item of contents) {
+        if (batch.length > 0 &&
+            (batch.length >= PUT_BATCH_ITEMS || bytes + item.length > PUT_BATCH_BYTES)) {
+            yield batch;
+            batch = [];
+            bytes = 0;
+        }
+        batch.push(item);
+        bytes += item.length;
+    }
+    if (batch.length > 0)
+        yield batch;
+}
+/**
+ * Keeps the journal as a small pointer record in session storage, with every
+ * file's contents stored as a DBFS blob referenced by content hash. A
+ * microVM's local disk then never holds the base64 copy of the tree, and a
+ * fresh process over the same state directory can still accept or discard the
+ * drafts of a session that was killed.
+ *
+ * Blobs are put before the pointer that references them is written, so a
+ * pointer on disk always resolves.
+ */
+export class SessionDraftJournalStore {
+    options;
+    stored = new Set();
+    constructor(options) {
+        this.options = options;
+    }
+    get file() {
+        return path.join(this.options.stateDir, SESSION_DRAFT_JOURNAL_FILE);
+    }
+    async read() {
+        const reader = await SafeDirectoryReader.open(this.options.stateDir).catch((error) => {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        });
+        if (!reader)
+            return undefined;
+        let contents;
+        try {
+            contents = await reader.readFile(SESSION_DRAFT_JOURNAL_FILE, MAX_POINTER_BYTES);
+        }
+        finally {
+            await reader.close();
+        }
+        if (!contents)
+            return undefined;
+        const pointer = pointerSchema.parse(JSON.parse(contents.toString("utf8")));
+        const blobs = await this.fetch([
+            ...Object.values(pointer.before),
+            ...Object.values(pointer.originals),
+        ]);
+        const resolve = (files) => new Map(Object.entries(files).map(([relative, hash]) => [
+            relative,
+            blobs.get(hash),
+        ]));
+        return {
+            root: pointer.root,
+            scope: pointer.scope,
+            id: pointer.id,
+            before: resolve(pointer.before),
+            originals: resolve(pointer.originals),
+            phase: pointer.phase,
+            ...(pointer.hash === undefined ? {} : { hash: pointer.hash }),
+        };
+    }
+    async write(record) {
+        await fs.mkdir(this.options.stateDir, { recursive: true, mode: 0o700 });
+        assertOutsideRoot(await fs.realpath(record.root), await fs.realpath(this.options.stateDir));
+        const before = await this.put(record.before);
+        const originals = await this.put(record.originals);
+        const pointer = {
+            version: 1,
+            root: record.root,
+            scope: record.scope,
+            id: record.id,
+            before,
+            originals,
+            phase: record.phase,
+            hash: record.hash,
+        };
+        await writeFileAtomic(this.file, JSON.stringify(pointer));
+    }
+    async clear() {
+        await fs.rm(this.file, { force: true });
+    }
+    async put(files) {
+        const references = {};
+        const missing = new Map();
+        for (const [relative, bytes] of files) {
+            const hash = await hashFileContents(bytes);
+            references[relative] = hash;
+            if (!this.stored.has(hash))
+                missing.set(hash, bytes);
+        }
+        if (missing.size > 0) {
+            const expected = [...missing.keys()];
+            const hashes = await this.options.blobs.put([...missing.values()]);
+            if (hashes.length !== expected.length ||
+                hashes.some((hash, index) => hash !== expected[index]))
+                throw new Error("DBFS returned unexpected hashes for journal blobs");
+            for (const hash of expected)
+                this.stored.add(hash);
+        }
+        return references;
+    }
+    async fetch(hashes) {
+        const unique = [...new Set(hashes)];
+        const blobs = new Map();
+        let next = 0;
+        const worker = async () => {
+            while (next < unique.length) {
+                const hash = unique[next++];
+                const bytes = await this.options.blobs.get(hash);
+                if ((await hashFileContents(bytes)) !== hash)
+                    throw new Error("Native draft journal blob does not match its hash");
+                blobs.set(hash, bytes);
+                this.stored.add(hash);
+            }
+        };
+        await Promise.all(Array.from({ length: Math.min(GET_CONCURRENCY, unique.length) }, worker));
+        return blobs;
+    }
+}
+//# sourceMappingURL=session-draft-journal-store.js.map

package/dist/session-draft-journal-store.js.map

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

package/dist/snapshot/take-snapshot.d.ts

@@ -0,0 +1,41 @@
+import type { DirectorySnapshot } from "./types.js";
+/**
+ * Takes a snapshot of a local directory. The current implementation stores the snapshot in memory.
+ * This is not scalable for large directories and is subject to change.
+ *
+ * This function now captures the DRAFT state (current filesystem state).
+ * For committed state, use snapshotLocalDirectoryCommittedState.
+ *
+ * @param localDirectoryPath - The path to the local directory to snapshot.
+ * @returns A promise that resolves to a snapshot of the local directory.
+ */
+export declare function snapshotLocalDirectory(localDirectoryPath: string, rootDirectoryPath?: string): Promise<DirectorySnapshot>;
+/**
+ * Takes a snapshot of a local directory showing the COMMITTED state.
+ * This function:
+ * - Uses .sbswap.edit content from the drafts directory instead of current files (for edited files)
+ * - Excludes files that have .sbswap.add markers in the drafts directory (draft additions)
+ * - Excludes .sbswap.edit and .sbswap.add marker files themselves
+ *
+ * @param localDirectoryPath - The path to the local directory to snapshot.
+ * @param appRootPath - The app root path (defaults to localDirectoryPath for top-level calls).
+ * @param editMarkerMap - Map of edit markers (for internal recursive use).
+ * @param addMarkerSet - Set of add markers (for internal recursive use).
+ * @returns A promise that resolves to a snapshot of the committed state.
+ */
+export declare function snapshotLocalDirectoryCommittedState(localDirectoryPath: string, appRootPath?: string, editMarkerMap?: Map<string, Buffer>, addMarkerSet?: Set<string>): Promise<DirectorySnapshot>;
+/**
+ * Takes a snapshot of a local directory, prioritizing .sbswap files for content.
+ * .sbswap files themselves are not included in the snapshot output.
+ *
+ * @param localDirectoryPath - The path to the local directory to snapshot.
+ * @returns A promise that resolves to a snapshot of the local directory, reflecting draft states.
+ */
+export declare function snapshotLocalDirectoryWithDrafts(localDirectoryPath: string): Promise<DirectorySnapshot>;
+/**
+ * Flattens a snapshot into relative path -> content hash. A symlink maps to its
+ * target, so retargeting it counts as a change. Directories are left out; their
+ * files carry the change.
+ */
+export declare function snapshotPathHashes(snapshot: DirectorySnapshot): Map<string, string>;
+//# sourceMappingURL=take-snapshot.d.ts.map

package/dist/snapshot/take-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take-snapshot.d.ts","sourceRoot":"","sources":["../../src/snapshot/take-snapshot.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAEtE;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,SAAqB,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAqD5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oCAAoC,CACxD,kBAAkB,EAAE,MAAM,EAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAgH5B;AA4DD;;;;;;GAMG;AACH,wBAAsB,gCAAgC,CACpD,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,GAC1B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBrB"}