Expand description
Provider-neutral blocking and asynchronous transport contracts.
Structs§
- Acknowledged
Custom Endpoint - Custom endpoint paired with an explicit operator acknowledgement.
- 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
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.
- 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§
- 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.
- Structured
Query Error - Structured query validation error.
- Trailer
Policy - Response trailer handling.
Constants§
- 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.
- 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 asynchronous raw HTTP execution.
- Async
Transport - Asynchronous transport over caller-owned request and response buffers.
- Blocking
RawHttp Executor - Blocking execution of one already validated raw HTTP request.
- Blocking
Transport - Synchronous transport over caller-owned request and response buffers.
- Bound
Transport - Transport whose credentials are permanently bound to one endpoint.
- Response
Storage Sanitizer - Optional additive cleanup hook for caller-owned response storage.