Class SagaTimerRecoveryJournal
Owns the original encoded timer intents persisted with ordinary saga state and dedup.
public sealed class SagaTimerRecoveryJournal
- Inheritance
-
SagaTimerRecoveryJournal
- Inherited Members
- Extension Methods
Remarks
EncodedIntents is a versioned strict frame containing ordered action, original timeout ID, type, saga routing type, owned payload bytes, due/scheduled UTC instants. No delegates/runtime objects. The coordinator and receiver must validate the full frame/count/length/UTF-16 identity guards before Save/apply respectively. Providers impose the same reviewed configured payload limits; a caller's claimed limit never grants authority. No silent truncation or partial batch acceptance.
Constructors
SagaTimerRecoveryJournal(SagaScopeIdentity, Guid, long, Guid, Guid, long, int, byte[])
Restores or creates an owned original intent journal.
public SagaTimerRecoveryJournal(SagaScopeIdentity scope, Guid incarnationId, long sequence, Guid batchId, Guid expectedFence, long observedRevision, int encodingVersion, byte[] encodedIntents)
Parameters
scopeSagaScopeIdentityExact scope of the committed state.
incarnationIdGuidNonempty identity persisted across that state's lifetime.
sequencelongStrictly positive next journal sequence for the incarnation.
batchIdGuidStable nonempty batch identity, never replaced on ambiguous retry.
expectedFenceGuidReceiver observation obtained before authoritative state load.
observedRevisionlongReceiver revision captured with the expected fence before state load.
encodingVersionintExact supported intent frame version.
encodedIntentsbyte[]Complete primitive intent frame, copied on input and output.
Properties
BatchId
Gets the original immutable batch identity.
public Guid BatchId { get; }
Property Value
EncodedIntents
Gets a fresh copy of the complete original timer intents.
public byte[] EncodedIntents { get; }
Property Value
- byte[]
EncodingVersion
Gets the supported primitive frame version.
public int EncodingVersion { get; }
Property Value
ExpectedFence
Gets the expected receiver token; authority rebindinging requires a new guarded state CAS.
public Guid ExpectedFence { get; }
Property Value
IncarnationId
Gets the persisted state incarnation.
public Guid IncarnationId { get; }
Property Value
ObservedRevision
Gets the captured cancellation/retirement revision; never advanced during retry.
public long ObservedRevision { get; }
Property Value
Scope
Gets the exact authoritative state scope.
public SagaScopeIdentity Scope { get; }
Property Value
Sequence
Gets the original monotone batch sequence.
public long Sequence { get; }
Property Value
Methods
GetAuthorityDigest()
Gets an owned digest of the exact immutable journal header and intent frame for state CAS.
public byte[] GetAuthorityDigest()
Returns
- byte[]
Remarks
Versioned length framing preserves ordinal UTF-16 identities, including code units; this is journal equality metadata, not a signature or a replacement for provider authority.
GetDomain()
Returns the timer authority domain without introducing a state-type partition.
public SagaTimerRecoveryDomain GetDomain()
Returns
GetIntentDigest()
Gets a fresh payload digest; receiver receipt additionally binds all immutable header fields.
public byte[] GetIntentDigest()
Returns
- byte[]