ts-procedures 7.3.0 → 8.0.0

package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono.md

@@ -0,0 +1,223 @@
+# Hono Template: {{Name}}
+
+A single `HonoAppBuilder` can host all four procedure kinds — RPC (`Create`), RPC stream (`CreateStream`), HTTP REST (`CreateHttp`), and HTTP stream (`CreateHttpStream`) — registered against one `Procedures` factory and mounted with one `register(...)` call. This template demonstrates that.
+
+## Implementation — `{{Name}}.hono.ts`
+
+```typescript
+import { Procedures } from 'ts-procedures'
+import type { RPCConfig } from 'ts-procedures/http'
+import { defineErrorTaxonomy, HonoAppBuilder } from 'ts-procedures/hono'
+import { Type } from 'typebox'
+
+// ─── Context ──────────────────────────────────────────────
+
+type {{Name}}Context = {
+  userId: string
+  requestId: string
+}
+
+// ─── Procedures ───────────────────────────────────────────
+// Capture the factory in a single `procs` variable so every kind shares
+// the same context type and the same final register() call.
+
+const procs = Procedures<{{Name}}Context, RPCConfig>()
+
+// RPC — `Create`. Mounted at POST /api/{{kebab}}/get-item/1
+export const { GetItem } = procs.Create(
+  'GetItem',
+  {
+    scope: '{{kebab}}',
+    version: 1,
+    description: 'Fetch an item by id (RPC).',
+    schema: {
+      params: Type.Object({
+        id: Type.String(),
+      }),
+      returnType: Type.Object({
+        id: Type.String(),
+        name: Type.String(),
+      }),
+    },
+  },
+  async (ctx, params) => {
+    // TODO: implement
+    return { id: params.id, name: 'Example' }
+  }
+)
+
+// RPC stream — `CreateStream`. Mounted at POST /api/{{kebab}}/stream-events/1 (SSE)
+export const { StreamEvents } = procs.CreateStream(
+  'StreamEvents',
+  {
+    scope: '{{kebab}}',
+    version: 1,
+    description: 'Stream events for the given subject (rpc-stream / SSE).',
+    schema: {
+      params: Type.Object({
+        subject: Type.String(),
+      }),
+      yieldType: Type.Object({
+        seq: Type.Number(),
+        message: Type.String(),
+      }),
+    },
+  },
+  async function* (ctx, params) {
+    // ctx.signal is guaranteed for streams. Pass it to all downstream async work.
+    for (let seq = 0; seq < 3; seq++) {
+      if (ctx.signal.aborted) return
+      yield { seq, message: `event-${params.subject}-${seq}` }
+    }
+  }
+)
+
+// HTTP REST — `CreateHttp`. Mounted at GET /api/{{kebab}}/:id
+export const { GetUser } = procs.CreateHttp(
+  'GetUser',
+  {
+    path: '/{{kebab}}/:id',
+    method: 'get',
+    description: 'Fetch a user (REST).',
+    schema: {
+      req: {
+        pathParams: Type.Object({ id: Type.String() }),
+      },
+      res: {
+        body: Type.Object({
+          id: Type.String(),
+          name: Type.String(),
+        }),
+      },
+    },
+  },
+  async (ctx, { pathParams }) => {
+    // TODO: implement
+    return { id: pathParams.id, name: 'Example' }
+  }
+)
+
+// HTTP stream — `CreateHttpStream`. Mounted at GET /api/{{kebab}}/:id/watch (text/event-stream)
+export const { WatchUser } = procs.CreateHttpStream(
+  'WatchUser',
+  {
+    path: '/{{kebab}}/:id/watch',
+    method: 'get',
+    description: 'Server-sent stream of user updates (http-stream).',
+    schema: {
+      req: {
+        pathParams: Type.Object({ id: Type.String() }),
+      },
+      yield: Type.Object({
+        id: Type.String(),
+        revision: Type.Number(),
+      }),
+    },
+  },
+  async function* (ctx, { pathParams }) {
+    for (let revision = 1; revision <= 3; revision++) {
+      if (ctx.signal.aborted) return
+      yield { id: pathParams.id, revision }
+    }
+  }
+)
+
+// ─── Error Taxonomy ───────────────────────────────────────
+// Declare the error classes this service throws. Framework errors
+// (ProcedureValidationError → 400, ctx.error() → 500) are caught by the
+// default taxonomy automatically. Add your own classes here — handlers just
+// `throw` them and the builder serializes via this map. See
+// docs/http-integrations.md#error-handling for the full contract.
+
+const {{name}}Errors = defineErrorTaxonomy({
+  // Example — replace with your app's error classes:
+  // NotFoundError: { class: NotFoundError, statusCode: 404 },
+  // AuthError:     { class: AuthError,     statusCode: 401 },
+})
+
+// ─── Hono App Builder ─────────────────────────────────────
+// One builder, one register() call, all four kinds. Config is stratified by
+// kind: rpc.{onSuccess}, api.{queryParser, onSuccess}, stream.{...}. Cross-cutting
+// concerns (errors, unknownError, onError, onRequestError, onRequestStart/End,
+// pathPrefix) live at the top level. See src/implementations/http/hono/types.ts.
+
+// Optional observers (uncomment as needed):
+// onRequestStart: (c) => {...}                           // every inbound request (all kinds)
+// rpc:    { onSuccess: (procedure, c) => {...} }         // successful RPC (Create) responses
+// api:    { onSuccess: (procedure, c) => {...} }         // successful REST (CreateHttp) responses
+// stream: { onStreamStart: (procedure, c, mode) => {...}, onStreamEnd: (procedure, c, mode) => {...} }
+
+const {{name}}Builder = new HonoAppBuilder({
+  pathPrefix: '/api',
+  errors: {{name}}Errors,
+  unknownError: {
+    statusCode: 500,
+    toResponse: () => ({ name: 'InternalServerError', message: 'Unexpected error' }),
+    onCatch: (err, { procedure }) => console.error(`[${procedure.name}]`, err),
+  },
+})
+  .register(procs, (c) => ({
+    userId: c.req.header('x-user-id') || 'anonymous',
+    requestId: c.req.header('x-request-id') || crypto.randomUUID(),
+  }))
+
+export const {{name}}App = {{name}}Builder.build()
+
+// Route map:
+// POST /api/{{kebab}}/get-item/1            → RPC          (Create)
+// POST /api/{{kebab}}/stream-events/1       → RPC stream   (CreateStream, SSE)
+// GET  /api/{{kebab}}/:id                   → REST         (CreateHttp)
+// GET  /api/{{kebab}}/:id/watch             → HTTP stream  (CreateHttpStream, SSE)
+
+// Documentation: {{name}}Builder.docs or {{name}}Builder.toDocEnvelope()
+```
+
+## Test — `{{Name}}.hono.test.ts`
+
+```typescript
+import { describe, test, expect } from 'vitest'
+import { {{name}}App } from './{{Name}}.hono'
+
+describe('{{Name}} Hono — all four kinds', () => {
+  test('Create (RPC) — POST /api/{{kebab}}/get-item/1', async () => {
+    const res = await {{name}}App.request('/api/{{kebab}}/get-item/1', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id: 'item-1' }),
+    })
+    expect(res.status).toBe(200)
+    expect(await res.json()).toEqual({ id: 'item-1', name: 'Example' })
+  })
+
+  test('CreateStream (rpc-stream) — POST /api/{{kebab}}/stream-events/1 yields SSE', async () => {
+    const res = await {{name}}App.request('/api/{{kebab}}/stream-events/1', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ subject: 'orders' }),
+    })
+    expect(res.status).toBe(200)
+    expect(res.headers.get('content-type') ?? '').toContain('text/event-stream')
+
+    const text = await res.text()
+    // Yielded events are emitted as SSE `data:` frames.
+    expect(text).toContain('event-orders-0')
+    expect(text).toContain('event-orders-2')
+  })
+
+  test('CreateHttp (REST) — GET /api/{{kebab}}/:id', async () => {
+    const res = await {{name}}App.request('/api/{{kebab}}/u-1')
+    expect(res.status).toBe(200)
+    expect(await res.json()).toEqual({ id: 'u-1', name: 'Example' })
+  })
+
+  test('CreateHttpStream (http-stream) — GET /api/{{kebab}}/:id/watch yields SSE', async () => {
+    const res = await {{name}}App.request('/api/{{kebab}}/u-1/watch')
+    expect(res.status).toBe(200)
+    expect(res.headers.get('content-type') ?? '').toContain('text/event-stream')
+
+    const text = await res.text()
+    expect(text).toContain('"revision":1')
+    expect(text).toContain('"revision":3')
+  })
+})
+```

package/agent_config/copilot/copilot-instructions.md

@@ -26,18 +26,15 @@ import { ProcedureError, ProcedureValidationError, ProcedureYieldValidationError
 // HTTP types
 import type { RPCConfig, RPCHttpRouteDoc, StreamHttpRouteDoc, StreamMode } from 'ts-procedures/http'
 
-// Express RPC
-import { ExpressRPCAppBuilder } from 'ts-procedures/express-rpc'
-
 // Hono RPC
-import { HonoRPCAppBuilder } from 'ts-procedures/hono-rpc'
+import { HonoAppBuilder } from 'ts-procedures/hono'
 
 // Hono Streaming
-import { HonoStreamAppBuilder, sse } from 'ts-procedures/hono-stream'
+import { HonoAppBuilder, sse } from 'ts-procedures/hono'
 
 // Hono API (REST-style)
-import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
-import type { APIConfig, APIInput } from 'ts-procedures/hono-api'
+import { HonoAppBuilder } from 'ts-procedures/hono'
+import type { APIConfig, APIInput } from 'ts-procedures/hono'
 
 // Doc Registry — compose route docs from multiple builders
 import { DocRegistry } from 'ts-procedures/http-docs'
@@ -114,31 +111,12 @@ const { StreamEvents } = CreateStream(
 )
 ```
 
-## Express RPC Pattern
-
-```typescript
-import { ExpressRPCAppBuilder } from 'ts-procedures/express-rpc'
-import type { RPCConfig } from 'ts-procedures/http'
-
-const RPC = Procedures<AppContext, RPCConfig>()
-
-RPC.Create('GetUser', {
-  scope: 'users', version: 1,
-  schema: { params: Type.Object({ id: Type.String() }) },
-}, async (ctx, params) => fetchUser(params.id))
-
-const app = new ExpressRPCAppBuilder({ pathPrefix: '/api' })
-  .register(RPC, async (req) => ({ userId: await authenticate(req) }))
-  .build()
-// POST /api/users/get-user/1
-```
-
 ## Hono RPC Pattern
 
 ```typescript
-import { HonoRPCAppBuilder } from 'ts-procedures/hono-rpc'
+import { HonoAppBuilder } from 'ts-procedures/hono'
 
-const app = new HonoRPCAppBuilder({ pathPrefix: '/api' })
+const app = new HonoAppBuilder({ pathPrefix: '/api' })
   .register(RPC, (c) => ({ userId: c.req.header('x-user-id') }))
   .build()
 ```
@@ -146,7 +124,7 @@ const app = new HonoRPCAppBuilder({ pathPrefix: '/api' })
 ## Hono Streaming Pattern
 
 ```typescript
-import { HonoStreamAppBuilder, sse } from 'ts-procedures/hono-stream'
+import { HonoAppBuilder, sse } from 'ts-procedures/hono'
 
 const StreamRPC = Procedures<AppContext, RPCConfig>()
 
@@ -160,43 +138,53 @@ StreamRPC.CreateStream('Feed', {
   }
 })
 
-const app = new HonoStreamAppBuilder({ defaultStreamMode: 'sse' })
+const app = new HonoAppBuilder({ defaultStreamMode: 'sse' })
   .register(StreamRPC, (c) => ({ userId: c.req.header('x-user-id') }))
   .build()
 // GET|POST /events/feed/1
 ```
 
-## Hono API Pattern (REST-style)
+## Hono API Pattern (REST-style) — v8 `CreateHttp`
+
+In v8, HTTP routes use `CreateHttp` (not `Create + APIConfig`). `schema.input` is renamed `schema.req`. The factory needs no `APIConfig` type parameter.
 
 ```typescript
-import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
-import type { APIConfig } from 'ts-procedures/http'
+import { HonoAppBuilder } from 'ts-procedures/hono'
 
-const API = Procedures<AppContext, APIConfig>()
+const API = Procedures<AppContext>()
 
-API.Create('GetUser', {
+API.CreateHttp('GetUser', {
   path: '/users/:id', method: 'get',
   schema: {
-    input: { pathParams: Type.Object({ id: Type.String() }) },
+    req: { pathParams: Type.Object({ id: Type.String() }) },
+    res: { body: Type.Object({ id: Type.String(), name: Type.String() }) },
   },
 }, async (ctx, { pathParams }) => fetchUser(pathParams.id))
 
-API.Create('CreateUser', {
+API.CreateHttp('CreateUser', {
   path: '/users', method: 'post',
   schema: {
-    input: { body: Type.Object({ name: Type.String() }) },
+    req: { body: Type.Object({ name: Type.String() }) },
   },
 }, async (ctx, { body }) => createUser(body))
 
-const app = new HonoAPIAppBuilder({ pathPrefix: '/api' })
+const app = new HonoAppBuilder({ pathPrefix: '/api' })
   .register(API, (c) => ({ userId: c.req.header('x-user-id') }))
   .build()
 // GET /api/users/:id → 200, POST /api/users → 201
 ```
 
+**v7 → v8 migration:**
+
+1. `Procedures<Ctx, APIConfig>()` → `Procedures<Ctx>()`
+2. `.Create(` → `.CreateHttp(` for HTTP routes
+3. `schema.input` → `schema.req` (same channels: `pathParams`, `query`, `body`, `headers`)
+4. Move response type to `schema.res.body` (optional)
+5. Re-run `npx ts-procedures-codegen`
+
 ## Astro adapter
 
-Catch-all endpoint pattern. Build Hono apps once with HonoAPI/RPC/Stream builders, mount via `createAstroHandler` in `src/pages/api/[...rest].ts` with `pathPrefix: '/api'`. Read Astro context inside factory closures with `getAstroContext(c)`. Multi-app dispatch is first-non-404-wins. Express builders are not supported.
+Catch-all endpoint pattern. Build Hono apps once with `HonoAppBuilder`, mount via `createAstroHandler` in `src/pages/api/[...rest].ts` with `pathPrefix: '/api'`. Read Astro context inside factory closures with `getAstroContext(c)`. Multi-app dispatch is first-non-404-wins.
 
 ## Error Handling
 
@@ -209,7 +197,7 @@ Catch-all endpoint pattern. Build Hono apps once with HonoAPI/RPC/Stream builder
 
 ### Error Taxonomy (required for custom errors)
 
-`defineErrorTaxonomy` maps error classes to HTTP responses declaratively. Works with every HTTP builder (`hono-api`, `hono-rpc`, `express-rpc`, `hono-stream` pre-stream).
+`defineErrorTaxonomy` maps error classes to HTTP responses declaratively. Works with `HonoAppBuilder` for `rpc`, `http`, and pre-stream paths (`rpc-stream` / `http-stream`).
 
 Do NOT write `onError` `instanceof` ladders — that's anti-pattern #20. Use the taxonomy instead:
 
@@ -239,13 +227,13 @@ const appErrors = defineErrorTaxonomy({
   },
 })
 
-new HonoAPIAppBuilder({
+new HonoAppBuilder({
   errors: appErrors,
   unknownError: { statusCode: 500, toResponse: () => ({ name: 'InternalServerError' }) },
 })
 ```
 
-Handlers throw the error classes directly — the builder auto-serializes. `onError` is the first-class imperative peer when you want to handle errors in one callback instead (both modes coexist). In v6 `HonoStreamAppBuilder.onPreStreamError` was renamed to `onError`. Cross-cutting `onRequestError` observer fires for every caught error.
+Handlers throw the error classes directly — the builder auto-serializes. `onError` is the first-class imperative peer when you want to handle errors in one callback instead (both modes coexist). In v6 `HonoAppBuilder.onPreStreamError` was renamed to `onError`. Cross-cutting `onRequestError` observer fires for every caught error.
 
 ### Per-route errors (typed)
 
@@ -313,10 +301,7 @@ onRequestStart → factoryContext() → validation → onStreamStart → handler
 - **TypeBox** (`import { Type } from 'typebox'`)
 
 **Which HTTP implementation?**
-- Express → `ExpressRPCAppBuilder`
-- Hono (standard) → `HonoRPCAppBuilder`
-- Hono (streaming) → `HonoStreamAppBuilder`
-- Hono (REST-style, per-channel input) → `HonoAPIAppBuilder`
+- Hono (RPC, streams, REST, REST streams) → `HonoAppBuilder`
 
 **Stream mode?**
 - Browser EventSource → `'sse'` (default)
@@ -329,13 +314,14 @@ onRequestStart → factoryContext() → validation → onStreamStart → handler
 3. **Never put validation logic in handler** — use `schema.params`
 4. **Never ignore ctx.signal** — pass to all async calls
 5. **Never skip signal.aborted check in stream loops** — causes resource leaks
-6. **Never register Create procedures with HonoStreamAppBuilder** — they're silently ignored
+6. **Never register Create procedures with HonoAppBuilder** — they're silently ignored
 7. **Never use plain JSON Schema objects** — use TypeBox builders
 8. **Never swallow errors without re-throwing** — hides failures
 9. **Never assume extra params fields survive** — `removeAdditional: true` strips them
 10. **Never manually parse types AJV coerces** — `coerceTypes: true` handles it
 11. **Never define both schema.params and schema.input** — mutually exclusive, throws ProcedureRegistrationError
 12. **Never catch raw DOMException/TypeError from generated callables** — catch `ClientTimeoutError`, `ClientAbortError`, `ClientNetworkError` instead; or use `.safe()` for Result-based narrowing
+13. **Never use `Create` for HTTP routes (v8+)** — use `CreateHttp` (unary) or `CreateHttpStream` (streaming); `schema.input` → `schema.req`; `Procedures<Ctx, APIConfig>()` → `Procedures<Ctx>()`
 
 ## Testing
 

package/agent_config/cursor/cursorrules

@@ -26,18 +26,15 @@ import { ProcedureError, ProcedureValidationError, ProcedureYieldValidationError
 // HTTP types
 import type { RPCConfig, RPCHttpRouteDoc, StreamHttpRouteDoc, StreamMode } from 'ts-procedures/http'
 
-// Express RPC
-import { ExpressRPCAppBuilder } from 'ts-procedures/express-rpc'
-
 // Hono RPC
-import { HonoRPCAppBuilder } from 'ts-procedures/hono-rpc'
+import { HonoAppBuilder } from 'ts-procedures/hono'
 
 // Hono Streaming
-import { HonoStreamAppBuilder, sse } from 'ts-procedures/hono-stream'
+import { HonoAppBuilder, sse } from 'ts-procedures/hono'
 
 // Hono API (REST-style)
-import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
-import type { APIConfig, APIInput } from 'ts-procedures/hono-api'
+import { HonoAppBuilder } from 'ts-procedures/hono'
+import type { APIConfig, APIInput } from 'ts-procedures/hono'
 
 // Doc Registry — compose route docs from multiple builders
 import { DocRegistry } from 'ts-procedures/http-docs'
@@ -114,31 +111,12 @@ const { StreamEvents } = CreateStream(
 )
 ```
 
-## Express RPC Pattern
-
-```typescript
-import { ExpressRPCAppBuilder } from 'ts-procedures/express-rpc'
-import type { RPCConfig } from 'ts-procedures/http'
-
-const RPC = Procedures<AppContext, RPCConfig>()
-
-RPC.Create('GetUser', {
-  scope: 'users', version: 1,
-  schema: { params: Type.Object({ id: Type.String() }) },
-}, async (ctx, params) => fetchUser(params.id))
-
-const app = new ExpressRPCAppBuilder({ pathPrefix: '/api' })
-  .register(RPC, async (req) => ({ userId: await authenticate(req) }))
-  .build()
-// POST /api/users/get-user/1
-```
-
 ## Hono RPC Pattern
 
 ```typescript
-import { HonoRPCAppBuilder } from 'ts-procedures/hono-rpc'
+import { HonoAppBuilder } from 'ts-procedures/hono'
 
-const app = new HonoRPCAppBuilder({ pathPrefix: '/api' })
+const app = new HonoAppBuilder({ pathPrefix: '/api' })
   .register(RPC, (c) => ({ userId: c.req.header('x-user-id') }))
   .build()
 ```
@@ -146,7 +124,7 @@ const app = new HonoRPCAppBuilder({ pathPrefix: '/api' })
 ## Hono Streaming Pattern
 
 ```typescript
-import { HonoStreamAppBuilder, sse } from 'ts-procedures/hono-stream'
+import { HonoAppBuilder, sse } from 'ts-procedures/hono'
 
 const StreamRPC = Procedures<AppContext, RPCConfig>()
 
@@ -160,43 +138,53 @@ StreamRPC.CreateStream('Feed', {
   }
 })
 
-const app = new HonoStreamAppBuilder({ defaultStreamMode: 'sse' })
+const app = new HonoAppBuilder({ defaultStreamMode: 'sse' })
   .register(StreamRPC, (c) => ({ userId: c.req.header('x-user-id') }))
   .build()
 // GET|POST /events/feed/1
 ```
 
-## Hono API Pattern (REST-style)
+## Hono API Pattern (REST-style) — v8 `CreateHttp`
+
+In v8, HTTP routes use `CreateHttp` (not `Create + APIConfig`). `schema.input` is renamed `schema.req`. The factory needs no `APIConfig` type parameter.
 
 ```typescript
-import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
-import type { APIConfig } from 'ts-procedures/http'
+import { HonoAppBuilder } from 'ts-procedures/hono'
 
-const API = Procedures<AppContext, APIConfig>()
+const API = Procedures<AppContext>()
 
-API.Create('GetUser', {
+API.CreateHttp('GetUser', {
   path: '/users/:id', method: 'get',
   schema: {
-    input: { pathParams: Type.Object({ id: Type.String() }) },
+    req: { pathParams: Type.Object({ id: Type.String() }) },
+    res: { body: Type.Object({ id: Type.String(), name: Type.String() }) },
   },
 }, async (ctx, { pathParams }) => fetchUser(pathParams.id))
 
-API.Create('CreateUser', {
+API.CreateHttp('CreateUser', {
   path: '/users', method: 'post',
   schema: {
-    input: { body: Type.Object({ name: Type.String() }) },
+    req: { body: Type.Object({ name: Type.String() }) },
   },
 }, async (ctx, { body }) => createUser(body))
 
-const app = new HonoAPIAppBuilder({ pathPrefix: '/api' })
+const app = new HonoAppBuilder({ pathPrefix: '/api' })
   .register(API, (c) => ({ userId: c.req.header('x-user-id') }))
   .build()
 // GET /api/users/:id → 200, POST /api/users → 201
 ```
 
+**v7 → v8 migration:**
+
+1. `Procedures<Ctx, APIConfig>()` → `Procedures<Ctx>()`
+2. `.Create(` → `.CreateHttp(` for HTTP routes
+3. `schema.input` → `schema.req` (same channels: `pathParams`, `query`, `body`, `headers`)
+4. Move response type to `schema.res.body` (optional)
+5. Re-run `npx ts-procedures-codegen`
+
 ## Astro adapter
 
-Catch-all endpoint pattern. Build Hono apps once with HonoAPI/RPC/Stream builders, mount via `createAstroHandler` in `src/pages/api/[...rest].ts` with `pathPrefix: '/api'`. Read Astro context inside factory closures with `getAstroContext(c)`. Multi-app dispatch is first-non-404-wins. Express builders are not supported.
+Catch-all endpoint pattern. Build Hono apps once with `HonoAppBuilder`, mount via `createAstroHandler` in `src/pages/api/[...rest].ts` with `pathPrefix: '/api'`. Read Astro context inside factory closures with `getAstroContext(c)`. Multi-app dispatch is first-non-404-wins.
 
 ## Error Handling
 
@@ -209,7 +197,7 @@ Catch-all endpoint pattern. Build Hono apps once with HonoAPI/RPC/Stream builder
 
 ### Error Taxonomy (required for custom errors)
 
-`defineErrorTaxonomy` maps error classes to HTTP responses declaratively. Works with every HTTP builder (`hono-api`, `hono-rpc`, `express-rpc`, `hono-stream` pre-stream).
+`defineErrorTaxonomy` maps error classes to HTTP responses declaratively. Works with `HonoAppBuilder` for `rpc`, `http`, and pre-stream paths (`rpc-stream` / `http-stream`).
 
 Do NOT write `onError` `instanceof` ladders — that's anti-pattern #20. Use the taxonomy instead:
 
@@ -239,13 +227,13 @@ const appErrors = defineErrorTaxonomy({
   },
 })
 
-new HonoAPIAppBuilder({
+new HonoAppBuilder({
   errors: appErrors,
   unknownError: { statusCode: 500, toResponse: () => ({ name: 'InternalServerError' }) },
 })
 ```
 
-Handlers throw the error classes directly — the builder auto-serializes. `onError` is the first-class imperative peer when you want to handle errors in one callback instead (both modes coexist). In v6 `HonoStreamAppBuilder.onPreStreamError` was renamed to `onError`. Cross-cutting `onRequestError` observer fires for every caught error.
+Handlers throw the error classes directly — the builder auto-serializes. `onError` is the first-class imperative peer when you want to handle errors in one callback instead (both modes coexist). In v6 `HonoAppBuilder.onPreStreamError` was renamed to `onError`. Cross-cutting `onRequestError` observer fires for every caught error.
 
 ### Per-route errors (typed)
 
@@ -313,10 +301,7 @@ onRequestStart → factoryContext() → validation → onStreamStart → handler
 - **TypeBox** (`import { Type } from 'typebox'`)
 
 **Which HTTP implementation?**
-- Express → `ExpressRPCAppBuilder`
-- Hono (standard) → `HonoRPCAppBuilder`
-- Hono (streaming) → `HonoStreamAppBuilder`
-- Hono (REST-style, per-channel input) → `HonoAPIAppBuilder`
+- Hono (RPC, streams, REST, REST streams) → `HonoAppBuilder`
 
 **Stream mode?**
 - Browser EventSource → `'sse'` (default)
@@ -329,13 +314,14 @@ onRequestStart → factoryContext() → validation → onStreamStart → handler
 3. **Never put validation logic in handler** — use `schema.params`
 4. **Never ignore ctx.signal** — pass to all async calls
 5. **Never skip signal.aborted check in stream loops** — causes resource leaks
-6. **Never register Create procedures with HonoStreamAppBuilder** — they're silently ignored
+6. **Never register Create procedures with HonoAppBuilder** — they're silently ignored
 7. **Never use plain JSON Schema objects** — use TypeBox builders
 8. **Never swallow errors without re-throwing** — hides failures
 9. **Never assume extra params fields survive** — `removeAdditional: true` strips them
 10. **Never manually parse types AJV coerces** — `coerceTypes: true` handles it
 11. **Never define both schema.params and schema.input** — mutually exclusive, throws ProcedureRegistrationError
 12. **Never catch raw DOMException/TypeError from generated callables** — catch `ClientTimeoutError`, `ClientAbortError`, `ClientNetworkError` instead; or use `.safe()` for Result-based narrowing
+13. **Never use `Create` for HTTP routes (v8+)** — use `CreateHttp` (unary) or `CreateHttpStream` (streaming); `schema.input` → `schema.req`; `Procedures<Ctx, APIConfig>()` → `Procedures<Ctx>()`
 
 ## Testing
 

package/build/client/call.js

@@ -84,7 +84,10 @@ export async function executeCall(config) {
             scope: descriptor.scope,
         });
     }
-    // 8. Return the body
+    // 8. Return the body (or { body, headers } when the route declares res.headers)
+    if (descriptor.responseHeadersDeclared) {
+        return { body: response.body, headers: response.headers };
+    }
     return response.body;
 }
 /**

package/build/client/call.js.map

@@ -1 +1 @@
-{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/client/call.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/client/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAwB1D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAY,MAAyB;IACpE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;IAEzF,iEAAiE;IACjE,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACrE,IAAI,OAAO,GAAG,mBAAmB,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;IAE/D,kEAAkE;IAClE,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IACzB,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;IAE3C,oEAAoE;IACpE,MAAM,SAAS,GAAG,MAAM,gBAAgB,CACtC,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EACpE,KAAK,EACL,OAAO,CACR,CAAA;IACD,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;IAE3B,sBAAsB;IACtB,IAAI,QAAQ,CAAA;IACZ,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,4EAA4E;QAC5E,0DAA0D;QAC1D,MAAM,WAAW,GAAyB;YACxC,aAAa,EAAE,UAAU,CAAC,IAAI;YAC9B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,aAAa,EAAE,aAAa,CAAC,aAAa;YAC1C,UAAU,EAAE,aAAa,CAAC,UAAU;YACpC,SAAS,EAAE,aAAa,CAAC,SAAS;SACnC,CAAA;QACD,MAAM,UAAU,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;YAC5C,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAC3C,4EAA4E;QAC5E,iEAAiE;QACjE,uEAAuE;QACvE,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;YACxE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,CAAC;gBAAC,UAAU,CAAC,KAAoD,CAAC,kBAAkB,GAAG,UAAU,CAAC,IAAI,CAAA;YACxG,CAAC;QACH,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,EAAE,KAAK,IAAI,MAAM,CAAA;QAE9C,MAAM,UAAU,CACd,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EACvF,KAAK,EACL,OAAO,CACR,CAAA;QACD,MAAM,UAAU,CAAA;IAClB,CAAC;IAED,kFAAkF;IAClF,MAAM,gBAAgB,CACpB,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAC9E,KAAK,EACL,OAAO,CACR,CAAA;IAED,sFAAsF;IACtF,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,kBAAkB,CAAC,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;YAC7D,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,aAAa,EAAE,UAAU,CAAC,IAAI;YAC9B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAA;QACF,IAAI,KAAK,EAAE,CAAC;YACV,0EAA0E;YAC1E,sDAAsD;YACtD,CAAC;YAAC,KAAsD,CAAC,mBAAmB,GAAG,IAAI,CAAA;YACnF,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,IAAI,eAAe,CAAC;YACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,aAAa,EAAE,UAAU,CAAC,IAAI;YAC9B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAA;IACJ,CAAC;IAED,gFAAgF;IAChF,IAAI,UAAU,CAAC,uBAAuB,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAe,CAAA;IACxE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAiB,CAAA;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAY,MAAM,CAAC,CAAA;QAClD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,mBAAmB,CAAS,GAAG,CAAC,CAAA;IACzC,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAS,GAAY;IAC/C,oEAAoE;IACpE,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACjD,CAAC;IACD,yEAAyE;IACzE,IAAI,GAAG,YAAY,KAAK,IAAK,GAAoD,CAAC,mBAAmB,EAAE,CAAC;QACtG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAa,EAAE,CAAA;IAC3D,CAAC;IACD,+CAA+C;IAC/C,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IAChD,CAAC;IACD,gEAAgE;IAChE,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACnD,CAAC;IACD,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACnD,CAAC;IACD,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACnD,CAAC;IACD,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACjD,CAAC;IACD,yEAAyE;IACzE,+EAA+E;IAC/E,6EAA6E;IAC7E,0EAA0E;IAC1E,wEAAwE;IACxE,IAAI,GAAG,YAAY,KAAK,IAAI,OAAQ,GAAkD,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;QACvH,MAAM,IAAI,GAAI,GAAiD,CAAC,kBAAkB,CAAA;QAClF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAA4B,EAAE,KAAK,EAAE,GAAG,EAAsB,CAAA;IAC1F,CAAC;IACD,oEAAoE;IACpE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AACnD,CAAC"}

package/build/client/call.test.js

@@ -270,6 +270,29 @@ describe('executeCall', () => {
         });
         expect(observedMeta).toEqual({ traceId: 'override', attempt: 1 });
     });
+    // ── responseHeadersDeclared ──
+    it('returns bare body when responseHeadersDeclared is not set', async () => {
+        const adapter = makeAdapter({ body: { id: 'abc' } });
+        const result = await run({ adapter, descriptor: makeDescriptor() });
+        expect(result).toEqual({ id: 'abc' });
+    });
+    it('returns { body, headers } when responseHeadersDeclared is true', async () => {
+        const adapter = {
+            request: vi.fn(async () => ({
+                status: 200,
+                headers: { 'x-rate-limit': '99' },
+                body: { id: 'abc' },
+            })),
+            stream: vi.fn(async () => { throw new Error('not expected'); }),
+        };
+        const descriptor = makeDescriptor({ responseHeadersDeclared: true });
+        const result = await run({
+            adapter,
+            descriptor,
+        });
+        expect(result).toEqual({ body: { id: 'abc' }, headers: { 'x-rate-limit': '99' } });
+        expect(result.headers['x-rate-limit']).toBe('99');
+    });
 });
 describe('executeCall classifier integration', () => {
     it('throws ClientNetworkError when adapter throws TypeError', async () => {