newrelic 7.0.2 → 7.1.3

package/NEWS.md

@@ -1,6 +1,67 @@
+### v7.1.3 (2021-03-09)
+
+* Bumped @grpc/grpc-js to ^1.2.7.
+
+* Removed index-bad-config test which tested a no-longer possible use-case.
+
+* Removed license-key test logic from serverless-harvest test.
+
+  Serverless mode does not require a license key as data transfer is handled by the integration.
+
+* Added support metric to be able to track usage of cert bundle via usage of custom certificates.
+
+* Removed requirement to configure application name when running in AWS Lambda (serverless mode).
+
+  Application name is not currently leveraged by New Relic for Lambda invocations. The agent now defaults the application name in serverless mode to remove the requirement of end-user configuration while handling cases if it were to be leveraged in the future.
+
+* Stopped binding/propagating segments via `setImmediate` for ended transactions.
+
+* Fixed bug where agent would attempt to call the 'preconnect' endpoint on the redirect host returned by the previous 'preconnect' call when reconnecting to the New Relic servers.
+
+  The 'preconnect' calls will now always use the original agent configuration value. Subsequent endpoints (connect, harvest endpoints, etc.) will continue to leverage the new redirect host value returned by 'preconnect.' The original config values are no-longer overridden.
+
+* Fixed issue where a call to `transaction.acceptDistributedTraceHeaders` would throw an error when the `headers` parameter is a string.
+
+* Improved clarity of logging between 'no log file' or disabled agent startup issues.
+
+  * Logs no-config file error to initialized logger (stdout) in addition to existing console.error() logging.
+  * Adds specific message to no config file separate from being disabled.
+
+* Removed aws-sdk versioned test filtering.
+
+* Removed unused Travis CI scripts.
+
+### v7.1.2 (2021-02-24)
+
+* Fixed bug where the agent failed to reconnect to Infinite Tracing gRPC streams on Status OK at higher log levels.
+
+  Node streams require all data be consumed for the end/status events to fire. We were only reading data at lower log levels where we'd use/log the data. This resulted in a failure to reconnect and 'ERR_STREAM_WRITE_AFTER_END' errors. The agent now always listens to the 'data' event, even if not logging, and will also reconnect (with 15 second delay) on any 'ERR_STREAM_WRITE_AFTER_END' error.
+
+* Removed initial harvest send() call on streaming span event aggregator to prevent warning in logs.
+
+* Bumped @newrelic/aws-sdk to ^3.1.0.
+
+### v7.1.1 (2021-02-01)
+
+* Upgrade @grpc/grpc-js to v1.2.5 to fix non-propagation of internal http2 errors
+  Now allows minor and patch auto-updates.
+
+* Added workflow for publishing to npm when a v* tag is pushed to the repo.
+
+* Fixes resolveMx test by using example.com for a valid exchange.
+
+### 7.1.0 (2021-01-05):
+
+* Fixed SQL traces being generated with invalid ID.
+* Fixed log message for minimum supported Node.js version.
+* Added Fastify v3 support.
+* Fixed empty log message for Infinite Tracing connections.
+* Upgraded grpc version.
+* Fixed bug that prevented users from changing Infinite Tracing queue size.
+
 ### 7.0.2 (2020-12-01):
 
-* Fixes a bug where the `http.statusCode` attribute was not being captured for an async invoked lambda.
+* Fixed a bug where the `http.statusCode` attribute was not being captured for an async invoked lambda.
 * Fixed typos in code comments, documentation, and debugging logger messages.
   Thank you @TysonAndre for the contribution.
 

package/THIRD_PARTY_NOTICES.md

@@ -35,6 +35,7 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 
 * [@newrelic/proxy](#newrelicproxy)
 * [@newrelic/test-utilities](#newrelictest-utilities)
+* [@octokit/rest](#octokitrest)
 * [JSV](#JSV)
 * [architect](#architect)
 * [benchmark](#benchmark)
@@ -73,7 +74,7 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 
 ### @grpc/grpc-js
 
-This product includes source derived from [@grpc/grpc-js](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js) ([v1.2.0](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/tree/v1.2.0)), distributed under the [Apache-2.0 License](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/blob/v1.2.0/LICENSE):
+This product includes source derived from [@grpc/grpc-js](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js) ([v1.2.5](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/tree/v1.2.5)), distributed under the [Apache-2.0 License](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/blob/v1.2.5/LICENSE):
 
 ```
                                  Apache License
@@ -491,7 +492,7 @@ This product includes source derived from [@grpc/proto-loader](https://github.co
 
 ### @newrelic/aws-sdk
 
-This product includes source derived from [@newrelic/aws-sdk](https://github.com/newrelic/node-newrelic-aws-sdk) ([v3.0.0](https://github.com/newrelic/node-newrelic-aws-sdk/tree/v3.0.0)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-newrelic-aws-sdk/blob/v3.0.0/LICENSE):
+This product includes source derived from [@newrelic/aws-sdk](https://github.com/newrelic/node-newrelic-aws-sdk) ([v3.1.0](https://github.com/newrelic/node-newrelic-aws-sdk/tree/v3.1.0)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-newrelic-aws-sdk/blob/v3.1.0/LICENSE):
 
 ```
                                  Apache License
@@ -1207,11 +1208,13 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 This product includes source derived from [https-proxy-agent](https://github.com/TooTallNate/node-https-proxy-agent) ([v4.0.0](https://github.com/TooTallNate/node-https-proxy-agent/tree/v4.0.0)), distributed under the [MIT License](https://github.com/TooTallNate/node-https-proxy-agent/blob/v4.0.0/README.md):
 
 ```
-MIT License Copyright (c) <year> <copyright holders>
+MIT License
+
+Copyright (c) <year> <copyright holders>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
@@ -1534,11 +1537,13 @@ This product includes source derived from [@newrelic/native-metrics](https://git
 This product includes source derived from [@newrelic/proxy](https://github.com/newrelic/proxy) ([v2.0.0](https://github.com/newrelic/proxy/tree/v2.0.0)), distributed under the [MIT License](https://github.com/newrelic/proxy/blob/v2.0.0/README.md):
 
 ```
-MIT License Copyright (c) <year> <copyright holders>
+MIT License
+
+Copyright (c) <year> <copyright holders>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
@@ -1752,23 +1757,41 @@ This product includes source derived from [@newrelic/test-utilities](https://git
 
 ```
 
-### JSV
+### @octokit/rest
 
-This product includes source derived from [JSV](https://github.com/garycourt/JSV) ([v4.0.2](https://github.com/garycourt/JSV/tree/v4.0.2)), distributed under the [FreeBSD License](https://github.com/garycourt/JSV/tree/v4.0.2#license):
+This product includes source derived from [@octokit/rest](https://github.com/octokit/rest.js) ([v18.0.15](https://github.com/octokit/rest.js/tree/v18.0.15)), distributed under the [MIT License](https://github.com/octokit/rest.js/blob/v18.0.15/LICENSE):
 
 ```
-Copyright 2010 Gary Court. All rights reserved.
+The MIT License
+
+Copyright (c) 2012 Cloud9 IDE, Inc. (Mike de Boer)
+Copyright (c) 2017-2018 Octokit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
-Redistribution and use in source and binary forms, with or without modification, are
-permitted provided that the following conditions are met:
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
 
-   1. Redistributions of source code must retain the above copyright notice, this list of
-      conditions and the following disclaimer.
+```
 
-   2. Redistributions in binary form must reproduce the above copyright notice, this list
-      of conditions and the following disclaimer in the documentation and/or other materials
-      provided with the distribution.
+### JSV
 
+This product includes source derived from [JSV](https://github.com/garycourt/JSV) ([v4.0.2](https://github.com/garycourt/JSV/tree/v4.0.2)), distributed under the [FreeBSD License](https://github.com/garycourt/JSV/tree/v4.0.2#license):
+
+```
 THIS SOFTWARE IS PROVIDED BY GARY COURT ``AS IS'' AND ANY EXPRESS OR IMPLIED
 WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GARY COURT OR
@@ -1997,11 +2020,13 @@ SOFTWARE.
 This product includes source derived from [generic-pool](https://github.com/coopernurse/node-pool) ([v3.7.1](https://github.com/coopernurse/node-pool/tree/v3.7.1)), distributed under the [MIT License](https://github.com/coopernurse/node-pool/blob/v3.7.1/README.md):
 
 ```
-MIT License Copyright (c) <year> <copyright holders>
+MIT License
+
+Copyright (c) <year> <copyright holders>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
@@ -2614,11 +2639,13 @@ IN THE SOFTWARE.
 This product includes source derived from [redis](https://github.com/mranney/node_redis) ([v1.0.0](https://github.com/mranney/node_redis/tree/v1.0.0)), distributed under the [MIT License](https://github.com/mranney/node_redis/blob/v1.0.0/README.md):
 
 ```
-MIT License Copyright (c) <year> <copyright holders>
+MIT License
+
+Copyright (c) <year> <copyright holders>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```

package/bin/check-workflow-run.js

@@ -0,0 +1,74 @@
+'use strict'
+
+const Github = require('./github')
+
+const SUCCESS_MSG = '*** [OK] ***'
+
+const formatRun = (run) => {
+  return {
+    name: run.name,
+    repository: run.repository.name,
+    repoOwner: run.repository.owner.login,
+    branch: run.head_branch,
+    status: run.status,
+    url: run.url,
+    workflow_id: run.workflow_id,
+    event: run.event
+  }
+}
+
+async function checkWorkflowRun(repoOwner, branch) {
+  const github = new Github(repoOwner)
+
+  try {
+    const results = {
+      ci: false,
+      smokeTest: false
+    }
+
+    const latestRun = await github.getLatestWorkflowRun('ci-workflow.yml', branch)
+
+    if (latestRun === undefined) {
+      console.log('No ci workflow run found.')
+    } else {
+      console.log('CI workflow run details: ', JSON.stringify(formatRun(latestRun)))
+      if (latestRun.status === 'completed' && latestRun.conclusion === 'success') {
+        results.ci = true
+      }
+    }
+
+    const latestSmokeTestRun = await github.getLatestWorkflowRun('smoke-test-workflow.yml', branch)
+
+    if (latestSmokeTestRun === undefined) {
+      console.log('No smoke test workflow run found.')
+    } else {
+      console.log('Smoke-test workflow run details: ', JSON.stringify(formatRun(latestSmokeTestRun)))
+
+      if (latestSmokeTestRun.status === 'completed' && latestSmokeTestRun.conclusion === 'success') {
+        results.smokeTest = true
+      }
+    }
+
+    if (results.ci && results.smokeTest) {
+      console.log(SUCCESS_MSG)
+      console.log('Latest ci and smoke-test runs were successful!')
+      return true
+    }
+
+    if (!results.ci) {
+      console.log('Latest ci workflow run result was not \'completed\' and \'success\'.')
+    }
+
+    if (!results.smokeTest) {
+      console.log('Latest smoke-test workflow run result was not \'completed\' and \'success\'.')
+    }
+
+    return false
+  } catch (err) {
+    console.error(err)
+
+    return false
+  }
+}
+
+module.exports = checkWorkflowRun

package/bin/create-github-release.js

@@ -0,0 +1,109 @@
+'use strict'
+
+const fs = require('fs')
+const {program} = require('commander')
+
+const Github = require('./github')
+const { indexOf } = require('benchmark')
+
+const DEFAULT_FILE_NAME = 'NEWS.md'
+/** e.g. v7.2.1 */
+const TAG_VALID_REGEX = /v\d+\.\d+\.\d+/
+
+program.requiredOption('--tag <tag>', 'tag name to create GitHub release for')
+program.option('--repo-owner <repoOwner>', 'repository owner', 'newrelic')
+program.option('--release-notes-file <releaseNotesFile>', 'path to release notes file', DEFAULT_FILE_NAME)
+program.option('-f --force', 'bypass validation')
+
+async function createRelease() {
+  // Parse commandline options inputs
+  program.parse()
+
+  const options = program.opts()
+
+  console.log('Script running with following options: ', JSON.stringify(options))
+
+  const github = new Github(options.repoOwner)
+
+  try {
+    const tagName = options.tag.replace('refs/tags/', '')
+    console.log('Using tag name: ', tagName)
+
+    logStep('Validation')
+    if (options.force) {
+      console.log('--force set. Skipping validation logic')
+    }
+
+    if (!options.force && !TAG_VALID_REGEX.exec(tagName)) {
+      console.log('Tag arg invalid (%s). Valid tags in form: v#.#.# (e.g. v7.2.1)', tagName)
+      stopOnError()
+    }
+
+    logStep('Get Release Notes from File')
+    const body = await getReleaseNotes(tagName, options.releaseNotesFile)
+
+    logStep('Create Release')
+    await github.createRelease(tagName, tagName, body)
+
+    console.log('*** Full Run Successful ***')
+  } catch (err) {
+    if (err.status && err.status === 404) {
+      console.log('404 status error detected. For octokit, this may mean insuffient permissions.')
+      console.log('Ensure you have a valid GITHUB_TOKEN set in your env vars.')
+    }
+
+    stopOnError(err)
+  }
+}
+
+async function getReleaseNotes(tagName, releaseNotesFile) {
+  console.log('Retrieving release notes from file: ', releaseNotesFile)
+
+  const data = await readReleaseNoteFile(releaseNotesFile)
+
+  const currentVersionHeader = `### ${tagName}`
+  if (data.indexOf(currentVersionHeader) !== 0) {
+    throw new Error(`Current tag (${currentVersionHeader}) not first line of release notes.`)
+  }
+
+  const sections = data.split('### ', 2)
+  if (sections.length !== 2) {
+    throw new Error('Did not split into multiple sections. Double check notes format.')
+  }
+
+  const tagSection = sections[1]
+  // e.g. v7.1.2 (2021-02-24)\n\n
+  const headingRegex = /^v\d+\.\d+\.\d+ \(\d{4}-\d{2}-\d{2}\)\n\n/
+  const headingRemoved = tagSection.replace(headingRegex, '')
+
+  return headingRemoved
+}
+
+async function readReleaseNoteFile(file) {
+  const promise = new Promise((resolve, reject) => {
+    fs.readFile(file, 'utf8', function (err, data) {
+      if (err) {
+        return reject(err)
+      }
+
+      resolve(data)
+    })
+  })
+
+  return promise
+}
+
+function stopOnError(err) {
+  if (err) {
+    console.error(err)
+  }
+
+  console.log('Halting execution with exit code: 1')
+  process.exit(1)
+}
+
+function logStep(step) {
+  console.log(`\n ----- [Step]: ${step} -----\n`)
+}
+
+createRelease()

package/bin/create-release-tag.js

@@ -0,0 +1,95 @@
+'use strict'
+
+const {program} = require('commander')
+
+const checkWorkflowRun = require('./check-workflow-run')
+const git = require('./git-commands')
+
+// Add command line options
+program.option('-b, --branch <branch>', 'release branch', 'main')
+program.option('-o, --repo-owner <repoOwner>', 'repository owner', 'newrelic')
+program.option('-f --force', 'bypass validation')
+
+async function createReleaseTag() {
+  // Parse commandline options inputs
+  program.parse()
+
+  const options = program.opts()
+
+  console.log('Script running with following options: ', JSON.stringify(options))
+
+  const branch = options.branch.replace('refs/heads/', '')
+  const repoOwner = options.repoOwner
+
+  if (options.force) {
+    console.log('--force set. Skipping validation logic')
+  }
+
+  try {
+    const isValid = options.force || (
+      await validateLocalChanges() &&
+      await validateCurrentBranch(branch) &&
+      await checkWorkflowRun(repoOwner, branch)
+    )
+
+    if (!isValid) {
+      process.exit(1)
+    }
+
+    const packagePath = '../package.json'
+    console.log('Extracting new version from package.json here: ', )
+    const packageInfo = require(packagePath)
+
+    const version = `v${packageInfo.version}`
+    console.log('New version is: ', version)
+
+    console.log('Creating and pushing tag')
+
+    await git.createAnnotatedTag(version, version)
+    await git.pushTags()
+
+    console.log('*** Full Run Successful ***')
+  } catch (err) {
+    console.log(err)
+
+    process.exit(1)
+  }
+}
+
+async function validateLocalChanges() {
+  try {
+    const localChanges = await git.getLocalChanges()
+    if (localChanges.length > 0) {
+      console.log('Local changes detected: ', localChanges)
+      console.log('Please commit to a feature branch or stash changes and then try again.')
+      return false
+    }
+
+    return true
+  } catch (err) {
+    console.error(err)
+    return false
+  }
+}
+
+async function validateCurrentBranch(branch) {
+  try {
+    const currentBranch = await git.getCurrentBranch()
+
+    if (branch != currentBranch) {
+      console.log(
+        'Current checked-out branch (%s) does not match expected (%s)',
+        currentBranch,
+        branch
+      )
+      return false
+    }
+
+    return true
+  } catch (err) {
+    console.error(err)
+    return false
+  }
+}
+
+createReleaseTag()

package/bin/git-commands.js

@@ -0,0 +1,110 @@
+'use strict'
+
+const { exec } = require('child_process')
+
+async function getPushRemotes() {
+  const stdout = await execAsPromise('git remote -v')
+
+  const remotes = stdout.split('\n')
+  const processedRemotes = remotes.reduce((remotePairs, currentRemote) => {
+    const parts = currentRemote.split('\t')
+    if (parts.length < 2) {
+      return remotePairs
+    }
+
+    const [name, url] = parts
+    if (url.indexOf('(push)') >= 0) {
+      remotePairs[name] = url
+    }
+
+    return remotePairs
+  }, {})
+
+  return processedRemotes
+}
+
+async function getLocalChanges() {
+  const stdout = await execAsPromise('git status --short --porcelain')
+  const changes = stdout.split('\n').filter((line) => {
+    return line.length > 0
+  })
+
+  return changes
+}
+
+async function getCurrentBranch() {
+  const stdout = await execAsPromise('git branch --show-current')
+  const branch = stdout.trim()
+
+  return branch
+}
+
+async function checkoutNewBranch(name) {
+  const stdout = await execAsPromise(`git checkout -b ${name}`)
+  const output = stdout.trim()
+
+  return output
+}
+
+async function addAllFiles() {
+  const stdout = await execAsPromise(`git add .`)
+  const output = stdout.trim()
+
+  return output
+}
+
+async function commit(message) {
+  const stdout = await execAsPromise(`git commit -m "${message}"`)
+  const output = stdout.trim()
+
+  return output
+}
+
+async function pushToRemote(remote, branchName) {
+  const stdout = await execAsPromise(`git push --set-upstream ${remote} ${branchName}`)
+  const output = stdout.trim()
+
+  return output
+}
+
+async function createAnnotatedTag(name, message) {
+  const stdout = await execAsPromise(`git tag -a ${name} -m ${message}`)
+  const output = stdout.trim()
+
+  return output
+}
+
+async function pushTags() {
+  const stdout = await execAsPromise('git push --tags')
+  const output = stdout.trim()
+
+  return output
+}
+
+function execAsPromise(command) {
+  const promise = new Promise((resolve, reject) => {
+    console.log(`Executing: '${command}'`)
+
+    exec(command, (err, stdout) => {
+      if (err) {
+        return reject(err)
+      }
+
+      resolve(stdout)
+    })
+  })
+
+  return promise
+}
+
+module.exports = {
+  getPushRemotes,
+  getLocalChanges,
+  getCurrentBranch,
+  checkoutNewBranch,
+  addAllFiles,
+  commit,
+  pushToRemote,
+  createAnnotatedTag,
+  pushTags
+}