a3s-flow 0.13.1

Durable workflow engine and Rust SDK for A3S
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

use serde::{Deserialize, Serialize};

use crate::model::JsonValue;

pub const NATIVE_RUNTIME_PROTOCOL: &str = "a3s.flow.native_ts.v1";
pub const NATIVE_COMPILER_PROTOCOL: &str = "a3s.flow.native_ts.compiler.v1";
pub const NATIVE_DEPENDENCY_MANIFEST_PROTOCOL: &str = "a3s.flow.native_ts.dependencies.v1";

/// Capabilities reported by the installable native TypeScript compiler.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct NativeTsCompilerCapabilities {
    pub protocol: String,
    #[serde(rename = "dependencyManifest")]
    pub dependency_manifest: bool,
}

impl NativeTsCompilerCapabilities {
    pub fn current() -> Self {
        Self {
            protocol: NATIVE_COMPILER_PROTOCOL.to_string(),
            dependency_manifest: true,
        }
    }
}

/// Compiler-owned source graph used to bind native artifacts to every input.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct NativeTsDependencyManifest {
    pub protocol: String,
    #[serde(rename = "compilerIdentity")]
    pub compiler_identity: String,
    pub files: Vec<String>,
}

impl NativeTsDependencyManifest {
    pub fn new(compiler_identity: impl Into<String>, files: Vec<String>) -> Self {
        Self {
            protocol: NATIVE_DEPENDENCY_MANIFEST_PROTOCOL.to_string(),
            compiler_identity: compiler_identity.into(),
            files,
        }
    }
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum NativeRuntimeKind {
    Workflow,
    Step,
}

impl NativeRuntimeKind {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Workflow => "workflow",
            Self::Step => "step",
        }
    }
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct NativeRuntimeRequest<T> {
    pub protocol: String,
    pub kind: NativeRuntimeKind,
    #[serde(rename = "exportName")]
    pub export_name: String,
    #[serde(rename = "sourceHash")]
    pub source_hash: String,
    pub payload: T,
}

impl<T> NativeRuntimeRequest<T> {
    pub fn new(
        kind: NativeRuntimeKind,
        export_name: impl Into<String>,
        source_hash: impl Into<String>,
        payload: T,
    ) -> Self {
        Self {
            protocol: NATIVE_RUNTIME_PROTOCOL.to_string(),
            kind,
            export_name: export_name.into(),
            source_hash: source_hash.into(),
            payload,
        }
    }
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct NativeRuntimeResponse {
    pub protocol: String,
    pub kind: NativeRuntimeKind,
    pub ok: bool,
    #[serde(default)]
    pub output: Option<JsonValue>,
    #[serde(default)]
    pub error: Option<String>,
}