fix: add @semantic-release/exec

Author: ivictbor

adminforth/documentation/blog/2025-01-09-how-adminforth-manages-version/index.md

@@ -81,18 +81,34 @@ In `package.json` add:
 //diff-add
   "release": {
 //diff-add
-    "branches": [main", "next"]
+    "branches": [main", "next"],
+//diff-add
+    "plugins": [
+//diff-add
+      "@semantic-release/commit-analyzer",
+//diff-add
+      "@semantic-release/release-notes-generator",
+//diff-add
+      "@semantic-release/npm",
+//diff-add
+      "@semantic-release/github"
+//diff-add
+    ],
 //diff-add
   }
 }
 ```
 
 Make sure name in package.json has your organisation name like mine `@devforth/` and you have access to publish packages to npmjs.com.
 
+
+Also install `semantic-release`:
+
 ```
-npm install --save-dev semantic-release
+npm i -D semantic-release
 ```
 
+
 ## Connecting to CI
 
 We will use Woodpecker CI for this example. Woodpecker is a free and open-source CI/CD tool that you can install to your own server / VPS and will not need to pay only for server. No limits on pipelines, users, repositories, etc. If you want to try it, we have [Woodpecker installation guide](https://devforth.io/blog/step-by-step-guide-to-modern-secure-ci-setup/)
@@ -238,4 +254,70 @@ git merge next
 git push
 ```
 
-This will trigger release `v1.2.0` because we merged `next` to `main` and it was a feature release.
+This will trigger release `v1.2.0` because we merged `next` to `main` and it was a feature release.
+
+
+## Slack notifications
+
+So now we have automatic releases with release notes on GitHub. 
+For our internal team we use Slack and we want to get notifications about releases there.
+
+```
+npm i -D semantic-release-slack-bot
+```
+
+Into "release" section of `package.json` add slack plugin:
+
+```
+ "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/npm",
+      "@semantic-release/github",
+//diff-add
+      [
+//diff-add
+        "semantic-release-slack-bot",
+//diff-add
+        {
+//diff-add
+          "notifyOnSuccess": true,
+//diff-add
+          "notifyOnFail": true,
+//diff-add
+          "slackIcon": ":package:",
+//diff-add
+          "onSuccessTemplate": {
+//diff-add
+            "text": "$npm_package_version has been released!"
+//diff-add
+          },
+//diff-add
+          "markdownReleaseNotes": true
+        }
+      ]
+    ],
+```
+
+
+Also create channel in Slack, click on channel name, "Integrations" -> "Add an App" -> "Incoming Webhooks" -> "Add to Slack" -> "Add Incoming Webhook to Workspace" -> "Add to Slack" -> "Copy Webhook URL"
+
+Add it to Woodpecker as secret `SLACK_WEBHOOK` environment variable.
+
+Also add this secterd to `.woodpecker.yml`:
+
+```
+    secrets:
+      - GITHUB_TOKEN
+      - NPM_TOKEN
+//diff-add
+      - SLACK_WEBHOOK
+```
+
+
+This will send notifications to Slack channel about succesfull releases when `npm run build` is done without errors. 
+However if you have errors in build, or have unit tests in the flow, you will not get notifications about failed releases, because `npx semantic-release` will not be executed.
+
+To fix it we will add another slack notification plugin, moreover we will use dedicated `adminforth-developers` channel for it.
+
+```

adminforth/index.ts

@@ -8,6 +8,8 @@ import ExpressServer from './servers/express.js';
 // import FastifyServer from './servers/fastify.js';
 import { ADMINFORTH_VERSION, listify, suggestIfTypo, RateLimiter, getClientIp } from './modules/utils.js';
 
+a.b =1
+
 import { 
   type AdminForthConfig, 
   type IAdminForth, 

adminforth/package-lock.json

@@ -26,12 +26,6 @@
   },
   "release": {
     "plugins": [
-      [
-        "@semantic-release/exec",
-        {
-          "prepareCmd": "npm run build"
-        }
-      ],
       "@semantic-release/commit-analyzer",
       "@semantic-release/release-notes-generator",
       "@semantic-release/npm",
@@ -40,7 +34,12 @@
         "semantic-release-slack-bot",
         {
           "notifyOnSuccess": true,
-          "notifyOnFail": true
+          "notifyOnFail": true,
+          "slackIcon": ":package:",
+          "onSuccessTemplate": {
+            "text": "$npm_package_version has been released!"
+          },
+          "markdownReleaseNotes": true
         }
       ]
     ],
@@ -87,6 +86,7 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@semantic-release/exec": "^6.0.3",
     "@types/node": "^20.14.2",
     "semantic-release": "^24.2.1",
     "semantic-release-slack-bot": "^4.0.2",