deploy-notify-slack 0.2.1 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Mike
+
+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.
+
+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/README.md

@@ -1,19 +1,29 @@
 ## Dummy script to send notification about new version deployment to a Slack channel
 
-- no npm dependencies, plain nodejs
+- no npm dependencies, plain nodejs 8.x or higher
 - use Slack incoming webhooks API to send a message
 - can attach version description Markdown files
 
 ### 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 description 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
 
@@ -21,11 +31,11 @@
 
 - In Bitbucket pipeline or another place you wish to notify about just deployed version of your application you can add dev dependency
 ```shell
-npm i --no-save deploy-notify-slack@^0.1
+npm i --no-save deploy-notify-slack@^0.3
 ```
 or major version
 ```shell
-npm i --location=global deploy-notify-slack@^0.1
+npm i --location=global deploy-notify-slack@^0.3
 ```
 
 - run the scrypt with your env variables:
@@ -39,7 +49,7 @@ Bitbucket pipeline example:
     name: Notify deploy
     image: node:16-alpine
     script:
-      - npm i --location=global deploy-notify-slack@^0.1
+      - npm i --location=global deploy-notify-slack@^0.3
       - VERSION=$(npm run version --silent)
       - SLACK_WEBHOOK_URL=${SLACK_WEBHOOK_URL} STAGE=dev VERSION=$VERSION node ./node_modules/deploy-notify-slack/notify
 ```
@@ -51,7 +61,7 @@ or install package globally
     name: Notify Slack
     image: node:16-alpine
     script:
-      - npm i --location=global deploy-notify-slack@^0.1
+      - npm i --location=global deploy-notify-slack@^0.3
       - VERSION=$(npm run version --silent)
       - PWD=$(pwd)
       - SLACK_WEBHOOK_URL=${SLACK_WEBHOOK_URL} STAGE=dev VERSION=$VERSION CHANGELOG_PATH=$PWD/changelog node /usr/local/lib/node_modules/deploy-notify-slack/notify.js
@@ -100,7 +110,7 @@ pipelines:
         name: Notify Slack
         image: node:16-alpine
         script:
-          - npm i --location=global deploy-notify-slack@^0.1
+          - npm i --location=global deploy-notify-slack@^0.3
           - VERSION=$(npm run version --silent)
           - SLACK_WEBHOOK_URL=${SLACK_WEBHOOK_URL} STAGE=dev VERSION=$VERSION node /usr/local/lib/node_modules/deploy-notify-slack/notify.js
   

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.2",
   "description": "Send Slack notification about deploy with version comments",
   "main": "notify.js",
   "scripts": {

package/bitbucket-pipelines.yml

@@ -1,16 +0,0 @@
-image: node:16-alpine
-
-pipelines:
-  default:
-#    - step:
-#        name: Build and Test
-#        script:
-#          - npm install
-#          - npm test
-    - step:
-        name: Publish
-        deployment: production
-        script:
-          - pipe: atlassian/npm-publish:0.2.0
-            variables:
-              NPM_TOKEN: $NPM_TOKEN

package/tag-deploy.sh

@@ -1,5 +0,0 @@
-#!/bin/bash
-
-VERSION=$(npm run version --silent)
-git tag -a $VERSION -m "new version"
-git push origin $VERSION