Skip to content

Support Source Map Uploads in HyperDX v2 #1544

Open

Description

@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

Activity

  1. brandon-pereira commented on Jan 2, 2026

    @brandon-pereira
    Member

    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!

  2. astralhpi commented on Jan 3, 2026

    @astralhpi
    Author

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

  3. changed the title [-]Support source map upload for ClickStack deployments[/-] [+]Support Source Map Uploads in HyperDX v2[/+] on Jan 4, 2026
  4. jkrumm commented on May 20, 2026

    @jkrumm

    Any updates regarding Sourcemap upload support?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions