improbable-eng/grpc-web
Grpc Web
grpc-web est une couche de traduction et un système de proxy qui permet aux navigateurs web de communiquer avec des services backend gRPC. Il se compose d'un proxy gRPC Web qui convertit les requêtes HTTP et WebSocket basées sur le navigateur en appels gRPC standard, ainsi qu'un client gRPC TypeScript pour effectuer des appels de procédure distante fortement typés depuis des navigateurs ou des environnements Node.js.
Le projet propose un pont de streaming bidirectionnel qui utilise des WebSockets pour contourner les limitations du navigateur, permettant une communication full-duplex et le streaming de données côté client. Il inclut un générateur de code de protocol buffer qui analyse les fichiers de schéma pour produire des classes de requête et de réponse JavaScript et TypeScript typées.
Le système couvre un large éventail de capacités, notamment la sélection de transport, la gestion CORS pour restreindre les origines approuvées et la connectivité backend sécurisée via le chiffrement TLS. Il fournit également une surveillance du trafic proxy pour suivre les requêtes et les connexions via des métriques et des points de terminaison de débogage.
Features
- gRPC-Web Bridging - Implements a translation layer that converts browser-based gRPC-Web requests into standard gRPC server requests.
- Protocol Buffer Generators - Parses .proto files to generate typed JavaScript and TypeScript request and response classes.
- Schema-Based Code Generators - Parses Protocol Buffer schema files to generate typed request and response classes.
- TypeScript Stub Typings - Generates type-safe TypeScript declarations for gRPC client code in the browser.
- gRPC Code Generators - Automatically generates JavaScript and TypeScript client classes from Protocol Buffer service definitions.
- gRPC Implementations - Implements the translation of web requests into standard gRPC calls to allow browser-backend communication.
- HTTP-to-gRPC Transcoding - Converts browser-compatible HTTP requests into standard gRPC calls to bridge web clients and backends.
- Browser gRPC Clients - Connects web applications to gRPC backends by translating RPCs into browser-compatible HTTP protocols.
- gRPC-Web Clients - Provides client libraries that implement the gRPC-Web protocol for making requests from web browsers.
- Secure Proxy-to-Backend Connectivity - Establishes encrypted connections from the proxy to backend services using plaintext or TLS with custom certificates.
- Bidirectional WebSocket Streaming - Leverages WebSockets to enable full-duplex communication and bidirectional data streaming between browsers and servers.
- Server-Side Streaming - Enables the receipt of multiple response messages from a server for a single client request.
- WebSocket Transports - Uses the native WebSocket API to enable client-streaming and bidirectional data exchange.
- CORS Header Management - Manages allowed origins and CORS headers to control which web domains can access the proxy.
- Node.js Clients - Extends gRPC-Web communication to Node.js environments using specialized server-side transports.
- Node.js Integration - Executes gRPC client logic within a server-side JavaScript environment using specialized transport modules.
- Language Specific Libraries - Implementation of gRPC for web browsers using Go and TypeScript.
- Language Specific Tools - Implementation of gRPC-web for Go and TypeScript environments.
