The best way to control Claude Code, Codex and more from any computer or phone
| 1 | import { RpcSession, type RpcCompatible, type RpcTransport } from "capnweb"; |
| 2 | |
| 3 | /** |
| 4 | * A platform-agnostic interface for a server-side WebSocket. |
| 5 | */ |
| 6 | export interface ServerWebSocketLike { |
| 7 | send: (message: string) => any; |
| 8 | close: (code?: number, reason?: string) => void; |
| 9 | } |
| 10 | |
| 11 | /** |
| 12 | * Represents a websocket RPC session with capnweb. |
| 13 | * Use the `dispatch` object to handle messages that are received from the client. |
| 14 | */ |
| 15 | export type ServerRpcSession<T extends RpcCompatible<T>> = ReturnType< |
| 16 | typeof makeServerRpcSession<T> |
| 17 | >; |
| 18 | |
| 19 | /** |
| 20 | * Constructs a ServerRpcSession using capnweb. |
| 21 | * @param ws - The WebSocket to use for the session. |
| 22 | * @param main - The main object to use for the session. |
| 23 | * @returns A ServerRpcSession. |
| 24 | */ |
| 25 | export function makeServerRpcSession<T extends RpcCompatible<T>>(ws: ServerWebSocketLike, main: T) { |
| 26 | const { transport, dispatch } = makeWebSocketRpcTransport(ws); |
| 27 | const session = new RpcSession(transport, main); |
| 28 | return { session, dispatch }; |
| 29 | } |
| 30 | |
| 31 | function makeWebSocketRpcTransport(ws: ServerWebSocketLike) { |
| 32 | let receiveQueue: Array<string> = []; |
| 33 | let receiveResolver: ((value: string) => void) | undefined; |
| 34 | let receiveRejecter: ((reason: unknown) => void) | undefined; |
| 35 | let error: unknown; |
| 36 | return { |
| 37 | transport: { |
| 38 | send: async (message: string) => await ws.send(message), |
| 39 | receive: async () => { |
| 40 | const next = receiveQueue.shift(); |
| 41 | if (next) { |
| 42 | return next; |
| 43 | } else if (error) { |
| 44 | throw error; |
| 45 | } |
| 46 | return new Promise<string>((resolve, reject) => { |
| 47 | receiveResolver = resolve; |
| 48 | receiveRejecter = reject; |
| 49 | }); |
| 50 | }, |
| 51 | abort: (reason: unknown) => { |
| 52 | const message = reason instanceof Error ? reason.message : String(reason); |
| 53 | ws.close(3000, message); |
| 54 | error ??= reason; |
| 55 | }, |
| 56 | } satisfies RpcTransport, |
| 57 | dispatch: { |
| 58 | message: (data: string | Buffer<ArrayBuffer>) => { |
| 59 | if (error) { |
| 60 | return; |
| 61 | } |
| 62 | data = typeof data === "string" ? data : data.toString(); |
| 63 | if (receiveResolver) { |
| 64 | receiveResolver(data); |
| 65 | receiveResolver = undefined; |
| 66 | receiveRejecter = undefined; |
| 67 | } else { |
| 68 | receiveQueue.push(data); |
| 69 | } |
| 70 | }, |
| 71 | close: (code: number, reason: string) => { |
| 72 | if (!error) { |
| 73 | error = new Error(`WebSocket closed with code ${code}: ${reason}`); |
| 74 | if (receiveRejecter) { |
| 75 | receiveRejecter(error); |
| 76 | receiveRejecter = undefined; |
| 77 | receiveResolver = undefined; |
| 78 | } |
| 79 | } |
| 80 | }, |
| 81 | }, |
| 82 | }; |
| 83 | } |