Janady13/missionmatch / frontend/src/tools/slatematch/scopeApi.ts

1import { csrfForUpload, request } from '../../lib/api' 2 3// The Phase 2 review path: documents in, scope reviewed, drafts built, one named human promotes. Shapes are 4// snake_case to match the Go DTOs exactly, so a field rename on either side fails loudly rather than silently 5// rendering undefined. 6 7export interface OpportunityDocument { 8 id: string 9 document_type: string 10 file_name: string 11 media_type: string 12 size_bytes: number 13 sha256: string 14 extraction_status: string 15 extraction_error_code: string 16 is_current: boolean 17 provenance: string 18 created_at: string 19} 20 21export interface ScopeItem { 22 id: string 23 opportunity_id: string 24 scope_type: string 25 title: string 26 description: string 27 source_document_id: string 28 source_page_number: number 29 source_section_label: string 30 source_quote_hash: string 31 extraction_method: string 32 extraction_confidence: number 33 review_status: string 34 display_order: number 35 created_at: string 36} 37 38export interface RequirementDraft { 39 id: string 40 labor_category: string 41 quantity: number 42 clearance_level: string 43 polygraph: string 44 minimum_years_experience: number 45 work_location: string 46 remote_allowed: boolean 47 required_skills: string[] | null 48 review_status: string 49 approved_requirement_id: string 50 derivation_method: string 51} 52 53const NS = '/opportunities/tracked' 54const body = (v: unknown) => ({ body: JSON.stringify(v) }) 55 56// UPLOAD USES XMLHttpRequest, NOT fetch, for exactly one reason: Section 6 screen 3 requires upload PROGRESS 57// and fetch cannot report it. A solicitation package is tens of megabytes, so a progressless upload looks 58// indistinguishable from a hung one, which is how a user learns to distrust a screen. 59export function uploadDocument( 60 opportunityId: string, 61 file: File, 62 documentType: string, 63 onProgress: (percent: number) => void, 64): Promise<OpportunityDocument> { 65 return csrfForUpload().then( 66 (token) => 67 new Promise<OpportunityDocument>((resolve, reject) => { 68 const form = new FormData() 69 form.append('file', file) 70 form.append('document_type', documentType) 71 72 const xhr = new XMLHttpRequest() 73 xhr.open('POST', `/api/opportunities/${encodeURIComponent(opportunityId)}/documents`) 74 xhr.withCredentials = true 75 xhr.setRequestHeader('X-CSRF-Token', token) 76 // The boundary is generated by the browser, so Content-Type is deliberately NOT set here. 77 78 xhr.upload.onprogress = (e) => { 79 if (e.lengthComputable) onProgress(Math.round((e.loaded / e.total) * 100)) 80 } 81 xhr.onload = () => { 82 if (xhr.status >= 200 && xhr.status < 300) { 83 try { 84 resolve(JSON.parse(xhr.responseText) as OpportunityDocument) 85 } catch { 86 reject(new Error('the server accepted the upload but returned an unreadable body')) 87 } 88 return 89 } 90 // A 413 is the one failure a user can act on, and it is worth naming rather than showing a number. 91 if (xhr.status === 413) { 92 reject(new Error('this file is larger than the server accepts')) 93 return 94 } 95 let detail = `upload failed with status ${xhr.status}` 96 try { 97 const parsed = JSON.parse(xhr.responseText) as { error?: string } 98 if (parsed.error) detail = parsed.error 99 } catch { 100 /* a non JSON error body keeps the status line above */ 101 } 102 reject(new Error(detail)) 103 } 104 xhr.onerror = () => reject(new Error('the upload could not reach the server')) 105 xhr.onabort = () => reject(new Error('the upload was cancelled')) 106 xhr.send(form) 107 }), 108 ) 109} 110 111export const scopeApi = { 112 documents: (oppId: string) => 113 request<{ documents: OpportunityDocument[] }>(`/opportunities/${encodeURIComponent(oppId)}/documents`), 114 115 scope: (oppId: string, status?: string) => { 116 const qs = status ? `?status=${encodeURIComponent(status)}` : '' 117 return request<ScopeItem[]>(`${NS}/${encodeURIComponent(oppId)}/scope${qs}`) 118 }, 119 120 review: (oppId: string, itemId: string, v: Record<string, unknown>) => 121 request<ScopeItem>(`${NS}/${encodeURIComponent(oppId)}/scope/items/${encodeURIComponent(itemId)}`, { 122 method: 'PATCH', 123 ...body(v), 124 }), 125 126 addManual: (oppId: string, v: { scope_type: string; title: string; description: string }) => 127 request<ScopeItem>(`${NS}/${encodeURIComponent(oppId)}/scope/items`, { method: 'POST', ...body(v) }), 128 129 split: (oppId: string, itemId: string, parts: Array<{ scope_type?: string; title: string; description?: string }>) => 130 request<{ children: ScopeItem[] }>( 131 `${NS}/${encodeURIComponent(oppId)}/scope/items/${encodeURIComponent(itemId)}/split`, 132 { method: 'POST', ...body({ parts }) }, 133 ), 134 135 merge: ( 136 oppId: string, 137 itemId: string, 138 v: { absorb_item_ids: string[]; title: string; description?: string; scope_type?: string }, 139 ) => 140 request<ScopeItem>(`${NS}/${encodeURIComponent(oppId)}/scope/items/${encodeURIComponent(itemId)}/merge`, { 141 method: 'POST', 142 ...body(v), 143 }), 144 145 drafts: (oppId: string) => request<RequirementDraft[]>(`${NS}/${encodeURIComponent(oppId)}/requirement-drafts`), 146 147 generateDrafts: (oppId: string) => 148 request<{ created: number; skipped_existing: number }>( 149 `${NS}/${encodeURIComponent(oppId)}/requirement-drafts/generate`, 150 { method: 'POST', body: '{}' }, 151 ), 152 153 patchDraft: (draftId: string, v: Record<string, unknown>) => 154 request<Record<string, unknown>>(`/requirement-drafts/${encodeURIComponent(draftId)}`, { 155 method: 'PATCH', 156 ...body(v), 157 }), 158 159 approveDraft: (draftId: string) => 160 request<Record<string, unknown>>(`/requirement-drafts/${encodeURIComponent(draftId)}/approve`, { 161 method: 'POST', 162 body: '{}', 163 }), 164 165 rejectDraft: (draftId: string, reason: string) => 166 request<Record<string, unknown>>(`/requirement-drafts/${encodeURIComponent(draftId)}/reject`, { 167 method: 'POST', 168 ...body({ reason }), 169 }), 170} 171