Expand description
§bitemporal-runtime
Bitemporal truth primitives for append-supersede temporal data.
§Core concepts
- valid_time: When something is true in the domain (business time)
- recorded_time: When the system learned about it (system time)
- append-supersede: Updates never mutate; they append a new row and mark prior rows superseded
§Key types
BitemporalRecord<T>: A temporal record with valid_time, recorded_time, and valueSupersessionReceipt: Cryptographic receipt for every supersession event
§Functions
append_supersede: Insert a new record, mark prior records supersededas_of_query: Query records valid at a specific valid_time as of a specific recorded_timetemporal_snapshot: Retrieve full state as of a specific recorded_time
Structs§
- Bitemporal
Record - A bitemporal record.
- InMemory
Db - In-memory bitemporal store for testing and development.
- Supersession
Receipt - Receipt for a supersession event.
- Supersession
Target - Reference to the record that was superseded by a supersession event.
Enums§
- Bitemporal
Error - Errors produced by bitemporal-runtime operations.
Functions§
- append_
supersede - Append a new record and mark prior versions as superseded.
- as_
of_ query - Query records valid at a specific
valid_timeas of a specificrecorded_time. - temporal_
snapshot - Return full state as of a specific
recorded_time.
Type Aliases§
- Record
Id - A globally unique record identifier.