use crate::protocol::Compat;
use serde_json::Value;
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Maturity {
Draft,
Stable,
Deprecated,
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Binding {
pub id: String,
pub version: String,
pub name: String,
pub versions: Vec<(String, Maturity)>,
pub compat: Compat,
pub kinds: Vec<String>,
pub meaning: Vec<(String, String)>,
}
impl Binding {
pub fn stable(&self) -> Vec<&str> {
self.versions.iter().filter(|(_, m)| *m == Maturity::Stable).map(|(v, _)| v.as_str()).collect()
}
}
pub fn binding_from(m: &Value) -> Option<Binding> {
if m.get("format")?.as_str()? != "instruction-extension/1" || !m.get("roles")?.as_array()?.iter().any(|r| r == "binding") {
return None;
}
let p = m.get("provides")?.get("protocol")?;
let versions = p
.get("versions")?
.as_object()?
.iter()
.map(|(v, s)| {
let maturity = match s.as_str() {
Some("stable") => Maturity::Stable,
Some("deprecated") => Maturity::Deprecated,
_ => Maturity::Draft,
};
(v.clone(), maturity)
})
.collect();
let compat = match p.get("compat").and_then(Value::as_str) {
Some("semver-minor") => Compat::SemverMinor,
Some("date") => Compat::Date,
_ => Compat::Exact,
};
Some(Binding {
id: m.get("id")?.as_str()?.to_string(),
version: m.get("version")?.as_str()?.to_string(),
name: p.get("name")?.as_str()?.to_string(),
versions,
compat,
kinds: p.get("kinds").and_then(Value::as_array).map(|k| k.iter().filter_map(|x| x.as_str().map(str::to_string)).collect()).unwrap_or_default(),
meaning: p
.get("meaning")
.and_then(Value::as_object)
.map(|m| m.iter().filter_map(|(k, v)| v.as_str().map(|v| (k.clone(), v.to_string()))).collect())
.unwrap_or_default(),
})
}
pub fn x402() -> Binding {
Binding {
id: "org.x402/x402".into(),
version: "2.0.0".into(),
name: "x402".into(),
versions: vec![("1".into(), Maturity::Deprecated), ("2".into(), Maturity::Stable)],
compat: Compat::Exact,
kinds: vec!["wallet".into(), "service".into()],
meaning: Vec::new(),
}
}
pub fn openapi() -> Binding {
Binding {
id: "org.openapis/openapi".into(),
version: "1.0.0".into(),
name: "openapi".into(),
versions: vec![("2.0".into(), Maturity::Deprecated), ("3.0".into(), Maturity::Stable), ("3.1".into(), Maturity::Stable)],
compat: Compat::SemverMinor,
kinds: vec!["service".into(), "tool".into()],
meaning: vec![
("service.src".into(), "the OpenAPI document (JSON or YAML), not the API's own address".into()),
("tool.name".into(), "an operation's operationId in that document".into()),
],
}
}
pub fn known(name: &str) -> Option<Binding> {
match name {
"x402" => Some(x402()),
"openapi" => Some(openapi()),
_ => None,
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn reads_a_manifest_and_ships_x402() {
let m: Value = serde_json::from_str(r#"{"format":"instruction-extension/1","id":"org.x402/x402","version":"2.0.0","spec":["1"],"roles":["binding"],"provides":{"protocol":{"name":"x402","versions":{"1":"deprecated","2":"stable"},"compat":"exact","kinds":["wallet","service"]}}}"#).unwrap();
assert_eq!(binding_from(&m), Some(x402()));
assert_eq!(x402().stable(), vec!["2"]);
assert!(known("a2a").is_none());
}
#[test]
fn ships_openapi_as_the_specification_publishes_it() {
let path = std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("conformance/specification/bindings/openapi.extension.json");
let m: Value = serde_json::from_str(&std::fs::read_to_string(path).unwrap()).unwrap();
assert_eq!(binding_from(&m), Some(openapi()));
assert_eq!(known("openapi"), Some(openapi()));
assert_eq!(openapi().stable(), vec!["3.0", "3.1"]);
}
}