public-receipts.ts (2701B)
1 import { 2 publicRecordSnapshot, 3 publicRecordWire, 4 type PublicRecordHandle 5 } from './records.ts'; 6 import { 7 preparePublicReceiptTransition, 8 publicTransitionSnapshot 9 } from './artifact-records.ts'; 10 import { 11 publicPublicationOwner, 12 publicPublicationQuotaRepository, 13 readPublicListingIntent, 14 type PublicPublicationRepository 15 } from './public-publications.ts'; 16 import { 17 commitPublicOperationTransition, 18 observePublicOperationTransition 19 } from './quota.ts'; 20 export type PublicListingReceiptResult = 21 | Readonly<{ status: 'saved'; record: PublicRecordHandle }> 22 | Readonly<{ status: 'invalid' | 'conflict' | 'unknown' | 'unavailable' }>; 23 // Exact full-wire CAS append. A request success or detached cached observation 24 // cannot acknowledge a receipt. Unknown native commits retain original payload. 25 export async function commitPublicListingReceipt( 26 repository: PublicPublicationRepository, 27 record: PublicRecordHandle, 28 command: string, 29 receiptWire: string 30 ): Promise<PublicListingReceiptResult> { 31 try { 32 const owner = publicPublicationOwner(repository), 33 quota = publicPublicationQuotaRepository(repository); 34 const row = owner 35 ? publicRecordSnapshot(record, owner, command) 36 : undefined; 37 if ( 38 !owner || 39 !quota || 40 row?.family !== 'public_operation' || 41 !( 42 row.capture.kind === 30402 || 43 (row.capture.kind === 5 && row.source.type === 'public_head') 44 ) || 45 !row.artifact 46 ) 47 return { status: 'invalid' }; 48 const transition = preparePublicReceiptTransition( 49 record, 50 owner, 51 command, 52 receiptWire 53 ); 54 if (!transition.ok) return { status: 'invalid' }; 55 const expected = publicTransitionSnapshot(transition.value, owner, command); 56 if (!expected) return { status: 'invalid' }; 57 const saved = await commitPublicOperationTransition( 58 quota, 59 transition.value 60 ); 61 if (!saved.ok) { 62 if (saved.reason !== 'unknown_completion') 63 return { 64 status: saved.reason === 'conflict' ? 'conflict' : 'unavailable' 65 }; 66 const observed = await observePublicOperationTransition( 67 quota, 68 transition.value 69 ); 70 if (observed.state !== 'committed') 71 return { 72 status: observed.state === 'conflict' ? 'conflict' : 'unknown' 73 }; 74 } 75 const read = await readPublicListingIntent(repository, command); 76 if (read.status !== 'found') return { status: 'unknown' }; 77 if (publicRecordWire(read.record, owner, command) !== expected.nextWire) 78 return { status: 'conflict' }; 79 return { status: 'saved', record: read.record }; 80 } catch { 81 return { status: 'unknown' }; 82 } 83 }