wavecraft_bridge/lib.rs
1//! IPC bridge for WebView ↔ Rust communication
2//!
3//! This crate provides the message handling layer between the React UI
4//! (running in a WebView) and Rust application logic. It implements
5//! JSON-RPC 2.0 style request/response handling with typed message contracts.
6//!
7//! # Architecture
8//!
9//! - **ParameterHost** trait: Abstracts parameter storage (desktop POC, plugin, etc.)
10//! - **IpcHandler**: Dispatches JSON-RPC requests to appropriate handlers
11//! - **BridgeError**: Typed error handling with conversion to IPC error codes
12//!
13//! # Example
14//!
15//! ```rust,no_run
16//! use wavecraft_bridge::{IpcHandler, ParameterHost, BridgeError};
17//! use wavecraft_protocol::{MeterFrame, ParameterInfo};
18//!
19//! // Implement ParameterHost for your application state
20//! struct MyApp;
21//!
22//! impl ParameterHost for MyApp {
23//! fn get_parameter(&self, id: &str) -> Option<ParameterInfo> {
24//! // Implementation
25//! None
26//! }
27//!
28//! fn set_parameter(&self, id: &str, value: f32) -> Result<(), BridgeError> {
29//! // Implementation
30//! Ok(())
31//! }
32//!
33//! fn get_all_parameters(&self) -> Vec<ParameterInfo> {
34//! // Implementation
35//! vec![]
36//! }
37//!
38//! fn get_meter_frame(&self) -> Option<MeterFrame> {
39//! // Implementation
40//! None
41//! }
42//!
43//! fn request_resize(&self, _width: u32, _height: u32) -> bool {
44//! // Implementation
45//! false
46//! }
47//! }
48//!
49//! // Create handler
50//! let handler = IpcHandler::new(MyApp);
51//!
52//! // Handle incoming JSON from WebView
53//! let request_json = r#"{"jsonrpc":"2.0","id":1,"method":"ping"}"#;
54//! let response_json = handler.handle_json(request_json);
55//! ```
56
57pub mod error;
58pub mod handler;
59pub mod host;
60
61// Re-export key types for convenience
62pub use error::BridgeError;
63pub use handler::IpcHandler;
64pub use host::ParameterHost;
65
66// Re-export protocol types used in bridge API
67pub use wavecraft_protocol::{
68 GetAllParametersResult, GetParameterParams, GetParameterResult, IpcError, IpcNotification,
69 IpcRequest, IpcResponse, ParameterChangedNotification, ParameterInfo, ParameterType, RequestId,
70 SetParameterParams, SetParameterResult,
71};