app

Local-first trade for farms and co-ops
git clone https://radroots.dev/git/app.git
Log | Files | Refs | README | LICENSE

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 }