/** * 应用的接口(/api/apps、/api/ledger),挂在 api.apps 上。形状见 typesApp.ts(应用平台的接口约定)。 * * 请求函数从 ./http 导入,不要从 ./client 导入(循环导入,见 http.ts 开头)。 * 入口提交校验失败回 422,ApiError 的 body 里带 {errors: FormError[]}。 */ import type { AppBindings, AppDetail, AppGrant, AppSpec, AppSummary, AppVersionRow, ComponentCatalog, Disposition, InstanceRow, LintIssue, PublishResult, ViewModel, } from '../typesApp' import { get, patch, post, put, qs, type RequestOptions } from './http' const at = (id: string) => `/apps/${encodeURIComponent(id)}` export const apps = { catalog: (opts?: RequestOptions) => get('/apps/catalog', opts), list: (opts?: RequestOptions) => get<{ items: AppSummary[] }>('/apps', opts), get: (id: string, opts?: RequestOptions) => get(at(id), opts), create: (body: { name: string; description?: string; spec?: AppSpec }) => post('/apps', body), /** 从工作流版本确定性派生一份应用草稿(不落库),编辑器拿去预览 / 新建 */ derive: (body: { workflow_id: string; version: number; name?: string }) => post<{ spec: AppSpec }>('/apps/derive', body), /** 改草稿:spec、岗位绑定、名称等,只带改了的字段 */ update: (id: string, body: { name?: string; description?: string; icon?: string; draft?: AppSpec; draft_bindings?: AppBindings }) => patch(at(id), body), archive: (id: string) => post(`${at(id)}/archive`), lint: (id: string) => post<{ issues: LintIssue[]; level: string | null }>(`${at(id)}/lint`), publish: (id: string, body: { note?: string; dispositions?: Record }) => post(`${at(id)}/publish`, body), versions: (id: string) => get<{ items: AppVersionRow[] }>(`${at(id)}/versions`), version: (id: string, v: number) => get(`${at(id)}/versions/${v}`), grants: (id: string) => get<{ items: AppGrant[] }>(`${at(id)}/grants`), setGrants: (id: string, items: AppGrant[]) => put<{ items: AppGrant[] }>(`${at(id)}/grants`, { items }), /** 页面解析:服务端解析好的视图模型(不可见的组件不下发,遮罩值不出服务端) */ page: (id: string, page: string, params?: { instance?: string; params?: Record }, opts?: RequestOptions) => get(`${at(id)}/pages/${encodeURIComponent(page)}${qs({ instance: params?.instance, params: params?.params ? JSON.stringify(params.params) : undefined, })}`, opts), /** 发起一个实例 */ start: (id: string, entry: string, values: Record) => post<{ run_id: string; title: string }>(`${at(id)}/entries/${encodeURIComponent(entry)}`, { values }), instances: (id: string, params?: { who?: 'mine' | 'all'; entry?: string; status?: string; limit?: number }) => get<{ items: InstanceRow[] }>(`${at(id)}/instances${qs(params)}`), instance: (id: string, runId: string) => get(`${at(id)}/instances/${encodeURIComponent(runId)}`), /** 按需视图:发起一次运行(或命中缓存) */ refreshView: (id: string, view: string, params?: Record) => post<{ run_id: string; cached: boolean }>(`${at(id)}/views/${encodeURIComponent(view)}/refresh`, { params: params ?? {} }), } export const ledger = { /** 一个工作流版本被哪些应用钉住、生效记录数、正式运行数 */ version: (workflowId: string, version: number) => get<{ apps: { app_id: string; name: string; app_version: number }[]; effects: number; formal_runs: number }>( `/ledger/workflow-versions/${encodeURIComponent(workflowId)}/${version}`), }