connect es

Подключитесь к Ecmascript

Connect-это семейство библиотек для создания API-защитников с различными языками и платформами. @ConnectRpc/Connect приводит их в TypeScript, веб -браузер и в node.js.

С помощью Connect вы сначала определяете свою схему:

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

А с магией генерации кода эта схема производит серверы и клиенты:

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

В отличие от отдыха, вызов удаленной процедуры предоставляется типом, но они регулярно HTTP под капотом. Вы можете увидеть все запросы в сетевом инспекторе, и вы можете curl их, если хотите:

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

Connect использует Protobuf-ES, единственную полностью совместимую библиотеку JavaScript Protobuf.

Подключите реализацию RPC Три протокола: широко доступные протоколы GRPC и GRPC-WEB и собственный протокол Connect, оптимизированный для Интернета. Это дает вам беспрецедентную совместимость на многих платформах и языках, с сквозным типов.

Начните в Интернете

Следуйте нашему 10 -минутному уроку, где мы используем Vite и реагируете, чтобы создать веб -интерфейс для Элизы.

React , Svelte , Vue , Next.js и Angular поддерживаются (см. Примеры), и у нас есть пакет расширения для запроса Tanstack. Мы поддерживаем все современные веб -браузеры, которые реализуют широко доступные API Fetch и API кодирования.

Начните на node.js

Следуйте нашему 10 -минутному учебному пособию, чтобы развернуть сервис в node.js, и позвоните в Интернет, и от клиента GRPC в вашем терминале.

Вы можете обслуживать свои RPC Connect с ванильным узлом . Мы поддерживаем node.js v18.14.1, а затем с встроенными модулями http и http2 .

Мигрирование из версии 1

Если вы мигрируете с V1 на V2, ознакомьтесь с нашим руководством по миграции;

Другие платформы

Хотели бы вы использовать Connect на других платформах, таких как Bun, Deno, время выполнения Vercel's Edge или работники Cloudflare? Мы хотели бы узнать о ваших случаях использования и о том, что вы хотели бы сделать с Connect. Вы можете связаться с нами либо через Slack BUF, либо подав проблему GitHub, и мы будем более чем рады поболтать!

Пакеты

• @ConnectRpc/Connect: клиенты и серверы RPC для вашей схемы (исходный код).
• @Connectrpc/Connect-Web: адаптеры для веб-браузеров и любая другая платформа, на которой есть API Fetch на борту.
• @ConnectRpc/Connect-Node: подайте RPC на Vanilla Node.js Servers. Позвоните в RPC с любым протоколом.
• @Connectrectc/Connect-Fastify: подключите свои услуги к серверу фазвии.
• @Connectrectc/Connect-Next: подайте свои RPC с помощью маршрутов API Next.js.
• @Connectrectc/Connect-Express: добавляет ваши услуги на экспресс-сервер.

Библиотеки и сгенерированный код совместимы с ES2017 и TypeScript 4.9.5.

Экосистема

• Примеры-ES: примеры использования подключения с различными веб-структурами и инструментами TypeScript
• Connect-Query-ES: пакет расширения в сети-рамке для запроса Tanstack, который дает вам суперспособности Protobuf
• Connect-Playwright-ES: драматурные тесты для вашего приложения Connect
• Connect-Swift: идиоматический GRPC & Connect RPC для Swift
• Connect-GO: GO Реализация GRPC, GRPC-WEB и Connect
• Примеры-GO: Пример RPC Service Powering https://demo.connectrectc.com и создан с помощью Connect-Go
• Соответствие: grpc-web и подключить тесты взаимодействия
• BUF Studio: веб-интерфейс для Ad-HOC RPC

Юридический

Предлагается по лицензии Apache 2.