codetether-browser 0.1.0

Browser automation runtime for CodeTether
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

//! Native browser session lifecycle operations.

use crate::browser::{BrowserError, BrowserOutput, output::Ack, request::StartRequest};
use serde_json::json;

/// Start a native TetherScript browser session.
///
/// # Errors
///
/// This currently only returns errors for API compatibility.
pub(super) async fn start(
    session: &super::super::BrowserSession,
    _request: StartRequest,
) -> Result<BrowserOutput, BrowserError> {
    *session.inner.native.lock().await = Some(super::NativeRuntime::new());
    Ok(ack())
}

/// Stop the native browser session.
///
/// # Errors
///
/// This currently only returns errors for API compatibility.
pub(super) async fn stop(
    session: &super::super::BrowserSession,
) -> Result<BrowserOutput, BrowserError> {
    *session.inner.native.lock().await = None;
    Ok(ack())
}

/// Return native backend health information.
///
/// # Errors
///
/// This currently only returns errors for API compatibility.
pub(super) async fn health(
    session: &super::super::BrowserSession,
) -> Result<BrowserOutput, BrowserError> {
    let native = session.inner.native.lock().await;
    let Some(runtime) = native.as_ref() else {
        return Ok(BrowserOutput::Json(json!({
            "ok": true,
            "backend": "tetherscript-native",
            "started": false
        })));
    };
    Ok(BrowserOutput::Json(json!({
        "ok": true,
        "alive": true,
        "backend": "tetherscript-native",
        "current": runtime.current,
        "started": true,
        "tabs": runtime.pages.len()
    })))
}

/// Return a successful acknowledgement output.
pub(super) fn ack() -> BrowserOutput {
    BrowserOutput::Ack(Ack { ok: true })
}