chore: add Hono examples

examples/README.md

@@ -2,6 +2,7 @@ Examples
 
 - batch-pipelining: Node server + client. Shows batching and pipelining to execute a dependent sequence of RPC calls in a single HTTP round trip, with timing vs sequential.
 - worker-react: Cloudflare Worker backend + React frontend. Shows the same pattern from a browser app, served by the Worker.
+- hono: Cap'n Web servers on Cloudflare Workers / Deno / Node.js with Hono.
 
 Notes
 

examples/hono/.gitignore

@@ -0,0 +1,36 @@
+package-lock.json
+bun.lock
+
+# prod
+dist/
+
+# dev
+.yarn/
+!.yarn/releases
+.vscode/*
+!.vscode/launch.json
+!.vscode/*.code-snippets
+.idea/workspace.xml
+.idea/usage.statistics.xml
+.idea/shelf
+
+# deps
+node_modules/
+.wrangler
+
+# env
+.env
+.env.production
+.dev.vars
+
+# logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# misc
+.DS_Store

examples/hono/README.md

@@ -0,0 +1,31 @@
+Cap'n Web servers on Cloudflare Workers / Deno / Node.js with Hono.
+
+Cloudflare Workers:
+
+```console
+npm run dev:workers
+```
+
+Deno:
+
+```console
+npm run dev:deno
+```
+
+Node.js:
+
+```console
+npm run dev:node
+```
+
+Client:
+
+```console
+npm run client
+```
+
+Client with batch:
+
+```console
+npm run client:batch
+```

examples/hono/client/client-batch.ts

@@ -0,0 +1,6 @@
+import { newHttpBatchRpcSession, RpcStub } from '../../../dist/index.js'
+import type { PublicApi } from '../src/my-api-server'
+
+const stub: RpcStub<PublicApi> = newHttpBatchRpcSession<PublicApi>('http://localhost:8787/api')
+
+console.log(await stub.hello("Cap'n Web"))

examples/hono/client/client.ts

@@ -0,0 +1,6 @@
+import { newWebSocketRpcSession, RpcStub } from '../../../dist/index.js'
+import type { PublicApi } from '../src/my-api-server'
+
+using stub: RpcStub<PublicApi> = newWebSocketRpcSession<PublicApi>("ws://localhost:8787/api");
+
+console.log(await stub.hello('Cap\'n Web'))

examples/hono/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "my-capnweb-app",
+  "type": "module",
+  "scripts": {
+    "dev:workers": "wrangler dev",
+    "dev:deno": "deno serve --sloppy-imports --port 8787 --watch src/deno.ts",
+    "dev:node": "tsx --watch src/node.ts",
+    "client": "tsx client/client.ts",
+    "client:batch": "tsx client/client-batch.ts",
+    "cf-typegen": "wrangler types --env-interface CloudflareBindings"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.4",
+    "@hono/node-ws": "^1.2.0",
+    "hono": "^4.9.9"
+  },
+  "devDependencies": {
+    "tsx": "^4.20.6",
+    "wrangler": "^4.4.0"
+  }
+}

examples/hono/src/deno.ts

@@ -0,0 +1,23 @@
+import { Hono } from 'hono'
+import { upgradeWebSocket } from 'hono/deno'
+import { newHttpBatchRpcResponse, newWebSocketRpcSession } from '../../../dist/index.js'
+import { MyApiServer } from './my-api-server.ts'
+
+const app = new Hono()
+
+app.get(
+  '/api',
+  upgradeWebSocket((_c) => {
+    return {
+      onOpen(_event, ws) {
+        newWebSocketRpcSession(ws.raw!, new MyApiServer())
+      }
+    }
+  })
+)
+
+app.post('/api', (c) => {
+  return newHttpBatchRpcResponse(c.req.raw, new MyApiServer())
+})
+
+export default app

examples/hono/src/my-api-server.ts

@@ -0,0 +1,11 @@
+import { RpcTarget } from '../../../dist'
+
+export interface PublicApi {
+  hello(name: string): string
+}
+
+export class MyApiServer extends RpcTarget implements PublicApi {
+  hello(name: string) {
+    return `Hello, ${name}!`
+  }
+}

examples/hono/src/node.ts

@@ -0,0 +1,31 @@
+import { Hono } from 'hono'
+import { createNodeWebSocket } from '@hono/node-ws'
+import { serve } from '@hono/node-server'
+import { newHttpBatchRpcResponse, newWebSocketRpcSession } from '../../../dist/index.js'
+import { MyApiServer } from './my-api-server'
+
+const app = new Hono()
+
+const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app })
+
+app.get(
+  '/api',
+  upgradeWebSocket((_c) => {
+    return {
+      onOpen(_event, ws) {
+        newWebSocketRpcSession(ws.raw!, new MyApiServer())
+      }
+    }
+  })
+)
+
+app.post('/api', (c) => {
+  return newHttpBatchRpcResponse(c.req.raw, new MyApiServer())
+})
+
+const server = serve({
+  port: 8787,
+  fetch: app.fetch
+})
+
+injectWebSocket(server)

examples/hono/src/workers.ts

@@ -0,0 +1,11 @@
+import { Hono } from 'hono'
+import { newWorkersRpcResponse } from '../../../dist/index.js'
+import { MyApiServer } from './my-api-server'
+
+const app = new Hono()
+
+app.all('/api', (c) => {
+  return newWorkersRpcResponse(c.req.raw, new MyApiServer())
+})
+
+export default app

examples/hono/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "lib": [
+      "ESNext"
+    ],
+    "jsx": "react-jsx",
+    "jsxImportSource": "hono/jsx"
+  },
+}