ts-procedures 7.3.0 → 8.0.0

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

@@ -0,0 +1,128 @@
+import { describe, expect, test } from 'vitest';
+import { Hono } from 'hono';
+import { Type } from 'typebox';
+import { Procedures } from '../../../../index.js';
+import { installHttpStreamRoute } from './http-stream.js';
+function buildApp(setup, cfg = {}) {
+    const P = Procedures();
+    setup(P);
+    const app = new Hono();
+    const docs = [];
+    for (const proc of P.getProcedures().values()) {
+        if (proc.kind !== 'http-stream')
+            continue;
+        installHttpStreamRoute({
+            app,
+            procedure: proc,
+            factoryItem: { factory: P, factoryContext: () => ({ uid: 'u1' }) },
+            cfg,
+            docs,
+        });
+    }
+    return { app, docs };
+}
+describe('installHttpStreamRoute', () => {
+    test('SSE pumping with initialHeaders and event:return', async () => {
+        const { app, docs } = buildApp((P) => {
+            P.CreateHttpStream('Tail', {
+                path: '/logs/tail', method: 'get',
+                schema: {
+                    yield: Type.Object({ line: Type.String() }),
+                    res: { headers: Type.Object({ 'x-trace': Type.String() }) },
+                },
+            }, async () => ({
+                headers: { 'x-trace': 'abc' },
+                stream: (async function* () {
+                    yield { line: 'a' };
+                    yield { line: 'b' };
+                    return 'fin';
+                })(),
+            }));
+        });
+        expect(docs[0].kind).toBe('http-stream');
+        const res = await app.request('/logs/tail');
+        const text = await res.text();
+        expect(res.headers.get('x-trace')).toBe('abc');
+        expect(text).toContain('"line":"a"');
+        expect(text).toContain('"line":"b"');
+        expect(text).toContain('event: return');
+        expect(text).toContain('fin');
+    });
+    test('mid-stream throw → dispatchMidStreamError default { error }', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttpStream('Boom', { path: '/boom', method: 'get', schema: {} }, (async function* () {
+                yield { ok: 1 };
+                throw new Error('mid');
+            }));
+        });
+        const res = await app.request('/boom');
+        const text = await res.text();
+        expect(text).toContain('event: error');
+        expect(text).toContain('"error":"mid"');
+    });
+    test('pre-stream throw → dispatchPreStreamError 500', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttpStream('Pre', { path: '/pre', method: 'get', schema: {} }, (async () => { throw new Error('pre'); }));
+        });
+        const res = await app.request('/pre');
+        expect(res.status).toBe(500);
+        const body = await res.json();
+        expect(body.error).toContain('pre');
+    });
+    test('validateYields: true → invalid yield surfaces ProcedureYieldValidationError on the wire', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttpStream('BadHttpYield', {
+                path: '/bad-yield',
+                method: 'get',
+                schema: { yield: Type.Object({ id: Type.Number() }) },
+                validateYields: true,
+            }, (async function* () {
+                yield { id: 1 };
+                yield { id: 'not-a-number' };
+            }));
+        });
+        const res = await app.request('/bad-yield');
+        expect(res.status).toBe(200);
+        const text = await res.text();
+        expect(text).toContain('event: error');
+        expect(text).toContain('"name":"ProcedureYieldValidationError"');
+        expect(text).toContain('"procedureName":"BadHttpYield"');
+        expect(text).toContain('"id":1');
+    });
+    test('AbortSignal: natural completion → ctx.signal.reason === "stream-completed"', async () => {
+        let capturedSignal;
+        const { app } = buildApp((P) => {
+            P.CreateHttpStream('NaturalSig', { path: '/sig-natural', method: 'get', schema: {} }, (async function* (ctx) {
+                capturedSignal = ctx.signal;
+                yield { tick: 1 };
+            }));
+        });
+        const res = await app.request('/sig-natural');
+        await res.text();
+        expect(capturedSignal).toBeInstanceOf(AbortSignal);
+        expect(capturedSignal.aborted).toBe(true);
+        expect(capturedSignal.reason).toBe('stream-completed');
+    });
+    test('AbortSignal: pre-aborted request signal → ctx.signal.reason !== "stream-completed"', async () => {
+        // Same proxy approach as the rpc-stream variant: pre-abort the request
+        // signal and rely on `AbortSignal.any` preserving the earlier reason over
+        // the internal 'stream-completed' that fires in the wrappedHandler's
+        // finally clause.
+        let capturedSignal;
+        const { app } = buildApp((P) => {
+            P.CreateHttpStream('DisconnectSig', { path: '/sig-disconnect', method: 'get', schema: {} }, (async function* (ctx) {
+                capturedSignal = ctx.signal;
+                yield { tick: 1 };
+            }));
+        });
+        const ac = new AbortController();
+        ac.abort('client-gone');
+        const req = new Request('http://localhost/sig-disconnect', { method: 'GET', signal: ac.signal });
+        const res = await app.request(req);
+        await res.text().catch(() => '');
+        expect(capturedSignal).toBeInstanceOf(AbortSignal);
+        expect(capturedSignal.aborted).toBe(true);
+        expect(capturedSignal.reason).not.toBe('stream-completed');
+    });
+});
+//# sourceMappingURL=http-stream.test.js.map

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

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

package/build/implementations/http/hono/handlers/http.d.ts

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

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

@@ -0,0 +1,115 @@
+import { dispatchPreStreamError } from '../../error-dispatch.js';
+import { buildHttpRouteDoc } from '../docs/http-doc.js';
+const BODY_METHODS = ['post', 'put', 'patch'];
+function defaultSuccessStatus(method) {
+    switch (method) {
+        case 'post': return 201;
+        case 'delete': return 204;
+        default: return 200;
+    }
+}
+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 installHttpRoute(params) {
+    const { app, procedure, factoryItem, cfg, docs } = params;
+    const queryParser = cfg.api?.queryParser ?? parseQueryNative;
+    const route = buildHttpRouteDoc(procedure, cfg.pathPrefix, factoryItem.extendProcedureDoc);
+    docs.push(route);
+    const successStatus = procedure.config.successStatus ?? defaultSuccessStatus(procedure.config.method);
+    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 result = await procedure.handler({ ...context, signal: c.req.raw.signal }, reqParams);
+            cfg.api?.onSuccess?.(procedure, c);
+            // 204 No Content — no body, just optional headers
+            if (successStatus === 204) {
+                if (result && typeof result === 'object' && 'headers' in result && result.headers) {
+                    for (const [k, v] of Object.entries(result.headers)) {
+                        c.header(k, v);
+                    }
+                }
+                return c.body(null, 204);
+            }
+            let body = result;
+            let headers;
+            if (result && typeof result === 'object' && 'body' in result && 'headers' in result) {
+                body = result.body;
+                headers = result.headers;
+            }
+            else if (result && typeof result === 'object' && 'headers' in result && !('body' in result)) {
+                for (const [k, v] of Object.entries(result.headers)) {
+                    c.header(k, v);
+                }
+                return c.body(null, successStatus);
+            }
+            else if (result && typeof result === 'object' && 'body' in result && !('headers' in result)) {
+                body = result.body;
+            }
+            if (headers)
+                for (const [k, v] of Object.entries(headers))
+                    c.header(k, v);
+            return c.json(body, successStatus);
+        }
+        catch (error) {
+            return dispatchPreStreamError({
+                err: error,
+                procedure,
+                raw: c,
+                cfg: {
+                    errors: cfg.errors,
+                    unknownError: cfg.unknownError,
+                    onError: cfg.onError,
+                    onRequestError: cfg.onRequestError,
+                },
+            });
+        }
+    });
+}
+//# sourceMappingURL=http.js.map

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

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

package/build/implementations/http/hono/handlers/http.test.js

@@ -0,0 +1,118 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Hono } from 'hono';
+import { Type } from 'typebox';
+import { Procedures } from '../../../../index.js';
+import { installHttpRoute } from './http.js';
+function buildApp(setup, cfg = {}) {
+    const P = Procedures();
+    setup(P);
+    const app = new Hono();
+    const docs = [];
+    for (const proc of P.getProcedures().values()) {
+        if (proc.kind !== 'http')
+            continue;
+        installHttpRoute({
+            app,
+            procedure: proc,
+            factoryItem: { factory: P, factoryContext: () => ({ uid: 'u1' }) },
+            cfg,
+            docs,
+        });
+    }
+    return { app, docs };
+}
+describe('installHttpRoute', () => {
+    test('GET with pathParams and query', async () => {
+        const { app, docs } = buildApp((P) => {
+            P.CreateHttp('GetUser', {
+                path: '/users/:id',
+                method: 'get',
+                scope: 'users',
+                schema: {
+                    req: {
+                        pathParams: Type.Object({ id: Type.String() }),
+                        query: Type.Object({ include: Type.Optional(Type.String()) }),
+                    },
+                    res: { body: Type.Object({ id: Type.String(), include: Type.Optional(Type.String()) }) },
+                },
+            }, async (_ctx, { pathParams, query }) => ({ id: pathParams.id, include: query.include }));
+        });
+        const res = await app.request('/users/abc?include=foo');
+        expect(res.status).toBe(200);
+        expect(await res.json()).toEqual({ id: 'abc', include: 'foo' });
+        expect(docs[0].kind).toBe('api');
+        expect(docs[0].fullPath).toBe('/users/:id');
+    });
+    test('POST with body, default 201', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttp('Create', {
+                path: '/items',
+                method: 'post',
+                schema: {
+                    req: { body: Type.Object({ name: Type.String() }) },
+                    res: { body: Type.Object({ name: Type.String() }) },
+                },
+            }, async (_ctx, { body }) => body);
+        });
+        const res = await app.request('/items', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name: 'gizmo' }),
+        });
+        expect(res.status).toBe(201);
+        expect(await res.json()).toEqual({ name: 'gizmo' });
+    });
+    test('DELETE returns 204 with no body', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttp('Delete', {
+                path: '/items/:id',
+                method: 'delete',
+                schema: { req: { pathParams: Type.Object({ id: Type.String() }) } },
+            }, async () => undefined);
+        });
+        const res = await app.request('/items/x', { method: 'DELETE' });
+        expect(res.status).toBe(204);
+        expect(await res.text()).toBe('');
+    });
+    test('headers in result are forwarded', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttp('WithHeaders', {
+                path: '/h', method: 'get',
+                schema: { res: { body: Type.Object({ ok: Type.Boolean() }), headers: Type.Object({}) } },
+            }, async () => ({ body: { ok: true }, headers: { 'x-trace': 'abc' } }));
+        });
+        const res = await app.request('/h');
+        expect(res.headers.get('x-trace')).toBe('abc');
+        expect(await res.json()).toEqual({ ok: true });
+    });
+    test('api.onSuccess fires after handler', async () => {
+        const onSuccess = vi.fn();
+        const { app } = buildApp((P) => {
+            P.CreateHttp('Ping', { path: '/ping', method: 'get', schema: {} }, async () => undefined);
+        }, { api: { onSuccess } });
+        await app.request('/ping');
+        expect(onSuccess).toHaveBeenCalledOnce();
+    });
+    test('thrown error → dispatchPreStreamError default 500', async () => {
+        const { app } = buildApp((P) => {
+            P.CreateHttp('Boom', { path: '/boom', method: 'get', schema: {} }, async () => { throw new Error('x'); });
+        });
+        const res = await app.request('/boom');
+        expect(res.status).toBe(500);
+        const body = await res.json();
+        expect(body.error).toContain('x');
+    });
+    test('custom queryParser is used', async () => {
+        const queryParser = vi.fn((q) => ({ parsed: true, raw: q }));
+        const { app } = buildApp((P) => {
+            P.CreateHttp('Q', {
+                path: '/q', method: 'get',
+                schema: { req: { query: Type.Any() }, res: { body: Type.Any() } },
+            }, async (_ctx, { query }) => ({ body: query }));
+        }, { api: { queryParser } });
+        const res = await app.request('/q?a=1&b=2');
+        expect(queryParser).toHaveBeenCalledWith('a=1&b=2');
+        expect(await res.json()).toEqual({ parsed: true, raw: 'a=1&b=2' });
+    });
+});
+//# sourceMappingURL=http.test.js.map

package/build/implementations/http/hono/handlers/http.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/handlers/http.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,IAAI,EAAE,MAAM,SAAS,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE5C,SAAS,QAAQ,CAAC,KAAkE,EAAE,MAAW,EAAE;IACjG,MAAM,CAAC,GAAG,UAAU,EAAmB,CAAA;IACvC,KAAK,CAAC,CAAC,CAAC,CAAA;IACR,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,IAAI,GAAU,EAAE,CAAA;IACtB,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,SAAQ;QAClC,gBAAgB,CAAC;YACf,GAAG;YACH,SAAS,EAAE,IAAW;YACtB,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE;YAClE,GAAG;YACH,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;AACtB,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YACnC,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE;gBACtB,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE;oBACN,GAAG,EAAE;wBACH,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;wBAC9C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;qBAC9D;oBACD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE;iBACzF;aACF,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC5F,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;QACvD,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,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC/D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE;oBACN,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;oBACnD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;iBACpD;aACF,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SACxC,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,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE;gBACrB,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;aACpE,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC/D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,CAAC,CAAC,UAAU,CAAC,aAAa,EAAE;gBAC1B,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK;gBACzB,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE;aACzF,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;QACzE,CAAC,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACzB,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAA;QAC3F,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QAE1B,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC1B,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QAC1G,CAAC,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,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,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QACpE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;gBAChB,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK;gBACzB,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE;aAClE,EACC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QACjD,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;QAE5B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QAC3C,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/implementations/http/hono/handlers/rpc.d.ts

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

package/build/implementations/http/hono/handlers/rpc.js

@@ -0,0 +1,32 @@
+import { dispatchPreStreamError } from '../../error-dispatch.js';
+import { buildRpcRouteDoc } from '../docs/rpc-doc.js';
+export function installRpcRoute(params) {
+    const { app, procedure, factoryItem, cfg, docs } = params;
+    const route = buildRpcRouteDoc(procedure, cfg.pathPrefix, factoryItem.extendProcedureDoc);
+    docs.push(route);
+    app.post(route.path, async (c) => {
+        try {
+            const context = typeof factoryItem.factoryContext === 'function'
+                ? await factoryItem.factoryContext(c)
+                : factoryItem.factoryContext;
+            const body = await c.req.json().catch(() => ({}));
+            const result = await procedure.handler({ ...context, signal: c.req.raw.signal }, body);
+            cfg.rpc?.onSuccess?.(procedure, c);
+            return c.json(result);
+        }
+        catch (error) {
+            return dispatchPreStreamError({
+                err: error,
+                procedure,
+                raw: c,
+                cfg: {
+                    errors: cfg.errors,
+                    unknownError: cfg.unknownError,
+                    onError: cfg.onError,
+                    onRequestError: cfg.onRequestError,
+                },
+            });
+        }
+    });
+}
+//# sourceMappingURL=rpc.js.map

package/build/implementations/http/hono/handlers/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/handlers/rpc.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGrD,MAAM,UAAU,eAAe,CAAC,MAM/B;IACC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IAEzD,MAAM,KAAK,GAAG,gBAAgB,CAC5B,SAAS,EACT,GAAG,CAAC,UAAU,EACd,WAAW,CAAC,kBAAyB,CACtC,CAAA;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEhB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,OAAO,GACX,OAAO,WAAW,CAAC,cAAc,KAAK,UAAU;gBAC9C,CAAC,CAAC,MAAO,WAAW,CAAC,cAAsC,CAAC,CAAC,CAAC;gBAC9D,CAAC,CAAC,WAAW,CAAC,cAAc,CAAA;YAEhC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACjD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CACpC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EACxC,IAAI,CACL,CAAA;YAED,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;YAElC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,sBAAsB,CAAC;gBAC5B,GAAG,EAAE,KAAK;gBACV,SAAS;gBACT,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE;oBACH,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,YAAY,EAAE,GAAG,CAAC,YAAY;oBAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,cAAc,EAAE,GAAG,CAAC,cAAc;iBACnC;aACF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/implementations/http/hono/handlers/rpc.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Hono } from 'hono';
+import { Type } from 'typebox';
+import { Procedures } from '../../../../index.js';
+import { installRpcRoute } from './rpc.js';
+function buildApp(register, cfg = {}) {
+    const RPC = Procedures();
+    register(RPC);
+    const app = new Hono();
+    const docs = [];
+    for (const proc of RPC.getProcedures().values()) {
+        if (proc.kind !== 'rpc')
+            continue;
+        installRpcRoute({
+            app,
+            procedure: proc,
+            factoryItem: { factory: RPC, factoryContext: () => ({ userId: '123' }) },
+            cfg,
+            docs,
+        });
+    }
+    return { app, docs };
+}
+describe('installRpcRoute', () => {
+    test('mounts POST route at scope/name/version path', async () => {
+        const { app, docs } = buildApp((RPC) => {
+            RPC.Create('Echo', {
+                scope: 'echo',
+                version: 1,
+                schema: { params: Type.Object({ msg: Type.String() }) },
+            }, async (_ctx, params) => params);
+        });
+        const res = await app.request('/echo/echo/1', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ msg: 'hi' }),
+        });
+        expect(res.status).toBe(200);
+        expect(await res.json()).toEqual({ msg: 'hi' });
+        expect(docs).toHaveLength(1);
+        expect(docs[0].kind).toBe('rpc');
+        expect(docs[0].path).toBe('/echo/echo/1');
+    });
+    test('rpc.onSuccess fires after handler', async () => {
+        const onSuccess = vi.fn();
+        const { app } = buildApp((RPC) => {
+            RPC.Create('Ping', { scope: 'p', version: 1 }, async () => ({ ok: true }));
+        }, { rpc: { onSuccess } });
+        await app.request('/p/ping/1', { method: 'POST', body: '{}', headers: { 'Content-Type': 'application/json' } });
+        expect(onSuccess).toHaveBeenCalledOnce();
+    });
+    test('thrown error → dispatchPreStreamError default 500', async () => {
+        const { app } = buildApp((RPC) => {
+            RPC.Create('Boom', { scope: 'b', version: 1 }, async () => { throw new Error('boom'); });
+        });
+        const res = await app.request('/b/boom/1', { method: 'POST', body: '{}', headers: { 'Content-Type': 'application/json' } });
+        expect(res.status).toBe(500);
+        const body = await res.json();
+        expect(body.error).toContain('boom');
+    });
+    test('AbortSignal is injected into ctx', async () => {
+        let receivedSignal;
+        const { app } = buildApp((RPC) => {
+            RPC.Create('Sig', { scope: 's', version: 1 }, async (ctx) => {
+                receivedSignal = ctx.signal;
+                return {};
+            });
+        });
+        await app.request('/s/sig/1', { method: 'POST', body: '{}', headers: { 'Content-Type': 'application/json' } });
+        expect(receivedSignal).toBeInstanceOf(AbortSignal);
+    });
+});
+//# sourceMappingURL=rpc.test.js.map

package/build/implementations/http/hono/handlers/rpc.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.test.js","sourceRoot":"","sources":["../../../../../src/implementations/http/hono/handlers/rpc.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,IAAI,EAAE,MAAM,SAAS,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C,SAAS,QAAQ,CAAC,QAAyF,EAAE,MAAW,EAAE;IACxH,MAAM,GAAG,GAAG,UAAU,EAAiC,CAAA;IACvD,QAAQ,CAAC,GAAG,CAAC,CAAA;IACb,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,IAAI,GAAU,EAAE,CAAA;IACtB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,SAAQ;QACjC,eAAe,CAAC;YACd,GAAG;YACH,SAAS,EAAE,IAAW;YACtB,WAAW,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;YACxE,GAAG;YACH,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;AACtB,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE;YACrC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE;gBACjB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;aACxD,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE;YAC5C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;SACpC,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,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACzB,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5E,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QAE1B,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAC/G,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QACzF,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAC3H,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,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAClD,IAAI,cAAuC,CAAA;QAC3C,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC1D,cAAc,GAAG,GAAG,CAAC,MAAM,CAAA;gBAC3B,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAC9G,MAAM,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/implementations/http/hono/handlers/stream.d.ts

@@ -0,0 +1,23 @@
+import type { Hono } from 'hono';
+import type { TStreamProcedureRegistration } from '../../../../types.js';
+import type { RPCConfig, StreamMode } from '../../../types.js';
+import type { DocAccumulator, HonoAppBuilderConfig, HonoFactoryItem } from '../types.js';
+export type SSEOptions = {
+    event?: string;
+    id?: string;
+    retry?: number;
+};
+/**
+ * Marks an object yield as an SSE event with custom metadata. Stream handlers
+ * read this metadata to set the SSE `event:`, `id:`, and `retry:` fields.
+ */
+export declare function sse<T extends object>(data: T, options?: SSEOptions): T;
+export type { MidStreamErrorResult } from '../../error-dispatch.js';
+export declare function installRpcStreamRoute(params: {
+    app: Hono;
+    procedure: TStreamProcedureRegistration<any, RPCConfig>;
+    factoryItem: HonoFactoryItem;
+    cfg: HonoAppBuilderConfig;
+    docs: DocAccumulator;
+    streamMode: StreamMode;
+}): void;