turul-rpc 0.2.2

Typed JSON-RPC 2.0 framework — facade re-exporting turul-rpc-core, turul-rpc-jsonrpc, and turul-rpc-server.
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

//! # turul-rpc
//!
//! Typed JSON-RPC 2.0 framework. Facade crate re-exporting the
//! [`turul-rpc-core`], [`turul-rpc-jsonrpc`], and [`turul-rpc-server`]
//! crates under stable paths that mirror the original
//! `turul-mcp-json-rpc-server 0.3.x` layout.
//!
//! Most consumers should depend on this crate. Use the split crates
//! directly only when you need to avoid pulling in the async runtime
//! (depend on `turul-rpc-core` only) or want to write a transport on top
//! of the codec without the dispatcher (depend on `turul-rpc-jsonrpc`).
//!
//! [`turul-rpc-core`]: https://crates.io/crates/turul-rpc-core
//! [`turul-rpc-jsonrpc`]: https://crates.io/crates/turul-rpc-jsonrpc
//! [`turul-rpc-server`]: https://crates.io/crates/turul-rpc-server

// Module re-exports — preserve the original `turul_mcp_json_rpc_server::<module>`
// paths so the compatibility shim can re-export this crate without API drift.
pub use turul_rpc_core::{error, error_codes, notification, request, response, types};
pub use turul_rpc_jsonrpc::dispatch;

/// Async dispatcher and handler trait. Mirrors the original `r#async`
/// module from `turul-mcp-json-rpc-server`.
#[cfg(feature = "async")]
pub mod r#async {
    pub use turul_rpc_server::{
        FunctionHandler, JsonRpcDispatcher, JsonRpcHandler, SessionContext, ToJsonRpcError,
    };

    #[cfg(feature = "streams")]
    pub use turul_rpc_server::streaming;
}

pub mod prelude;

// Root re-exports — match the original crate's `pub use` lines.

/// JSON-RPC 2.0 error types and standard error codes.
pub use error::{JsonRpcError, JsonRpcErrorCode};
/// JSON-RPC notification message structure for fire-and-forget communications.
pub use notification::JsonRpcNotification;
/// JSON-RPC request structure with method and parameters.
pub use request::{JsonRpcRequest, RequestParams};
/// JSON-RPC response types: the §5 Response object union (`JsonRpcResponse`)
/// and the success-only struct (`JsonRpcSuccessResponse`).
pub use response::{JsonRpcResponse, JsonRpcSuccessResponse, ResponseResult};
/// Core JSON-RPC types for version and request identification.
pub use types::{JsonRpcVersion, RequestId};

/// Incoming message union (request | notification) produced by the parser.
pub use turul_rpc_jsonrpc::JsonRpcMessage;

/// Bidirectional wire-message union (request | notification | response) — the
/// schema's `JSONRPCMessage`. Superset of [`JsonRpcMessage`]; for clients and
/// peers that read responses. Parse with [`parse_json_rpc_wire_message`].
pub use turul_rpc_jsonrpc::frame::{JsonRpcWireMessage, parse_json_rpc_wire_message};

#[cfg(feature = "async")]
pub use turul_rpc_server::{JsonRpcDispatcher, JsonRpcHandler, SessionContext};

#[cfg(feature = "streams")]
pub use turul_rpc_server::streaming::{
    JsonRpcFrame, StreamingJsonRpcDispatcher, StreamingJsonRpcHandler,
};

/// JSON-RPC 2.0 version constant.
pub const JSONRPC_VERSION: &str = "2.0";