Files
Aislo/B07_DesignDetail/openwebcad/src/helpers/autosave.ts
T

117 lines
4.0 KiB
TypeScript

/**
* 자동 백업·복구 — 탭이 죽어도 마지막 편집을 잃지 않게 한다.
* 작업본(호스트 저장)과는 다른 층이다. 여기 쓰는 것은 복구 전용 사본이고,
* 되살리는 것은 사용자가 안내를 눌렀을 때뿐이다. 자동으로 도면을 갈아끼우지 않는다.
*/
import { toast } from 'react-toastify';
import { HtmlEvent } from '../App.types';
import type { Entity } from '../entities/Entity';
import {
getEntities,
isDrawingReadOnly,
resetUndoBaseline,
setActiveLayerId,
setEntities,
setLayers,
} from '../state';
import { exportEntitiesAndLayersToJsonString } from './import-export-handlers/export-entities-to-json';
import { getEntitiesAndLayersFromJsonString } from './import-export-handlers/import-entities-from-json';
const RECOVERY_KEY = 'OPEN_WEB_CAD__RECOVERY';
const AUTOSAVE_DEBOUNCE_MS = 5000;
interface RecoveryFile {
savedAt: number;
json: string;
}
let debounceTimer: ReturnType<typeof setTimeout> | undefined;
/** 마지막으로 백업한 객체 배열. setEntities가 매번 새 배열을 만들어 참조로 비교된다 */
let lastBackedUp: Entity[] | null = null;
/**
* 지금 백업이 어느 도면 것인가. 칸을 하나만 쓰면 도면을 넘겨볼 때마다 서로 덮어
* 마지막에 본 것만 남고, 되살리면 **지금 열린 다른 도면 위에 붙는다**
* (2026-09-01 지적). B07 임베드에서는 도면을 실을 때마다 이 값이 바뀐다.
*/
let recoveryScope: string | null = null;
/** 서버 도면을 싣는 동안에는 백업하지 않는다 — 적재가 사용자 백업을 덮어 쓴다. */
let suspended = false;
function recoveryKey(): string {
return recoveryScope ? `${RECOVERY_KEY}__${recoveryScope}` : RECOVERY_KEY;
}
/**
* 백업 칸을 이 도면 것으로 옮긴다 (B07 브리지가 도면을 실을 때 부른다).
* 옮기는 동안은 백업을 멈춘다 — 방금 실은 서버 도면이 사용자 백업을 덮지 않게.
*/
export function setRecoveryScope(drawingId: string | null): void {
recoveryScope = drawingId;
lastBackedUp = null;
suspended = true;
clearTimeout(debounceTimer);
// 적재가 부르는 상태 갱신이 모두 지나간 뒤 다시 연다.
setTimeout(() => {
suspended = false;
}, AUTOSAVE_DEBOUNCE_MS);
}
function readRecovery(): RecoveryFile | null {
try {
const raw = localStorage.getItem(recoveryKey());
return raw ? (JSON.parse(raw) as RecoveryFile) : null;
} catch {
return null;
}
}
async function writeBackup(): Promise<void> {
const entities = getEntities();
if (suspended || entities === lastBackedUp || entities.length === 0) return;
try {
const file: RecoveryFile = {
savedAt: Date.now(),
json: await exportEntitiesAndLayersToJsonString(),
};
localStorage.setItem(recoveryKey(), JSON.stringify(file));
lastBackedUp = entities;
} catch {
// 저장 공간이 없거나 막혀 있으면 조용히 넘어간다 — 편집을 막을 일은 아니다
}
}
export function clearRecovery(): void {
try {
localStorage.removeItem(recoveryKey());
} catch {
// 지우지 못해도 다음 백업이 덮어쓴다
}
}
export async function restoreRecovery(): Promise<void> {
if (isDrawingReadOnly()) {
toast.info('확정한 도면입니다. 되살리려면 [수정]을 먼저 누르세요.');
return;
}
const file = readRecovery();
if (!file) {
toast.info('복구할 백업이 없습니다.');
return;
}
const drawing = await getEntitiesAndLayersFromJsonString(file.json);
setEntities(drawing.entities, true);
setLayers(drawing.layers);
setActiveLayerId(drawing.layers[0].id);
resetUndoBaseline();
toast.success(`백업을 되살렸습니다 (${new Date(file.savedAt).toLocaleString()}).`);
}
/** 시작할 때 한 번 부른다. 시작 안내는 띄우지 않음 — 되살리기는 파일 명령으로. */
export function registerAutoSave(): void {
window.addEventListener(HtmlEvent.UPDATE_STATE, () => {
clearTimeout(debounceTimer);
debounceTimer = setTimeout(() => void writeBackup(), AUTOSAVE_DEBOUNCE_MS);
});
}