UploadFileState enum

Lifecycle state of a single file within an upload group.

queued -> requestingUrl -> uploading -> uploaded -> attached
   |           |              |
   |           +-- rejected <-+   (onFileError — not retryable; bytes freed)
   |                          |
   +- cancelled <-------------+-- failed  (onFileFailure — retryable -> queued;
                                           cancelled -> removed from group)
Inheritance
Available extensions

Values

queued → const UploadFileState

Accepted and waiting for a free concurrency slot.

requestingUrl → const UploadFileState

Requesting the pre-signed upload form from the chat-api.

uploading → const UploadFileState

Streaming bytes to storage.

uploaded → const UploadFileState

Bytes are on storage; the resulting attachment is held.

attached → const UploadFileState

Included in a sent MediaMessage (terminal, app-driven).

rejected → const UploadFileState

Rejected by validation or presign authorization — not retryable (reported via onFileError).

failed → const UploadFileState

Transfer failed (network/storage/stall/expired presign) — retryable (reported via onFileFailure).

cancelled → const UploadFileState

Cancelled and removed from the group.

Properties

hashCode → int
The hash code for this object.
no setterinherited
index → int
A numeric identifier for the enumerated value.
no setterinherited
isInFlight → bool

Available on UploadFileState, provided by the UploadFileStateX extension

Whether a file in this state still occupies the group's in-flight set (i.e. the group has not yet drained). onComplete fires only when no file remains in-flight.
no setter
isTerminal → bool

Available on UploadFileState, provided by the UploadFileStateX extension

Whether this is a terminal state (no further transitions without an explicit retry).
no setter
name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Constants

values → const List<UploadFileState>
A constant List of the values in this enum, in order of their declaration.