@bugsnag/source-maps

What is @bugsnag/source-maps?

@bugsnag/source-maps is an npm package that helps you upload source maps to Bugsnag, a tool for monitoring and reporting errors in applications. Source maps are used to map minified code back to the original source code, making it easier to debug errors in production environments.

What are @bugsnag/source-maps's main functionalities?

Uploading Browser Source Maps

This feature allows you to upload source maps for browser-based applications. The code sample demonstrates how to upload a source map file along with the minified JavaScript file to Bugsnag.

const { upload } = require('@bugsnag/source-maps');

upload({
  apiKey: 'YOUR_API_KEY',
  appVersion: '1.2.3',
  minifiedUrl: 'https://example.com/app.min.js',
  sourceMap: 'path/to/app.min.js.map',
  minifiedFile: 'path/to/app.min.js',
  overwrite: true
}).then(() => {
  console.log('Source map uploaded successfully');
}).catch(err => {
  console.error('Failed to upload source map', err);
});

Uploading Node.js Source Maps

This feature allows you to upload source maps for Node.js applications. The code sample shows how to upload a source map file along with the corresponding minified JavaScript file to Bugsnag.

const { upload } = require('@bugsnag/source-maps');

upload({
  apiKey: 'YOUR_API_KEY',
  appVersion: '1.2.3',
  sourceMap: 'path/to/app.js.map',
  minifiedFile: 'path/to/app.js',
  minifiedUrl: 'app.js',
  overwrite: true
}).then(() => {
  console.log('Source map uploaded successfully');
}).catch(err => {
  console.error('Failed to upload source map', err);
});

Uploading React Native Source Maps

This feature allows you to upload source maps for React Native applications. The code sample demonstrates how to upload a source map file along with the minified JavaScript bundle for an iOS platform to Bugsnag.

const { upload } = require('@bugsnag/source-maps');

upload({
  apiKey: 'YOUR_API_KEY',
  appVersion: '1.2.3',
  platform: 'ios',
  sourceMap: 'path/to/main.jsbundle.map',
  minifiedFile: 'path/to/main.jsbundle',
  minifiedUrl: 'main.jsbundle',
  overwrite: true
}).then(() => {
  console.log('Source map uploaded successfully');
}).catch(err => {
  console.error('Failed to upload source map', err);
});

Other packages similar to @bugsnag/source-maps

sentry-cli

sentry-cli is a command-line tool for Sentry, another error monitoring and reporting tool. It allows you to upload source maps, manage releases, and perform other Sentry-related tasks. Compared to @bugsnag/source-maps, sentry-cli offers a broader range of functionalities beyond just source map uploads.

airbrake-js

airbrake-js is an error monitoring library for Airbrake that includes functionalities for uploading source maps. It is similar to @bugsnag/source-maps in that it helps map minified code back to the original source code, but it is part of a broader library for error tracking.

README

@bugsnag/source-maps

Installation

You can install @bugsnag/source-maps locally to your project:

npm install --save-dev @bugsnag/source-maps
yarn add --dev @bugsnag/source-maps

You can then run the CLI using the convenience tools for each package manager:

npx bugsnag-source-maps [...args]
yarn run bugsnag-source-maps [...args]

Or you can install the bugsnag-source-maps CLI tool globally on your system:

npm install --global @bugsnag/source-maps
yarn global add @bugsnag/source-maps

System requirements

@bugsnag/source-maps requires Node.js v10+

Usage

See the Bugsnag docs website for full usage documentation.

bugsnag-source-maps --help

  bugsnag-source-maps <command>

Available commands

  upload-browser
  upload-node
  upload-react-native

Options

  -h, --help    show this message
  --version     output the version of the CLI module

Bugsnag On-Premise

If you are using Bugsnag On-premise, you should use the endpoint option to set the url of your upload server, for example:

bugsnag-source-maps upload-browser \
  --endpoint https://bugsnag.my-company.com/
  # ... other options

Support

• Check out the documentation
• Search open and closed issues for similar problems
• Report a bug or request a feature

Contributing

Most updates to this repo will be made by Bugsnag employees. We are unable to accommodate significant external PRs such as features additions or any large refactoring, however minor fixes are welcome.

License

This package is free software released under the MIT License. See LICENSE.txt for details.