Interface ProposalRefinementTransaction<TProposal>

interface ProposalRefinementTransaction<
    TProposal extends CanonicalProposal = CanonicalProposal,
> {
    stage(proposals: readonly TProposal[]): MaybePromise<void>;
    commit(): MaybePromise<void>;
    rollback(): MaybePromise<void>;
}

Type Parameters

TProposal extends CanonicalProposal = CanonicalProposal

Index

Methods

stage commit rollback

Methods

stage

stage(proposals: readonly TProposal[]): MaybePromise<void>
Stage immutable successors; implementations MUST NOT expose them before commit and MUST insert them as new records (never upsert/overwrite).
Parameters
- proposals: readonly TProposal[]
Returns MaybePromise<void>
- Defined in src/lib/negotiation/seller.ts:74

commit

commit(): MaybePromise<void>
Commit every staged successor atomically after comparing every source version supplied to begin. A mismatch MUST abort the whole batch.

For finalize, the store MUST also reject an existing unexpired active hold and atomically record the staged committed successor as the source's new active_hold. Merely incrementing the source version is insufficient: a later request can read that new version and otherwise mint a second hold. Source proposal contents remain immutable.

Returns MaybePromise<void>
- Defined in src/lib/negotiation/seller.ts:85

rollback

rollback(): MaybePromise<void>
Restore the exact pre-batch state. Safe to call after any failed stage/commit.

Returns MaybePromise<void>
- Defined in src/lib/negotiation/seller.ts:87