Skip to content

Commit 37dec44

Browse files
committed
feat: support the Alpha release phase
Node.js 27 introduces Alpha releases versioned as vN.0.0-alpha.X.Y.Z (see nodejs/node#63135). - Keep Alpha versions in the release data instead of letting nodevu coerce them into vN.0.0, and give them the new Alpha status. - Add a /download/alpha page and warn that Alpha releases are not meant for production. - Fall back to the latest LTS on /download/current and /download/archive/current while there is no Current release. - Match pre-releases in the platform and installer checks. Refs: nodejs/Release#1187 Signed-off-by: RafaelGSS <[email protected]>
1 parent 7c40136 commit 37dec44

18 files changed

Lines changed: 359 additions & 13 deletions

File tree

‎.changeset/brave-alpha-releases.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
'@node-core/website-i18n': patch
3+
---
4+
5+
Add the Alpha release warning.

‎apps/site/app/[locale]/download/archive/[version]/page.tsx‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,10 @@ const getPage: FC<PageParams> = async props => {
5151
if (version === 'current') {
5252
const releaseData = await provideReleaseData();
5353

54-
const release = releaseData.find(release => release.status === 'Current');
54+
// There's no Current release while the next major is in its Alpha phase
55+
const release =
56+
releaseData.find(release => release.status === 'Current') ??
57+
releaseData.find(release => release.status === 'LTS');
5558

5659
redirect(`/${locale}/download/archive/${release?.versionWithPrefix}`);
5760
}

‎apps/site/components/Downloads/Release/VersionDropdown.tsx‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,10 @@ const VersionDropdown: FC = () => {
2727
({ versionWithPrefix }) => versionWithPrefix === version
2828
);
2929

30-
if (release?.status === 'LTS' && pathname.includes('current')) {
30+
if (
31+
release?.status === 'LTS' &&
32+
(pathname.includes('current') || pathname.includes('alpha'))
33+
) {
3134
redirect({ href: '/download', locale });
3235
return;
3336
}
@@ -37,6 +40,11 @@ const VersionDropdown: FC = () => {
3740
return;
3841
}
3942

43+
if (release?.status === 'Alpha' && !pathname.includes('alpha')) {
44+
redirect({ href: '/download/alpha', locale });
45+
return;
46+
}
47+
4048
setVersion(version);
4149
};
4250

‎apps/site/components/withDownloadSection.tsx‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import {
99
ReleasesProvider,
1010
} from '#site/providers/releaseProvider';
1111

12-
import type { NodeRelease } from '../types';
12+
import type { NodeRelease, NodeReleaseStatus } from '../types';
1313
import type { FC, PropsWithChildren } from 'react';
1414

1515
type WithDownloadSectionProps = PropsWithChildren<{
@@ -39,7 +39,11 @@ const WithDownloadSection: FC<WithDownloadSectionProps> = async ({
3939
.concat(localeSnippets);
4040

4141
// Decides which initial release to use based on the current pathname
42-
const initialRelease = pathname.endsWith('/current') ? 'Current' : 'LTS';
42+
const initialRelease: Array<NodeReleaseStatus> = pathname.endsWith('/alpha')
43+
? ['Alpha', 'Current', 'LTS']
44+
: pathname.endsWith('/current')
45+
? ['Current', 'LTS']
46+
: ['LTS'];
4347

4448
return (
4549
<WithNodeRelease status={initialRelease}>

‎apps/site/components/withReleaseAlertBox.tsx‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,22 @@ const WithReleaseAlertBox: FC<WithReleaseAlertBoxProps> = ({ status }) => {
2626
})}
2727
</AlertBox>
2828
);
29+
case 'Alpha':
30+
return (
31+
<AlertBox
32+
title={t('components.common.alertBox.warning')}
33+
level="warning"
34+
size="small"
35+
>
36+
{t.rich('layouts.download.codeBox.alphaVersionWarning', {
37+
link: text => (
38+
<Link href="/blog/announcements/evolving-the-nodejs-release-schedule">
39+
{text}
40+
</Link>
41+
),
42+
})}
43+
</AlertBox>
44+
);
2945
case 'LTS':
3046
return (
3147
<AlertBox
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
import assert from 'node:assert/strict';
2+
import { describe, it } from 'node:test';
3+
4+
import getMajorNodeReleases from '#site/next-data/generators/majorNodeReleases.mjs';
5+
6+
const createRelease = (version, date, lts = false) => ({
7+
version,
8+
date,
9+
files: [],
10+
npm: '11.0.0',
11+
v8: '14.0.0.0',
12+
modules: '150',
13+
lts,
14+
security: false,
15+
});
16+
17+
const SCHEDULE = {
18+
v26: {
19+
start: '2026-05-05',
20+
lts: '2026-10-28',
21+
maintenance: '2027-10-20',
22+
end: '2029-04-30',
23+
codename: '',
24+
},
25+
v27: {
26+
alpha: '2026-10-28',
27+
start: '2027-04-22',
28+
lts: '2027-10-20',
29+
end: '2030-04-30',
30+
codename: '',
31+
},
32+
};
33+
34+
const mockFetch = (index, schedule = SCHEDULE) => {
35+
globalThis.fetch = async url => ({
36+
json: async () => (url.includes('schedule') ? schedule : index),
37+
});
38+
};
39+
40+
describe('getMajorNodeReleases', () => {
41+
it('keeps the pre-release identifiers of Alpha releases', async () => {
42+
mockFetch([
43+
createRelease('v27.0.0-alpha.1.0.0', '2026-11-25'),
44+
createRelease('v27.0.0-alpha.0.0.0', '2026-10-28'),
45+
createRelease('v26.1.0', '2026-10-28', 'Codename'),
46+
]);
47+
48+
const majors = await getMajorNodeReleases();
49+
50+
assert.deepEqual(
51+
majors.map(([version]) => version),
52+
['v27', 'v26']
53+
);
54+
55+
const [, v27] = majors[0];
56+
57+
assert.deepEqual(Object.keys(v27.releases), [
58+
'v27.0.0-alpha.1.0.0',
59+
'v27.0.0-alpha.0.0.0',
60+
]);
61+
assert.equal(
62+
v27.releases['v27.0.0-alpha.1.0.0'].semver.raw,
63+
'27.0.0-alpha.1.0.0'
64+
);
65+
assert.equal(v27.releases['v27.0.0-alpha.1.0.0'].semver.major, 27);
66+
assert.equal(v27.releases['v27.0.0-alpha.1.0.0'].lts.isLts, false);
67+
assert.equal(v27.support.phases.dates.end, '2030-04-30');
68+
});
69+
70+
it('lists Alpha releases after the stable releases of the same line', async () => {
71+
mockFetch([
72+
createRelease('v27.0.0', '2027-04-22'),
73+
createRelease('v27.0.0-alpha.1.0.0', '2026-11-25'),
74+
createRelease('v27.0.0-alpha.0.0.0', '2026-10-28'),
75+
]);
76+
77+
const [[version, v27]] = await getMajorNodeReleases();
78+
79+
assert.equal(version, 'v27');
80+
assert.deepEqual(Object.keys(v27.releases), [
81+
'v27.0.0',
82+
'v27.0.0-alpha.1.0.0',
83+
'v27.0.0-alpha.0.0.0',
84+
]);
85+
});
86+
87+
it('ignores Alpha releases of release lines without documented support', async () => {
88+
mockFetch([
89+
createRelease('v28.0.0-alpha.0.0.0', '2027-10-27'),
90+
createRelease('v26.1.0', '2026-10-28', 'Codename'),
91+
]);
92+
93+
const majors = await getMajorNodeReleases();
94+
95+
assert.deepEqual(
96+
majors.map(([version]) => version),
97+
['v26']
98+
);
99+
});
100+
});

‎apps/site/next-data/generators/__tests__/releaseData.test.mjs‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,74 @@ describe('generateReleaseData', () => {
130130
assert.equal(result[0]?.status, 'Current');
131131
});
132132

133+
it('returns Alpha when release is not EOL and latest is a pre-release', async t => {
134+
const result = await runWithNodevuData(t, '2026-11-01', {
135+
27: {
136+
releases: {
137+
'v27.0.0-alpha.0.0.0': {
138+
semver: { major: 27, raw: '27.0.0-alpha.0.0.0' },
139+
dependencies: { npm: '11.6.0', v8: '14.6.0.0' },
140+
lts: { isLts: false },
141+
releaseDate: '2026-10-28',
142+
modules: { version: '150' },
143+
},
144+
},
145+
support: {
146+
phases: {
147+
dates: {
148+
alpha: '2026-10-28',
149+
start: '2027-04-22',
150+
maintenance: '2027-10-20',
151+
end: '2030-04-30',
152+
},
153+
},
154+
},
155+
},
156+
});
157+
158+
assert.equal(result[0]?.status, 'Alpha');
159+
assert.equal(result[0]?.versionWithPrefix, 'v27.0.0-alpha.0.0.0');
160+
});
161+
162+
it('returns Current when latest is a stable release following pre-releases', async t => {
163+
const result = await runWithNodevuData(t, '2027-04-22', {
164+
27: {
165+
releases: {
166+
'v27.0.0': {
167+
semver: { major: 27, raw: '27.0.0' },
168+
dependencies: { npm: '11.6.0', v8: '14.6.0.0' },
169+
lts: { isLts: false },
170+
releaseDate: '2027-04-22',
171+
modules: { version: '150' },
172+
},
173+
'v27.0.0-alpha.0.0.0': {
174+
semver: { major: 27, raw: '27.0.0-alpha.0.0.0' },
175+
dependencies: { npm: '11.6.0', v8: '14.6.0.0' },
176+
lts: { isLts: false },
177+
releaseDate: '2026-10-28',
178+
modules: { version: '150' },
179+
},
180+
},
181+
support: {
182+
phases: {
183+
dates: {
184+
alpha: '2026-10-28',
185+
start: '2027-04-22',
186+
maintenance: '2027-10-20',
187+
end: '2030-04-30',
188+
},
189+
},
190+
},
191+
},
192+
});
193+
194+
assert.equal(result[0]?.status, 'Current');
195+
assert.equal(
196+
result[0]?.minorVersions[1]?.versionWithPrefix,
197+
'v27.0.0-alpha.0.0.0'
198+
);
199+
});
200+
133201
it('uses latest and earliest release dates for latestReleaseDate and initialReleaseDate', async t => {
134202
const result = await runWithNodevuData(t, '2026-04-14', {
135203
26: {

‎apps/site/next-data/generators/majorNodeReleases.mjs‎

Lines changed: 56 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,69 @@
11
'use strict';
22

33
import nodevu from '@nodevu/core';
4+
import semVer from 'semver';
45

56
import { fetchWithRetry } from '#site/next.fetch.mjs';
67

8+
const toNodevuRelease = ({ version, date, npm, v8, modules, lts }) => {
9+
const { version: raw, major, minor, patch } = semVer.parse(version);
10+
11+
return {
12+
semver: { raw, major, minor, patch, line: `v${major}` },
13+
releaseDate: date,
14+
modules: { version: modules },
15+
dependencies: { npm, v8 },
16+
lts: { isLts: !!lts },
17+
};
18+
};
19+
720
/**
821
* Filters Node.js release data to return only major releases with documented support.
922
*/
1023
export default async function getMajorNodeReleases() {
11-
const nodevuData = await nodevu({ fetch: fetchWithRetry });
24+
const preReleases = [];
25+
let schedule = {};
26+
27+
// nodevu coerces versions (v27.0.0-alpha.0.0.0 becomes v27.0.0), hence
28+
// pre-releases are removed before nodevu parses index.json and added back
29+
const fetchWithoutPreReleases = async (url, options) => {
30+
const data = await fetchWithRetry(url, options).then(r => r.json());
31+
32+
if (!Array.isArray(data)) {
33+
schedule = data;
34+
35+
return Response.json(data);
36+
}
37+
38+
preReleases.push(
39+
...data.filter(({ version }) => semVer.prerelease(version))
40+
);
41+
42+
return Response.json(data.filter(r => !preReleases.includes(r)));
43+
};
44+
45+
const releaseLines = await nodevu({ fetch: fetchWithoutPreReleases });
46+
47+
const preReleaseLines = {};
48+
49+
preReleases.forEach(release => {
50+
const line = `v${semVer.major(release.version)}`;
51+
52+
if (!releaseLines[line] && !preReleaseLines[line]) {
53+
const { codename, ...dates } = schedule[line] ?? {};
54+
55+
preReleaseLines[line] = {
56+
releases: {},
57+
support: schedule[line] && { codename, phases: { dates } },
58+
};
59+
}
60+
61+
const { releases } = releaseLines[line] ?? preReleaseLines[line];
62+
63+
releases[release.version] = toNodevuRelease(release);
64+
});
65+
66+
const nodevuData = { ...preReleaseLines, ...releaseLines };
1267

1368
return Object.entries(nodevuData).filter(([version, { support }]) => {
1469
// Filter out those without documented support

‎apps/site/next-data/generators/releaseData.mjs‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
'use strict';
22

3+
import semVer from 'semver';
4+
35
import getMajorNodeReleases from './majorNodeReleases.mjs';
46

57
// Gets the appropriate release status for each major release
@@ -14,6 +16,10 @@ const getNodeReleaseStatus = (latest, eol) => {
1416
return 'LTS';
1517
}
1618

19+
if (semVer.prerelease(latest.semver.raw)) {
20+
return 'Alpha';
21+
}
22+
1723
return 'Current';
1824
};
1925

‎apps/site/next.constants.mjs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,7 @@ export const STATUS_KIND_MAP = {
145145
EOL: 'warning',
146146
LTS: 'info',
147147
Current: 'default',
148+
Alpha: 'default',
148149
};
149150

150151
/**

0 commit comments

Comments
 (0)