feat(downloads): add Linux x64 musl builds (#9220)

* feat(downloads): add linux x64 musl builds

* test(downloads): use published release versions

* fix(downloads): simplify musl version compatibility

Signed-off-by: Bellussi <enzobellussifam@gmail.com>

---------

Signed-off-by: Bellussi <enzobellussifam@gmail.com>

Author: bellussi1

apps/site/util/__tests__/download.test.mjs

@@ -10,6 +10,8 @@ import {
   PLATFORMS,
 } from '#site/util/download';
 
+import { buildReleaseArtifacts } from '../download/archive';
+
 describe('parseCompat', () => {
   it('should handle all OS, install methods, and package managers', () => {
     OPERATING_SYSTEMS.forEach(os => {
@@ -46,6 +48,39 @@ describe('parseCompat', () => {
     });
   });
 
+  it('should enable x64 musl only for releases that publish the artifact', () => {
+    const platform = PLATFORMS.LINUX.find(({ value }) => value === 'x64-musl');
+    assert.ok(
+      platform,
+      'Linux x64 musl should be available as a manual option'
+    );
+
+    const cases = [
+      ['v22.23.3', false],
+      ['v22.23.2', true],
+      ['v23.11.1', true],
+      ['v24.20.0', false],
+      ['v24.19.0', true],
+      ['v25.0.0', true],
+      ['v26.8.0', false],
+      ['v26.7.0', true],
+      ['v27.0.0', false],
+      ['v27.0.0-alpha.1', false],
+    ];
+
+    for (const [version, disabled] of cases) {
+      const [result] = parseCompat([platform], {
+        os: 'LINUX',
+        installMethod: '',
+        platform: 'x64-musl',
+        version,
+        release: { status: 'LTS' },
+      });
+
+      assert.equal(result.disabled, disabled, `compatibility for ${version}`);
+    }
+  });
+
   describe('extended tests', () => {
     it('should disable items if OS is not supported', () => {
       const items = [
@@ -156,6 +191,35 @@ describe('parseCompat', () => {
   });
 });
 
+describe('buildReleaseArtifacts', () => {
+  it('should list x64 musl only for versions with published artifacts', () => {
+    const cases = [
+      ['v22.23.3', true],
+      ['v22.23.2', false],
+      ['v23.11.1', false],
+      ['v24.20.0', true],
+      ['v24.19.0', false],
+      ['v25.0.0', false],
+      ['v26.8.0', true],
+      ['v26.7.0', false],
+      ['v27.0.0', true],
+      ['v27.0.0-alpha.1', true],
+    ];
+
+    for (const [version, shouldInclude] of cases) {
+      const { binaries } = buildReleaseArtifacts(
+        { minorVersions: [] },
+        version
+      );
+      const artifact = binaries.find(
+        ({ fileName }) => fileName === `node-${version}-linux-x64-musl.tar.xz`
+      );
+
+      assert.equal(Boolean(artifact), shouldInclude, `artifact for ${version}`);
+    }
+  });
+});
+
 describe('nextItem', () => {
   it('should find the first valid item if current is invalid', () => {
     const items = [

apps/site/util/__tests__/url.test.mjs

@@ -100,6 +100,18 @@ describe('getNodeDownloadUrl', () => {
     );
   });
 
+  it('should return the x64 musl Linux binary URL', () => {
+    assert.equal(
+      getNodeDownloadUrl({
+        versionWithPrefix: 'v24.20.0',
+        os: 'LINUX',
+        platform: 'x64-musl',
+        kind: 'binary',
+      }),
+      'https://nodejs.org/dist/v24.20.0/node-v24.20.0-linux-x64-musl.tar.xz'
+    );
+  });
+
   describe('MAC', () => {
     it('should return .pkg link for installer', () => {
       const url = getNodeDownloadUrl({

apps/site/util/download/archive.tsx

@@ -57,7 +57,7 @@ const getCompatiblePlatforms = (
     return items
       .filter(({ compatibility }) => {
         // In the download constants file (apps/site/util/download/constants.json),
-        //  if no compatibility is defined as a semver, we treat it as supporting all
+        //  if no semver compatibility is defined, we treat it as supporting all
         //  versions by default.
         if (!compatibility.semver) {
           return true;

apps/site/util/download/constants.json

@@ -65,6 +65,13 @@
           "label": "x64",
           "value": "x64"
         },
+        {
+          "label": "x64 (musl)",
+          "value": "x64-musl",
+          "compatibility": {
+            "semver": [">=22.23.3 <23.0.0-0 || >=24.20.0 <25.0.0-0 || >=26.8.0"]
+          }
+        },
         {
           "label": "ARMv7",
           "value": "armv7l",
@@ -238,7 +245,16 @@
     }
   ],
   "userOptions": {
-    "platforms": ["arm64", "armv7l", "ppc64le", "ppc64", "s390x", "x64", "x86"],
+    "platforms": [
+      "arm64",
+      "armv7l",
+      "ppc64le",
+      "ppc64",
+      "s390x",
+      "x64",
+      "x64-musl",
+      "x86"
+    ],
     "bitness": ["64", "32"],
     "architecture": ["arm", "x86"]
   },