Expand description
Provider-neutral blocking and asynchronous transport contracts.
Structs§
- Acknowledged
Custom Endpoint - Custom endpoint paired with an explicit operator acknowledgement.
- Async
Response Staging - Non-committing response view supplied to an asynchronous transport.
- Canonical
Query - Validated RFC 3986-style query with
%20space encoding. - Content
Type - Borrowed, validated HTTP content type.
- Custom
Endpoint Acknowledgement - Explicit acknowledgement that a custom endpoint is a credential destination.
- Endpoint
Identity - Borrowed normalized identity of a credential-bound transport endpoint.
- Form
Query - Explicit provider dialect that admits
+for encoded spaces. - Header
Name - Borrowed, validated HTTP header name.
- Header
Value - Borrowed, validated request header value.
- Informational
Response Tracker - Small state machine for bounded informational-response handling.
- Media
Type - Borrowed media-type essence used by response policies.
- Provider
Link Query - Raw query state admitted only through a validated provider pagination link.
- Query
Pair - One encoded query pair, preserving missing versus empty values.
- Query
Pairs - Exact-order iterator over encoded query pairs.
- RawResponse
Policy - Complete provider-neutral admission policy for one final HTTP response.
- Region
Endpoint - Provider-derived endpoint paired with its canonical region identifier.
- Request
Header - One validated borrowed request header.
- Request
Headers - Validated ordered request-header block.
- Request
Path - Validated canonical origin-form path.
- Request
Target - Validated complete origin-form HTTP request target.
- Response
Attempt - Cleanup-owning transaction around one response write attempt.
- Response
Buffer - Cleanup-owning admission guard around one sealed
ResponseWriter. - Response
Completion - Completion metadata returned by an asynchronous transport.
- Response
Content Type - Borrowed, validated content type captured in stable response-header storage.
- Response
Decode Workspace - Complete fixed response workspace cleared with its checked guard.
- Response
Header - Borrowed view into one retained response header.
- Response
Headers - Caller-storage-backed fixed-capacity response-header metadata.
- Response
Metadata - Non-sensitive interpreted response metadata captured by a transport.
- Response
Writer - Exclusive transport access to one admitted caller-owned response prefix.
- Retained
Response Metadata - Request identifier deliberately retained beyond a checked response guard.
- Status
Code - Valid HTTP response status code.
- Stream
Attempt - SDK-owned accounting attempt over caller-owned outcome state.
- Stream
Completion - Successful accounting completion.
- Stream
Limits - Hard byte, chunk, observation, and zero-progress limits.
- Stream
Outcome - Attempt outcome stored in caller-owned state.
- Stream
Policy - Complete stream behavior fixed before the first observation.
- Stream
Progress - Public nonsensitive streaming counters.
- Stream
Source Id - Exact source version supplied by the source owner.
- Transport
Failure - Payload-redacting transport failure with an explicit delivery phase.
- Transport
Request - Provider-neutral request passed to a blocking transport.
- Transport
Response - Borrowed view committed from an admitted writer.
Enums§
- Async
Execution Error - Failure while SDK-owned asynchronous response staging is driven to completion.
- Content
Type Error - Content-type validation error.
- Delivery
Phase - Furthest delivery point known for one failed HTTP attempt.
- Endpoint
Identity Error - Endpoint identity validation error.
- Endpoint
Policy - Allocation-free provider-owned endpoint admission policy.
- Endpoint
Policy Error - Endpoint trust policy validation or matching error.
- Endpoint
Policy Kind - Trust provenance represented by an
EndpointPolicy. - Endpoint
Scheme - Network scheme in an immutable endpoint identity.
- Header
Error - Bounded HTTP header validation or capacity failure.
- Header
Sensitivity - Whether a header value must be treated as sensitive.
- Informational
Response Error - Informational or final-response selection failure.
- RawResponse
Policy Error - Invalid raw response-wire policy.
- Request
Path Error - Canonical path validation error.
- Request
Query - Explicit request query state.
- Request
Target Error - Request-target validation or assembly error.
- Response
Media Policy - Response media-type requirement for one status class.
- Response
Writer Error - Response-writer state violation.
- Retained
Metadata Error - Request-identifier admission or transfer failure.
- Stream
Execution Error - One bounded stream execution failure.
- Stream
Framing - Wire framing responsibility.
- Stream
Kind - Streaming operation shape.
- Stream
Limits Error - Invalid hard streaming limits.
- Stream
Partial State - Visibility and cleanup requirement after incomplete transfer.
- Stream
Policy Error - Incoherent stream policy.
- Stream
Progress Error - Stream accounting or lifecycle failure.
- Stream
Read - One source observation.
- Stream
Replay Error - Streaming replay rejection.
- Stream
Replayability - Whether a streaming body can be reproduced for another attempt.
- Stream
Sink Mode - Visibility of accepted bytes before successful completion.
- Stream
Source IdError - Invalid source identity.
- Stream
State - Final lifecycle state recorded even when an asynchronous attempt is dropped.
- Structured
Query Error - Structured query validation error.
- Trailer
Policy - Response trailer handling.
Constants§
- ASYNC_
CANCELLATION_ DELIVERY_ PHASE - Conservative delivery classification after an asynchronous future is cancelled by being dropped.
- MAX_
CONSECUTIVE_ ZERO_ PROGRESS - Global ceiling for consecutive observations that transfer no bytes.
- MAX_
CONTENT_ TYPE_ BYTES - Maximum content-type header value length admitted by the core contract.
- MAX_
ENDPOINT_ BASE_ PATH_ BYTES - Maximum normalized endpoint base-path length admitted by the core contract.
- MAX_
ENDPOINT_ HOST_ BYTES - Maximum normalized endpoint host length admitted by the core contract.
- MAX_
ENDPOINT_ REGION_ BYTES - Maximum provider region identifier length.
- MAX_
HEADER_ NAME_ BYTES - Maximum header-name length admitted by the transport contract.
- MAX_
HEADER_ VALUE_ BYTES - Maximum single header-value length admitted by the transport contract.
- MAX_
INFORMATIONAL_ RESPONSES - Maximum informational response heads accepted before a final response.
- MAX_
OFFICIAL_ ENDPOINTS - Maximum identities in one finite official endpoint set.
- MAX_
RAW_ RESPONSE_ BODY_ BYTES - Maximum per-class body limit represented by the raw buffered contract.
- MAX_
REQUEST_ HEADERS - Maximum number of request headers.
- MAX_
REQUEST_ HEADER_ BYTES - Maximum encoded request-header bytes, excluding the final empty line.
- MAX_
REQUEST_ ID_ BYTES - Maximum opaque provider request-identifier length.
- MAX_
REQUEST_ TARGET_ BYTES - Maximum origin-form request-target length admitted by the core contract.
- MAX_
RESPONSE_ CHUNKS - Maximum chunks admitted by one buffered raw response.
- MAX_
RESPONSE_ HEADERS - Maximum number of retained response headers.
- MAX_
RESPONSE_ HEADER_ BYTES - Maximum encoded response-header bytes, excluding the final empty line.
- MAX_
STREAM_ BYTES - Global ceiling for one stream’s actual transferred bytes.
- MAX_
STREAM_ CHUNKS - Global ceiling for chunks observed in one stream attempt.
- MAX_
STREAM_ CHUNK_ BYTES - Global ceiling for one source chunk.
- MAX_
STREAM_ OBSERVATIONS - Global ceiling for source, sink, and waiting observations in one attempt.
- MAX_
STREAM_ SOURCE_ ID_ BYTES - Maximum exact source-version identity length.
- RESPONSE_
CURSOR_ SCRATCH_ BYTES - Cursor staging bytes available to checked pagination decoders.
- RESPONSE_
DECODER_ SCRATCH_ BYTES - Decoder scratch bytes available to checked provider decoders.
- RESPONSE_
PROVIDER_ LINK_ SCRATCH_ BYTES - Provider-link staging bytes available to checked pagination decoders.
Traits§
- Async
RawHttp Executor - Runtime-neutral Send asynchronous raw HTTP execution.
- Async
Stream Sink - Cross-thread asynchronous sink.
- Async
Stream Source - Cross-thread asynchronous source.
- Async
Transport - Cross-thread asynchronous transport over caller-owned buffers.
- Blocking
RawHttp Executor - Blocking execution of one already validated raw HTTP request.
- Blocking
Stream Sink - Blocking sink with explicit commit and infallible abort cleanup.
- Blocking
Stream Source - Blocking source that initializes caller-owned scratch storage.
- Blocking
Transport - Synchronous transport over caller-owned request and response buffers.
- Bound
Transport - Transport whose credentials are permanently bound to one endpoint.
- Delivery
Classified - Error whose furthest possible request-delivery phase is explicit.
- Local
Async RawHttp Executor - Runtime-neutral raw HTTP execution for
!Sendlocal futures. - Local
Async Stream Sink - Local asynchronous sink whose futures may be
!Send. - Local
Async Stream Source - Local asynchronous source whose future may be
!Send. - Local
Async Transport - Local asynchronous transport for
!Sendfutures and executors. - Response
Storage Sanitizer - Optional additive cleanup hook for caller-owned response storage.
Functions§
- drive_
async - Drives one cross-thread async attempt and commits only after
Ready(Ok). - drive_
async_ raw - Drives one raw cross-thread async attempt and commits after
Ready(Ok). - drive_
async_ stream - Drives one cross-thread asynchronous transfer without owning an executor.
- drive_
blocking_ stream - Drives one finite blocking transfer with caller-owned scratch storage.
- drive_
local - Drives one local transport attempt and commits only after
Ready(Ok). - drive_
local_ raw - Drives one raw local attempt and commits only after
Ready(Ok). - drive_
local_ stream - Drives one local asynchronous transfer without owning an executor.
- validate_
stream_ replay - Validates that a later attempt uses the same explicit replayable source.