What's Changed

4df9fb8c feat(web-api): add new Slack Connect APIs team.externalTeams.list and users.discoverableContacts.lookup (#1826)
f3acb2f5 feat(web-api): Update response types to latest automatically generated (#1824)
20f026b6 feat(web-api): user id map in MigrationExchangeResponse as map (#1821)

What's Changed

The new feature available in this release is access to new Canvas APIs - programmatically manipulate your Canvases to your heart's content!

Additionally:

• Previously in v7 of web-api, if you were using an API method that required no arguments (e.g. api.test), you still had to pass it an empty object ({}). Thanks to @davidlj95's work in #1809, that is no longer a requirement!
• You can now set the attachOriginalToWebAPIRequestError to false to ensure API responses are not logged. By default, this option will be set to false. Many thanks to @Parama92 for their work in this area!

a2c0fe56 web-api: public canvas APIs (#1813)
9f2935ff feat: allow using WebClient APIs without argument (#1809) - fixes #1769; thank you @davidlj95 for your contribution! ❤️
b98ef1e1 feat: providing a way to disable message content being logged (#1786) - fixes #1751; thank you @Parama92 for your contribution! ❤️

What's Changed

The Image Block and Image Block Element now correctly support using either an image_url string or a slack_file object. The latter is particularly useful when wanting to display an image that is only uploaded within Slack, and not available via a public URL.

Also, the rich_text_quote Block Element had a missing border property. We have addressed this deficiency. Hooray!

aea11d00 Add slack_file object to image block/element types (#1783)
20899b01 Add missing border property to rich_text_quote block element (#1753)

What's Changed

A few new APIs were added: a suite of low-level shell process wrappers under shell.*, a new app.list command, and exposing QA environment targeting for all commands.

• cli-test: add ability to invoke arbitrary CLI commands by @filmaj in https://github.com/slackapi/node-slack-sdk/pull/1798
• cli-test: expose --slackdev flag as qa option to all commands by @filmaj in https://github.com/slackapi/node-slack-sdk/pull/1799
• cli-test: adding shell and app.list APIs, exposing QA environment flags, added more traces available in CLI v2.25.0 by @filmaj in https://github.com/slackapi/node-slack-sdk/pull/1804

What's Changed

First official GitHub release of the new cli-test module! This module aims to provide node.js bindings for the Slack Platform CLI.

9fb278a4 cli-test: small internal refactor to use new app.list command (#1797)
c3725a96 cli-test(trace): include test trace constants for 'datastore count' (#1795)
11cb80e5 cli-test: add app.list command (#1794)

New Contributors

• @zimeg made their first contribution in https://github.com/slackapi/node-slack-sdk/pull/1795

What's Changed

New major version! We have dropped the ancient, finite-state-machine-based implementation and ported the rock solid python-slack-sdk socket-mode implementation to node.

We also removed a couple of events and properties that are no longer relevant in the new implementation. Check out our socket mode 1.x -> 2.0 migration guide to get all the details and ease your upgrading path.

Full Changelog

476e6a9e socket-mode: Rewrite to Python(ish) Implementation (#1781)
3ebb6cef socket-mode: do not throw exception when calling disconnect() and already disconnected; do not raise slack_event in case of type:disconnect messages (#1762)
6ab1e68b socket-mode: add more debug logging to low level websocket event handlers (#1757)
46b500db socket-mode: fix bug when apps.connections.open returns an error and won't retry (#1735)
a6f2b283 socket-mode: prep for major release, start now completes only once Connected state is emitted (#1732)

Final 1.x Release

Please note that this will be the final planned release of @slack/socket-mode in the 1.x line. The next release will be 2.0, which will include a few breaking changes.

What's Changed

A few bug fixes and stability improvements were landed in this release:

• WebSocket messages of type:disconnect coming from the Slack backend should now consistently force-reconnect the socket mode client; previously certain type:disconnect messages (containing a specific reason property) were not treated in this way.
• All type:disconnect messages from the Slack backend now do not raise a slack_event event; this led to problems, particularly for users of bolt-js.
• Calling disconnect() if the client is already disconnected no longer raises an exception.

Full Changelog

dc489596 socket-mode: do not throw if calling disconnect() and already disconnected, and do not raise slack_event if message received is of type: disconnect

What's Changed

We released a fix for the oauth.v2.exchange method argument type; previously it did not require a token, which was incorrect. It now requires a token parameter, which matches the expectations of this API method.

Full Changelog

ae755dc4 web-api(fix): oauth.v2.exchange method requires a token parameter (#1779) - thanks for reporting @iggyray!

What's Changed

We've deprecated the files.upload method. Check out our announcement on the topic here. Instead, use the uploadV2 method provided by the client.

Full Changelog

ae9ace8b web-api(fix): fix node-retry types (#1772) - thanks @cotsupa!
fec4895f web-api(docs): Add deprecation JSdoc to files.upload method (#1773)
8bff32ff web-api(fix): Fix typo in error throwing for rate limit exceeded (#1755) - thanks @WhiteKiwi!

What's Changed

This major release bumps dependencies to their latest versions and sets the minimum node version is to v18, the current LTS node.js. While the library should work with older versions of node, we no longer test the library against versions of node older than 18, so we cannot guarantee compatibility.

In addition, calling disconnect() when already disconnected should no longer throw an exception (fixed https://github.com/slackapi/node-slack-sdk/issues/842).

What's Changed

A new doctor hook was added to surface certain runtime dependencies depended upon by your project! Stay tuned for an upcoming CLI release to find out how it'll be used. Hint: It's related to the doctor command 😉

Full Changelog

• 3e296410e26caa756f91f59ac37a950f59ca7ce4 feat: return runtime versions used by the application with a doctor hook (https://github.com/slackapi/node-slack-sdk/pull/1763)

https://github.com/slackapi/node-slack-sdk/compare/@slack/[email protected]...@slack/[email protected]

What's Changed

We added some more debug-level logging to the underlying socket connections used in this package. Now both primary and backup secondary websocket connections are identified in logs, and websocket-level events (like open and close) are logged out at the debug level.

Full Changelog

e3bf5cdb socket-mode: add more debug logging to low level websocket event handlers (#1757)

https://github.com/slackapi/node-slack-sdk/compare/@slack/[email protected]...@slack/[email protected]

What's Changed

Nothing major or even minor in this release! Just a few patches:

• web-api: prevent apps.event.authorizations.list API from ever sending token in the body by @filmaj in https://github.com/slackapi/node-slack-sdk/pull/1737
• web-api(fix): include file or contents types in file_uploads arguments by @zimeg in https://github.com/slackapi/node-slack-sdk/pull/1744
• web-api(fix): share tokens provided as arguments in files upload to upload jobs by @zimeg in https://github.com/slackapi/node-slack-sdk/pull/1745
• web-api(chore): release @slack/[email protected] by @zimeg in https://github.com/slackapi/node-slack-sdk/pull/1746

Full Changelog: https://github.com/slackapi/node-slack-sdk/compare/@slack/[email protected]...@slack/[email protected]

What's Changed

A new package has been introduced to enable inter-process communication between the Slack CLI and applications built with Bolt for JavaScript. That's this @slack/cli-hooks package!

More information on this package can be found on the package's README.md and releases are currently available on NPM.

Full Changelog

f3dff4d2d278d5a38de2c526b3a372017f4f95ca Introduce a @slack/cli-hooks package that implements Slack CLI hooks in https://github.com/slackapi/node-slack-sdk/pull/1714 - Thanks @zimeg @misscoded @WilliamBergamin @filmaj

What's Changed

The following methods were added to the web client to support functions.* methods:

• functions.completeError
• functions.completeSuccess

Full Changelog

4f393719e76236d8d3eb9e5961e6837045e445b4 Add support for functions.* (complete) methods in #1702 - Thanks @misscoded!

https://github.com/slackapi/node-slack-sdk/compare/@slack/[email protected]...@slack/[email protected]

What's Changed

Only relevant to consumers in TypeScript projects: we mistakenly removed the types for method arguments as exports in the 7.0.0 major release (e.g. ViewsPushArguments, etc. - any of the types listed in this file). These were available for consumers to import in the 6.x versions of web-api. Woops! This release simply adds these back in.

Full Changelog

d5c17d8 web-api: re-export method argument types (#1729)

What's Changed

This major release introduces two major changes:

• the minimum node version is now v18, the current LTS node.js. While the library should work with older versions of node, we no longer test the library against versions of node older than 18, so we cannot guarantee compatibility.
• the dependent @slack/web-api package has been updated to the latest major version, v7. While web-api is not directly exposed in this oauth library so it should not affect consuming applications, it is worth mentioning that the client methods web-api exposes has newer, stricter, more accurate TypeScript types. This should not affect developers, but is worth calling out.

No other changes were released!

What's Changed

There are two big (potentially) breaking changes library users should be aware of:

1. The minimum supported (and thus tested) version of node.js is now v18. While older versions of node should still work, we no longer guarantee this, especially now that versions of node.js older than 18 are end-of-life'd.
2. If you use this library in a TypeScript project, many of the HTTP API methods that this library exposes now have stricter, and more correct / accurate, argument types and constraints modeled.

But do not fear! We have written a migration guide for v6 -> v7 users which painstakingly list out the changes per-method, which should provide you with an easy upgrade process.

As usual, if you have trouble with this library, feel free to file an issue! We are here to help 🫂 😄

Much love,
The Slack DevRel Engineering team

Changelog

e29f6a1 Add support for overriding token when using fileUploadV2 (#1723 fixes #1644)
d53ef02 @slack/web-api argument type safety (#1673)
4a8eeac Remove warning about lack of fallback text from chat.update invocations (#1674)
6e8a31e Bump minimum node version to v18 (#1667)

This patch release bumps the @slack/web-api dependency up a patch version to address an underlying security vulnerability in the axios sub-dependency.

This patch release bumps the @slack/web-api dependency up a patch version to address an underlying security vulnerability in the axios sub-dependency.