Download web/src/pulse/api.ts from loveaa/OneAlign: direct link, hf CLI and curl.
- Browser
- Download file 8.19 kB
-
https://huggingface.co/spaces/loveaa/OneAlign/resolve/main/web/src/pulse/api.ts
- Command line
-
hf download hf://spaces/loveaa/OneAlign/web/src/pulse/api.ts
-
curl -L -o api.ts https://huggingface.co/spaces/loveaa/OneAlign/resolve/main/web/src/pulse/api.ts
8.19 kB
| 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} | |