v0.8.0

[smaye81]

This repository now hosts Connect for Web, but also for Node.js. We changed the name to Connect-ES to reflect the universal nature. As part of the reorganization, this release includes new features, but also some breaking changes.

Connect for Web

This is the first release that shares important bits of code between the web and the Node implementation, and comes with some bug fixes and new features:

• Allow JSON in the gRPC-web transport of @bufbuild/connect-web #334
• Emit unpadded base64 for binary headers #454
• Way to recover from errors caused by non-compliant response body #469
• Switch @bufbuild/connect-web to use @bufbuild/connect #471

If you are using Interceptors, please note the breaking change described in #471.

Otherwise, this release is backwards compatible, but we kindly ask you to install @bufbuild/connect, and import ConnectError and other types from there. In the future, @bufbuild/connect-web will only export the Connect and gRPC-web transports.

Connect for Node.js

The Handlers introduced in the preview are gone! With the new ConnectRouter, we can support more frameworks, and this release adds adapters for Express and Fastify:

• Rename @bufbuild/connect-core to @bufbuild/connect #473
• Add support for Express #479
• Add support for Fastify #474
• Polyfill headers in connect-node #462

If you have been using Connect for Node, please remove @bufbuild/connect-core, install @bufbuild/connect instead, and update your imports. See here how to use ConnectRouter with a Node.js server.

protoc-gen-connect-web

The code generator plugin has been renamed to @bufbuild/protoc-gen-connect-es. The old one is still available, so you don't have to update right away. See here how to update.

Other changes

• NodeNext module resolution by @fubhy in Declare type exports #485

---

This discussion was created from the release v0.8.0.

[nicole0707]

I am surprised to discover Handlers in @bufbuild/connect-node, Is there any examples to cater for Next.js or any plans to support it? thanks.

[timostamm]

Hey Nicole, this release actually removes Handlers added in the previous release, and introduces ConnectRouter instead. I've updated the description to clarify. We're still updating the docs.

The motivation for that change was to enable support for more frameworks, such as Next.js. Can I ask how you want to use it?

[nicole0707]

Thanks @timostamm, we are planning to add gRPC service mocks with Next.js. I checked out the latest version @bufbuild/connect and @bufbuild/connect-express example, it would be better if there is a similar middleware for Next.js. Currently i set up a custome server with Next.js and @bufbuild/connect-express alternatively.

[timostamm]

The docs are now updated with a step-by-step tutorial and more information for running on Node.js.