grpc-ts-demo

🎵 Music-themed demo of a fully typed gRPC client and server implementation in TypeScript. It implements each RPC type (unary, client streaming, server streaming and bidirectional), and uses type definitions generated with grpc_tools_node_protoc_ts.

The demo application takes the form of a CLI tool that allows you to manage and discuss your favourite songs. Watch demo.

Read the accompanying blog post here.

Install

yarn
yarn clean
yarn build

Usage

Start the server

yarn start serve

Unary: Get a random song

yarn start get-song

Client Streaming: Add songs

yarn start add-songs

The songs you add will be persisted to the local JSON store db.json.

Server Streaming: Get chat comments on a song

yarn start get-chat --songId <id>

Bidirectional Streaming: Live chat on a song

yarn start chat

Say you set your username as mike and you choose to discuss the song with id 10. Then, the application will dump chat messages to a local file called chat-mike-10.txt. You can observe messages as they come in:

watch cat chat-mike-10.txt

Go ahead and try running multiple chat clients at once!