nodejs_versions.py

import datetime
from typing import TypedDict

import requests

todays_date = datetime.datetime.now(datetime.UTC).date().isoformat()


class NodeRelease(TypedDict):
    version: str
    date: str
    files: list[str]


def fetch_node_releases() -> list[NodeRelease]:
    """Fetch official node releases"""
    url = "https://nodejs.org/dist/index.json"
    res = requests.get(url, timeout=10.0)
    res.raise_for_status()
    data: list[NodeRelease] = res.json()
    return data


def fetch_node_unofficial_releases() -> list[NodeRelease]:
    url = "https://unofficial-builds.nodejs.org/download/release/index.json"
    res = requests.get(url, timeout=10.0)
    res.raise_for_status()
    data: list[NodeRelease] = res.json()
    return data


class ReleaseScheduleItem(TypedDict):
    start: str
    lts: str
    maintenance: str
    end: str
    codename: str


def fetch_nodejs_release_schedule() -> dict[str, ReleaseScheduleItem]:
    """Download list of official releases, skipping unreleased and unsupported versions"""
    res = requests.get("https://raw.githubusercontent.com/nodejs/Release/master/schedule.json", timeout=10.0)
    res.raise_for_status()
    release_schedule: dict[str, ReleaseScheduleItem] = res.json()
    return release_schedule