Expand description
Shared transport and auth for Sylphx Platform Rust SDKs.
Wire payloads are owned by sylphx-api-types (Protobuf). This crate only maps
HTTP status + JSON error envelopes onto typed errors and applies auth.
Re-exports§
pub use project_binding::BindingAdmissionError;pub use project_binding::BindingDispatchError;pub use project_binding::CurrentBindingAuthority;pub use project_binding::CurrentBindingHead;pub use project_binding::PlatformBindingVerifier;pub use project_binding::ProjectBindingAdmission;pub use project_binding::CLOCK_SKEW_SECONDS;pub use project_binding::MAX_BINDING_LIFETIME_SECONDS;pub use project_binding::PLATFORM_ISSUER;pub use project_binding::PROJECT_BINDING_ALGORITHM;pub use project_binding::PROJECT_BINDING_HEADER;pub use project_binding::PROJECT_BINDING_TYPE;
Modules§
- project_
binding - Platform-owned signed project-binding admission for downstream services. Platform project-binding admission for downstream HTTP and Connect calls.
Structs§
- Build
Connection UrlInput - Connection URL SSOT (ADR-123 dual-oracle of
@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Input forbuild_connection_url. - Parsed
Connection Url - Connection URL SSOT (ADR-123 dual-oracle of
@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Parsed Sylphx connection URL components (dual-oracle ofParsedConnectionUrl). - Retry
Config - Retry policy for transient failures.
- Transport
- Production HTTP transport.
- Transport
Config - Shared HTTP client configuration for one plane endpoint.
- Verified
Binding Context - Re-export contract identity for consumers and CLI evidence. Immutable identity and scope proved by Platform binding admission.
Enums§
- Connection
Credential Type - Connection URL SSOT (ADR-123 dual-oracle of
@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Credential kind — publishable (pk) or secret (sk). - Connection
Env - Connection URL SSOT (ADR-123 dual-oracle of
@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Target environment encoded in the credential. - Credential
- Credential material for a plane.
- SdkError
- SDK-level errors.
- Verified
Binding Context Error - Re-export contract identity for consumers and CLI evidence. Failure to construct a verified-binding context from incomplete claims.
Constants§
- API_
TYPES_ CONTRACT_ PACKAGE - Re-export contract identity for consumers and CLI evidence. Schema identity for publish/admission evidence.
- API_
TYPES_ CONTRACT_ REVISION - Re-export contract identity for consumers and CLI evidence. Human-readable contract revision for this crate release.
- DEFAULT_
MANAGEMENT_ BASE_ URL - Default Management API base URL (includes
/v1). - PLATFORM_
CONSOLE_ SLUG - Customer Zero project slug (Console dogfood residual).
Matches packages/contract platform-identity
PLATFORM_CONSOLE_SLUG(ADR-089 §2.8.1 / ADR-3888). Identity / routing only — never an operator privilege grant (ADR-3418, ADR-3422). - VERIFIED_
BINDING_ CONTEXT_ REVISION - Re-export contract identity for consumers and CLI evidence. Canonical revision of the verified-binding request context contract.
- WIRE_
CONTRACT_ PACKAGE - Deprecated aliases — prefer API_TYPES_CONTRACT_*. Schema identity for publish/admission evidence.
- WIRE_
CONTRACT_ REVISION - Deprecated aliases — prefer API_TYPES_CONTRACT_*. Human-readable contract revision for this crate release.
Functions§
- auth_
header_ pair - Build Authorization / x-app-secret header pair for inspection/tests.
- baas_
base_ url - Build the BaaS plane base URL for a tenant slug.
- build_
connection_ url - Connection URL SSOT (ADR-123 dual-oracle of
@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Build a canonical Sylphx connection URL (dual-oracle ofbuildConnectionUrl). - normalize_
management_ base_ url - Normalize a Management API base URL so callers always hit
/v1. - parse_
connection_ url - Connection URL SSOT (ADR-123 dual-oracle of
@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Connection URL SSOT (ADR-123 dual-oracle of@sylphx/sdkconnection-url). Parse a Sylphx connection URL (dual-oracle ofparseConnectionUrl). - platform_
console_ baas_ base_ url - Customer Zero BaaS base URL (
…/v1) for operator device login dogfood. - strip_
json_ nulls - Remove JSON
nullvalues from objects (recursively).
Type Aliases§
- SdkEvent
Stream - Backpressure-aware typed Server-Sent Events response stream.