Skip to content
WarmHub

PartialStreamSubmissionError

Error raised when a streamed commit submission fails after an ambiguous or partial append.

completedReceipts contains only earlier, acknowledged event receipts. The other identity fields name the one pending chunk that must be looked up before any manual retry. acknowledgedOperationCount preserves progress even if a receipt omits operation rows. attemptedAppendOutcome and lastAcknowledgedRepoSeq retain recovery information from the earlier stream contract; the durable receipt remains the authoritative record.

See

Section titled “See”

https://docs.warmhub.ai/sdk/transient-retry/#partial-submissions

Extends

Section titled “Extends”
  • Error

Constructors

Section titled “Constructors”

Constructor

Section titled “Constructor”

new PartialStreamSubmissionError(input): PartialStreamSubmissionError

Parameters

Section titled “Parameters”
input
Section titled “input”
cause
Section titled “cause”

unknown

completedReceipts
Section titled “completedReceipts”

readonly OperationEventReceipt[]

completedOperations?
Section titled “completedOperations?”

CommitRealOperationResult[]

acknowledgedOperationCount?
Section titled “acknowledgedOperationCount?”

number

lastAcknowledgedRepoSeq?
Section titled “lastAcknowledgedRepoSeq?”

number

attemptedAppendOutcome
Section titled “attemptedAppendOutcome”

"unknown" | "not_applied"

submissionId
Section titled “submissionId”

string

eventRequestId
Section titled “eventRequestId”

string

chunkOrdinal
Section titled “chunkOrdinal”

number

pendingOutcome
Section titled “pendingOutcome”

"unknown" | "absent"

Returns

Section titled “Returns”

PartialStreamSubmissionError

Overrides

Section titled “Overrides”

Error.constructor

Properties

Section titled “Properties”

code

Section titled “code”

readonly code: "PARTIAL_STREAM_SUBMISSION" = 'PARTIAL_STREAM_SUBMISSION'

Stable error code. Always 'PARTIAL_STREAM_SUBMISSION'.

completedReceipts

Section titled “completedReceipts”

readonly completedReceipts: readonly OperationEventReceipt[]

Earlier exact receipts, in submission order.

completedOperations

Section titled “completedOperations”

readonly completedOperations: CommitRealOperationResult[]

Legacy projection of operations confirmed before the failed append.

submissionId

Section titled “submissionId”

readonly submissionId: string

eventRequestId

Section titled “eventRequestId”

readonly eventRequestId: string

chunkOrdinal

Section titled “chunkOrdinal”

readonly chunkOrdinal: number

pendingOutcome

Section titled “pendingOutcome”

readonly pendingOutcome: "unknown" | "absent"

acknowledgedOperationCount

Section titled “acknowledgedOperationCount”

readonly acknowledgedOperationCount: number

Number of operations covered by acknowledged append responses.

lastAcknowledgedRepoSeq?

Section titled “lastAcknowledgedRepoSeq?”

readonly optional lastAcknowledgedRepoSeq?: number

Last repository sequence returned by an acknowledged chunk that persisted an event. This is a lower bound for known completed work, never evidence that the attempted append did not land.

attemptedAppendOutcome

Section titled “attemptedAppendOutcome”

readonly attemptedAppendOutcome: "unknown" | "not_applied"

Authoritative outcome of the attempted append. not_applied is used only when the SDK received explicit server rejection evidence; unknown means callers must stop writes and reconcile from a later verified checkpoint.

cause

Section titled “cause”

readonly cause: unknown

Underlying error that triggered the partial submission, preserved for diagnostics. Do not infer append outcome from this field; branch on attemptedAppendOutcome instead.

Overrides

Section titled “Overrides”

Error.cause