zendriver-transport 0.1.1

Internal: WebSocket + CDP routing actor for zendriver
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

//! Internal CDP transport for `zendriver`: WebSocket I/O, command/response
//! routing, event broadcast.
//!
//! **Use via the `zendriver` crate's re-exports.** This crate is published so
//! the workspace can compile end-to-end but its surface is not covered by the
//! same SemVer guarantees as `zendriver`; expect minor versions to rearrange
//! types here freely. See [`SEMVER.md`] in the repo root for the policy.
//!
//! For a high-level walkthrough of the actor/observer model see the
//! [Architecture chapter](https://turtiesocks.github.io/zendriver-rs/architecture.html)
//! of the [zendriver-rs user guide](https://turtiesocks.github.io/zendriver-rs/).
//!
//! # What lives here
//!
//! - [`Connection`] — cheap, clonable handle to the actor task. All `Tab`s
//!   and `Element`s hold one.
//! - [`SessionHandle`] — a connection scoped to a particular CDP `sessionId`.
//! - [`CdpCommand`] / [`CdpInbound`] / [`CdpRpcError`] / [`RawEvent`] — wire
//!   types.
//! - [`TargetObserver`] — observer trait fired on `Target.attachedToTarget`
//!   before the debugger is released; used by `zendriver-stealth` to install
//!   patches on new pages.
//! - [`CallError`] / [`TransportError`] — error types surfaced via
//!   `zendriver`'s `ZendriverError::Transport` / `Cdp` variants.
//!
//! [`SEMVER.md`]: https://github.com/TurtIeSocks/zendriver-rs/blob/main/SEMVER.md

#![cfg_attr(docsrs, feature(doc_cfg))]

pub mod actor;
pub mod connection;
pub mod error;
pub mod frame;
pub mod observer;
pub mod session;

#[cfg(any(test, feature = "testing"))]
pub mod testing;

// Re-exports added as types land in later Phase 1 tasks:
pub use connection::{
    Connection, connect, connect_with_observers, spawn_actor, spawn_actor_with_observers,
};
pub use error::{CallError, TransportError};
pub use frame::{CdpCommand, CdpInbound, CdpRpcError, RawEvent};
pub use observer::{ObserverError, PausedSession, TargetInfo, TargetObserver};
pub use session::SessionHandle;