iii-sdk 0.11.2

SDK for III Engine - a platform for building distributed applications
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

//! Integration tests for bridge operations.
//!
//! Requires a running III engine. Set III_URL or use ws://localhost:49134 default.

mod common;

use std::sync::Arc;
use std::time::Duration;

use serde_json::{Value, json};
use tokio::sync::Mutex;

use iii_sdk::{FunctionInfo, RegisterFunctionMessage, TriggerAction, TriggerRequest};

#[tokio::test]
async fn connect_successfully() {
    let iii = common::shared_iii();

    let functions: Vec<FunctionInfo> = iii.list_functions().await.expect("list_functions");
    // Just verify it returns a valid list (may be empty if no functions registered)
    let _ = functions;
}

#[tokio::test]
async fn register_and_invoke_function() {
    let iii = common::shared_iii();

    let received = Arc::new(Mutex::new(Vec::new()));
    let received_clone = received.clone();

    let fn_ref = iii.register_function((
        RegisterFunctionMessage::with_id("test::bridge::rs::echo".to_string()),
        move |input: Value| {
            let received = received_clone.clone();
            async move {
                received.lock().await.push(input.clone());
                Ok(json!({ "echoed": input }))
            }
        },
    ));

    common::settle().await;

    let result = iii
        .trigger(TriggerRequest {
            function_id: "test::bridge::rs::echo".to_string(),
            payload: json!({"message": "hello"}),
            action: None,
            timeout_ms: None,
        })
        .await
        .expect("trigger");

    assert_eq!(result["echoed"]["message"], "hello");
    assert_eq!(received.lock().await[0]["message"], "hello");

    fn_ref.unregister();
}

#[tokio::test]
async fn invoke_function_fire_and_forget() {
    let iii = common::shared_iii();

    let received = Arc::new(Mutex::new(Vec::new()));
    let received_clone = received.clone();
    let (tx, rx) = tokio::sync::oneshot::channel::<()>();
    let tx = Arc::new(Mutex::new(Some(tx)));

    let fn_ref = iii.register_function((
        RegisterFunctionMessage::with_id("test::bridge::rs::receiver".to_string()),
        move |input: Value| {
            let received = received_clone.clone();
            let tx = tx.clone();
            async move {
                received.lock().await.push(input);
                if let Some(sender) = tx.lock().await.take() {
                    let _ = sender.send(());
                }
                Ok(json!({}))
            }
        },
    ));

    common::settle().await;

    let result = iii
        .trigger(TriggerRequest {
            function_id: "test::bridge::rs::receiver".to_string(),
            payload: json!({"value": 42}),
            action: Some(TriggerAction::Void),
            timeout_ms: None,
        })
        .await
        .expect("void trigger");

    assert!(result.is_null());

    tokio::time::timeout(Duration::from_secs(5), rx)
        .await
        .expect("timeout waiting for fire-and-forget")
        .expect("channel error");

    assert_eq!(received.lock().await[0]["value"], 42);

    fn_ref.unregister();
}

#[tokio::test]
async fn list_registered_functions() {
    let iii = common::shared_iii();

    let fn1 = iii.register_function((
        RegisterFunctionMessage::with_id("test::bridge::rs::list::func1".to_string()),
        |_: Value| async move { Ok(json!({})) },
    ));
    let fn2 = iii.register_function((
        RegisterFunctionMessage::with_id("test::bridge::rs::list::func2".to_string()),
        |_: Value| async move { Ok(json!({})) },
    ));

    common::settle().await;

    let functions: Vec<FunctionInfo> = iii.list_functions().await.expect("list_functions");
    let ids: Vec<&str> = functions.iter().map(|f| f.function_id.as_str()).collect();

    assert!(ids.contains(&"test::bridge::rs::list::func1"));
    assert!(ids.contains(&"test::bridge::rs::list::func2"));

    fn1.unregister();
    fn2.unregister();
}

#[tokio::test]
async fn reject_non_existent_function() {
    let iii = common::shared_iii();

    let result = iii
        .trigger(TriggerRequest {
            function_id: "nonexistent::function::rs".to_string(),
            payload: json!({}),
            action: None,
            timeout_ms: Some(2000),
        })
        .await;

    assert!(result.is_err());
}