@faststats/sourcemap-uploader-plugin

[!IMPORTANT] This repository is in early development and not intended for production use. Its only published for internal testing.

Unplugin-based sourcemap uploader that works across all unplugin adapters:

• Vite
• Rollup
• Rolldown
• Webpack
• Rspack
• esbuild
• Unloader
• Farm
• Bun

What it does

• injects build metadata in the bundle at globalThis.__SOURCEMAPS_BUILD__
• uploads generated sourcemaps to a backend endpoint
• supports custom buildId or auto-generated IDs
• prefers native bundler build IDs when available (webpack/rspack compilation hash)
• optionally deletes sourcemap files after successful upload

Usage

import sourcemapsPlugin from "@sourcemaps/bundler-plugin/vite";

export default {
  plugins: [
    sourcemapsPlugin({
      endpoint: "http://localhost:3000/api/sourcemaps",
      deleteAfterUpload: true,
    }),
  ],
};

Options

• endpoint (required): upload URL
• enabled: true by default; set false or pass (framework) => boolean to disable the plugin conditionally
• authToken: bearer token for the upload request
• buildId: custom build identifier
• deleteAfterUpload: remove sourcemap files after successful upload
• globalKey: runtime global key for build metadata
• fetchImpl: custom fetch implementation
• onUploadSuccess: callback after successful upload
• onUploadError: callback when upload fails

Tests

bun test