[BUG] CLI hangs indefinitely when `--registry-url `points to an unreachable host (no timeout handling)

[sahillllllllll-bit]

Describe the bug.

When the CLI is executed with a --registry-url that is unreachable (e.g., a blackholed IP), the command hangs indefinitely instead of failing fast.

Root cause is in:

cli/src/utils/generate/registry.ts

Function:

registryValidation()

Problematic code:

await fetch(registryUrl as string);

Issues:

• No timeout
• No AbortController
• Uses default GET instead of lightweight HEAD
• Swallows original network error
• Blocks CLI execution indefinitely

This causes:

• CLI freeze
• CI pipeline stalls
• Poor UX
• No actionable error feedback

Expected behavior

CLI should:

• Fail fast (e.g., 3–5s timeout)
• Display meaningful error message
• Exit cleanly

Screenshots

How to Reproduce

Run:

asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template \
  --registry-url http://10.255.255.1

CLI will hang instead of exiting with an error.

🖥️ Device Information [optional]

• Operating System (OS):Windows(WSL)
• Browser:
• Browser Version:

👀 Have you checked for similar open issues?

• I checked and didn't find similar issue

🏢 Have you read the Contributing Guidelines?

• I have read the Contributing Guidelines

Are you willing to work on this issue ?

Yes I am willing to submit a PR!

[sahillllllllll-bit]

@Shurtu-gal @AayushSaini101 @Souvikns waiting for maintainer approval :)

[AayushSaini101]

@Shurtu-gal @AayushSaini101 @Souvikns waiting for maintainer approval :)

@sahillllllllll-bit nice, if the host is not valid, do we need explicity close the terminal ?

[sahillllllllll-bit]

@Shurtu-gal @AayushSaini101 @Souvikns waiting for maintainer approval :)

@sahillllllllll-bit nice, if the host is not valid, do we need explicity close the terminal ?

Yes, currently the CLI does not fail fast.
It waits on the underlying TCP timeout from fetch, which can take a long time depending on the OS.

In my testing (WSL), it hangs until manually interrupted with Ctrl+C.

The issue originates in:

cli/src/utils/generate/registry.ts

here:

await fetch(registryUrl as string);

Since fetch is called without an AbortController or timeout handling, it relies on the OS-level TCP timeout, which causes the indefinite hang.

also if you have time please take a look at these issues : #2018 #2017

[md-amer]

Hi @AayushSaini101 @Shurtu-gal, I'd like to work on this.

Proposed fix:

• Add AbortController with a 5-second timeout to the fetch call in registryValidation()
• Switch from GET to HEAD for a lighter validation request
• Provide a clear timeout-specific error message (Registry URL timed out after 5s)
• Clean up the timer with clearTimeout in a finally block

Will submit a PR shortly.