pub struct Tx<'a> { /* private fields */ }Expand description
The transaction of one Session commit callback. Table reads fail with SessionError::ReadAfterWrite after the
first table write; document access stays available.
Implementations§
Source§impl<'a> Tx<'a>
impl<'a> Tx<'a>
Sourcepub fn committed<T>(
&mut self,
read: impl FnOnce(&dyn Storage) -> Result<T>,
) -> Result<T, SessionError>
pub fn committed<T>( &mut self, read: impl FnOnce(&dyn Storage) -> Result<T>, ) -> Result<T, SessionError>
A read of committed Storage that ignores the read-after-write rule: the conversation runtime and the task
scheduler (crates/harness) read inside their own commit callbacks, as upstream’s read Storage directly.
Sourcepub fn staged_tasks(&self) -> Vec<TaskRecord>
pub fn staged_tasks(&self) -> Vec<TaskRecord>
Latest candidate of every task this transaction created or replaced, in first-write order.
Sourcepub fn staged_conversations(&self) -> Vec<ConversationRecord>
pub fn staged_conversations(&self) -> Vec<ConversationRecord>
Every conversation this transaction created or forked, in order.
Sourcepub fn create_root_conversation(
&mut self,
) -> Result<ConversationRecord, SessionError>
pub fn create_root_conversation( &mut self, ) -> Result<ConversationRecord, SessionError>
Create the ownerless root conversation at its reserved ID.
pub fn conversation( &mut self, id: ConversationId, ) -> Result<Option<ConversationRecord>, SessionError>
pub fn entry( &mut self, id: EntryId, ) -> Result<Option<EntryRecord>, SessionError>
Sourcepub fn entry_of(
&mut self,
kind: &str,
id: EntryId,
) -> Result<Option<EntryRecord>, SessionError>
pub fn entry_of( &mut self, kind: &str, id: EntryId, ) -> Result<Option<EntryRecord>, SessionError>
None when the entry is absent or has another kind.
pub fn task(&mut self, id: TaskId) -> Result<Option<TaskRecord>, SessionError>
pub fn scan_conversations( &mut self, query: &ConversationQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<ConversationRecord>, SessionError>
pub fn scan_entries( &mut self, query: &EntryQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<EntryRecord>, SessionError>
Sourcepub fn latest_head_marker(
&mut self,
conversation_id: ConversationId,
) -> Result<Option<EntryRecord>, SessionError>
pub fn latest_head_marker( &mut self, conversation_id: ConversationId, ) -> Result<Option<EntryRecord>, SessionError>
Newest visible entry of the conversation that carries a head.
pub fn scan_tasks( &mut self, query: &TaskQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<TaskRecord>, SessionError>
pub fn submission( &mut self, id: SubmissionId, ) -> Result<Option<SubmissionRecord>, SessionError>
Sourcepub fn submission_by_request(
&mut self,
conversation_id: ConversationId,
request_id: &str,
) -> Result<Option<SubmissionRecord>, SessionError>
pub fn submission_by_request( &mut self, conversation_id: ConversationId, request_id: &str, ) -> Result<Option<SubmissionRecord>, SessionError>
Committed submission with a conversation-scoped request ID, for host deduplication.
pub fn create_conversation( &mut self, ownership: ConversationOwnership, ) -> Result<ConversationRecord, SessionError>
Sourcepub fn fork_conversation(
&mut self,
parent: ConversationId,
at: EntryId,
ownership: ConversationOwnership,
) -> Result<ConversationRecord, SessionError>
pub fn fork_conversation( &mut self, parent: ConversationId, at: EntryId, ownership: ConversationOwnership, ) -> Result<ConversationRecord, SessionError>
Fork history at one visible entry; conversation documents are copied by their fork policy.
Sourcepub fn append_entry(
&mut self,
conversation_id: ConversationId,
draft: EntryDraft,
) -> Result<EntryRecord, SessionError>
pub fn append_entry( &mut self, conversation_id: ConversationId, draft: EntryDraft, ) -> Result<EntryRecord, SessionError>
Append an entry; head: SelfId starts the active context at the new entry.
pub fn create_task( &mut self, task: &TaskDefinition, input: Value, options: TaskOptions, ) -> Result<TaskId, SessionError>
Sourcepub fn create_submission(
&mut self,
create: SubmissionCreate,
) -> Result<SubmissionRecord, SessionError>
pub fn create_submission( &mut self, create: SubmissionCreate, ) -> Result<SubmissionRecord, SessionError>
Create a raw submission record with a fresh ID. No admission rules apply.
Sourcepub fn settle_submission(
&mut self,
id: SubmissionId,
settlement: SubmissionSettlement,
)
pub fn settle_submission( &mut self, id: SubmissionId, settlement: SubmissionSettlement, )
Settle a queued or placed submission; resolved during assembly against this transaction’s latest record.
Sourcepub fn place_submission(&mut self, id: SubmissionId, entry: EntryId)
pub fn place_submission(&mut self, id: SubmissionId, entry: EntryId)
Place a queued submission at entry: an input becomes placed, a write done.
Sourcepub fn set_task(&mut self, value: TaskRecord) -> Result<(), SessionError>
pub fn set_task(&mut self, value: TaskRecord) -> Result<(), SessionError>
Replace one task record completely, stamping startedAt on its first change to running and endedAt on the
change to terminal.