Hallow gRPC

A Seamless gRPC web client library without code generation by plugin system

Usage

Example Protobuf

syntax = "proto3";

package greeting;

service Greeting {
    rpc Greeting (GreetingRequest) returns (GreetingResponse);
}

message GreetingRequest {
    string name = 1;
}

message GreetingResponse {
    string message = 1;
}

Promise API

import { Client } from "@hallow/grpc-web"
import { GreetingStub } from './greeting.proto'

const client = new Client({ baseURL: "/api" })
const greeter = new GreetingStub(client)

const res = await greeter.greeting({message: "Hello, Ryan!"})
console.log(`hello from server: ${res.message}`)

React Hook API (with Suspense)

import { Client } from "@hallow/grpc-web"
import { GreetingHookStub } from './greeting.proto'
import { ErrorBoundary } from "react-error-boundary";

const client = new Client({ baseURL: "/api" })
const greeter = new GreetingHookStub(client)

function Greeter() {
    const res = greeter.useGreeting({message: "Hello, Ryan!"})
    return <div>{`hello from server: ${res.message}`}</div>
}

function App() {
    return <Suspense fallback={"loading"}>
        <ErrorBoundary fallback={"Something went wrong"}>
            <Greeter />
        </ErrorBoundary>
    </Suspense>
}

Dependencies

• google-protobuf
• @improbable-eng/grpc-web