@semantic-release/github 8.0.9 → 8.1.0

package/README.md

@@ -89,6 +89,7 @@ When using the _GITHUB_TOKEN_, the **minimum required permissions** are:
 | `assignees`           | The [assignees](https://help.github.com/articles/assigning-issues-and-pull-requests-to-other-github-users) to add to the issue created when a release fails.                                           | -                                                                                                                                                    |
 | `releasedLabels`      | The [labels](https://help.github.com/articles/about-labels) to add to each issue and pull request resolved by the release. Set to `false` to not add any label. See [releasedLabels](#releasedlabels). | `['released<%= nextRelease.channel ? \` on @\${nextRelease.channel}\` : "" %>']-                                                                                                                                                    |
 | `addReleases`         | Will add release links to the GitHub Release. Can be `false`, `"bottom"` or `"top"`. See [addReleases](#addReleases). | `false`                                                                     |
+| `draftRelease`        | A boolean indicating if a GitHub Draft Release should be created instead of publishing an actual GitHub Release. | `false` |
 
 #### proxy
 
@@ -218,4 +219,4 @@ Valid values for this option are `false`, `"top"` or `"bottom"`.
 
 ##### addReleases example
 
-See [The introducing PR](https://github.com/semantic-release/github/pull/282) for an example on how it will look.
+See [The introducing PR](https://github.com/semantic-release/github/pull/282) for an example on how it will look.

package/lib/definitions/errors.js

@@ -63,6 +63,12 @@ Your configuration for the \`releasedLabels\` option is \`${stringify(releasedLa
     details: `The [addReleases option](${linkify('README.md#options')}) if defined, must be one of \`false|top|bottom\`.
 
 Your configuration for the \`addReleases\` option is \`${stringify(addReleases)}\`.`,
+  }),
+  EINVALIDDRAFTRELEASE: ({draftRelease}) => ({
+    message: 'Invalid `draftRelease` option.',
+    details: `The [draftRelease option](${linkify('README.md#options')}) if defined, must be a \`Boolean\`.
+
+Your configuration for the \`draftRelease\` option is \`${stringify(draftRelease)}\`.`,
   }),
   EINVALIDGITHUBURL: () => ({
     message: 'The git repository URL is not a valid GitHub URL.',

package/lib/publish.js

@@ -18,7 +18,10 @@ module.exports = async (pluginConfig, context) => {
     nextRelease: {name, gitTag, notes},
     logger,
   } = context;
-  const {githubToken, githubUrl, githubApiPathPrefix, proxy, assets} = resolveConfig(pluginConfig, context);
+  const {githubToken, githubUrl, githubApiPathPrefix, proxy, assets, draftRelease} = resolveConfig(
+    pluginConfig,
+    context
+  );
   const {owner, repo} = parseGithubUrl(repositoryUrl);
   const octokit = getClient({githubToken, githubUrl, githubApiPathPrefix, proxy});
   const release = {
@@ -33,8 +36,20 @@ module.exports = async (pluginConfig, context) => {
 
   debug('release object: %O', release);
 
-  // When there are no assets, we publish a release directly
+  const draftReleaseOptions = {...release, draft: true};
+
+  // When there are no assets, we publish a release directly.
   if (!assets || assets.length === 0) {
+    // If draftRelease is true we create a draft release instead.
+    if (draftRelease) {
+      const {
+        data: {html_url: url, id: releaseId},
+      } = await octokit.request('POST /repos/{owner}/{repo}/releases', draftReleaseOptions);
+
+      logger.log('Created GitHub draft release: %s', url);
+      return {url, name: RELEASE_NAME, id: releaseId};
+    }
+
     const {
       data: {html_url: url, id: releaseId},
     } = await octokit.request('POST /repos/{owner}/{repo}/releases', release);
@@ -45,11 +60,9 @@ module.exports = async (pluginConfig, context) => {
 
   // We'll create a draft release, append the assets to it, and then publish it.
   // This is so that the assets are available when we get a Github release event.
-  const draftRelease = {...release, draft: true};
-
   const {
-    data: {upload_url: uploadUrl, id: releaseId},
-  } = await octokit.request('POST /repos/{owner}/{repo}/releases', draftRelease);
+    data: {upload_url: uploadUrl, html_url: draftUrl, id: releaseId},
+  } = await octokit.request('POST /repos/{owner}/{repo}/releases', draftReleaseOptions);
 
   // Append assets to the release
   const globbedAssets = await globAssets(context, assets);
@@ -98,6 +111,12 @@ module.exports = async (pluginConfig, context) => {
     })
   );
 
+  // If we want to create a draft we don't need to update the release again
+  if (draftRelease) {
+    logger.log('Created GitHub draft release: %s', draftUrl);
+    return {url: draftUrl, name: RELEASE_NAME, id: releaseId};
+  }
+
   const {
     data: {html_url: url},
   } = await octokit.request('PATCH /repos/{owner}/{repo}/releases/{release_id}', {

package/lib/resolve-config.js

@@ -13,6 +13,7 @@ module.exports = (
     assignees,
     releasedLabels,
     addReleases,
+    draftRelease,
   },
   {env}
 ) => ({
@@ -32,4 +33,5 @@ module.exports = (
     ? false
     : castArray(releasedLabels),
   addReleases: isNil(addReleases) ? false : addReleases,
+  draftRelease: isNil(draftRelease) ? false : draftRelease,
 });

package/lib/verify.js

@@ -1,4 +1,4 @@
-const {isString, isPlainObject, isNil, isArray, isNumber} = require('lodash');
+const {isString, isPlainObject, isNil, isArray, isNumber, isBoolean} = require('lodash');
 const urlJoin = require('url-join');
 const AggregateError = require('aggregate-error');
 const parseGithubUrl = require('./parse-github-url');
@@ -27,6 +27,7 @@ const VALIDATORS = {
   assignees: isArrayOf(isNonEmptyString),
   releasedLabels: canBeDisabled(isArrayOf(isNonEmptyString)),
   addReleases: canBeDisabled(oneOf(['bottom', 'top'])),
+  draftRelease: isBoolean,
 };
 
 module.exports = async (pluginConfig, context) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@semantic-release/github",
   "description": "semantic-release plugin to publish a GitHub release and comment on released Pull Requests/Issues",
-  "version": "8.0.9",
+  "version": "8.1.0",
   "author": "Pierre Vanduynslager (https://twitter.com/@pvdlg_)",
   "ava": {
     "files": [