First Version

crates/skald-relay-client/src/events.rs

@@ -0,0 +1,33 @@
+//! Events broadcast by the relay client. Consumers (the plugin's
+//! `RelayApp::run_event_loop`) subscribe via `RelayClient::events()`.
+
+/// One event emitted by the relay client.
+///
+/// `Message.payload` is already **decrypted AND decompressed**: the client
+/// peels off the v2 `version‖comp‖json` framing before emission, so the
+/// consumer sees only clean bytes and applies its own JSON semantics. This is
+/// the payload-agnostic boundary (see the "Crate split" section of
+/// `docs/plugins/mobile-connector.md`).
+#[derive(Debug, Clone)]
+pub enum RelayEvent {
+    /// The WS handshake completed and the relay verified our namespace_id.
+    Connected,
+    /// The WS connection dropped. The client will reconnect with backoff.
+    Disconnected,
+    /// An inbound `message` from a client, decoded end-to-end. `from` is the
+    /// sender's ed25519 pubkey; `live` mirrors the wire flag.
+    Message {
+        from: [u8; 32],
+        payload: Vec<u8>,
+        live: bool,
+    },
+    /// A device paired (pending authorization). The consumer decides whether
+    /// to call `client.authorize(ed)` (auto) or to notify the human (manual).
+    ClientPaired {
+        ed25519_pub: [u8; 32],
+        x25519_pub: [u8; 32],
+        platform: String,
+    },
+    /// A device was revoked via `client.revoke` or removed by `client.clear_all`.
+    ClientRevoked { ed25519_pub: [u8; 32] },
+}