Crate solari_browser

Expand description

§solari-browser

Rust binding for the Solari Browser platform — the control plane: acquire and release pooled stealth Chromium sessions, manage stored browser profiles, pull session replays, and inspect managed-proxy egress. It speaks the same wire contract as the reference @solarisdk/browser TypeScript package (sdk/src/index.ts).

use solari_browser::{Client, ClientOptions, CreateSessionOptions, ProxySpec};

let client = Client::new(ClientOptions::default_region("slr_live_…"))?;

let session = client
    .sessions()
    .create(
        CreateSessionOptions::new()
            .stealth(true)
            .proxy(ProxySpec::country("us")),
    )
    .await?;

println!("ws  {}", session.ws_endpoint);   // Playwright wire protocol
println!("cdp {}", session.cdp_endpoint);  // raw CDP — use this from Rust

client.sessions().release(&session.id).await?;

§Scope

This crate is the control plane plus browser attachment. Playwright has no Rust binding, so there is no port of the TypeScript BrowserSession Playwright object model; instead, with the connect feature enabled you get two levels of attachment, both driving the session over raw CDP via chromiumoxide:

[connect] — attach to a session you already created; and
[Client::launch] — a thin one-call convenience (create, connect, seed an attached profile’s cookies, health-probe, retry, and release on close) that hands back the same [chromiumoxide::Browser] to drive.

Enable it with:

solari-browser = { version = "0.2", features = ["connect"] }

§Endpoints vs. the TypeScript SDK

The TS SDK routes wsEndpoint / cdpEndpoint through a Node-side loopback LocalProxy. This crate has no such indirection: Session::ws_endpoint and Session::cdp_endpoint are the upstream gateway endpoints.

Structs§

ApiErrorBody: Shape the API’s error bodies may take. Every field is optional — an error body is best-effort and may not be JSON at all.
Client: Talks the Solari Browser control-plane REST API.
ClientOptions: Options for constructing a Client.
Cookie: One cookie in a StorageState.
CreateSessionOptions: Options accepted by POST /sessions.
EditorState: Result of ProfileEditor::status.
ListSessionsOptions: Filters and paging for Sessions::list. The default lists the first page.
LocalStorageEntry: One localStorage key/value pair.
Profile: A stored browser profile (cookies + localStorage).
ProfileEditor: A handle on an open profile editor. Send the person to url; it works until expires_at. There is no save without closing: save_and_close stores the profile and ends the editor, exit ends it without saving.
ProfileSaveResult: Result of POST /profiles/:id/save.
Profiles: The profiles namespace. Obtain via Client::profiles.
Proxy: The proxy namespace. Obtain via Client::proxy.
ProxyCountries: GET /proxy/countries — supported egress countries, plus whether the gateway actually has residential credentials configured.
ProxyRequest: Managed proxy egress request.
ReplayUrl: Presigned URL for a session’s replay.
ResolvedProxyConfig: Coarse confirmation of the proxy the gateway resolved for a session.
Session: A live browser session.
SessionList: One page of Sessions::list.
SessionSummary: One row of Sessions::list. It never carries the websocket endpoints (they are bearer capabilities): use Sessions::get.
SessionView: GET /sessions/:id. Fields the gateway adds later land in SessionView::extra.
Sessions: The sessions namespace. Obtain via Client::sessions.
StorageOrigin: One origin’s localStorage in a StorageState.
StorageState: A browser profile’s persisted state — Playwright’s storageState shape. Unknown keys round-trip through StorageState::extra.

Enums§

EditorStatus: State of a profile editor.
ProxySpec: What to send as the proxy field of POST /sessions.
ProxyTier: Managed proxy tier.
SameSite: Cookie sameSite policy, as Playwright spells it.
SolariError: Every error raised by this crate.
SolariErrorCode: Machine-readable error codes the API returns in a { "code": … } body.
SolariRegion: Supported Solari regions. More coming soon.