did-hosting-common 0.10.1

DID Hosting Common, Common methods and structs related to WebVH Content
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
148
149
150
151
152
153
154
155
156
157
158
159

//! `OperatorMessages` implementations for the four webvh setup binaries.
//!
//! These are passed to `vta_sdk::provision_client::run_provision` (and the
//! headless `run_phase1_init` / `run_phase2_connect`) so the SDK's runners
//! and CLI driver render the right integration label and `pnm contexts
//! create` command for each binary.

use vta_sdk::provision_client::OperatorMessages;

/// Messages for the `did-hosting-daemon` binary (unified server + control + witness).
pub struct WebvhDaemonMessages;

impl OperatorMessages for WebvhDaemonMessages {
    fn integration_label(&self) -> &str {
        "DID Hosting daemon"
    }

    fn integration_label_lower(&self) -> &str {
        "did hosting daemon"
    }

    fn pnm_admin_command_hint(&self, context_id: &str, setup_did: &str) -> String {
        format!(
            "pnm contexts create --id {context_id} --name \"DID Hosting daemon\" \\\n  \
             --admin-did {setup_did} --admin-expires 1h"
        )
    }
}

/// Messages for the `did-hosting-server` binary (standalone DID hosting server).
pub struct WebvhServerMessages;

impl OperatorMessages for WebvhServerMessages {
    fn integration_label(&self) -> &str {
        "DID Hosting server"
    }

    fn integration_label_lower(&self) -> &str {
        "did hosting server"
    }

    fn pnm_admin_command_hint(&self, context_id: &str, setup_did: &str) -> String {
        format!(
            "pnm contexts create --id {context_id} --name \"DID Hosting server\" \\\n  \
             --admin-did {setup_did} --admin-expires 1h"
        )
    }
}

/// Messages for the `did-hosting-control` binary (standalone management plane).
pub struct WebvhControlMessages;

impl OperatorMessages for WebvhControlMessages {
    fn integration_label(&self) -> &str {
        "DID Hosting control plane"
    }

    fn integration_label_lower(&self) -> &str {
        "did hosting control plane"
    }

    fn pnm_admin_command_hint(&self, context_id: &str, setup_did: &str) -> String {
        format!(
            "pnm contexts create --id {context_id} --name \"DID Hosting control plane\" \\\n  \
             --admin-did {setup_did} --admin-expires 1h"
        )
    }
}

/// Messages for the `webvh-witness` binary (standalone witness service).
pub struct WebvhWitnessMessages;

impl OperatorMessages for WebvhWitnessMessages {
    fn integration_label(&self) -> &str {
        "WebVH witness"
    }

    fn integration_label_lower(&self) -> &str {
        "webvh witness"
    }

    fn pnm_admin_command_hint(&self, context_id: &str, setup_did: &str) -> String {
        format!(
            "pnm contexts create --id {context_id} --name \"WebVH witness\" \\\n  \
             --admin-did {setup_did} --admin-expires 1h"
        )
    }
}

/// Messages for the `webvh-watcher` binary (standalone watcher service).
pub struct WebvhWatcherMessages;

impl OperatorMessages for WebvhWatcherMessages {
    fn integration_label(&self) -> &str {
        "WebVH watcher"
    }

    fn integration_label_lower(&self) -> &str {
        "webvh watcher"
    }

    fn pnm_admin_command_hint(&self, context_id: &str, setup_did: &str) -> String {
        format!(
            "pnm contexts create --id {context_id} --name \"WebVH watcher\" \\\n  \
             --admin-did {setup_did} --admin-expires 1h"
        )
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn labels_are_distinct_per_binary() {
        let labels = [
            WebvhDaemonMessages.integration_label(),
            WebvhServerMessages.integration_label(),
            WebvhControlMessages.integration_label(),
            WebvhWitnessMessages.integration_label(),
        ];
        for (i, a) in labels.iter().enumerate() {
            for b in labels.iter().skip(i + 1) {
                assert_ne!(a, b, "duplicate label: {a}");
            }
        }
    }

    #[test]
    fn pnm_command_includes_context_did_and_label() {
        let cmd = WebvhDaemonMessages
            .pnm_admin_command_hint("prod-webvh", "did:key:z6MkExampleDaemonKey");
        assert!(cmd.contains("--id prod-webvh"));
        assert!(cmd.contains("--admin-did did:key:z6MkExampleDaemonKey"));
        assert!(cmd.contains("--name \"DID Hosting daemon\""));
        assert!(cmd.contains("--admin-expires 1h"));
    }

    #[test]
    fn server_command_uses_hosting_server_label() {
        let cmd = WebvhServerMessages
            .pnm_admin_command_hint("prod-webvh", "did:key:z6MkExampleServerKey");
        assert!(cmd.contains("--name \"DID Hosting server\""));
    }

    #[test]
    fn control_command_uses_control_plane_label() {
        let cmd = WebvhControlMessages
            .pnm_admin_command_hint("prod-webvh", "did:key:z6MkExampleControlKey");
        assert!(cmd.contains("--name \"DID Hosting control plane\""));
    }

    #[test]
    fn witness_command_uses_witness_label() {
        let cmd = WebvhWitnessMessages
            .pnm_admin_command_hint("prod-webvh", "did:key:z6MkExampleWitnessKey");
        assert!(cmd.contains("--name \"WebVH witness\""));
    }
}