lenso-contract-codegen 0.6.2

Code generator for portable Lenso Capability contracts.
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

use std::path::Path;

use lenso_contract_authoring::{CapabilitySnapshot, OperationSnapshot};
use lenso_contract_codegen::{
    CodegenError, check_source_snapshot, generate, write_source_snapshot,
};
use serde_json::json;

fn snapshot() -> CapabilitySnapshot {
    CapabilitySnapshot {
        capability_id: "example.derived@1".to_owned(),
        version: "1.0.0".to_owned(),
        portable: true,
        cross_lane_transfer: false,
        operations: vec![OperationSnapshot {
            name: "run".to_owned(),
            interaction: "request".to_owned(),
            request_schema: json!({
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {},
                "additionalProperties": false
            }),
            response_schema: json!({
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {},
                "additionalProperties": false
            }),
            domain_error_schema: json!({
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "oneOf": [{"const": "rejected"}]
            }),
        }],
    }
}

#[test]
fn source_snapshots_are_deterministic_and_drift_checked() {
    let root = tempfile::tempdir().unwrap();
    let descriptor = root.path().join("capability.json");
    write_source_snapshot(&snapshot(), &descriptor).unwrap();
    check_source_snapshot(&snapshot(), &descriptor).unwrap();
    let generated = generate(&descriptor).unwrap();
    assert_eq!(generated.metadata.capability_id, "example.derived@1");
    assert!(generated.rust.contains("pub trait DerivedProvider"));
    assert!(
        generated
            .typescript
            .contains("export interface DerivedProvider")
    );

    std::fs::write(root.path().join("schemas/run-request.schema.json"), "{}\n").unwrap();
    assert!(matches!(
        check_source_snapshot(&snapshot(), &descriptor),
        Err(CodegenError::GeneratedArtifactDrift { .. })
    ));
    assert!(Path::new(&descriptor).exists());
}

#[test]
fn stream_source_snapshots_use_open_and_message_artifacts() {
    let root = tempfile::tempdir().unwrap();
    let descriptor = root.path().join("capability.json");
    let mut snapshot = snapshot();
    snapshot.operations[0].interaction = "stream".to_owned();

    write_source_snapshot(&snapshot, &descriptor).unwrap();
    assert!(root.path().join("schemas/run-open.schema.json").is_file());
    assert!(
        root.path()
            .join("schemas/run-message.schema.json")
            .is_file()
    );
    assert!(!root.path().join("schemas/run-request.schema.json").exists());
    let generated = generate(&descriptor).unwrap();
    assert!(generated.rust.contains("NativeStreamSession"));
    assert!(generated.typescript.contains("StreamSession"));
}