1#[derive(Debug, Clone, PartialEq, Eq)]
15pub enum ParsedSpec {
16 Npm {
17 pkg: String,
18 name: String,
19 },
20 Github {
21 owner: String,
22 repo: String,
23 name: String,
24 },
25 Unknown {
26 ecosystem: String,
27 payload: String,
28 name: String,
29 },
30}
31
32impl ParsedSpec {
33 pub fn name(&self) -> &str {
35 match self {
36 ParsedSpec::Npm { name, .. }
37 | ParsedSpec::Github { name, .. }
38 | ParsedSpec::Unknown { name, .. } => name,
39 }
40 }
41}
42
43pub fn parse_spec(spec: &str) -> ParsedSpec {
48 let Some(colon_idx) = spec.find(':') else {
49 return ParsedSpec::Unknown {
50 ecosystem: String::new(),
51 payload: spec.to_string(),
52 name: spec.to_string(),
53 };
54 };
55 let ecosystem = &spec[..colon_idx];
56 let payload = &spec[colon_idx + 1..];
57
58 if ecosystem == "npm" {
59 return ParsedSpec::Npm {
60 pkg: payload.to_string(),
61 name: slugify_npm_name(payload),
62 };
63 }
64
65 if ecosystem == "github" {
66 match payload.split_once('/') {
69 Some((owner, repo)) => {
70 return ParsedSpec::Github {
71 owner: owner.to_string(),
72 repo: repo.to_string(),
73 name: repo.to_string(),
74 };
75 }
76 None => {
77 return ParsedSpec::Unknown {
78 ecosystem: ecosystem.to_string(),
79 payload: payload.to_string(),
80 name: payload.to_string(),
81 };
82 }
83 }
84 }
85
86 ParsedSpec::Unknown {
87 ecosystem: ecosystem.to_string(),
88 payload: payload.to_string(),
89 name: payload.to_string(),
90 }
91}
92
93pub fn library_name_from_spec(spec: &str) -> String {
95 parse_spec(spec).name().to_string()
96}
97
98pub fn split_explicit_version(input: &str) -> (&str, Option<&str>) {
106 match input.rfind('@') {
107 None => (input, None),
108 Some(0) => (input, None),
110 Some(idx) if input.as_bytes()[idx - 1] == b':' => (input, None),
111 Some(idx) => (&input[..idx], Some(&input[idx + 1..])),
112 }
113}
114
115pub fn slugify_npm_name(pkg_name: &str) -> String {
119 if is_scoped_pkg(pkg_name) {
120 pkg_name[1..].replacen('/', "-", 1)
122 } else {
123 pkg_name.to_string()
124 }
125}
126
127fn is_scoped_pkg(s: &str) -> bool {
131 let Some(rest) = s.strip_prefix('@') else {
132 return false;
133 };
134 match rest.split_once('/') {
135 Some((scope, name)) => !scope.is_empty() && !name.is_empty() && !name.contains('/'),
138 None => false,
139 }
140}
141
142#[cfg(test)]
143mod tests {
144 use super::*;
145
146 #[test]
147 fn npm_unscoped() {
148 assert_eq!(
149 parse_spec("npm:next"),
150 ParsedSpec::Npm {
151 pkg: "next".into(),
152 name: "next".into()
153 }
154 );
155 }
156
157 #[test]
158 fn npm_scoped_is_flattened() {
159 assert_eq!(
160 parse_spec("npm:@mastra/client-js"),
161 ParsedSpec::Npm {
162 pkg: "@mastra/client-js".into(),
163 name: "mastra-client-js".into(),
164 }
165 );
166 }
167
168 #[test]
169 fn github_repo_keeps_dots() {
170 assert_eq!(
171 parse_spec("github:vercel/next.js"),
172 ParsedSpec::Github {
173 owner: "vercel".into(),
174 repo: "next.js".into(),
175 name: "next.js".into(),
176 }
177 );
178 }
179
180 #[test]
181 fn github_without_slash_is_unknown() {
182 assert_eq!(
183 parse_spec("github:justarepo"),
184 ParsedSpec::Unknown {
185 ecosystem: "github".into(),
186 payload: "justarepo".into(),
187 name: "justarepo".into(),
188 }
189 );
190 }
191
192 #[test]
193 fn no_colon_is_unknown_empty_ecosystem() {
194 assert_eq!(
195 parse_spec("next"),
196 ParsedSpec::Unknown {
197 ecosystem: String::new(),
198 payload: "next".into(),
199 name: "next".into(),
200 }
201 );
202 }
203
204 #[test]
205 fn unknown_ecosystem_passthrough() {
206 assert_eq!(
207 parse_spec("pypi:fastapi"),
208 ParsedSpec::Unknown {
209 ecosystem: "pypi".into(),
210 payload: "fastapi".into(),
211 name: "fastapi".into(),
212 }
213 );
214 }
215
216 #[test]
217 fn github_owner_repo_with_subpath_splits_on_first_slash() {
218 assert_eq!(
220 parse_spec("github:owner/repo/extra"),
221 ParsedSpec::Github {
222 owner: "owner".into(),
223 repo: "repo/extra".into(),
224 name: "repo/extra".into(),
225 }
226 );
227 }
228
229 #[test]
230 fn library_name_helper_matches_variant_name() {
231 assert_eq!(
232 library_name_from_spec("npm:@mastra/client-js"),
233 "mastra-client-js"
234 );
235 assert_eq!(library_name_from_spec("github:vercel/next.js"), "next.js");
236 assert_eq!(library_name_from_spec("react"), "react");
237 }
238
239 #[test]
240 fn split_explicit_version_cases() {
241 assert_eq!(
242 split_explicit_version("npm:next@14"),
243 ("npm:next", Some("14"))
244 );
245 assert_eq!(
246 split_explicit_version("github:vercel/next.js@v14.2.3"),
247 ("github:vercel/next.js", Some("v14.2.3"))
248 );
249 assert_eq!(split_explicit_version("@vercel/ai"), ("@vercel/ai", None));
251 assert_eq!(
253 split_explicit_version("npm:@vercel/ai"),
254 ("npm:@vercel/ai", None)
255 );
256 assert_eq!(
258 split_explicit_version("npm:@vercel/ai@5.0.0"),
259 ("npm:@vercel/ai", Some("5.0.0"))
260 );
261 assert_eq!(split_explicit_version("next"), ("next", None));
262 }
263
264 #[test]
265 fn slugify_edge_cases() {
266 assert_eq!(slugify_npm_name("next"), "next");
267 assert_eq!(slugify_npm_name("@scope/pkg"), "scope-pkg");
268 assert_eq!(slugify_npm_name("@notscoped"), "@notscoped");
270 assert_eq!(slugify_npm_name("@a/b/c"), "@a/b/c");
272 }
273}