overleaf-codex 0.1.0-rc.1

package/dist/sync/apply.js

@@ -0,0 +1,92 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, win32 } from "node:path";
+import { createOlcxError } from "../errors.js";
+import { normalizeSyncPath } from "./ignore.js";
+export async function applySyncPlan(input) {
+    if (input.plan.conflicts.length > 0 || input.plan.operations.some((operation) => operation.type === "conflict")) {
+        throw createOlcxError({
+            code: "SYNC_CONFLICT",
+            message: "Sync plan contains conflicts.",
+            hint: "Review conflicts, then run olcx sync --dry-run.",
+        });
+    }
+    if (input.plan.operations.some((operation) => operation.type === "deleteLocal" || operation.type === "deleteRemote")) {
+        throw createOlcxError({
+            code: "SYNC_UNSAFE_OPERATION",
+            message: "Sync plan contains delete operations that are not applied automatically.",
+            hint: "Confirm deletions manually before running olcx sync again.",
+        });
+    }
+    const result = {
+        uploaded: new Map(),
+        downloaded: [],
+    };
+    if (input.plan.dryRun) {
+        return result;
+    }
+    for (const operation of input.plan.operations) {
+        if (operation.type === "upload") {
+            const uploaded = await applyUpload(input, operation);
+            result.uploaded.set(uploaded.path, uploaded);
+            continue;
+        }
+        if (operation.type === "download") {
+            const downloadedPath = await applyDownload(input, operation);
+            result.downloaded.push(downloadedPath);
+        }
+    }
+    return result;
+}
+async function applyUpload(input, operation) {
+    const path = requireSafeSyncPath(operation.path);
+    const bytes = await readFile(toAbsolutePath(input.projectRoot, path));
+    const uploaded = await input.backend.uploadFile({
+        projectId: input.projectId,
+        auth: input.auth,
+        path,
+        bytes,
+    });
+    return {
+        path,
+        exists: true,
+        contentHash: uploaded.contentHash ?? operation.local?.contentHash,
+        size: uploaded.size ?? bytes.byteLength,
+        modifiedAt: uploaded.modifiedAt,
+        remoteId: uploaded.remoteId,
+        revision: uploaded.revision,
+        binary: uploaded.binary,
+    };
+}
+async function applyDownload(input, operation) {
+    const path = requireSafeSyncPath(operation.path);
+    const bytes = await input.backend.downloadFile({
+        projectId: input.projectId,
+        auth: input.auth,
+        path,
+        remoteId: operation.remote?.remoteId,
+    });
+    const absolutePath = toAbsolutePath(input.projectRoot, path);
+    await mkdir(dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, bytes);
+    return path;
+}
+function requireSafeSyncPath(path) {
+    const normalized = normalizeSyncPath(path);
+    const segments = normalized.split("/").filter(Boolean);
+    if (normalized.length === 0 ||
+        normalized.startsWith("/") ||
+        win32.isAbsolute(path) ||
+        segments.includes("..")) {
+        throw createOlcxError({
+            code: "SYNC_UNSAFE_OPERATION",
+            message: "Sync operation contains an unsafe path.",
+            hint: "Resolve the unsafe path manually, then run olcx sync --dry-run.",
+            details: { path: normalized },
+        });
+    }
+    return normalized;
+}
+function toAbsolutePath(projectRoot, path) {
+    return join(projectRoot, ...path.split("/"));
+}
+//# sourceMappingURL=apply.js.map

package/dist/sync/apply.js.map

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

package/dist/sync/conflicts.d.ts

@@ -0,0 +1,7 @@
+import { type ConflictReport, type SyncConflict } from "./types.js";
+export declare function createConflictReport(input: {
+    generatedAt: string;
+    conflicts: SyncConflict[];
+    watchPaused: boolean;
+}): ConflictReport;
+export declare function formatConflictReport(report: ConflictReport): string;

package/dist/sync/conflicts.js

@@ -0,0 +1,59 @@
+import { redactSensitive } from "../cli-behavior.js";
+import { CONFLICT_REPORT_PATH, SYNC_STATE_PATH, } from "./types.js";
+const REPORT_MANUAL_STEPS = [
+    "Open each conflict path locally and in Overleaf.",
+    "Choose local, remote, or a manual merge.",
+    "Run olcx sync --dry-run.",
+    "Run olcx sync after the dry run is clean.",
+    "Restart olcx watch if you use the watcher.",
+];
+export function createConflictReport(input) {
+    return {
+        schemaVersion: 1,
+        generatedAt: input.generatedAt,
+        reportPath: CONFLICT_REPORT_PATH,
+        syncStatePath: SYNC_STATE_PATH,
+        watch: {
+            paused: input.watchPaused,
+            reason: "sync-conflict",
+            resumeCommand: "olcx watch",
+        },
+        conflicts: input.conflicts.map(toReportEntry),
+        manualSteps: REPORT_MANUAL_STEPS,
+    };
+}
+export function formatConflictReport(report) {
+    return redactSensitive(JSON.stringify(report, null, 2));
+}
+function toReportEntry(conflict) {
+    return {
+        path: conflict.path,
+        reason: conflict.reason,
+        local: conflict.local ? toDigest(conflict.local) : undefined,
+        remote: conflict.remote ? toDigest(conflict.remote) : undefined,
+        base: conflict.base ? toBaseDigest(conflict.base) : undefined,
+        suggestedCommands: ["olcx sync --dry-run", "olcx sync"],
+        manualSteps: [
+            `Review ${conflict.path} locally and in Overleaf.`,
+            conflict.recommendation,
+            "Run olcx sync --dry-run before applying changes.",
+        ],
+    };
+}
+function toDigest(input) {
+    return {
+        contentHash: input.contentHash,
+        size: input.size,
+        modifiedAt: input.modifiedAt,
+        remoteId: input.remoteId,
+        revision: input.revision,
+    };
+}
+function toBaseDigest(base) {
+    return {
+        contentHash: base.contentHash,
+        size: base.size,
+        syncedAt: base.syncedAt,
+    };
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/sync/conflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.js","sourceRoot":"","sources":["../../src/sync/conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,eAAe,GAMhB,MAAM,YAAY,CAAC;AAEpB,MAAM,mBAAmB,GAAG;IAC1B,kDAAkD;IAClD,0CAA0C;IAC1C,0BAA0B;IAC1B,2CAA2C;IAC3C,4CAA4C;CAC7C,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,KAIpC;IACC,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,oBAAoB;QAChC,aAAa,EAAE,eAAe;QAC9B,KAAK,EAAE;YACL,MAAM,EAAE,KAAK,CAAC,WAAW;YACzB,MAAM,EAAE,eAAe;YACvB,aAAa,EAAE,YAAY;SAC5B;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC;QAC7C,WAAW,EAAE,mBAAmB;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACzD,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,aAAa,CAAC,QAAsB;IAC3C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5D,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC/D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,iBAAiB,EAAE,CAAC,qBAAqB,EAAE,WAAW,CAAC;QACvD,WAAW,EAAE;YACX,UAAU,QAAQ,CAAC,IAAI,2BAA2B;YAClD,QAAQ,CAAC,cAAc;YACvB,kDAAkD;SACnD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAMjB;IACC,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAoB;IACxC,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC"}

package/dist/sync/ignore.d.ts

@@ -0,0 +1,5 @@
+export declare const BUILT_IN_IGNORE_PATTERNS: readonly [".git/", "node_modules/", ".olcx/auth.local.json", ".olcx/*.local.json", ".olcx/*.secret.json", ".olcx/state/", "build/overleaf/", "*.aux", "*.bbl", "*.bcf", "*.blg", "*.fdb_latexmk", "*.fls", "*.log", "*.out", "*.run.xml", "*.synctex.gz", "*.toc"];
+export declare function normalizeSyncPath(path: string): string;
+export declare function createIgnoreMatcher(userPatterns?: readonly string[]): {
+    isIgnored(path: string): boolean;
+};

package/dist/sync/ignore.js

@@ -0,0 +1,74 @@
+export const BUILT_IN_IGNORE_PATTERNS = [
+    ".git/",
+    "node_modules/",
+    ".olcx/auth.local.json",
+    ".olcx/*.local.json",
+    ".olcx/*.secret.json",
+    ".olcx/state/",
+    "build/overleaf/",
+    "*.aux",
+    "*.bbl",
+    "*.bcf",
+    "*.blg",
+    "*.fdb_latexmk",
+    "*.fls",
+    "*.log",
+    "*.out",
+    "*.run.xml",
+    "*.synctex.gz",
+    "*.toc",
+];
+export function normalizeSyncPath(path) {
+    return path.replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/\/+/g, "/").replace(/\/+$/, "");
+}
+export function createIgnoreMatcher(userPatterns = []) {
+    const patterns = [...BUILT_IN_IGNORE_PATTERNS, ...userPatterns];
+    return {
+        isIgnored(path) {
+            const normalized = normalizeSyncPath(path);
+            if (isUnsafePath(normalized)) {
+                return true;
+            }
+            return patterns.some((pattern) => matchesPattern(normalized, pattern));
+        },
+    };
+}
+function isUnsafePath(path) {
+    return path.startsWith("/") || path === ".." || path.startsWith("../") || path.includes("/../");
+}
+function matchesPattern(path, pattern) {
+    if (!pattern || pattern.startsWith("!")) {
+        return false;
+    }
+    const normalizedPattern = normalizeSyncPath(pattern);
+    if (pattern.endsWith("/") || normalizedPattern.endsWith("/")) {
+        return matchesDirectory(path, normalizedPattern);
+    }
+    if (normalizedPattern.endsWith("/**")) {
+        return matchesDirectory(path, normalizedPattern.slice(0, -3));
+    }
+    if (normalizedPattern.includes("*")) {
+        return matchesStarPattern(path, normalizedPattern);
+    }
+    return path === normalizedPattern;
+}
+function matchesDirectory(path, directory) {
+    const normalizedDirectory = normalizeSyncPath(directory);
+    return path === normalizedDirectory || path.startsWith(`${normalizedDirectory}/`);
+}
+function matchesStarPattern(path, pattern) {
+    const starIndex = pattern.indexOf("*");
+    const prefix = pattern.slice(0, starIndex);
+    const suffix = pattern.slice(starIndex + 1);
+    if (prefix === "" && !suffix.includes("/")) {
+        return basename(path).endsWith(suffix);
+    }
+    if (!path.startsWith(prefix) || !path.endsWith(suffix)) {
+        return false;
+    }
+    return !path.slice(prefix.length, path.length - suffix.length).includes("/");
+}
+function basename(path) {
+    return path.split("/").at(-1) ?? path;
+}
+//# sourceMappingURL=ignore.js.map

package/dist/sync/ignore.js.map

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

package/dist/sync/plan.d.ts

@@ -0,0 +1,3 @@
+import type { SyncPlan, SyncPlanInput } from "./types.js";
+export declare function sha256Hex(content: string | Uint8Array): string;
+export declare function createSyncPlan(input: SyncPlanInput): SyncPlan;

package/dist/sync/plan.js

@@ -0,0 +1,197 @@
+import { createHash } from "node:crypto";
+import { createIgnoreMatcher, normalizeSyncPath } from "./ignore.js";
+const RECOMMENDATIONS = {
+    "both-modified": "Review both versions, merge manually, then run olcx sync --dry-run.",
+    "local-modified-remote-deleted": "Decide whether to keep the local file or accept the remote deletion, then run olcx sync --dry-run.",
+    "remote-modified-local-deleted": "Decide whether to restore the local file or delete the remote version, then run olcx sync --dry-run.",
+    "unsafe-delete": "Deletion is not applied automatically in v1. Confirm manually, then run olcx sync --dry-run.",
+    unsupported: "Resolve this path manually, then run olcx sync --dry-run.",
+};
+export function sha256Hex(content) {
+    const bytes = typeof content === "string" ? Buffer.from(content) : content;
+    return createHash("sha256").update(bytes).digest("hex");
+}
+export function createSyncPlan(input) {
+    const ignoreMatcher = createIgnoreMatcher(input.userIgnorePatterns);
+    const stateByPath = createStateMap(input.state.files);
+    const localByPath = createLocalMap(input.localFiles);
+    const remoteByPath = createRemoteMap(input.remoteFiles);
+    const paths = sortedUnion(stateByPath.keys(), localByPath.keys(), remoteByPath.keys());
+    const operations = [];
+    const conflicts = [];
+    for (const path of paths) {
+        const base = stateByPath.get(path);
+        const local = localByPath.get(path);
+        const remote = remoteByPath.get(path);
+        const localIgnored = local?.ignored === true;
+        if (localIgnored || ignoreMatcher.isIgnored(path)) {
+            operations.push({
+                type: "ignored",
+                path,
+                reason: "ignored by sync rules",
+                local,
+                remote,
+                base,
+            });
+            continue;
+        }
+        const operation = planPath({
+            path,
+            base,
+            local,
+            remote,
+            allowDeletes: input.allowDeletes === true,
+        });
+        operations.push(operation);
+        if (operation.type === "conflict" && operation.conflictReason) {
+            conflicts.push({
+                path,
+                reason: operation.conflictReason,
+                local,
+                remote,
+                base,
+                recommendation: RECOMMENDATIONS[operation.conflictReason],
+            });
+        }
+    }
+    return {
+        projectId: input.projectId,
+        createdAt: input.createdAt,
+        dryRun: input.dryRun,
+        operations,
+        conflicts,
+        summary: summarizeOperations(operations),
+    };
+}
+function createStateMap(files) {
+    return new Map(Object.entries(files).map(([path, entry]) => {
+        const normalizedPath = normalizeSyncPath(entry.path || path);
+        return [normalizedPath, { ...entry, path: normalizedPath }];
+    }));
+}
+function createLocalMap(files) {
+    return new Map(files.map((file) => {
+        const path = normalizeSyncPath(file.path);
+        return [path, { ...file, path }];
+    }));
+}
+function createRemoteMap(files) {
+    return new Map(files.map((file) => {
+        const path = normalizeSyncPath(file.path);
+        return [path, { ...file, path }];
+    }));
+}
+function sortedUnion(...keySets) {
+    return [...new Set(keySets.flatMap((keys) => [...keys]))].sort();
+}
+function planPath(input) {
+    const { path, base, local, remote, allowDeletes } = input;
+    const localPresent = isPresentLocal(local);
+    const remotePresent = isPresentRemote(remote);
+    if ((localPresent && !local?.contentHash) || (remotePresent && !remote?.contentHash)) {
+        return conflictOperation(path, "unsupported", "present file is missing a content hash", local, remote, base);
+    }
+    if (!base) {
+        if (localPresent && !remotePresent) {
+            return operation("upload", path, "local-only file", local, remote);
+        }
+        if (!localPresent && remotePresent) {
+            return operation("download", path, "remote-only file", local, remote);
+        }
+        if (localPresent && remotePresent && local.contentHash === remote.contentHash) {
+            return operation("unchanged", path, "local and remote hashes match", local, remote);
+        }
+        return conflictOperation(path, "both-modified", "local and remote differ without a baseline", local, remote);
+    }
+    if (!localPresent && !remotePresent) {
+        return operation("unchanged", path, "both-deleted", local, remote, base);
+    }
+    if (localPresent && remotePresent) {
+        return planPresentOnBothSides(path, base, local, remote);
+    }
+    if (localPresent) {
+        return planRemoteAbsent(path, base, local, remote, allowDeletes);
+    }
+    if (remotePresent) {
+        return planLocalAbsent(path, base, local, remote, allowDeletes);
+    }
+    return conflictOperation(path, "unsupported", "path state could not be classified", local, remote, base);
+}
+function planPresentOnBothSides(path, base, local, remote) {
+    const localHash = local.contentHash;
+    const remoteHash = remote.contentHash;
+    const baseHash = base.contentHash;
+    if (localHash === baseHash && remoteHash === baseHash) {
+        return operation("unchanged", path, "matches baseline", local, remote, base);
+    }
+    if (localHash !== baseHash && remoteHash === baseHash) {
+        return operation("upload", path, "local changed from baseline", local, remote, base);
+    }
+    if (localHash === baseHash && remoteHash !== baseHash) {
+        return operation("download", path, "remote changed from baseline", local, remote, base);
+    }
+    if (localHash === remoteHash) {
+        return operation("unchanged", path, "local and remote already share the same changed hash", local, remote, base);
+    }
+    return conflictOperation(path, "both-modified", "local and remote both changed from baseline", local, remote, base);
+}
+function planRemoteAbsent(path, base, local, remote, allowDeletes) {
+    if (local.contentHash !== base.contentHash) {
+        return conflictOperation(path, "local-modified-remote-deleted", "remote deleted while local changed", local, remote, base);
+    }
+    if (allowDeletes) {
+        return operation("deleteLocal", path, "remote deletion explicitly allowed", local, remote, base);
+    }
+    return conflictOperation(path, "unsafe-delete", "remote deletion requires explicit confirmation", local, remote, base);
+}
+function planLocalAbsent(path, base, local, remote, allowDeletes) {
+    if (remote.contentHash !== base.contentHash) {
+        return conflictOperation(path, "remote-modified-local-deleted", "local deleted while remote changed", local, remote, base);
+    }
+    if (allowDeletes) {
+        return operation("deleteRemote", path, "local deletion explicitly allowed", local, remote, base);
+    }
+    return conflictOperation(path, "unsafe-delete", "local deletion requires explicit confirmation", local, remote, base);
+}
+function operation(type, path, reason, local, remote, base) {
+    return {
+        type,
+        path,
+        reason,
+        local,
+        remote,
+        base,
+    };
+}
+function conflictOperation(path, conflictReason, reason, local, remote, base) {
+    return {
+        type: "conflict",
+        path,
+        reason,
+        local,
+        remote,
+        base,
+        conflictReason,
+    };
+}
+function isPresentLocal(snapshot) {
+    return snapshot?.exists === true;
+}
+function isPresentRemote(snapshot) {
+    return snapshot?.exists === true;
+}
+function summarizeOperations(operations) {
+    return operations.reduce((summary, operation) => ({
+        ...summary,
+        [operation.type]: summary[operation.type] + 1,
+    }), {
+        upload: 0,
+        download: 0,
+        deleteLocal: 0,
+        deleteRemote: 0,
+        unchanged: 0,
+        conflict: 0,
+        ignored: 0,
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/sync/plan.js.map

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

package/dist/sync/snapshot.d.ts

@@ -0,0 +1,13 @@
+import { type ProjectAuth } from "../auth/types.js";
+import { type OverleafBackend } from "../backend/types.js";
+import { type LocalFileSnapshot, type RemoteFileSnapshot } from "./types.js";
+export declare function createLocalSnapshot(input: {
+    projectRoot: string;
+    userIgnorePatterns?: string[];
+}): Promise<LocalFileSnapshot[]>;
+export declare function createRemoteSnapshot(_input: {
+    backend: OverleafBackend;
+    projectId: string;
+    auth: ProjectAuth;
+    userIgnorePatterns?: string[];
+}): Promise<RemoteFileSnapshot[]>;

package/dist/sync/snapshot.js

@@ -0,0 +1,82 @@
+import { lstat, readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { createIgnoreMatcher, normalizeSyncPath } from "./ignore.js";
+import { sha256Hex } from "./plan.js";
+export async function createLocalSnapshot(input) {
+    const ignoreMatcher = createIgnoreMatcher(input.userIgnorePatterns);
+    const files = [];
+    async function visit(relativeDirectory) {
+        const absoluteDirectory = relativeDirectory
+            ? join(input.projectRoot, ...relativeDirectory.split("/"))
+            : input.projectRoot;
+        const entries = await readdir(absoluteDirectory, { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = normalizeSyncPath(relativeDirectory ? `${relativeDirectory}/${entry.name}` : entry.name);
+            if (ignoreMatcher.isIgnored(relativePath)) {
+                continue;
+            }
+            const absolutePath = join(input.projectRoot, ...relativePath.split("/"));
+            const linkStats = await lstat(absolutePath);
+            if (linkStats.isSymbolicLink()) {
+                continue;
+            }
+            if (linkStats.isDirectory()) {
+                await visit(relativePath);
+                continue;
+            }
+            if (!linkStats.isFile()) {
+                continue;
+            }
+            const bytes = await readFile(absolutePath);
+            const fileStats = await stat(absolutePath);
+            files.push({
+                path: relativePath,
+                exists: true,
+                contentHash: sha256Hex(bytes),
+                size: bytes.byteLength,
+                modifiedAt: fileStats.mtime.toISOString(),
+            });
+        }
+    }
+    await visit("");
+    return files.sort((a, b) => a.path.localeCompare(b.path));
+}
+export async function createRemoteSnapshot(_input) {
+    const input = _input;
+    const ignoreMatcher = createIgnoreMatcher(input.userIgnorePatterns);
+    const files = await input.backend.listFiles({ projectId: input.projectId, auth: input.auth });
+    const snapshots = [];
+    for (const file of files) {
+        const path = normalizeSyncPath(file.path);
+        if (file.kind !== "file" || ignoreMatcher.isIgnored(path)) {
+            continue;
+        }
+        let contentHash = isValidSha256(file.contentHash) ? file.contentHash : undefined;
+        let size = file.size;
+        if (!contentHash) {
+            const bytes = await input.backend.downloadFile({
+                projectId: input.projectId,
+                auth: input.auth,
+                path,
+                remoteId: file.remoteId,
+            });
+            contentHash = sha256Hex(bytes);
+            size = size ?? bytes.byteLength;
+        }
+        snapshots.push({
+            path,
+            exists: true,
+            contentHash,
+            size,
+            modifiedAt: file.modifiedAt,
+            remoteId: file.remoteId,
+            revision: file.revision,
+            binary: file.binary,
+        });
+    }
+    return snapshots.sort((a, b) => a.path.localeCompare(b.path));
+}
+function isValidSha256(value) {
+    return typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/sync/snapshot.js.map

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

package/dist/sync/state.d.ts

@@ -0,0 +1,16 @@
+import { type ConflictReport, type RemoteFileSnapshot, type SyncPlan, type SyncStateFile } from "./types.js";
+export declare function createEmptySyncState(updatedAt: string): SyncStateFile;
+export declare function getSyncStatePath(projectRoot: string): string;
+export declare function getConflictReportPath(projectRoot: string): string;
+export declare function readSyncState(projectRoot: string, options?: {
+    now?: () => Date;
+}): Promise<SyncStateFile>;
+export declare function writeSyncState(projectRoot: string, state: SyncStateFile): Promise<void>;
+export declare function writeConflictReport(projectRoot: string, report: ConflictReport): Promise<void>;
+export declare function clearConflictReport(projectRoot: string): Promise<void>;
+export declare function buildNextSyncState(input: {
+    previous: SyncStateFile;
+    plan: SyncPlan;
+    appliedAt: string;
+    uploadResults?: Map<string, RemoteFileSnapshot>;
+}): SyncStateFile;