connect es

Conecte -se ao ECMAScript

Connect é uma família de bibliotecas para criar APIs seguras de tipo com diferentes idiomas e plataformas. @Connectrpc/Connect os traz ao TypeScript, ao navegador da Web e ao Node.js.

Com o Connect, você define seu esquema primeiro:

 service ElizaService {
  rpc Say(SayRequest) returns (SayResponse) {}
}

E com a magia da geração de código, este esquema produz servidores e clientes:

 const answer = await eliza . say ( { sentence : "I feel happy." } ) ;
console . log ( answer ) ;
// {sentence: 'When you feel happy, what do you do?'}

Ao contrário do descanso, a chamada do procedimento remoto é segura por tipo, mas eles são HTTP regulares sob o capô. Você pode ver todas as solicitações no inspetor de rede e pode curl -as, se quiser:

curl 
    --header ' Content-Type: application/json ' 
    --data ' {"sentence": "I feel happy."} ' 
    https://demo.connectrpc.com/connectrpc.eliza.v1.ElizaService/Say

O Connect usa o Protobuf-es, a única biblioteca JavaScript do Protobuf totalmente compatível.

Connect implementa o RPC três protocolos: os protocolos GRPC e GRPC-WEB amplamente disponíveis e o próprio protocolo da Connect, otimizado para a Web. Isso oferece interoperabilidade incomparável em muitas plataformas e idiomas, com a ponta a ponta da segurança do tipo.

Comece na web

Siga nosso tutorial de 10 minutos, onde usamos o Vite e reaja para criar uma interface da Web para Eliza.

React , Site , Vue , Next.js e Angular são suportados (ver exemplos), e temos um pacote de expansão para o TanStack Query. Apoiamos todos os navegadores da Web modernos que implementam a API Fetch amplamente disponível e a API de codificação.

Comece no Node.js

Siga nosso tutorial de 10 minutos para aumentar um serviço no Node.js e ligue para a Web e de um cliente GRPC em seu terminal.

Você pode servir seus RPCs de conexão com baunilha node.js ou usar nossos plugins de servidor para o Fastify , Next.js e Express . Apoiamos o Node.js v18.14.1 e posterior com os módulos http e http2 construídos.

Migrando da versão 1

Se você estiver migrando de V1 para V2, consulte nosso Guia de Migração;

Outras plataformas

Você gostaria de usar o Connect em outras plataformas como BUN, Deno, Vercel's Edge Runtime, ou Cloudflare Workers? Adoraríamos aprender sobre seus casos de uso e o que você gostaria de fazer com o Connect. Você pode entrar em contato conosco através da folga do BUF ou arquivando um problema do Github e ficaríamos mais do que felizes em conversar!

Pacotes

• @ConnectRPC/Connect: RPC Clients and Servers para seu esquema (código -fonte).
• @Connectrpc/Connect-Web: adaptadores para navegadores da Web e qualquer outra plataforma que tenha a API buscar a bordo.
• @Connectrpc/Connect-Node: Sirva RPCs nos servidores Vanilla Node.js. Ligue para RPCs com qualquer protocolo.
• @Connectrpc/Connect-Fastify: conecte seus serviços a um servidor Fastify.
• @Connectrpc/Connect-Next: Sirva seus RPCs com as rotas da API Next.js.
• @Connectrpc/Connect-Express: adiciona seus serviços a um servidor expresso.

As bibliotecas e o código gerado são compatíveis com o ES2017 e o TypeScript 4.9.5.

Ecossistema

• Exemplos-es: Exemplos para usar Connect com várias estruturas da web TypeScript e ferramentas
• Connect-Query-es: Pacote de expansão TypeScript-primeiro
• Connect-playwright-es: testes de dramaturgo para o seu aplicativo Connect
• Connect-Swift: Idiomatic Grpc & Connect RPCs para Swift
• Connect-go: Go Implementation of GRPC, GRPC-Web e Connect
• Exemplos-Go: Exemplo de serviço RPC Powering https://demo.connectrends.com e construído com connect-go
• Conformância: GRPC-Web e Testes de interoperabilidade de conexão
• BUF Studio: UI da web para RPCs ad-hoc

Jurídico

Oferecido sob a licença Apache 2.