presolve-compiler 0.1.0-alpha.2

The Presolve compiler toolchain for TypeScript web 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

//! Explicit host-owned locations for semantic-package runtime modules.

use std::collections::BTreeMap;

use crate::SemanticPackageContract;

#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub struct SemanticPackageRuntimeModuleKey {
    pub package: String,
    pub version: String,
    pub integrity: String,
    pub runtime_module: String,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum SemanticPackageRuntimeModuleError {
    EmptyLocation,
    DuplicateRuntimeModule,
    ContractMismatch,
}

/// The application/metaframework-provided location of exact package runtime
/// bytes. This table is a compiler input; it performs no package discovery.
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct SemanticPackageRuntimeModuleTable {
    modules: BTreeMap<SemanticPackageRuntimeModuleKey, String>,
}

impl SemanticPackageRuntimeModuleTable {
    pub fn insert(
        &mut self,
        key: SemanticPackageRuntimeModuleKey,
        location: String,
    ) -> Result<(), SemanticPackageRuntimeModuleError> {
        if location.is_empty() {
            return Err(SemanticPackageRuntimeModuleError::EmptyLocation);
        }
        if self.modules.contains_key(&key) {
            return Err(SemanticPackageRuntimeModuleError::DuplicateRuntimeModule);
        }
        self.modules.insert(key, location);
        Ok(())
    }

    #[must_use]
    pub fn resolve(&self, key: &SemanticPackageRuntimeModuleKey) -> Option<&str> {
        self.modules.get(key).map(String::as_str)
    }

    #[must_use]
    pub fn contains(&self, key: &SemanticPackageRuntimeModuleKey) -> bool {
        self.modules.contains_key(key)
    }

    pub fn resolve_contract_module(
        &self,
        contract: &SemanticPackageContract,
        runtime_module: &str,
    ) -> Result<&str, SemanticPackageRuntimeModuleError> {
        let key = SemanticPackageRuntimeModuleKey {
            package: contract.package.clone(),
            version: contract.version.clone(),
            integrity: contract.integrity.clone(),
            runtime_module: runtime_module.to_string(),
        };
        self.resolve(&key)
            .ok_or(SemanticPackageRuntimeModuleError::ContractMismatch)
    }
}

#[cfg(test)]
mod tests {
    use crate::{
        parse_semantic_package_contract, SemanticPackageRuntimeModuleError,
        SemanticPackageRuntimeModuleKey, SemanticPackageRuntimeModuleTable,
    };

    #[test]
    fn resolves_only_the_exact_integrity_checked_runtime_module_coordinate() {
        let contract = parse_semantic_package_contract(
            r#"{"schema_version":1,"package":"profile-service","version":"1.2.3","integrity":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","exports":{"loadProfile":{"kind":"resource","type_signature":"() -> Resource<string, string>","runtime_module":"dist/load-profile.js","resume_policy":"snapshot","resource_endpoint":{"execution_boundary":"shared","cancellation":"abort","resume":"snapshot"}}}}"#,
        )
        .unwrap();
        let mut modules = SemanticPackageRuntimeModuleTable::default();
        modules
            .insert(
                SemanticPackageRuntimeModuleKey {
                    package: "profile-service".into(),
                    version: "1.2.3".into(),
                    integrity:
                        "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
                            .into(),
                    runtime_module: "dist/load-profile.js".into(),
                },
                "./vendor/profile-service.js".into(),
            )
            .unwrap();
        assert_eq!(
            modules
                .resolve_contract_module(&contract, "dist/load-profile.js")
                .unwrap(),
            "./vendor/profile-service.js"
        );
        assert_eq!(
            modules.resolve_contract_module(&contract, "other.js"),
            Err(SemanticPackageRuntimeModuleError::ContractMismatch)
        );
    }
}