dist: Migrate from Zulu Discovery API to Azul Metadata API

[jameswald]

Used Claude Sonnet 4.6 to implement https://docs.azul.com/core/detailed/metadata-api-migration.html. If it's way off the mark then we can close it but if it's salvageable then please feel free to push any necessary commits on top of what is already done although I believe the changes I've made for this PR are complete.

Summary

Migrates the zulu distribution from the deprecated Zulu Discovery API (https://api.azul.com/zulu/download/community/v1.0/bundles/) to the new Azul Metadata API (https://api.azul.com/metadata/v1/zulu/packages/).

Background

The old Zulu Discovery API was returning HTTP 520 errors for a few hours, breaking all distribution: zulu workflows. Since the beginning of 2023 Azul has recommended the Metadata API and published a migration guide.

Changes

src/distributions/zulu/models.ts

Updated IZuluVersions to match the new API response shape:

• id: number → package_uuid: string
• url → download_url
• jdk_version → java_version
• zulu_version → distro_version
• Added latest: boolean and availability_type: string

src/distributions/zulu/installer.ts

• New API base URL: https://api.azul.com/metadata/v1/zulu/packages/
• Renamed query parameters: ext → archive_type, bundle_type → java_package_type, javafx → javafx_bundled
• Removed hw_bitness and abi query parameters (no longer part of the API)
• Added availability_types=ca to restrict to free community builds
• Pagination: the new API is paginated; added a loop that iterates through all pages until an empty page is returned
• Simplified getArchitectureOptions(): now returns a plain string instead of {arch, hw_bitness, abi}. Architecture mapping: x64 → x64, x86 → x86, arm64/aarch64 → aarch64
• Linux platform: returns linux_glibc instead of linux to exclude musl packages, which standard GitHub-hosted runners do not use
• Fixed a typo: win_aarhc4 → win_aarch64

README.md

Updated the architecture-mapping note to reflect the new API's conventions (arm64 → aarch64).

Test fixtures and tests

• Updated all three fixture files (zulu-releases-default.json, zulu-linux.json, zulu-windows.json) to use the new field names
• Updated URL assertions in all three installer test files to match the new endpoint and parameter names
• Updated getArchitectureOptions test cases to expect strings instead of objects
• Removed the DistroArch type (no longer needed)

Related issue

Fixes #795

Check list

• Documentation updated (README.md)
• Tests added/updated to cover the changes

Fixes #795
Fixes #636

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Migrates the Zulu (Azul) distribution from the deprecated zulu/download/community/v1.0 API to the new metadata/v1/zulu/packages API, updating request parameters, response model fields, and architecture mapping accordingly.

Changes:

• Switched API endpoint and renamed query parameters (e.g., ext → archive_type, bundle_type → java_package_type, javafx → javafx_bundled); replaced hw_bitness/abi with a single arch value and added availability_types, page, page_size parameters.
• Updated IZuluVersions model to use new field names (package_uuid, download_url, java_version, distro_version, latest, availability_type).
• Updated tests and fixture data to align with the new API contract; updated README note about arch mapping.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/distributions/zulu/models.ts	Updated IZuluVersions interface to new Azul Metadata API schema.
src/distributions/zulu/installer.ts	Updated request URL/params, response field references, and simplified getArchitectureOptions to return a single string.
tests/distributors/zulu-installer.test.ts	Updated expected URLs and arch mapping assertions for macOS.
tests/distributors/zulu-linux-installer.test.ts	Updated expected URLs and arch mapping for Linux.
tests/distributors/zulu-windows-installer.test.ts	Updated expected URLs and arch mapping for Windows.
tests/data/zulu-windows.json	Regenerated fixture to match new API response schema.
tests/data/zulu-linux.json	Regenerated fixture to match new API response schema.
tests/data/zulu-releases-default.json	Regenerated fixture to match new API response schema.
README.md	Updated note about Zulu architecture mapping.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jameswald]

Unintentionally implemented many of the same changes from #998 although the scope of this PR is a bit narrower.

[jameswald]

Thanks @brunoborges! The additional changes look solid.

[brunoborges]

Linking the tracking issue: this PR implements #795 (Migrate to the new Azul Metadata API). Maintainers — adding Closes #795 to the PR description will auto-close the issue on merge.