Skip to content

feat: Bolt version 5 #2940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
WilliamBergamin wants to merge 9 commits into
base: main
Choose a base branch
from
Draft

feat: Bolt version 5 #2940

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
43050e0
chore: drop support for node 18 (#2927)
WilliamBergamin May 14, 2026
b439d8f
chore: remove deprecated workflow steps references (#2928)
WilliamBergamin May 14, 2026
a3b731c
feat: remove references to axios in favor of fetch (#2929)
WilliamBergamin May 14, 2026
7094511
feat: improve error handling (#2930)
WilliamBergamin May 14, 2026
f63cfad
chore: bump version for release candidate
WilliamBergamin May 14, 2026
b50019c
chore: update biome configurations and applied settings (#2932)
zimeg May 15, 2026
b942e38
chore: merge w main
zimeg May 15, 2026
71560b2
Merge branch 'main' into v5
WilliamBergamin May 19, 2026
397b7d6
chore: improve test coverage
WilliamBergamin May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/drop-node-18.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@slack/bolt": major
---

Drop Node.js 18 support. The minimum required runtime is now Node.js 20 (npm >=9.6.4).
5 changes: 5 additions & 0 deletions .changeset/drop-workflow-steps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@slack/bolt": major
---

Remove deprecated `WorkflowStep` class and all associated types, middleware, and utilities. Use `CustomFunction` and `app.function()` instead.
5 changes: 5 additions & 0 deletions .changeset/improve-error-handling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@slack/bolt": minor
---

Improve error handling by leveraging `@slack/web-api` v8 error classes. Authorization errors are now properly wrapped (preserving the original error's class identity). Default error handlers log richer details for web-api errors (API error codes, rate limit durations, HTTP status codes). Re-export `SlackError`, `WebAPIPlatformError`, `WebAPIRequestError`, `WebAPIHTTPError`, and `WebAPIRateLimitedError` from the package entry point.
5 changes: 5 additions & 0 deletions .changeset/use-native-fetch.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@slack/bolt": major
---

Replace axios with native fetch for response_url calls. Remove `agent` and `clientTls` options from `AppOptions` — use `clientOptions.fetch` to provide a custom fetch implementation for proxy/TLS needs. Add `dispatcher` option to `SocketModeReceiver` for proxy/TLS configuration in socket mode.
1 change: 0 additions & 1 deletion .github/workflows/ci-build.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ jobs:
fail-fast: false
matrix:
node-version:
- 18.x
- 20.x
- 22.x
- 24.x
Expand Down
2 changes: 0 additions & 2 deletions .github/workflows/samples.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ jobs:
fail-fast: false
matrix:
node-version:
- 18.x
- 20.x
- 22.x
- 24.x
Expand Down Expand Up @@ -48,7 +47,6 @@ jobs:
fail-fast: false
matrix:
node-version:
- 18.x
- 20.x
- 22.x
- 24.x
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ Listeners receive a single object with these properties (availability depends on

## Code Conventions

- **TypeScript** throughout. Compiler options in `tsconfig.json` (extends `@tsconfig/node18`, CommonJS output).
- **TypeScript** throughout. Compiler options in `tsconfig.json` (extends `@tsconfig/node20`, CommonJS output).
- **Biome** for formatting and linting. Configuration in `biome.json`.
- **Testing:** See the Testing section below for test frameworks and conventions.

Expand Down
10 changes: 5 additions & 5 deletions examples/custom-receiver/package-lock.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion examples/custom-receiver/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
"koa": "^3"
},
"devDependencies": {
"@tsconfig/node18": "^18.2.6",
"@tsconfig/node20": "^20.1.5",
"@types/koa": "^3.0.2",
"@types/node": "^24",
"ts-node": "^10",
Expand Down
2 changes: 1 addition & 1 deletion examples/custom-receiver/tsconfig.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"extends": "@tsconfig/node18/tsconfig.json",
"extends": "@tsconfig/node20/tsconfig.json",
"compilerOptions": {
"resolveJsonModule": true,
"allowSyntheticDefaultImports": true,
Expand Down
2 changes: 1 addition & 1 deletion examples/getting-started-typescript/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
"dotenv": "^17"
},
"devDependencies": {
"@tsconfig/node18": "^18.2.6",
"@tsconfig/node20": "^20.1.5",
"@types/node": "^24",
"ts-node": "^10",
"typescript": "6.0.3"
Expand Down
2 changes: 1 addition & 1 deletion examples/getting-started-typescript/tsconfig.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"extends": "@tsconfig/node18/tsconfig.json",
"extends": "@tsconfig/node20/tsconfig.json",
"compilerOptions": {
"resolveJsonModule": true,
"allowSyntheticDefaultImports": true,
Expand Down
Loading
Loading