import { analysisPeriodLabel, parseAnalysisPeriod } from './analysisPeriodModel.ts'; import { sanitizeAnalysisDisplayText } from './analysisDisplayText.ts'; export type AnalysisMemberStage = 'black' | 'bright'; export type AnalysisMemberList = { schemaVersion: 1; releaseId: string; period: { year: number; month?: number; quarter?: number; monthStart?: number; monthEnd?: number }; fields: { key: string; label: string }[]; rows: { values: Record; stages: AnalysisMemberStage[] }[]; totalCount: number; rowsReturned: number; queryComplete: boolean; }; export type MemberListReadState = { data: T | null; error: string }; const isRecord = (value: unknown): value is Record => Boolean(value) && typeof value === 'object' && !Array.isArray(value); function count(value: unknown): value is number { return Number.isSafeInteger(value) && Number(value) >= 0; } /** Reject malformed snapshot data before it reaches the table. Values stay plain strings. */ export function parseAnalysisMemberList(value: unknown): AnalysisMemberList | null { if (!isRecord(value) || value.schemaVersion !== 1 || typeof value.releaseId !== 'string' || !value.releaseId.trim()) return null; if (!isRecord(value.period)) return null; const period = parseAnalysisPeriod(value.period, 1900, 2100); if (!period?.year) return null; if (!Array.isArray(value.fields) || value.fields.length < 1 || value.fields.length > 5 || !Array.isArray(value.rows) || value.rows.length > 4000 || !count(value.totalCount) || !count(value.rowsReturned) || value.rowsReturned > 4000 || value.rowsReturned > value.totalCount || value.rows.length !== value.rowsReturned || typeof value.queryComplete !== 'boolean' || value.queryComplete && value.rowsReturned !== value.totalCount) return null; const fields: AnalysisMemberList['fields'] = []; const fieldKeys = new Set(); for (const field of value.fields) { if (!isRecord(field) || typeof field.key !== 'string' || !field.key.trim() || typeof field.label !== 'string' || !field.label.trim() || fieldKeys.has(field.key)) return null; fieldKeys.add(field.key); fields.push({ key: field.key, label: field.label }); } const rows: AnalysisMemberList['rows'] = []; for (const row of value.rows) { if (!isRecord(row) || !isRecord(row.values) || !Array.isArray(row.stages) || !row.stages.length || new Set(row.stages).size !== row.stages.length) return null; const valueKeys = Object.keys(row.values); if (valueKeys.length !== fieldKeys.size || valueKeys.some(key => !fieldKeys.has(key))) return null; const values = Object.create(null) as Record; for (const [key, cell] of Object.entries(row.values)) { if (cell !== null && typeof cell !== 'string') return null; values[key] = cell; } if (!row.stages.every(stage => stage === 'black' || stage === 'bright')) return null; rows.push({ values, stages: [...new Set(row.stages)] as AnalysisMemberStage[] }); } return { schemaVersion: 1, releaseId: value.releaseId, period: period as AnalysisMemberList['period'], fields, rows, totalCount: value.totalCount, rowsReturned: value.rowsReturned, queryComplete: value.queryComplete, }; } export function analysisMemberListPeriod(period: AnalysisMemberList['period']): string { return analysisPeriodLabel(period, 1900, 2100); } export function analysisMemberListFullyRead(list: AnalysisMemberList): boolean { return list.queryComplete && list.rowsReturned >= list.totalCount; } export function analysisMemberListPage(list: AnalysisMemberList, page: number, pageSize: number) { const size = Math.max(1, Math.trunc(pageSize)); const pageCount = Math.max(1, Math.ceil(list.rowsReturned / size)); const currentPage = Math.min(Math.max(1, Math.trunc(page)), pageCount); const offset = (currentPage - 1) * size; return { page: currentPage, pageSize: size, offset, pageCount, rows: list.rows.slice(offset, offset + size) }; } /** A failed current snapshot authorization always returns an empty data slot. */ export async function authorizedMemberListRead( data: T, authorize: () => Promise, onUnauthorized: (error: unknown) => boolean, ): Promise> { try { await authorize(); return { data, error: '' }; } catch (error) { const handled = onUnauthorized(error); const detail = error instanceof Error ? sanitizeAnalysisDisplayText(error.message).replace(/\b[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\b/gi, '[隐藏标识]').slice(0, 300) : ''; return { data: null, error: handled ? '访问权限已更新,成员清单已清空。' : detail || '当前快照复核失败,成员清单已清空。' }; } }