dpp-digital-link 0.1.0

GS1 Digital Link parser/builder and JSON-LD helpers for Odal Node
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

//! Minimal JSON-LD context builder for DPP passport payloads.

use serde_json::{Value, json};

#[cfg(test)]
mod tests;

/// Build a minimal JSON-LD context for an Odal Node passport.
///
/// Suitable for embedding in or linking from a DPP payload to assert
/// semantic interoperability with GS1, Schema.org, and EU ESPR vocabularies.
pub fn passport_context() -> Value {
    json!({
        "@context": [
            "https://www.w3.org/ns/did/v1",
            "https://ref.gs1.org/standards/digital-link/context/",
            {
                "dpp": "https://schema.odal-node.io/dpp#",
                "gs1": "https://ref.gs1.org/voc/",
                "schema": "https://schema.org/",
                "gtin": "gs1:gtin",
                "sector": "dpp:sector",
                "passportId": "dpp:passportId",
                "status": "dpp:status",
                "sectorData": "dpp:sectorData",
                "complianceResult": "dpp:complianceResult",
                "createdAt": "schema:dateCreated",
                "updatedAt": "schema:dateModified",
                "jws": "dpp:jws"
            }
        ]
    })
}

/// Wrap a passport JSON value in a JSON-LD envelope.
pub fn frame_passport(passport: Value) -> Value {
    let mut framed = passport_context();
    if let Value::Object(ref mut ctx_map) = framed
        && let Value::Object(passport_map) = passport
    {
        ctx_map.extend(passport_map);
    }
    framed
}

/// Extract the plain data from a JSON-LD framed passport (strip `@context`).
pub fn strip_context(framed: Value) -> Value {
    match framed {
        Value::Object(mut map) => {
            map.remove("@context");
            Value::Object(map)
        }
        other => other,
    }
}