import { useCallback, useEffect, useRef, useState } from 'react'; import { api } from './api'; import { analysisSnapshotResult, reportSnapshotDifferences, reportSnapshotIdentity } from './analysisSnapshot'; type Row = Record; const object = (value: unknown): Row => value && typeof value === 'object' && !Array.isArray(value) ? value as Row : {}; export function canRecoverAnalysisVisuals(turn: Row): boolean { const result=analysisSnapshotResult(turn),plan=object(turn.plan),task=object(plan.task); const state=String(result.visualState||''); const status=String(turn.status||result.status||'').toUpperCase(); const planned=Array.isArray(task.queryPlan)&&task.queryPlan.some(raw=>{ const node=object(raw);return ['ranking','trend','defects'].includes(String(node.purpose))&&node.visualPreference!=='none'; }); const requested=task.trendRequired===true||task.visualPreference==='required'||Boolean(task.visualType)||planned; return plan.protocolVersion===1&&['metrics','analysis'].includes(String(task.kind)) &&['COMPLETED','PARTIAL'].includes(status)&&task.visualPreference!=='none'&&requested &&object(result.visualRecovery).complete!==true&&(state!=='ready'||status==='PARTIAL'); } /** A late chart recovery can replace only presentation belonging to this exact saved execution. */ export function useAnalysisVisualRecovery(source: Row,onUnauthorized:(error:unknown)=>boolean) { const plan=object(source.plan); const key=JSON.stringify([source.id||source.turnId,plan.attemptId,plan.executionId,plan.revision,reportSnapshotIdentity(source)]); const identity=useRef(key);identity.current=key; const generation=useRef(0),pending=useRef(false); const [recovered,setRecovered]=useState<{key:string;turn:Row}|null>(null); const [recovering,setRecovering]=useState(false),[error,setError]=useState(''); useEffect(()=>{ generation.current++;pending.current=false;setRecovered(null);setRecovering(false);setError(''); return()=>{generation.current++;pending.current=false;}; },[key]); const recover=useCallback(async()=>{ if(pending.current||!canRecoverAnalysisVisuals(source))return; const request=++generation.current,capturedKey=key,id=String(source.id||source.turnId||''); const current=()=>request===generation.current&&capturedKey===identity.current; pending.current=true;setRecovering(true);setError(''); try { const value=await api.recoverAnalysisVisuals(id); if(!current())return; const returnedPlan=object(value.plan); if(String(value.id||value.turnId||'')!==id||['attemptId','executionId','revision'].some(field=>returnedPlan[field]!==plan[field]) ||reportSnapshotDifferences(source,value).some(field=>field!=='visuals'))throw new Error('原分析已变化,请重新打开后再恢复图表。'); setRecovered({key:capturedKey,turn:value}); } catch(value) { if(current()&&!onUnauthorized(value))setError(value instanceof Error?value.message:'图表暂未恢复,原分析结果已保留。'); } finally { if(current()){pending.current=false;setRecovering(false);} } },[source,key,onUnauthorized]); const turn=recovered?.key===key?recovered.turn:source; return {turn,recover,recovering,error,available:canRecoverAnalysisVisuals(turn)}; }