evidentsource-client 1.0.0-rc1

//! Low-level gRPC API for direct protocol buffer access.
//!
//! This module exposes the raw gRPC client and protocol buffer types for advanced
//! use cases that require direct access to the underlying protocol.
//!
//! # When to use this module
//!
//! - Building custom tooling that needs raw protocol buffer access
//! - Implementing advanced streaming patterns not covered by the high-level API
//! - Debugging or introspecting the wire protocol
//! - Interoperating with other gRPC clients
//!
//! # When to use the high-level API instead
//!
//! For most application code, prefer the types in [`crate::client`] which:
//! - Use domain types from `evidentsource_core::domain`
//! - Provide better type safety and ergonomics
//! - Handle protocol buffer conversions automatically
//!
//! # Example
//!
//! ```rust,ignore
//! use evidentsource_client::grpc::{EvidentSourceClient, proto};
//!
//! let mut client = EvidentSourceClient::new("http://localhost:50051").await?;
//!
//! // Direct proto access for advanced use cases
//! let db = client.fetch_latest_database("my-db".into()).await?;
//! println!("Database revision: {}", db.revision);
//! ```

/// Protocol buffer types for direct gRPC access.
///
/// These are the raw protobuf-generated types. For most use cases,
/// prefer the domain types from `evidentsource_core::domain`.
pub mod proto {
    /// EvidentSource service protocol buffer types.
    pub mod evidentsource {
        pub use crate::com::evidentsource::*;
    }

    /// CloudEvents protocol buffer types.
    pub mod cloudevents {
        pub use crate::io::cloudevents::v1::*;
    }
}

// Re-export the internal client types for the grpc API
pub use crate::Error as GrpcError;
pub use crate::EvidentSourceClient;