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>,
}
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(),
})
}
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()],
}
}
pub fn known(name: &str) -> Option<Binding> {
(name == "x402").then(x402)
}
#[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());
}
}