ts-procedures 7.2.0 → 8.0.0

package/build/implementations/http/error-dispatch.test.js

@@ -0,0 +1,254 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Hono } from 'hono';
+import { dispatchMidStreamError, dispatchPreStreamError } from './error-dispatch.js';
+import { defineErrorTaxonomy } from './error-taxonomy.js';
+import { ProcedureValidationError } from '../../errors.js';
+function makeContext() {
+    return new Promise((resolve) => {
+        const app = new Hono();
+        app.get('/', (c) => {
+            resolve(c);
+            return c.text('ok');
+        });
+        app.request('/');
+    });
+}
+const dummyProcedure = {
+    name: 'Test',
+    kind: 'rpc',
+    config: { scope: 'test', version: 1 },
+    handler: async () => undefined,
+};
+describe('dispatchPreStreamError', () => {
+    test('default taxonomy: ProcedureValidationError → 400', async () => {
+        const c = await makeContext();
+        const err = new ProcedureValidationError('Test', 'Validation error for Test', [
+            { instancePath: '/x', message: 'expected number' },
+        ]);
+        const res = await dispatchPreStreamError({
+            err,
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: {},
+        });
+        expect(res.status).toBe(400);
+        const body = await res.json();
+        expect(body.name).toBe('ProcedureValidationError');
+        expect(body.procedureName).toBe('Test');
+    });
+    test('user taxonomy entry takes precedence', async () => {
+        const c = await makeContext();
+        class MyError extends Error {
+            reason;
+            constructor(reason) {
+                super(reason);
+                this.reason = reason;
+            }
+        }
+        const errors = defineErrorTaxonomy({
+            MyError: { class: MyError, statusCode: 422, toResponse: (e) => ({ name: 'MyError', reason: e.reason }) },
+        });
+        const res = await dispatchPreStreamError({
+            err: new MyError('boom'),
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: { errors },
+        });
+        expect(res.status).toBe(422);
+        expect(await res.json()).toEqual({ name: 'MyError', reason: 'boom' });
+    });
+    test('falls back to onError imperative callback', async () => {
+        const c = await makeContext();
+        const onError = vi.fn().mockResolvedValue(c.json({ ok: false }, 503));
+        const res = await dispatchPreStreamError({
+            err: new Error('unmatched'),
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: { onError: (proc, raw, e) => onError(proc, raw, e) },
+        });
+        expect(onError).toHaveBeenCalled();
+        expect(res.status).toBe(503);
+    });
+    test('hard default 500 when nothing matches', async () => {
+        const c = await makeContext();
+        const res = await dispatchPreStreamError({
+            err: new Error('boom'),
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: {},
+        });
+        expect(res.status).toBe(500);
+        expect(await res.json()).toEqual({ error: 'boom' });
+    });
+    test('onRequestError observer fires before dispatch and is awaited', async () => {
+        const c = await makeContext();
+        const calls = [];
+        const onRequestError = vi.fn(async () => {
+            calls.push('observer');
+        });
+        const errors = defineErrorTaxonomy({
+            AnyError: {
+                match: (e) => e instanceof Error,
+                statusCode: 500,
+                toResponse: () => {
+                    calls.push('toResponse');
+                    return { name: 'AnyError' };
+                },
+            },
+        });
+        await dispatchPreStreamError({
+            err: new Error('x'),
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: { errors, onRequestError },
+        });
+        expect(calls).toEqual(['observer', 'toResponse']);
+        expect(onRequestError).toHaveBeenCalledWith({ err: expect.any(Error), procedure: dummyProcedure, raw: c });
+    });
+    test('observer throw is swallowed and logged', async () => {
+        const c = await makeContext();
+        const consoleErr = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const onRequestError = vi.fn(() => { throw new Error('observer broke'); });
+        const res = await dispatchPreStreamError({
+            err: new Error('x'),
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: { onRequestError },
+        });
+        expect(res.status).toBe(500);
+        expect(consoleErr).toHaveBeenCalled();
+        consoleErr.mockRestore();
+    });
+    test('taxonomy onCatch is fully awaited before the response body is written', async () => {
+        const c = await makeContext();
+        const calls = [];
+        class HookedError extends Error {
+        }
+        const errors = defineErrorTaxonomy({
+            HookedError: {
+                class: HookedError,
+                statusCode: 500,
+                toResponse: () => ({ name: 'HookedError' }),
+                onCatch: async () => {
+                    // Awaiting an async setTimeout here means a non-awaiting dispatcher
+                    // would write the response BEFORE this push runs. The order we capture
+                    // in `calls` reveals which branch happened.
+                    await new Promise((resolve) => setTimeout(resolve, 5));
+                    calls.push('oncatch-done');
+                },
+            },
+        });
+        // Spy on c.json: when the dispatcher writes the response, record where in
+        // the timeline it happened relative to onCatch's push.
+        const originalJson = c.json.bind(c);
+        const jsonSpy = vi.fn((...args) => {
+            calls.push('response-write');
+            return originalJson(...args);
+        });
+        c.json = jsonSpy;
+        const res = await dispatchPreStreamError({
+            err: new HookedError('boom'),
+            procedure: dummyProcedure,
+            raw: c,
+            cfg: { errors },
+        });
+        expect(res.status).toBe(500);
+        expect(jsonSpy).toHaveBeenCalledTimes(1);
+        // If the dispatcher awaits onCatch first, 'oncatch-done' precedes
+        // 'response-write'. Without the await, the order would be reversed
+        // (or 'oncatch-done' would land after the dispatcher returns).
+        expect(calls).toEqual(['oncatch-done', 'response-write']);
+    });
+});
+const streamProcedure = {
+    name: 'Tail',
+    kind: 'rpc-stream',
+    config: { scope: 'logs', version: 1 },
+    handler: async function* () { },
+};
+describe('dispatchMidStreamError', () => {
+    test('uses taxonomy body when configured', async () => {
+        const c = await makeContext();
+        class MidErr extends Error {
+        }
+        const errors = defineErrorTaxonomy({
+            MidErr: { class: MidErr, statusCode: 500, toResponse: () => ({ name: 'MidErr', detail: 'x' }) },
+        });
+        const result = await dispatchMidStreamError({
+            err: new MidErr('mid'),
+            procedure: streamProcedure,
+            raw: c,
+            cfg: { errors },
+        });
+        expect(result.data).toEqual({ name: 'MidErr', detail: 'x' });
+        expect(result.sseEvent).toBe('error');
+        expect(result.runOnCatch).toBeTypeOf('function');
+    });
+    test('falls back to onMidStreamError', async () => {
+        const c = await makeContext();
+        const result = await dispatchMidStreamError({
+            err: new Error('boom'),
+            procedure: streamProcedure,
+            raw: c,
+            cfg: {
+                onMidStreamError: () => ({ data: { kind: 'fail', msg: 'boom' } }),
+            },
+        });
+        expect(result.data).toEqual({ kind: 'fail', msg: 'boom' });
+        expect(result.sseEvent).toBe('Tail'); // procedure name override
+    });
+    test('hard default { error: msg } when nothing matches', async () => {
+        const c = await makeContext();
+        const result = await dispatchMidStreamError({
+            err: new Error('plain'),
+            procedure: streamProcedure,
+            raw: c,
+            cfg: {},
+        });
+        expect(result.data).toEqual({ error: 'plain' });
+        expect(result.sseEvent).toBe('error');
+    });
+    test('onRequestError observer fires before dispatch (mid-stream form)', async () => {
+        const c = await makeContext();
+        const onRequestError = vi.fn(async () => { });
+        await dispatchMidStreamError({
+            err: new Error('x'),
+            procedure: streamProcedure,
+            raw: c,
+            cfg: { onRequestError },
+        });
+        expect(onRequestError).toHaveBeenCalled();
+    });
+    test('returns a runOnCatch function that is invokable and awaits the taxonomy hook', async () => {
+        const c = await makeContext();
+        const calls = [];
+        class StreamErr extends Error {
+        }
+        const errors = defineErrorTaxonomy({
+            StreamErr: {
+                class: StreamErr,
+                statusCode: 500,
+                toResponse: () => ({ name: 'StreamErr' }),
+                onCatch: async () => {
+                    await new Promise((resolve) => setTimeout(resolve, 5));
+                    calls.push('oncatch-done');
+                },
+            },
+        });
+        // Mid-stream contract: the dispatcher does NOT call runOnCatch itself —
+        // the caller (stream handler) decides when to invoke it. Verify the shape
+        // and that awaiting it actually awaits the hook.
+        const result = await dispatchMidStreamError({
+            err: new StreamErr('mid'),
+            procedure: streamProcedure,
+            raw: c,
+            cfg: { errors },
+        });
+        expect(result.runOnCatch).toBeTypeOf('function');
+        // Hook has not yet run — caller hasn't invoked it.
+        expect(calls).toEqual([]);
+        await result.runOnCatch();
+        expect(calls).toEqual(['oncatch-done']);
+    });
+});
+//# sourceMappingURL=error-dispatch.test.js.map

package/build/implementations/http/error-dispatch.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-dispatch.test.js","sourceRoot":"","sources":["../../../src/implementations/http/error-dispatch.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,SAAS,WAAW;IAClB,OAAO,IAAI,OAAO,CAAyB,CAAC,OAAO,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YACjB,OAAO,CAAC,CAAC,CAAC,CAAA;YACV,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE;IACrC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;CACxB,CAAA;AAER,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,GAAG,GAAG,IAAI,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,EAAE;YAC5E,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAS;SAC1D,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC;YACvC,GAAG;YACH,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE;SACR,CAAC,CAAA;QAEF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QAClD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,OAAQ,SAAQ,KAAK;YACN;YAAnB,YAAmB,MAAc;gBAAI,KAAK,CAAC,MAAM,CAAC,CAAA;gBAA/B,WAAM,GAAN,MAAM,CAAQ;YAAkB,CAAC;SACrD;QACD,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;SACzG,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC;YACvC,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC;YACxB,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,MAAM,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;QAErE,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC;YACvC,GAAG,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC;YAC3B,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;SAC1D,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC;YACvC,GAAG,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE;SACR,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YACtC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,QAAQ,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,YAAY,KAAK;gBAC5C,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,GAAG,EAAE;oBACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;oBACxB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;gBAC7B,CAAC;aACF;SACF,CAAC,CAAA;QAEF,MAAM,sBAAsB,CAAC;YAC3B,GAAG,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAA;QACjD,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IAC5G,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC1E,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QAEzE,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC;YACvC,GAAG,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,cAAc,EAAE;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAA;QACrC,UAAU,CAAC,WAAW,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,WAAY,SAAQ,KAAK;SAAG;QAClC,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,WAAW,EAAE;gBACX,KAAK,EAAE,WAAW;gBAClB,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;gBAC3C,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,oEAAoE;oBACpE,uEAAuE;oBACvE,4CAA4C;oBAC5C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;oBAC5D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;gBAC5B,CAAC;aACF;SACF,CAAC,CAAA;QAEF,0EAA0E;QAC1E,uDAAuD;QACvD,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAiC,CAAA;QACnE,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;YACvC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;YAC5B,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC,CAAA;QAC9B,CAAC,CAAC,CACD;QAAC,CAAS,CAAC,IAAI,GAAG,OAAO,CAAA;QAE1B,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC;YACvC,GAAG,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;YAC5B,SAAS,EAAE,cAAc;YACzB,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,MAAM,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACxC,kEAAkE;QAClE,mEAAmE;QACnE,+DAA+D;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE;IACrC,OAAO,EAAE,KAAK,SAAS,CAAC,MAAK,CAAC;CACxB,CAAA;AAER,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,IAAI,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,MAAO,SAAQ,KAAK;SAAG;QAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;SAChG,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,GAAG,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC;YACtB,SAAS,EAAE,eAAe;YAC1B,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,MAAM,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAC5D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,GAAG,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,eAAe;YAC1B,GAAG,EAAE,CAAC;YACN,GAAG,EAAE;gBACH,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;aAClE;SACF,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA,CAAC,0BAA0B;IACjE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,GAAG,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC;YACvB,SAAS,EAAE,eAAe;YAC1B,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE;SACR,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAA;QAE5C,MAAM,sBAAsB,CAAC;YAC3B,GAAG,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,eAAe;YAC1B,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,cAAc,EAAE;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAA;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,SAAU,SAAQ,KAAK;SAAG;QAChC,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,SAAS,EAAE;gBACT,KAAK,EAAE,SAAS;gBAChB,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACzC,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;oBAC5D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;gBAC5B,CAAC;aACF;SACF,CAAC,CAAA;QAEF,wEAAwE;QACxE,0EAA0E;QAC1E,iDAAiD;QACjD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,GAAG,EAAE,IAAI,SAAS,CAAC,KAAK,CAAC;YACzB,SAAS,EAAE,eAAe;YAC1B,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,EAAE,MAAM,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;QAChD,mDAAmD;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAEzB,MAAM,MAAM,CAAC,UAAW,EAAE,CAAA;QAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/implementations/http/error-taxonomy.d.ts

@@ -1,8 +1,8 @@
 import { ProcedureError, ProcedureValidationError, ProcedureYieldValidationError } from '../../errors.js';
-import type { TProcedureRegistration, TStreamProcedureRegistration } from '../../index.js';
+import type { TProcedureRegistration, TStreamProcedureRegistration, THttpProcedureRegistration, THttpStreamProcedureRegistration } from '../../index.js';
 import type { ErrorDoc } from '../types.js';
-/** Either a regular or stream procedure registration — accepted by taxonomy callbacks. */
-export type TAnyProcedureRegistration = TProcedureRegistration | TStreamProcedureRegistration;
+/** Any procedure registration — accepted by taxonomy callbacks. */
+export type TAnyProcedureRegistration = TProcedureRegistration | TStreamProcedureRegistration | THttpProcedureRegistration<any> | THttpStreamProcedureRegistration<any>;
 /**
  * An entry in an {@link ErrorTaxonomy}. Describes how to recognize a thrown
  * error at runtime and how to serialize it into an HTTP response.
@@ -31,8 +31,8 @@ export type ErrorTaxonomyEntry<TError = any, TBody = unknown> = {
     }) => TBody;
     /**
      * Side effect on catch (logging, metrics). Awaited before the response is sent.
-     * `raw` is the framework-specific request context (Hono `Context` /
-     * `{ req, res }` for Express) — cast as needed.
+     * `raw` is the framework-specific request context (e.g., Hono `Context`) —
+     * cast as needed.
      */
     onCatch?: (err: TError, ctx: {
         procedure: TAnyProcedureRegistration;

package/build/implementations/http/hono/docs/http-doc.d.ts

@@ -0,0 +1,6 @@
+import type { THttpProcedureRegistration } from '../../../../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>;
+}) => Record<string, unknown>): APIHttpRouteDoc;

package/build/implementations/http/hono/docs/http-doc.js

@@ -0,0 +1,42 @@
+import { resolveFullPath } from '../path.js';
+export function buildHttpRouteDoc(procedure, prefix, extend) {
+    const config = procedure.config;
+    const fullPath = resolveFullPath(config.path, prefix);
+    const reqSchema = config.schema?.req;
+    const resSchema = config.schema?.res;
+    const jsonSchema = {};
+    if (reqSchema && (reqSchema.pathParams || reqSchema.query || reqSchema.body || reqSchema.headers)) {
+        jsonSchema.req = {};
+        if (reqSchema.pathParams)
+            jsonSchema.req.pathParams = reqSchema.pathParams;
+        if (reqSchema.query)
+            jsonSchema.req.query = reqSchema.query;
+        if (reqSchema.body)
+            jsonSchema.req.body = reqSchema.body;
+        if (reqSchema.headers)
+            jsonSchema.req.headers = reqSchema.headers;
+    }
+    if (resSchema && (resSchema.body || resSchema.headers)) {
+        jsonSchema.res = {};
+        if (resSchema.body)
+            jsonSchema.res.body = resSchema.body;
+        if (resSchema.headers)
+            jsonSchema.res.headers = resSchema.headers;
+    }
+    const base = {
+        kind: 'api',
+        name: procedure.name,
+        scope: config.scope,
+        path: config.path,
+        method: config.method,
+        fullPath,
+        jsonSchema,
+    };
+    if (config.successStatus)
+        base.successStatus = config.successStatus;
+    if (config.errors && config.errors.length > 0)
+        base.errors = [...config.errors];
+    const extended = extend ? extend({ base, procedure }) : {};
+    return { ...extended, ...base };
+}
+//# sourceMappingURL=http-doc.js.map

package/build/implementations/http/hono/docs/http-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-doc.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/docs/http-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,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/docs/http-stream-doc.d.ts

@@ -0,0 +1,6 @@
+import type { THttpStreamProcedureRegistration } from '../../../../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>;
+}) => Record<string, unknown>): HttpStreamRouteDoc;

package/build/implementations/http/hono/docs/http-stream-doc.js

@@ -0,0 +1,40 @@
+import { resolveFullPath } from '../path.js';
+export function buildHttpStreamRouteDoc(procedure, prefix, extend) {
+    const config = procedure.config;
+    const fullPath = resolveFullPath(config.path, prefix);
+    const reqSchema = config.schema?.req;
+    const resSchema = config.schema?.res;
+    const jsonSchema = {};
+    if (reqSchema && (reqSchema.pathParams || reqSchema.query || reqSchema.body || reqSchema.headers)) {
+        jsonSchema.req = {};
+        if (reqSchema.pathParams)
+            jsonSchema.req.pathParams = reqSchema.pathParams;
+        if (reqSchema.query)
+            jsonSchema.req.query = reqSchema.query;
+        if (reqSchema.body)
+            jsonSchema.req.body = reqSchema.body;
+        if (reqSchema.headers)
+            jsonSchema.req.headers = reqSchema.headers;
+    }
+    if (resSchema?.headers)
+        jsonSchema.res = { headers: resSchema.headers };
+    if (config.schema?.yield)
+        jsonSchema.yield = config.schema.yield;
+    if (config.schema?.returnType)
+        jsonSchema.returnType = config.schema.returnType;
+    const base = {
+        kind: 'http-stream',
+        name: procedure.name,
+        scope: config.scope,
+        path: config.path,
+        method: config.method,
+        fullPath,
+        streamMode: 'sse',
+        jsonSchema,
+    };
+    if (config.errors && config.errors.length > 0)
+        base.errors = [...config.errors];
+    const extended = extend ? extend({ base, procedure }) : {};
+    return { ...extended, ...base };
+}
+//# sourceMappingURL=http-stream-doc.js.map

package/build/implementations/http/hono/docs/http-stream-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-stream-doc.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/docs/http-stream-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,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/docs/rpc-doc.d.ts

@@ -0,0 +1,6 @@
+import type { TProcedureRegistration } from '../../../../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>;
+}) => Record<string, unknown>): RPCHttpRouteDoc;

package/build/implementations/http/hono/docs/rpc-doc.js

@@ -0,0 +1,24 @@
+import { makeRoutePath } from '../path.js';
+export function buildRpcRouteDoc(procedure, prefix, extend) {
+    const config = procedure.config;
+    const jsonSchema = {};
+    if (config.schema?.params)
+        jsonSchema.body = config.schema.params;
+    if (config.schema?.returnType)
+        jsonSchema.response = config.schema.returnType;
+    const base = {
+        kind: 'rpc',
+        name: procedure.name,
+        version: config.version,
+        scope: config.scope,
+        path: makeRoutePath({ procedure, prefix }),
+        method: 'post',
+        jsonSchema,
+    };
+    if (config.errors && config.errors.length > 0) {
+        base.errors = [...config.errors];
+    }
+    const extended = extend ? extend({ base, procedure }) : {};
+    return { ...extended, ...base };
+}
+//# sourceMappingURL=rpc-doc.js.map

package/build/implementations/http/hono/docs/rpc-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-doc.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/docs/rpc-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,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/docs/stream-doc.d.ts

@@ -0,0 +1,6 @@
+import type { TStreamProcedureRegistration } from '../../../../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>;
+}) => Record<string, unknown>): StreamHttpRouteDoc;

package/build/implementations/http/hono/docs/stream-doc.js

@@ -0,0 +1,42 @@
+import { makeRoutePath } from '../path.js';
+export function buildStreamRouteDoc(procedure, streamMode, prefix, extend) {
+    const config = procedure.config;
+    const jsonSchema = {};
+    if (config.schema?.params)
+        jsonSchema.params = config.schema.params;
+    if (streamMode === 'sse') {
+        jsonSchema.yieldType = {
+            type: 'object',
+            description: 'SSE message envelope. The data field contains the procedure yield value.',
+            required: ['data', 'event', 'id'],
+            properties: {
+                data: config.schema?.yieldType ?? {},
+                event: { type: 'string' },
+                id: { type: 'string' },
+                retry: { type: 'number' },
+            },
+        };
+    }
+    else if (config.schema?.yieldType) {
+        jsonSchema.yieldType = config.schema.yieldType;
+    }
+    if (config.schema?.returnType)
+        jsonSchema.returnType = config.schema.returnType;
+    // POST first so codegen (which reads `methods[0]`) defaults to POST. POST is
+    // the canonical method for streams because it can carry a body for params.
+    const base = {
+        kind: 'stream',
+        name: procedure.name,
+        version: config.version,
+        scope: config.scope,
+        path: makeRoutePath({ procedure, prefix }),
+        methods: ['post', 'get'],
+        streamMode,
+        jsonSchema,
+    };
+    if (config.errors && config.errors.length > 0)
+        base.errors = [...config.errors];
+    const extended = extend ? extend({ base, procedure }) : {};
+    return { ...extended, ...base };
+}
+//# sourceMappingURL=stream-doc.js.map

package/build/implementations/http/hono/docs/stream-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-doc.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/docs/stream-doc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,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/implementations/http/hono/handlers/http-stream.d.ts

@@ -0,0 +1,10 @@
+import type { Hono } from 'hono';
+import type { THttpStreamProcedureRegistration } from '../../../../types.js';
+import type { DocAccumulator, HonoAppBuilderConfig, HonoFactoryItem } from '../types.js';
+export declare function installHttpStreamRoute(params: {
+    app: Hono;
+    procedure: THttpStreamProcedureRegistration<any>;
+    factoryItem: HonoFactoryItem;
+    cfg: HonoAppBuilderConfig;
+    docs: DocAccumulator;
+}): void;

package/build/implementations/http/hono/handlers/http-stream.js

@@ -0,0 +1,123 @@
+import { streamSSE } from 'hono/streaming';
+import { dispatchMidStreamError, dispatchPreStreamError } from '../../error-dispatch.js';
+import { buildHttpStreamRouteDoc } from '../docs/http-stream-doc.js';
+const BODY_METHODS = ['post', 'put', 'patch'];
+function parseQueryNative(queryString) {
+    const sp = new URLSearchParams(queryString);
+    const result = {};
+    for (const key of new Set(sp.keys())) {
+        const values = sp.getAll(key);
+        result[key] = values.length > 1 ? values : values[0];
+    }
+    return result;
+}
+function extractQuery(url, parser) {
+    const q = url.indexOf('?');
+    if (q === -1)
+        return {};
+    const raw = url.slice(q + 1);
+    return raw ? parser(raw) : {};
+}
+async function extractParams(c, method, reqSchema, parser) {
+    const params = {};
+    for (const channel of Object.keys(reqSchema)) {
+        switch (channel) {
+            case 'pathParams':
+                params.pathParams = c.req.param();
+                break;
+            case 'query':
+                params.query = extractQuery(c.req.url, parser);
+                break;
+            case 'body':
+                if (BODY_METHODS.includes(method)) {
+                    params.body = await c.req.json().catch(() => ({}));
+                }
+                break;
+            case 'headers': {
+                const obj = {};
+                c.req.raw.headers.forEach((v, k) => { obj[k] = v; });
+                params.headers = obj;
+                break;
+            }
+            default:
+                params[channel] = undefined;
+        }
+    }
+    return params;
+}
+export function installHttpStreamRoute(params) {
+    const { app, procedure, factoryItem, cfg, docs } = params;
+    const queryParser = cfg.api?.queryParser ?? parseQueryNative;
+    const route = buildHttpStreamRouteDoc(procedure, cfg.pathPrefix, factoryItem.extendProcedureDoc);
+    docs.push(route);
+    const reqSchema = procedure.config.schema?.req;
+    app.on(procedure.config.method.toUpperCase(), route.fullPath, async (c) => {
+        try {
+            const context = typeof factoryItem.factoryContext === 'function'
+                ? await factoryItem.factoryContext(c)
+                : factoryItem.factoryContext;
+            const reqParams = reqSchema
+                ? await extractParams(c, procedure.config.method, reqSchema, queryParser)
+                : undefined;
+            const { stream: gen, initialHeaders } = await procedure.handler({ ...context, signal: c.req.raw.signal }, reqParams);
+            if (initialHeaders) {
+                for (const [k, v] of Object.entries(initialHeaders))
+                    c.header(k, v);
+            }
+            cfg.stream?.onStreamStart?.(procedure, c, 'sse');
+            return streamSSE(c, async (stream) => {
+                let eventId = 0;
+                try {
+                    let it = await gen.next();
+                    while (!it.done) {
+                        const data = typeof it.value === 'string' ? it.value : JSON.stringify(it.value);
+                        await stream.writeSSE({ data, event: procedure.name, id: String(eventId++) });
+                        it = await gen.next();
+                    }
+                    if (it.value !== undefined) {
+                        const data = typeof it.value === 'string' ? it.value : JSON.stringify(it.value);
+                        await stream.writeSSE({ data, event: 'return', id: String(eventId++) });
+                    }
+                }
+                catch (error) {
+                    const dispatched = await dispatchMidStreamError({
+                        err: error,
+                        procedure,
+                        raw: c,
+                        cfg: {
+                            errors: cfg.errors,
+                            unknownError: cfg.unknownError,
+                            onMidStreamError: cfg.stream?.onMidStreamError,
+                            onRequestError: cfg.onRequestError,
+                        },
+                    });
+                    await stream.writeSSE({
+                        data: typeof dispatched.data === 'string' ? dispatched.data : JSON.stringify(dispatched.data),
+                        event: dispatched.sseEvent ?? 'error',
+                        id: String(eventId++),
+                    });
+                    if (dispatched.runOnCatch)
+                        await dispatched.runOnCatch();
+                }
+                finally {
+                    cfg.stream?.onStreamEnd?.(procedure, c, 'sse');
+                    cfg.onRequestEnd?.(c);
+                }
+            });
+        }
+        catch (error) {
+            return dispatchPreStreamError({
+                err: error,
+                procedure,
+                raw: c,
+                cfg: {
+                    errors: cfg.errors,
+                    unknownError: cfg.unknownError,
+                    onError: cfg.onError,
+                    onRequestError: cfg.onRequestError,
+                },
+            });
+        }
+    });
+}
+//# sourceMappingURL=http-stream.js.map

package/build/implementations/http/hono/handlers/http-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-stream.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/handlers/http-stream.ts"],"names":[],"mappings":"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"}