Skip to content
kkRPC

HTTP

I will be using Hono for server because of its simplicity, but you can use kkRPC with any JS/TS HTTP server (e.g. Express, Fastify, http, Bun.serve, Deno.serve).

API Definitions

api.ts is where all the API definitions and implementations are (you can separate type and implementation into different files).

To add a new API method, just add a new method to the API type and implement it in the api object. Then you can call it directly in client.ts No need to touch server.ts.

api.ts
export type API = {
  echo: (message: string) => Promise<string>
  add: (a: number, b: number) => Promise<number>
}


export const api: API = {
  echo: (message) => {
    return Promise.resolve(message)
  },
  add: (a, b) => {
    return Promise.resolve(a + b)
  }
}

Server Setup

server.ts only needs to be setup once (no need to touch it later to add more API methods), and contain only one post route (/rpc).

server.ts
import { Hono } from "hono"
import { createHttpHandler } from "kkrpc/http"
import { apiImplementationNested, type APINested } from "./api.ts"


const handler = createHttpHandler(apiImplementationNested)


const app = new Hono()


app.post("/rpc", async (c) => {
  return c.text(await handler.handleRequest(await c.req.text()))
})


export default {
  port: 3000,
  fetch: app.fetch
}

bun server.ts to start the server.

Client

client.ts is how you use kkRPC to make RPC calls to the server.

Making an http RPC call is as simple as calling the methods defined in api.ts.

client.ts
import { createHttpClient } from "kkrpc/http"
import { api, type API } from "./api.ts"


const { api } = createHttpClient<API>("http://localhost:3000/rpc")


const echo = await api.echo("hello")
console.log("echo", echo)


const sum = await api.add(2, 3)
console.log("Sum: ", sum)

bun client.ts to test the API.