deploy-notify-slack 0.2.1 → 0.3.0

package/README.md

@@ -6,14 +6,24 @@
 
 ### ENV Variables
 
+#### Required
+
 - SLACK_WEBHOOK_URL - you should generate webhook url for your target channel, see: https://api.slack.com/messaging/webhooks
 - STAGE - name of an application stage you're deploying, usually: dev, staging, prod..
 - VERSION - deployed version
-- TITLE - notification title
-- CHANGELOG_PATH - path of your deployed version details file `changelog` by default.
+
+#### Optional
+
+- TITLE - ('Deployment' by default) notification title
+- CHANGELOG_PATH - path of your deployed version details file (`changelog` by default as well as we assume that the package installed locally, so this option is required if the package installed globally)
 
 > version details file is a Markdown file having the name like `${STAGE}-v${VERSION}.md`. 
-> If such file isn't found details block will be omitted in Slack message.
+> 
+> you can also create cross-environment file with name pattern `v${VERSION}.md` and if script cannot find stage specific description it will get this one.
+> 
+> If no decription file found details block will be omitted in Slack message.
+
+- FAILS_IF_NOT_SENT - (false by default)  Should exit with not 0 error code if message was not sent successfully.
 
 ### How it works
 

package/notify.js

@@ -7,17 +7,20 @@ const stage = process.env.STAGE;
 const version = process.env.VERSION;
 const title = process.env.TITLE || 'Deployment';
 const changelogPath = process.env.CHANGELOG_PATH || path.join(__dirname, '../../changelog');
+const failsIfNotSent = process.env.FAILS_IF_NOT_SENT !== undefined
+  ? stringToBool(process.env.FAILS_IF_NOT_SENT, false)
+  : false;
 
 function getChangelog() {
   try {
     return fs.readFileSync(path.join(changelogPath, `${stage}-v${version}.md`), 'utf8')
   } catch (e) {
-    console.log(`Description "${stage}-v${version}.md" not found`)
+    console.log(`Description "${stage}-v${version}.md" not found in "${changelogPath}"`)
   }
   try {
     return fs.readFileSync(path.join(changelogPath, `v${version}.md`), 'utf8')
   } catch (e) {
-    console.log(`Description "v${version}.md" not found`)
+    console.log(`Description "v${version}.md" not found in "${changelogPath}"`)
   }
   return '';
 }
@@ -121,6 +124,24 @@ function sendSlackMessage (webhookURL, messageBody) {
   });
 }
 
+function stringToBool(str, defaultValue = false){
+  switch(str.toLowerCase().trim()){
+    case "true":
+    case "yes":
+    case "1":
+      return true;
+
+    case "false":
+    case "no":
+    case "0":
+    case null:
+      return false;
+
+    default:
+      return defaultValue
+  }
+}
+
 function validate() {
   let success = true;
   if (!slackWebHookURL) {
@@ -144,14 +165,23 @@ function validate() {
 // main
 (async function () {
   if (!validate()) {
-    process.exit(1);
+    process.exit(3);
   }
 
   console.log('Sending slack message');
   try {
     const slackResponse = await sendSlackMessage(slackWebHookURL, notificationBody());
     console.log('Message response', slackResponse);
+    if (slackResponse !== 'ok') {
+      console.error('There was an error with the request. Check SLACK_WEBHOOK_URL.');
+      if (failsIfNotSent) {
+        process.exit(4);
+      }
+    }
   } catch (e) {
-    console.error('There was a error with the request', e);
+    console.error('There was an error with the request', e);
+    if (failsIfNotSent) {
+      process.exit(5);
+    }
   }
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deploy-notify-slack",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Send Slack notification about deploy with version comments",
   "main": "notify.js",
   "scripts": {