1#[derive(Debug, Clone, PartialEq, Eq)]
18pub struct SpecKeyInput {
19 pub ecosystem: String,
20 pub name: String,
21 pub version: String,
22}
23
24fn encode_part(value: &str) -> anyhow::Result<String> {
27 if value.is_empty() {
28 anyhow::bail!("spec-key part must be non-empty");
29 }
30 Ok(value.replace(['/', ':'], "__"))
31}
32
33pub fn encode_spec_key(input: &SpecKeyInput) -> anyhow::Result<String> {
36 Ok([
37 encode_part(&input.ecosystem)?,
38 encode_part(&input.name)?,
39 encode_part(&input.version)?,
40 ]
41 .join("__"))
42}
43
44pub fn decode_spec_key(key: &str) -> anyhow::Result<SpecKeyInput> {
48 let segments: Vec<&str> = key.split("__").collect();
49 if segments.len() < 3 {
50 anyhow::bail!("malformed spec-key (needs at least 3 segments): {key}");
51 }
52 let ecosystem = segments[0];
53 let version = *segments.last().unwrap();
54 let name = segments[1..segments.len() - 1].join("/");
55 if ecosystem.is_empty() || name.is_empty() || version.is_empty() {
56 anyhow::bail!("malformed spec-key (empty segment): {key}");
57 }
58 Ok(SpecKeyInput {
59 ecosystem: ecosystem.to_string(),
60 name,
61 version: version.to_string(),
62 })
63}
64
65#[cfg(test)]
66mod tests {
67 use super::*;
68
69 fn k(e: &str, n: &str, v: &str) -> SpecKeyInput {
70 SpecKeyInput {
71 ecosystem: e.to_string(),
72 name: n.to_string(),
73 version: v.to_string(),
74 }
75 }
76
77 #[test]
78 fn encode_examples() {
79 assert_eq!(
80 encode_spec_key(&k("npm", "next", "14.2.3")).unwrap(),
81 "npm__next__14.2.3"
82 );
83 assert_eq!(
84 encode_spec_key(&k("npm", "@vercel/ai", "5.0.0")).unwrap(),
85 "npm__@vercel__ai__5.0.0"
86 );
87 assert_eq!(
88 encode_spec_key(&k("github", "vercel/ai", "v5.0.0")).unwrap(),
89 "github__vercel__ai__v5.0.0"
90 );
91 }
92
93 #[test]
94 fn encode_rejects_empty_part() {
95 assert!(encode_spec_key(&k("", "n", "v")).is_err());
96 }
97
98 #[test]
99 fn decode_roundtrips_scoped_and_github() {
100 assert_eq!(
101 decode_spec_key("npm__next__14.2.3").unwrap(),
102 k("npm", "next", "14.2.3")
103 );
104 assert_eq!(
106 decode_spec_key("github__vercel__ai__v5.0.0").unwrap(),
107 k("github", "vercel/ai", "v5.0.0")
108 );
109 }
110
111 #[test]
112 fn decode_rejects_short_key() {
113 assert!(decode_spec_key("npm__next").is_err());
114 }
115}