action-rpc library

action-rpc is an rpc library made with typescript. It uses action-rpc spec to communicate.

Server

First let's use the library to create a server

1// Server code
2const getUser = async (p: { id: string }, _body: null, _req: Request) => {
3	return {
4		body: {
5			user: {
6				id: p.id,
7				name: "Amy"
8			}
9		}
10	};
11};
12const postForm = async (_p: { id: string }, body: Record<string, string>) => {
13	if (!body.password || body.password != "password") return {
14		status: 400,
15		statusText: "Bad request.",
16		body: "Bad request."
17	};
18	return {
19		status: 200,
20		statusText: "Ok",
21		body: "Ok"
22	};
23};
24const app = service()
25	.action("GET", "getUser", getUser)
26	.action("POST", "postForm", postForm)
27	.build();
28const appHandler = actionHandler(app);
29// Hono app handler
30// ...
31export type AppService = typeof app;

Client

Then let's use service type declaration in a typed client:

1import { client, jsonBodyEncoder } from "action-rpc/client";
2import { ActionReturnType, _ActionParams } from "action-rpc";
3import { AppService } from "./path/to/server.ts"
4const action = client<typeof handlers>(new URL("your base url"))
5const result = await action({
6	method: "GET",
7	action: "getUser",
8	params: { id: "amy" },
9	body: null,
10});
11if(result.ok) {
12	// Here we use as because I didn't find any way to allow typed parsing of BodyInit
13	const json = (await result.result.json()) as ActionReturnType<typeof handlers, "GET", "getUser">;
14}