ts-procedures 8.6.0 → 9.0.0

package/build/{implementations/http → server}/doc-registry.test.js

@@ -1,10 +1,10 @@
 import { describe, expect, it, test, vi, afterEach } from 'vitest';
-import { v } from 'suretype';
 import { Type } from 'typebox';
-import { Procedures } from '../../index.js';
-import { HonoAppBuilder } from './hono/index.js';
+import { Procedures } from '../core/procedures.js';
 import { DocRegistry } from './doc-registry.js';
-import { defineErrorTaxonomy } from './error-taxonomy.js';
+import { defineErrorTaxonomy } from './errors/taxonomy.js';
+import { buildRpcRouteDoc } from './docs/rpc-doc.js';
+import { buildHttpStreamRouteDoc } from './docs/http-stream-doc.js';
 // ---------------------------------------------------------------------------
 // Helpers — minimal doc fixtures
 // ---------------------------------------------------------------------------
@@ -88,15 +88,15 @@ describe('DocRegistry', () => {
             const result = registry.from(makeSource([rpcDoc]));
             expect(result).toBe(registry);
         });
-        test('accepts RPC builder source', () => {
+        test('accepts RPC doc source', () => {
             const registry = new DocRegistry().from(makeSource([rpcDoc]));
             expect(registry.toJSON().routes).toEqual([rpcDoc]);
         });
-        test('accepts API builder source', () => {
+        test('accepts API doc source', () => {
             const registry = new DocRegistry().from(makeSource([apiDoc]));
             expect(registry.toJSON().routes).toEqual([apiDoc]);
         });
-        test('accepts Stream builder source', () => {
+        test('accepts Stream doc source', () => {
             const registry = new DocRegistry().from(makeSource([streamDoc]));
             expect(registry.toJSON().routes).toEqual([streamDoc]);
         });
@@ -105,12 +105,12 @@ describe('DocRegistry', () => {
             const registry = new DocRegistry().from(plain);
             expect(registry.toJSON().routes).toHaveLength(2);
         });
-        test('builder not yet built returns empty routes', () => {
+        test('source with no docs yet returns empty routes', () => {
             const emptySource = makeSource([]);
             const registry = new DocRegistry().from(emptySource);
             expect(registry.toJSON().routes).toEqual([]);
         });
-        test('same builder twice duplicates routes', () => {
+        test('same source twice duplicates routes', () => {
             const source = makeSource([rpcDoc]);
             const registry = new DocRegistry().from(source).from(source);
             expect(registry.toJSON().routes).toHaveLength(2);
@@ -260,7 +260,7 @@ describe('DocRegistry', () => {
         });
     });
     // --------------------------------------------------------------------------
-    // taxonomy input + auto-defaults + dedupe (v6.0.1 simplification)
+    // taxonomy input + auto-defaults + dedupe
     // --------------------------------------------------------------------------
     describe('errors: ErrorTaxonomy (polymorphic constructor input)', () => {
         test('accepts an ErrorTaxonomy directly and converts to ErrorDoc[]', () => {
@@ -275,8 +275,8 @@ describe('DocRegistry', () => {
             const envelope = new DocRegistry({ errors: taxonomy }).toJSON();
             const auth = envelope.errors.find((e) => e.name === 'AuthError');
             expect(auth).toBeDefined();
-            expect(auth?.statusCode).toBe(401);
-            expect(auth?.description).toBe('unauthenticated');
+            expect(auth.statusCode).toBe(401);
+            expect(auth.description).toBe('unauthenticated');
         });
         test('auto-includes framework defaults when errors is a taxonomy', () => {
             const taxonomy = defineErrorTaxonomy({
@@ -425,7 +425,7 @@ describe('DocRegistry', () => {
     // Integration
     // --------------------------------------------------------------------------
     describe('integration', () => {
-        test('multiple builder types composed', () => {
+        test('multiple doc kinds composed', () => {
             const registry = new DocRegistry({
                 basePath: '/api',
                 headers: [{ name: 'Authorization', description: 'Bearer token', required: false }],
@@ -512,7 +512,10 @@ describe('DocRegistry', () => {
                 expect(warnSpy).not.toHaveBeenCalled();
             });
         });
-        it('aggregates http-stream routes from HonoAppBuilder', () => {
+        // v8 used a built HonoAppBuilder as the source here; the hono adapter
+        // doesn't exist yet in v9 (Phase 3), so a plain DocSource backed by the
+        // real doc builders takes its place.
+        it('aggregates http-stream routes built from a real procedure registration', () => {
             const procs = Procedures();
             procs.CreateHttpStream('Tail', {
                 path: '/streams/logs',
@@ -522,20 +525,20 @@ describe('DocRegistry', () => {
                     yield: Type.Object({ line: Type.String() }),
                 },
             }, async function* () { });
-            const builder = new HonoAppBuilder().register(procs, {});
-            builder.build();
-            const registry = new DocRegistry().from(builder);
+            const reg = procs.getProcedures()[0];
+            const source = { docs: [buildHttpStreamRouteDoc(reg, undefined)] };
+            const registry = new DocRegistry().from(source);
             const envelope = registry.toJSON();
             const route = envelope.routes.find((r) => r.name === 'Tail');
-            expect(route?.kind).toBe('http-stream');
+            expect(route).toBeDefined();
+            expect(route.kind).toBe('http-stream');
         });
-        test('accepts a real HonoAppBuilder as source', () => {
+        test('accepts a real RPC registration via a plain DocSource', () => {
             const RPC = Procedures();
-            RPC.Create('Ping', { scope: 'ping', version: 1, schema: { params: v.object({ msg: v.string() }) } }, async (_ctx, params) => params);
-            const builder = new HonoAppBuilder();
-            builder.register(RPC, () => ({ userId: '123' }));
-            builder.build();
-            const registry = new DocRegistry({ basePath: '/rpc' }).from(builder);
+            RPC.Create('Ping', { scope: 'ping', version: 1, schema: { params: Type.Object({ msg: Type.String() }) } }, async (_ctx, params) => params);
+            const reg = RPC.getProcedures()[0];
+            const source = { docs: [buildRpcRouteDoc(reg, undefined)] };
+            const registry = new DocRegistry({ basePath: '/rpc' }).from(source);
             const out = registry.toJSON();
             expect(out.basePath).toBe('/rpc');
             expect(out.routes).toHaveLength(1);

package/build/server/doc-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-registry.test.js","sourceRoot":"","sources":["../../src/server/doc-registry.test.ts"],"names":[],"mappings":"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"}

package/build/server/docs/docs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/server/docs/docs.test.js

@@ -0,0 +1,237 @@
+/**
+ * Doc-builder tests — ported from the doc-builder parts of v8's
+ * route-errors.test.ts (the hono-server parts arrive with the Phase 3
+ * adapter). Covers config.errors propagation onto route docs plus the
+ * core doc shapes each builder emits.
+ */
+import { describe, expect, test } from 'vitest';
+import { Type } from 'typebox';
+import { Procedures } from '../../core/procedures.js';
+import { defineErrorTaxonomy } from '../errors/taxonomy.js';
+import { buildRpcRouteDoc } from './rpc-doc.js';
+import { buildStreamRouteDoc } from './stream-doc.js';
+import { buildHttpRouteDoc } from './http-doc.js';
+import { buildHttpStreamRouteDoc } from './http-stream-doc.js';
+class UseCaseError extends Error {
+    externalMsg;
+    constructor(externalMsg) {
+        super(externalMsg);
+        this.externalMsg = externalMsg;
+        this.name = 'UseCaseError';
+        Object.setPrototypeOf(this, UseCaseError.prototype);
+    }
+}
+class AuthError extends Error {
+}
+const appErrors = defineErrorTaxonomy({
+    UseCaseError: { class: UseCaseError, statusCode: 422 },
+    AuthError: { class: AuthError, statusCode: 401 },
+});
+// ---------------------------------------------------------------------------
+// Fixture helpers — real registrations built through the core factory
+// ---------------------------------------------------------------------------
+function makeRpcReg(config) {
+    const RPC = Procedures();
+    RPC.Create('DoThing', config, async () => ({}));
+    return RPC.getProcedures()[0];
+}
+function makeStreamReg(config) {
+    const Stream = Procedures();
+    Stream.CreateStream('Watch', config, async function* () {
+        yield { ok: true };
+    });
+    return Stream.getProcedures()[0];
+}
+// ---------------------------------------------------------------------------
+// buildRpcRouteDoc
+// ---------------------------------------------------------------------------
+describe('buildRpcRouteDoc', () => {
+    test('copies config.errors onto the route doc', () => {
+        const reg = makeRpcReg({
+            scope: 'things',
+            version: 1,
+            errors: ['UseCaseError'],
+            schema: { params: Type.Object({}) },
+        });
+        const doc = buildRpcRouteDoc(reg, undefined);
+        expect(doc.errors).toEqual(['UseCaseError']);
+    });
+    test('omits errors when not declared', () => {
+        const reg = makeRpcReg({ scope: 'things', version: 1 });
+        const doc = buildRpcRouteDoc(reg, undefined);
+        expect(doc.errors).toBeUndefined();
+    });
+    test('emits kind, method and the rpc path (with prefix)', () => {
+        const reg = makeRpcReg({ scope: 'userThings', version: 2 });
+        const doc = buildRpcRouteDoc(reg, '/api');
+        expect(doc.kind).toBe('rpc');
+        expect(doc.method).toBe('post');
+        expect(doc.name).toBe('DoThing');
+        expect(doc.path).toBe('/api/user-things/do-thing/2');
+    });
+    test('maps schema.params → jsonSchema.body and schema.returnType → jsonSchema.response', () => {
+        const reg = makeRpcReg({
+            scope: 'things',
+            version: 1,
+            schema: {
+                params: Type.Object({ id: Type.String() }),
+                returnType: Type.Object({ ok: Type.Boolean() }),
+            },
+        });
+        const doc = buildRpcRouteDoc(reg, undefined);
+        expect(doc.jsonSchema.body).toMatchObject({ type: 'object' });
+        expect(doc.jsonSchema.response).toMatchObject({ type: 'object' });
+    });
+    test('extend() merges extra fields but base fields win', () => {
+        const reg = makeRpcReg({ scope: 'things', version: 1 });
+        const doc = buildRpcRouteDoc(reg, undefined, ({ base }) => ({
+            custom: 'extra',
+            name: `OVERRIDE-${base.name}`,
+        }));
+        expect(doc.custom).toBe('extra');
+        expect(doc.name).toBe('DoThing');
+    });
+});
+// ---------------------------------------------------------------------------
+// buildStreamRouteDoc
+// ---------------------------------------------------------------------------
+describe('buildStreamRouteDoc', () => {
+    test('copies config.errors onto the route doc', () => {
+        const reg = makeStreamReg({ scope: 'watch', version: 1, errors: ['AuthError'] });
+        const doc = buildStreamRouteDoc(reg, 'sse', undefined);
+        expect(doc.errors).toEqual(['AuthError']);
+    });
+    test('omits errors when not declared', () => {
+        const reg = makeStreamReg({ scope: 'watch', version: 1 });
+        const doc = buildStreamRouteDoc(reg, 'sse', undefined);
+        expect(doc.errors).toBeUndefined();
+    });
+    test('emits kind, methods (post first for codegen) and streamMode', () => {
+        const reg = makeStreamReg({ scope: 'watch', version: 1 });
+        const doc = buildStreamRouteDoc(reg, 'sse', '/api');
+        expect(doc.kind).toBe('stream');
+        expect(doc.methods).toEqual(['post', 'get']);
+        expect(doc.streamMode).toBe('sse');
+        expect(doc.path).toBe('/api/watch/watch/1');
+    });
+    test('sse mode wraps yieldType in the SSE message envelope', () => {
+        const reg = makeStreamReg({
+            scope: 'watch',
+            version: 1,
+            schema: { yieldType: Type.Object({ ok: Type.Boolean() }) },
+        });
+        const doc = buildStreamRouteDoc(reg, 'sse', undefined);
+        const envelope = doc.jsonSchema.yieldType;
+        expect(envelope.required).toEqual(['data', 'event', 'id']);
+        expect(envelope.properties.data).toMatchObject({ type: 'object' });
+        expect(envelope.properties.event).toEqual({ type: 'string' });
+        expect(envelope.properties.id).toEqual({ type: 'string' });
+        expect(envelope.properties.retry).toEqual({ type: 'number' });
+    });
+    test('text mode passes yieldType through unwrapped', () => {
+        const reg = makeStreamReg({
+            scope: 'watch',
+            version: 1,
+            schema: { yieldType: Type.Object({ ok: Type.Boolean() }) },
+        });
+        const doc = buildStreamRouteDoc(reg, 'text', undefined);
+        const yieldType = doc.jsonSchema.yieldType;
+        expect(yieldType.properties.ok).toMatchObject({ type: 'boolean' });
+        expect(yieldType.properties.data).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// buildHttpRouteDoc
+// ---------------------------------------------------------------------------
+describe('buildHttpRouteDoc', () => {
+    function makeHttpReg() {
+        const HTTP = Procedures();
+        HTTP.CreateHttp('GetUser', {
+            path: '/users/:id',
+            method: 'get',
+            scope: 'users',
+            successStatus: 200,
+            errors: ['UseCaseError'],
+            schema: {
+                req: { pathParams: Type.Object({ id: Type.String() }) },
+                res: { body: Type.Object({ id: Type.String() }) },
+            },
+        }, async (_ctx, req) => ({ id: req.pathParams.id }));
+        return HTTP.getProcedures()[0];
+    }
+    test('copies config.errors onto the route doc', () => {
+        const doc = buildHttpRouteDoc(makeHttpReg(), undefined);
+        expect(doc.errors).toEqual(['UseCaseError']);
+    });
+    test('route doc omits errors when not declared', () => {
+        const HTTP = Procedures();
+        HTTP.CreateHttp('Ping', { path: '/ping', method: 'get', schema: {} }, async () => { });
+        const reg = HTTP.getProcedures()[0];
+        const doc = buildHttpRouteDoc(reg, undefined);
+        expect(doc.errors).toBeUndefined();
+    });
+    test('resolves fullPath from prefix while keeping the registered path', () => {
+        const doc = buildHttpRouteDoc(makeHttpReg(), '/api');
+        expect(doc.kind).toBe('api');
+        expect(doc.path).toBe('/users/:id');
+        expect(doc.fullPath).toBe('/api/users/:id');
+        expect(doc.method).toBe('get');
+        expect(doc.scope).toBe('users');
+    });
+    test('copies successStatus and req/res channel schemas', () => {
+        const doc = buildHttpRouteDoc(makeHttpReg(), undefined);
+        expect(doc.successStatus).toBe(200);
+        expect(doc.jsonSchema.req.pathParams).toMatchObject({ type: 'object' });
+        expect(doc.jsonSchema.res.body).toMatchObject({ type: 'object' });
+    });
+});
+// ---------------------------------------------------------------------------
+// buildHttpStreamRouteDoc
+// ---------------------------------------------------------------------------
+describe('buildHttpStreamRouteDoc', () => {
+    function makeHttpStreamReg(errors) {
+        const S = Procedures();
+        S.CreateHttpStream('Tail', {
+            path: '/streams/logs',
+            method: 'get',
+            errors,
+            schema: {
+                req: { query: Type.Object({ source: Type.String() }) },
+                yield: Type.Object({ line: Type.String() }),
+            },
+        }, async function* () {
+            yield { line: 'x' };
+        });
+        return S.getProcedures()[0];
+    }
+    test('copies config.errors onto the route doc', () => {
+        const doc = buildHttpStreamRouteDoc(makeHttpStreamReg(['AuthError']), undefined);
+        expect(doc.errors).toEqual(['AuthError']);
+    });
+    test('omits errors when not declared', () => {
+        const doc = buildHttpStreamRouteDoc(makeHttpStreamReg(), undefined);
+        expect(doc.errors).toBeUndefined();
+    });
+    test('emits kind, streamMode sse, fullPath and yield schema', () => {
+        const doc = buildHttpStreamRouteDoc(makeHttpStreamReg(), '/api');
+        expect(doc.kind).toBe('http-stream');
+        expect(doc.streamMode).toBe('sse');
+        expect(doc.path).toBe('/streams/logs');
+        expect(doc.fullPath).toBe('/api/streams/logs');
+        expect(doc.jsonSchema.req.query).toMatchObject({ type: 'object' });
+        expect(doc.jsonSchema.yield).toMatchObject({ type: 'object' });
+    });
+});
+// ---------------------------------------------------------------------------
+// Compile-time narrowing (ported from route-errors.test.ts)
+// ---------------------------------------------------------------------------
+describe('per-route errors declaration', () => {
+    test('compile-time: errors typed as keyof taxonomy narrows valid keys', () => {
+        const _valid = ['UseCaseError', 'AuthError'];
+        // @ts-expect-error - 'NotRegistered' is not in the taxonomy
+        const _invalid = ['NotRegistered'];
+        expect(_valid).toBeDefined();
+        expect(_invalid).toBeDefined();
+    });
+});
+//# sourceMappingURL=docs.test.js.map

package/build/server/docs/docs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.test.js","sourceRoot":"","sources":["../../../src/server/docs/docs.test.ts"],"names":[],"mappings":"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"}

package/build/{implementations/http/hono → server}/docs/http-doc.d.ts

@@ -1,5 +1,5 @@
-import type { THttpProcedureRegistration } from '../../../../types.js';
-import type { APIHttpRouteDoc } from '../../../types.js';
+import type { THttpProcedureRegistration } from '../../core/types.js';
+import type { APIHttpRouteDoc } from '../types.js';
 export declare function buildHttpRouteDoc(procedure: THttpProcedureRegistration<any>, prefix: string | undefined, extend?: (params: {
     base: APIHttpRouteDoc;
     procedure: THttpProcedureRegistration<any>;

package/build/{implementations/http/hono → server}/docs/http-doc.js

@@ -1,4 +1,4 @@
-import { resolveFullPath } from '../path.js';
+import { resolveFullPath } from '../paths.js';
 export function buildHttpRouteDoc(procedure, prefix, extend) {
     const config = procedure.config;
     const fullPath = resolveFullPath(config.path, prefix);

package/build/server/docs/http-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-doc.js","sourceRoot":"","sources":["../../../src/server/docs/http-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,UAAU,iBAAiB,CAC/B,SAA0C,EAC1C,MAA0B,EAC1B,MAAmH;IAEnH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;IAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;IACpC,MAAM,UAAU,GAAkC,EAAE,CAAA;IAEpD,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAClG,UAAU,CAAC,GAAG,GAAG,EAAE,CAAA;QACnB,IAAI,SAAS,CAAC,UAAU;YAAE,UAAU,CAAC,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,UAAiB,CAAA;QACjF,IAAI,SAAS,CAAC,KAAK;YAAE,UAAU,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,KAAY,CAAA;QAClE,IAAI,SAAS,CAAC,IAAI;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,IAAW,CAAA;QAC/D,IAAI,SAAS,CAAC,OAAO;YAAE,UAAU,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,OAAc,CAAA;IAC1E,CAAC;IACD,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,UAAU,CAAC,GAAG,GAAG,EAAE,CAAA;QACnB,IAAI,SAAS,CAAC,IAAI;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,IAAW,CAAA;QAC/D,IAAI,SAAS,CAAC,OAAO;YAAE,UAAU,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,OAAc,CAAA;IAC1E,CAAC;IAED,MAAM,IAAI,GAAoB;QAC5B,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,UAAU;KACX,CAAA;IACD,IAAI,MAAM,CAAC,aAAa;QAAE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;IACnE,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAE/E,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAA;AACjC,CAAC"}

package/build/{implementations/http/hono → server}/docs/http-stream-doc.d.ts

@@ -1,5 +1,5 @@
-import type { THttpStreamProcedureRegistration } from '../../../../types.js';
-import type { HttpStreamRouteDoc } from '../../../types.js';
+import type { THttpStreamProcedureRegistration } from '../../core/types.js';
+import type { HttpStreamRouteDoc } from '../types.js';
 export declare function buildHttpStreamRouteDoc(procedure: THttpStreamProcedureRegistration<any>, prefix: string | undefined, extend?: (params: {
     base: HttpStreamRouteDoc;
     procedure: THttpStreamProcedureRegistration<any>;

package/build/{implementations/http/hono → server}/docs/http-stream-doc.js

@@ -1,4 +1,4 @@
-import { resolveFullPath } from '../path.js';
+import { resolveFullPath } from '../paths.js';
 export function buildHttpStreamRouteDoc(procedure, prefix, extend) {
     const config = procedure.config;
     const fullPath = resolveFullPath(config.path, prefix);

package/build/server/docs/http-stream-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-stream-doc.js","sourceRoot":"","sources":["../../../src/server/docs/http-stream-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,UAAU,uBAAuB,CACrC,SAAgD,EAChD,MAA0B,EAC1B,MAG6B;IAE7B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;IAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;IACpC,MAAM,UAAU,GAAqC,EAAE,CAAA;IAEvD,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAClG,UAAU,CAAC,GAAG,GAAG,EAAE,CAAA;QACnB,IAAI,SAAS,CAAC,UAAU;YAAE,UAAU,CAAC,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,UAAiB,CAAA;QACjF,IAAI,SAAS,CAAC,KAAK;YAAE,UAAU,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,KAAY,CAAA;QAClE,IAAI,SAAS,CAAC,IAAI;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,IAAW,CAAA;QAC/D,IAAI,SAAS,CAAC,OAAO;YAAE,UAAU,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,OAAc,CAAA;IAC1E,CAAC;IACD,IAAI,SAAS,EAAE,OAAO;QAAE,UAAU,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,OAAc,EAAE,CAAA;IAC9E,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK;QAAE,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAY,CAAA;IACvE,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU;QAAE,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAiB,CAAA;IAEtF,MAAM,IAAI,GAAuB;QAC/B,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,UAAU,EAAE,KAAK;QACjB,UAAU;KACX,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAE/E,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAA;AACjC,CAAC"}

package/build/{implementations/http/hono → server}/docs/rpc-doc.d.ts

@@ -1,5 +1,5 @@
-import type { TProcedureRegistration } from '../../../../types.js';
-import type { RPCConfig, RPCHttpRouteDoc } from '../../../types.js';
+import type { TProcedureRegistration } from '../../core/types.js';
+import type { RPCConfig, RPCHttpRouteDoc } from '../types.js';
 export declare function buildRpcRouteDoc(procedure: TProcedureRegistration<any, RPCConfig>, prefix: string | undefined, extend?: (params: {
     base: RPCHttpRouteDoc;
     procedure: TProcedureRegistration<any, RPCConfig>;

package/build/{implementations/http/hono → server}/docs/rpc-doc.js

@@ -1,4 +1,4 @@
-import { makeRoutePath } from '../path.js';
+import { makeRoutePath } from '../paths.js';
 export function buildRpcRouteDoc(procedure, prefix, extend) {
     const config = procedure.config;
     const jsonSchema = {};

package/build/server/docs/rpc-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-doc.js","sourceRoot":"","sources":["../../../src/server/docs/rpc-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,UAAU,gBAAgB,CAC9B,SAAiD,EACjD,MAA0B,EAC1B,MAA0H;IAE1H,MAAM,MAAM,GAAG,SAAS,CAAC,MAGxB,CAAA;IAED,MAAM,UAAU,GAA2E,EAAE,CAAA;IAC7F,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;QAAE,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;IACjE,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU;QAAE,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAA;IAE7E,MAAM,IAAI,GAAoB;QAC5B,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM;QACd,UAAU;KACX,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAA;AACjC,CAAC"}

package/build/{implementations/http/hono → server}/docs/stream-doc.d.ts

@@ -1,5 +1,5 @@
-import type { TStreamProcedureRegistration } from '../../../../types.js';
-import type { RPCConfig, StreamHttpRouteDoc, StreamMode } from '../../../types.js';
+import type { TStreamProcedureRegistration } from '../../core/types.js';
+import type { RPCConfig, StreamHttpRouteDoc, StreamMode } from '../types.js';
 export declare function buildStreamRouteDoc(procedure: TStreamProcedureRegistration<any, RPCConfig>, streamMode: StreamMode, prefix: string | undefined, extend?: (params: {
     base: StreamHttpRouteDoc;
     procedure: TStreamProcedureRegistration<any, RPCConfig>;

package/build/{implementations/http/hono → server}/docs/stream-doc.js

@@ -1,4 +1,4 @@
-import { makeRoutePath } from '../path.js';
+import { makeRoutePath } from '../paths.js';
 export function buildStreamRouteDoc(procedure, streamMode, prefix, extend) {
     const config = procedure.config;
     const jsonSchema = {};

package/build/server/docs/stream-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-doc.js","sourceRoot":"","sources":["../../../src/server/docs/stream-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,UAAU,mBAAmB,CACjC,SAAuD,EACvD,UAAsB,EACtB,MAA0B,EAC1B,MAAmI;IAEnI,MAAM,MAAM,GAAG,SAAS,CAAC,MAGxB,CAAA;IAED,MAAM,UAAU,GAAqC,EAAE,CAAA;IACvD,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;QAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;IAEnE,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,SAAS,GAAG;YACrB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;YACjC,UAAU,EAAE;gBACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE;gBACpC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;SACF,CAAA;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;QACpC,UAAU,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAA;IAChD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU;QAAE,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAA;IAE/E,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,IAAI,GAAuB;QAC/B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QACxB,UAAU;QACV,UAAU;KACX,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAE/E,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAA;AACjC,CAAC"}

package/build/server/errors/dispatch.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Transport-agnostic error dispatch.
+ *
+ * Unlike v8 (where dispatch produced Hono `Response` objects directly), v9
+ * dispatch returns plain data and the server adapter translates it into its
+ * framework's response primitive. `TRaw` is the adapter's request context
+ * (Hono `Context`, Fastify `Request`, ...) and `TResponse` its response type —
+ * both flow through untouched.
+ */
+import { type ErrorTaxonomy, type TAnyProcedureRegistration, type UnknownErrorConfig } from './taxonomy.js';
+import type { TStreamProcedureRegistration, THttpStreamProcedureRegistration } from '../../core/types.js';
+/** Public alias of {@link TAnyProcedureRegistration}. */
+export type AnyServedProcedure = TAnyProcedureRegistration;
+export type OnRequestErrorContext<TRaw = unknown> = {
+    err: unknown;
+    procedure: AnyServedProcedure;
+    raw: TRaw;
+};
+/**
+ * Cross-cutting observer for logging/tracing — fires for every caught error
+ * BEFORE dispatch. Awaited; cannot mutate the response; throws are swallowed.
+ */
+export type OnRequestErrorObserver<TRaw = unknown> = (ctx: OnRequestErrorContext<TRaw>) => void | Promise<void>;
+/** Imperative error handler — produces a framework response directly. */
+export type PreStreamOnError<TRaw = unknown, TResponse = unknown> = (procedure: AnyServedProcedure, raw: TRaw, err: Error) => TResponse | Promise<TResponse>;
+export type PreStreamErrorConfig<TRaw = unknown, TResponse = unknown> = {
+    errors?: ErrorTaxonomy;
+    unknownError?: UnknownErrorConfig;
+    onError?: PreStreamOnError<TRaw, TResponse>;
+    onRequestError?: OnRequestErrorObserver<TRaw>;
+};
+/**
+ * What the adapter should send. Either resolved data (taxonomy / unknownError /
+ * hard default — serialize `body` as JSON with `statusCode`) or a framework
+ * response produced by the imperative `onError` callback (send as-is).
+ */
+export type PreStreamDispatchResult<TResponse = unknown> = {
+    type: 'body';
+    statusCode: number;
+    body: unknown;
+} | {
+    type: 'response';
+    response: TResponse;
+};
+/**
+ * Used by rpc, http, and the pre-stream guard in stream / http-stream
+ * handlers. Order: onRequestError observer (awaited, throws swallowed) →
+ * taxonomy resolver → imperative onError → hard default
+ * (`{ error: message }`, 500).
+ */
+export declare function dispatchPreStreamError<TRaw, TResponse>(params: {
+    err: unknown;
+    procedure: AnyServedProcedure;
+    raw: TRaw;
+    cfg: PreStreamErrorConfig<TRaw, TResponse>;
+}): Promise<PreStreamDispatchResult<TResponse>>;
+/**
+ * Return shape of an `onMidStreamError` callback.
+ *
+ * - `data`: the value to write to the open stream as the error payload.
+ *   Decorate with the `sse(data, { event, id, retry })` helper to attach SSE
+ *   metadata; the stream handler reads that metadata via `getSSEMeta` after
+ *   dispatch.
+ * - `closeStream`: reserved for future use. The stream currently always
+ *   closes naturally after the catch block returns.
+ */
+export type MidStreamErrorResult<TErrorData = unknown> = {
+    data: TErrorData;
+    closeStream?: boolean;
+};
+export type OnMidStreamError<TErrorData = unknown, TRaw = unknown> = (procedure: TStreamProcedureRegistration<any, any> | THttpStreamProcedureRegistration<any>, raw: TRaw, err: Error) => MidStreamErrorResult<TErrorData> | undefined;
+export type MidStreamErrorConfig<TErrorData = unknown, TRaw = unknown> = {
+    errors?: ErrorTaxonomy;
+    unknownError?: UnknownErrorConfig;
+    onMidStreamError?: OnMidStreamError<TErrorData, TRaw>;
+    onRequestError?: OnRequestErrorObserver<TRaw>;
+};
+export type DispatchedMidStreamError = {
+    data: unknown;
+    sseEvent?: string;
+    sseId?: string;
+    sseRetry?: number;
+    runOnCatch?: () => Promise<void>;
+};
+/**
+ * Used inside SSE / text-stream generator catch blocks. Returns the bytes
+ * to write to the open stream — the HTTP status is already committed, so a
+ * Response is impossible. Order matches dispatchPreStreamError: observer
+ * (awaited, throws swallowed) → taxonomy → onMidStreamError → hard default.
+ */
+export declare function dispatchMidStreamError<TErrorData, TRaw>(params: {
+    err: unknown;
+    procedure: TStreamProcedureRegistration<any, any> | THttpStreamProcedureRegistration<any>;
+    raw: TRaw;
+    cfg: MidStreamErrorConfig<TErrorData, TRaw>;
+}): Promise<DispatchedMidStreamError>;