[public-api] Generate Go and TS Connect protos with buf

[easyCZ]

Description

Extends buf configuration to generate Connect interfaces for Go and TS.

The generates TS is API compatible, just uses modern TS

Related Issue(s)

• Part of Epic: Dashboard communicates with Public API #13574
• Depends on [public-api] Switch go codegen to buf #13579

How to test

builds

Release Notes

NONE

Documentation

Werft options:

• /werft with-local-preview
  If enabled this will build install/preview
• /werft with-preview
• /werft with-integration-tests=all
  Valid options are all, workspace, webapp, ide

[socket-security]

Socket Security Report

👍 No new dependency issues detected in pull request

Socket.dev scan summary

Issue	Status
Did you mean?	✅ no new possible package typos
Install scripts	✅ no new install scripts
Telemetry	✅ no new telemetry
Troll package	✅ no new troll packages
Malware	✅ no new malware
Native code	✅ no new native modules

Bot Commands

To ignore an alert, reply with a comment starting with @SocketSecurity ignore followed by a space separated list of package-name@version specifiers. e.g. @SocketSecurity ignore [email protected] [email protected]

Powered by socket.dev

[akosyakov]

@easyCZ I'm looking at generated code, and wonder how to use it? They seem to be specs of types and services.

[akosyakov]

/hold

code-generation works, but I'm not sure how to use generated code, there is also runtime deps to gitpod-protocol. Do we need it?

[easyCZ]

The dependency on gitpod-protocol is due to the NPM publish scripts which live in there. I'll add an example for how to use it with a client.

[akosyakov]

@easyCZ it should go to dev deps then otherwise it going to be pulled on npm install by clients

[easyCZ]

@akosyakov The way we use the client is here https://connect.build/docs/web/using-clients#promises

It's also implemented in the original Connect prototype here

[akosyakov]

nice!

[easyCZ]

@easyCZ it should go to dev deps then otherwise it going to be pulled on npm install by clients

Moved it to dev dependencies.

[akosyakov]

/unhold

[svenefftinge]

Looks good! I understood that we would use this API also from within node and go not only browsers, correct?
Also love this:

[geropl]

Awesome, really looking forward to actually use connect-web! 🙃

[easyCZ]

I understood that we would use this API also from within node and go not only browsers, correct?

Yes, we can. It doesn't remove our ability to use gRPC but we can use buf to get slightly simpler clients with less "fluff" that gRPC has. It's made more user-friendly.