Table of Contents

Class SagaTimerRecoveryJournal

Namespace
Excalibur.Dispatch.Messaging
Assembly
Excalibur.Dispatch.Abstractions.dll

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

scope SagaScopeIdentity

Exact scope of the committed state.

incarnationId Guid

Nonempty identity persisted across that state's lifetime.

sequence long

Strictly positive next journal sequence for the incarnation.

batchId Guid

Stable nonempty batch identity, never replaced on ambiguous retry.

expectedFence Guid

Receiver observation obtained before authoritative state load.

observedRevision long

Receiver revision captured with the expected fence before state load.

encodingVersion int

Exact supported intent frame version.

encodedIntents byte[]

Complete primitive intent frame, copied on input and output.

Properties

BatchId

Gets the original immutable batch identity.

public Guid BatchId { get; }

Property Value

Guid

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

int

ExpectedFence

Gets the expected receiver token; authority rebindinging requires a new guarded state CAS.

public Guid ExpectedFence { get; }

Property Value

Guid

IncarnationId

Gets the persisted state incarnation.

public Guid IncarnationId { get; }

Property Value

Guid

ObservedRevision

Gets the captured cancellation/retirement revision; never advanced during retry.

public long ObservedRevision { get; }

Property Value

long

Scope

Gets the exact authoritative state scope.

public SagaScopeIdentity Scope { get; }

Property Value

SagaScopeIdentity

Sequence

Gets the original monotone batch sequence.

public long Sequence { get; }

Property Value

long

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

SagaTimerRecoveryDomain

GetIntentDigest()

Gets a fresh payload digest; receiver receipt additionally binds all immutable header fields.

public byte[] GetIntentDigest()

Returns

byte[]