Files
hyperframes/packages/studio/src/hooks/useStudioExternalFileChanges.ts
T
Miguel Ángel ebdd1893c4 fix(studio): reconcile external edits before reload (#2993)
* fix(studio): reconcile external edits before reload

* fix(ci): retry transient workspace installs

Make external reload retry behavior honest and isolate reload listeners.

Remove the dead SDK timestamp parameter.
2026-08-04 23:13:19 +00:00

82 lines
2.9 KiB
TypeScript

import { useCallback, type MutableRefObject } from "react";
import {
deleteExternalConflictSnapshot,
loadExternalConflictSnapshot,
persistExternalConflictSnapshot,
persistExternalFailureSnapshot,
} from "../utils/externalConflictStorage";
import { notifyExternalFileReload } from "./externalFileReloadBus";
import { useExternalFileChangeCoordinator } from "./useExternalFileChangeCoordinator";
import type { useFileManager } from "./useFileManager";
import type { usePreviewPersistence } from "./usePreviewPersistence";
type FileManager = Pick<
ReturnType<typeof useFileManager>,
| "editingFile"
| "flushPendingSourceSave"
| "discardPendingSourceSave"
| "getPendingSourceCandidate"
| "overwriteExternalConflict"
| "readProjectFile"
| "updateEditingFileContent"
>;
type PreviewPersistence = Pick<
ReturnType<typeof usePreviewPersistence>,
"drainPendingDomEditSaves" | "resetDomEditSaveQueueBreaker"
>;
interface UseStudioExternalFileChangesOptions {
projectId: string | null;
activeCompPath: string | null;
masterCompPath: string | null;
fileManager: FileManager;
previewPersistence: PreviewPersistence;
pendingTimelineEditPathRef: MutableRefObject<Set<string>>;
reloadPreview: () => void;
}
/** Connects the app's save queues, recovery storage, and reload surfaces to one owner. */
export function useStudioExternalFileChanges({
projectId,
activeCompPath,
masterCompPath,
fileManager,
previewPersistence,
pendingTimelineEditPathRef,
reloadPreview,
}: UseStudioExternalFileChangesOptions) {
const { flushPendingSourceSave, discardPendingSourceSave } = fileManager;
const { drainPendingDomEditSaves, resetDomEditSaveQueueBreaker } = previewPersistence;
const drainPendingChanges = useCallback(async () => {
const source = await flushPendingSourceSave();
if (source.status !== "clean") return source;
return drainPendingDomEditSaves();
}, [drainPendingDomEditSaves, flushPendingSourceSave]);
const discardPendingChanges = useCallback(() => {
discardPendingSourceSave();
resetDomEditSaveQueueBreaker();
}, [discardPendingSourceSave, resetDomEditSaveQueueBreaker]);
return useExternalFileChangeCoordinator({
projectId,
activeCompPath,
recoveryFilePath: fileManager.editingFile?.path ?? activeCompPath ?? masterCompPath,
pendingTimelineEditPathRef,
drainPendingChanges,
getPendingCandidate: fileManager.getPendingSourceCandidate,
discardPendingChanges,
reloadPreview,
reloadSdkSession: notifyExternalFileReload,
persistConflictSnapshot: persistExternalConflictSnapshot,
persistFailureSnapshot: persistExternalFailureSnapshot,
loadConflictSnapshot: loadExternalConflictSnapshot,
deleteConflictSnapshot: deleteExternalConflictSnapshot,
overwriteConflict: fileManager.overwriteExternalConflict,
readProjectFile: fileManager.readProjectFile,
onUseExternalFile: fileManager.updateEditingFileContent,
resetSaveQueues: resetDomEditSaveQueueBreaker,
});
}