Struct Client 

pub struct Client { /* private fields */ }

A handle on one mdcast-server. Cheap to clone — the underlying reqwest::Client is a shared connection pool.

Implementations

impl Client

pub async fn check(&self, bundle: &AssetBundle) -> Result<Vec<Digest>>

Which of the bundle’s assets the server does not hold yet. An empty result means a render with this bundle will not stall on a 409. Never fetches a digest-only entry’s bytes — only its stored digest.

pub async fn upload( &self, bundle: &AssetBundle, digests: &[Digest], ) -> Result<()>

Upload the named digests from bundle. A digest nothing in the bundle hashes to is Error::UnknownDigest — the request is never sent half-formed.

pub async fn preflight(&self, bundle: &AssetBundle) -> Result<Vec<Digest>>

The pessimistic strategy: ask what is missing, upload exactly that, and let the render that follows go straight through. Returns the digests it uploaded.

impl Client

pub fn builder(base_url: impl Into<String>) -> ClientBuilder

Start building a client for the server at base_url (http://mdcast.internal:8080, with or without a trailing slash).

pub fn base_url(&self) -> &str

The normalised base URL, without its trailing slash.

pub async fn render( &self, request: RenderMarkdownRequest, bundle: &AssetBundle, ) -> Result<Artifact>

Render markdown, negotiating any assets the server is missing.

request.assets is filled from bundle when the caller left it empty, and verified against it otherwise.

pub async fn render_template( &self, request: RenderTemplateRequest, bundle: &AssetBundle, ) -> Result<Artifact>

Render a typst template over structured data — same negotiation, same single retry.

pub async fn capabilities(&self) -> Result<CapabilitiesResponse>

What this server can actually render right now — targets, template formats, and its upload size ceiling. Unauthenticated server-side (GET /v1/capabilities sits outside the bearer gate), so this is useful for feature-gating a UI before a render is ever attempted.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

Debug is written out rather than derived on both types: the token is a shared secret, and a derived impl would print it into whatever log or panic message formats the client.

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

Formats the value using the given formatter.