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

package/dist/download.js

@@ -0,0 +1,475 @@
+import * as fsp from "node:fs/promises";
+import { NotFoundError, unwrapResponseDto } from "@superblocksteam/shared";
+import { codeModeDownloadSkippedDirectories, codeModeSyncExcludedDirectories, ExportViewMode, } from "@superblocksteam/shared";
+import { cleanUpDraftsDirectory, getDraftInfo, writeDraftMarker, } from "./draft-helpers.js";
+import { hashLocalDirectory } from "./hash-dir-tree.js";
+import { getSyncLogger } from "./logger.js";
+import { isSnapshotExcludedName } from "./sync-paths.js";
+const DOWNLOAD_BATCH_SIZE = 50;
+// TODO(code-mode): this is re-implemented in the sdk package
+// because SDK depends on vite-plugin-file-sync, but can't be circular
+async function getApplicationDirectoryHash(rpcClient, applicationId, branch, localDirectoryPath) {
+    const [draftOrLiveEditHash, localDirectoryStatePreDownload] = await Promise.all([
+        getDraftOrLiveDirectoryHash(rpcClient, applicationId, branch),
+        hashLocalDirectory(localDirectoryPath),
+    ]);
+    const directoryHash = draftOrLiveEditHash.hash;
+    if (!directoryHash) {
+        throw new Error("No live edit hash found");
+    }
+    return {
+        serverDirectoryHash: directoryHash,
+        latestNonDraftCommitId: draftOrLiveEditHash.latestNonDraftCommitId,
+        localDirectoryStatePreDownload,
+    };
+}
+export async function downloadApplicationDirectory({ rpcClient, applicationId, branch, localDirectoryPath, hashCache, }) {
+    const { serverDirectoryHash, latestNonDraftCommitId, localDirectoryStatePreDownload, } = await getApplicationDirectoryHash(rpcClient, applicationId, branch, localDirectoryPath);
+    const directoryState = await doDownloadApplicationDirectory(rpcClient, serverDirectoryHash, localDirectoryStatePreDownload, localDirectoryPath);
+    // Now that the directory has been downloaded, we know that all of its hashes are in the server,
+    // so we can add them to the hash cache
+    hashCache.add_directory_recursive(directoryState);
+    return { directoryHash: serverDirectoryHash, latestNonDraftCommitId };
+}
+/**
+ * Incrementally download the directory contents, skipping any files that are already
+ * present locally, based on the old local directory state.
+ * Returns the new local directory state.
+ *
+ * @param rpcClient - The RPC client to use to get the directory contents from the server.
+ * @param directoryHash - The hash of the directory to download.
+ * @param oldLocalDirState - The old local directory state.
+ * @param localDirectoryPath - The path to the local directory.
+ * @returns The new local directory state.
+ */
+export async function doDownloadApplicationDirectory(rpcClient, directoryHash, oldLocalDirState, localDirectoryPath) {
+    const filesToGet = [];
+    const doRecursive = async (rpcClient, directoryHash, oldLocalDirState, localDirectoryPath, dbfsPath, filesToGet) => {
+        if (oldLocalDirState?.hash === directoryHash) {
+            // The directory is already up to date, we don't need to download anything and we can return the old local directory state
+            return oldLocalDirState;
+        }
+        const newStateContents = [];
+        // FIXME: @joeyagreco - this is slow!
+        // FIXME: @joeyagreco - look into having this be a single call to the server beforehand or implement pagination of some sort
+        const directoryContentsResponse = await unwrapResponseDto(rpcClient.call.v1.dbfs.directoryContents.get({ hash: directoryHash }));
+        // Create a map of the local directory contents
+        // As we process the directory entries, we will be removing them from the map so that the entries left will
+        // correspond to files that have been deleted
+        const localDirMap = new Map(oldLocalDirState?.contents.map((entry) => [entry.name, entry]) ?? []);
+        for (const entry of directoryContentsResponse.contents) {
+            const entryDbfsPath = dbfsPath === "" ? entry.name : `${dbfsPath}/${entry.name}`;
+            if (codeModeDownloadSkippedDirectories.includes(entry.name) ||
+                ((entry.name !== ".superblocks" || entry.type !== "d") &&
+                    isSnapshotExcludedName(entry.name))) {
+                getSyncLogger().debug(`[sync-service] dbfs download: skipping download-excluded entry "${entry.name}" (type ${entry.type}) at ${entryDbfsPath}`);
+                if (entry.type !== "d") {
+                    getSyncLogger().warn(`[sync-service] dbfs download: skipping non-directory entry "${entry.name}" (type ${entry.type}) with download-excluded name at ${entryDbfsPath}`);
+                }
+                localDirMap.delete(entry.name);
+                continue;
+            }
+            const localFilePath = `${localDirectoryPath}/${entry.name}`;
+            // The entry has been matched, remove it from the map, if it exists
+            let localEntry = localDirMap.get(entry.name);
+            localDirMap.delete(entry.name);
+            if (localEntry !== undefined && localEntry.type !== entry.type) {
+                // The file type has changed, the file is a regular file but the local file is not, so we need to delete the local file
+                // because we will not be able to overwrite it otherwise
+                await fsp.rm(localFilePath, { recursive: true });
+                localEntry = undefined;
+            }
+            // At this point, if `localEntry` is defined, it is guaranteed to have the same type as `entry`.
+            // TypeScript will not be able to infer this, so we need to cast it to the correct type in each case.
+            switch (entry.type) {
+                case "-": {
+                    newStateContents.push(entry);
+                    const localEntryTyped = localEntry;
+                    if (localEntryTyped?.hash !== entry.hash) {
+                        filesToGet.push({
+                            dbfsPath: entryDbfsPath,
+                            hash: entry.hash,
+                            localFilePath,
+                        });
+                    }
+                    break;
+                }
+                case "l": {
+                    newStateContents.push(entry);
+                    const localEntryTyped = localEntry;
+                    if (localEntryTyped?.target !== entry.target) {
+                        await fsp.symlink(entry.target, localFilePath);
+                    }
+                    break;
+                }
+                case "d": {
+                    const localEntryTyped = localEntry;
+                    if (localEntryTyped === undefined) {
+                        await fsp.mkdir(localFilePath, { recursive: true }); // don't fail if directory exists
+                    }
+                    const localSubDirState = localEntryTyped === undefined
+                        ? undefined
+                        : {
+                            hash: localEntryTyped.hash,
+                            contents: localEntryTyped.contents,
+                        };
+                    const newSubDirState = await doRecursive(rpcClient, entry.hash, localSubDirState, localFilePath, entryDbfsPath, filesToGet);
+                    newStateContents.push({
+                        ...entry,
+                        contents: newSubDirState.contents,
+                    });
+                    break;
+                }
+                default: {
+                    throw new Error(`Unknown entry type: ${entry}`);
+                }
+            }
+        }
+        // Any remaining entries in the map are files/directories that have been deleted
+        for (const localEntry of localDirMap.values()) {
+            // Never delete sync-excluded directories (e.g. `.superblocks`) during
+            // download reconciliation. They are upload-excluded (see
+            // `codeModeSyncExcludedDirectories` / `listLocalDirectory`), so the
+            // server manifest never lists them — treating that absence as a
+            // server-side deletion would `rm -rf` app-scoped local state such as
+            // `.superblocks/superblocks.json`, bricking the live-edit workspace
+            // (APPS-4488). Upload and download must honor the same exclusions.
+            if (isSnapshotExcludedName(localEntry.name) ||
+                (localEntry.type === "d" &&
+                    codeModeSyncExcludedDirectories.includes(localEntry.name))) {
+                getSyncLogger().debug(`[sync-service] dbfs download: keeping upload-excluded directory "${localEntry.name}" at ${localDirectoryPath} — skipping deletion`);
+                // Not pushed to newStateContents: excluded dirs are not server-tracked
+                // and must not appear in the returned DirectoryState (used only for
+                // upload-hash caching).
+                continue;
+            }
+            const localFilePath = `${localDirectoryPath}/${localEntry.name}`;
+            getSyncLogger().debug(`[sync-service] dbfs download: deleting local entry "${localEntry.name}" at ${localFilePath}`);
+            await fsp.rm(localFilePath, { recursive: true });
+        }
+        return {
+            hash: directoryHash,
+            contents: newStateContents,
+        };
+    };
+    const newLocalDirState = await doRecursive(rpcClient, directoryHash, oldLocalDirState, localDirectoryPath, "", filesToGet);
+    const downloadedWithGetMany = await tryDownloadFilesByPath(rpcClient, directoryHash, filesToGet);
+    if (downloadedWithGetMany) {
+        return newLocalDirState;
+    }
+    for (let i = 0; i < filesToGet.length; i += DOWNLOAD_BATCH_SIZE) {
+        const batch = filesToGet.slice(i, i + DOWNLOAD_BATCH_SIZE);
+        await Promise.all(batch.map(async ({ hash, localFilePath }) => {
+            const fileContentsResponse = await unwrapResponseDto(rpcClient.call.v1.dbfs.fileContents.get({ hash }));
+            const fileContents = Buffer.from(fileContentsResponse.contents, "base64");
+            await fsp.writeFile(localFilePath, fileContents);
+        }));
+    }
+    return newLocalDirState;
+}
+export class DraftRestoreError extends Error {
+    phase;
+    constructor(phase, cause) {
+        super(`Draft restore failed during ${phase}`, { cause });
+        this.phase = phase;
+    }
+}
+async function inPhase(phase, run) {
+    try {
+        return await run();
+    }
+    catch (e) {
+        throw new DraftRestoreError(phase, e);
+    }
+}
+/**
+ * Rebuilds the `.sbswap` markers that a replaced pod lost: every file that
+ * differs from the last checkpoint becomes a draft, so Accept and Reject work.
+ * The markers do not change the upload hash, because snapshots skip them.
+ */
+export async function restoreDraftMarkersFromCheckpoint({ rpcClient, applicationId, branch, appRootDirPath, }) {
+    const existing = await getDraftInfo(appRootDirPath);
+    if (existing.edits.length +
+        existing.additions.length +
+        existing.deletions.length >
+        0) {
+        return {
+            outcome: "markers_present",
+            edits: existing.edits.length,
+            additions: existing.additions.length,
+            deletions: existing.deletions.length,
+        };
+    }
+    const checkpointHash = await inPhase("checkpoint_fetch", async () => {
+        try {
+            // EXPORT_LIVE is the latest non-draft commit, the same commit the server
+            // compares an upload with to decide whether to create a checkpoint.
+            const checkpoint = await unwrapResponseDto(rpcClient.call.v3.application.directoryContents.get({
+                applicationId,
+                branchName: branch,
+                viewMode: ExportViewMode.EXPORT_LIVE,
+            }));
+            return checkpoint.hash;
+        }
+        catch (e) {
+            if (e instanceof NotFoundError) {
+                return undefined;
+            }
+            throw e;
+        }
+    });
+    if (checkpointHash === undefined) {
+        return { outcome: "no_checkpoint", edits: 0, additions: 0, deletions: 0 };
+    }
+    const markers = [];
+    await inPhase("tree_diff", async () => diffWithCheckpoint(rpcClient, checkpointHash, await hashLocalDirectory(appRootDirPath), "", markers));
+    if (markers.length === 0) {
+        return { outcome: "no_changes", edits: 0, additions: 0, deletions: 0 };
+    }
+    // Fetch every original before writing any marker, so a failed fetch leaves no partial draft.
+    const originals = await inPhase("content_fetch", async () => {
+        const contents = [];
+        for (let i = 0; i < markers.length; i += DOWNLOAD_BATCH_SIZE) {
+            const batch = markers.slice(i, i + DOWNLOAD_BATCH_SIZE);
+            contents.push(...(await Promise.all(batch.map(async ({ checkpointHash: hash }) => {
+                if (hash === undefined) {
+                    return undefined;
+                }
+                const response = await unwrapResponseDto(rpcClient.call.v1.dbfs.fileContents.get({ hash }));
+                return Buffer.from(response.contents, "base64");
+            }))));
+        }
+        return contents;
+    });
+    await inPhase("marker_write", async () => {
+        try {
+            for (const [i, marker] of markers.entries()) {
+                await writeDraftMarker(marker.path, appRootDirPath, marker.kind, originals[i]);
+            }
+        }
+        catch (e) {
+            // No marker existed before this loop, so removing the drafts directory undoes a partial write.
+            await cleanUpDraftsDirectory(appRootDirPath);
+            throw e;
+        }
+    });
+    const count = (kind) => markers.filter((marker) => marker.kind === kind).length;
+    return {
+        outcome: "restored",
+        edits: count("edit"),
+        additions: count("add"),
+        deletions: count("delete"),
+    };
+}
+async function diffWithCheckpoint(rpcClient, checkpointHash, local, prefix, markers) {
+    if (local?.hash === checkpointHash) {
+        return;
+    }
+    const { contents } = await unwrapResponseDto(rpcClient.call.v1.dbfs.directoryContents.get({ hash: checkpointHash }));
+    const localByName = new Map(local?.contents.map((entry) => [entry.name, entry]) ?? []);
+    for (const entry of contents) {
+        const localEntry = localByName.get(entry.name);
+        localByName.delete(entry.name);
+        if (codeModeSyncExcludedDirectories.includes(entry.name) ||
+            isSnapshotExcludedName(entry.name)) {
+            continue;
+        }
+        // A local symlink is not part of the restored draft, so Reject never writes through it.
+        if (localEntry?.type === "l") {
+            continue;
+        }
+        const entryPath = prefix + entry.name;
+        if (entry.type === "d") {
+            await diffWithCheckpoint(rpcClient, entry.hash, localEntry?.type === "d" ? localEntry : undefined, `${entryPath}/`, markers);
+            if (localEntry?.type === "-") {
+                markers.push({ kind: "add", path: entryPath });
+            }
+        }
+        else if (entry.type === "-") {
+            if (localEntry?.type !== "-") {
+                markers.push({
+                    kind: "delete",
+                    path: entryPath,
+                    checkpointHash: entry.hash,
+                });
+                if (localEntry?.type === "d") {
+                    collectLocalAdditions(localEntry.contents, `${entryPath}/`, markers);
+                }
+            }
+            else if (localEntry.hash !== entry.hash) {
+                markers.push({
+                    kind: "edit",
+                    path: entryPath,
+                    checkpointHash: entry.hash,
+                });
+            }
+        }
+    }
+    collectLocalAdditions([...localByName.values()], prefix, markers);
+}
+function collectLocalAdditions(entries, prefix, markers) {
+    for (const entry of entries) {
+        if (codeModeSyncExcludedDirectories.includes(entry.name) ||
+            isSnapshotExcludedName(entry.name)) {
+            continue;
+        }
+        if (entry.type === "-") {
+            markers.push({ kind: "add", path: prefix + entry.name });
+        }
+        else if (entry.type === "d") {
+            collectLocalAdditions(entry.contents, `${prefix}${entry.name}/`, markers);
+        }
+    }
+}
+async function tryDownloadFilesByPath(rpcClient, rootHash, filesToGet) {
+    if (filesToGet.length === 0) {
+        return true;
+    }
+    const getMany = rpcClient.call.v1.dbfs.getMany;
+    if (getMany === undefined) {
+        return false;
+    }
+    try {
+        const response = await unwrapResponseDto(getMany({
+            rootHash,
+            paths: filesToGet.map((file) => file.dbfsPath),
+        }));
+        const itemByPath = new Map(response.items.map((item) => [item.path, item]));
+        if (response.items.length !== filesToGet.length) {
+            throw new InvalidGetManyResponseError(`DBFS getMany returned ${response.items.length} items for ${filesToGet.length} requested files`);
+        }
+        const filesWithContents = filesToGet.map((file) => {
+            const item = itemByPath.get(file.dbfsPath);
+            if (item?.type !== "fileContents") {
+                throw new InvalidGetManyResponseError(`DBFS getMany did not return file contents for ${file.dbfsPath}`);
+            }
+            if (item.hash !== file.hash) {
+                throw new InvalidGetManyResponseError(`DBFS getMany returned hash ${item.hash} for ${file.dbfsPath}, expected ${file.hash}`);
+            }
+            return {
+                file,
+                contents: Buffer.from(item.contents, "base64"),
+            };
+        });
+        // Validate every returned item before changing the local filesystem. A
+        // malformed partial response can then safely fall back to per-file reads.
+        for (const { file, contents } of filesWithContents) {
+            await fsp.writeFile(file.localFilePath, contents);
+        }
+        return true;
+    }
+    catch (e) {
+        if (e instanceof InvalidGetManyResponseError ||
+            isGetManyUnsupported(e) ||
+            isBulkReadLimitError(e)) {
+            getSyncLogger().warn(`DBFS getMany unavailable, invalid, or exceeded bulk limits (${getErrorMessage(e)}), falling back to per-file download`);
+            return false;
+        }
+        throw e;
+    }
+}
+class InvalidGetManyResponseError extends Error {
+}
+function isSocketError(e) {
+    return (typeof e === "object" &&
+        e !== null &&
+        "code" in e &&
+        typeof e.code === "number" &&
+        "message" in e &&
+        typeof e.message === "string");
+}
+function getErrorMessage(e) {
+    if (e instanceof Error || isSocketError(e)) {
+        return e.message;
+    }
+    return String(e);
+}
+function isBulkReadLimitError(e) {
+    const message = getErrorMessage(e);
+    return (message.includes("maxObjects") ||
+        message.includes("maxBytes") ||
+        message.includes("bulk read"));
+}
+function isGetManyUnsupported(e) {
+    return ((isSocketError(e) && e.code === 2) ||
+        getErrorMessage(e).includes("is not implemented"));
+}
+export async function getDraftOrLiveDirectoryHash(rpcClient, applicationId, branch) {
+    // Prefer the live-edit working copy. Clark's in-progress autosaves advance the
+    // working-copy pointer (application_live_edit.directoryContentsHash) without
+    // creating a commit, so the commit-based draft/live views can lag behind it.
+    // Restoring an older commit on a cold/recycled pod is what made in-progress
+    // work appear lost (APPS-4873).
+    try {
+        const response = await unwrapResponseDto(rpcClient.call.v3.application.directoryContents.get({
+            applicationId,
+            branchName: branch,
+            viewMode: ExportViewMode.EXPORT_LIVE_EDIT,
+        }));
+        const directoryHash = response;
+        return {
+            hash: directoryHash.hash,
+            latestNonDraftCommitId: directoryHash.latestNonDraftCommitId,
+        };
+    }
+    catch (e) {
+        // Fall back to the commit-based draft/live views only when this app has no
+        // live-edit working copy (NotFoundError) or when the server predates the
+        // EXPORT_LIVE_EDIT view mode (deploy skew: an old server reports it as not
+        // implemented). Any other error (auth, transport) surfaces, matching the
+        // draft/live behavior below — a cold load that can resolve no hash should
+        // fail loudly rather than silently restore a stale tree.
+        if (!isMissingLiveEditOrUnsupportedViewMode(e)) {
+            throw e;
+        }
+        getSyncLogger().warn(`Live-edit working copy unavailable (${e instanceof Error ? e.message : String(e)}), falling back to draft/live views`);
+    }
+    return getDraftOrLiveCommitDirectoryHash(rpcClient, applicationId, branch);
+}
+// The legacy restore path: the latest draft commit, falling back to the latest
+// non-draft (live) commit. Used when no live-edit working copy is available, or
+// against a server that predates the live-edit view mode.
+async function getDraftOrLiveCommitDirectoryHash(rpcClient, applicationId, branch) {
+    try {
+        const response = await unwrapResponseDto(rpcClient.call.v3.application.directoryContents.get({
+            applicationId,
+            branchName: branch,
+            viewMode: ExportViewMode.EXPORT_DRAFT,
+        }));
+        const directoryHash = response;
+        return {
+            hash: directoryHash.hash,
+            latestNonDraftCommitId: directoryHash.latestNonDraftCommitId,
+        };
+    }
+    catch (e) {
+        if (e instanceof NotFoundError) {
+            const response = await unwrapResponseDto(rpcClient.call.v3.application.directoryContents.get({
+                applicationId,
+                branchName: branch,
+                viewMode: ExportViewMode.EXPORT_LIVE,
+            }));
+            // This is the latest live (non-draft) commit, i.e. a snapshot -- not the
+            // live-edit working copy. The working copy is restored earlier via
+            // EXPORT_LIVE_EDIT; this path only runs when that is unavailable.
+            getSyncLogger().warn(`Draft commit not found, falling back to the latest live commit: ${response.hash}`);
+            const directoryHash = response;
+            return {
+                hash: directoryHash.hash,
+                latestNonDraftCommitId: directoryHash.latestNonDraftCommitId,
+            };
+        }
+        throw e;
+    }
+}
+// True when the live-edit view should yield to the legacy draft/live path:
+// either this app has no live-edit working copy (NotFoundError), or the server
+// is too old to know the view mode and reports it as not implemented.
+function isMissingLiveEditOrUnsupportedViewMode(e) {
+    if (e instanceof NotFoundError) {
+        return true;
+    }
+    const message = e instanceof Error ? e.message : String(e);
+    return message.includes("is not implemented");
+}
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

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

package/dist/draft-helpers.d.ts

@@ -0,0 +1,127 @@
+declare const MARKER_EXT: {
+    readonly add: ".sbswap.add";
+    readonly delete: ".sbswap.delete";
+    readonly edit: ".sbswap.edit";
+};
+/**
+ * Creates a draft edit or addition marker file only.
+ *
+ * @param filePath - The absolute path to the file for which to create the respective marker.
+ * @param appRootDirPath - The absolute path to the app root directory.
+ */
+export declare function createDraftMarkerOnly(filePath: string, appRootDirPath: string): Promise<void>;
+/**
+ * Creates a draft edit or addition based on the presence of an existing file.
+ * This makes the draft content visible to the build system while preserving the original.
+ *
+ * @param filePath - The absolute path to the file to edit or add.
+ * @param draftContent - The content of the draft edit or addition.
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves to "edit" if the file already exists, or "add" if the file does not exist.
+ */
+export declare function createDraft(filePath: string, draftContent: string | Buffer, appRootDirPath: string): Promise<"edit" | "add">;
+/**
+ * Creates a draft edit by copying the original file to the drafts directory and writing draft content to the original location.
+ * This makes the draft content visible to the build system while preserving the original.
+ * If a draft edit already exists, this will just update the draft content.
+ *
+ * @param filePath - The absolute path to the file to edit.
+ * @param draftContent - The content of the draft edit.
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves when the draft edit is created.
+ */
+export declare function createDraftEdit(filePath: string, draftContent: string | Buffer, appRootDirPath: string): Promise<void>;
+/**
+ * Creates a draft addition by writing new file content and creating a .sbswap.add marker.
+ * This makes the new file visible to the build system while marking it as a draft addition.
+ * If a draft addition already exists, this will just update the content.
+ *
+ * @param filePath - The absolute path where the new file should be created.
+ * @param content - The content of the new file.
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves when the draft addition is created.
+ */
+export declare function createDraftAdd(filePath: string, content: string | Buffer, appRootDirPath: string): Promise<void>;
+/**
+ * Writes a marker for a file that already holds its draft content, leaving the
+ * file untouched. `original` is the pre-draft content of an edit or a delete.
+ */
+export declare function writeDraftMarker(relativePath: string, appRootDirPath: string, kind: keyof typeof MARKER_EXT, original?: Buffer): Promise<void>;
+export declare class DraftMarkers {
+    private readonly root;
+    constructor(root: string);
+    prepare(): Promise<void>;
+    originals(targets: string[], before: Map<string, Buffer>, maxBytes: number, maxFiles: number): Promise<Map<string, Buffer>>;
+    private assertSafePath;
+    private markerFiles;
+    reconcile(relative: string, original: Buffer | undefined, current: Buffer | undefined): Promise<void>;
+    private withinTargets;
+}
+/**
+ * Creates a draft deletion by backing up the file content and removing it from the workspace.
+ *
+ * @param filePath - The absolute path to the file to delete.
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves when the draft deletion is created.
+ */
+export declare function createDraftDelete(filePath: string, appRootDirPath: string): Promise<void>;
+/**
+ * Recursively checks if any draft files exist in the drafts directory.
+ * Looks for .sbswap.edit, .sbswap.add, and .sbswap.delete marker files.
+ *
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves to true if any draft files are found, false otherwise.
+ */
+export declare function hasSwapFiles(appRootDirPath: string): Promise<boolean>;
+/**
+ * {@link hasSwapFiles} for decisions that clear the server's draft flag: only
+ * a missing drafts directory means no drafts. A directory or entry that
+ * cannot be read counts as a draft, so an unreadable tree never reads as
+ * reviewed.
+ */
+export declare function hasDraftsFailClosed(appRootDirPath: string): Promise<boolean>;
+/**
+ * Throws unless the drafts directory is gone. Accept, reject and clear all
+ * end by removing it, and their helpers swallow removal and read errors, so
+ * this is the check that they finished.
+ */
+export declare function assertDraftsSettled(appRootDirPath: string, action: string): Promise<void>;
+/**
+ * Discards all draft changes by removing draft additions, then restoring the
+ * originals of edits and deletions. Each marker is retired once its step
+ * succeeds, so a retry after a failed restore resumes where it stopped.
+ *
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves when all drafts have been discarded.
+ */
+export declare function discardAllDrafts(appRootDirPath: string): Promise<void>;
+export declare function cleanUpDraftsDirectory(appRootDirPath: string): Promise<void>;
+/**
+ * Commits all draft changes by removing .sbswap.edit and .sbswap.add markers.
+ * This leaves the current filesystem state as the committed state.
+ *
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves when all drafts have been committed.
+ */
+export declare function commitAllDrafts(appRootDirPath: string): Promise<void>;
+/**
+ * Gets information about all draft files in the drafts directory.
+ *
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @returns A promise that resolves to information about draft files.
+ */
+export declare function getDraftInfo(appRootDirPath: string): Promise<{
+    edits: string[];
+    additions: string[];
+    deletions: string[];
+}>;
+/**
+ * Generates a git-like diff showing all draft changes.
+ *
+ * @param appRootDirPath - The absolute path to the app root directory.
+ * @param specificPaths - An optional array of relative paths to limit the diff to.
+ * @returns A promise that resolves to a git-like diff string.
+ */
+export declare function generateDraftDiff(appRootDirPath: string, specificPaths?: string[]): Promise<string>;
+export {};
+//# sourceMappingURL=draft-helpers.d.ts.map

package/dist/draft-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-helpers.d.ts","sourceRoot":"","sources":["../src/draft-helpers.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,UAAU;aACd,GAAG;aACH,MAAM;aACN,IAAI;CACI,CAAC;AAoFX;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,iBAwCvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GAAG,MAAM,EAC7B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAyDzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GAAG,MAAM,EAC7B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAKf;AAsFD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,OAAO,UAAU,EAC7B,QAAQ,GAAE,MAAwB,GACjC,OAAO,CAAC,IAAI,CAAC,CAkBf;AA+CD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,MAAM,EAAI;IAEvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7B;IAEK,SAAS,CACb,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgC9B;YAEa,cAAc;YAmCd,WAAW;IAqDnB,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkBf;IAED,OAAO,CAAC,aAAa;CAMtB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW3E;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAOf;AA0ED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E;AAgED,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC,CAyDD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,aAAa,GAAE,MAAM,EAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmGjB"}