Map Zulu x86 architecture to i686 for Azul Metadata API

[brunoborges]

Summary

Follow-up to #1010 (Azul Metadata API migration). Fixes a regression where an explicit architecture: x86 request for the Zulu distribution could resolve to a 64-bit JDK.

Problem

The migration mapped code arch x86 → API arch=x86. However, the Azul Metadata API's arch=x86 returns both 32-bit (i686) and 64-bit (x64) packages. The two variants share identical java_version and distro_version, so findPackageForDownload cannot distinguish them and picks whichever the API returns first.

Consequences for architecture: x86:

• It frequently resolves to a 64-bit build instead of 32-bit.
• For Java 21+ (where Azul dropped 32-bit), it silently returns a 64-bit JDK instead of failing.

The legacy Zulu Discovery API avoided this by using arch=x86&hw_bitness=32, which returned only 32-bit builds.

Fix

Map x86 → i686. The Metadata API's arch=i686 returns only genuine 32-bit builds, with verified full version parity to the legacy 32-bit behavior:

Platform	legacy x86 + hw_bitness=32	new i686	lost
linux	141 versions	141	0
windows	143 versions	143	0

x64 and aarch64 resolution are unaffected.

Testing

• Updated the three Zulu installer test suites (URL query params + getArchitectureOptions mapping).
• Full suite passes (855 tests).
• dist/ rebuilt.

[Copilot]

Pull request overview

This PR fixes Azul Zulu architecture resolution for explicit architecture: x86 requests after the migration to the Azul Metadata API, ensuring x86 consistently targets true 32-bit builds rather than sometimes resolving to 64-bit packages.

Changes:

• Map Zulu x86 architecture requests to Azul Metadata API arch=i686 to return only 32-bit packages.
• Update Zulu installer tests to assert the new arch=i686 query parameter and expected architecture mapping.
• Rebuild dist/ to reflect the source change.

Show a summary per file

File	Description
src/distributions/zulu/installer.ts	Changes x86 mapping to i686 to ensure only genuine 32-bit Zulu builds are returned by the Metadata API.
dist/setup/index.js	Updates the compiled distribution output to match the new x86 → i686 mapping.
tests/distributors/zulu-windows-installer.test.ts	Updates URL/query assertions and architecture mapping expectations for Windows Zulu.
tests/distributors/zulu-linux-installer.test.ts	Updates URL/query assertions and architecture mapping expectations for Linux Zulu.
tests/distributors/zulu-installer.test.ts	Updates URL/query assertions and architecture mapping expectations in the generic Zulu installer tests.

Review details

Tip

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

• Files reviewed: 4/5 changed files
• Comments generated: 0
• Review effort level: Low

[gdams]

Should we not include i386 in this logic too? Or does the Azul API specifically map to i686?

[brunoborges]

Seems clear to me this is a matter of them mapping i686