Expand description
Runtime-neutral capability contracts.
Capabilities are deliberately smaller than a client implementation. They do not know about conversion, routing, credentials, persistence engines, or a common content representation. A host supplies the opaque target/scope types and enforces the limits returned by each capability instance.
Structs§
- Capability
Error - A structured capability error that retains the originating error when one
exists. HTTP status responses are not represented by this type: an upstream
HTTP non-2xx response is still a successful
sendresult and retains its complete response body. - Capability
Limits - The limits a capability instance is required to enforce.
- Published
Resource - The handle and reference returned by a successful publication.
- Resource
Metadata - File-only metadata exposed by resource access. A filename is retained across upload and read so adapters can preserve the source file’s identity.
- Resource
Read - A resource body and its metadata.
- State
Entry - A state entry returned by a store read.
- State
Write - Replacement data for a state CAS.
Nonereplacement means delete. - Version
- An opaque, host-generated state version. Versions must never be reused, including after delete and recreate.
Enums§
- Capability
Error Kind - A stable category for a capability failure.
- Capability
Error Stage - Whether an error occurred before or during transfer.
- CasResult
- The outcome of a scoped compare-and-exchange.
- Publication
Kind - The representation requested for a newly published resource. If the host cannot provide the requested form, it must reject before consuming the body or causing any remote side effect.
- Publication
Status - The durable status of an idempotent publication operation.
- Resource
Reference - A resource locator understood by the host boundary. An
Idis interpreted using the associated scope’s upstream and identity; aUrlremains subject to host authorization. Neither form grants deletion authority. - Upstream
Connection - The result of a WebSocket-capable upstream connect attempt.
Traits§
- Resource
Access - Scoped resource publication and access.
- State
Store - An atomically scoped state store.
- Upstream
- The upstream transport family.
Type Aliases§
- Capability
Future - A boxed capability operation future.