feat: Add setCommits option

[dmitryrn]

I added setCommits command to be able set associated commits through this plugin as requested here #71. Without this options you forced to use sentry-cli to set associated commits directly. Please check this out.

ToDo:

• add tests for setCommits
• update setCommits options descriptions in README.md

[dmitryrn]

Also I realised that I also might need to use deploys. This is for the thread #71.

BTW I wrote simple webpack-3 plugin:

const SentryCli = require('@sentry/cli')

class SentryCommitsPlugin {
  constructor(options) {
    this.options = options
  }

  apply(compiler) {
    compiler.hooks.emit.tapAsync(
      'MyExampleWebpackPlugin',
      async (compilation, callback) => {
        const cli = new SentryCli()

        const {
          release,
          commit,
          previousCommit,
          repo,
          auto,
        } = this.options

        console.info('\n\n> Associating sentry release commits...')

        await cli.releases.setCommits(release, {
          commit,
          previousCommit,
          repo,
          auto,
        })

        console.info('> Sentry release commits associated successfully\n')

        callback()
      }
    )
  }
}

module.exports = SentryCommitsPlugin

I run this SentryCommitsPlugin after SentryCLIPlugin

Also I'll write and use similar SentryDeploysPlugin

So what do you think: do we really need such functionality in this plugin?

[dmitryrn]

Oh, no way! We need to add deploys here first

[dmitryrn]

@kamilogorek can you review this?

[dmitryrn]

Also I wrote and use following plugin for Sentry Deploys:

I use Sentry API here instead of sentry-cli because bridge-like thing from Rust to JS does not implemented like for setCommits (https://github.com/getsentry/sentry-cli/blob/master/js/releases/index.js#L61)

const assert = require('assert')
const axios = require('axios').default

class SentryDeploysPlugin {
  constructor(options) {
    this.options = options
  }

  apply(compiler) {
    compiler.hooks.emit.tapAsync(
      'SentryDeploysPlugin',
      async (compilation, callback) => {
        const {
          version,
          authToken,
          orgSlug,
          serverUrl,
        } = this.options

        assert(typeof version === 'string', 'option version is incorrect')
        assert(typeof authToken === 'string', 'option authToken is incorrect')
        assert(typeof orgSlug === 'string', 'option orgSlug is incorrect')
        assert(typeof serverUrl === 'string', 'option serverUrl is incorrect')

        try {
          console.info('\n\n> Creating sentry deploy...')

          await axios.post(`${serverUrl}api/0/organizations/${orgSlug}/releases/${version}/deploys/`, {
            environment: 'production',
          }, {
            headers: {
              Authorization: `Bearer ${authToken}`,
            },
          })

          console.info('> Sentry deploy created successfully\n')

          callback()
        } catch (error) {
          console.info('> Sentry deploy failed!\n')
          console.error('Sentry server response: ', error.response.data)
          callback(error)
        }
      }
    )
  }
}

module.exports = SentryDeploysPlugin

[kamilogorek]

edit: missed one thing. Updated.

[kamilogorek]

Few minor changes

[kamilogorek]

Thanks!