rust

Vovk.ts Rust client

vovk-rust generates typed Rust crate from same .vovk-schema/ artifacts driving TS client. Async by default via reqwest + tokio; streaming via futures.

Install + generate

npm i -D vovk-rust

Standalone crate

Canonical output dir ./dist_rust (hello-world convention):

npx vovk generate --from rs --out ./dist_rust

Output:

dist_rust/
  src/http_request.rs       # HTTP handling
  src/lib.rs                # RPC functions + types
  src/read_full_schema.rs   # Schema utilities
  src/schema.json           # Vovk schema (compiled into the crate with include_str!)
  Cargo.toml                # edition = "2021"
  README.md

Embedded source

npx vovk generate --from rsSrc --out ./rust_src

Auto-generate with composed client

// vovk.config.mjs
const config = {
  composedClient: {
    fromTemplates: ['ts', 'rs'],
  },
};
export default config;

Bake prod API URL via clientTemplateDefs.rs.outputConfig.origin — generated crate uses this by default. Required: crate sends calls to an absolute URL, so without an origin every call needs api_root, and vovk generate warns. Pattern from hello-world:

// vovk.config.js
const PROD_ORIGIN = 'https://hello-world.vovk.dev';

const config = {
  composedClient: { fromTemplates: ['ts', 'rs'] },
  clientTemplateDefs: {
    rs: {
      extends: 'rs',
      outputConfig: { origin: PROD_ORIGIN },
      // composedClient: { outDir: './my_other_dir' }, // optional — defaults to ./dist_rust
    },
  },
};

Consumers can still override per call via api_root arg.

Generated call shape

Every RPC function async, takes positional args: body, query, params, headers?, api_root?, disable_client_validation.

pub async fn update_user(
    body: update_user_::body,
    query: update_user_::query,
    params: update_user_::params,
    headers: Option<&HashMap<String, String>>,
    api_root: Option<&str>,
    disable_client_validation: bool,
) -> Result<update_user_::output, HttpException>