Support Source Map Uploads in HyperDX v2

[astralhpi]

Problem

When using the latest version of HyperDX (v2), there's no way to upload JavaScript source maps. The @hyperdx/cli upload-sourcemaps command only works with the HyperDX Cloud (v1), as it requires the /api/v1/sourcemaps/upload-presigned-urls endpoint.

This means frontend errors captured via @hyperdx/browser SDK show minified stack traces, making debugging difficult.

Current Behaviour

npx @hyperdx/cli upload-sourcemaps \
  --serviceKey "..." \
  --apiUrl "https://my-clickstack-instance" \
  --path .next

# Fails because HyperDX doesn't have the sourcemap upload API

Expected Behaviour

HyperDX deployments should support source map uploads, either:

1. Built-in storage within HyperDX (e.g., storing source maps in ClickHouse or a configurable S3-compatible storage)
2. Client-side source map resolution (as suggested in Resolve sourcemaps from captured frontend stack frames client side #1501)
3. Documentation for self-hosting the source map API component

Use Case

We're using HyperDX v2 for observability. We have a SvelteKit frontend instrumented with @hyperdx/browser for session replay and error tracking. Without source maps, stack traces in captured exceptions are unreadable.

Environment

• Deployment: ClickStack on ClickHouse Cloud
• Frontend: SvelteKit with @hyperdx/browser SDK
• Build tool: Vite (generates .js.map files)

Related

• Resolve sourcemaps from captured frontend stack frames client side #1501 - Client-side source map resolution proposal

[brandon-pereira]

Hey @astralhpi, thanks for raising this!

At the moment, the sourcemaps feature is only available in our v1 offering. We don’t currently support sourcemaps in v2, for either the managed or open-source deployments.

We are tracking sourcemap support for v2 internally, and I’ll bump that on your behalf 👍

It may make sense to keep this issue open, so others with the same question can find it. Would you be okay if I update the issue description to reflect the current state and what’s planned?

Let me know, and thanks again for flagging this!

[astralhpi]

Thanks for the clarification! Feel free to update the issue description - happy to help others find this info. Looking forward to v2 sourcemap support!