vectorizer-sdk 3.3.0

Rust SDK for Vectorizer — RPC-first (vectorizer://) with HTTP fallback
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! Hive Vectorizer Rust SDK
//!
//! High-performance Rust client for the Hive Vectorizer vector
//! database. v3.x ships with **VectorizerRPC** as the default transport
//! (binary MessagePack over raw TCP, see [`rpc`]); HTTP stays available
//! as the legacy fallback under the `http` Cargo feature.
//!
//! Suppresses the long tail of legacy clippy warnings (cast_lossless,
//! uninlined_format_args, etc.) that the workspace lint policy
//! escalates to deny. Mirrors the same blanket allow the umbrella
//! `vectorizer` crate + `vectorizer-core` + `vectorizer-cli` all
//! carry — without it, joining the workspace under sub-phase 6
//! would fail clippy on pre-existing SDK code untouched by the move.
//!
//! The SDK also explicitly allows `unwrap_used` / `expect_used` at
//! the crate root because it carries 13 pre-existing call sites
//! (mostly in `client/` discovery + files modules) that
//! `phase4_enforce-no-unwrap-policy` cleared from the server crate
//! but not yet from the SDK. A dedicated cleanup task (separate from
//! the workspace split) covers those — the policy only fires on the
//! server's public surface today, not the SDK.

#![allow(warnings)]
#![allow(clippy::unwrap_used, clippy::expect_used)]
//!
//! # Quick start (RPC, default)
//!
//! ```no_run
//! # async fn run() -> Result<(), Box<dyn std::error::Error>> {
//! use vectorizer_sdk::rpc::{RpcClient, HelloPayload};
//!
//! let client = RpcClient::connect("127.0.0.1:15503").await?;
//! client.hello(HelloPayload::new("vectorizer-sdk-rust/3.0.0")).await?;
//! let collections = client.list_collections().await?;
//! println!("collections: {collections:?}");
//! # Ok(())
//! # }
//! ```

pub mod error;
pub mod models;
pub mod rpc;
pub mod transport;
pub mod utils;

#[cfg(feature = "http")]
pub mod client;
#[cfg(feature = "http")]
pub mod http_transport;

#[cfg(feature = "umicp")]
pub mod umicp_transport;

// Re-export main types for convenience
#[cfg(all(feature = "http", feature = "umicp"))]
pub use client::UmicpConfig;
#[cfg(feature = "http")]
pub use client::{ClientConfig, VectorizerClient};
pub use error::{Result, VectorizerError};
#[cfg(feature = "http")]
pub use http_transport::HttpTransport;
pub use models::*;
pub use rpc::{HelloPayload, HelloResponse, RpcClient, RpcClientError, RpcPool};
pub use transport::{Protocol, Transport, parse_connection_string};
#[cfg(feature = "umicp")]
pub use umicp_transport::UmicpTransport;

/// SDK version
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// Default API base URL
pub const DEFAULT_BASE_URL: &str = "http://localhost:15002";

/// Default MCP server URL
pub const DEFAULT_MCP_URL: &str = "http://localhost:15002/sse";

/// Default request timeout in seconds
pub const DEFAULT_TIMEOUT_SECS: u64 = 30;

/// Default maximum retries
pub const DEFAULT_MAX_RETRIES: usize = 3;

/// Default retry delay in seconds
pub const DEFAULT_RETRY_DELAY_SECS: u64 = 1;