Struct Config 

pub struct Config {
    pub api_key: String,
    pub api_url: String,
    pub sailbox_api_url: String,
    pub imagebuilder_url: String,
    pub sailbox_ingress_url: String,
    pub sailbox_ingress_mode: String,
}

Resolved SDK configuration: credentials plus the three service endpoints.

Fields

api_key: String

Bearer API key sent on every request (trimmed of surrounding whitespace).

api_url: String

Base URL of the public Sail REST API (no trailing path).

sailbox_api_url: String

Base URL of the sailbox lifecycle/exec API.

imagebuilder_url: String

host:port target of the imagebuilder dispatcher gRPC service.

sailbox_ingress_url: String

Base URL the platform edge serves listener ingress from.

sailbox_ingress_mode: String

How listener URLs are addressed under the ingress base: "wildcard" (per-listener subdomain, deployed) or "path" (one host, local stacks).

Implementations

impl Config

pub fn resolve( mode: Option<&str>, api_key: String, api_url: Option<String>, sailbox_api_url: Option<String>, imagebuilder_url: Option<String>, sailbox_ingress_url: Option<String>, ) -> Result<Config, SailError>

Resolve a config from a mode plus explicit overrides. mode selects the endpoint defaults (empty/None means prod); any non-empty override wins over its default. The API key is required and trimmed.

pub fn from_env() -> Result<Config, SailError>

Resolve a config from the environment, falling back to the stored ~/.sail credential and settings for any value the environment does not set. Environment variables always win. The stored API key is applied only when its tagged target matches the resolved one, so a key minted for one environment is never sent to another. The key is trimmed so one sourced with a trailing newline can’t produce a malformed bearer token.

pub fn from_env_optional_api_key() -> Result<Config, SailError>

Like from_env but does not require an API key, for telemetry that degrades to a no-op when unauthenticated. Endpoints still resolve from the environment and ~/.sail.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.