feat: add failOnError option to abort pipeline on notification failures

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- `slack.failOnError` option to abort the pipeline when Slack notification operations fail ([#54](https://github.com/seqeralabs/nf-slack/pull/54))
+
 ## [0.5.1] - 2026-02-19
 
 ### Fixed

docs/reference/api.md

@@ -23,6 +23,7 @@ Complete API reference for nf-slack plugin configuration options and functions.
 | `onComplete`        | Closure | See [`slack.onComplete`](#slackoncomplete) | No       | Configuration for workflow completion notifications                |
 | `onError`           | Closure | See [`slack.onError`](#slackonerror)       | No       | Configuration for workflow error notifications                     |
 | `validateOnStartup` | Boolean | `true`                                     | No       | Validate Slack connection credentials on pipeline startup          |
+| `failOnError`       | Boolean | `false`                                    | No       | Abort the pipeline when a Slack notification operation fails       |
 
 \*Either `webhook` or `bot` is required. If neither is configured, the plugin will automatically disable itself.
 

docs/usage/guide.md

@@ -351,6 +351,22 @@ slack {
 
 This checks the token/webhook and channel access at pipeline start, failing fast if there's a configuration problem.
 
+## Fail on Notification Errors
+
+By default, Slack notification failures are logged and the pipeline continues. Set `failOnError = true` to abort the pipeline when any notification operation fails (messages, file uploads, reactions, or extension calls):
+
+```groovy
+slack {
+    bot {
+        token = System.getenv('SLACK_BOT_TOKEN')
+        channel = 'general'
+    }
+    failOnError = true
+}
+```
+
+Reaction failures continue to log at `DEBUG` when `failOnError` is `false` (the default).
+
 ## What's Next
 
 - [Examples](../examples/gallery.md) — Copy-paste configurations for common scenarios

example/configs/01-minimal.config

@@ -4,6 +4,7 @@ plugins {
 
 slack {
     enabled = true
+    // failOnError = true  // Uncomment to abort the pipeline on notification failures
     bot {
         token = System.getenv('SLACK_BOT_TOKEN')
         channel = System.getenv('SLACK_CHANNEL_ID')