hyprstream_workers/dbus/mod.rs
1//! D-Bus bridge for container access to host services
2//!
3//! Enables containers to transparently access D-Bus services (notifications,
4//! media controls, etc.) with fine-grained policy enforcement.
5//!
6//! # Architecture
7//!
8//! ```text
9//! Container (GUI app)
10//! │
11//! ▼ (ZMQ over vsock/TCP)
12//! DbusBridgeService
13//! │
14//! ├── PolicyClient.check(subject, resource, operation)
15//! │ └── resource: "dbus:system:org.freedesktop.Notifications:Notify"
16//! │
17//! └── zbus Connection (system or session bus)
18//! └── Forward permitted calls to actual D-Bus
19//! ```
20//!
21//! # Protocol
22//!
23//! Containers send D-Bus requests via ZMQ:
24//!
25//! ```text
26//! Request: DbusRequest { bus, destination, path, interface, method, args }
27//! Response: DbusResponse { result } or DbusError { name, message }
28//! ```
29//!
30//! # Policy Integration
31//!
32//! Every D-Bus operation is checked against Casbin policy:
33//!
34//! - Resource format: `dbus:<bus>:<destination>:<interface>:<member>`
35//! - Operations: `call` (methods), `read` (properties), `write` (properties), `subscribe` (signals)
36//!
37//! # Example Policy
38//!
39//! ```csv
40//! # Allow container to send desktop notifications
41//! p, container:gui-app, dbus:session:org.freedesktop.Notifications:Notify, call, allow
42//!
43//! # Allow reading media player properties
44//! p, container:gui-app, dbus:session:org.mpris.MediaPlayer2.*:@*, read, allow
45//!
46//! # Deny all D-Bus by default
47//! p, container:*, dbus:*, *, deny
48//! ```
49//!
50//! # Usage
51//!
52//! ```ignore
53//! use hyprstream_workers::dbus::{DbusBridgeService, DbusBridgeConfig};
54//!
55//! // Create the bridge service
56//! let config = DbusBridgeConfig::default();
57//! let bridge = DbusBridgeService::new(config).await?;
58//!
59//! // Start as ZMQ service
60//! let handle = bridge.start("ipc:///run/hyprstream/dbus-bridge.sock").await?;
61//! ```
62
63mod bridge;
64mod policy;
65mod protocol;
66
67pub use bridge::{
68 AllowAllPolicy, DbusBridgeConfig, DbusBridgeService, DenyAllPolicy, PolicyChecker,
69};
70pub use policy::{container_subject, DbusOperation, DbusResource};
71pub use protocol::{
72 BusType, DbusCallRequest, DbusCallResponse, DbusError, DbusGetPropertyRequest, DbusRequest,
73 DbusResponse, DbusSetPropertyRequest, DbusSignal, DbusSubscribeRequest, DbusValue,
74};