fix(cli): bundle resolver uses /HEAD/ instead of /main/ (JavaScriptSolidServer#487)

melvincarvalho · web-flow · commit 128990962731 · 2026-05-18T06:56:02.000+02:00
GitHub's raw URLs resolve /HEAD/ to the repo's default branch
automatically. Works for both gh-pages-default repos (solid-apps
convention) and main-default repos (everyone else's GitHub
default). Better than picking one branch name.

Smoke: `jss install --bundle starter` against
solid-apps/bundles (default branch gh-pages) → 4/4 installed
end-to-end.
diff --git a/src/cli/install.js b/src/cli/install.js
@@ -91,8 +91,8 @@ function parseAppSpec(input) {
  * Resolve a `--bundle` source string to either a fully-qualified URL
  * or an absolute local-file path.
  *
- *   --bundle media                  → github.com/solid-apps/bundles/main/media.jsonld
- *   --bundle <org>/<repo>           → github.com/<org>/<repo>/main/bundle.jsonld
+ *   --bundle media                  → github.com/solid-apps/bundles/HEAD/media.jsonld
+ *   --bundle <org>/<repo>           → github.com/<org>/<repo>/HEAD/bundle.jsonld
  *   --bundle https://...            → as-is (must end in a JSON-LD doc)
  *   --bundle ./path or /abs/path    → absolute local-file path
  *
@@ -118,12 +118,12 @@ function resolveBundleSource(input) {
     if (cleaned.split('/').length !== 2) {
       return { error: 'expected <org>/<repo> shorthand for bundle source' };
     }
-    return { url: `https://raw.githubusercontent.com/${cleaned}/main/bundle.jsonld` };
+    return { url: `https://raw.githubusercontent.com/${cleaned}/HEAD/bundle.jsonld` };
   }
   if (!/^[a-z0-9][a-z0-9_.-]*$/i.test(input)) {
     return { error: `invalid bundle name "${input}"` };
   }
-  return { url: `https://raw.githubusercontent.com/solid-apps/bundles/main/${input}.jsonld` };
+  return { url: `https://raw.githubusercontent.com/solid-apps/bundles/HEAD/${input}.jsonld` };
 }
 
 /**

Original file line number	Diff line number	Diff line change
`@@ -91,8 +91,8 @@ function parseAppSpec(input) {`
`91`	`91`	* Resolve a `--bundle` source string to either a fully-qualified URL
`92`	`92`	`* or an absolute local-file path.`
`93`	`93`	`*`
`94`		`- * --bundle media → github.com/solid-apps/bundles/main/media.jsonld`
`95`		`- * --bundle <org>/<repo> → github.com/<org>/<repo>/main/bundle.jsonld`
	`94`	`+ * --bundle media → github.com/solid-apps/bundles/HEAD/media.jsonld`
	`95`	`+ * --bundle <org>/<repo> → github.com/<org>/<repo>/HEAD/bundle.jsonld`
`96`	`96`	`* --bundle https://... → as-is (must end in a JSON-LD doc)`
`97`	`97`	`* --bundle ./path or /abs/path → absolute local-file path`
`98`	`98`	`*`
`@@ -118,12 +118,12 @@ function resolveBundleSource(input) {`
`118`	`118`	`if (cleaned.split('/').length !== 2) {`
`119`	`119`	`return { error: 'expected <org>/<repo> shorthand for bundle source' };`
`120`	`120`	`}`
`121`		- return { url: `https://raw.githubusercontent.com/${cleaned}/main/bundle.jsonld` };
	`121`	+ return { url: `https://raw.githubusercontent.com/${cleaned}/HEAD/bundle.jsonld` };
`122`	`122`	`}`
`123`	`123`	`if (!/^[a-z0-9][a-z0-9_.-]*$/i.test(input)) {`
`124`	`124`	return { error: `invalid bundle name "${input}"` };
`125`	`125`	`}`
`126`		- return { url: `https://raw.githubusercontent.com/solid-apps/bundles/main/${input}.jsonld` };
	`126`	+ return { url: `https://raw.githubusercontent.com/solid-apps/bundles/HEAD/${input}.jsonld` };
`127`	`127`	`}`
`128`	`128`
`129`	`129`	`/**`