File size: 8,193 Bytes
133b124 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 | import type {Binding, CapturePolicy, ContractResult, LocationAlerts, ObjectMemory, Plan, Setup} from '@/lib/grounded'
import type {Metrics} from '@/lib/metrics'
import {isCloud} from '@/lib/cloud-client'
export type Category='security'|'care'|'memory'|'routine'
export interface Device {id:string;clientId:string;name:string;model:string;online:boolean;viewRevision:number;state:Record<string,unknown>;capabilities:{live:boolean;frames:boolean;events:boolean;scheduledCapture?:boolean;actions:string[];nightVisionModes:{key:number;label:string}[]}}
export interface Watch {id:string;title:string;request:string;deviceId:string;viewRevision:number;state:'active'|'paused'|'replaced';observationStatus:string;sourceOnline:boolean;lastResult:string|null;lastConfirmedAt:string|null;binding:Binding;plan:Plan;category:Category;attentionLevel:number;memoryId?:string;intervalSeconds:number;capturePolicy?:CapturePolicy;locationAlerts?:LocationAlerts;observations:{capturedAt:string;text?:string;verdict?:string;evidence?:string;latencyMs?:number;engineMs?:number;mediaTime?:number;pending?:boolean;unknown?:boolean;outcome?:string}[];needsReconfirmation:boolean}
export interface StateEvent {id:string;watchId:string;title:string;category:Category;attentionLevel:number;handlingState:string;revision:number;occurredAt:string;createdAt:string;visualRecoveryAt:string|null;userCompletedAt:string|null;closedAt:string|null;actions:{action:string;at:string}[]}
export interface Command {id:string;deviceId:string;action:string;params:Record<string,unknown>;status:string;revision:number;expiresAt:string;executionToken?:string;executionDeadline?:string}
export interface AppMetrics {model:Metrics;app:{devices:number;onlineDevices:number;hardwareEvents24h:number;uniqueFrames24h:number;observationRuns24h:number;eventsRetained:number;sdkSuccessRate:number|null;verificationRate:number|null;commandStatuses:Record<string,number>}}
export interface Snapshot {watches:Watch[];events:StateEvent[];memories:ObjectMemory[];devices:Device[];commands:Command[];metrics:AppMetrics|null}
export interface RequestTrace {id:string;method:string;route:string;ms:number;status:number;at:string;code?:string}
export const requestTraces:RequestTrace[]=[]
export class ApiError extends Error {code:string;status:number;details:unknown;constructor(message:string,code:string,status:number,details?:unknown){super(message);this.code=code;this.status=status;this.details=details}}
let tokenPromise:Promise<string>|undefined,clientPromise:Promise<string>|undefined
export async function workspaceToken(){
if(!tokenPromise)tokenPromise=(async()=>{
const key=isCloud()?'home-pulse-cloud-workspace':'home-pulse-app-workspace'
const saved=localStorage.getItem(key);if(saved&&/^[a-f0-9]{64}$/.test(saved))return saved
const r=await fetch('/api/v1/sessions',{method:'POST',headers:{'Content-Type':'application/json'},body:'{}'})
const result=await r.json();if(!r.ok)throw new ApiError(result.error?.message||'空间连接未完成',result.error?.code||'CONNECTION_FAILED',r.status)
localStorage.setItem(key,result.data.token);return result.data.token as string
})().catch(e=>{tokenPromise=undefined;throw e})
return tokenPromise
}
export async function api<T>(route:string,body?:unknown,key?:string):Promise<T>{
const token=await workspaceToken(),method=body===undefined?'GET':'POST',operationKey=key||crypto.randomUUID(),encoded=body===undefined?undefined:JSON.stringify(body),started=performance.now()
let status=0,code:string|undefined
try{
let response:Response|undefined
// A transport retry repeats the identical operation; model and validation errors are surfaced.
for(let attempt=0;attempt<2;attempt++){
try{response=await fetch('/api/v1'+route,{method,headers:{'Content-Type':'application/json','X-Home-Pulse-Workspace':token,...(body===undefined?{}:{'Idempotency-Key':operationKey})},body:encoded,signal:AbortSignal.timeout(240000)});break}
catch(e){if(attempt===1)throw e}
}
status=response!.status
const result=await response!.json()
if(!response!.ok){code=result.error?.code;throw new ApiError(result.error?.message||'这次连接未完成',code||'CONNECTION_FAILED',status,result.error?.details)}
return result.data as T
}finally{
requestTraces.unshift({id:crypto.randomUUID(),method,route,ms:Math.round(performance.now()-started),status,at:new Date().toISOString(),code});requestTraces.splice(80)
window.dispatchEvent(new Event('pulse-request'))
}
}
export async function appClient(){
if(!clientPromise)clientPromise=(async()=>{
const token=await workspaceToken(),key='home-pulse-app-client:'+token.slice(0,12),saved=localStorage.getItem(key)
if(saved){try{await api('/clients/'+saved+'/heartbeat',{foreground:true,sdkReady:false});return saved}catch(e){if(!(e instanceof ApiError&&e.status===404))throw e}}
const c=await api<{id:string}>('/clients',{name:'Home Pulse 网页接入端',platform:'web',appVersion:'1.2.0'})
localStorage.setItem(key,c.id);return c.id
})().catch(e=>{clientPromise=undefined;throw e})
return clientPromise
}
export const emptySnapshot:Snapshot={watches:[],events:[],memories:[],devices:[],commands:[],metrics:null}
export async function readSnapshot():Promise<Snapshot>{
const [watches,events,memories,devices,commands,metrics]=await Promise.all([api<Watch[]>('/watches'),api<StateEvent[]>('/events'),api<ObjectMemory[]>('/memories'),api<Device[]>('/devices'),api<Command[]>('/commands'),api<AppMetrics>('/metrics')])
return {watches,events,memories,devices,commands,metrics}
}
export const categoryMeta:Record<Category,{label:string;pattern:string;color:string}>={security:{label:'安全',pattern:'安全警报',color:'coral'},care:{label:'照护',pattern:'状态关注',color:'mint'},memory:{label:'记忆',pattern:'生活回忆',color:'lilac'},routine:{label:'日常',pattern:'行动提醒',color:'peach'}}
export const levelNames=['后台记录','轻量展示','主动提醒','优先关注','立即处理']
export const statusNames:Record<string,string>={observing:'观察中',recently_checked:'已更新状态',waiting_event:'等待下次设备事件',ready_for_check:'可以按需检查',waiting_schedule:'等待下次定时检查',awaiting_evidence:'等待新画面',needs_reconfirmation:'需要重新确认',connection_interrupted:'设备接入已中断',paused:'已暂停',replaced:'已更新守护方式'}
export const policyName=(policy?:CapturePolicy)=>policy?.mode==='scheduled'?`每 ${Math.round(policy.intervalSeconds/60)} 分钟检查`:policy?.mode==='manual'?'想看时检查':'设备有事件时检查'
export const handlingNames:Record<string,string>={unread:'待查看',read:'已查看',handling:'正在处理',user_completed:'用户已处理',dismissed:'已结束'}
export const commandNames:Record<string,string>={awaiting_confirmation:'等待你的确认',queued:'已确认,等待执行',executing:'正在执行',awaiting_verification:'操作已执行,正在确认状态',verified:'设备状态已确认',verification_failed:'设备状态与设置不一致',result_unknown:'操作结果待确认',failed:'本次操作未完成',cancelled:'已取消',expired:'这次操作已过期'}
export const time=(value?:string|null)=>value?new Intl.DateTimeFormat('zh-CN',{timeZone:'Asia/Shanghai',hour:'2-digit',minute:'2-digit',hourCycle:'h23'}).format(new Date(value)):'—'
export const dateTime=(value?:string|null)=>value?new Intl.DateTimeFormat('zh-CN',{timeZone:'Asia/Shanghai',month:'numeric',day:'numeric',hour:'2-digit',minute:'2-digit',hourCycle:'h23'}).format(new Date(value)):'尚未确认'
export const count=(value?:number|null)=>value==null?'—':value.toLocaleString('zh-CN')
export const latency=(value?:number|null)=>value==null?'—':Math.round(value).toLocaleString('zh-CN')+' ms'
export function download(name:string,value:unknown){const url=URL.createObjectURL(new Blob([JSON.stringify(value,null,2)],{type:'application/json'})),link=document.createElement('a');link.href=url;link.download=name;link.click();setTimeout(()=>URL.revokeObjectURL(url),1000)}
export type {Binding,ContractResult,ObjectMemory,Plan,Setup}
|