import type { ProductOrder } from './productPagination'; import type { ProductPageResponse } from './types'; import { WORKSPACE_INVALIDATED } from './pageCache'; import { consumeEventStream, type StreamEvent } from './eventStream'; import { publicErrorMessage } from './publicDataDisplay'; import type { SalesOrderTypePreview,SalesOrderTypeStatus } from './salesOrderTypes'; import { clearReadCache, configureRequestScope, coordinateRequest, getRequestDiagnostics, invalidateReadResources, resetRequestScope, type CoordinatedResult, } from './requestCoordinator'; import type { AuthUser, FilterField, SourceColumnField, Collection, FineDefectTopResponse, FineDefectCatalogResponse, DefectDrilldownResponse, MetricsResponse, TrendResponse, OptionsResponse, QueryParams, RecordExportParams, RecordsParams, RecordsResponse, } from './types'; import type { ConfigureSourceBody, DataStage, DataWorkflowOperation, DataWorkflowStatus, MasterWorkbookImportBody, MasterWorkbookPreview, SourceDeletionPreview, SourceUploadOptions, WorkbookPreview } from './NoCodeDataTypes'; export { configureRequestScope, getRequestDiagnostics, invalidateReadResources, resetRequestScope }; export interface SystemUpdateStatus { enabled: boolean; currentVersion?: string; state: string; message?: string; checkedAt?: string; version?: string; available?: boolean; startedAt?: string; finishedAt?: string; } export class ApiError extends Error { status: number; details: unknown; constructor(status: number, message: string, details?: unknown) { super(publicErrorMessage(message, status)); this.name = 'ApiError'; this.status = status; this.details = details; } } let csrfToken: string | undefined; async function fetchApi(path: string, init: RequestInit): Promise { try { return await fetch(path, init); } catch (error) { if (init.signal?.aborted || (error instanceof DOMException && error.name === 'AbortError')) throw error; throw new ApiError(0, '无法连接质量数据服务,请检查网络后重试;当前无法确认数据覆盖。'); } } async function readResponse(response: Response): Promise> { const raw = await response.text(); const responseBytes = new TextEncoder().encode(raw).byteLength; let payload: unknown; if (raw) { try { payload = JSON.parse(raw) as unknown; } catch { payload = raw; } } if (!response.ok) { const body = payload && typeof payload === 'object' ? payload as Record : undefined; // Spring ProblemDetail uses `detail`; older endpoints may use `message` or `error`. const message = typeof body?.detail === 'string' ? body.detail : typeof body?.message === 'string' ? body.message : typeof body?.error === 'string' ? body.error : typeof payload === 'string' && payload.trim() ? payload : `请求失败(${response.status})`; const error = new ApiError(response.status, message, payload); Object.defineProperty(error, 'responseBytes', { value: responseBytes }); throw error; } if (typeof payload === 'string') { const error = new ApiError(response.status, '服务返回格式异常,请稍后重试。'); Object.defineProperty(error, 'responseBytes', { value: responseBytes }); throw error; } return { data: payload as T, status: response.status, bytes: responseBytes }; } export async function request(path: string, init: RequestInit = {}, timeoutMs?: number): Promise { const headers = new Headers(init.headers); if (init.body && !(init.body instanceof FormData) && !headers.has('Content-Type')) headers.set('Content-Type', 'application/json'); const method = (init.method ?? 'GET').toUpperCase(); try { return await coordinateRequest({ url: path, method, signal: init.signal ?? undefined, timeoutMs: timeoutMs ?? requestTimeoutFor(path), cache: method === 'GET' && init.cache !== 'reload' && isImmutableRead(path), tags: requestResourceTags(path), category: requestCategory(path), priority: requestPriority(path), execute: async signal => { const response = await fetchApi(path, { ...init, signal, headers, credentials: 'same-origin', cache: 'no-store' }); return readResponse(response); }, }); } catch (error) { handleAccessFailure(error); if (error instanceof Error && error.name === 'RequestTimeoutError') { const query = /^\/api\/(?:metrics(?:\/|$)|records(?:\/|$)|analysis\/(?:source\/|defects(?:\/|$)))/.test(requestPath(path)); throw new ApiError(408, query ? '查询处理超时,请重试或调整筛选范围。' : '连接质量数据服务超时,请点击重新连接;服务恢复后可继续使用。'); } throw error; } } async function requestBlob(path: string, signal?: AbortSignal): Promise<{ blob: Blob; filename: string }> { try { return await coordinateRequest({ url: path, method: 'GET', signal, timeoutMs: 900_000, queue: false, retry: false, tags: requestResourceTags(path), category: 'export', priority: 'active', execute: async requestSignal => { const response = await fetchApi(path, { credentials: 'same-origin', cache: 'no-store', signal: requestSignal }); if (!response.ok) { const raw = await response.text(); let payload: unknown = raw; try { payload = raw ? JSON.parse(raw) as unknown : undefined; } catch { /* keep plain text */ } const body = payload && typeof payload === 'object' ? payload as Record : undefined; const message = typeof body?.detail === 'string' ? body.detail : typeof body?.message === 'string' ? body.message : `下载失败(${response.status})`; const error = new ApiError(response.status, message, payload); Object.defineProperty(error, 'responseBytes', { value: new TextEncoder().encode(raw).byteLength }); throw error; } const disposition = response.headers.get('Content-Disposition') || ''; const encoded = disposition.match(/filename\*=UTF-8''([^;]+)/i)?.[1]; const plain = disposition.match(/filename="?([^";]+)"?/i)?.[1]; let filename = 'source-evidence.xlsx'; try { filename = encoded ? decodeURIComponent(encoded) : plain || filename; } catch { filename = plain || filename; } const blob = await response.blob(); return { data: { blob, filename }, status: response.status, bytes: blob.size }; }, }); } catch (error) { handleAccessFailure(error); if (error instanceof Error && error.name === 'RequestTimeoutError') throw new ApiError(408, '文件导出超时,请稍后重试。'); throw error; } } export type { StreamEvent } from './eventStream'; async function readEventStream(path: string, options: { signal?: AbortSignal; lastEventId?: string; onEvent: (event: StreamEvent) => void }): Promise { const headers = new Headers({ Accept: 'text/event-stream' }); if (options.lastEventId) headers.set('Last-Event-ID', options.lastEventId); try { const response = await fetchApi(path, { headers, credentials: 'same-origin', cache: 'no-store', signal: options.signal }); if (!response.ok) { const raw = await response.text(); let payload: unknown = raw; try { payload = raw ? JSON.parse(raw) as unknown : undefined; } catch { /* keep plain text */ } const body = payload && typeof payload === 'object' ? payload as Record : undefined; throw new ApiError(response.status, typeof body?.detail === 'string' ? body.detail : typeof body?.message === 'string' ? body.message : `事件流读取失败(${response.status})`, payload); } if (!response.body) throw new ApiError(response.status, '浏览器没有收到可读的分析事件流'); await consumeEventStream(response.body, options.onEvent); } catch (error) { handleAccessFailure(error); throw error; } } export async function refreshCsrf(): Promise { const result = await request<{ token: string }>('/api/auth/csrf', {}, 8000); csrfToken = result.token; return csrfToken; } async function mutate(path: string, body?: unknown, method = 'POST', timeoutMs?: number, silent = false): Promise { const token = csrfToken ?? await refreshCsrf(); const headers = new Headers({ 'X-XSRF-TOKEN': token }); const result = await request(path, { method, headers, ...(body === undefined ? {} : { body: JSON.stringify(body) }), }, timeoutMs); if (!silent && !/^\/api\/(?:analysis|auth)(?:\/|$)/.test(path)) invalidateAfterMutation(path); return result; } async function queryPost(path: string, body: unknown, signal?: AbortSignal): Promise { const token = csrfToken ?? await refreshCsrf(); return request(path, { method: 'POST', headers: { 'X-XSRF-TOKEN': token }, body: JSON.stringify(body), signal }); } async function mutateForm(path: string, body: FormData): Promise { const token = csrfToken ?? await refreshCsrf(); const result = await request(path, { method: 'POST', headers: { 'X-XSRF-TOKEN': token }, body }, 900_000); invalidateAfterMutation(path); return result; } export const api = { systemUpdateStatus() { return request('/api/system-update', {}, 12_000); }, checkSystemUpdate() { return mutate('/api/system-update/check', undefined, 'POST', 55_000); }, applySystemUpdate() { return mutate('/api/system-update/apply', undefined, 'POST', 55_000); }, exportSalesOrderTypes(signal?:AbortSignal) { return requestBlob('/api/sales-order-types/export',signal); }, salesOrderTypeStatus() { return request('/api/sales-order-types'); }, async salesOrderTypePreview(file:File,mode:string) { const body=new FormData();body.append('file',file);body.append('mode',mode); const token=csrfToken??await refreshCsrf(); return request('/api/sales-order-types/preview',{method:'POST',headers:{'X-XSRF-TOKEN':token},body},900_000); }, importSalesOrderTypes(file:File,mode:string,expectedVersion:string,sha256:string) { const body=new FormData();body.append('file',file);body.append('mode',mode);body.append('expectedVersion',expectedVersion);body.append('sha256',sha256); return mutateForm<{versionId:string}>('/api/sales-order-types/import',body); }, activateSalesOrderTypes(versionId:string,expectedVersion:string) { return mutate<{versionId:string}>('/api/sales-order-types/activate',{versionId,expectedVersion}); }, sourceColumnCatalog(releaseId?: string, signal?: AbortSignal) { return request<{releaseId:string;sourceFields:SourceColumnField[]}>(`/api/analysis/source/catalog?${toQuery({releaseId})}`, { signal }); }, sourceColumnValues(body: Record & {candidateOnly?:true}, signal?: AbortSignal) { return queryPost<{values:Array;hasMore?:boolean;total?:number;limit?:number}>('/api/analysis/source/values',body,signal); }, workspaceState() { return request<{ authRevision: string; dataRevision: string; currentReleaseId: string | null }>('/api/workspace/state', {}, 8000); }, filterFields(manage = false, signal?: AbortSignal) { return request(`/api/filter-fields?manage=${manage}`, { signal }); }, filterFieldOptions(key: string, search = '', signal?: AbortSignal,releaseId?:string,stage?:string) { return request<{ values: string[]; hasMore: boolean }>(`/api/filter-fields/options?${toQuery({key, search,releaseId,stage})}`, { signal }); }, filterFieldColumns() { return request<{ black: string[]; bright: string[] }>('/api/filter-fields/columns'); }, saveFilterFields(fields: FilterField[]) { return mutate('/api/filter-fields', fields, 'PUT'); }, refreshCsrf, async me(): Promise { const result = await request<{ user: AuthUser }>('/api/auth/me', {}, 8000); return result.user; }, async login(username: string, password: string) { csrfToken = undefined; resetRequestScope(); return mutate<{ user: AuthUser }>('/api/auth/login', { username, password }); }, async logout() { try { return await mutate('/api/auth/logout'); } finally { csrfToken = undefined; resetRequestScope(); } }, changePassword(currentPassword: string, newPassword: string) { return mutate<{ success: boolean }>('/api/auth/change-password', { currentPassword, newPassword }); }, options(signal?: AbortSignal) { return request('/api/options', { signal }); }, referenceNames() { return request>('/api/options/reference-names'); }, metrics(params: QueryParams, signal?: AbortSignal) { return request(`/api/metrics?${toQuery(params)}`, { signal }); }, productPage(params:QueryParams,page:number,pageSize:number,order:ProductOrder,signal?:AbortSignal) { return request(`/api/metrics/products?${toQuery({...params,page,pageSize,order})}`,{signal}); }, exportProductRows(params:QueryParams,rowOrder:ProductOrder,signal?:AbortSignal) { return request(`/api/metrics?${toQuery({...params,part:'table',rowOrder})}`,{signal,cache:'reload'}); }, metricsTable(params: QueryParams, signal?: AbortSignal) { return request(`/api/metrics?${toQuery({ ...params, part: 'table' })}`, { signal }); }, trend(params: QueryParams, signal?: AbortSignal) { return request(`/api/metrics/trend?${toQuery(params)}`, { signal }); }, fineDefectTop(params: Record, signal?: AbortSignal) { return queryPost('/api/analysis/defects', params, signal); }, fineDefectCatalog(params: Record, signal?: AbortSignal) { return queryPost('/api/analysis/defects', params, signal); }, defectDrilldown(params: Record, signal?: AbortSignal) { return queryPost('/api/analysis/defects/drilldown', params, signal); }, records(params: RecordsParams, signal?: AbortSignal) { return request(`/api/records?${toQuery(params)}`, { signal }); }, exportRecords(params: RecordExportParams, signal?: AbortSignal) { return requestBlob(`/api/records/export?${toQuery(params)}`, signal); }, sources() { return request>('/api/sources'); }, sourceDeletionPreview(id: string) { return request(`/api/sources/${encodeURIComponent(id)}/deletion-preview`); }, deletedSources() { return request<{ items: SourceDeletionPreview[] }>('/api/sources/deleted'); }, deleteSource(id: string, body: { expectedCurrentReleaseId: string | null; expectedDeleteVersion: number; expectedRevisionId?: string; reason: string; idempotencyKey: string }) { return mutate(`/api/sources/${encodeURIComponent(id)}/delete`, body); }, restoreSource(id: string, body: { expectedCurrentReleaseId: string | null; expectedDeleteVersion: number; reason: string }) { return mutate(`/api/sources/${encodeURIComponent(id)}/restore`, body); }, scanSources() { return mutate<{ items: import('./types').SourceItem[]; scannedAt: string }>('/api/sources/scan'); }, uploadSource(file: File) { const body = new FormData(); body.append('file', file); return mutateForm<{ source: import('./types').SourceItem }>('/api/sources/upload', body); }, sourceUploadOptions() { return request('/api/sources/upload-options'); }, previewSourceWorkbook(file: File) { const body = new FormData(); body.append('file', file); return mutateForm('/api/sources/workbook-preview', body); }, sourceWorkbookPreview(uploadId: string, params: { sheetName: string; headerRow: number; stage: DataStage }) { return request(`/api/sources/workbook-preview/${encodeURIComponent(uploadId)}?${toQuery(params)}`); }, configureSourceWorkbook(body: ConfigureSourceBody) { return mutate<{ source: import('./types').SourceItem; configuration: Record; currentReleaseId: string | null }>('/api/sources/configure', body); }, previewMasterWorkbook(file: File) { const body = new FormData(); body.append('file', file); return mutateForm('/api/master-data/workbooks/preview', body); }, importMasterWorkbook(body: MasterWorkbookImportBody) { return mutate>('/api/master-data/workbooks/import', body); }, prepareMasterWorkbook(body: MasterWorkbookImportBody) { return mutate>('/api/master-data/workbooks/prepare', body); }, startImport(body: { sourceIds: string[]; idempotencyKey: string; expectedCurrentReleaseId: string | null }) { return mutate('/api/import-runs', body); }, importRun(id: string) { return request<{ run: Record }>(`/api/import-runs/${encodeURIComponent(id)}`); }, importIssues(id: string, page = 1, pageSize = 50) { return request(`/api/import-runs/${encodeURIComponent(id)}/issues?page=${page}&pageSize=${pageSize}`); }, classificationMetadata() { return request<{ defaultRules: unknown[] }>('/api/governance/mapping-issues/classification-metadata'); }, classificationSources(body: {stage:string;conditions:{field:string;operator:string;value:string}[];page:number;pageSize:number;releaseId?:string}, signal?:AbortSignal) { return queryPost<{rows:Record[];total:number;page:number;pageSize:number;releaseId?:string}>('/api/governance/mapping-issues/classification-sources',body,signal); }, previewClassification(body: {kind?:'group'|'projectGroup';stage:string;target:string;conditions:{field:string;operator:string;value:string}[]}) { return queryPost>('/api/governance/mapping-issues/classification-preview',body); }, unclassifiedProjects(params: {page:number;pageSize:number;customerCode?:string;businessGroup?:string;department?:string}) { return request(`/api/governance/mapping-issues/unclassified-projects?${toQuery(params)}`); }, unclassifiedSources(page = 1, pageSize = 50) { return request(`/api/governance/mapping-issues/unclassified?${toQuery({ page, pageSize })}`); }, mappingIssues(params: { mappingType?: string; importRunId?: string; status?: string; page?: number; pageSize?: number; customerCode?: string; businessGroup?: string; department?: string } = {}) { return request(`/api/governance/mapping-issues?${toQuery({ page: 1, pageSize: 50, ...params })}`); }, mappingIssue(id: string) { return request>(`/api/governance/mapping-issues/${encodeURIComponent(id)}`); }, resolveMappingIssue(id: string, body: Record) { return mutate>(`/api/governance/mapping-issues/${encodeURIComponent(id)}/resolve`, body); }, revalidateMappingIssue(id: string, body: { decisionId: string; expectedCurrentReleaseId: string | null; idempotencyKey: string }) { return mutate>(`/api/governance/mapping-issues/${encodeURIComponent(id)}/revalidate`, body); }, taskOverview() { return request('/api/tasks/overview'); }, latestBackup() { return request>('/api/governance/backups/latest'); }, tasks() { return request('/api/tasks'); }, retryTask(id: string, body: { idempotencyKey: string; expectedCurrentReleaseId: string | null }) { return mutate(`/api/tasks/${encodeURIComponent(id)}/retry`, body); }, cancelTask(id: string, body: { expectedStatus: string }) { return mutate(`/api/tasks/${encodeURIComponent(id)}/cancel`, body); }, releases() { return request('/api/releases'); }, publishRelease(id: string, body: ReleaseActionBody) { return mutate(`/api/releases/${encodeURIComponent(id)}/publish`, body); }, rules() { return request('/api/rules'); }, ruleSchema() { return request>('/api/rules/schema'); }, createRule(body: Record) { return mutate('/api/rules', body); }, updateRule(id: string, body: Record) { return mutate(`/api/rules/${encodeURIComponent(id)}`, body, 'PUT'); }, validateRule(id: string, body: { expectedRowVersion: number }) { return mutate(`/api/rules/${encodeURIComponent(id)}/validate`, body); }, ruleRegressions(id: string) { return request<{ items: Record[] }>(`/api/governance/rules/${encodeURIComponent(id)}/regressions`); }, ruleRegression(id: string) { return request>(`/api/governance/rule-regressions/${encodeURIComponent(id)}`); }, activateRule(id: string, body: { expectedRowVersion: number; confirmDifferences?: boolean; regressionRunId?: string }) { return mutate(`/api/rules/${encodeURIComponent(id)}/activate`, body); }, metricDictionary() { return request<{ items: Record[] }>('/api/metric-dictionary'); }, metricDictionaryMigration() { return request<{ items: Record[]; verification?: Record }>('/api/metric-dictionary/migration'); }, updateMetricDictionary(code: string, body: Record) { return mutate>(`/api/metric-dictionary/${encodeURIComponent(code)}`, body, 'PUT'); }, mappings() { return request('/api/mappings'); }, createMapping(body: Record) { return mutate('/api/mappings', body); }, updateMapping(id: string, body: Record) { return mutate(`/api/mappings/${encodeURIComponent(id)}`, body, 'PUT'); }, validateMapping(id: string, body: { expectedRowVersion: number }) { return mutate(`/api/mappings/${encodeURIComponent(id)}/validate`, body); }, activateMapping(id: string, body: { expectedRowVersion: number }) { return mutate(`/api/mappings/${encodeURIComponent(id)}/activate`, body); }, dataWorkflowStatus() { return request('/api/data-workflow/status'); }, applyDataWorkflow(body: { kind: 'mapping' | 'rule'; name: string; definition: Record; description?: string; expectedCurrentReleaseId: string | null }, silent = false) { const matchRules = body.definition.matchRules; const definition = Array.isArray(matchRules) ? { ...body.definition, matchRules: matchRules.map(rule => { if (!rule || typeof rule !== 'object' || Array.isArray(rule)) return rule; const row = rule as Record; if (!Array.isArray(row.conditions)) return row; return { ...row, conditions: row.conditions.map(condition => { if (!condition || typeof condition !== 'object' || Array.isArray(condition)) return condition; const item = condition as Record; return ['IS_BLANK', 'IS_NOT_BLANK'].includes(String(item.operator)) ? { ...item, value: '' } : item; }), }; }), } : body.definition; return mutate('/api/data-workflow/apply', { ...body, definition }, 'POST', undefined, silent); }, recalculateDataWorkflow() { return mutate('/api/data-workflow/recalculate', {}); }, importDataWorkflow(body: { sourceIds: string[] }) { return mutate('/api/data-workflow/import', body); }, deleteDataWorkflowSource(id: string) { return mutate(`/api/data-workflow/sources/${encodeURIComponent(id)}/delete`, {}); }, deleteDataWorkflowSources(body: { sourceIds: string[]; expectedCurrentReleaseId: string | null }) { return mutate('/api/data-workflow/sources/delete-batch', body); }, restoreDataWorkflowSource(id: string) { return mutate(`/api/data-workflow/sources/${encodeURIComponent(id)}/restore`, {}); }, dataWorkflowOperation(id: string) { return request(`/api/data-workflow/operations/${encodeURIComponent(id)}`); }, audit(page = 1, pageSize = 50) { return request(`/api/audit?page=${page}&pageSize=${pageSize}`); }, users() { return request('/api/users'); }, createUser(body: Record) { return mutate('/api/users', body); }, updateUser(id: string, body: Record) { return mutate(`/api/users/${encodeURIComponent(id)}`, body, 'PUT'); }, deleteUser(id: string, expectedRowVersion: number) { return mutate<{ deleted: boolean; id: string }>(`/api/users/${encodeURIComponent(id)}`, { expectedRowVersion }, 'DELETE'); }, analysis(body: { query: string; sessionId?: string; context?: Record }) { return mutate('/api/analysis', body); }, analysisStatus() { return request>('/api/analysis/status'); }, analysisReports() { return request<{ items: Record[] }>('/api/analysis/reports'); }, createAnalysisReport(body: { periodType: string; periodKey: string }) { return mutate<{ report: Record; turn: Record }>('/api/analysis/reports', body); }, analysisReportPlans() { return request<{ items: Record[] }>('/api/analysis/report-plans'); }, createAnalysisReportPlan(body: Record) { return mutate<{ plan: Record }>('/api/analysis/report-plans', body); }, updateAnalysisReportPlan(id: string, body: Record) { return mutate<{ plan: Record }>(`/api/analysis/report-plans/${encodeURIComponent(id)}`, body, 'PUT'); }, analysisSessions() { return request>>('/api/analysis/sessions'); }, analysisSession(id: string) { return request>(`/api/analysis/sessions/${encodeURIComponent(id)}`); }, analysisSessionPage(id: string, before?: string, signal?: AbortSignal) { const cursor = before ? `?before=${encodeURIComponent(before)}` : ''; return request>(`/api/analysis/sessions/${encodeURIComponent(id)}/history${cursor}`, { signal }); }, deleteAnalysisSession(id: string) { return mutate<{ deleted: boolean; sessionId: string }>(`/api/analysis/sessions/${encodeURIComponent(id)}`, undefined, 'DELETE'); }, renameAnalysisSession(id: string, title: string) { return mutate<{ sessionId: string; title: string }>(`/api/analysis/sessions/${encodeURIComponent(id)}`, { title }, 'PATCH'); }, analysisSessionTurns(id: string) { return request<{ items: Record[] }>(`/api/analysis/sessions/${encodeURIComponent(id)}/turns`); }, createAnalysisSession(body: { title?: string; releaseId?: string; context?: Record }) { return mutate<{ session: Record }>('/api/analysis/sessions', body); }, startAnalysisTurn(id: string, body: { question: string; context?: Record; idempotencyKey?: string }) { return mutate<{ turn: Record }>(`/api/analysis/sessions/${encodeURIComponent(id)}/turns`, body); }, analysisTurn(id: string) { return request>(`/api/analysis/turns/${encodeURIComponent(id)}`); }, analysisTurnSnapshot(id: string) { return request>(`/api/analysis/turns/${encodeURIComponent(id)}/snapshot`, {}, 30000); }, analysisSettings() { return request('/api/analysis/settings'); }, saveAnalysisSettings(body: import('./AnalysisApiSettings').AnalysisModelSettingsInput) { return mutate('/api/analysis/settings', body, 'PUT'); }, testAnalysisSettings(body: import('./AnalysisApiSettings').AnalysisModelSettingsInput) { return mutate<{ success: boolean; message: string; elapsedMs?: number }>('/api/analysis/settings/test', body); }, retryAnalysisTurn(id: string) { return mutate<{ turn: Record }>(`/api/analysis/turns/${encodeURIComponent(id)}/retry`); }, recoverAnalysisVisuals(id: string) { return mutate>(`/api/analysis/turns/${encodeURIComponent(id)}/visual-recovery`, undefined, 'POST', 60000); }, analysisTurnEvents(id: string, options: { signal?: AbortSignal; lastEventId?: string; onEvent: (event: StreamEvent) => void }) { return readEventStream(`/api/analysis/turns/${encodeURIComponent(id)}/events`, options); }, analysisSessionFollow(id: string, options: { signal?: AbortSignal; onEvent: (event: StreamEvent) => void }) { return readEventStream(`/api/analysis/sessions/${encodeURIComponent(id)}/follow`, options); }, cancelAnalysisTurn(id: string, reason?: string) { return mutate>(`/api/analysis/turns/${encodeURIComponent(id)}/cancel`, reason ? { reason } : {}); }, feedbackAnalysisTurn(id: string, body: { rating: string; comment?: string }) { return mutate>(`/api/analysis/turns/${encodeURIComponent(id)}/feedback`, body); }, analyticsTop(params: Record) { return request>(`/api/analytics/top?${toQuery(params)}`); }, checklists() { return request<{ items: Record[] }>('/api/analytics/checklists'); }, createChecklist(body: { title: string }) { return mutate>('/api/analytics/checklists', body); }, checklist(id: string) { return request>(`/api/analytics/checklists/${encodeURIComponent(id)}`); }, addChecklistItem(id: string, body: Record) { return mutate>(`/api/analytics/checklists/${encodeURIComponent(id)}/items`, body); }, deleteChecklistItem(id: string, itemId: string) { return mutate(`/api/analytics/checklists/${encodeURIComponent(id)}/items/${encodeURIComponent(itemId)}`, undefined, 'DELETE'); }, analyticsCompare(body: Record) { return mutate>('/api/analytics/compare', body); }, analyticsImpact(body: Record) { return mutate>('/api/analytics/impact', body); }, structureDecomposition(body: Record) { return mutate>('/api/analytics/structure-decomposition', body); }, comparisonViews() { return request<{ items: Record[] }>('/api/analytics/comparison-views'); }, sharedComparisonViews() { return request<{ items: Record[] }>('/api/analytics/comparison-views/shared'); }, comparisonViewShareCandidates() { return request<{ items: Record[] }>('/api/analytics/comparison-views/share-candidates'); }, comparisonViewShares(id: string) { return request<{ items: Record[]; viewRowVersion: number }>(`/api/analytics/comparison-views/${encodeURIComponent(id)}/shares`); }, shareComparisonView(id: string, body: { recipientUserId: string; expectedRowVersion: number }) { return mutate>(`/api/analytics/comparison-views/${encodeURIComponent(id)}/shares`, body); }, revokeComparisonViewShare(id: string, recipientUserId: string, expectedRowVersion: number) { return mutate>(`/api/analytics/comparison-views/${encodeURIComponent(id)}/shares/${encodeURIComponent(recipientUserId)}?expectedRowVersion=${expectedRowVersion}`, undefined, 'DELETE'); }, createComparisonView(body: Record) { return mutate>('/api/analytics/comparison-views', body); }, updateComparisonView(id: string, body: Record) { return mutate>(`/api/analytics/comparison-views/${encodeURIComponent(id)}`, body, 'PUT'); }, deleteComparisonView(id: string) { return mutate(`/api/analytics/comparison-views/${encodeURIComponent(id)}`, undefined, 'DELETE'); }, openComparisonView(id: string) { return mutate>(`/api/analytics/comparison-views/${encodeURIComponent(id)}/open`, {}); }, analyticsTarget(params: Record) { return request>(`/api/analytics/targets?${toQuery(params)}`); }, targetVersions() { return request<{ items: Record[]; currentVersionId?: string }>('/api/analytics/targets/versions'); }, targetVersion(id: string) { return request>(`/api/analytics/targets/versions/${encodeURIComponent(id)}`); }, createTargetVersion(body: { name: string }) { return mutate>('/api/analytics/targets/versions', body); }, updateTargetVersion(id: string, body: Record) { return mutate>(`/api/analytics/targets/versions/${encodeURIComponent(id)}`, body, 'PUT'); }, updateCurrentTargets(body: Record) { return mutate>('/api/analytics/targets/current', body, 'PUT'); }, validateTargetVersion(id: string, body: { expectedRowVersion: number }) { return mutate>(`/api/analytics/targets/versions/${encodeURIComponent(id)}/validate`, body); }, activateTargetVersion(id: string, body: { expectedRowVersion: number }) { return mutate>(`/api/analytics/targets/versions/${encodeURIComponent(id)}/activate`, body); }, governanceProtocols() { return request<{ items: Record[] }>('/api/governance/protocols'); }, governanceSourceDocuments() { return request<{ items: Record[]; revisions: Record[] }>('/api/governance/source-documents'); }, createGovernanceProtocol(body: Record) { return mutate>('/api/governance/protocols', body); }, governanceCoverage(releaseId?: string) { const suffix = releaseId ? `?releaseId=${encodeURIComponent(releaseId)}` : ''; return request>(`/api/governance/coverage${suffix}`); }, governanceReleaseInspect(id: string) { return request>(`/api/governance/releases/${encodeURIComponent(id)}/inspect`); }, governanceReleaseDiff(id: string, againstReleaseId: string) { return request>(`/api/governance/releases/${encodeURIComponent(id)}/diff?againstReleaseId=${encodeURIComponent(againstReleaseId)}`); }, governanceReleaseReconciliations(id: string) { return request<{ items: Record[]; acceptanceId?: string }>(`/api/governance/releases/${encodeURIComponent(id)}/reconciliations`); }, createGovernanceReconciliation(id: string, body: Record) { return mutate>(`/api/governance/releases/${encodeURIComponent(id)}/reconciliations`, body); }, governanceReconciliation(id: string) { return request>(`/api/governance/reconciliations/${encodeURIComponent(id)}`); }, confirmGovernanceReconciliation(id: string, body: { expectedRowVersion: number; expectedDifferenceHash: string; expectedTransitionDifferenceHash?: string; reason: string }) { return mutate>(`/api/governance/reconciliations/${encodeURIComponent(id)}/confirm`, body); }, governanceDependencyImpact(kind: 'rule' | 'mapping', id: string) { return request>(`/api/governance/dependencies/${kind}/${encodeURIComponent(id)}/impact`); }, governanceBackups() { return request>('/api/governance/backups'); }, createBackupJob(body: Record) { return mutate>('/api/governance/backups/jobs', body); }, updateBackupPlan(body: Record) { return mutate>('/api/governance/backups/plan', body, 'PUT'); }, resolveSourceCandidate(id: string, body: Record) { return mutate>(`/api/governance/sources/${encodeURIComponent(id)}/resolve`, body); }, sourceChanges() { return request<{ items: Record[] }>('/api/governance/source-changes'); }, createSourceChange(body: Record) { return mutate>('/api/governance/source-changes', body); }, reviewSourceChange(id: string, body: Record) { return mutate>(`/api/governance/source-changes/${encodeURIComponent(id)}/review`, body); }, buildSourceChange(id: string, body: Record) { return mutate>(`/api/governance/source-changes/${encodeURIComponent(id)}/build`, body); }, governanceMonitor() { return request>('/api/governance/monitor'); }, inspectionStrategies() { return request<{ items: Record[] }>('/api/analytics/inspection-strategies'); }, inspectionStrategy(id: string) { return request>(`/api/analytics/inspection-strategies/${encodeURIComponent(id)}`); }, createInspectionStrategy(body: Record) { return mutate>('/api/analytics/inspection-strategies', body); }, updateInspectionStrategy(id: string, body: Record) { return mutate>(`/api/analytics/inspection-strategies/${encodeURIComponent(id)}`, body, 'PUT'); }, inspectionRuns(releaseId?: string) { const query = releaseId ? `?releaseId=${encodeURIComponent(releaseId)}` : ''; return request<{ items: Record[]; resultAvailable?: boolean }>(`/api/analytics/inspection-runs${query}`); }, runInspection(releaseId: string) { return mutate<{ items: Record[]; resultAvailable?: boolean }>('/api/analytics/inspection-runs/run', { releaseId }); }, refreshGovernanceMonitor() { return mutate>('/api/governance/monitor/refresh', {}); }, governanceAlertPolicy() { return request>('/api/governance/monitor/alert-policy'); }, updateGovernanceAlertPolicy(body: Record) { return mutate>('/api/governance/monitor/alert-policy', body, 'PUT'); }, serviceIdentities() { return request<{ items: Record[]; allowedActions?: string[]; serviceTypes?: string[] }>('/api/governance/service-identities'); }, createServiceIdentity(body: Record) { return mutate>('/api/governance/service-identities', body); }, updateServiceIdentity(id: string, body: Record) { return mutate>(`/api/governance/service-identities/${encodeURIComponent(id)}`, body, 'PUT'); }, rotateServiceIdentity(id: string, body: Record) { return mutate>(`/api/governance/service-identities/${encodeURIComponent(id)}/rotate`, body); }, userAccessPolicy(id: string) { return request>(`/api/governance/users/${encodeURIComponent(id)}/access-policy`); }, updateUserAccessPolicy(id: string, body: Record) { return mutate>(`/api/governance/users/${encodeURIComponent(id)}/access-policy`, body, 'PUT'); }, effectiveUserAccess(id: string) { return request>(`/api/governance/users/${encodeURIComponent(id)}/effective-access`); }, userScopePreview(id: string) { return request>(`/api/governance/users/${encodeURIComponent(id)}/scope-preview`); }, downloadSourceRevision(id: string, signal?: AbortSignal) { return requestBlob(`/api/governance/source-revisions/${encodeURIComponent(id)}/download`, signal); }, sourceRevisionEvidence(id: string) { return request>(`/api/governance/source-revisions/${encodeURIComponent(id)}/evidence`); }, serviceRotations(id: string) { return request<{ items: Record[] }>(`/api/governance/service-identities/${encodeURIComponent(id)}/rotations`); }, authorizeServiceAction(id: string, action: string) { return mutate>(`/api/governance/service-identities/${encodeURIComponent(id)}/authorize`, { action }); }, serviceBindings() { return request<{ items: Record[] }>('/api/governance/service-bindings'); }, updateServiceBinding(type: string, body: { identityId: string; reason: string }) { return mutate>(`/api/governance/service-bindings/${encodeURIComponent(type)}`, body, 'PUT'); }, }; export interface ReleaseActionBody { expectedCurrentReleaseId: string | null; idempotencyKey: string; reason: string; } function toQuery(values: object): string { const query = new URLSearchParams(); for (const [key, value] of Object.entries(values)) { if (value === undefined || value === null || value === '') continue; if (key === 'columnFilters') query.set(key, JSON.stringify(value)); else if (Array.isArray(value)) value.forEach(item => { if (item !== undefined && item !== null && item !== '') query.append(key, String(item)); }); else query.set(key, typeof value === 'object' ? JSON.stringify(value) : String(value)); } return query.toString(); } function requestPath(path: string): string { const base = typeof location === 'undefined' ? 'http://localhost' : location.origin; return new URL(path, base).pathname; } function requestTimeoutFor(path: string): number | undefined { const pathname = requestPath(path); return pathname === '/api/workspace/state' || pathname === '/api/auth/me' || pathname === '/api/auth/csrf' ? 8_000 : undefined; } function isImmutableRead(path: string): boolean { const pathname = requestPath(path); if (pathname === '/api/metrics' || pathname === '/api/metrics/trend') return true; if (pathname === '/api/options' || pathname === '/api/options/reference-names') return true; if (pathname === '/api/analysis/source/catalog' || pathname === '/api/rules/schema') return true; if (/^\/api\/governance\/releases\/[^/]+\/(?:inspect|diff)$/.test(pathname)) return true; if (pathname === '/api/governance/coverage') { const url = new URL(path, typeof location === 'undefined' ? 'http://localhost' : location.origin); return Boolean(url.searchParams.get('releaseId')); } return false; } function requestResourceTags(path: string): string[] { const pathname = requestPath(path); if(pathname.startsWith('/api/sales-order-types'))return ['configuration','metrics','trend','records','options','catalog','query']; if (pathname.startsWith('/api/metrics')) return ['metrics', 'trend', 'query']; if (pathname.startsWith('/api/options')) return ['options', 'query']; if (pathname.startsWith('/api/filter-fields') || pathname === '/api/analysis/source/catalog') return ['options', 'catalog', 'configuration']; if (pathname.startsWith('/api/records')) return ['records', 'query']; if (pathname.startsWith('/api/analytics/targets')) return ['targets', 'query']; if (pathname.startsWith('/api/sources')) return ['sources', 'workflow', 'catalog']; if (pathname.startsWith('/api/data-workflow')) return ['workflow', 'sources', 'tasks', 'releases']; if (pathname.startsWith('/api/tasks') || pathname.startsWith('/api/import-runs')) return ['tasks', 'workflow']; if (pathname.startsWith('/api/analysis/')) return ['analysis', 'reports', 'options', 'catalog']; if (pathname.startsWith('/api/rules') || pathname.startsWith('/api/mappings') || pathname.startsWith('/api/governance/mapping-issues')) return ['configuration', 'metrics', 'trend', 'records', 'options', 'catalog']; if (pathname.startsWith('/api/governance/backups')) return ['backups', 'monitor', 'workflow']; if (pathname.startsWith('/api/governance/monitor')) return ['monitor', 'workflow']; if (pathname.startsWith('/api/governance/')) return ['configuration', 'workflow', 'sources', 'releases']; if (pathname.startsWith('/api/analytics/')) return ['configuration', 'targets']; if (pathname.startsWith('/api/users') || pathname.startsWith('/api/audit') || pathname.includes('/access-policy') || pathname.includes('/effective-access') || pathname.includes('/scope-preview') || pathname.includes('/service-identities') || pathname.includes('/service-bindings')) return ['access', 'users', 'audit', 'policy']; return []; } function requestCategory(path: string): string { const pathname = requestPath(path); if (pathname === '/api/workspace/state') return 'workspace'; if (pathname.startsWith('/api/auth/')) return 'auth'; if (pathname.startsWith('/api/metrics')) return 'metrics'; if (pathname.includes('/export') || pathname.endsWith('/download')) return 'export'; if (pathname.startsWith('/api/analysis/')) return 'analysis'; if (pathname.startsWith('/api/governance/')) return 'governance'; if (pathname.startsWith('/api/tasks') || pathname.startsWith('/api/import-runs')) return 'tasks'; if (pathname.startsWith('/api/sources')) return 'sources'; if (pathname.startsWith('/api/analytics/')) return 'analytics'; return 'other'; } function requestPriority(path: string): 'active' | 'background' { const pathname = requestPath(path); return pathname.startsWith('/api/data-workflow/operations/') || pathname.startsWith('/api/import-runs/') || pathname.startsWith('/api/tasks/') ? 'background' : 'active'; } function mutationResources(path: string): string[] | null { const pathname = requestPath(path); if (pathname.startsWith('/api/auth/') || pathname.startsWith('/api/analysis/')) return []; if (pathname.startsWith('/api/users') || pathname.startsWith('/api/audit') || pathname.includes('/access-policy') || pathname.includes('/effective-access') || pathname.includes('/scope-preview') || pathname.includes('/service-identities') || pathname.includes('/service-bindings')) return ['*']; if (pathname.startsWith('/api/sources') || pathname.startsWith('/api/releases') || pathname.startsWith('/api/data-workflow') || pathname.startsWith('/api/import-runs')) { return ['metrics', 'trend', 'records', 'options', 'catalog', 'sources', 'workflow', 'tasks', 'releases', 'configuration']; } if (pathname.startsWith('/api/filter-fields')) return ['options', 'catalog', 'query', 'configuration']; if (pathname.startsWith('/api/rules') || pathname.startsWith('/api/mappings') || pathname.startsWith('/api/governance/mapping-issues') || pathname.startsWith('/api/metric-dictionary')) { return ['metrics', 'trend', 'records', 'options', 'catalog', 'configuration']; } if (pathname.startsWith('/api/tasks')) return ['tasks', 'workflow']; if (pathname.startsWith('/api/governance/backups')) return ['backups', 'monitor', 'workflow', 'configuration']; if (pathname.startsWith('/api/governance/monitor')) return ['monitor', 'workflow', 'configuration']; if (pathname.startsWith('/api/analytics/targets')) return ['targets', 'configuration']; if (pathname.startsWith('/api/analytics/')) return ['configuration']; if (pathname.startsWith('/api/governance/')) return ['configuration', 'workflow', 'sources', 'releases']; if (pathname.startsWith('/api/')) return null; return null; } function invalidateAfterMutation(path: string): void { const resources = mutationResources(path); if (resources?.length === 0) return; const invalidated = resources ?? ['*']; invalidateReadResources(resources?.includes('*') ? undefined : resources ?? undefined); window.dispatchEvent(new CustomEvent(WORKSPACE_INVALIDATED, { detail: { resources: invalidated } })); } function hasStatus(error: unknown, status: number): boolean { return !!error && typeof error === 'object' && (error as { status?: unknown }).status === status; } function handleAccessFailure(error: unknown): void { if (hasStatus(error, 401)) { csrfToken = undefined; resetRequestScope(); } else if (hasStatus(error, 403)) { clearReadCache(); window.dispatchEvent(new Event('quality-permission-recheck')); } } const MULTI_VALUE_MARKER = '~qv1~'; /** Encodes multiple selected values into the scalar query wire format understood by the API. */ export function encodeQueryValueList(values: string[] | undefined): string | undefined { if (!values?.length) return undefined; const normalized = [...new Set(values.map(value => value.trim()).filter(Boolean))]; if (normalized.length === 0) return undefined; if (normalized.length === 1) return normalized[0]; const bytes = new TextEncoder().encode(JSON.stringify(normalized)); let binary = ''; bytes.forEach(byte => { binary += String.fromCharCode(byte); }); return `${MULTI_VALUE_MARKER}${btoa(binary).replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/g, '')}`; } /** Reads a plain scalar or the versioned multi-value query wire format. */ export function decodeQueryValueList(value: string | undefined): string[] { if (!value) return []; if (!value.startsWith(MULTI_VALUE_MARKER)) return [value]; try { const encoded = value.slice(MULTI_VALUE_MARKER.length).replaceAll('-', '+').replaceAll('_', '/'); const binary = atob(encoded.padEnd(Math.ceil(encoded.length / 4) * 4, '=')); const bytes = Uint8Array.from(binary, character => character.charCodeAt(0)); const parsed: unknown = JSON.parse(new TextDecoder().decode(bytes)); return Array.isArray(parsed) ? [...new Set(parsed.filter(item => typeof item === 'string').map(item => item.trim()).filter(Boolean))] : []; } catch { return []; } } export function collectionItems(value: Collection | T[] | null | undefined): T[] { if (Array.isArray(value)) return value; if (value && Array.isArray(value.items)) return value.items; return []; }