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 OperationEventReceiptV1[]

completedOperations?
Section titled “completedOperations?”

object[]

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 OperationEventReceiptV1[]

Earlier exact receipts, in submission order.

completedOperations

Section titled “completedOperations”

readonly completedOperations: object[]

Legacy projection of operations confirmed before the failed append.

opIndex?

Section titled “opIndex?”

optional opIndex?: number

name

Section titled “name”

name: string

operation

Section titled “operation”

operation: unknown

dataHash

Section titled “dataHash”

dataHash: string

version

Section titled “version”

version: number

status?

Section titled “status?”

optional status?: "error" | "noop" | "applied"

error?

Section titled “error?”

optional error?: object

error.code
Section titled “error.code”

code: string

error.message
Section titled “error.message”

message: string

error.details?
Section titled “error.details?”

optional details?: { reason: "expected_version_mismatch"; expectedVersion: number; currentVersion: number; } | { reason: "lease_held"; leaseExpiresAt: string; } | { reason: "validation_failed"; issues: object[]; } | { reason: "rate_limit_reset"; retryAfterSeconds: number; resetAt: string; } | { reason: "cursor_fence_unavailable"; cause: "not_ready" | "below_floor" | "above_head"; retryFromStart: true; }

submittedName?

Section titled “submittedName?”

optional submittedName?: string

resolvedName?

Section titled “resolvedName?”

optional resolvedName?: string

retryable?

Section titled “retryable?”

optional retryable?: boolean

warnings?

Section titled “warnings?”

optional warnings?: object

warnings.undeclaredFields?
Section titled “warnings.undeclaredFields?”

optional undeclaredFields?: string[]

warnings.undeclaredFieldsTruncated?
Section titled “warnings.undeclaredFieldsTruncated?”

optional undeclaredFieldsTruncated?: true

warnings.totalUndeclared?
Section titled “warnings.totalUndeclared?”

optional totalUndeclared?: number

warnings.coalescedWrefs?
Section titled “warnings.coalescedWrefs?”

optional coalescedWrefs?: object[]

warnings.coalescedWrefsTruncated?
Section titled “warnings.coalescedWrefsTruncated?”

optional coalescedWrefsTruncated?: true

warnings.totalCoalescedWrefs?
Section titled “warnings.totalCoalescedWrefs?”

optional totalCoalescedWrefs?: number

warnings.deprecations?
Section titled “warnings.deprecations?”

optional deprecations?: object[]

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